@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
@@ -3,16 +3,16 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { Button as BaseButton } from "@base-ui/react/button";
4
4
  import { Field as BaseField } from "@base-ui/react/field";
5
5
  import { Input as BaseInput } from "@base-ui/react/input";
6
- import { XIcon } from "lucide-react";
6
+ import { XIcon } from "../lib/icons.js";
7
7
  import * as React from "react";
8
8
  import { cn, sx } from "../lib/cn.js";
9
9
  import { mergeRefs } from "../lib/merge-refs.js";
10
- import { cssDuration } from "../lib/motion.js";
10
+ import { cssDuration, cssEase } from "../lib/motion.js";
11
11
  import { useMessages } from "./locale.js";
12
12
  const defaultMessages = { showPassword: "Show password", clear: "Clear" };
13
13
  const groupSizes = {
14
- sm: "min-h-(--control-h-sm) text-[13px]",
15
- default: "min-h-(--control-h) text-base sm:text-[15px]",
14
+ sm: "min-h-(--control-h-sm) text-13 pointer-coarse:text-base",
15
+ default: "min-h-(--control-h) text-base sm:text-15",
16
16
  };
17
17
  /**
18
18
  * InputGroup — one recessed field that holds an input (or textarea) together with addons:
@@ -56,7 +56,7 @@ export function InputGroupInput({ className, ...props }) {
56
56
  export function InputGroupTextarea({ className, ...props }) {
57
57
  return (_jsx(BaseField.Control, { "data-slot": "input-group-control", render: _jsx("textarea", {}), className: sx([
58
58
  controlBase,
59
- "field-sizing-content max-h-60 min-h-24 w-full resize-none px-3.5 py-3 text-base sm:text-[15px]",
59
+ "field-sizing-content max-h-60 min-h-24 w-full resize-none px-3.5 py-3 text-base sm:text-15",
60
60
  "group-has-[>[data-align=block-end]]/input-group:pb-1.5 group-has-[>[data-align=block-start]]/input-group:pt-1.5",
61
61
  ], className), ...props }));
62
62
  }
@@ -91,7 +91,7 @@ export function InputGroupAddon({ align = "inline-start", className, onMouseDown
91
91
  }
92
92
  /** Plain text inside an addon: a prefix, a suffix or a count. Licht Mono, muted, tabular. */
93
93
  export function InputGroupText({ className, ...props }) {
94
- return (_jsx("span", { "data-slot": "input-group-text", className: cn("flex items-center gap-1.5 font-mono text-[13px] whitespace-nowrap text-muted-foreground tabular-nums", "group-data-[size=sm]/input-group:text-xs [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3.5", className), ...props }));
94
+ return (_jsx("span", { "data-slot": "input-group-text", className: cn("flex items-center gap-1.5 font-mono text-13 whitespace-nowrap text-muted-foreground tabular-nums", "group-data-[size=sm]/input-group:text-xs [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3.5", className), ...props }));
95
95
  }
96
96
  const buttonVariants = {
97
97
  secondary: "material-raised",
@@ -104,7 +104,7 @@ const buttonSizes = {
104
104
  /** 24px — fits the dense group, or a quiet action in the default one. */
105
105
  sm: "min-h-(--control-inset-sm) gap-1 rounded-(--input-group-button-radius) px-2 text-xs leading-none",
106
106
  /** 30px — fits the 38px group with a 3px inset, like a segment. */
107
- default: "min-h-(--control-inset) gap-1.5 rounded-(--input-group-button-radius) px-2.5 text-[13px] leading-none",
107
+ default: "min-h-(--control-inset) gap-1.5 rounded-(--input-group-button-radius) px-2.5 text-13 leading-none",
108
108
  "icon-sm": "size-(--control-inset-sm) rounded-full p-0 [&_svg:not([class*='size-'])]:size-[min(14px,calc(var(--control-inset-sm)-4px))]",
109
109
  icon: "size-(--control-inset) rounded-full p-0",
110
110
  };
@@ -126,10 +126,10 @@ export function InputGroupButton({ variant = "secondary", size = "default", clas
126
126
  }
127
127
  /*
128
128
  * The reveal sweeps: on a press, the field's new text — or its dots — is uncovered left to right
129
- * behind a soft 32px edge, across the text itself rather than the whole field, on 2.2 × --duration
130
- * with the press's ease-out (the brand ease spends most of its way in a frame or two, too soon to
131
- * see). The value is there at once and the field stays usable, so revealing a password many times
132
- * a day never means waiting. Only a press of the toggle plays it; reduced motion skips it.
129
+ * behind a soft 32px edge, across the text itself rather than the whole field, over 2 × --duration
130
+ * on --ease-glide (the brand ease spends most of its way in a frame or two, too soon to see). The
131
+ * value is there at once and the field stays usable, so revealing a password many times a day
132
+ * never means waiting. Only a press of the toggle plays it; reduced motion skips it.
133
133
  */
134
134
  let measurer = null;
135
135
  /**
@@ -190,7 +190,7 @@ const groupInput = (el) => el
190
190
  * `aria-pressed` while the password is shown — a toggle's name never changes with its state.
191
191
  * Switch the input's `type` with `visible`.
192
192
  */
193
- export function InputGroupPasswordToggle({ visible, onVisibleChange, label, labels, ref, onClick, ...props }) {
193
+ export function InputGroupPasswordToggle({ visible, onVisibleChange, label, ref, onClick, ...props }) {
194
194
  const text = useMessages("inputGroup", defaultMessages);
195
195
  const own = React.useRef(null);
196
196
  const pressed = React.useRef(false);
@@ -207,9 +207,9 @@ export function InputGroupPasswordToggle({ visible, onVisibleChange, label, labe
207
207
  const duration = cssDuration(input) * 2;
208
208
  if (!duration)
209
209
  return;
210
- input.animate(sweepFrames(input), { duration, easing: "cubic-bezier(0.33, 1, 0.68, 1)" });
210
+ input.animate(sweepFrames(input), { duration, easing: cssEase("--ease-glide", input) });
211
211
  }, [visible]);
212
- return (_jsx(InputGroupButton, { ref: refs, "data-password-toggle": "", variant: "ghost", size: "icon", "aria-label": label ?? labels?.show ?? text.showPassword, "aria-pressed": visible, onClick: (event) => {
212
+ return (_jsx(InputGroupButton, { ref: refs, "data-password-toggle": "", variant: "ghost", size: "icon", "aria-label": label ?? text.showPassword, "aria-pressed": visible, onClick: (event) => {
213
213
  pressed.current = true;
214
214
  onVisibleChange(!visible);
215
215
  onClick?.(event);
@@ -232,7 +232,7 @@ function EyeSlashIcon({ slashed }) {
232
232
  * InputGroupClearButton — empties the field it sits in, smoothly: the text is erased right to
233
233
  * left behind a soft edge, as if typed away, then the value clears and focus returns to the
234
234
  * field. The button fades out while the field is empty and back in when there is text, instead of
235
- * popping in and out. Reduced motion clears at once.
235
+ * popping in and out. The keyboard (Enter, Space) and reduced motion clear at once.
236
236
  */
237
237
  export function InputGroupClearButton({ onClear, label, ref, className, ...props }) {
238
238
  const text = useMessages("inputGroup", defaultMessages);
@@ -267,7 +267,7 @@ export function InputGroupClearButton({ onClear, label, ref, className, ...props
267
267
  input.form?.removeEventListener("reset", reset);
268
268
  };
269
269
  }, []);
270
- const clear = () => {
270
+ const clear = (event) => {
271
271
  const input = groupInput(own.current);
272
272
  if (!input || clearing.current)
273
273
  return;
@@ -281,7 +281,9 @@ export function InputGroupClearButton({ onClear, label, ref, className, ...props
281
281
  }
282
282
  input.focus();
283
283
  };
284
- const duration = cssDuration(input) * 1.6;
284
+ // One --duration, and none for Enter or Space (a click with no pointer, detail 0): a keyboard
285
+ // action never waits for an animation.
286
+ const duration = event.detail === 0 ? 0 : cssDuration(input);
285
287
  if (!duration || input.value === "") {
286
288
  done();
287
289
  return;
@@ -291,7 +293,7 @@ export function InputGroupClearButton({ onClear, label, ref, className, ...props
291
293
  // Held at its end until the value is really gone, so the text never flashes back.
292
294
  const erase = input.animate(sweepFrames(input, true), {
293
295
  duration,
294
- easing: "cubic-bezier(0.33, 1, 0.68, 1)",
296
+ easing: cssEase("--ease-glide", input),
295
297
  fill: "forwards",
296
298
  });
297
299
  erase.onfinish = () => {
@@ -308,5 +310,5 @@ export function InputGroupClearButton({ onClear, label, ref, className, ...props
308
310
  return (_jsx(InputGroupButton, { ref: refs, "data-clear-button": "", "data-empty": empty ? "" : undefined, variant: "ghost", size: "icon", "aria-label": label ?? text.clear, "aria-hidden": empty || undefined, tabIndex: empty ? -1 : undefined, onClick: clear, className: cn(
309
311
  // The fade rides the material's own transition list (--material-motion), which a transition
310
312
  // utility would replace.
311
- "[--material-motion:opacity_var(--duration)_var(--ease),scale_var(--duration)_var(--ease)] data-empty:pointer-events-none data-empty:scale-75 data-empty:opacity-0", className), ...props, children: _jsx(XIcon, {}) }));
313
+ "[--material-motion:opacity_var(--duration-fade)_var(--ease),scale_var(--duration)_var(--ease)] data-empty:pointer-events-none data-empty:scale-75 data-empty:opacity-0", className), ...props, children: _jsx(XIcon, {}) }));
312
314
  }
@@ -1,7 +1,7 @@
1
1
  import { Input as BaseInput } from "@base-ui/react/input";
2
2
  declare const sizes: {
3
- readonly sm: "min-h-(--control-h-sm) px-2.5 text-[13px] [&[type=file]]:p-0.5 [&[type=file]]:leading-none file:h-(--control-inset-sm)";
4
- readonly default: "min-h-(--control-h) px-3.5 text-base sm:text-[15px] [&[type=file]]:p-[3px] [&[type=file]]:leading-none file:h-(--control-inset)";
3
+ readonly sm: "min-h-(--control-h-sm) px-2.5 text-13 pointer-coarse:text-base [&[type=file]]:p-0.5 [&[type=file]]:leading-none file:h-(--control-inset-sm)";
4
+ readonly default: "min-h-(--control-h) px-3.5 text-base sm:text-15 [&[type=file]]:p-[3px] [&[type=file]]:leading-none file:h-(--control-inset)";
5
5
  };
6
6
  export interface InputProps extends Omit<BaseInput.Props, "size"> {
7
7
  /** `sm` (30px) for dense surfaces; `default` (38px) everywhere else. */
@@ -3,8 +3,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
3
3
  import { Input as BaseInput } from "@base-ui/react/input";
4
4
  import { sx } from "../lib/cn.js";
5
5
  const sizes = {
6
- sm: "min-h-(--control-h-sm) px-2.5 text-[13px] [&[type=file]]:p-0.5 [&[type=file]]:leading-none file:h-(--control-inset-sm)",
7
- default: "min-h-(--control-h) px-3.5 text-base sm:text-[15px] [&[type=file]]:p-[3px] [&[type=file]]:leading-none file:h-(--control-inset)",
6
+ sm: "min-h-(--control-h-sm) px-2.5 text-13 pointer-coarse:text-base [&[type=file]]:p-0.5 [&[type=file]]:leading-none file:h-(--control-inset-sm)",
7
+ default: "min-h-(--control-h) px-3.5 text-base sm:text-15 [&[type=file]]:p-[3px] [&[type=file]]:leading-none file:h-(--control-inset)",
8
8
  };
9
9
  /**
10
10
  * Input — a recessed single-line field. 10px radius, 38px default, 30px dense, full width of
@@ -17,7 +17,7 @@ export function Input({ size = "default", className, ...props }) {
17
17
  // A file input's "Choose file" is a small raised button inside the field, inset like an
18
18
  // InputGroup button (30px in 38, 24px in 30, 7px corners); the file name stays quiet.
19
19
  "[&[type=file]]:cursor-pointer [&[type=file]]:text-muted-foreground",
20
- "file:me-3 file:cursor-pointer file:rounded-item file:border-0 file:bg-control-surface file:bg-linear-to-b file:from-control-inner-edge file:to-transparent file:px-3 file:font-body file:text-[13px] file:font-medium file:text-foreground file:shadow-raised file:hover:bg-control-hover",
20
+ "file:me-3 file:cursor-pointer file:rounded-item file:border-0 file:bg-control-surface file:bg-linear-to-b file:from-control-inner-edge file:to-transparent file:px-3 file:font-body file:text-13 file:font-medium file:text-foreground file:shadow-raised file:hover:bg-control-hover",
21
21
  // The search field's clear button (×) is a button: it takes the pointer.
22
22
  "[&::-webkit-search-cancel-button]:cursor-pointer",
23
23
  sizes[size],
@@ -11,9 +11,9 @@ declare const itemVariants: {
11
11
  };
12
12
  declare const itemSizes: {
13
13
  /** 46px minimum: title + description. */
14
- readonly default: "min-h-(--control-h-lg) gap-4 px-4 py-3";
14
+ readonly default: "min-h-(--control-h-lg) gap-4 px-4 py-[calc((var(--control-h-lg)-22px)/2)]";
15
15
  /** 38px minimum: dense lists, settings rows. */
16
- readonly sm: "min-h-(--control-h) gap-3 px-3 py-2";
16
+ readonly sm: "min-h-(--control-h) gap-3 px-3 py-[calc((var(--control-h)-22px)/2)]";
17
17
  };
18
18
  export type ItemVariant = keyof typeof itemVariants;
19
19
  export type ItemSize = keyof typeof itemSizes;
@@ -33,12 +33,15 @@ export interface ItemProps extends useRender.ComponentProps<"div"> {
33
33
  */
34
34
  export declare function Item({ variant, size, render, ref, className, ...props }: ItemProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
35
35
  declare const itemMediaVariants: {
36
- /** The child as is — an `Avatar`, a lucide icon at 20px. */
37
- readonly default: "[&_svg:not([class*='size-'])]:size-5";
36
+ /**
37
+ * The child as is — an `Avatar`, a lucide icon at 20px. An SVG that sizes itself (`size-*`,
38
+ * `h-*` or `w-*`: a product drawing, an illustration) keeps its size.
39
+ */
40
+ readonly default: "[&_svg:not([class*='size-'],[class^='h-'],[class*='_h-'],[class^='w-'],[class*='_w-'])]:size-5";
38
41
  /** A raised 32px key with 7px corners holding a 16px icon. */
39
42
  readonly icon: "size-8 rounded-item text-foreground [&_svg:not([class*='size-'])]:size-4 bg-control-surface bg-linear-to-b from-control-inner-edge to-transparent shadow-raised";
40
- /** A 40px thumbnail with 7px corners; the image covers it. */
41
- readonly image: "size-10 overflow-hidden rounded-item ring-1 ring-field-edge [&_img]:size-full [&_img]:object-cover";
43
+ /** A 40px thumbnail with 7px corners; the image — an `<img>` or an `<svg>` — fills it. */
44
+ readonly image: "size-10 overflow-hidden rounded-item ring-1 ring-field-edge [&_img]:size-full [&_img]:object-cover [&>svg]:size-full";
42
45
  };
43
46
  export type ItemMediaVariant = keyof typeof itemMediaVariants;
44
47
  export interface ItemMediaProps extends React.ComponentProps<"div"> {
@@ -28,9 +28,11 @@ const itemVariants = {
28
28
  };
29
29
  const itemSizes = {
30
30
  /** 46px minimum: title + description. */
31
- default: "min-h-(--control-h-lg) gap-4 px-4 py-3",
31
+ // The padding follows the control height too: a one-line item is exactly the height, and one
32
+ // with a description grows with it (12px and 8px at zon's 46 and 38).
33
+ default: "min-h-(--control-h-lg) gap-4 px-4 py-[calc((var(--control-h-lg)-22px)/2)]",
32
34
  /** 38px minimum: dense lists, settings rows. */
33
- sm: "min-h-(--control-h) gap-3 px-3 py-2",
35
+ sm: "min-h-(--control-h) gap-3 px-3 py-[calc((var(--control-h)-22px)/2)]",
34
36
  };
35
37
  /**
36
38
  * Item — a flexible row: media, a title and description, and actions. For people, files,
@@ -52,17 +54,20 @@ export function Item({ variant = "default", size = "default", render, ref, class
52
54
  "data-variant": variant,
53
55
  "data-size": size,
54
56
  ...props,
55
- className: cn("group/item flex w-full flex-wrap items-center rounded-button border border-transparent text-start text-sm text-foreground no-underline focus-ring sm:flex-nowrap", "transition-[background-color,color,box-shadow] duration-(--duration) ease-(--ease)", interactive, itemSizes[size], itemVariants[variant], className),
57
+ className: cn("group/item flex w-full flex-wrap items-center rounded-button border border-transparent text-start text-sm text-foreground no-underline focus-ring sm:flex-nowrap", "transition-[background-color,color,box-shadow] duration-(--duration-fade) ease-(--ease)", interactive, itemSizes[size], itemVariants[variant], className),
56
58
  },
57
59
  });
58
60
  }
59
61
  const itemMediaVariants = {
60
- /** The child as is — an `Avatar`, a lucide icon at 20px. */
61
- default: "[&_svg:not([class*='size-'])]:size-5",
62
+ /**
63
+ * The child as is — an `Avatar`, a lucide icon at 20px. An SVG that sizes itself (`size-*`,
64
+ * `h-*` or `w-*`: a product drawing, an illustration) keeps its size.
65
+ */
66
+ default: "[&_svg:not([class*='size-'],[class^='h-'],[class*='_h-'],[class^='w-'],[class*='_w-'])]:size-5",
62
67
  /** A raised 32px key with 7px corners holding a 16px icon. */
63
68
  icon: `size-8 rounded-item text-foreground [&_svg:not([class*='size-'])]:size-4 ${raised}`,
64
- /** A 40px thumbnail with 7px corners; the image covers it. */
65
- image: "size-10 overflow-hidden rounded-item ring-1 ring-field-edge [&_img]:size-full [&_img]:object-cover",
69
+ /** A 40px thumbnail with 7px corners; the image — an `<img>` or an `<svg>` — fills it. */
70
+ image: "size-10 overflow-hidden rounded-item ring-1 ring-field-edge [&_img]:size-full [&_img]:object-cover [&>svg]:size-full",
66
71
  };
67
72
  /** The leading visual: an avatar or icon (`default`), a raised icon key (`icon`) or a thumbnail (`image`). */
68
73
  export function ItemMedia({ variant = "default", className, ...props }) {
@@ -78,7 +83,7 @@ export function ItemTitle({ className, ...props }) {
78
83
  }
79
84
  /** One or two lines of muted detail; clamped at two. */
80
85
  export function ItemDescription({ className, ...props }) {
81
- return (_jsx("p", { "data-slot": "item-description", className: cn("m-0 line-clamp-2 text-[13px] leading-normal [overflow-wrap:anywhere] text-muted-foreground [&_a]:link", className), ...props }));
86
+ return (_jsx("p", { "data-slot": "item-description", className: cn("m-0 line-clamp-2 text-13 leading-normal [overflow-wrap:anywhere] text-muted-foreground [&_a]:link", className), ...props }));
82
87
  }
83
88
  /** Trailing actions or meta: small buttons, a `Switch`, a `Tag`, a mono value. */
84
89
  export function ItemActions({ className, ...props }) {
@@ -12,7 +12,7 @@ export interface KbdMessages {
12
12
  enter: string;
13
13
  }
14
14
  declare module "./locale" {
15
- interface Messages {
15
+ interface LocaleMessages {
16
16
  kbd: KbdMessages;
17
17
  }
18
18
  }
@@ -15,7 +15,7 @@ export function useKeyNames() {
15
15
  */
16
16
  export const kbdClassName = cn(
17
17
  // A key keeps its size in a tight row: squeezed, its label would spill over the next key.
18
- "inline-flex min-h-5 min-w-5 shrink-0 items-center justify-center rounded-checkbox px-1.5 font-mono text-[11px] leading-none font-normal text-foreground-soft select-none", "bg-control-surface bg-linear-to-b from-control-inner-edge to-transparent shadow-key", "[&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3");
18
+ "inline-flex min-h-(--kbd-h) min-w-(--kbd-h) shrink-0 items-center justify-center rounded-checkbox px-1.5 font-mono text-11 leading-none font-normal text-foreground-soft select-none", "bg-control-surface bg-linear-to-b from-control-inner-edge to-transparent shadow-key", "[&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3");
19
19
  /**
20
20
  * Kbd — a keyboard key, as a raised mini key: Licht Mono 11px, 20px tall, 5px radius.
21
21
  *
@@ -116,7 +116,8 @@ export interface GrainProps extends HTMLAttributes<HTMLDivElement> {
116
116
  }
117
117
  /**
118
118
  * Grain — an animated film-grain overlay that fills its positioned parent. It is
119
- * `aria-hidden`, ignores the pointer and holds still under reduced motion.
119
+ * `aria-hidden`, ignores the pointer and holds still under reduced motion, and on a phone or
120
+ * a touch screen: it moves only on a desktop.
120
121
  *
121
122
  * Use it on dark or large expressive regions to take the digital edge off a flat ground.
122
123
  * The rule people break: putting it over small text, where it costs contrast.
@@ -89,6 +89,8 @@ export function Blueprint({ cell, interactive = true, className, style, children
89
89
  const ref = useRef(null);
90
90
  const enabled = useRef(false);
91
91
  const frame = useRef(0);
92
+ /** Where the light is drawn, and where the pointer is: the light eases after it, frame by frame. */
93
+ const light = useRef({ x: 0, y: 0, cx: 0, cy: 0, last: 0, placed: false });
92
94
  useEffect(() => {
93
95
  if (!interactive || typeof window === "undefined" || !window.matchMedia)
94
96
  return;
@@ -103,25 +105,66 @@ export function Blueprint({ cell, interactive = true, className, style, children
103
105
  return () => {
104
106
  mq.removeEventListener("change", sync);
105
107
  cancelAnimationFrame(frame.current);
108
+ frame.current = 0;
106
109
  };
107
110
  }, [interactive]);
111
+ /**
112
+ * One frame of the light: it closes most of the way to the pointer (by the time since the last
113
+ * frame, so the same at any refresh rate) and keeps going until it is there. Tied to the pointer
114
+ * directly it moved like a cursor; easing after it, it moves like a light.
115
+ */
116
+ const step = useCallback((now) => {
117
+ const el = ref.current;
118
+ const l = light.current;
119
+ if (!el) {
120
+ frame.current = 0;
121
+ return;
122
+ }
123
+ // The pointer in the grid's box, read once a frame however many moves there were.
124
+ const r = el.getBoundingClientRect();
125
+ const tx = l.cx - r.left;
126
+ const ty = l.cy - r.top;
127
+ // Coming in, the light starts under the pointer (it fades in there), and eases after it.
128
+ if (!l.placed) {
129
+ l.placed = true;
130
+ l.x = tx;
131
+ l.y = ty;
132
+ }
133
+ const dt = l.last ? Math.min(64, now - l.last) : 16;
134
+ l.last = now;
135
+ const k = 1 - Math.exp(-dt / 70);
136
+ l.x += (tx - l.x) * k;
137
+ l.y += (ty - l.y) * k;
138
+ const done = Math.abs(tx - l.x) < 0.5 && Math.abs(ty - l.y) < 0.5;
139
+ if (done) {
140
+ l.x = tx;
141
+ l.y = ty;
142
+ }
143
+ el.style.setProperty("--mx", `${l.x.toFixed(1)}px`);
144
+ el.style.setProperty("--my", `${l.y.toFixed(1)}px`);
145
+ if (done) {
146
+ frame.current = 0;
147
+ l.last = 0;
148
+ }
149
+ else
150
+ frame.current = requestAnimationFrame(step);
151
+ }, []);
108
152
  const handleMove = useCallback((e) => {
109
153
  onPointerMove?.(e);
110
154
  const el = ref.current;
111
155
  if (!interactive || !enabled.current || !el || e.pointerType !== "mouse")
112
156
  return;
113
- const { clientX, clientY } = e;
114
- cancelAnimationFrame(frame.current);
115
- frame.current = requestAnimationFrame(() => {
116
- const r = el.getBoundingClientRect();
117
- el.style.setProperty("--mx", `${clientX - r.left}px`);
118
- el.style.setProperty("--my", `${clientY - r.top}px`);
119
- el.dataset.lit = "true";
120
- });
121
- }, [interactive, onPointerMove]);
157
+ const l = light.current;
158
+ l.cx = e.clientX;
159
+ l.cy = e.clientY;
160
+ el.dataset.lit = "true";
161
+ if (!frame.current)
162
+ frame.current = requestAnimationFrame(step);
163
+ }, [interactive, onPointerMove, step]);
122
164
  const handleLeave = useCallback((e) => {
123
165
  onPointerLeave?.(e);
124
- cancelAnimationFrame(frame.current);
166
+ // The light fades out where it is; the next entry places it afresh.
167
+ light.current.placed = false;
125
168
  if (ref.current)
126
169
  ref.current.dataset.lit = "false";
127
170
  }, [onPointerLeave]);
@@ -140,7 +183,8 @@ export function DotField({ className, children, ...props }) {
140
183
  }
141
184
  /**
142
185
  * Grain — an animated film-grain overlay that fills its positioned parent. It is
143
- * `aria-hidden`, ignores the pointer and holds still under reduced motion.
186
+ * `aria-hidden`, ignores the pointer and holds still under reduced motion, and on a phone or
187
+ * a touch screen: it moves only on a desktop.
144
188
  *
145
189
  * Use it on dark or large expressive regions to take the digital edge off a flat ground.
146
190
  * The rule people break: putting it over small text, where it costs contrast.
@@ -13,9 +13,21 @@ export interface LightboxMessages {
13
13
  loading: string;
14
14
  /** "Image 3 of 12", read out on every change, before the image's alt text. */
15
15
  position: (index: number, count: number) => string;
16
+ /** The viewer's name when it shows other files than images. */
17
+ fileTitle: string;
18
+ previousFile: string;
19
+ nextFile: string;
20
+ /** "File 3 of 12", in a set that is not only images. */
21
+ filePosition: (index: number, count: number) => string;
22
+ /** Said while a file (a text, a player) loads. */
23
+ loadingFile: string;
24
+ /** Under the name of a file that cannot be shown here. */
25
+ noPreview: string;
26
+ /** In place of a text that could not be fetched. */
27
+ loadFailed: string;
16
28
  }
17
29
  declare module "./locale" {
18
- interface Messages {
30
+ interface LocaleMessages {
19
31
  lightbox: LightboxMessages;
20
32
  }
21
33
  }
@@ -34,10 +46,57 @@ export interface LightboxImage {
34
46
  /** What Download saves — another file, the original say. Defaults to `src`. `false` hides it for this image. */
35
47
  download?: string | false;
36
48
  }
49
+ /**
50
+ * What a Lightbox gives the PDF viewer it is handed in `pdfViewer`. `PdfViewer` from
51
+ * `@zonsh/ui/pdf-viewer` takes them.
52
+ */
53
+ export interface LightboxPdfViewerProps {
54
+ src: string;
55
+ fileName?: string;
56
+ variant?: "card";
57
+ download?: boolean;
58
+ className?: string;
59
+ }
60
+ /** What a Lightbox shows an item as. */
61
+ export type LightboxKind = "image" | "video" | "audio" | "pdf" | "text" | "file";
62
+ /**
63
+ * One file of any kind, for `items`: an image, a video, a sound, a PDF, a text, or
64
+ * anything else — shown by its name and size, with a download.
65
+ */
66
+ export interface LightboxItem extends Omit<LightboxImage, "alt"> {
67
+ /** The file. */
68
+ src: string;
69
+ /** What it is shown as, when its type or name does not say: inferred from `type`, then the extension. */
70
+ kind?: LightboxKind;
71
+ /** Its MIME type (`video/mp4`, `application/pdf`): it says the kind before the extension does. */
72
+ type?: string;
73
+ /** The file's name: shown above it, and what Download saves it as. Defaults to the URL's last part. */
74
+ name?: string;
75
+ /** Its size in bytes, shown for a file there is no preview of. */
76
+ size?: number;
77
+ /** What an image shows (write one for every image); other files are named by `name`. */
78
+ alt?: string;
79
+ /** A video's still: shown before it plays, and as its thumbnail. */
80
+ poster?: string;
81
+ /** A text's content, in place of fetching `src`. */
82
+ text?: string;
83
+ /** A text's language, for colouring (`ts`, `json`, `python`). Defaults to the one its extension names. */
84
+ language?: string;
85
+ }
86
+ /**
87
+ * How a Lightbox shows an item: as its `kind`; else as its MIME `type` (or a `data:` URL's) says;
88
+ * else as the extension of its `name` or `src` says. An extension it does not know makes it a
89
+ * `file`; no extension at all, an image, as image URLs often have none.
90
+ */
91
+ export declare function lightboxItemKind(item: Pick<LightboxItem, "src" | "kind" | "type" | "name">): LightboxKind;
37
92
  export interface LightboxProps {
38
- /** The images, in order. */
39
- images: LightboxImage[];
40
- /** The image shown, 0-based. */
93
+ /**
94
+ * What it shows, in order: images, or files of any kind, each shown as what it is — an image, a
95
+ * video, a sound, a PDF, a text, or a file to download — by its `kind`, `type` or extension. A
96
+ * URL without an extension is an image.
97
+ */
98
+ items?: LightboxItem[];
99
+ /** The item shown, 0-based. With `open`, it opens the viewer from code at that item. */
41
100
  index?: number;
42
101
  defaultIndex?: number;
43
102
  onIndexChange?: (index: number) => void;
@@ -54,6 +113,11 @@ export interface LightboxProps {
54
113
  * ground, `bg-white` under a logo — either would otherwise vanish on the black.
55
114
  */
56
115
  imageClassName?: string;
116
+ /**
117
+ * The reader PDFs open in: `PdfViewer` from `@zonsh/ui/pdf-viewer`, which brings pdf.js (and
118
+ * loads it only once a PDF is shown). Without one, a PDF opens in the browser's own viewer.
119
+ */
120
+ pdfViewer?: React.ComponentType<LightboxPdfViewerProps>;
57
121
  /** Interface text; a LocaleProvider sets it for every Lightbox. */
58
122
  labels?: Partial<LightboxMessages>;
59
123
  /** The thumbnails: a `LightboxGrid`, or your own `LightboxTrigger`s. */
@@ -61,17 +125,19 @@ export interface LightboxProps {
61
125
  }
62
126
  /**
63
127
  * Lightbox — images opened large over the page, one at a time: the photos of a listing, the
64
- * figures of an article, the attachments of a report.
128
+ * figures of an article, the attachments of a report — and files of other kinds: a video, a
129
+ * sound, a PDF, a text.
65
130
  *
66
131
  * Thumbnails (`LightboxGrid`, or `LightboxTrigger`s around your own) open a full-screen viewer on
67
132
  * a black ground in either theme, with a mono "03 / 12" counter, previous and next buttons, the
68
133
  * arrow keys and a swipe, zoom by double click or tap, wheel or pinch with a drag to pan, a
69
- * caption and an optional download. It is a modal Dialog: focus stays inside, Escape closes it,
70
- * and focus returns to the thumbnail of the image last shown.
134
+ * caption and an optional download. Or open it from code, with `open` and `index`. It
135
+ * is a modal Dialog: focus stays inside, Escape closes it, and focus returns to the thumbnail of
136
+ * the image last shown, or to what had focus. Inside a Dialog it opens over it as a nested dialog.
71
137
  *
72
138
  * The rule people break: an empty `alt`. Every image is named, in the grid and in the viewer.
73
139
  */
74
- export declare function Lightbox({ images, index: indexProp, defaultIndex, onIndexChange, open: openProp, defaultOpen, onOpenChange, loop, download, imageClassName, labels, children, }: LightboxProps): React.JSX.Element;
140
+ export declare function Lightbox({ items, index: indexProp, defaultIndex, onIndexChange, open: openProp, defaultOpen, onOpenChange, loop, download, imageClassName, pdfViewer, labels, children, }: LightboxProps): React.JSX.Element;
75
141
  export interface LightboxTriggerProps extends BaseButton.Props {
76
142
  /** The image it opens, 0-based. */
77
143
  index: number;
@@ -94,7 +160,8 @@ export interface LightboxGridProps extends React.ComponentProps<"ul"> {
94
160
  }
95
161
  /**
96
162
  * The thumbnails of every image as a grid of square buttons, each cropped to fill its square and
97
- * edged with a `--field-edge` hairline at 12px.
163
+ * edged with a `--field-edge` hairline at 12px. A file without a picture (a `thumbnail`, or a
164
+ * video's `poster`) shows its kind's icon and its name.
98
165
  */
99
166
  export declare function LightboxGrid({ columns, className, ...props }: LightboxGridProps): React.JSX.Element;
100
167
  export {};