@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
@@ -0,0 +1,235 @@
1
+ # Lightbox
2
+
3
+ ```tsx
4
+ import { Lightbox, LightboxGrid, type LightboxImage } from "@zonsh/ui";
5
+
6
+ const EDITORIAL = `${import.meta.env.BASE_URL}illustrations/editorial/`;
7
+
8
+ const step = (name: string, title: string, caption: string): LightboxImage => ({
9
+ src: `${EDITORIAL}${name}.webp`,
10
+ thumbnail: `${EDITORIAL}${name}-640.webp`,
11
+ alt: title,
12
+ caption,
13
+ });
14
+
15
+ /* The seven steps of a software project, drawn for the illustration library. */
16
+ const steps: LightboxImage[] = [
17
+ step("process-discovery", "First call", "Step 1 — a first conversation about what is needed."),
18
+ step("process-analysis", "Process analysis", "Step 2 — mapping how the work is done today."),
19
+ step("process-concept", "Solution concept", "Step 3 — a concrete plan to agree on."),
20
+ step("process-prototype", "Prototype", "Step 4 — a first working version to try."),
21
+ step("process-development", "Development", "Step 5 — building it out."),
22
+ step("process-testing", "Testing and deployment", "Step 6 — testing, then shipping."),
23
+ step("process-maintenance", "Maintenance", "Step 7 — keeping it running, and improving it."),
24
+ ];
25
+
26
+ export function Basic() {
27
+ return (
28
+ <div className="w-full max-w-2xl">
29
+ {/* Black line art on a transparent ground: inverted on the viewer's black, as on a dark page. */}
30
+ <Lightbox items={steps} imageClassName="invert">
31
+ <LightboxGrid columns={4} className="[&_img]:p-[6%] dark:[&_img]:invert" />
32
+ </Lightbox>
33
+ </div>
34
+ );
35
+ }
36
+ ```
37
+
38
+ Images opened large, one at a time. Each thumbnail is a button that opens a full-screen viewer on black — in the light theme too, so every image sits on the same dark — with a mono "03 / 12" counter, a caption, and previous and next at the sides.
39
+
40
+ ## Usage
41
+
42
+ ```tsx
43
+ import { Lightbox, LightboxGrid } from "@zonsh/ui";
44
+
45
+ const photos = [
46
+ {
47
+ src: "/photos/kitchen.jpg",
48
+ thumbnail: "/photos/kitchen-640.jpg",
49
+ alt: "Kitchen with an oak worktop",
50
+ caption: "Kitchen, east window",
51
+ },
52
+ { src: "/photos/hall.jpg", thumbnail: "/photos/hall-640.jpg", alt: "Hall with the original tiles" },
53
+ ];
54
+
55
+ <Lightbox items={photos}>
56
+ <LightboxGrid columns={4} />
57
+ </Lightbox>;
58
+ ```
59
+
60
+ - `items` — `src`, a required `alt`, and a `thumbnail` and `caption` where you have them.
61
+ - `columns` on `LightboxGrid` — 2 to 6, fewer on a phone.
62
+ - `download` / `loop` — a Download button per image; wrap from last to first.
63
+
64
+ Zoom with a double click or tap (to the image's own pixels, at least 2×), the wheel, a pinch or the zoom button; drag to pan. A click on the black, Escape or the close button closes it. The large image loads when opened, its neighbours in the background.
65
+
66
+ ## When to use
67
+
68
+ - Photos and figures people want larger: a listing's photos, an article's figures, screenshots on a report.
69
+ - `LightboxGrid` for a grid; `LightboxTrigger` around your own thumbnail — a file row, a figure in the text.
70
+ - Slides that move in place are a Carousel; a PDF, the PDF Viewer; a video, the Video Player.
71
+
72
+ ## Examples
73
+
74
+ ### Own triggers and download
75
+
76
+ `LightboxTrigger index={i}` opens the viewer from anything you draw. `download: "…"` on an image saves another file, such as the original; `false` hides its button.
77
+
78
+ ```tsx
79
+ import { Lightbox, LightboxTrigger, type LightboxImage } from "@zonsh/ui";
80
+ import { FileImageIcon } from "lucide-react";
81
+
82
+ const FILES = `${import.meta.env.BASE_URL}files/`;
83
+
84
+ /* The files attached to a bug report, opened from a list. */
85
+ const attachments: LightboxImage[] = [
86
+ {
87
+ src: `${FILES}package-updates.png`,
88
+ alt: "Screenshot of the update notes: three packages have updates",
89
+ caption: "package-updates.png — the notes the update check wrote, 704 × 527",
90
+ },
91
+ {
92
+ src: `${FILES}eclipse-poster.jpg`,
93
+ alt: "Poster frame of the eclipse clip at totality",
94
+ caption: "eclipse-poster.jpg — the poster frame of the clip, 3840 × 2160",
95
+ },
96
+ ];
97
+
98
+ export function Attachments() {
99
+ return (
100
+ <div className="w-full max-w-md">
101
+ <Lightbox items={attachments} download loop>
102
+ <ul className="m-0 flex list-none flex-col p-0">
103
+ {attachments.map((file, i) => (
104
+ <li key={file.src} className="border-b border-border/60 last:border-b-0">
105
+ <LightboxTrigger
106
+ index={i}
107
+ className="flex w-full items-center gap-3 rounded-item bg-transparent px-2 py-2 text-start text-sm text-foreground hover:bg-control-hover"
108
+ >
109
+ <img
110
+ src={file.src}
111
+ alt=""
112
+ className="size-10 shrink-0 rounded-checkbox border border-field-edge object-cover"
113
+ />
114
+ <span className="min-w-0 flex-1">
115
+ <span className="block truncate font-medium">{file.alt}</span>
116
+ <span className="block truncate font-mono text-[12px] text-muted-foreground">
117
+ {file.src.split("/").pop()}
118
+ </span>
119
+ </span>
120
+ <FileImageIcon aria-hidden className="size-4 shrink-0 text-muted-foreground" />
121
+ </LightboxTrigger>
122
+ </li>
123
+ ))}
124
+ </ul>
125
+ </Lightbox>
126
+ </div>
127
+ );
128
+ }
129
+ ```
130
+
131
+ ### One figure
132
+
133
+ A single image opens without counter or arrows, to be zoomed.
134
+
135
+ ```tsx
136
+ import { Lightbox, LightboxTrigger, type LightboxImage } from "@zonsh/ui";
137
+
138
+ // FILES: as in the first example on this page that uses them.
139
+
140
+ /* One figure in an article, opened large to read its detail. */
141
+ const figure: LightboxImage[] = [
142
+ {
143
+ src: `${FILES}eclipse-poster.jpg`,
144
+ alt: "A drawn total eclipse: the moon's disc ringed by the corona",
145
+ caption:
146
+ "Totality, drawn for the eclipse clip: the corona shows only while the moon covers the whole sun.",
147
+ },
148
+ ];
149
+
150
+ export function Figure() {
151
+ return (
152
+ <figure className="m-0 flex w-full max-w-lg flex-col gap-3">
153
+ <Lightbox items={figure}>
154
+ <LightboxTrigger
155
+ index={0}
156
+ className="block overflow-hidden rounded-button border border-field-edge bg-black p-0"
157
+ >
158
+ <img src={figure[0]!.src} alt={figure[0]!.alt} className="aspect-video w-full object-cover" />
159
+ </LightboxTrigger>
160
+ </Lightbox>
161
+ <figcaption className="text-[13px] text-muted-foreground">
162
+ Fig. 2 — Totality. Select the image to see it full size; double-click or pinch to zoom.
163
+ </figcaption>
164
+ </figure>
165
+ );
166
+ }
167
+ ```
168
+
169
+ ## Props
170
+
171
+ ### Lightbox
172
+
173
+ | Prop | Type | Default |
174
+ | ---------------- | ------------------------------------------------------------------------ | ------- |
175
+ | `items` | `LightboxItem[]` — images, or files of any kind | — |
176
+ | `index` | `number` — the item shown; with `open`, opens the viewer from code at it | — |
177
+ | `defaultIndex` | `number` | `0` |
178
+ | `onIndexChange` | `(index) => void` | — |
179
+ | `open` | `boolean` | — |
180
+ | `defaultOpen` | `boolean` | `false` |
181
+ | `onOpenChange` | `(open) => void` | — |
182
+ | `loop` | `boolean` | `false` |
183
+ | `download` | `boolean` | `false` |
184
+ | `imageClassName` | `string` — on the large image | — |
185
+ | `labels` | `Partial<LightboxMessages>` | English |
186
+
187
+ An image in `items` is `{ src, alt, thumbnail?, caption?, srcSet?, sizes?, download? }` (`LightboxImage`); a file adds `kind?`, `type?`, `name?`, `size?`, `poster?`, `text?` and `language?` (`LightboxItem`). `alt` is required: it names the thumbnail and the image.
188
+
189
+ A transparent image can vanish on black: `imageClassName="invert"` turns line art white, `bg-white` puts a logo on paper.
190
+
191
+ ### LightboxGrid, LightboxTrigger
192
+
193
+ `LightboxGrid` takes `columns` and `<ul>` props. `LightboxTrigger` takes `index` and the props of Base UI's `Button`, `render` included.
194
+
195
+ The viewer's parts carry `data-slot`: `lightbox-content`, `lightbox-stage` (with `data-zoomed`), `lightbox-image`, `lightbox-counter`, `lightbox-caption`, `lightbox-previous`, `lightbox-next`, `lightbox-zoom`, `lightbox-download`, `lightbox-close`.
196
+
197
+ ## Brand rules
198
+
199
+ - **Do** write an `alt` that says what each image shows, and a caption when there is more to say.
200
+ - **Do** give large images a `thumbnail`.
201
+ - **Do** keep the ground black in both themes.
202
+ - **Don't** put text in images to be read here; it cannot be searched or translated.
203
+ - **Don't** use it for a small image already readable on the page.
204
+
205
+ ## Accessibility
206
+
207
+ - A modal Dialog named "Image viewer": focus stays inside and returns on close to the thumbnail last shown, or whatever opened it.
208
+ - Each thumbnail is a button named by its `alt`, with `aria-haspopup="dialog"`.
209
+ - A polite live region reads each change: "Image 3 of 7: Solution concept"; the visible counter is hidden.
210
+ - Previous and Next stay focusable at the ends (without `loop`).
211
+ - Under reduced motion nothing transitions; a swipe still follows the finger.
212
+ - Words come from `labels` or `messages.lightbox`.
213
+
214
+ ### Keyboard
215
+
216
+ | Key | What it does |
217
+ | --------------- | ------------------------------------------------------------------------------------------ |
218
+ | Enter / Space | Opens the viewer on the focused thumbnail's image |
219
+ | ← / → | Shows the previous or next image at rest (swapped right to left) |
220
+ | ← → ↑ ↓ | Zoomed in: looks around the image, a sixth of the view at a time, the way the arrow points |
221
+ | Shift+← / → | Zoomed in: shows the previous or next image all the same |
222
+ | Home / End | Shows the first or last image |
223
+ | + / = | Zooms in |
224
+ | - | Zooms out |
225
+ | 0 | Resets the zoom |
226
+ | Tab / Shift+Tab | Moves through the viewer's buttons; the focus stays in the viewer |
227
+ | Escape | Closes the viewer and returns the focus to the thumbnail |
228
+
229
+ Keys are left alone while ⌘, Ctrl or Alt is held. Zoom keys work on images only; in a video, sound, PDF or text the keys belong to the player or reader, and only Escape still closes.
230
+
231
+ ---
232
+
233
+ - Import: `import { Lightbox, LightboxGrid, LightboxTrigger } from "@zonsh/ui"`
234
+ - Source: `packages/ui/src/components/lightbox.tsx`
235
+ - Primitive: `@base-ui/react/dialog` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/dialog.md`)
@@ -0,0 +1,279 @@
1
+ # Locale
2
+
3
+ ```tsx
4
+ import { Button, CopyButton, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Field, FieldLabel, LocaleProvider, NumberField, Pagination } from "@zonsh/ui";
5
+ import { de } from "@zonsh/ui/messages/de";
6
+ import * as React from "react";
7
+
8
+ function Pages() {
9
+ const [page, setPage] = React.useState(3);
10
+ return <Pagination page={page} pageCount={9} onPageChange={setPage} />;
11
+ }
12
+
13
+ /** A dialog whose close button is named "Schließen", and a copy button that answers "Kopiert". */
14
+ function Invoice() {
15
+ return (
16
+ <Dialog>
17
+ <DialogTrigger render={<Button variant="secondary" />}>Rechnung ansehen</DialogTrigger>
18
+ <DialogContent size="sm">
19
+ <DialogHeader>
20
+ <DialogTitle>Rechnung RE-2026-0417</DialogTitle>
21
+ <DialogDescription>
22
+ Fällig am 15. November. Der Link führt direkt zur Rechnung, etwa für die Buchhaltung.
23
+ </DialogDescription>
24
+ </DialogHeader>
25
+ <DialogFooter>
26
+ <DialogClose render={<Button variant="secondary" />}>Fertig</DialogClose>
27
+ <CopyButton value="https://example.com/rechnungen/RE-2026-0417" size="default">
28
+ Link kopieren
29
+ </CopyButton>
30
+ </DialogFooter>
31
+ </DialogContent>
32
+ </Dialog>
33
+ );
34
+ }
35
+
36
+ export function German() {
37
+ return (
38
+ <LocaleProvider locale="de-DE" messages={de}>
39
+ <div lang="de" className="flex w-full flex-col items-center gap-6">
40
+ <Pages />
41
+ <Field className="w-full max-w-xs">
42
+ <FieldLabel>Betrag</FieldLabel>
43
+ <NumberField defaultValue={1284.5} step={0.5} format={{ style: "currency", currency: "EUR" }} />
44
+ </Field>
45
+ <Invoice />
46
+ </div>
47
+ </LocaleProvider>
48
+ );
49
+ }
50
+ ```
51
+
52
+ Every component's built-in text — "Previous page", "Copied", the names screen readers announce — is English by default. `LocaleProvider` replaces it for everything inside, and sets the locale for numbers, dates and times. A component's own `labels` prop still wins.
53
+
54
+ ## Usage
55
+
56
+ ```tsx
57
+ import { LocaleProvider, Toaster } from "@zonsh/ui";
58
+ import { de } from "@zonsh/ui/messages/de";
59
+
60
+ <LocaleProvider locale="de-DE" messages={de}>
61
+ <App />
62
+ <Toaster />
63
+ </LocaleProvider>;
64
+ ```
65
+
66
+ Set `locale` (a BCP 47 tag) and `messages` (a pack, or a partial object), and put everything that shows text inside — the `Toaster` too. To change a few words of a pack, spread it:
67
+
68
+ ```tsx
69
+ const messages = { ...de, pagination: { ...de.pagination, nav: "Ergebnisseiten" } };
70
+ ```
71
+
72
+ Or give only what you translate; anything missing stays English.
73
+
74
+ ```tsx
75
+ <LocaleProvider
76
+ locale="de-DE"
77
+ messages={{
78
+ pagination: {
79
+ nav: "Seiten",
80
+ previous: "Vorherige Seite",
81
+ next: "Nächste Seite",
82
+ page: (n) => `Seite ${n}`,
83
+ },
84
+ }}
85
+ >
86
+ <App />
87
+ </LocaleProvider>
88
+ ```
89
+
90
+ ## When to use
91
+
92
+ - An app in another language: wrap the root once.
93
+ - A region in another language (a translated preview): wrap just that region; nested providers merge into the outer one.
94
+ - One component needing other words ("Next result"): its `labels` prop, not a provider.
95
+
96
+ ## Message packs
97
+
98
+ A pack is every component's text in one language, typed as the full `LocaleMessages`. The library ships German:
99
+
100
+ | Pack | Import | Locale |
101
+ | ------ | -------------------------------------------- | --------- |
102
+ | German | `import { de } from "@zonsh/ui/messages/de"` | `"de-DE"` |
103
+
104
+ It is neutral interface German, as in macOS and Google: infinitives and nouns ("Kopieren", "Vorherige Seite"), never "Sie" or "du". Packs are plain data, importable on the server.
105
+
106
+ For another language, type your own object as `LocaleMessages`; the typecheck fails while a key is missing:
107
+
108
+ ```ts
109
+ import type { LocaleMessages } from "@zonsh/ui";
110
+
111
+ export const nl: LocaleMessages = {
112
+ pagination: {
113
+ nav: "Paginering",
114
+ previous: "Vorige pagina",
115
+ next: "Volgende pagina",
116
+ page: (n) => `Pagina ${n}`,
117
+ },
118
+ // … every other namespace
119
+ };
120
+ ```
121
+
122
+ ## Examples
123
+
124
+ ### Nested regions
125
+
126
+ An inner provider switches one region of a German page to French.
127
+
128
+ ```tsx
129
+ import { LocaleProvider, Pagination, useLocale, type PartialLocaleMessages } from "@zonsh/ui";
130
+ import { de } from "@zonsh/ui/messages/de";
131
+ import * as React from "react";
132
+
133
+ // Pages: as in the first example on this page that uses them.
134
+
135
+ const french: PartialLocaleMessages = {
136
+ pagination: {
137
+ nav: "Pages",
138
+ previous: "Page précédente",
139
+ next: "Page suivante",
140
+ page: (page) => `Page ${page}`,
141
+ },
142
+ };
143
+
144
+ /** Formats with the provider's locale — the same as the components inside it. */
145
+ function Total() {
146
+ const locale = useLocale();
147
+ return (
148
+ <p className="font-mono text-[13px] text-muted-foreground tabular-nums">
149
+ {new Intl.NumberFormat(locale, { style: "currency", currency: "EUR" }).format(1284.5)}
150
+ </p>
151
+ );
152
+ }
153
+
154
+ export function Nested() {
155
+ return (
156
+ <LocaleProvider locale="de-DE" messages={de}>
157
+ <div lang="de" className="flex flex-col items-center gap-6">
158
+ <Pages />
159
+ <LocaleProvider locale="fr-FR" messages={french}>
160
+ <div lang="fr" className="flex flex-col items-center gap-4">
161
+ <Pages />
162
+ <Total />
163
+ </div>
164
+ </LocaleProvider>
165
+ </div>
166
+ </LocaleProvider>
167
+ );
168
+ }
169
+ ```
170
+
171
+ ## Namespaces
172
+
173
+ One entry per component (or family), in camelCase; each has an exported `…Messages` interface documenting the English defaults.
174
+
175
+ | Namespace | Interface | Used by |
176
+ | ---------------- | ------------------------ | --------------------------------------------------------- |
177
+ | `bottomNav` | `BottomNavMessages` | BottomNav, BottomNavItem |
178
+ | `breadcrumb` | `BreadcrumbMessages` | Breadcrumb |
179
+ | `carousel` | `CarouselMessages` | Carousel and its parts |
180
+ | `codeBlock` | `CodeBlockMessages` | CodeBlock (its confirmation comes from `copyButton`) |
181
+ | `colorPicker` | `ColorPickerMessages` | ColorPicker, ColorPickerPanel |
182
+ | `combobox` | `ComboboxMessages` | ComboboxInput, ComboboxChip |
183
+ | `command` | `CommandMessages` | CommandDialog, CommandInput, CommandFooter |
184
+ | `conversation` | `ConversationMessages` | ConversationScrollButton |
185
+ | `copyButton` | `CopyButtonMessages` | CopyButton |
186
+ | `dataTable` | `DataTableMessages` | DataTable |
187
+ | `datePicker` | `DatePickerMessages` | DatePicker, DateRangePicker |
188
+ | `dateTimePicker` | `DateTimePickerMessages` | DateTimePicker |
189
+ | `dialog` | `DialogMessages` | DialogContent |
190
+ | `drawer` | `DrawerMessages` | DrawerContent |
191
+ | `fileDrop` | `FileDropMessages` | FileDrop, FileDropItem |
192
+ | `filterBar` | `FilterBarMessages` | FilterBar |
193
+ | `graph` | `GraphMessages` | Graph |
194
+ | `inputGroup` | `InputGroupMessages` | InputGroupPasswordToggle, InputGroupClearButton |
195
+ | `kbd` | `KbdMessages` | KbdShortcut, MenuShortcut, FileDrop — key names off Apple |
196
+ | `lightbox` | `LightboxMessages` | Lightbox |
197
+ | `markdownEditor` | `MarkdownEditorMessages` | MarkdownEditor |
198
+ | `mentions` | `MentionsMessages` | Mentions |
199
+ | `moneyInput` | `MoneyInputMessages` | MoneyInput |
200
+ | `numberField` | `NumberFieldMessages` | NumberField |
201
+ | `otpField` | `OtpFieldMessages` | OtpField |
202
+ | `pagination` | `PaginationMessages` | Pagination |
203
+ | `pdfViewer` | `PdfViewerMessages` | PdfViewer, PdfPreview |
204
+ | `phoneInput` | `PhoneInputMessages` | PhoneInput |
205
+ | `promptInput` | `PromptInputMessages` | PromptInputTextarea, …AttachButton, …Attachment, …Submit |
206
+ | `rating` | `RatingMessages` | Rating |
207
+ | `reasoning` | `ReasoningMessages` | ReasoningTrigger |
208
+ | `resizable` | `ResizableMessages` | ResizableHandle |
209
+ | `response` | `ResponseMessages` | Response (task list boxes) |
210
+ | `sidebar` | `SidebarMessages` | Sidebar, SidebarTrigger, SidebarRail |
211
+ | `siteHeader` | `SiteHeaderMessages` | SiteHeader |
212
+ | `sortable` | `SortableMessages` | Sortable and its parts |
213
+ | `sources` | `SourcesMessages` | SourcesTrigger, Source |
214
+ | `spinner` | `SpinnerMessages` | Spinner |
215
+ | `stat` | `StatMessages` | Stat |
216
+ | `stepper` | `StepperMessages` | Stepper |
217
+ | `tagsInput` | `TagsInputMessages` | TagsInput |
218
+ | `theme` | `ThemeMessages` | ThemeToggle |
219
+ | `timeField` | `TimeFieldMessages` | TimeField |
220
+ | `timeline` | `TimelineMessages` | TimelineChange |
221
+ | `toast` | `ToastMessages` | Toaster |
222
+ | `toolCall` | `ToolCallMessages` | ToolCall, ToolCallInput, ToolCallOutput |
223
+ | `tour` | `TourMessages` | Tour |
224
+ | `videoPlayer` | `VideoPlayerMessages` | VideoPlayer |
225
+
226
+ The optional components' namespaces (`carousel`, `dataTable`, `datePicker`, `dateTimePicker`, `filterBar`, `graph`, `pdfViewer`, `resizable`) are typed once their entry (`@zonsh/ui/graph` and the like) is imported.
227
+
228
+ ## Numbers and dates
229
+
230
+ The provider's `locale` is the default for everything that formats — NumberField, Slider, Progress and Meter values, TimeField, FilterBar chips, DataTable sorting, Chart tooltips, FileDropItem sizes — unless a component's own `locale` is set.
231
+
232
+ Calendar, DatePicker and DateRangePicker use date-fns locale objects, which the provider does not set. Pass one from `react-day-picker/locale` (it also translates the calendar's labels):
233
+
234
+ ```tsx
235
+ import { de as calendarDe } from "react-day-picker/locale";
236
+
237
+ <LocaleProvider locale="de-DE" messages={de}>
238
+ <DatePicker locale={calendarDe} />
239
+ </LocaleProvider>;
240
+ ```
241
+
242
+ Keep both in one wrapper or constant so the language is set once.
243
+
244
+ ## Props
245
+
246
+ | Prop | Type | Default |
247
+ | ---------- | ----------------- | ---------------------- |
248
+ | `locale` | `string` | the browser's language |
249
+ | `messages` | `PartialLocaleMessages` | `{}` (English) |
250
+ | `children` | `ReactNode` | — |
251
+
252
+ Value-dependent strings are functions (`page: (n) => …`). Each namespace merges string by string: `labels` over the provider, the provider over the English defaults, an inner provider over an outer one.
253
+
254
+ `useLocale(): string | undefined` returns the nearest provider's locale, for your own `Intl` formatting. `useMessages(key, defaults, labels?)` resolves defaults, then provider, then `labels`; use it in your own components by extending `LocaleMessages`:
255
+
256
+ ```ts
257
+ declare module "@zonsh/ui" {
258
+ interface LocaleMessages {
259
+ invoiceList: { empty: string };
260
+ }
261
+ }
262
+ ```
263
+
264
+ ## Brand rules
265
+
266
+ - **Do** translate the whole message set of a component, including what only screen readers hear — a pack does.
267
+ - **Do** set `lang` on `<html>` (and on a region in another language) — the provider changes the text, not the document's language.
268
+ - **Don't** pass a new `messages` object on every render when it never changes; define it once outside the component.
269
+ - **Don't** mix forms of address: the pack never says "Sie" or "du", so keep your own text in the same neutral voice.
270
+
271
+ ## Accessibility
272
+
273
+ - Icon button names, landmarks and live announcements come from the same messages, so a translated app is translated for screen readers too.
274
+ - Pair a right-to-left language with `DirectionProvider` and `dir="rtl"` — see Direction.
275
+
276
+ ---
277
+
278
+ - Import: `import { LocaleProvider, useLocale, useMessages } from "@zonsh/ui"`
279
+ - Source: `packages/ui/src/components/locale.tsx`