@zonsh/ui 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,362 @@
1
+ # Theme
2
+
3
+ ```tsx
4
+ import { ThemeProvider, ThemeToggle } from "@zonsh/ui";
5
+
6
+ export function Toggle() {
7
+ return (
8
+ <ThemeProvider>
9
+ <ThemeToggle />
10
+ </ThemeProvider>
11
+ );
12
+ }
13
+ ```
14
+
15
+ Every token is redefined under `.dark`, so a theme is one class on `<html>`. `ThemeProvider` sets it, remembers the choice and follows the OS on `system`; `themeScript` applies it before the first paint. `ThemeToggle` is a round secondary icon button.
16
+
17
+ ## Usage
18
+
19
+ ```tsx
20
+ import { ThemeProvider, ThemeToggle, themeScript } from "@zonsh/ui";
21
+
22
+ // In <head>, before the stylesheets:
23
+ <script dangerouslySetInnerHTML={{ __html: themeScript }} />
24
+
25
+ // At the root:
26
+ <ThemeProvider>
27
+ <header>
28
+ <ThemeToggle />
29
+ </header>
30
+ </ThemeProvider>
31
+ ```
32
+
33
+ - `ThemeProvider.preset` — your theme: `themePresetFromColor(…)`, a preset code or a theme.json.
34
+ - `ThemeProvider.defaultTheme` — before anyone picks.
35
+ - `ThemeToggle.size` — `"sm"` for a dense header.
36
+
37
+ Changed `storageKey`, `defaultTheme` or `themeColor`? Build the script with the same: `createThemeScript({ storageKey, defaultTheme, themeColor })`.
38
+
39
+ ## When to use
40
+
41
+ - `ThemeProvider` once at the root; `themeScript` in every page's `<head>`; one `ThemeToggle`, usually in the header; `useTheme()` for a menu with "System".
42
+ - `ThemeScope` for one area in its own theme or scheme, popups included. A plain region with no popups can use `.theme-dark` / `.theme-light`.
43
+
44
+ ## Setting up
45
+
46
+ ### In a Vite app's index.html
47
+
48
+ `zonThemeScript()` from `@zonsh/ui/vite` puts the script atop `<head>`, right after `<meta charset>`, in every page (options as `createThemeScript`).
49
+
50
+ ```ts
51
+ // vite.config.ts
52
+ import { zonThemeScript } from "@zonsh/ui/vite";
53
+
54
+ export default defineConfig({ plugins: [react(), tailwindcss(), zonThemeScript()] });
55
+ ```
56
+
57
+ With a theme of your own, give the plugin the same `preset` as `ThemeProvider`: it writes the theme's stylesheet into `index.html` after the library's, so the first paint already has your colours, corners and density instead of zon's grey until the app runs. Keep the preset in one module both import, from `@zonsh/ui/theme` (plain code, which the Vite config can load):
58
+
59
+ ```ts
60
+ // src/theme.ts
61
+ import { themePresetFromColor } from "@zonsh/ui/theme";
62
+
63
+ export const preset = themePresetFromColor("#c2410c", { neutral: "warm", corners: "round" });
64
+
65
+ // vite.config.ts
66
+ import { zonThemeScript } from "@zonsh/ui/vite";
67
+ import { preset } from "./src/theme";
68
+
69
+ export default defineConfig({ plugins: [react(), tailwindcss(), zonThemeScript({ preset })] });
70
+
71
+ // src/main.tsx: <ThemeProvider preset={preset}>
72
+ ```
73
+
74
+ Or paste `themeScript` (the defaults) first in `<head>`:
75
+
76
+ ```html
77
+ <script>(function(){var t=null;try{t=localStorage.getItem("zon-theme")}catch(e){}if(t!=="light"&&t!=="dark"&&t!=="system")t="system";var d=t==="dark";if(t==="system"){try{d=matchMedia("(prefers-color-scheme: dark)").matches}catch(e){}}document.documentElement.classList.toggle("dark",d);var m=document.querySelector('meta[name="theme-color"]:not([media])');if(!m){m=document.createElement("meta");m.name="theme-color";document.head.appendChild(m)}m.content=d?"#141414":"#f9f9f9";})();</script>
78
+ ```
79
+
80
+ Both keep `<meta name="theme-color">` (no `media`; made if missing) at the page tone (`PAGE_TONE`, `--page-tone`), or a preset's `--background`; `themeColor: false` leaves it to you. See also Layout, "The page's edges on a phone".
81
+
82
+ Server-rendered (a Next.js root layout): `suppressHydrationWarning` on `<html>`.
83
+
84
+ ### Your own colour
85
+
86
+ Unthemed, an app looks like zon: grey, a near-black primary. `themePresetFromColor` makes a theme from one colour: the primary, checked controls and focus outline take its hue, and every text colour is moved until it reads. `neutral`, `corners` and `density` set the rest. For every colour and the exact shape, use a preset code from the [theme editor](./theme-editor.md).
87
+
88
+ ```tsx
89
+ import { ThemeProvider, themePresetFromColor } from "@zonsh/ui";
90
+
91
+ <ThemeProvider preset={themePresetFromColor("#c2410c", { neutral: "warm", corners: "round" })}>
92
+ {children}
93
+ </ThemeProvider>;
94
+ ```
95
+
96
+ Any CSS colour works; a very light one is deepened so its label reads, and a grey keeps zon's primary. Bad input throws a `ThemePresetError` that says why.
97
+
98
+ Pick a colour away from the hues that already mean something: the status colours (green success, amber warning, blue info, red destructive) and the category tones the app uses (blue, aqua, violet, magenta, orange, lime). A teal primary beside the aqua tone, or a red one beside `destructive`, makes a selected row read as a status. When the brand colour is close to one, keep that meaning off the screen where they meet, or move the category to another tone.
99
+
100
+ For a first paint in your colours with no flash of zon's grey: in Vite, the same `preset` to `zonThemeScript({ preset })` (above); server-rendered, `themeFromPreset(preset).css` in a `<style>` in `<head>` after the library's stylesheet, or that CSS pasted after `@import "@zonsh/ui/styles.css";`.
101
+
102
+ As a code: `pnpm create zon@latest theme --color "#c2410c" --corners round` (`--css` for the stylesheet), or `encodeThemePreset(themePresetFromColor(…))` from `@zonsh/ui/theme`. `pnpm create zon@latest my-app` asks for the look or takes `--color`, `--neutral`, `--corners`, `--density`.
103
+
104
+ | Option | Values | Default |
105
+ | --------- | -------------------------------------------------------------------------------------------------------- | --------- |
106
+ | `neutral` | `pure` (zon's grey), `warm` (paper), `cool` (slate), `tinted` (a hint of the colour) | `pure` |
107
+ | `corners` | `square` (0), `subtle` (half zon's), `default` (zon's 12px buttons, 20px cards), `round` (one and a half times), or a step of `THEME_CORNERS` | `default` |
108
+ | `density` | `dense` (30px controls), `compact` (34px), `default` (38px), `comfortable` (42px), `spacious` (46px) | `default` |
109
+ | `controlHeight` | the default control height in px, one of `THEME_HEIGHTS` (30, 34, 38, 42, 46), in place of `density` | — |
110
+
111
+ What a density changes, inside the components: the control heights, row heights and inset parts follow the default control height; padding, gaps, icons and the sidebar's width scale by `--space` (0.79 dense, 0.89 compact, 1 default, 1.05 comfortable, 1.1 spacious — in a roomy theme they grow only as fast as the type, so it is taller rather than padded out); type scales by `--type`, half the density's change, never under 10px; a card's padding follows `--space` too. The small parts keep their sizes (a checkbox, a switch, a badge, a key cap, a tag), and so does your own layout.
112
+
113
+ ### A theme of your own
114
+
115
+ A [theme editor](./theme-editor.md) theme is a preset code:
116
+
117
+ ```tsx
118
+ <ThemeProvider preset="Z11ARFCXWTUPYKES">{children}</ThemeProvider>
119
+ ```
120
+
121
+ The provider adds its stylesheet to the end of `<head>`; an unreadable code leaves zon's theme and warns once in development. For a server-rendered first paint, render `themeFromPreset(code).css` in `<head>`:
122
+
123
+ ```tsx
124
+ import { themeFromPreset, themeScript } from "@zonsh/ui";
125
+
126
+ <head>
127
+ <script dangerouslySetInnerHTML={{ __html: themeScript }} />
128
+ <style dangerouslySetInnerHTML={{ __html: themeFromPreset("Z11ARFCXWTUPYKES").css }} />
129
+ </head>;
130
+ ```
131
+
132
+ Light tokens go on `:root, .theme-light`, dark on `.dark, [data-theme="dark"], .theme-dark`, shape on `:root`.
133
+
134
+ ### One area of a page
135
+
136
+ `ThemeScope` gives one area its own theme, or holds it light or dark.
137
+
138
+ ```tsx
139
+ import { Button, Label, Menu, MenuContent, MenuItem, MenuTrigger, Mono, Switch, ThemeScope, themePresetFromColor } from "@zonsh/ui";
140
+ import { ChevronDownIcon } from "lucide-react";
141
+
142
+ const clay = themePresetFromColor("#c2410c", { neutral: "warm", corners: "round", density: "comfortable" });
143
+
144
+ /** One panel's controls: a menu (which opens in the panel's theme), a switch and the primary. */
145
+ function PanelControls({ action }: { action: string }) {
146
+ return (
147
+ <div className="flex flex-wrap items-center gap-3">
148
+ <Menu>
149
+ <MenuTrigger render={<Button variant="secondary" />}>
150
+ Kiln
151
+ <ChevronDownIcon />
152
+ </MenuTrigger>
153
+ <MenuContent>
154
+ <MenuItem>Kiln 1</MenuItem>
155
+ <MenuItem>Kiln 2</MenuItem>
156
+ <MenuItem>Test kiln</MenuItem>
157
+ </MenuContent>
158
+ </Menu>
159
+ <Label>
160
+ <Switch defaultChecked />
161
+ Slow cool
162
+ </Label>
163
+ <Button>{action}</Button>
164
+ </div>
165
+ );
166
+ }
167
+
168
+ export function Scope() {
169
+ return (
170
+ <div className="grid gap-4 md:grid-cols-2">
171
+ <ThemeScope preset={clay} className="flex flex-col gap-4 rounded-card border border-border p-6">
172
+ <Mono className="text-xs text-muted-foreground">A theme from #c2410c, round and comfortable</Mono>
173
+ <PanelControls action="Start firing" />
174
+ </ThemeScope>
175
+ <ThemeScope scheme="dark" className="flex flex-col gap-4 rounded-card border border-border p-6">
176
+ <Mono className="text-xs text-muted-foreground">zon's own, always dark</Mono>
177
+ <PanelControls action="Start firing" />
178
+ </ThemeScope>
179
+ </div>
180
+ );
181
+ }
182
+ ```
183
+
184
+ ```tsx
185
+ import { ThemeScope, themePresetFromColor } from "@zonsh/ui";
186
+
187
+ <ThemeScope preset={themePresetFromColor("#c2410c", { corners: "round" })} className="p-6">
188
+ {/* a customer's branded preview, an embedded widget, a night section */}
189
+ </ThemeScope>;
190
+
191
+ <ThemeScope scheme="dark">{/* always dark, in zon's colours */}</ThemeScope>;
192
+ ```
193
+
194
+ A `div` with `bg-background text-foreground`. Without `scheme` it follows the page; `scheme` holds it (adding `.theme-light` / `.theme-dark`). Density and corners reach every component inside; your own spacing keeps Tailwind's step.
195
+
196
+ Popups opened inside (menus, dialogs, tooltips, toasts …) portal into a themed element at the end of `<body>`, matching and unclipped; a `Toaster` takes its scope's theme. Your own portals use `usePortalContainer()`: `<Popover.Portal container={usePortalContainer()}>`. Scopes nest. Inside a `.theme-dark` / `.theme-light` region, give the scope the same `scheme`.
197
+
198
+ Its stylesheet is server-rendered into `<head>` once per theme. Outside React: `themeScopeStyle(theme, "dark")` (an inline style) or `themeFromPreset(theme, { scope: "promo" }).css` (for `data-theme-scope="promo"`).
199
+
200
+ ### A theme in the repository
201
+
202
+ Commit the [theme editor](./theme-editor.md)'s `theme.json` (every token on its own line, so changes review well) and pass it as is:
203
+
204
+ ```tsx
205
+ import theme from "./theme.json";
206
+
207
+ <ThemeProvider preset={theme}>{children}</ThemeProvider>;
208
+ ```
209
+
210
+ Hand edits win over the code. `themeFromPreset(preset).json` / `.css` write the file and stylesheet deterministically.
211
+
212
+ ### Part sizes
213
+
214
+ Small parts have their own size tokens outside `--density`; override them on `:root` after the library's stylesheet:
215
+
216
+ ```css
217
+ :root {
218
+ --check-size: 20px;
219
+ --focus-width: 3px;
220
+ }
221
+ ```
222
+
223
+ | Token | Default | What it sizes |
224
+ | --- | --- | --- |
225
+ | `--focus-width` | `2px` | Every focus outline, the global `:focus-visible` one and the components' own |
226
+ | `--check-size` | `18px` | Checkbox and Radio, and the task-list boxes in Response and Markdown Editor |
227
+ | `--touch-target` | `44px` | The least a finger hits on a coarse pointer: `touch-target`'s invisible area around a small control |
228
+ | `--switch-w` | `38px` | The Switch track's width |
229
+ | `--switch-h` | `22px` | The Switch track's height |
230
+ | `--switch-thumb` | `18px` | The Switch thumb; pressed, it stretches 7px wider |
231
+ | `--slider-thumb` | `18px` | The Slider thumb, the Video and Audio Player scrubber's thumb and the Color Picker's handles |
232
+ | `--track-h` | `6px` | The Slider, Progress and Meter tracks; scales with `--density` |
233
+ | `--badge-h-sm` | `16px` | A `size="sm"` Badge (height and least width) |
234
+ | `--badge-h` | `20px` | A default Badge (height and least width) |
235
+ | `--kbd-h` | `20px` | A Kbd key cap (least height and width) |
236
+ | `--tag-h` | `22px` | A Tag's least height |
237
+ | `--scroll-thumb` | `4px` | The ScrollArea thumb; scales with `--density` |
238
+ | `--hairline-opacity` | `60%` | The components' hairline rules: `--border` at this strength (Separator, Table, Accordion, Card, Sidebar …) |
239
+ | `--card-space` | `24px` | `surface-card`'s padding on a phone |
240
+ | `--card-space-sm` | `32px` | … from 40rem |
241
+ | `--card-space-md` | `40px` | … from 48rem; one card overrides all three with `--card-padding` |
242
+ | `--drag-lift` | `1.02` | The scale of an item lifted in Sortable and Kanban |
243
+
244
+ `--track-h` and `--scroll-thumb` scale with `--density` (`calc(var(--zon-spacing) * 1.5)`).
245
+
246
+ ### Printing
247
+
248
+ A page prints as it is on screen, in the scheme it is in, and the browser leaves out backgrounds unless asked: no grain, no material fills, so text and hairlines carry what is printed. Paper wants the light theme, whatever the reader has chosen:
249
+
250
+ - **The part to print** (an invoice, a receipt) takes `.theme-light` and `text-foreground`. The class sets the light tokens there; the text colour has to be set again, because text inherits the colour already worked out on the dark `<body>`.
251
+ - **Or the whole page, for the print only:** take `.dark` off `<html>` on `beforeprint` and put it back on `afterprint`.
252
+
253
+ ```ts
254
+ const { resolvedTheme } = useTheme();
255
+ useEffect(() => {
256
+ const light = () => document.documentElement.classList.remove("dark");
257
+ const back = () => document.documentElement.classList.toggle("dark", resolvedTheme === "dark");
258
+ window.addEventListener("beforeprint", light);
259
+ window.addEventListener("afterprint", back);
260
+ return () => {
261
+ window.removeEventListener("beforeprint", light);
262
+ window.removeEventListener("afterprint", back);
263
+ };
264
+ }, [resolvedTheme]);
265
+ ```
266
+
267
+ - **Leave the app out:** `print:hidden` on the sidebar, the header, the toolbar and the buttons; `print:static` on anything `sticky` or `fixed`, which would repeat on every page or cover the content.
268
+
269
+ ## Examples
270
+
271
+ ### Chooser
272
+
273
+ ```tsx
274
+ import { Button, Mono, ThemeProvider, useTheme, type ThemeMode } from "@zonsh/ui";
275
+
276
+ function ThemeChoices() {
277
+ const { theme, resolvedTheme, setTheme } = useTheme();
278
+ const modes: { value: ThemeMode; label: string }[] = [
279
+ { value: "light", label: "Light" },
280
+ { value: "dark", label: "Dark" },
281
+ { value: "system", label: "System" },
282
+ ];
283
+ return (
284
+ <div className="flex flex-col items-start gap-4">
285
+ <div className="flex flex-wrap gap-2" role="group" aria-label="Theme">
286
+ {modes.map((mode) => (
287
+ <Button
288
+ key={mode.value}
289
+ variant="secondary"
290
+ className="aria-pressed:bg-control-hover aria-pressed:text-foreground"
291
+ aria-pressed={theme === mode.value}
292
+ onClick={() => setTheme(mode.value)}
293
+ >
294
+ {mode.label}
295
+ </Button>
296
+ ))}
297
+ </div>
298
+ <Mono className="text-[13px] text-muted-foreground">
299
+ theme: {theme} · applied: {resolvedTheme}
300
+ </Mono>
301
+ </div>
302
+ );
303
+ }
304
+
305
+ export function Chooser() {
306
+ return (
307
+ <ThemeProvider>
308
+ <ThemeChoices />
309
+ </ThemeProvider>
310
+ );
311
+ }
312
+
313
+ /* Made once, outside render: a preset object made on every render would still apply once, but
314
+ there is no need to build it again. */
315
+ ```
316
+
317
+ ## Props
318
+
319
+ **ThemeProvider**
320
+
321
+ | Prop | Type | Default |
322
+ | -------------- | ------------------------------- | ------------------- |
323
+ | `defaultTheme` | `"light" \| "dark" \| "system"` | `"system"` |
324
+ | `storageKey` | `string` — localStorage key | `"zon-theme"` |
325
+ | `themeColor` | `boolean` — keep `<meta name="theme-color">` at the page tone | `true` |
326
+ | `preset` | `string \| ThemePreset \| ThemeFile` — a theme editor preset code, a preset such as `themePresetFromColor("#c2410c")`, or a theme.json file; its stylesheet goes into `<head>` | — |
327
+
328
+ **ThemeScope** takes every `div` prop, and:
329
+
330
+ | Prop | Type | Default |
331
+ | -------- | --------------------------------------------- | ---------------- |
332
+ | `preset` | `string \| ThemePreset \| ThemeFile` — the area's theme | — (the page's) |
333
+ | `scheme` | `"light" \| "dark"` — hold the area in one scheme | — (the page's) |
334
+
335
+ **usePortalContainer()** — the portal element inside a ThemeScope, else `undefined`.
336
+
337
+ **themeScopeStyle(theme, scheme, { format? })** — one scheme's tokens, shape and `colorScheme` as a style.
338
+
339
+ **useTheme()** — `{ theme, resolvedTheme, setTheme }`; `resolvedTheme` is `"light" | "dark"`.
340
+
341
+ **ThemeToggle** forwards `Button` props but `variant` and `children`; `size` `"default"` (36px) or `"sm"` (30px); `onClick` runs first.
342
+
343
+ **zonThemeScript(options)** (from `@zonsh/ui/vite`) — the Vite plugin: `storageKey`, `defaultTheme` and `themeColor` as `createThemeScript`, and `preset`, whose stylesheet it writes into `index.html` for the first paint.
344
+
345
+ **themeScript** — the minified script for the defaults; **createThemeScript(options)** for others (options escaped, so `</script>` cannot break out). **THEME_STORAGE_KEY** is `"zon-theme"`; **PAGE_TONE** `{ light: "#f9f9f9", dark: "#141414" }`. The toggle's name is `messages.theme.toggle`.
346
+
347
+ ## Brand rules
348
+
349
+ - **Do** preview everything in both themes, with semantic tokens rather than `dark:` overrides, and one toggle per page.
350
+ - **Do** ask once how the product should look (zon's own, a brand colour, a preset code) and set it in the theme, not on components.
351
+ - **Don't** invert the logo with a filter; it uses `currentColor`.
352
+ - **Don't** tint a theme by hand or pick separate dark-mode hues.
353
+
354
+ ## Accessibility
355
+
356
+ - `ThemeToggle` is labelled "Toggle light and dark theme"; its icons are `aria-hidden`.
357
+ - The icon is picked by CSS, right on the first paint. Blocked storage keeps the choice for the session. `system` follows `prefers-color-scheme` live, and other tabs through the `storage` event.
358
+
359
+ ---
360
+
361
+ - Import: `import { ThemeProvider, useTheme, ThemeToggle, ThemeScope, usePortalContainer, themeScript, createThemeScript, THEME_STORAGE_KEY } from "@zonsh/ui"`
362
+ - Source: `packages/ui/src/components/theme.tsx`
@@ -0,0 +1,222 @@
1
+ # Time Field
2
+
3
+ ```tsx
4
+ import { Field, FieldDescription, FieldLabel, TimeField } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field className="max-w-48">
9
+ <FieldLabel>Daily reminder</FieldLabel>
10
+ <TimeField defaultValue="08:30" name="reminder" />
11
+ <FieldDescription>We send the day's notes at this time.</FieldDescription>
12
+ </Field>
13
+ );
14
+ }
15
+ ```
16
+
17
+ A recessed field (38px, 30px dense) holding the time as mono segments, `14 : 30`, plus seconds or AM/PM when needed. The value is always 24-hour — `"14:30"` or `"14:30:05"` — and `null` until complete.
18
+
19
+ ## Usage
20
+
21
+ ```tsx
22
+ import { Field, FieldLabel, TimeField } from "@zonsh/ui";
23
+
24
+ <Field>
25
+ <FieldLabel>Daily reminder</FieldLabel>
26
+ <TimeField defaultValue="08:30" name="reminder" />
27
+ </Field>;
28
+ ```
29
+
30
+ - `value` / `onValueChange` — `"HH:mm"` or `null`.
31
+ - `step` — minutes per arrow press.
32
+ - `min` / `max` — bounds, applied on blur.
33
+
34
+ Each segment is a spinbutton: arrows step and wrap (59 → 00) with a digit roll, changing in place when held. Typing moves on once no other digit could follow (`7` in the minutes is 07; `1` in the hours waits for 1 or 12). Backspace clears a segment. A pasted `14:30` or `2:30 pm` fills the field; Arabic, Persian and full-width digits count. Right to left it still reads `14 : 30`, at the field's start with the icon on the left. A focused segment takes the hover fill.
35
+
36
+ ## When to use
37
+
38
+ - A time of day; beside a `DatePicker` for date and time.
39
+ - Durations: a `NumberField` per unit — they don't wrap at midnight.
40
+ - Not a `Select` of quarter hours: `step={15}`.
41
+
42
+ ## Examples
43
+
44
+ ### 12 and 24 hours
45
+
46
+ The clock follows `locale` (en-US `04 : 45 PM`, de-DE `16:45`); `hourCycle` overrides it. `seconds`, or a value with seconds, adds that segment.
47
+
48
+ ```tsx
49
+ import { Field, FieldLabel, TimeField } from "@zonsh/ui";
50
+
51
+ export function Clock() {
52
+ return (
53
+ <div className="flex flex-col gap-4">
54
+ <Field className="max-w-48">
55
+ <FieldLabel>Pickup (12-hour)</FieldLabel>
56
+ <TimeField hourCycle={12} locale="en-US" defaultValue="16:45" />
57
+ </Field>
58
+ <Field className="max-w-48">
59
+ <FieldLabel>Abholung (de-DE)</FieldLabel>
60
+ <TimeField locale="de-DE" defaultValue="16:45" />
61
+ </Field>
62
+ <Field className="max-w-48">
63
+ <FieldLabel>Backup starts at</FieldLabel>
64
+ <TimeField hourCycle={24} seconds defaultValue="03:15:00" />
65
+ </Field>
66
+ </div>
67
+ );
68
+ }
69
+ ```
70
+
71
+ ### Steps and bounds
72
+
73
+ `step={15}` steps 00, 15, 30, 45; typing still takes any minute. A finished time outside `min` / `max` snaps to the nearest bound on blur, as in `NumberField`.
74
+
75
+ ```tsx
76
+ import { Field, FieldDescription, FieldLabel, TimeField } from "@zonsh/ui";
77
+ import * as React from "react";
78
+
79
+ export function Steps() {
80
+ const [value, setValue] = React.useState<string | null>("19:00");
81
+ return (
82
+ <Field className="max-w-48">
83
+ <FieldLabel>Table for two</FieldLabel>
84
+ <TimeField hourCycle={24} step={15} min="17:00" max="22:30" value={value} onValueChange={setValue} />
85
+ <FieldDescription>
86
+ {value ? `Booking for ${value}. ` : "Pick a time. "}
87
+ Seatings every quarter hour, 17:00 to 22:30.
88
+ </FieldDescription>
89
+ </Field>
90
+ );
91
+ }
92
+ ```
93
+
94
+ ### Sizes
95
+
96
+ ```tsx
97
+ import { Field, FieldLabel, TimeField } from "@zonsh/ui";
98
+
99
+ export function Sizes() {
100
+ return (
101
+ <div className="flex flex-col gap-4">
102
+ <Field className="max-w-40">
103
+ <FieldLabel>Dense</FieldLabel>
104
+ <TimeField size="sm" hourCycle={24} defaultValue="14:30" />
105
+ </Field>
106
+ <Field className="max-w-40">
107
+ <FieldLabel>Default</FieldLabel>
108
+ <TimeField hourCycle={24} defaultValue="14:30" />
109
+ </Field>
110
+ </div>
111
+ );
112
+ }
113
+ ```
114
+
115
+ ### States
116
+
117
+ Inside a `Field`, `invalid` gives the red edge and `disabled` dims it. `readOnly` drops the recess but keeps segments focusable, so the time is still read out.
118
+
119
+ ```tsx
120
+ import { Field, FieldError, FieldLabel, TimeField } from "@zonsh/ui";
121
+
122
+ function Invalid() {
123
+ return (
124
+ <Field invalid className="max-w-48">
125
+ <FieldLabel>Lesson ends</FieldLabel>
126
+ <TimeField hourCycle={24} defaultValue="09:15" />
127
+ <FieldError match>The lesson ends before it starts at 10:00.</FieldError>
128
+ </Field>
129
+ );
130
+ }
131
+
132
+ function Disabled() {
133
+ return (
134
+ <Field disabled className="max-w-48">
135
+ <FieldLabel>Quiet hours begin</FieldLabel>
136
+ <TimeField hourCycle={24} defaultValue="22:00" />
137
+ </Field>
138
+ );
139
+ }
140
+
141
+ function ReadOnly() {
142
+ return (
143
+ <Field className="max-w-48">
144
+ <FieldLabel>Checkout by</FieldLabel>
145
+ <TimeField hourCycle={24} defaultValue="11:00" readOnly />
146
+ </Field>
147
+ );
148
+ }
149
+
150
+ /** Invalid, disabled and read-only, one under the other. */
151
+ export function States() {
152
+ return (
153
+ <div className="flex w-full max-w-sm flex-col gap-8">
154
+ <Invalid />
155
+ <Disabled />
156
+ <ReadOnly />
157
+ </div>
158
+ );
159
+ }
160
+ ```
161
+
162
+ ## Props
163
+
164
+ | Prop | Type | Default |
165
+ | ------------------------ | ------------------------------------------------------------- | ------------------------------------------ |
166
+ | `value` / `defaultValue` | `string \| null`: `"HH:mm"` or `"HH:mm:ss"`, 24-hour | — |
167
+ | `onValueChange` | `(value: string \| null) => void` | — |
168
+ | `size` | `"sm" \| "default"` | `"default"` |
169
+ | `hourCycle` | `12 \| 24` | the locale's |
170
+ | `locale` | `string` (BCP 47) | the `LocaleProvider`'s, else the browser's |
171
+ | `seconds` | `boolean` | from the value |
172
+ | `step` | `number`: minutes per arrow press on the minutes | `1` |
173
+ | `min` / `max` | `string`: `"HH:mm"` | — |
174
+ | `name` | `string`: submits the value in a hidden input (`""` if empty) | — |
175
+ | `required` | `boolean`: a time must be entered | `false` |
176
+ | `disabled` / `readOnly` | `boolean` | `false` |
177
+ | `icon` | `boolean`: the clock at the end | `true` |
178
+ | `labels` | `{ hour?, minute?, second?, dayPeriod?, empty? }` | English |
179
+ | `inputRef` | the hidden input, for a form library to focus the field | — |
180
+
181
+ Without `locale`, server rendering shows the en-US clock until hydration; pass it from the request.
182
+
183
+ `required` makes an incomplete field `valueMissing` (blocks submit, focuses the first empty segment). `validate` and `onFormSubmit` get the 24-hour value.
184
+
185
+ Other props go to the group; a form reset restores `defaultValue`. Data: `data-size`, `data-disabled`, `data-readonly`, `data-invalid` (from a `Field`); on each segment `data-type`, and `data-placeholder` while empty.
186
+
187
+ A `LocaleProvider` sets `labels` (`messages.timeField`) and the default `locale`.
188
+
189
+ ## Brand rules
190
+
191
+ - **Do** keep the value 24-hour; the display follows the locale.
192
+ - **Do** set `step` and bounds to the business rule.
193
+ - **Don't** add AM/PM by hand; use `hourCycle={12}`.
194
+ - **Don't** use a long `Select` of times.
195
+
196
+ ## Accessibility
197
+
198
+ - The field is a `group` named by its `FieldLabel`; each segment is a `spinbutton` named by the label and its own name ("Daily reminder Hours"), with `aria-valuenow` and `aria-valuetext` ("Empty" until filled; on a 12-hour clock the hour reads with its half of the day, "9 PM"). Rename segments with `labels`.
199
+ - Clicking the label focuses the first segment.
200
+ - Segments are `contenteditable` with `inputmode="numeric"` (a number pad on phones); IME input is applied when composition ends.
201
+ - `Field` descriptions and errors are announced per segment, with `aria-required` when required.
202
+ - The roll is hidden from assistive tech and still under reduced motion.
203
+
204
+ ### Keyboard
205
+
206
+ | Key | What it does |
207
+ | ------------------ | ---------------------------------------------------------------------- |
208
+ | Tab / Shift+Tab | Moves to the next or previous segment |
209
+ | ← / → | Moves to the segment on the left or right |
210
+ | ↑ / ↓ | Steps the segment up or down, wrapping at the ends (minutes by `step`) |
211
+ | Home / End | Sets the segment to its first or last value |
212
+ | 0–9 | Types into the segment, and moves on once it is full |
213
+ | A / P | Sets the AM/PM segment |
214
+ | : or Space | Moves on from a filled segment |
215
+ | Backspace / Delete | Clears the segment; Backspace in an empty one moves to the previous |
216
+
217
+ Segments always run left to right, so ← and → follow what you see. AM/PM also takes the first letter of the locale's names.
218
+
219
+ ---
220
+
221
+ - Import: `import { TimeField } from "@zonsh/ui"`
222
+ - Source: `packages/ui/src/components/time-field.tsx`