@zonsh/ui 0.4.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (562) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +7 -7
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. package/package.json +69 -2
@@ -1,4 +1,5 @@
1
- import { type ReactNode } from "react";
1
+ import { type ComponentProps, type ReactNode } from "react";
2
+ import { type ThemeInput } from "../lib/theme-preset.js";
2
3
  import { type ThemeMode } from "../lib/theme-script.js";
3
4
  import { type ButtonProps } from "./button.js";
4
5
  export interface ThemeMessages {
@@ -6,11 +7,11 @@ export interface ThemeMessages {
6
7
  toggle: string;
7
8
  }
8
9
  declare module "./locale" {
9
- interface Messages {
10
+ interface LocaleMessages {
10
11
  theme: ThemeMessages;
11
12
  }
12
13
  }
13
- export { createThemeScript, themeScript, PAGE_TONE, THEME_STORAGE_KEY, type ThemeMode } from "../lib/theme-script.js";
14
+ export { createThemeScript, themeScript, PAGE_TONE, THEME_STORAGE_KEY, type ThemeMode, } from "../lib/theme-script.js";
14
15
  export type ResolvedTheme = "light" | "dark";
15
16
  export interface ThemeContextValue {
16
17
  /** The stored preference: `light`, `dark` or `system`. */
@@ -26,10 +27,19 @@ export interface ThemeProviderProps {
26
27
  /** localStorage key. Default `zon-theme`. */
27
28
  storageKey?: string;
28
29
  /**
29
- * Keep `<meta name="theme-color">` at the theme's page tone (`PAGE_TONE`), so a phone's
30
- * status bar and toolbar match the page. Default `true`; pass the same to `createThemeScript`.
30
+ * Keep `<meta name="theme-color">` at the theme's page tone (`PAGE_TONE`, or a `preset`'s
31
+ * ground), so a phone's status bar and toolbar match the page. Default `true`; pass the same to
32
+ * `createThemeScript`.
31
33
  */
32
34
  themeColor?: boolean;
35
+ /**
36
+ * A theme: a preset code from the theme editor, such as `"Z11ARFCXWTUPYKES"`, a preset, such
37
+ * as `themePresetFromColor("teal")`, or a theme.json file (`import theme from "./theme.json"`). Its stylesheet (`themeFromPreset(preset).css`) goes
38
+ * into a `<style>` at the end of `<head>`, so the whole app takes that theme in light and dark.
39
+ * A code that can't be read leaves zon's theme, with a warning in development. Applied after
40
+ * hydration; for a server-rendered first paint, put the stylesheet in `<head>` yourself.
41
+ */
42
+ preset?: ThemeInput;
33
43
  }
34
44
  /**
35
45
  * ThemeProvider — light, dark or system theme for the whole document. It toggles `.dark` on
@@ -40,10 +50,43 @@ export interface ThemeProviderProps {
40
50
  * already correct. The rule people break: forgetting the script, which flashes light
41
51
  * before React hydrates.
42
52
  */
43
- export declare function ThemeProvider({ children, defaultTheme, storageKey, themeColor, }: ThemeProviderProps): import("react").JSX.Element;
53
+ export declare function ThemeProvider({ children, defaultTheme, storageKey, themeColor, preset, }: ThemeProviderProps): import("react").JSX.Element;
44
54
  /** Read and change the theme. Must be used inside `ThemeProvider`. */
45
55
  export declare function useTheme(): ThemeContextValue;
56
+ export interface ThemeScopeProps extends ComponentProps<"div"> {
57
+ /**
58
+ * The area's theme: a preset code, a preset such as `themePresetFromColor("teal")`, or a
59
+ * theme.json file. Its colours, density and corners apply inside the area only. Without one,
60
+ * the area keeps the page's theme and `scheme` alone sets light or dark.
61
+ */
62
+ preset?: ThemeInput;
63
+ /**
64
+ * `light` or `dark` whatever the page is (it adds `.theme-light` / `.theme-dark`). Default: the
65
+ * page's own, so the area turns dark with the page.
66
+ */
67
+ scheme?: "light" | "dark";
68
+ }
69
+ /**
70
+ * ThemeScope — one area of a page in a theme of its own: a preset's colours, density and corners,
71
+ * light or dark with the page or forced, on a `div` that takes the theme's ground and ink.
72
+ *
73
+ * Menus, popovers, selects, dialogs, drawers, tooltips and toasts opened from inside it portal
74
+ * into an element it keeps at the end of `<body>` with the same theme, so they match the area
75
+ * they came from. A popup of your own takes it from `usePortalContainer()`.
76
+ */
77
+ export declare function ThemeScope({ preset, scheme, className, children, ...props }: ThemeScopeProps): import("react").JSX.Element;
78
+ /**
79
+ * The element a popup of your own should portal to, so it takes the theme of the ThemeScope it
80
+ * opens in: `<Popover.Portal container={usePortalContainer()}>`. Undefined outside a scope (the
81
+ * default, `document.body`); null for the moment the scope is making it.
82
+ */
83
+ export declare function usePortalContainer(): HTMLElement | null | undefined;
46
84
  export interface ThemeToggleProps extends Omit<ButtonProps, "children" | "variant" | "size"> {
85
+ /**
86
+ * `default`: the 36px round icon button. `sm`: 30px, to sit beside `size="sm"` buttons in a
87
+ * dense header or toolbar.
88
+ */
89
+ size?: "default" | "sm";
47
90
  }
48
91
  /**
49
92
  * ThemeToggle — a circular secondary icon button that switches between light and dark.
@@ -52,4 +95,4 @@ export interface ThemeToggleProps extends Omit<ButtonProps, "children" | "varian
52
95
  *
53
96
  * The rule people break: placing two toggles on a page. One lives in the header.
54
97
  */
55
- export declare function ThemeToggle({ onClick, ...props }: ThemeToggleProps): import("react").JSX.Element;
98
+ export declare function ThemeToggle({ onClick, size, ...props }: ThemeToggleProps): import("react").JSX.Element;
@@ -1,12 +1,15 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
- import { MoonIcon, SunIcon } from "lucide-react";
4
- import { createContext, useCallback, useContext, useEffect, useMemo, useState } from "react";
3
+ import { MoonIcon, SunIcon } from "../lib/icons.js";
4
+ import { createContext, useCallback, useContext, useEffect, useInsertionEffect, useLayoutEffect, useMemo, useState, } from "react";
5
+ import { cn } from "../lib/cn.js";
6
+ import { PortalContainerContext } from "../lib/portal-container.js";
7
+ import { encodeThemePreset, isThemeFile, themeFromPreset } from "../lib/theme-preset.js";
5
8
  import { DARK_QUERY, setThemeColor, THEME_STORAGE_KEY } from "../lib/theme-script.js";
6
9
  import { Button } from "./button.js";
7
10
  import { useMessages } from "./locale.js";
8
11
  const defaultMessages = { toggle: "Toggle light and dark theme" };
9
- export { createThemeScript, themeScript, PAGE_TONE, THEME_STORAGE_KEY } from "../lib/theme-script.js";
12
+ export { createThemeScript, themeScript, PAGE_TONE, THEME_STORAGE_KEY, } from "../lib/theme-script.js";
10
13
  const ThemeContext = createContext(null);
11
14
  const isMode = (v) => v === "light" || v === "dark" || v === "system";
12
15
  function readStored(key) {
@@ -34,6 +37,56 @@ function systemDark() {
34
37
  return false;
35
38
  }
36
39
  }
40
+ /** Codes already warned about, so a bad code says so once, not on every render. */
41
+ const warnedPresets = new Set();
42
+ /**
43
+ * A theme as a string that is the same for the same theme, so a preset object or a file made on
44
+ * every render applies its stylesheet once: a code as given, a preset as its code, a theme.json
45
+ * file as its JSON.
46
+ */
47
+ function presetKey(preset) {
48
+ if (!preset)
49
+ return undefined;
50
+ if (typeof preset === "string")
51
+ return preset || undefined;
52
+ if (isThemeFile(preset))
53
+ return JSON.stringify(preset);
54
+ return encodeThemePreset(preset);
55
+ }
56
+ /** The theme a key stands for: a theme.json file read back from its JSON, or a code. */
57
+ const fromKey = (key) => (key.startsWith("{") ? JSON.parse(key) : key);
58
+ /** Warns once, in development, that a theme can't be read. */
59
+ function warnPreset(who, key, error) {
60
+ if (process.env.NODE_ENV !== "production" && !warnedPresets.has(key)) {
61
+ warnedPresets.add(key);
62
+ console.warn(`${who}: the preset "${key}" can't be read (${error.message}), so zon's own theme is used.`);
63
+ }
64
+ }
65
+ /** A preset's page ground in light and dark, as hex for `<meta name="theme-color">`; undefined for zon's own. */
66
+ function presetTone(preset) {
67
+ if (!preset)
68
+ return undefined;
69
+ try {
70
+ const { light, dark } = themeFromPreset(fromKey(preset), { format: "hex" });
71
+ const ground = { light: light["--background"], dark: dark["--background"] };
72
+ return ground.light && ground.dark ? { light: ground.light, dark: ground.dark } : undefined;
73
+ }
74
+ catch {
75
+ return undefined;
76
+ }
77
+ }
78
+ /** The stylesheet for a preset code, or null for none or a code that can't be read. */
79
+ function presetCss(preset) {
80
+ if (!preset)
81
+ return null;
82
+ try {
83
+ return themeFromPreset(fromKey(preset)).css;
84
+ }
85
+ catch (error) {
86
+ warnPreset("ThemeProvider", preset, error);
87
+ return null;
88
+ }
89
+ }
37
90
  /**
38
91
  * ThemeProvider — light, dark or system theme for the whole document. It toggles `.dark` on
39
92
  * `<html>`, remembers the choice in localStorage and follows `prefers-color-scheme` while set
@@ -43,7 +96,7 @@ function systemDark() {
43
96
  * already correct. The rule people break: forgetting the script, which flashes light
44
97
  * before React hydrates.
45
98
  */
46
- export function ThemeProvider({ children, defaultTheme = "system", storageKey = THEME_STORAGE_KEY, themeColor = true, }) {
99
+ export function ThemeProvider({ children, defaultTheme = "system", storageKey = THEME_STORAGE_KEY, themeColor = true, preset, }) {
47
100
  const [theme, setThemeState] = useState(defaultTheme);
48
101
  const [prefersDark, setPrefersDark] = useState(false);
49
102
  const [mounted, setMounted] = useState(false);
@@ -75,26 +128,58 @@ export function ThemeProvider({ children, defaultTheme = "system", storageKey =
75
128
  };
76
129
  }, [storageKey, defaultTheme]);
77
130
  const resolvedTheme = theme === "system" ? (prefersDark ? "dark" : "light") : theme;
131
+ // The preset's stylesheet, last in <head> so it follows the library's own; and its ground, for
132
+ // the browser's bars in place of zon's page tone.
133
+ const code = presetKey(preset);
134
+ const css = useMemo(() => presetCss(code), [code]);
135
+ const tone = useMemo(() => presetTone(code), [code]);
78
136
  useEffect(() => {
79
137
  if (!mounted)
80
138
  return;
81
- document.documentElement.classList.toggle("dark", resolvedTheme === "dark");
139
+ applyDark(resolvedTheme === "dark");
82
140
  if (themeColor)
83
- setThemeColor(resolvedTheme === "dark");
84
- }, [mounted, resolvedTheme, themeColor]);
141
+ setThemeColor(resolvedTheme === "dark", tone);
142
+ }, [mounted, resolvedTheme, themeColor, tone]);
85
143
  const setTheme = useCallback((next) => {
86
144
  setThemeState(next);
87
145
  writeStored(storageKey, next);
88
146
  // Applied at once too: the effect above runs only when the resolved theme changes, and
89
147
  // something outside this provider may have changed the class since.
90
148
  const dark = next === "dark" || (next === "system" && systemDark());
91
- document.documentElement.classList.toggle("dark", dark);
149
+ applyDark(dark);
92
150
  if (themeColor)
93
- setThemeColor(dark);
94
- }, [storageKey, themeColor]);
151
+ setThemeColor(dark, tone);
152
+ }, [storageKey, themeColor, tone]);
153
+ useInsertionEffect(() => {
154
+ if (!css)
155
+ return;
156
+ const style = document.createElement("style");
157
+ style.setAttribute("data-zon-theme-preset", "");
158
+ style.textContent = css;
159
+ document.head.appendChild(style);
160
+ return () => style.remove();
161
+ }, [css]);
95
162
  const value = useMemo(() => ({ theme, resolvedTheme, setTheme }), [theme, resolvedTheme, setTheme]);
96
163
  return _jsx(ThemeContext.Provider, { value: value, children: children });
97
164
  }
165
+ /**
166
+ * Flip `.dark` on <html> in one frame. The page's colours change at once, but every material
167
+ * transitions its background and shadows over `--duration`, so for a moment half the page would
168
+ * show each theme. Transitions are off for the flip — a style read commits it — and come back on
169
+ * the next frame, before anything else moves.
170
+ */
171
+ function applyDark(dark) {
172
+ const root = document.documentElement;
173
+ if (root.classList.contains("dark") === dark)
174
+ return;
175
+ const style = document.createElement("style");
176
+ style.textContent = "*,*::before,*::after{transition:none!important}";
177
+ document.head.appendChild(style);
178
+ root.classList.toggle("dark", dark);
179
+ // Read a style so the browser applies the new theme while transitions are off.
180
+ void getComputedStyle(root).colorScheme;
181
+ requestAnimationFrame(() => style.remove());
182
+ }
98
183
  /** Read and change the theme. Must be used inside `ThemeProvider`. */
99
184
  export function useTheme() {
100
185
  const ctx = useContext(ThemeContext);
@@ -102,6 +187,77 @@ export function useTheme() {
102
187
  throw new Error("useTheme must be used within a <ThemeProvider>.");
103
188
  return ctx;
104
189
  }
190
+ /** A short, stable name for a text: FNV-1a, in base 36. */
191
+ function hash(text) {
192
+ let h = 0x811c9dc5;
193
+ for (let i = 0; i < text.length; i++)
194
+ h = Math.imul(h ^ text.charCodeAt(i), 0x01000193);
195
+ return (h >>> 0).toString(36);
196
+ }
197
+ /** The scope's name and stylesheet for a theme key, or null for none or one that can't be read. */
198
+ function scopeTheme(key) {
199
+ if (!key)
200
+ return null;
201
+ try {
202
+ const input = fromKey(key);
203
+ const theme = themeFromPreset(input);
204
+ // A code names its theme; a file may also hold values edited by hand, so its name adds them.
205
+ const scope = theme.code.toLowerCase() + (isThemeFile(input) ? `-${hash(theme.json)}` : "");
206
+ return { scope, css: themeFromPreset(input, { scope }).css };
207
+ }
208
+ catch (error) {
209
+ warnPreset("ThemeScope", key, error);
210
+ return null;
211
+ }
212
+ }
213
+ /**
214
+ * ThemeScope — one area of a page in a theme of its own: a preset's colours, density and corners,
215
+ * light or dark with the page or forced, on a `div` that takes the theme's ground and ink.
216
+ *
217
+ * Menus, popovers, selects, dialogs, drawers, tooltips and toasts opened from inside it portal
218
+ * into an element it keeps at the end of `<body>` with the same theme, so they match the area
219
+ * they came from. A popup of your own takes it from `usePortalContainer()`.
220
+ */
221
+ export function ThemeScope({ preset, scheme, className, children, ...props }) {
222
+ const key = presetKey(preset);
223
+ const theme = useMemo(() => scopeTheme(key), [key]);
224
+ const parent = useContext(PortalContainerContext);
225
+ const [host, setHost] = useState(null);
226
+ const schemeClass = scheme === "dark" ? "theme-dark" : scheme === "light" ? "theme-light" : undefined;
227
+ // The place popups opened in here portal to: at the end of <body> (or inside an outer scope's,
228
+ // so it takes that theme too), out of the area's overflow and stacking, but in its theme.
229
+ useLayoutEffect(() => {
230
+ if (parent === null)
231
+ return;
232
+ const el = document.createElement("div");
233
+ el.setAttribute("data-slot", "theme-scope-portal");
234
+ el.style.display = "contents";
235
+ (parent ?? document.body).appendChild(el);
236
+ setHost(el);
237
+ return () => {
238
+ el.remove();
239
+ setHost(null);
240
+ };
241
+ }, [parent]);
242
+ useLayoutEffect(() => {
243
+ if (!host)
244
+ return;
245
+ if (theme)
246
+ host.setAttribute("data-theme-scope", theme.scope);
247
+ else
248
+ host.removeAttribute("data-theme-scope");
249
+ host.className = schemeClass ?? "";
250
+ }, [host, theme, schemeClass]);
251
+ return (_jsxs(PortalContainerContext.Provider, { value: host, children: [theme && (_jsx("style", { href: `zon-theme-scope-${theme.scope}`, precedence: "zon-theme", children: theme.css })), _jsx("div", { "data-slot": "theme-scope", "data-theme-scope": theme?.scope, className: cn(schemeClass, "bg-background text-foreground", className), ...props, children: children })] }));
252
+ }
253
+ /**
254
+ * The element a popup of your own should portal to, so it takes the theme of the ThemeScope it
255
+ * opens in: `<Popover.Portal container={usePortalContainer()}>`. Undefined outside a scope (the
256
+ * default, `document.body`); null for the moment the scope is making it.
257
+ */
258
+ export function usePortalContainer() {
259
+ return useContext(PortalContainerContext);
260
+ }
105
261
  /**
106
262
  * ThemeToggle — a circular secondary icon button that switches between light and dark.
107
263
  * It shows the moon in light mode and the sun in dark mode; the icon is chosen by CSS, so it
@@ -109,10 +265,10 @@ export function useTheme() {
109
265
  *
110
266
  * The rule people break: placing two toggles on a page. One lives in the header.
111
267
  */
112
- export function ThemeToggle({ onClick, ...props }) {
268
+ export function ThemeToggle({ onClick, size = "default", ...props }) {
113
269
  const { setTheme } = useTheme();
114
270
  const text = useMessages("theme", defaultMessages);
115
- return (_jsxs(Button, { "data-slot": "theme-toggle", type: "button", variant: "secondary", size: "icon", "aria-label": text.toggle, ...props, onClick: (e) => {
271
+ return (_jsxs(Button, { "data-slot": "theme-toggle", type: "button", variant: "secondary", size: size === "sm" ? "icon-sm" : "icon", "aria-label": text.toggle, ...props, onClick: (e) => {
116
272
  onClick?.(e);
117
273
  // Read the applied class rather than state: it is correct even before hydration.
118
274
  setTheme(document.documentElement.classList.contains("dark") ? "light" : "dark");
@@ -1,7 +1,7 @@
1
1
  import * as React from "react";
2
2
  declare const groupSizes: {
3
- readonly sm: "min-h-(--control-h-sm) gap-2 pe-2.5 ps-2 text-[13px] [&>svg]:size-3.5";
4
- readonly default: "min-h-(--control-h) gap-3 pe-3 ps-3 text-base sm:text-[15px] [&>svg]:size-4";
3
+ readonly sm: "min-h-(--control-h-sm) gap-2 pe-2.5 ps-2 text-13 pointer-coarse:text-base [&>svg]:size-3.5";
4
+ readonly default: "min-h-(--control-h) gap-3 pe-3 ps-3 text-base sm:text-15 [&>svg]:size-4";
5
5
  };
6
6
  type SegmentType = "hour" | "minute" | "second" | "dayPeriod";
7
7
  export interface TimeFieldProps extends Omit<React.ComponentProps<"div">, "defaultValue" | "onChange" | "children" | "dir"> {
@@ -34,11 +34,6 @@ export interface TimeFieldProps extends Omit<React.ComponentProps<"div">, "defau
34
34
  readOnly?: boolean;
35
35
  /** The clock icon at the end of the field. */
36
36
  icon?: boolean;
37
- /**
38
- * Names for each segment, read out with the field's label.
39
- * @deprecated Use `labels`, which takes the same keys.
40
- */
41
- segmentLabels?: Partial<Record<SegmentType, string>>;
42
37
  /** Names for each segment and the empty one's value; a LocaleProvider sets them for every TimeField. */
43
38
  labels?: Partial<TimeFieldMessages>;
44
39
  /**
@@ -52,7 +47,7 @@ export interface TimeFieldMessages extends Record<SegmentType, string> {
52
47
  empty: string;
53
48
  }
54
49
  declare module "./locale" {
55
- interface Messages {
50
+ interface LocaleMessages {
56
51
  timeField: TimeFieldMessages;
57
52
  }
58
53
  }
@@ -60,11 +55,12 @@ declare module "./locale" {
60
55
  * TimeField — a time of day entered as segments, `14 : 30`, in a recessed field like `Input`:
61
56
  * mono, tabular digits, an AM/PM segment where the clock has 12 hours, and an optional clock icon.
62
57
  *
63
- * Each segment is a spinbutton: ↑ ↓ step it (wrapping, and rolling its digits like a NumberField),
58
+ * Each segment is a spinbutton: ↑ ↓ step it (wrapping, and rolling its digits like a NumberField;
59
+ * a held key counts in place rather than restarting the roll on every repeat),
64
60
  * typing fills it and moves on, Backspace clears it. The value is always a 24-hour `"HH:mm"`
65
61
  * string, whatever the display. Use it for a time on its own — opening hours, a reminder, a
66
62
  * departure — and beside a `DatePicker` for a date and time. The rule people break: a `Select`
67
63
  * of 96 quarter hours. Set `step={15}` instead, and let people type.
68
64
  */
69
- export declare function TimeField({ value: valueProp, defaultValue, onValueChange, size, hourCycle, locale: localeProp, seconds: secondsProp, step, min, max, name, required, disabled: disabledProp, readOnly, icon, segmentLabels, labels: labelsProp, id: idProp, className, onBlur, onMouseDown, onPaste, inputRef, ...props }: TimeFieldProps): React.JSX.Element;
65
+ export declare function TimeField({ value: valueProp, defaultValue, onValueChange, size, hourCycle, locale: localeProp, seconds: secondsProp, step, min, max, name, required, disabled: disabledProp, readOnly, icon, labels: labelsProp, id: idProp, className, onBlur, onMouseDown, onPaste, inputRef, ...props }: TimeFieldProps): React.JSX.Element;
70
66
  export {};
@@ -1,14 +1,15 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { Field as BaseField } from "@base-ui/react/field";
4
- import { ClockIcon } from "lucide-react";
4
+ import { ClockIcon } from "../lib/icons.js";
5
5
  import * as React from "react";
6
6
  import { cn } from "../lib/cn.js";
7
+ import { cssDuration } from "../lib/motion.js";
7
8
  import { DigitRoll, reducedMotion } from "../lib/digit-roll.js";
8
9
  import { useLocale, useMessages } from "./locale.js";
9
10
  const groupSizes = {
10
- sm: "min-h-(--control-h-sm) gap-2 pe-2.5 ps-2 text-[13px] [&>svg]:size-3.5",
11
- default: "min-h-(--control-h) gap-3 pe-3 ps-3 text-base sm:text-[15px] [&>svg]:size-4",
11
+ sm: "min-h-(--control-h-sm) gap-2 pe-2.5 ps-2 text-13 pointer-coarse:text-base [&>svg]:size-3.5",
12
+ default: "min-h-(--control-h) gap-3 pe-3 ps-3 text-base sm:text-15 [&>svg]:size-4",
12
13
  };
13
14
  const EMPTY = { hour: null, minute: null, second: null, period: null };
14
15
  const pad = (n) => String(n).padStart(2, "0");
@@ -93,13 +94,14 @@ function useClock(locale, hourCycle, seconds) {
93
94
  * TimeField — a time of day entered as segments, `14 : 30`, in a recessed field like `Input`:
94
95
  * mono, tabular digits, an AM/PM segment where the clock has 12 hours, and an optional clock icon.
95
96
  *
96
- * Each segment is a spinbutton: ↑ ↓ step it (wrapping, and rolling its digits like a NumberField),
97
+ * Each segment is a spinbutton: ↑ ↓ step it (wrapping, and rolling its digits like a NumberField;
98
+ * a held key counts in place rather than restarting the roll on every repeat),
97
99
  * typing fills it and moves on, Backspace clears it. The value is always a 24-hour `"HH:mm"`
98
100
  * string, whatever the display. Use it for a time on its own — opening hours, a reminder, a
99
101
  * departure — and beside a `DatePicker` for a date and time. The rule people break: a `Select`
100
102
  * of 96 quarter hours. Set `step={15}` instead, and let people type.
101
103
  */
102
- export function TimeField({ value: valueProp, defaultValue, onValueChange, size = "default", hourCycle, locale: localeProp, seconds: secondsProp, step = 1, min, max, name, required = false, disabled: disabledProp = false, readOnly = false, icon = true, segmentLabels, labels: labelsProp, id: idProp, className, onBlur, onMouseDown, onPaste, inputRef, ...props }) {
104
+ export function TimeField({ value: valueProp, defaultValue, onValueChange, size = "default", hourCycle, locale: localeProp, seconds: secondsProp, step = 1, min, max, name, required = false, disabled: disabledProp = false, readOnly = false, icon = true, labels: labelsProp, id: idProp, className, onBlur, onMouseDown, onPaste, inputRef, ...props }) {
103
105
  const providedLocale = useLocale();
104
106
  const locale = localeProp ?? providedLocale;
105
107
  const initial = valueProp !== undefined ? valueProp : defaultValue;
@@ -112,7 +114,7 @@ export function TimeField({ value: valueProp, defaultValue, onValueChange, size
112
114
  const clock = useClock(locale ?? (hydrated ? undefined : "en-US"), hourCycle, seconds);
113
115
  const { h12 } = clock;
114
116
  const messages = useMessages("timeField", defaultMessages, labelsProp);
115
- const labels = { ...messages, ...segmentLabels };
117
+ const labels = messages;
116
118
  const generatedId = React.useId();
117
119
  const id = idProp ?? generatedId;
118
120
  const [segs, setSegs] = React.useState(() => parse(initial, h12));
@@ -155,6 +157,7 @@ export function TimeField({ value: valueProp, defaultValue, onValueChange, size
155
157
  };
156
158
  /* The digit roll: a step remembers the segment's text before and after, and which way it went. */
157
159
  const [rolls, setRolls] = React.useState({});
160
+ const lastStep = React.useRef(-Infinity);
158
161
  const endRoll = React.useMemo(() => {
159
162
  const end = (type) => () => setRolls((r) => ({ ...r, [type]: undefined }));
160
163
  return { hour: end("hour"), minute: end("minute"), second: end("second"), dayPeriod: end("dayPeriod") };
@@ -183,8 +186,15 @@ export function TimeField({ value: valueProp, defaultValue, onValueChange, size
183
186
  }
184
187
  const from = rolls[type]?.to ?? display(type, s);
185
188
  const to = display(type, next);
186
- if (from !== to && !from.includes("–") && !reducedMotion())
187
- setRolls((r) => ({ ...r, [type]: { from, to, dir, key: performance.now() } }));
189
+ // A held key repeats faster than a roll lasts, and a roll that restarts on every repeat never
190
+ // lands: a step that close to the last one shows its value in place, and the running roll gives way.
191
+ const now = performance.now();
192
+ const repeat = now - lastStep.current < cssDuration();
193
+ lastStep.current = now;
194
+ if (repeat)
195
+ setRolls((r) => ({ ...r, [type]: undefined }));
196
+ else if (from !== to && !from.includes("–") && !reducedMotion())
197
+ setRolls((r) => ({ ...r, [type]: { from, to, dir, key: now } }));
188
198
  update(next);
189
199
  };
190
200
  const setSegment = (type, n) => {
@@ -442,7 +452,7 @@ export function TimeField({ value: valueProp, defaultValue, onValueChange, size
442
452
  : String(n), onKeyDown: handleKeyDown(type), onFocus: () => (typed.current = ""), className: cn(
443
453
  // Focused, outline-hidden rather than none: a contrast theme drops the fill
444
454
  // that marks the focused segment, and shows this outline instead.
445
- "rounded-checkbox px-0.5 whitespace-nowrap caret-transparent outline-none focus:outline-hidden", "transition-[background-color,color] duration-(--duration) ease-(--ease) selection:bg-transparent", "focus:bg-control-hover focus:text-foreground", "data-placeholder:text-control-muted focus:data-placeholder:text-muted-foreground",
455
+ "rounded-checkbox px-0.5 whitespace-nowrap caret-transparent outline-none focus:outline-hidden", "transition-[background-color,color] duration-(--duration-fade) ease-(--ease) selection:bg-transparent", "focus:bg-control-hover focus:text-foreground", "data-placeholder:text-control-muted focus:data-placeholder:text-muted-foreground",
446
456
  // While the digits roll, the overlay draws them.
447
457
  roll && "text-transparent focus:text-transparent"), children: text }), roll && (_jsx(DigitRoll, { roll: roll, slot: "time-field-roll", onDone: endRoll[type] }, roll.key))] })] }, type));
448
458
  }) }), icon && _jsx(ClockIcon, { "aria-hidden": true }), _jsx("input", { ref: ref, name: controlName, value: controlValue ?? "", onChange: fieldChange, required: required, disabled: off, readOnly: readOnly, "aria-hidden": true, tabIndex: -1, autoComplete: "off", onFocus: focusFirstEmpty, className: "sr-only" })] }));
@@ -5,9 +5,13 @@ export interface TimelineMessages {
5
5
  from: string;
6
6
  /** Read between the old value and the new one. */
7
7
  to: string;
8
+ /** Read for the placeholder entries while a Timeline is `loading`. */
9
+ loading: string;
10
+ /** Shown by a Timeline with no entries and no `emptyMessage`. */
11
+ empty: string;
8
12
  }
9
13
  declare module "./locale" {
10
- interface Messages {
14
+ interface LocaleMessages {
11
15
  timeline: TimelineMessages;
12
16
  }
13
17
  }
@@ -19,6 +23,18 @@ export interface TimelineProps extends React.ComponentProps<"ol"> {
19
23
  * title in Licht, the body in reading type and 40px between entries.
20
24
  */
21
25
  variant?: TimelineVariant;
26
+ /**
27
+ * Entries are on their way: three placeholder entries follow whatever is already there (the
28
+ * first load, or older entries loading below), and the list is `aria-busy`.
29
+ */
30
+ loading?: boolean;
31
+ /**
32
+ * Shown, on the line, when there are no entries and nothing is loading. Say what will appear
33
+ * and when: "Changes to this deal show here." Default `labels.empty`.
34
+ */
35
+ emptyMessage?: React.ReactNode;
36
+ /** The timeline's own words (`loading`, `empty`); a LocaleProvider sets them for every Timeline. */
37
+ labels?: Partial<TimelineMessages>;
22
38
  }
23
39
  /**
24
40
  * Timeline — what happened, in order, on a hairline: an activity feed, a deal's history, a
@@ -29,7 +45,7 @@ export interface TimelineProps extends React.ComponentProps<"ol"> {
29
45
  * The rule people break: colouring every dot. Markers are monochrome; a status colour marks the
30
46
  * entries that are a status (a failed deploy, a won deal), and the entry's text says so too.
31
47
  */
32
- export declare function Timeline({ variant, className, ...props }: TimelineProps): React.JSX.Element;
48
+ export declare function Timeline({ variant, loading, emptyMessage, labels, className, children, ...props }: TimelineProps): React.JSX.Element;
33
49
  declare const dotStatus: {
34
50
  readonly default: "bg-muted-foreground";
35
51
  readonly success: "bg-success";
@@ -82,7 +98,7 @@ export interface TimelineChangeProps extends Omit<React.ComponentProps<"p">, "ch
82
98
  field: React.ReactNode;
83
99
  /** The old value. A string becomes a muted `Tag`; pass your own element to colour it. */
84
100
  from?: React.ReactNode;
85
- /** The new value. A string becomes a `Tag`; pass `<Tag variant="success">Won</Tag>` for a status. */
101
+ /** The new value. A string becomes a `Tag`; pass `<Tag tone="success">Won</Tag>` for a status. */
86
102
  to: React.ReactNode;
87
103
  /** What screen readers hear around the values; a LocaleProvider sets it for every TimelineChange. */
88
104
  labels?: Partial<TimelineMessages>;
@@ -1,13 +1,21 @@
1
1
  "use client";
2
2
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { useRender } from "@base-ui/react/use-render";
4
- import { ArrowRightIcon } from "lucide-react";
4
+ import { ArrowRightIcon } from "../lib/icons.js";
5
5
  import * as React from "react";
6
6
  import { cn } from "../lib/cn.js";
7
7
  import { useMessages } from "./locale.js";
8
+ import { Skeleton } from "./skeleton.js";
8
9
  import { Tag } from "./tag.js";
9
- const defaultMessages = { from: "from", to: "to" };
10
+ const defaultMessages = {
11
+ from: "from",
12
+ to: "to",
13
+ loading: "Loading",
14
+ empty: "Nothing has happened yet.",
15
+ };
10
16
  const TimelineContext = React.createContext("activity");
17
+ /** Title widths for the placeholders, so they don't read as one block. */
18
+ const placeholderWidths = ["w-3/4", "w-1/2", "w-2/3"];
11
19
  /**
12
20
  * Timeline — what happened, in order, on a hairline: an activity feed, a deal's history, a
13
21
  * changelog, a project's milestones. Each entry is a dot (or a 24px icon key) on the line, a line
@@ -17,12 +25,16 @@ const TimelineContext = React.createContext("activity");
17
25
  * The rule people break: colouring every dot. Markers are monochrome; a status colour marks the
18
26
  * entries that are a status (a failed deploy, a won deal), and the entry's text says so too.
19
27
  */
20
- export function Timeline({ variant = "activity", className, ...props }) {
28
+ export function Timeline({ variant = "activity", loading = false, emptyMessage, labels, className, children, ...props }) {
29
+ const text = useMessages("timeline", defaultMessages, labels);
30
+ const count = React.Children.toArray(children).length;
21
31
  // A long feed lays out and paints only the entries near the view; they stay in the page, for
22
32
  // find-in-page and screen readers. Each entry draws its own line, so nothing crosses between them.
23
- const long = React.Children.count(props.children) > LONG_FROM;
24
- return (_jsx(TimelineContext.Provider, { value: variant, children: _jsx("ol", { "data-slot": "timeline", "data-variant": variant, "data-long": long ? "" : undefined, className: cn("m-0 flex w-full list-none flex-col p-0 font-body", long &&
25
- "[&>li]:[contain-intrinsic-size:auto_4rem] [&>li]:[content-visibility:auto] [&>li]:[overflow-clip-margin:12px]", className), ...props }) }));
33
+ const long = count > LONG_FROM;
34
+ const empty = count === 0 && !loading;
35
+ return (_jsx(TimelineContext.Provider, { value: variant, children: _jsxs("ol", { "data-slot": "timeline", "data-variant": variant, "data-long": long ? "" : undefined, "data-empty": empty ? "" : undefined, "aria-busy": loading || undefined, className: cn("m-0 flex w-full list-none flex-col p-0 font-body", long &&
36
+ "[&>li]:[contain-intrinsic-size:auto_4rem] [&>li]:[content-visibility:auto] [&>li]:[overflow-clip-margin:12px]", className), ...props, children: [children, loading &&
37
+ placeholderWidths.map((width, index) => (_jsxs(TimelineItem, { "data-placeholder": "", "aria-hidden": index > 0 || undefined, className: "[&>[data-slot=timeline-marker]>span]:bg-control-surface", children: [_jsx(Skeleton, { className: cn("col-start-1 row-start-1 text-sm leading-6", width) }), _jsx(Skeleton, { className: "col-start-2 row-start-1 w-12 text-xs leading-6" }), index === 0 && _jsx("span", { className: "sr-only", children: text.loading })] }, index))), empty && (_jsxs("li", { "data-slot": "timeline-empty", className: "grid grid-cols-[1.5rem_minmax(0,1fr)] gap-x-3 text-sm leading-6 text-muted-foreground", children: [_jsx("span", { "aria-hidden": true, className: "flex h-6 items-center justify-center", children: _jsx("span", { className: "size-2 rounded-full border border-muted-foreground" }) }), _jsx("span", { children: emptyMessage ?? text.empty })] }))] }) }));
26
38
  }
27
39
  /** Timelines of more entries than this skip laying out those out of view. */
28
40
  const LONG_FROM = 100;
@@ -70,7 +82,7 @@ export function TimelineTitle({ render, ref, className, ...props }) {
70
82
  // A long word or link wraps in its column instead of running under the time.
71
83
  "m-0 min-w-0 break-words", variant === "activity"
72
84
  ? "col-start-1 row-start-1 text-sm leading-6 text-foreground-soft [&_strong]:font-medium [&_strong]:text-foreground"
73
- : "col-span-2 row-start-2 mt-1 display text-[22px] leading-[1.2] text-foreground sm:text-[24px]", className),
85
+ : "col-span-2 row-start-2 mt-1 display text-22 leading-[1.2] text-foreground sm:text-24", className),
74
86
  },
75
87
  });
76
88
  }
@@ -90,7 +102,7 @@ export function TimelineContent({ className, ...props }) {
90
102
  const variant = React.useContext(TimelineContext);
91
103
  return (_jsx("div", { "data-slot": "timeline-content", className: cn("col-span-2 flex min-w-0 flex-col break-words", variant === "activity"
92
104
  ? "gap-2 pt-1.5 text-sm text-foreground-soft"
93
- : "max-w-[68ch] gap-3 pt-3 text-[15px] leading-relaxed text-foreground-soft", className), ...props }));
105
+ : "max-w-[68ch] gap-3 pt-3 text-15 leading-relaxed text-foreground-soft", className), ...props }));
94
106
  }
95
107
  /**
96
108
  * A comment someone left, as a small 20px card under the entry — it could be quoted or moved on
@@ -104,5 +116,5 @@ export function TimelineChange({ field, from, to, labels, className, ...props })
104
116
  const text = useMessages("timeline", defaultMessages, labels);
105
117
  // A value longer than the line ends in an ellipsis inside its tag; the full text is still read.
106
118
  const tag = (value, variant) => typeof value === "string" || typeof value === "number" ? (_jsx(Tag, { variant: variant, className: "max-w-full shrink", children: _jsx("span", { className: "min-w-0 truncate leading-normal", children: value }) })) : (value);
107
- return (_jsxs("p", { "data-slot": "timeline-change", className: cn("m-0 flex flex-wrap items-center gap-x-2 gap-y-1 text-[13px] text-muted-foreground", className), ...props, children: [_jsx("span", { children: field }), from != null && (_jsxs(_Fragment, { children: [_jsx("span", { className: "sr-only", children: text.from }), tag(from, "muted"), _jsx(ArrowRightIcon, { "aria-hidden": true, className: "size-3.5 shrink-0 rtl:-scale-x-100" }), _jsx("span", { className: "sr-only", children: text.to })] })), tag(to, "default")] }));
119
+ return (_jsxs("p", { "data-slot": "timeline-change", className: cn("m-0 flex flex-wrap items-center gap-x-2 gap-y-1 text-13 text-muted-foreground", className), ...props, children: [_jsx("span", { children: field }), from != null && (_jsxs(_Fragment, { children: [_jsx("span", { className: "sr-only", children: text.from }), tag(from, "muted"), _jsx(ArrowRightIcon, { "aria-hidden": true, className: "size-3.5 shrink-0 rtl:-scale-x-100" }), _jsx("span", { className: "sr-only", children: text.to })] })), tag(to, "default")] }));
108
120
  }
@@ -18,6 +18,22 @@ export interface TippyProps extends Omit<React.ComponentProps<"canvas">, "childr
18
18
  label?: string;
19
19
  /** Hold the current frame. */
20
20
  paused?: boolean;
21
+ /**
22
+ * A point on the page to look at, in client pixels (as `getBoundingClientRect` gives them): the
23
+ * caret in a field being typed in, a button. Its eyes turn to it and its weight follows. `null`
24
+ * or left out, it looks where it likes — or at the pointer, with `followPointer`.
25
+ */
26
+ lookAt?: {
27
+ x: number;
28
+ y: number;
29
+ } | null;
30
+ /** Keep its eyes on the pointer, wherever it is on the page, when `lookAt` gives it nothing. */
31
+ followPointer?: boolean;
32
+ /**
33
+ * A count of the keys pressed in what it is watching: each change is taken with a little bob,
34
+ * its mouth an o while the keys go. For `watch`.
35
+ */
36
+ keystrokes?: number;
21
37
  }
22
38
  /**
23
39
  * Tippy — zon.sh's mascot, the mark turned over and standing on its horns, as a 64-pixel sprite on
@@ -29,7 +45,7 @@ export interface TippyProps extends Omit<React.ComponentProps<"canvas">, "childr
29
45
  * The rule people break: Tippy as decoration on every screen. Bring it in where a person is being
30
46
  * shown around or something has happened to them — a tour, an empty state, a finished task.
31
47
  */
32
- export declare function Tippy({ move, facing, scale, label, paused, className, style, ...props }: TippyProps): React.JSX.Element;
48
+ export declare function Tippy({ move, facing, scale, label, paused, lookAt, followPointer, keystrokes, className, style, ...props }: TippyProps): React.JSX.Element;
33
49
  export interface TippyGuideProps extends TourGuideState {
34
50
  /** CSS pixels to a sprite pixel, snapped to whole device pixels. Defaults to `2`. */
35
51
  scale?: number;