@zonsh/ui 0.4.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (562) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +7 -7
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. package/package.json +69 -2
@@ -0,0 +1,344 @@
1
+ # Swipe Actions
2
+
3
+ ```tsx
4
+ import { Item, ItemContent, ItemDescription, ItemTitle, SwipeActions } from "@zonsh/ui";
5
+ import { ArchiveIcon, CheckIcon, MailIcon, Trash2Icon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ /** A phone-sized screen for the demos: 390px wide, its list scrolling inside. */
9
+ function Phone({ label, children }: { label: string; children: React.ReactNode }) {
10
+ return (
11
+ <div className="relative mx-auto h-[600px] w-full max-w-[390px] overflow-hidden border border-field-edge">
12
+ <div
13
+ role="region"
14
+ aria-label={label}
15
+ tabIndex={0}
16
+ data-slot="demo-phone-screen"
17
+ className="h-full overflow-y-auto pt-6 focus-ring"
18
+ >
19
+ {children}
20
+ </div>
21
+ </div>
22
+ );
23
+ }
24
+
25
+ const messages = [
26
+ { id: "m1", from: "Ines Moreau", subject: "Kiln booking for Saturday", time: "09:41" },
27
+ { id: "m2", from: "Theo Lindqvist", subject: "Notes from the reading group", time: "08:15" },
28
+ { id: "m3", from: "Allotment society", subject: "Water is back on at the east gate", time: "Yesterday" },
29
+ { id: "m4", from: "Jun Park", subject: "Photos from the coast walk", time: "Yesterday" },
30
+ { id: "m5", from: "Library", subject: "Two books are due on Friday", time: "Mon" },
31
+ { id: "m6", from: "Ana Ribeiro", subject: "Porto — train times", time: "Sun" },
32
+ ];
33
+
34
+ export function Basic() {
35
+ const [rows, setRows] = React.useState(messages);
36
+ const [unread, setUnread] = React.useState<Set<string>>(() => new Set(["m1", "m2"]));
37
+ const [status, setStatus] = React.useState("");
38
+ const remove = (id: string, verb: string) => {
39
+ const row = rows.find((r) => r.id === id);
40
+ setRows((list) => list.filter((r) => r.id !== id));
41
+ setStatus(`${verb}: ${row?.subject}`);
42
+ };
43
+ const toggleUnread = (id: string) =>
44
+ setUnread((set) => {
45
+ const next = new Set(set);
46
+ if (next.has(id)) next.delete(id);
47
+ else next.add(id);
48
+ return next;
49
+ });
50
+ return (
51
+ <Phone label="Mail screen">
52
+ <ul aria-label="Inbox">
53
+ {rows.map((m) => (
54
+ <li key={m.id} className="border-b border-border/60">
55
+ <SwipeActions
56
+ label={m.subject}
57
+ leading={[
58
+ {
59
+ label: unread.has(m.id) ? "Read" : "Unread",
60
+ icon: unread.has(m.id) ? <CheckIcon /> : <MailIcon />,
61
+ tone: "info",
62
+ onSelect: () => toggleUnread(m.id),
63
+ },
64
+ ]}
65
+ trailing={[
66
+ { label: "Archive", icon: <ArchiveIcon />, onSelect: () => remove(m.id, "Archived") },
67
+ {
68
+ label: "Delete",
69
+ icon: <Trash2Icon />,
70
+ tone: "destructive",
71
+ onSelect: () => remove(m.id, "Deleted"),
72
+ },
73
+ ]}
74
+ >
75
+ <Item render={<a href={`#${m.id}`} />} className="rounded-none">
76
+ <ItemContent>
77
+ <ItemTitle className="flex w-full items-baseline gap-2">
78
+ {unread.has(m.id) && (
79
+ <span className="size-2 shrink-0 self-center rounded-full bg-info">
80
+ <span className="sr-only">Unread</span>
81
+ </span>
82
+ )}
83
+ <span className="min-w-0 flex-1 truncate">{m.from}</span>
84
+ <span className="shrink-0 font-mono text-11 font-normal text-muted-foreground">
85
+ {m.time}
86
+ </span>
87
+ </ItemTitle>
88
+ <ItemDescription className="truncate">{m.subject}</ItemDescription>
89
+ </ItemContent>
90
+ </Item>
91
+ </SwipeActions>
92
+ </li>
93
+ ))}
94
+ </ul>
95
+ <p className="px-4 pt-4 text-13 text-muted-foreground" aria-live="polite">
96
+ {rows.length === 0 ? "Inbox zero." : status}
97
+ </p>
98
+ </Phone>
99
+ );
100
+ }
101
+ ```
102
+
103
+ A row of a list — an `Item`, a link, a mail — that slides aside under the finger to uncover its actions. Swipe it a little and let go to keep them open; on a side with a single action, swipe on through more than 60% of the row and that action takes the whole strip and runs when you let go; let go short and the row springs back over 300ms. A flick is enough either way. Opening one row shuts the last; scrolling the list or tapping elsewhere shuts it too.
104
+
105
+ **A full swipe runs an action only on a side with one.** With two or more on a side — Archive and Delete — no action is the obvious one to run, and a long swipe meant to show Archive must never delete: swiping on through, however far, only opens the row to show the tiles, rubber-banding past them, and you tap the one you want.
106
+
107
+ Each action is a tile as tall as the row, an icon over a short label in Licht Sans. They stay monochrome but for meaning: `destructive` Delete in the destructive ink on a 15% tint, the status tones for what they mean (an `info` Unread, a `success` Done).
108
+
109
+ **It never fights a scroll.** The row only answers a press that has moved 8px and more sideways than up or down; anything steeper is the list's scroll, which the browser keeps (`touch-action: pan-y`). Touch and pen swipe; a mouse keeps selecting text and uses the menu button.
110
+
111
+ ## When to use
112
+
113
+ - Lists people triage with a thumb: mail, notifications, tasks, a basket — one or two actions a side, the one done most often outermost.
114
+ - One action on a side when a full swipe should run it (Done, Read). Two or three open the row and wait for a tap; more, or actions that need a look first, belong in an `ActionSheet` from the row, or the row's own screen.
115
+ - A table on a desktop: row actions in a `Menu` at the row's end (here `menu="always"`).
116
+
117
+ ## Usage
118
+
119
+ ```tsx
120
+ import { Item, ItemContent, ItemTitle, SwipeActions } from "@zonsh/ui";
121
+ import { ArchiveIcon, Trash2Icon } from "lucide-react";
122
+
123
+ <SwipeActions
124
+ label={mail.subject}
125
+ trailing={[
126
+ { label: "Archive", icon: <ArchiveIcon />, onSelect: () => archive(mail.id) },
127
+ { label: "Delete", icon: <Trash2Icon />, tone: "destructive", onSelect: () => remove(mail.id) },
128
+ ]}
129
+ >
130
+ <Item render={<a href={`/mail/${mail.id}`} />}>…</Item>
131
+ </SwipeActions>;
132
+ ```
133
+
134
+ `trailing` sits at the line's end, its last action outermost. `leading` sits at the start, its first action outermost. Here the single leading action runs from a full swipe; the two trailing ones only open. Right to left the sides follow the reading direction: trailing actions are on the left, revealed by a swipe to the right.
135
+
136
+ ## Examples
137
+
138
+ ### Always a menu
139
+
140
+ `menu="always"` keeps the menu button beside the row for a mouse: a list that is used on a desktop too. On a phone the swipe is the shortcut and the button the way everyone can see.
141
+
142
+ ```tsx
143
+ import { Item, ItemContent, ItemDescription, ItemTitle, SwipeActions } from "@zonsh/ui";
144
+ import { CheckIcon, PinIcon } from "lucide-react";
145
+ import * as React from "react";
146
+
147
+ const tasks = [
148
+ { id: "t1", title: "Glaze the test tiles", meta: "Studio · due Thursday" },
149
+ { id: "t2", title: "Order more clay", meta: "Supplies · 2 bags of stoneware" },
150
+ { id: "t3", title: "Photograph the mugs for the shop", meta: "Shop · before the market" },
151
+ ];
152
+
153
+ export function MenuButton() {
154
+ const [rows, setRows] = React.useState(tasks);
155
+ const [pinned, setPinned] = React.useState<string | null>(null);
156
+ return (
157
+ <ul aria-label="Tasks" className="mx-auto w-full max-w-md">
158
+ {rows.map((t) => (
159
+ <li key={t.id} className="border-b border-border/60 first:border-t">
160
+ <SwipeActions
161
+ menu="always"
162
+ label={t.title}
163
+ leading={[
164
+ {
165
+ label: pinned === t.id ? "Unpin" : "Pin",
166
+ icon: <PinIcon />,
167
+ onSelect: () => setPinned((p) => (p === t.id ? null : t.id)),
168
+ },
169
+ ]}
170
+ trailing={[
171
+ {
172
+ label: "Done",
173
+ icon: <CheckIcon />,
174
+ tone: "success",
175
+ onSelect: () => setRows((list) => list.filter((r) => r.id !== t.id)),
176
+ },
177
+ ]}
178
+ >
179
+ <Item size="sm" className="rounded-none">
180
+ <ItemContent>
181
+ <ItemTitle>
182
+ {pinned === t.id && (
183
+ <>
184
+ <PinIcon aria-hidden className="size-3.5 text-muted-foreground" />
185
+ <span className="sr-only">Pinned:</span>
186
+ </>
187
+ )}
188
+ {t.title}
189
+ </ItemTitle>
190
+ <ItemDescription>{t.meta}</ItemDescription>
191
+ </ItemContent>
192
+ </Item>
193
+ </SwipeActions>
194
+ </li>
195
+ ))}
196
+ </ul>
197
+ );
198
+ }
199
+ ```
200
+
201
+ ### Three actions on a side
202
+
203
+ With three trailing actions the row only opens, as with two: swipe as far as you like, let go and
204
+ the tiles stay on screen for a tap. The single leading action still runs from a full swipe.
205
+
206
+ ```tsx
207
+ import { Item, ItemContent, ItemDescription, ItemTitle, SwipeActions } from "@zonsh/ui";
208
+ import { ArchiveIcon, CheckIcon, FlagIcon, Trash2Icon } from "lucide-react";
209
+ import * as React from "react";
210
+
211
+ // Phone: as in the first example on this page that uses them.
212
+
213
+ const alerts = [
214
+ { id: "a1", title: "Kiln reached 1240 °C", meta: "Studio · 2 min ago" },
215
+ { id: "a2", title: "Ines shared “Glaze tests”", meta: "Shared · 1 h ago" },
216
+ { id: "a3", title: "Market stall confirmed", meta: "Events · Yesterday" },
217
+ { id: "a4", title: "Clay order shipped", meta: "Supplies · Mon" },
218
+ ];
219
+
220
+ /** Three trailing actions: a swipe opens the row and waits for a tap; it never runs one by itself. */
221
+ export function ManyActions() {
222
+ const [rows, setRows] = React.useState(alerts);
223
+ const [flagged, setFlagged] = React.useState<Set<string>>(() => new Set());
224
+ const [status, setStatus] = React.useState("");
225
+ const remove = (id: string, verb: string) => {
226
+ const row = rows.find((r) => r.id === id);
227
+ setRows((list) => list.filter((r) => r.id !== id));
228
+ setStatus(`${verb}: ${row?.title}`);
229
+ };
230
+ return (
231
+ <Phone label="Notifications screen">
232
+ <ul aria-label="Notifications">
233
+ {rows.map((a) => (
234
+ <li key={a.id} className="border-b border-border/60">
235
+ <SwipeActions
236
+ label={a.title}
237
+ leading={[
238
+ { label: "Done", icon: <CheckIcon />, tone: "success", onSelect: () => remove(a.id, "Done") },
239
+ ]}
240
+ trailing={[
241
+ {
242
+ label: flagged.has(a.id) ? "Unflag" : "Flag",
243
+ icon: <FlagIcon />,
244
+ tone: "warning",
245
+ onSelect: () =>
246
+ setFlagged((set) => {
247
+ const next = new Set(set);
248
+ if (next.has(a.id)) next.delete(a.id);
249
+ else next.add(a.id);
250
+ return next;
251
+ }),
252
+ },
253
+ { label: "Archive", icon: <ArchiveIcon />, onSelect: () => remove(a.id, "Archived") },
254
+ {
255
+ label: "Delete",
256
+ icon: <Trash2Icon />,
257
+ tone: "destructive",
258
+ onSelect: () => remove(a.id, "Deleted"),
259
+ },
260
+ ]}
261
+ >
262
+ <Item className="rounded-none">
263
+ <ItemContent>
264
+ <ItemTitle className="flex w-full items-center gap-2">
265
+ {flagged.has(a.id) && (
266
+ <FlagIcon aria-label="Flagged" className="size-3.5 shrink-0 text-warning" />
267
+ )}
268
+ <span className="min-w-0 flex-1 truncate">{a.title}</span>
269
+ </ItemTitle>
270
+ <ItemDescription className="truncate">{a.meta}</ItemDescription>
271
+ </ItemContent>
272
+ </Item>
273
+ </SwipeActions>
274
+ </li>
275
+ ))}
276
+ </ul>
277
+ <p className="px-4 pt-4 text-13 text-muted-foreground" aria-live="polite">
278
+ {rows.length === 0 ? "All caught up." : status}
279
+ </p>
280
+ </Phone>
281
+ );
282
+ }
283
+ ```
284
+
285
+ ## Props
286
+
287
+ | Prop | Type | Default | Notes |
288
+ | -------------- | ------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
289
+ | `children` | `ReactNode` | — | The row: an `Item`, a link, a list entry. |
290
+ | `leading` | `SwipeAction[]` | — | At the line's start, revealed by a swipe towards its end. The first is outermost. |
291
+ | `trailing` | `SwipeAction[]` | — | At the line's end. The last is outermost. |
292
+ | `fullSwipe` | `boolean \| "leading" \| "trailing"` | `true` | A swipe through 60% of the row runs that side's action. Only on a side with a single action; with two or more the swipe only opens the row. |
293
+ | `menu` | `"auto" \| "always" \| false` | `"auto"` | The menu button with every action: shown on focus and hover (`auto`), always, or not at all. |
294
+ | `label` | `string` | — | What the row is: the menu button reads "Actions for {label}". |
295
+ | `disabled` | `boolean` | `false` | No swipe and no menu. |
296
+ | `onOpenChange` | `(side: "leading" \| "trailing" \| null) => void` | — | Called as the row opens on a side or shuts. |
297
+ | `labels` | `Partial<SwipeActionsMessages>` | — | `menu(label?)` and `revealed(actions)`, what is read when a swipe opens the row. |
298
+ | `ref` | `Ref<HTMLDivElement>` | — | The root. |
299
+
300
+ Every other prop goes to the root `<div>`.
301
+
302
+ ### SwipeAction
303
+
304
+ | Field | Type | Notes |
305
+ | ---------- | ---------------------------------------------------------------- | ------------------------------------------------- |
306
+ | `label` | `string` | One short word, under the icon and in the menu. |
307
+ | `icon` | `ReactNode` | A lucide icon. |
308
+ | `onSelect` | `() => void` | Runs it, from the tile, a full swipe or the menu. |
309
+ | `tone` | `"default" \| "destructive" \| "info" \| "success" \| "warning"` | The ink and tint, for what the action means. |
310
+
311
+ ## Motion
312
+
313
+ - While the finger holds it the row follows 1:1, with no transition, and rubber-bands against a side with no actions and past what a side can reach.
314
+ - Let go, it settles over 2 × `--duration` (300ms) on `--ease`, and so does the strip of actions. Under reduced motion it jumps to where it rests.
315
+ - Crossing into a full swipe gives a haptic tick where the device has one, and the tile takes the whole strip. A side of two or more never crosses into one.
316
+ - Pressed, a row and a tile darken at once, in 90ms, and give a little: a row to 98.5%, a tile to 97%. Let go, they ease back. A press that moves (a scroll, a swipe) lets go of the shade at once. Under reduced motion only the shade shows.
317
+
318
+ ## Brand rules
319
+
320
+ - **Do** put the action people take most often outermost, and Delete at the trailing end.
321
+ - **Do** keep each label one word, with an icon people know.
322
+ - **Don't** colour a tile for decoration: monochrome, or the tone the action means.
323
+ - **Don't** hide an action in the swipe alone: the menu, or the row's own screen, must offer it too.
324
+
325
+ ## Accessibility
326
+
327
+ - The swipe is a shortcut. Every action is also in a menu button at the row's end, named "Actions for {label}": in the reading order always, drawn when it is focused or the row is hovered (`menu="auto"`), or always drawn (`menu="always"`).
328
+ - The tiles stay out of the reading order and the accessibility tree until a swipe opens them; then they are buttons, Tab reaches them, and "Actions shown: Archive, Delete" is read. A full swipe on a side of one reads the action it ran.
329
+ - Escape shuts an open row; a tap on the open row shuts it without following its link.
330
+ - Right to left the sides swap with the reading direction, and the swipe mirrors.
331
+
332
+ ### Keyboard
333
+
334
+ | Key | What it does |
335
+ | --------------- | ----------------------------------------------------------- |
336
+ | Tab | Moves from the row to its menu button, which shows on focus |
337
+ | Enter / Space | On the menu button, opens the actions |
338
+ | Arrow Down / Up | In the menu, moves between the actions |
339
+ | Escape | Closes the menu, or shuts a row a swipe has opened |
340
+
341
+ ---
342
+
343
+ - Import: `import { SwipeActions } from "@zonsh/ui"`
344
+ - Source: `packages/ui/src/components/swipe-actions.tsx`
@@ -0,0 +1,160 @@
1
+ # Switch
2
+
3
+ ```tsx
4
+ import { Field, FieldLabel, Switch } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field>
9
+ <FieldLabel>
10
+ <Switch defaultChecked />
11
+ Email me when a deployment finishes
12
+ </FieldLabel>
13
+ </Field>
14
+ );
15
+ }
16
+ ```
17
+
18
+ A recessed 38 × 22px track, a raised 18px thumb; on, the track takes `--primary`. A press stretches the thumb to 25px.
19
+
20
+ ## Usage
21
+
22
+ ```tsx
23
+ import { Field, FieldLabel, Switch } from "@zonsh/ui";
24
+
25
+ <Field>
26
+ <FieldLabel>
27
+ <Switch defaultChecked />
28
+ Email me when a deployment finishes
29
+ </FieldLabel>
30
+ </Field>;
31
+ ```
32
+
33
+ - `checked` / `onCheckedChange` — control it.
34
+ - `disabled` — blocks changes.
35
+ - `nativeButton` — with `render={<button type="button" />}`, for a label beside it.
36
+
37
+ ## When to use
38
+
39
+ - Settings that apply at once. In a form with a submit button, use a `Checkbox`.
40
+
41
+ ## Examples
42
+
43
+ ### Settings list
44
+
45
+ With the label beside the switch, render it as a native button so the label still works.
46
+
47
+ ```tsx
48
+ import { Field, FieldDescription, FieldLabel, Switch } from "@zonsh/ui";
49
+
50
+ const settings = [
51
+ {
52
+ label: "Deployment emails",
53
+ description: "One message when a release goes live, with a link to the change log.",
54
+ on: true,
55
+ },
56
+ {
57
+ label: "Failed build alerts",
58
+ description: "Tell me straight away when a build stops halfway.",
59
+ on: true,
60
+ },
61
+ {
62
+ label: "Weekly summary",
63
+ description: "Builds, errors and time spent, every Monday morning.",
64
+ on: false,
65
+ },
66
+ ];
67
+
68
+ export function SettingsList() {
69
+ return (
70
+ <div className="w-full max-w-lg">
71
+ {settings.map((setting) => (
72
+ <Field
73
+ key={setting.label}
74
+ className="flex-row items-center justify-between gap-6 border-t border-border/60 py-4 last:border-b"
75
+ >
76
+ <div className="flex flex-col gap-1">
77
+ <FieldLabel>{setting.label}</FieldLabel>
78
+ <FieldDescription>{setting.description}</FieldDescription>
79
+ </div>
80
+ <Switch defaultChecked={setting.on} nativeButton render={<button type="button" />} />
81
+ </Field>
82
+ ))}
83
+ </div>
84
+ );
85
+ }
86
+ ```
87
+
88
+ ### States
89
+
90
+ ```tsx
91
+ import { Field, FieldLabel, Switch } from "@zonsh/ui";
92
+
93
+ export function States() {
94
+ return (
95
+ <div className="flex flex-col gap-3">
96
+ <Field>
97
+ <FieldLabel>
98
+ <Switch />
99
+ Off
100
+ </FieldLabel>
101
+ </Field>
102
+ <Field>
103
+ <FieldLabel>
104
+ <Switch defaultChecked />
105
+ On
106
+ </FieldLabel>
107
+ </Field>
108
+ <Field disabled>
109
+ <FieldLabel>
110
+ <Switch />
111
+ Disabled
112
+ </FieldLabel>
113
+ </Field>
114
+ <Field disabled>
115
+ <FieldLabel>
116
+ <Switch defaultChecked />
117
+ Disabled and on
118
+ </FieldLabel>
119
+ </Field>
120
+ </div>
121
+ );
122
+ }
123
+ ```
124
+
125
+ ## Props
126
+
127
+ | Prop | Type | Default |
128
+ | ----------------- | ----------------------------------------- | ------- |
129
+ | `checked` | `boolean` | — |
130
+ | `defaultChecked` | `boolean` | `false` |
131
+ | `onCheckedChange` | `(checked: boolean, details) => void` | — |
132
+ | `disabled` | `boolean` | `false` |
133
+ | `readOnly` | `boolean` | `false` |
134
+ | `nativeButton` | `boolean`: set with `render={<button />}` | `false` |
135
+
136
+ Other Base UI props are forwarded. Data attributes: `data-checked`, `data-unchecked`, `data-disabled`, `data-invalid`.
137
+
138
+ ## Brand rules
139
+
140
+ - **Do** label the setting ("Failed job alerts"), not the state.
141
+ - **Don't** flatten it: the track stays recessed, the thumb raised.
142
+ - **Don't** put "On"/"Off" or colour in the track.
143
+ - **Don't** use it for a value saved on submit.
144
+
145
+ ## Accessibility
146
+
147
+ - `role="switch"` with `aria-checked`; a flush 2px `--control-focus` outline on focus.
148
+ - Still under reduced motion.
149
+
150
+ ### Keyboard
151
+
152
+ | Key | What it does |
153
+ | ------------- | --------------------------- |
154
+ | Space / Enter | Turns the setting on or off |
155
+
156
+ ---
157
+
158
+ - Import: `import { Switch } from "@zonsh/ui"`
159
+ - Source: `packages/ui/src/components/switch.tsx`
160
+ - Primitive: `@base-ui/react/switch` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/switch.md`)