@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
@@ -6,6 +6,7 @@
6
6
  * fits on one line beside them; an `inline` column moves into the title cell instead. Only once
7
7
  * every column that can step out has done so may titles wrap.
8
8
  */
9
+ import { cssDuration, cssEase } from "./motion.js";
9
10
  /* ── Fit ───────────────────────────────────────────────────────────────────── */
10
11
  /** The columns that can step out, in the order they do. The title never does. */
11
12
  export function removalOrder(columns, title) {
@@ -50,11 +51,50 @@ const UNCLIP = "position:static;display:inline-flex;width:max-content;min-width:
50
51
  */
51
52
  export function measuredRows(body) {
52
53
  const virtual = !!body.querySelector("[data-slot=table-sizer]");
53
- return [
54
+ const rows = [
54
55
  ...body.querySelectorAll(virtual
55
56
  ? "[data-slot=table-header] [data-slot=table-row], [data-slot=table-sizer] [data-slot=table-row]"
56
57
  : "[data-slot=table-row]"),
57
58
  ];
59
+ return virtual ? rows : sampledRows(rows);
60
+ }
61
+ /**
62
+ * How many body rows of a table that isn't virtual are measured at most. A long table's widest
63
+ * cells are among the rows whose text is longest, column by column, and the first few: measuring
64
+ * every row of a table of 243 (a clone of each cell, laid out) took seconds on every change.
65
+ */
66
+ const MEASURED_ROWS = 48;
67
+ function sampledRows(all) {
68
+ if (all.length <= MEASURED_ROWS)
69
+ return all;
70
+ const picked = new Set();
71
+ const longest = new Map();
72
+ const note = (key, length, row) => {
73
+ const list = longest.get(key) ?? [];
74
+ list.push([length, row]);
75
+ longest.set(key, list);
76
+ };
77
+ const bodyRows = [];
78
+ for (const row of all) {
79
+ if (row.closest("[data-slot=table-header]")) {
80
+ picked.add(row);
81
+ continue;
82
+ }
83
+ bodyRows.push(row);
84
+ note("title", row.querySelector("[data-slot=table-title-text]")?.textContent?.length ?? 0, row);
85
+ for (const cell of row.querySelectorAll("[data-column]")) {
86
+ note(cell.getAttribute("data-column"), cell.textContent?.length ?? 0, row);
87
+ }
88
+ }
89
+ const each = Math.max(2, Math.ceil(MEASURED_ROWS / Math.max(1, longest.size)));
90
+ for (const list of longest.values()) {
91
+ list.sort((a, b) => b[0] - a[0]);
92
+ for (const [, row] of list.slice(0, each))
93
+ picked.add(row);
94
+ }
95
+ for (const row of bodyRows.slice(0, 8))
96
+ picked.add(row);
97
+ return all.filter((row) => picked.has(row));
58
98
  }
59
99
  /**
60
100
  * Clones every measured title and cell (`measuredRows`) into a hidden probe with
@@ -140,7 +180,7 @@ function widthNeeded(layout, drawn, title, m, edge, gap) {
140
180
  }
141
181
  /**
142
182
  * The final layout's room for the title's track: the width less the columns that keep their own,
143
- * the gaps, and the padding of a last track that sizes to its content. Null before the final
183
+ * the gaps, and the padding of a first or last track that sizes to its content. Null before the final
144
184
  * layout, or when the title is the only column left.
145
185
  */
146
186
  export function titleRoom(layout, drawn, title, m, available, edge, gap) {
@@ -150,9 +190,13 @@ export function titleRoom(layout, drawn, title, m, available, edge, gap) {
150
190
  const others = own.filter((c) => c.id !== title);
151
191
  if (!others.length)
152
192
  return null;
193
+ // The rows' padding grows an edge track that sizes to its content: the first one (a selection
194
+ // checkbox, say) as much as the last.
195
+ const pads = (c) => c.id !== title && (c.width ?? "auto") === "auto";
196
+ const head = pads(own[0]) ? edge : 0;
153
197
  const last = own.at(-1);
154
- const tail = last.id !== title && (last.width ?? "auto") === "auto" ? edge : 0;
155
- const taken = others.reduce((sum, c) => sum + (m.tracks[c.id] ?? 0), 0) + gap * others.length + tail;
198
+ const tail = pads(last) ? edge : 0;
199
+ const taken = others.reduce((sum, c) => sum + (m.tracks[c.id] ?? 0), 0) + gap * others.length + head + tail;
156
200
  return Math.max(0, Math.floor(available - taken));
157
201
  }
158
202
  /**
@@ -177,23 +221,27 @@ export function fitStep(options) {
177
221
  /**
178
222
  * One beat for the whole row: a leaving cell fades over exactly the time its neighbours take to
179
223
  * glide into the space it frees, on the same curve and from the same start, so the gap closes as
180
- * the cell goes. Entering cells start a moment later and land with them.
224
+ * the cell goes. Entering cells start a moment later and land with them. The beat is
225
+ * `--duration-glide` (1.6 × `--duration`, 240ms; 0 under reduced motion), read from the table.
181
226
  */
182
- const MOVE_MS = 280;
227
+ const moveMs = (el) => cssDuration(el) * 1.6;
183
228
  const ENTER_DELAY_MS = 40;
184
- const ENTER_MS = MOVE_MS - ENTER_DELAY_MS;
229
+ /** Entering cells grow from this scale: near their size, so they arrive rather than appear. */
230
+ const ENTER_SCALE = "0.9";
185
231
  /**
186
- * Fades run on a gentle standard curve, not the brand's front-loaded ease-out: on that curve a
187
- * fade is ~85% done in the first frames, so a returning column seemed to pop straight in.
232
+ * Fades run on `--ease-glide`, not the brand's front-loaded ease-out: on that curve a fade is
233
+ * ~85% done in the first frames, so a returning column seemed to pop straight in.
188
234
  */
189
- const FADE_EASING = "cubic-bezier(0.4, 0, 0.2, 1)";
190
- const EXIT_MS = MOVE_MS;
235
+ const fadeEasing = (el) => cssEase("--ease-glide", el);
191
236
  /** How far a leaving cell drifts towards its own side as it fades. */
192
237
  const EXIT_DRIFT_PX = 8;
193
238
  /** Delay between one row (or band) and the next, top to bottom — exits and glides alike. */
194
239
  const STAGGER_MS = 30;
195
- /** The last row in view starts by then, so a long table still settles within ~520ms. */
196
- const SPREAD_MS = 240;
240
+ /**
241
+ * Only the first rows in view are staggered; the rest start with the last of them. Two steps of
242
+ * 30ms and a 240ms glide: the whole table has settled within 300ms.
243
+ */
244
+ const STAGGER_ROWS = 3;
197
245
  const ZERO = { x: 0, y: 0 };
198
246
  const keyOf = (el) => el.getAttribute("data-flip-key") ?? el;
199
247
  /** Rows of a closed group are not drawn, nor a virtual body's sizer rows. */
@@ -246,7 +294,7 @@ export class Flip {
246
294
  this.rtl = getComputedStyle(this.root).direction === "rtl";
247
295
  }
248
296
  easing() {
249
- return getComputedStyle(this.root).getPropertyValue("--ease").trim() || "cubic-bezier(0.16, 1, 0.3, 1)";
297
+ return cssEase("--ease", this.root);
250
298
  }
251
299
  track(a) {
252
300
  if (this.active++ === 0)
@@ -292,7 +340,21 @@ export class Flip {
292
340
  measure(offsets) {
293
341
  const box = this.body.getBoundingClientRect();
294
342
  const content = { x: box.left - this.body.scrollLeft, y: box.top - this.body.scrollTop };
295
- const els = [...this.root.querySelectorAll("[data-flip]")].filter(isDrawn);
343
+ // Only what is within a view's height of the view glides; the rest of a long table moves at
344
+ // once, unseen (hundreds of rows animating made every step of a drag stutter). Each piece is
345
+ // judged by its row's box: a row out of view may skip its layout (content-visibility), and
346
+ // reading a box inside it would lay it out.
347
+ const near = (r) => r.bottom >= box.top - box.height && r.top <= box.bottom + box.height;
348
+ const rows = new Map();
349
+ const els = [...this.root.querySelectorAll("[data-flip]")].filter(isDrawn).filter((el) => {
350
+ const row = el.closest("[data-flip=row],[data-flip=band]") ?? el;
351
+ let ok = rows.get(row);
352
+ if (ok === undefined) {
353
+ ok = near(row.getBoundingClientRect());
354
+ rows.set(row, ok);
355
+ }
356
+ return ok;
357
+ });
296
358
  const rects = new Map(els.map((el) => [el, el.getBoundingClientRect()]));
297
359
  const rel = new Map();
298
360
  for (const el of els) {
@@ -306,8 +368,9 @@ export class Flip {
306
368
  return { els, rects, rel, view: box };
307
369
  }
308
370
  /**
309
- * The cascade: bands and rows in view count 0, 1, 2… from the top; those above the view start
310
- * at once, those below with the last one in view.
371
+ * The cascade: rows in view count 0, 1, 2… from the top, and a band takes the step of the row
372
+ * after it (it has nothing to glide, so it must not hold the rows back); those above the view
373
+ * start at once, those below with the last one in view.
311
374
  */
312
375
  cascade(rects, view) {
313
376
  const index = new Map();
@@ -322,12 +385,11 @@ export class Flip {
322
385
  else if (r.top >= view.bottom)
323
386
  below.push(el);
324
387
  else
325
- index.set(el, count++);
388
+ index.set(el, el.getAttribute("data-flip") === "row" ? count++ : count);
326
389
  }
327
390
  for (const el of below)
328
391
  index.set(el, Math.max(0, count - 1));
329
- const gap = count > 1 ? Math.min(STAGGER_MS, SPREAD_MS / (count - 1)) : 0;
330
- return (seq) => (seq ? (index.get(seq) ?? 0) * gap : 0);
392
+ return (seq) => (seq ? Math.min(index.get(seq) ?? 0, STAGGER_ROWS - 1) * STAGGER_MS : 0);
331
393
  }
332
394
  /** Forget the last positions: something other than the width moved things (scroll, data, a group). */
333
395
  invalidate() {
@@ -343,6 +405,7 @@ export class Flip {
343
405
  /** Glides from what is drawn now to the layout that `commit` applies (synchronously) for `next`. */
344
406
  tier(next, commit) {
345
407
  const easing = this.easing();
408
+ const move = moveMs(this.root);
346
409
  this.direction();
347
410
  // Read: positions (mid-glide included), the fade of anything mid-entrance, the ghosts still
348
411
  // fading out, and clones of the pieces about to step out.
@@ -412,9 +475,13 @@ export class Flip {
412
475
  }
413
476
  if (!from) {
414
477
  this.run(el, [
415
- { opacity: 0, scale: "0.6", transformOrigin: side },
478
+ { opacity: 0, scale: ENTER_SCALE, transformOrigin: side },
416
479
  { opacity: 1, scale: "1", transformOrigin: side },
417
- ], { duration: ENTER_MS, delay: wait + ENTER_DELAY_MS, easing: FADE_EASING });
480
+ ], {
481
+ duration: Math.max(0, move - ENTER_DELAY_MS),
482
+ delay: move ? wait + ENTER_DELAY_MS : 0,
483
+ easing: fadeEasing(this.root),
484
+ });
418
485
  continue;
419
486
  }
420
487
  const to = last.rel.get(keyOf(el));
@@ -431,7 +498,7 @@ export class Flip {
431
498
  this.run(el, [
432
499
  { translate: `${dx}px ${dy}px`, ...fade[0] },
433
500
  { translate: "0px 0px", ...fade[1] },
434
- ], { duration: MOVE_MS, delay: wait, easing });
501
+ ], { duration: move, delay: wait, easing });
435
502
  }
436
503
  for (const l of leaving) {
437
504
  if (l.key)
@@ -465,7 +532,7 @@ export class Flip {
465
532
  transformOrigin: side,
466
533
  offset: 1,
467
534
  },
468
- ], { duration: EXIT_MS, delay: delay(l.seq), easing, fill: "both" }));
535
+ ], { duration: move, delay: delay(l.seq), easing, fill: "both" }));
469
536
  const ghost = { clone, anim };
470
537
  if (l.key)
471
538
  this.ghosts.set(l.key, ghost);
@@ -521,7 +588,7 @@ export class Flip {
521
588
  this.run(el, [
522
589
  { translate: `${dx}px ${dy}px`, ...fade[0] },
523
590
  { translate: "0px 0px", ...fade[1] },
524
- ], { duration: MOVE_MS, easing });
591
+ ], { duration: moveMs(this.root), easing });
525
592
  }
526
593
  }
527
594
  this.cache = now.rel;
@@ -0,0 +1,267 @@
1
+ /** A colour as the tokens write it: OKLCH lightness 0–1, chroma, hue in degrees, alpha 0–1. */
2
+ export interface ThemeColor {
3
+ l: number;
4
+ c: number;
5
+ h: number;
6
+ a: number;
7
+ }
8
+ type Scheme = "light" | "dark";
9
+ /**
10
+ * A colour as CSS: `oklch(0.52 0.15 250)` (lightness, chroma and hue to 3, 3 and 1 places, as
11
+ * tokens.css writes them), or `#rrggbb[aa]`, with chroma lowered until it fits in sRGB.
12
+ */
13
+ export declare function formatThemeColor(color: ThemeColor, format?: "oklch" | "hex"): string;
14
+ /**
15
+ * Reads a CSS colour: `oklch(…)` (lightness as a number or a percent, optional `/ alpha`),
16
+ * `#rgb[a]`, `#rrggbb[aa]`, `rgb()`/`rgba()`, `hsl()`/`hsla()` (with commas or spaces) and the
17
+ * CSS colour names (`teal`, `rebeccapurple`). Null if it is none of them.
18
+ */
19
+ export declare function parseThemeColor(input: string): ThemeColor | null;
20
+ /** The WCAG 2 contrast ratio of a colour (its alpha included) on an opaque ground: 1 to 21. */
21
+ export declare function themeContrast(fg: ThemeColor, bg: ThemeColor): number;
22
+ /** The nearest lightness, darker or lighter, at which `fg` reaches `min` on `bg`. Null if none does. */
23
+ export declare function fixThemeContrast(fg: ThemeColor, bg: ThemeColor, min: number): ThemeColor | null;
24
+ /** One colour token a theme sets: what it is for, and the ground it must read on, if it is text. */
25
+ export interface ThemeToken {
26
+ name: string;
27
+ label: string;
28
+ /** neutral: a grey; accent: the primary; status: success, warning, info, destructive; tone: a category tone. */
29
+ kind: "neutral" | "accent" | "status" | "tone";
30
+ /** Text, or a mark, that must read on another token, and the ratio it needs. */
31
+ on?: {
32
+ token: string;
33
+ min: number;
34
+ };
35
+ /**
36
+ * The other grounds it sits on, where it needs the same ratio: a card, a menu, a field, the
37
+ * hovered fill. The generator moves it until it reads on `on.token` and on every one of these.
38
+ */
39
+ alsoOn?: readonly string[];
40
+ }
41
+ /** The colour tokens a theme sets, grouped as in tokens.css. */
42
+ export declare const themeTokenGroups: readonly {
43
+ title: string;
44
+ tokens: readonly ThemeToken[];
45
+ }[];
46
+ /** zon's own colours as tokens.css writes them, by theme: the ground every preset is generated from. */
47
+ export declare const zonThemeTokens: Readonly<Record<Scheme, Readonly<Record<string, string>>>>;
48
+ /** The generator's settings. Each moves in the steps a preset code holds (see normalizeThemePreset). */
49
+ export interface ThemeSettings {
50
+ /** Chroma laid over every grey, 0–0.04 in steps of 0.001: 0 is zon's pure neutral. */
51
+ tint: number;
52
+ /** The greys' hue, 0–359°. */
53
+ tintHue: number;
54
+ /** 0 keeps the primary grey; 1 makes it a full colour. Steps of 0.01. */
55
+ accent: number;
56
+ /** The primary's hue, 0–359°. */
57
+ accentHue: number;
58
+ /** Chroma of the status colours and tones against zon's, 0.3–1.5 in steps of 0.01. */
59
+ vivid: number;
60
+ /** Turns the six tones round the hue circle together, −180° to 180°. */
61
+ toneShift: number;
62
+ /** Turns the four status colours together, −12° to 12°, so each keeps its meaning. */
63
+ statusShift: number;
64
+ /** 0 is zon's ground; 1 is a deeper paper in light and a lifted charcoal in dark. Steps of 0.01. */
65
+ ground: number;
66
+ }
67
+ /**
68
+ * How dense the interface is and how round the corners: one shape for both themes.
69
+ *
70
+ * The density is set by its default control height in px, `controlHeight`; the theme writes it as
71
+ * the `--density` factor (`themeDensity`), 1 at zon's 38px, which scales the padding, gaps and
72
+ * type inside the components. "Density" names that factor or a named level (`ThemeDensity`), never
73
+ * a height in px.
74
+ */
75
+ export interface ThemeShape {
76
+ /**
77
+ * The default control height in px, one of THEME_HEIGHTS (zon's is 38). The other heights, and
78
+ * through `--density` the padding and gaps inside the components and their type, follow it.
79
+ */
80
+ controlHeight: number;
81
+ /** The button's radius scaled, one of THEME_CORNERS (0 square, 1 zon's, 2 twice as round); the other radii keep their offsets from it. */
82
+ corners: number;
83
+ }
84
+ /** A theme as the editor holds it and a preset code carries it. */
85
+ export interface ThemePreset {
86
+ settings: ThemeSettings;
87
+ shape: ThemeShape;
88
+ /** Which seed colours were picked rather than left random: the greys (base), the primary (theme) and the tones (accent). */
89
+ seeds: {
90
+ base: boolean;
91
+ theme: boolean;
92
+ accent: boolean;
93
+ };
94
+ /** Colours set by hand, by theme: they win over the generator. */
95
+ pinned: Record<Scheme, Record<string, ThemeColor>>;
96
+ }
97
+ /** The default control heights a theme can set, in px: zon's 38 in the middle, 4px apart. */
98
+ export declare const THEME_HEIGHTS: readonly number[];
99
+ /** How round the corners can be, as a share of zon's button radius, in steps of 25%. */
100
+ export declare const THEME_CORNERS: readonly number[];
101
+ /** zon's own theme as a preset: `encodeThemePreset(zonThemePreset)` is its code. */
102
+ export declare const zonThemePreset: ThemePreset;
103
+ /**
104
+ * Every colour token of one theme (light or dark) for a preset: generated from zon's values and
105
+ * the settings, text moved until it reaches its contrast, colours pinned by hand laid on top, and
106
+ * the hover, pressed and card inks following their token.
107
+ */
108
+ export declare function themePalette(preset: ThemePreset, mode: Scheme): Record<string, ThemeColor>;
109
+ /** The dense, default and prominent heights for a default height: zon's 30 / 38 / 46, scaled. */
110
+ export declare function themeHeights(height: number): {
111
+ sm: number;
112
+ default: number;
113
+ lg: number;
114
+ };
115
+ /** The density factor (`--density`) for a default control height in px: 1 at zon's 38px, 0.79 at 30, 1.21 at 46. */
116
+ export declare function themeDensity(height: number): number;
117
+ /** A shape as zon's geometry tokens: the density, the three control heights, the round icon button 2px under the default, the inset controls and the radii. */
118
+ export declare function themeShapeTokens({ controlHeight, corners }: ThemeShape): Record<string, string>;
119
+ /** The version this module writes. */
120
+ export declare const THEME_PRESET_VERSION = 1;
121
+ /**
122
+ * A preset moved onto the steps a code holds, with anything out of range brought in and anything
123
+ * unknown dropped. Encoding a normalized preset and decoding it gives the same preset back.
124
+ */
125
+ export declare function normalizeThemePreset(preset: Partial<ThemePreset>): ThemePreset;
126
+ /**
127
+ * A preset as a code of letters and digits: 16 characters, and 8 more for each colour pinned by
128
+ * hand. The preset is normalized first, so the code holds what `decodeThemePreset` gives back.
129
+ */
130
+ export declare function encodeThemePreset(preset: Partial<ThemePreset>): string;
131
+ /** Why a code, or a colour or an option given to themePresetFromColor, could not be read. */
132
+ export declare class ThemePresetError extends Error {
133
+ constructor(message: string);
134
+ }
135
+ /**
136
+ * Reads a code back into the preset it holds. Case, spaces and hyphens are ignored. Throws a
137
+ * ThemePresetError, with a sentence saying why, for anything that is not a code.
138
+ */
139
+ export declare function decodeThemePreset(code: string): ThemePreset;
140
+ /** Where each part of a theme goes, after `@import "@zonsh/ui/styles.css";`. */
141
+ export declare const THEME_SELECTORS: {
142
+ readonly light: ":root, .theme-light";
143
+ readonly dark: '.dark, [data-theme="dark"], .theme-dark';
144
+ readonly shape: ":root";
145
+ };
146
+ /**
147
+ * A theme as a file to commit: `theme.json`. The editor's JSON export writes it, and
148
+ * `themeFromPreset`, `ThemeProvider` and `ThemeScope` take it as it is (`import theme from
149
+ * "./theme.json"`). The preset code is the theme; `shape`, `light` and `dark` are its tokens
150
+ * written out, so a change to the theme shows in review as the tokens that changed. A value edited
151
+ * by hand wins over the code's.
152
+ *
153
+ * Written the same way every time (`themeFromPreset(…).json`): keys in a fixed order, one token
154
+ * per line, two-space indent, a newline at the end, no dates.
155
+ */
156
+ export interface ThemeFile {
157
+ /** Always `"zon theme"`. */
158
+ name?: string;
159
+ /** Always `"@zonsh/ui"`. */
160
+ for?: string;
161
+ /** The file format, THEME_FILE_VERSION. Missing reads as 1. */
162
+ version?: number;
163
+ /** The theme's preset code, `Z1…`. */
164
+ preset: string;
165
+ /** The geometry tokens, for both themes: `--density`, the control heights and the radii. */
166
+ shape?: Record<string, string>;
167
+ /** The light theme's colour tokens. */
168
+ light?: Record<string, string>;
169
+ /** The dark theme's colour tokens. */
170
+ dark?: Record<string, string>;
171
+ }
172
+ /** The theme.json format this module writes and reads. */
173
+ export declare const THEME_FILE_VERSION = 1;
174
+ /** Anything a theme can be given as: a preset code, a preset, or a theme.json file. */
175
+ export type ThemeInput = string | Partial<ThemePreset> | ThemeFile;
176
+ /** Whether a theme input is a theme.json file (it names its preset code) rather than a preset. */
177
+ export declare function isThemeFile(input: unknown): input is ThemeFile;
178
+ export interface ThemeFromPresetOptions {
179
+ /** How colours are written: `oklch` as set, or `hex` with chroma lowered to fit in sRGB. Default `oklch`. */
180
+ format?: "oklch" | "hex";
181
+ /**
182
+ * Only the tokens that differ from zon's. Default `false`: every token the theme sets, so the
183
+ * theme looks the same whatever later version of zon's stylesheet it sits on.
184
+ */
185
+ onlyChanges?: boolean;
186
+ /**
187
+ * Write `css` for one area of the page instead of the whole document: the element with
188
+ * `data-theme-scope="<scope>"` and what is inside it, in light or dark as the page is, or as
189
+ * `.theme-light` / `.theme-dark` on that element force. Letters, digits, `-` and `_`.
190
+ * `ThemeScope` sets this up for you.
191
+ */
192
+ scope?: string;
193
+ }
194
+ /** A preset expanded: its code, its tokens by theme, and the stylesheet and file that apply them. */
195
+ export interface ThemeFromPreset {
196
+ /** The preset's code, normalized: upper case, no separators. */
197
+ code: string;
198
+ light: Record<string, string>;
199
+ dark: Record<string, string>;
200
+ /** The geometry tokens, for both themes. */
201
+ shape: Record<string, string>;
202
+ /** A stylesheet to put after `@import "@zonsh/ui/styles.css";`, or in a `<style>` after it. */
203
+ css: string;
204
+ /** The theme as a theme.json file, to commit: the same text for the same theme, every time. */
205
+ json: string;
206
+ }
207
+ /**
208
+ * Expands a preset code, a preset or a theme.json file into token values, the CSS that applies
209
+ * them and the theme.json text that records them:
210
+ *
211
+ * ```tsx
212
+ * <style>{themeFromPreset("Z1…").css}</style>
213
+ * ```
214
+ *
215
+ * Throws a ThemePresetError for a code or a file it can't read.
216
+ */
217
+ export declare function themeFromPreset(preset: ThemeInput, { format, onlyChanges, scope }?: ThemeFromPresetOptions): ThemeFromPreset;
218
+ /**
219
+ * One theme's tokens as an inline style, for an element that always shows that theme in light or
220
+ * dark: `<div className="theme-dark" style={themeScopeStyle(code, "dark")}>`. The colours, the
221
+ * density, the control heights and the radii, and `colorScheme`. To follow the page's light and
222
+ * dark, use `ThemeScope`, which writes the stylesheet for both.
223
+ */
224
+ export declare function themeScopeStyle(preset: ThemeInput, scheme: Scheme, options?: Pick<ThemeFromPresetOptions, "format">): Record<string, string>;
225
+ /** The greys of a theme made from a colour. */
226
+ export type ThemeNeutral = "pure" | "warm" | "cool" | "tinted";
227
+ /** How round the corners of a theme made from a colour are. */
228
+ export type ThemeCornersName = "square" | "subtle" | "default" | "round";
229
+ /** How dense a theme made from a colour is, by name: its control height and the `--density` that follows. */
230
+ export type ThemeDensity = "dense" | "compact" | "default" | "comfortable" | "spacious";
231
+ export interface ThemeFromColorOptions {
232
+ /**
233
+ * The greys (page, surfaces, edges and text): `pure`, zon's neutral grey (default); `warm`, a
234
+ * paper-like grey; `cool`, a slate grey; `tinted`, a hint of the colour itself.
235
+ */
236
+ neutral?: ThemeNeutral;
237
+ /**
238
+ * The corners: `square` (0), `subtle` (half zon's), `default` (zon's 12px buttons and 20px
239
+ * cards) or `round` (one and a half times zon's). Or one of THEME_CORNERS. Default `default`.
240
+ */
241
+ corners?: ThemeCornersName | number;
242
+ /**
243
+ * The density, by name: `dense` (30px controls), `compact` (34px), `default` (zon's 38px),
244
+ * `comfortable` (42px) or `spacious` (46px). Default `default`.
245
+ */
246
+ density?: ThemeDensity;
247
+ /** The default control height in px, one of THEME_HEIGHTS, in place of a named `density`. */
248
+ controlHeight?: number;
249
+ }
250
+ /**
251
+ * A theme from one colour, for when you know the brand colour but not the tokens. The primary
252
+ * button, checked controls and the focus outline take the colour's hue and as much colour as it
253
+ * has; the greys, corners and control height follow the plain options. It is built with the
254
+ * theme editor's generator, so text and the primary's label move until they read (4.5:1, and 3:1
255
+ * for the focus outline and the tick), in light and in dark.
256
+ *
257
+ * The colour is any CSS colour: `#c2410c`, `rgb(…)`, `hsl(…)`, `oklch(…)` or a name such as
258
+ * `teal`. A grey, black or white keeps zon's grey primary. Throws a ThemePresetError, saying
259
+ * why, for a colour or an option it can't read.
260
+ *
261
+ * ```tsx
262
+ * <ThemeProvider preset={themePresetFromColor("#c2410c", { corners: "round" })}>
263
+ * encodeThemePreset(themePresetFromColor("teal")) // its preset code, "Z1…"
264
+ * ```
265
+ */
266
+ export declare function themePresetFromColor(color: string, options?: ThemeFromColorOptions): ThemePreset;
267
+ export {};