@zonsh/ui 0.4.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (562) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +7 -7
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. package/package.json +69 -2
@@ -1,13 +1,15 @@
1
1
  "use client";
2
2
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { useRender } from "@base-ui/react/use-render";
4
- import { GripHorizontalIcon, GripIcon, GripVerticalIcon } from "lucide-react";
4
+ import { GripHorizontalIcon, GripIcon, GripVerticalIcon } from "../lib/icons.js";
5
5
  import * as React from "react";
6
6
  import { createPortal } from "react-dom";
7
7
  import { cn, sx } from "../lib/cn.js";
8
8
  import { mergeRefs } from "../lib/merge-refs.js";
9
9
  import { Button } from "./button.js";
10
10
  import { useMessages } from "./locale.js";
11
+ import { usePortalContainer } from "../lib/portal-container.js";
12
+ import { autoScroll, DRAG_THRESHOLD, LONG_PRESS, scrollersOf, TOUCH_SLOP, useAnnouncer, } from "../lib/drag.js";
11
13
  /** "Lead, position 2 of 4" or "position 2 of 4". */
12
14
  const at = (p) => `${p.list ? `${p.list}, position` : "position"} ${p.position} of ${p.count}`;
13
15
  /** The same, starting a sentence. */
@@ -26,6 +28,8 @@ const defaultMessages = {
26
28
  dropped: (item, p) => `Dropped ${item}. ${At(p)}.`,
27
29
  cancelled: (item, p) => `Move cancelled. ${item} is back in ${at(p)}.`,
28
30
  cannotMove: (item, p) => `${item} cannot move further. ${At(p)}.`,
31
+ overZone: (item, zone) => `Over ${zone}. Release to drop ${item} there.`,
32
+ droppedOn: (item, zone) => `Dropped ${item} on ${zone}.`,
29
33
  };
30
34
  /** The lists of a value, with `""` for a single list. */
31
35
  const toLists = (value) => (Array.isArray(value) ? { "": value } : value);
@@ -60,16 +64,8 @@ export function moveSortableItem(value, item, to) {
60
64
  return (Array.isArray(value) ? next[""] : next);
61
65
  }
62
66
  /* ── Timing and distances ──────────────────────────────────────────────────── */
63
- /** Mouse and pen drags start after this many pixels, so a click stays a click. */
64
- const DRAG_THRESHOLD = 4;
65
- /** Touch drags start on a long press, so a swipe still scrolls. */
66
- const LONG_PRESS = 400;
67
- /** A touch that moves this far before the long press is a scroll. */
68
- const TOUCH_SLOP = 8;
69
- /** Within this many pixels of a scrolling edge, a drag scrolls it. */
70
- const EDGE = 56;
71
- /** The fastest autoscroll, in pixels a frame, right at the edge. */
72
- const SPEED = 14;
67
+ /** Over a drop zone, the copy shrinks to sit this far inside the zone's edges. */
68
+ const ZONE_INSET = 8;
73
69
  /** A release this far past the root's edge still lands in the nearest list; further out it cancels. */
74
70
  const DROP_MARGIN = 32;
75
71
  /** Controls on an item that keep their own clicks: a press on them never starts a drag. */
@@ -96,6 +92,7 @@ export function useSortable() {
96
92
  move: context.move,
97
93
  dragging: context.drag?.item ?? null,
98
94
  lifted: context.lifted?.item ?? null,
95
+ zone: (context.drag?.phase === "drag" && context.drag.zone) || null,
99
96
  };
100
97
  }
101
98
  /* ── Measuring ─────────────────────────────────────────────────────────────── */
@@ -192,55 +189,6 @@ function flip(els, before) {
192
189
  el.style.translate = "";
193
190
  });
194
191
  }
195
- /**
196
- * Scroll whatever scrolls under the pointer while it is held near an edge: the innermost
197
- * container, from the list outwards to the page, that can still move that way.
198
- */
199
- function autoScroll(from, x, y) {
200
- let doneX = false;
201
- let doneY = false;
202
- const page = document.scrollingElement ?? document.documentElement;
203
- for (let el = from; el && !(doneX && doneY); el = el.parentElement) {
204
- const isPage = el === page || el === document.body;
205
- const style = getComputedStyle(el);
206
- const rect = isPage
207
- ? new DOMRect(0, 0, window.innerWidth, window.innerHeight)
208
- : el.getBoundingClientRect();
209
- const target = isPage ? page : el;
210
- const step = (low, high, size) => {
211
- const edge = Math.min(EDGE, size / 4);
212
- if (low < edge)
213
- return -Math.ceil(SPEED * (1 - Math.max(low, 0) / edge));
214
- if (high < edge)
215
- return Math.ceil(SPEED * (1 - Math.max(high, 0) / edge));
216
- return 0;
217
- };
218
- if (!doneX &&
219
- (isPage || /auto|scroll/.test(style.overflowX)) &&
220
- target.scrollWidth > target.clientWidth) {
221
- const dx = step(x - rect.left, rect.right - x, rect.width);
222
- if (dx) {
223
- const before = target.scrollLeft;
224
- target.scrollLeft += dx;
225
- if (target.scrollLeft !== before)
226
- doneX = true;
227
- }
228
- }
229
- if (!doneY &&
230
- (isPage || /auto|scroll/.test(style.overflowY)) &&
231
- target.scrollHeight > target.clientHeight) {
232
- const dy = step(y - rect.top, rect.bottom - y, rect.height);
233
- if (dy) {
234
- const before = target.scrollTop;
235
- target.scrollTop += dy;
236
- if (target.scrollTop !== before)
237
- doneY = true;
238
- }
239
- }
240
- if (isPage)
241
- break;
242
- }
243
- }
244
192
  /**
245
193
  * Sortable — reorderable lists: one list, a row, a wrapping grid, or several lists that items
246
194
  * move between, as the columns of a board.
@@ -257,7 +205,8 @@ function autoScroll(from, x, y) {
257
205
  * Compose `Sortable` → `SortableList` → `SortableItem` → `SortableHandle`. The rule people break:
258
206
  * leaving out the handle. Without it there is no keyboard way to move an item.
259
207
  */
260
- export function Sortable({ value: valueProp, defaultValue, onValueChange, onMoveEnd, overlay, handleOnly = false, labels, render, className, children, ref, ...props }) {
208
+ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMoveEnd, onDragMove, overlay, handleOnly = false, labels, render, className, children, ref, ...props }) {
209
+ const portalContainer = usePortalContainer();
261
210
  const text = useMessages("sortable", defaultMessages, labels);
262
211
  const [uncontrolled, setUncontrolled] = React.useState(defaultValue ?? []);
263
212
  const value = valueProp ?? uncontrolled;
@@ -273,7 +222,7 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
273
222
  liftedRef.current = next;
274
223
  setLiftedState(next);
275
224
  };
276
- const [message, setMessage] = React.useState("");
225
+ const [message, announce] = useAnnouncer();
277
226
  const instructionsId = React.useId();
278
227
  const rootRef = React.useRef(null);
279
228
  const overlayRef = React.useRef(null);
@@ -282,10 +231,9 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
282
231
  const itemLabels = React.useRef(new Map());
283
232
  /** After a move that remounts an item in another list, focus goes back to this. */
284
233
  const refocus = React.useRef(null);
285
- const callbacks = React.useRef({ onValueChange, onMoveEnd });
286
- callbacks.current = { onValueChange, onMoveEnd };
287
- /** Say it again even when the words repeat: a trailing no-break space makes it a new message. */
288
- const announce = React.useCallback((words) => setMessage((prev) => (prev === words ? `${words} ` : words)), []);
234
+ const callbacks = React.useRef({ onValueChange, onMoveEnd, onDragMove });
235
+ callbacks.current = { onValueChange, onMoveEnd, onDragMove };
236
+ const zoneMap = React.useRef(new Map());
289
237
  const labelOf = (item) => itemLabels.current.get(item) ?? item;
290
238
  const describe = (current, place) => ({
291
239
  list: listMap.current.get(place.list)?.label,
@@ -331,6 +279,28 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
331
279
  listMap.current.delete(id);
332
280
  };
333
281
  }, []);
282
+ const registerZone = React.useCallback((id, entry) => {
283
+ zoneMap.current.set(id, entry);
284
+ return () => {
285
+ if (zoneMap.current.get(id) === entry)
286
+ zoneMap.current.delete(id);
287
+ };
288
+ }, []);
289
+ /**
290
+ * The drop zone under a point — the last one registered where two overlap. Read afresh each
291
+ * time: a zone may grow or move as a drag starts, and there are only ever a few.
292
+ */
293
+ const zoneAt = (x, y) => {
294
+ let found = null;
295
+ for (const [id, zone] of zoneMap.current) {
296
+ if (zone.props.current.disabled)
297
+ continue;
298
+ const r = zone.el.getBoundingClientRect();
299
+ if ((r.width || r.height) && x >= r.left && x <= r.right && y >= r.top && y <= r.bottom)
300
+ found = id;
301
+ }
302
+ return found;
303
+ };
334
304
  const setItemLabel = React.useCallback((item, label) => {
335
305
  itemLabels.current.set(item, label);
336
306
  }, []);
@@ -585,11 +555,23 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
585
555
  const el = overlayRef.current;
586
556
  if (!el)
587
557
  return;
558
+ const session = sessionRef.current;
559
+ // Over a drop zone the copy goes into it: centred there, and shrunk to fit inside its edges.
560
+ // Read every frame while it is over one, as the zone may grow around it.
561
+ const zone = session?.zone ? zoneMap.current.get(session.zone)?.el : undefined;
562
+ if (zone) {
563
+ const r = zone.getBoundingClientRect();
564
+ const w = el.offsetWidth;
565
+ const h = el.offsetHeight;
566
+ const fit = Math.min(1, (r.width - 2 * ZONE_INSET) / w, (r.height - 2 * ZONE_INSET) / h);
567
+ el.style.setProperty("--sortable-fit", String(Math.max(0.2, fit)));
568
+ el.style.translate = `${r.left + (r.width - w) / 2}px ${r.top + (r.height - h) / 2}px`;
569
+ return;
570
+ }
588
571
  const { x, y } = pointerRef.current;
589
572
  const offsetX = Number(el.dataset.offsetX);
590
573
  const offsetY = Number(el.dataset.offsetY);
591
574
  // Read only once it has been resized: the copy's box is not asked for on every move.
592
- const session = sessionRef.current;
593
575
  const resized = !!session?.resized;
594
576
  const left = resized ? offsetX * (el.offsetWidth / session.size.w || 1) : offsetX;
595
577
  const top = resized ? Math.min(offsetY, Math.max(0, el.offsetHeight - 1)) : offsetY;
@@ -619,39 +601,70 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
619
601
  let active = false;
620
602
  let frame = 0;
621
603
  let timer = 0;
604
+ /** The last frame's time, for the autoscroll's speed per millisecond. */
605
+ let lastTick = 0;
606
+ /** Each list's scrolling ancestors, read when the drag starts (or a list appears mid-drag). */
607
+ const scrollers = new Map();
622
608
  const bodyStyle = { userSelect: document.body.style.userSelect, cursor: document.body.style.cursor };
623
609
  /** Where a release now would put the item: nowhere past the root's edge. */
624
610
  const dropTarget = (session) => within(session.root, pointer.x, pointer.y)
625
611
  ? (placeAt(session, pointer.x, pointer.y)?.place ?? null)
626
612
  : null;
627
613
  const retarget = (session) => {
628
- const target = dropTarget(session);
614
+ // A drop zone wins over the lists: over one, the gap closes and the item shows at home.
615
+ const zone = zoneAt(pointer.x, pointer.y);
616
+ const target = zone ? null : dropTarget(session);
629
617
  const current = session.target;
630
- if (current?.list === target?.list && current?.index === target?.index)
618
+ if (current?.list === target?.list && current?.index === target?.index && session.zone === zone)
631
619
  return;
620
+ if (zone && zone !== session.zone) {
621
+ const name = zoneMap.current.get(zone)?.props.current.label ?? zone;
622
+ announce(text.overZone(labelOf(item), name));
623
+ }
624
+ // Into a zone and out again, the copy glides: to the zone's middle, then back under the pointer.
625
+ if (zone !== session.zone) {
626
+ const el = overlayRef.current;
627
+ if (el) {
628
+ const glide = "var(--duration, 150ms) var(--ease)";
629
+ el.style.transition = `translate ${glide}, width ${glide}`;
630
+ window.clearTimeout(session.glide);
631
+ if (!zone)
632
+ session.glide = window.setTimeout(() => {
633
+ if (!session.zone && overlayRef.current === el)
634
+ el.style.transition = `width ${glide}`;
635
+ }, 200);
636
+ }
637
+ }
632
638
  session.target = target;
639
+ session.zone = zone;
633
640
  // The copy first: its height in the list it comes over is the size of the gap there.
634
641
  fitCopy(session, target);
635
642
  showAt(session, target);
636
- setDrag((d) => (d ? { ...d, target } : d));
643
+ setDrag((d) => (d ? { ...d, target, zone } : d));
637
644
  };
638
645
  // Once a frame: read the rects again if something scrolled, scroll near the edges — not once
639
646
  // the pointer is past the root's edge: it is on its way out, and a release there cancels —
640
647
  // and open the gap where the item would land.
641
- const tick = () => {
648
+ const tick = (now) => {
642
649
  const session = sessionRef.current;
643
650
  if (!session)
644
651
  return;
652
+ const dt = Math.min(32, lastTick ? now - lastTick : 16);
653
+ lastTick = now;
645
654
  if (session.dirty)
646
655
  refresh(session);
647
- if (within(session.root, pointer.x, pointer.y)) {
656
+ if (!session.zone && within(session.root, pointer.x, pointer.y)) {
648
657
  const under = placeAt(session, pointer.x, pointer.y);
649
- if (under)
650
- autoScroll(under.list.el, pointer.x, pointer.y);
658
+ if (under) {
659
+ let chain = scrollers.get(under.list.el);
660
+ if (!chain)
661
+ scrollers.set(under.list.el, (chain = scrollersOf(under.list.el)));
662
+ autoScroll(chain, pointer.x, pointer.y, dt);
663
+ }
651
664
  }
652
665
  retarget(session);
653
666
  // A copy fitting another list's width keeps the pointer at the same share of it.
654
- if (session.resized)
667
+ if (session.resized || session.zone)
655
668
  placeOverlay();
656
669
  frame = requestAnimationFrame(tick);
657
670
  };
@@ -666,6 +679,8 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
666
679
  return end(false);
667
680
  before.current = null;
668
681
  const lists = measure();
682
+ for (const list of lists.values())
683
+ scrollers.set(list.el, scrollersOf(list.el));
669
684
  const rect = itemEl.getBoundingClientRect();
670
685
  sessionRef.current = {
671
686
  item,
@@ -677,11 +692,13 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
677
692
  root: rootRef.current?.getBoundingClientRect() ?? null,
678
693
  dirty: false,
679
694
  target: from,
695
+ zone: null,
680
696
  shifts: new Map(),
681
697
  };
682
698
  setDrag({
683
699
  item,
684
700
  target: from,
701
+ zone: null,
685
702
  width: rect.width,
686
703
  offsetX: startX - rect.left,
687
704
  offsetY: startY - rect.top,
@@ -718,6 +735,13 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
718
735
  begin();
719
736
  }
720
737
  placeOverlay();
738
+ // Where a release now would land, read for this move — the slides follow on the next frame.
739
+ const session = sessionRef.current;
740
+ const report = callbacks.current.onDragMove;
741
+ if (session && report) {
742
+ const zone = zoneAt(pointer.x, pointer.y);
743
+ report({ item, x: pointer.x, y: pointer.y, target: zone ? null : dropTarget(session), zone });
744
+ }
721
745
  };
722
746
  // Once a touch drag has started, the finger moves the item and not the page.
723
747
  const onTouchMove = (e) => {
@@ -763,12 +787,22 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
763
787
  }
764
788
  if (session.dirty)
765
789
  refresh(session);
790
+ // Released over a drop zone: the lists stay as they are, and the zone takes the item.
791
+ const zone = drop ? zoneAt(pointer.x, pointer.y) : null;
792
+ const entry = zone ? zoneMap.current.get(zone) : undefined;
793
+ if (zone && entry) {
794
+ announce(text.droppedOn(labelOf(item), entry.props.current.label));
795
+ entry.props.current.onDrop?.(item);
796
+ callbacks.current.onMoveEnd?.({ item, from, to: from, cancelled: false, zone });
797
+ setDrag((d) => (d ? { ...d, target: null, zone, phase: "settle", landed: null } : d));
798
+ return;
799
+ }
766
800
  // Escape, an interrupted touch, or a release past the root's edge: the item goes back.
767
801
  const target = drop ? dropTarget(session) : null;
768
802
  if (!target) {
769
803
  announce(text.cancelled(labelOf(item), describe(current, from)));
770
804
  callbacks.current.onMoveEnd?.({ item, from, to: from, cancelled: true });
771
- setDrag((d) => (d ? { ...d, target: null, phase: "settle", landed: null } : d));
805
+ setDrag((d) => (d ? { ...d, target: null, zone: null, phase: "settle", landed: null } : d));
772
806
  return;
773
807
  }
774
808
  const next = moveIn(current, item, target);
@@ -777,7 +811,7 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
777
811
  commit(next, { item, from, to, source: "pointer" });
778
812
  announce(text.dropped(labelOf(item), describe(next, to)));
779
813
  callbacks.current.onMoveEnd?.({ item, from, to, cancelled: false });
780
- setDrag((d) => (d ? { ...d, target: null, phase: "settle", landed: to } : d));
814
+ setDrag((d) => (d ? { ...d, target: null, zone: null, phase: "settle", landed: to } : d));
781
815
  };
782
816
  const onUp = (e) => {
783
817
  if (e.pointerId !== event.pointerId)
@@ -829,6 +863,33 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
829
863
  if (session)
830
864
  release(session, placed);
831
865
  const copy = overlayRef.current;
866
+ const glide = "calc(var(--duration, 150ms) * 4 / 3) var(--ease)";
867
+ /** Waits for the copy's transition, at most its duration and a little more, then ends. */
868
+ const settle = (el) => {
869
+ const seconds = parseFloat(getComputedStyle(el).transitionDuration);
870
+ if (!seconds)
871
+ return finish();
872
+ settleRef.current = finish;
873
+ const onEnd = (event) => {
874
+ if (event.target === el)
875
+ finish();
876
+ };
877
+ el.addEventListener("transitionend", onEnd);
878
+ const timeout = window.setTimeout(finish, seconds * 1000 + 100);
879
+ return () => {
880
+ el.removeEventListener("transitionend", onEnd);
881
+ clearTimeout(timeout);
882
+ };
883
+ };
884
+ // Dropped on a zone: the copy fades out where it was let go, into the zone.
885
+ if (drag.zone) {
886
+ if (!copy)
887
+ return finish();
888
+ copy.style.transition = `opacity ${glide}, scale ${glide}`;
889
+ copy.style.opacity = "0";
890
+ copy.style.scale = "0.9";
891
+ return settle(copy);
892
+ }
832
893
  let home;
833
894
  for (const entry of listMap.current.values())
834
895
  home ??= itemsOf(entry.el).find((el) => el.dataset.sortableItem === item);
@@ -842,25 +903,11 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
842
903
  copy.style.width = `${drawn.width}px`;
843
904
  copy.style.height = `${drawn.height}px`;
844
905
  void copy.offsetWidth;
845
- const glide = "calc(var(--duration, 150ms) * 4 / 3) var(--ease)";
846
906
  copy.style.transition = `translate ${glide}, width ${glide}, height ${glide}`;
847
907
  copy.style.translate = `${rect.left}px ${rect.top}px`;
848
908
  copy.style.width = `${rect.width}px`;
849
909
  copy.style.height = `${rect.height}px`;
850
- const seconds = parseFloat(getComputedStyle(copy).transitionDuration);
851
- if (!seconds)
852
- return finish();
853
- settleRef.current = finish;
854
- const onEnd = (event) => {
855
- if (event.target === copy)
856
- finish();
857
- };
858
- copy.addEventListener("transitionend", onEnd);
859
- const timeout = window.setTimeout(finish, seconds * 1000 + 100);
860
- return () => {
861
- copy.removeEventListener("transitionend", onEnd);
862
- clearTimeout(timeout);
863
- };
910
+ return settle(copy);
864
911
  // eslint-disable-next-line react-hooks/exhaustive-deps
865
912
  }, [drag?.phase]);
866
913
  // The value changed under a drag — from outside, as nothing of ours commits before the drop:
@@ -1122,6 +1169,7 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
1122
1169
  instructionsId,
1123
1170
  text,
1124
1171
  registerList,
1172
+ registerZone,
1125
1173
  setItemLabel,
1126
1174
  startPointer,
1127
1175
  onHandleKeyDown,
@@ -1143,14 +1191,14 @@ export function Sortable({ value: valueProp, defaultValue, onValueChange, onMove
1143
1191
  },
1144
1192
  });
1145
1193
  return (_jsxs(SortableContext.Provider, { value: context, children: [element, drag &&
1146
- createPortal(_jsx("div", { ref: overlayRef, "aria-hidden": true, inert: true, dir: drag.dir, "data-slot": "sortable-overlay", "data-offset-x": drag.offsetX, "data-offset-y": drag.offsetY, className: "pointer-events-none fixed top-0 left-0 z-50 list-none", style: { width: drag.width }, children: overlay && (_jsx(SortableItemContext.Provider, { value: {
1194
+ createPortal(_jsx("div", { ref: overlayRef, "aria-hidden": true, inert: true, dir: drag.dir, "data-slot": "sortable-overlay", "data-phase": drag.phase, "data-over-zone": drag.zone ? "" : undefined, "data-offset-x": drag.offsetX, "data-offset-y": drag.offsetY, className: "pointer-events-none fixed top-0 left-0 z-50 list-none", style: { width: drag.width }, children: overlay && (_jsx(SortableItemContext.Provider, { value: {
1147
1195
  value: drag.item,
1148
1196
  label: labelOf(drag.item),
1149
1197
  disabled: false,
1150
1198
  dragging: false,
1151
1199
  lifted: false,
1152
1200
  overlay: true,
1153
- }, children: overlay(drag.item) })) }), document.body)] }));
1201
+ }, children: overlay(drag.item) })) }), portalContainer ?? document.body)] }));
1154
1202
  }
1155
1203
  /**
1156
1204
  * One list of items, an `<ol>` by default. Items keep the order of `value`; render them in it.
@@ -1256,3 +1304,48 @@ export function SortableHandle({ variant = "ghost", size = "icon-sm", className,
1256
1304
  }, className: sx("cursor-grab touch-none text-muted-foreground active:cursor-grabbing", className), ...props, children: children ??
1257
1305
  (orientation === "grid" ? (_jsx(GripIcon, {})) : orientation === "horizontal" ? (_jsx(GripHorizontalIcon, {})) : (_jsx(GripVerticalIcon, {}))) }));
1258
1306
  }
1307
+ /**
1308
+ * A place outside the lists that takes a dragged item — a trash can, an archive, a "move to
1309
+ * another project" target. It can sit anywhere inside `Sortable` in the React tree, even fixed to
1310
+ * a corner of the screen or in a portal. Released over it, the item stays in the lists (the value
1311
+ * is unchanged), `onDrop(item)` is called, and the copy fades out there; remove the item yourself.
1312
+ * It has `data-active` while an item is dragged with the pointer, so it can appear or grow, and
1313
+ * `data-over` while the pointer is over it. Over it, the dragged copy glides into its middle and
1314
+ * shrinks to sit 8px inside its edges, following it as it grows: open it up under `data-over` to
1315
+ * hold the item at the size you want. It draws no surface of its own.
1316
+ *
1317
+ * The rule people break: making it the only way to do the thing. A drop zone is for the pointer;
1318
+ * give each item a button or a menu item that does the same, for the keyboard and for touch.
1319
+ */
1320
+ export function SortableDropZone({ id: idProp, label, onDrop, disabled = false, render, className, children, ref, ...props }) {
1321
+ const context = useSortableContext("SortableDropZone");
1322
+ const generated = React.useId();
1323
+ const id = idProp ?? generated;
1324
+ const own = React.useRef(null);
1325
+ const current = React.useRef({ label, onDrop, disabled });
1326
+ current.current = { label, onDrop, disabled };
1327
+ const { registerZone, drag } = context;
1328
+ React.useLayoutEffect(() => {
1329
+ if (!own.current)
1330
+ return;
1331
+ return registerZone(id, { el: own.current, props: current });
1332
+ }, [registerZone, id]);
1333
+ const active = !disabled && drag?.phase === "drag";
1334
+ const over = active && drag?.zone === id;
1335
+ const refs = React.useMemo(() => mergeRefs(ref, own), [ref]);
1336
+ return useRender({
1337
+ defaultTagName: "div",
1338
+ render,
1339
+ ref: refs,
1340
+ props: {
1341
+ "data-slot": "sortable-drop-zone",
1342
+ "data-sortable-drop-zone": id,
1343
+ "data-active": active ? "" : undefined,
1344
+ "data-over": over ? "" : undefined,
1345
+ "data-disabled": disabled ? "" : undefined,
1346
+ ...props,
1347
+ className,
1348
+ children,
1349
+ },
1350
+ });
1351
+ }
@@ -7,7 +7,7 @@ export interface SourcesMessages {
7
7
  newTab: string;
8
8
  }
9
9
  declare module "./locale" {
10
- interface Messages {
10
+ interface LocaleMessages {
11
11
  sources: SourcesMessages;
12
12
  }
13
13
  }
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
- import { ArrowUpRightIcon } from "lucide-react";
3
+ import { ArrowUpRightIcon } from "../lib/icons.js";
4
4
  import { cn, sx } from "../lib/cn.js";
5
5
  import { Collapsible, CollapsiblePanel, CollapsibleTrigger, } from "./collapsible.js";
6
6
  import { useMessages } from "./locale.js";
@@ -38,5 +38,5 @@ const hostOf = (href) => {
38
38
  /** One source: the site in mono, the title, and an arrow; it opens in a new tab. */
39
39
  export function Source({ href, title, labels, className, children, ...props }) {
40
40
  const text = useMessages("sources", defaultMessages, labels);
41
- return (_jsx("li", { "data-slot": "source", children: _jsxs("a", { href: href, target: "_blank", rel: "noopener noreferrer", className: cn("flex min-h-(--control-h-sm) min-w-0 items-center gap-3 rounded-item material-row px-2.5 text-[13px] no-underline focus-ring", className), ...props, children: [_jsx("span", { className: "w-32 shrink-0 truncate font-mono text-[11px] text-muted-foreground", children: hostOf(href) }), _jsx("span", { className: "min-w-0 flex-1 truncate", children: children ?? title ?? href }), _jsx(ArrowUpRightIcon, { "aria-hidden": true, className: "size-3.5 shrink-0 text-muted-foreground rtl:-scale-x-100" }), _jsx("span", { className: "sr-only", children: text.newTab })] }) }));
41
+ return (_jsx("li", { "data-slot": "source", children: _jsxs("a", { href: href, target: "_blank", rel: "noopener noreferrer", className: cn("flex min-h-(--control-h-sm) min-w-0 items-center gap-3 rounded-item material-row px-2.5 text-13 no-underline focus-ring", className), ...props, children: [_jsx("span", { className: "w-[min(8rem,28%)] shrink-0 truncate font-mono text-11 text-muted-foreground", children: hostOf(href) }), _jsx("span", { className: "min-w-0 flex-1 truncate", children: children ?? title ?? href }), _jsx(ArrowUpRightIcon, { "aria-hidden": true, className: "size-3.5 shrink-0 text-muted-foreground rtl:-scale-x-100" }), _jsx("span", { className: "sr-only", children: text.newTab })] }) }));
42
42
  }
@@ -4,14 +4,14 @@ export interface SpinnerMessages {
4
4
  loading: string;
5
5
  }
6
6
  declare module "./locale" {
7
- interface Messages {
7
+ interface LocaleMessages {
8
8
  spinner: SpinnerMessages;
9
9
  }
10
10
  }
11
11
  declare const spinnerSizes: {
12
- readonly sm: "size-3 text-[12px]";
13
- readonly default: "size-4 text-[16px]";
14
- readonly lg: "size-5 text-[20px]";
12
+ readonly sm: "size-3 text-[length:--spacing(3)]";
13
+ readonly default: "size-4 text-[length:--spacing(4)]";
14
+ readonly lg: "size-5 text-[length:--spacing(5)]";
15
15
  };
16
16
  export type SpinnerSize = keyof typeof spinnerSizes;
17
17
  export type SpinnerVariant = "ring" | "arc" | "dots" | "bars" | "pulse" | "orbit" | "grid" | "cursor" | "ascii" | "brackets" | "crescent";
@@ -1,15 +1,15 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
- import { LoaderCircleIcon } from "lucide-react";
3
+ import { LoaderCircleIcon } from "../lib/icons.js";
4
4
  import { useId } from "react";
5
5
  import { cn } from "../lib/cn.js";
6
6
  import { bracketGeometry } from "../lib/logo-geometry.js";
7
7
  import { useMessages } from "./locale.js";
8
8
  const defaultMessages = { loading: "Loading" };
9
9
  const spinnerSizes = {
10
- sm: "size-3 text-[12px]",
11
- default: "size-4 text-[16px]",
12
- lg: "size-5 text-[20px]",
10
+ sm: "size-3 text-[length:--spacing(3)]",
11
+ default: "size-4 text-[length:--spacing(4)]",
12
+ lg: "size-5 text-[length:--spacing(5)]",
13
13
  };
14
14
  /** Every variant, in gallery order. */
15
15
  export const SPINNER_VARIANTS = [
@@ -6,9 +6,13 @@ export interface StatMessages {
6
6
  down: (change: string) => string;
7
7
  /** Read when the change is zero. */
8
8
  unchanged: string;
9
+ /** Read for the figure while it is `loading`. */
10
+ loading: string;
11
+ /** Read for a figure that has no value (`null`), shown as "—". */
12
+ noData: string;
9
13
  }
10
14
  declare module "./locale" {
11
- interface Messages {
15
+ interface LocaleMessages {
12
16
  stat: StatMessages;
13
17
  }
14
18
  }
@@ -48,12 +52,25 @@ declare const valueSizes: {
48
52
  readonly lg: "text-3xl";
49
53
  };
50
54
  export interface StatProps extends Omit<React.ComponentProps<"div">, "children"> {
51
- /** What is counted, as a short eyebrow: "Orders", "Takings (sample)". */
55
+ /** What is counted, as a short eyebrow: "Orders", "Takings". */
52
56
  label: React.ReactNode;
53
- /** The figure. A number is formatted for the locale with `format`; text is shown as it is — keep the unit in it. */
57
+ /**
58
+ * The figure. A number is formatted for the locale with `format`; text is shown as it is — keep
59
+ * the unit in it. `null` (or `NaN`) is a figure with no value: it shows as "—", read as "No data".
60
+ */
54
61
  value: React.ReactNode;
62
+ /**
63
+ * The figure is on its way: a placeholder stands in for the value and the change, the label
64
+ * stays, and the Stat is `aria-busy`. Keep the row's other Stats as they are.
65
+ */
66
+ loading?: boolean;
55
67
  /** `Intl.NumberFormat` options for a number `value`: `{ style: "currency", currency: "EUR" }`. */
56
68
  format?: Intl.NumberFormatOptions;
69
+ /**
70
+ * Roll a number `value`'s changed digits to the new value, like `NumberRoll`: for a figure that
71
+ * changes in front of someone. Default `false`.
72
+ */
73
+ roll?: boolean;
57
74
  /**
58
75
  * The change against the period before, signed: `0.12` is a rise of 12% with the default
59
76
  * format. It shows as an arrow, the amount and, when it is good or bad, the status colour.
@@ -87,5 +104,5 @@ export interface StatProps extends Omit<React.ComponentProps<"div">, "children">
87
104
  * people break: inventing figures to fill a row, and colouring every change. A figure that
88
105
  * isn't measured stays out, and a change that is only news is `better="neither"`.
89
106
  */
90
- export declare function Stat({ label, value, format, change, changeFormat, changeLabel, better, description, series, size, labels, className, ...props }: StatProps): React.JSX.Element;
107
+ export declare function Stat({ label, value, format, roll, change, changeFormat, changeLabel, better, description, series, size, loading, labels, className, ...props }: StatProps): React.JSX.Element;
91
108
  export {};