motion-ui-skill 2.1.1 → 2.2.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 (1011) hide show
  1. package/README.md +449 -219
  2. package/SKILL.md +268 -22
  3. package/bin/index.mjs +4 -3
  4. package/bin/installer.mjs +11 -1
  5. package/catalog.json +5989 -239
  6. package/components/agents/ai-agent-activity.tsx +443 -0
  7. package/components/agents/ai-response.tsx +829 -0
  8. package/components/agents/ai-status.tsx +373 -0
  9. package/components/agents/chat-thread.module.css +242 -0
  10. package/components/agents/chat-thread.tsx +700 -0
  11. package/components/agents/citations.tsx +1 -1
  12. package/components/agents/comment-thread.module.css +195 -0
  13. package/components/agents/comment-thread.tsx +593 -0
  14. package/components/agents/json-viewer.module.css +92 -0
  15. package/components/agents/json-viewer.tsx +530 -0
  16. package/components/agents/matrix-orb.tsx +252 -0
  17. package/components/agents/text-stream.css +17 -0
  18. package/components/agents/text-stream.tsx +169 -0
  19. package/components/agents/thinking-orb.tsx +653 -0
  20. package/components/agents/web-search.tsx +932 -0
  21. package/components/analytics-dashboard/context.ts +47 -0
  22. package/components/analytics-dashboard/data.ts +351 -0
  23. package/components/analytics-dashboard/details.tsx +282 -0
  24. package/components/analytics-dashboard/icons.tsx +219 -0
  25. package/components/analytics-dashboard/number-animation.module.css +19 -0
  26. package/components/analytics-dashboard/number-animation.tsx +183 -0
  27. package/components/analytics-dashboard/pages.tsx +673 -0
  28. package/components/analytics-dashboard/ui.tsx +238 -0
  29. package/components/blocks/active-sessions.css +52 -0
  30. package/components/blocks/active-sessions.tsx +679 -0
  31. package/components/blocks/activity-feed.tsx +432 -0
  32. package/components/blocks/activity-heatmap.module.css +83 -0
  33. package/components/blocks/activity-heatmap.tsx +416 -0
  34. package/components/blocks/advanced-data-table.tsx +1078 -0
  35. package/components/blocks/analytics-dashboard.css +2822 -0
  36. package/components/blocks/analytics-dashboard.tsx +394 -0
  37. package/components/blocks/art-gallery.tsx +508 -0
  38. package/components/blocks/bar-chart.module.css +49 -0
  39. package/components/blocks/bar-chart.tsx +394 -0
  40. package/components/blocks/blog-grid-data.ts +127 -0
  41. package/components/blocks/blog-grid.module.css +93 -0
  42. package/components/blocks/blog-grid.tsx +263 -0
  43. package/components/blocks/brush-chart.module.css +69 -0
  44. package/components/blocks/brush-chart.tsx +459 -0
  45. package/components/blocks/changelog-feed.module.css +138 -0
  46. package/components/blocks/changelog-feed.tsx +401 -0
  47. package/components/blocks/chat.tsx +785 -0
  48. package/components/blocks/comparison-table-data.ts +63 -0
  49. package/components/blocks/comparison-table.module.css +92 -0
  50. package/components/blocks/comparison-table.tsx +209 -0
  51. package/components/blocks/cta-section-data.ts +42 -0
  52. package/components/blocks/cta-section.module.css +95 -0
  53. package/components/blocks/cta-section.tsx +261 -0
  54. package/components/blocks/dashboard-shell.css +110 -0
  55. package/components/blocks/dashboard-shell.tsx +1067 -0
  56. package/components/blocks/empty-states-art.ts +331 -0
  57. package/components/blocks/empty-states.module.css +52 -0
  58. package/components/blocks/empty-states.tsx +326 -0
  59. package/components/blocks/family-drawer.tsx +695 -0
  60. package/components/blocks/faq.tsx +214 -0
  61. package/components/blocks/footer.tsx +117 -0
  62. package/components/blocks/form.tsx +594 -0
  63. package/components/blocks/hero-cadence.module.css +46 -0
  64. package/components/blocks/hero-cadence.tsx +68 -0
  65. package/components/blocks/hero-content.module.css +49 -0
  66. package/components/blocks/hero-content.tsx +93 -0
  67. package/components/blocks/hero-lumen-data.ts +97 -0
  68. package/components/blocks/hero-lumen.module.css +127 -0
  69. package/components/blocks/hero-lumen.tsx +204 -0
  70. package/components/blocks/hero-mesh.module.css +5 -0
  71. package/components/blocks/hero-mesh.tsx +200 -0
  72. package/components/blocks/hero-motion.ts +31 -0
  73. package/components/blocks/hero-relay.module.css +102 -0
  74. package/components/blocks/hero-relay.tsx +252 -0
  75. package/components/blocks/hero-section.module.css +31 -0
  76. package/components/blocks/hero-section.tsx +83 -0
  77. package/components/blocks/hook-sidebar.tsx +233 -0
  78. package/components/blocks/line-chart.module.css +60 -0
  79. package/components/blocks/line-chart.tsx +434 -0
  80. package/components/blocks/login-centered.module.css +94 -0
  81. package/components/blocks/login-centered.tsx +444 -0
  82. package/components/blocks/logo-marquee.module.css +162 -0
  83. package/components/blocks/logo-marquee.tsx +106 -0
  84. package/components/blocks/newsletter-signup-data.ts +95 -0
  85. package/components/blocks/newsletter-signup.module.css +175 -0
  86. package/components/blocks/newsletter-signup.tsx +369 -0
  87. package/components/blocks/notification-center.module.css +79 -0
  88. package/components/blocks/notification-center.tsx +244 -0
  89. package/components/blocks/page-header.module.css +161 -0
  90. package/components/blocks/page-header.tsx +495 -0
  91. package/components/blocks/plan-comparison.module.css +87 -0
  92. package/components/blocks/plan-comparison.tsx +120 -0
  93. package/components/blocks/pricing.tsx +421 -0
  94. package/components/blocks/product-tour.tsx +621 -0
  95. package/components/blocks/proximity-sidebar.tsx +397 -0
  96. package/components/blocks/rail-toc.tsx +468 -0
  97. package/components/blocks/scroll-progress.tsx +375 -0
  98. package/components/blocks/sidebar-stackbits.tsx +362 -0
  99. package/components/blocks/sign-in.module.css +73 -0
  100. package/components/blocks/sign-in.tsx +337 -0
  101. package/components/blocks/site-header.module.css +115 -0
  102. package/components/blocks/site-header.tsx +548 -0
  103. package/components/blocks/slope-chart.module.css +51 -0
  104. package/components/blocks/slope-chart.tsx +256 -0
  105. package/components/blocks/sortable-data-table.module.css +118 -0
  106. package/components/blocks/sortable-data-table.tsx +312 -0
  107. package/components/blocks/stats-band-data.ts +67 -0
  108. package/components/blocks/stats-band-world.ts +20 -0
  109. package/components/blocks/stats-band.module.css +150 -0
  110. package/components/blocks/stats-band.tsx +236 -0
  111. package/components/blocks/status-bars.css +52 -0
  112. package/components/blocks/status-bars.tsx +406 -0
  113. package/components/blocks/step-player.tsx +344 -0
  114. package/components/blocks/task-list.tsx +374 -0
  115. package/components/blocks/waffle-chart.module.css +52 -0
  116. package/components/blocks/waffle-chart.tsx +303 -0
  117. package/components/buttons/ash-burst-button.tsx +1 -1
  118. package/components/buttons/minecraft-button.tsx +1 -1
  119. package/components/craft/Button.tsx +137 -0
  120. package/components/craft/Form.tsx +594 -0
  121. package/components/craft/airport-matrix-clock.tsx +389 -0
  122. package/components/craft/animated-counter.tsx +384 -0
  123. package/components/craft/batch-gesture-tray.tsx +273 -0
  124. package/components/craft/car-smoke-page-transition.tsx +1147 -0
  125. package/components/craft/circular-orbit.tsx +270 -0
  126. package/components/craft/click-spark.tsx +205 -0
  127. package/components/craft/code-snippet-deck.tsx +275 -0
  128. package/components/craft/command.tsx +186 -0
  129. package/components/craft/cursor-follower.tsx +156 -0
  130. package/components/craft/delete-button.tsx +285 -0
  131. package/components/craft/density-lens.tsx +115 -0
  132. package/components/craft/dependency-trace.tsx +219 -0
  133. package/components/craft/depth-corridor.tsx +179 -0
  134. package/components/craft/discover-button.css +83 -0
  135. package/components/craft/discover-button.tsx +46 -0
  136. package/components/craft/drag-to-confirm.tsx +387 -0
  137. package/components/craft/draggable-marquee.css +5 -0
  138. package/components/craft/draggable-marquee.tsx +352 -0
  139. package/components/craft/duration-picker.tsx +291 -0
  140. package/components/craft/emoji-reaction.tsx +610 -0
  141. package/components/craft/empty.tsx +108 -0
  142. package/components/craft/evil-eye.tsx +350 -0
  143. package/components/craft/expandable-data-row.tsx +419 -0
  144. package/components/craft/field.tsx +250 -0
  145. package/components/craft/file-input.tsx +553 -0
  146. package/components/craft/flip-text.tsx +128 -0
  147. package/components/craft/fluid-orb.tsx +199 -0
  148. package/components/craft/focus-mode.tsx +262 -0
  149. package/components/craft/folder-component.tsx +474 -0
  150. package/components/craft/framing.ts +53 -0
  151. package/components/craft/github-activity.tsx +682 -0
  152. package/components/craft/glitch-text.tsx +414 -0
  153. package/components/craft/glyph-matrix.tsx +411 -0
  154. package/components/craft/golden-gate-404/framing.ts +53 -0
  155. package/components/craft/golden-gate-404/golden-gate-404.css +271 -0
  156. package/components/craft/golden-gate-404/golden-gate-404.mdx +55 -0
  157. package/components/craft/golden-gate-404/golden-gate-scene.tsx +73 -0
  158. package/components/craft/golden-gate-404/golden-gate.css +157 -0
  159. package/components/craft/golden-gate-404/live.ts +592 -0
  160. package/components/craft/golden-gate-404/model.json +176 -0
  161. package/components/craft/golden-gate-404/projection.ts +41 -0
  162. package/components/craft/golden-gate-404.css +271 -0
  163. package/components/craft/golden-gate-404.tsx +67 -0
  164. package/components/craft/golden-gate-scene.tsx +73 -0
  165. package/components/craft/golden-gate.css +157 -0
  166. package/components/craft/gooey-nav.tsx +286 -0
  167. package/components/craft/gravity-letters.tsx +687 -0
  168. package/components/craft/gravity-particle-burst.tsx +150 -0
  169. package/components/craft/grid-reveal.tsx +683 -0
  170. package/components/craft/hover-img.css +156 -0
  171. package/components/craft/hover-img.tsx +160 -0
  172. package/components/craft/input-otp.tsx +79 -0
  173. package/components/craft/interactive-area-chart.tsx +482 -0
  174. package/components/craft/interactive-timeline.tsx +315 -0
  175. package/components/craft/intro-loader.tsx +250 -0
  176. package/components/craft/ios-search-bar.tsx +130 -0
  177. package/components/craft/liquid-metal.tsx +212 -0
  178. package/components/craft/liquid-toggle.tsx +308 -0
  179. package/components/craft/live.ts +592 -0
  180. package/components/craft/loaders-gooey-blobs.tsx +61 -0
  181. package/components/craft/lock-input.tsx +169 -0
  182. package/components/craft/login.tsx +276 -0
  183. package/components/craft/meteors.tsx +139 -0
  184. package/components/craft/metric-hud.tsx +371 -0
  185. package/components/craft/model.json +176 -0
  186. package/components/craft/morphing-blob.tsx +289 -0
  187. package/components/craft/morphing-dialog.tsx +118 -0
  188. package/components/craft/morphing-icon.tsx +74 -0
  189. package/components/craft/morphing-shape-loader.tsx +241 -0
  190. package/components/craft/nimbu-mirchi.tsx +360 -0
  191. package/components/craft/notification-bell.tsx +357 -0
  192. package/components/craft/orbital-loading-ring.tsx +104 -0
  193. package/components/craft/origin-dropdown.tsx +196 -0
  194. package/components/craft/particle-delete.tsx +266 -0
  195. package/components/craft/payment-receipt-printer.tsx +600 -0
  196. package/components/craft/payment-status.tsx +359 -0
  197. package/components/craft/projection.ts +41 -0
  198. package/components/craft/recovery-ledger.tsx +215 -0
  199. package/components/craft/rocket-party-popper.tsx +308 -0
  200. package/components/craft/scroll-progress-nav.tsx +256 -0
  201. package/components/craft/scrollvelocitytext.tsx +285 -0
  202. package/components/craft/selection-basket.tsx +147 -0
  203. package/components/craft/sheet.tsx +324 -0
  204. package/components/craft/shooting-stars.tsx +710 -0
  205. package/components/craft/sidebar.tsx +448 -0
  206. package/components/craft/sign-up.tsx +396 -0
  207. package/components/craft/skeumorphic-music-card.tsx +177 -0
  208. package/components/craft/slide-pagination.tsx +170 -0
  209. package/components/craft/slot-text.module.css +19 -0
  210. package/components/craft/slot-text.tsx +183 -0
  211. package/components/craft/smart-comparison.tsx +375 -0
  212. package/components/craft/smooth-scroll.tsx +63 -0
  213. package/components/craft/speed-warp.tsx +179 -0
  214. package/components/craft/split-showcase.tsx +268 -0
  215. package/components/craft/spotlight-search.tsx +337 -0
  216. package/components/craft/stack-unfold-panel.tsx +137 -0
  217. package/components/craft/sticky-pages.tsx +210 -0
  218. package/components/craft/text-scramble-decoder.tsx +139 -0
  219. package/components/craft/toggle.tsx +49 -0
  220. package/components/craft/torque-dial.tsx +293 -0
  221. package/components/craft/v-prism-settings.ts +31 -0
  222. package/components/craft/v-prism.tsx +797 -0
  223. package/components/craft/voice-note.tsx +730 -0
  224. package/components/docks/mac-dock.tsx +1 -1
  225. package/components/motion/accordion.module.css +15 -0
  226. package/components/motion/accordion.tsx +59 -0
  227. package/components/motion/action-button.module.css +20 -0
  228. package/components/motion/action-button.tsx +120 -0
  229. package/components/motion/action-sheet.tsx +1 -1
  230. package/components/motion/alert.module.css +15 -0
  231. package/components/motion/alert.tsx +109 -0
  232. package/components/motion/animated-counter.tsx +2 -0
  233. package/components/motion/animated-sidebar.tsx +1 -1
  234. package/components/motion/animated-toast-stack.tsx +1 -1
  235. package/components/motion/attachment-upload.tsx +1 -1
  236. package/components/motion/avatar.module.css +60 -0
  237. package/components/motion/avatar.tsx +21 -0
  238. package/components/motion/badge.module.css +52 -0
  239. package/components/motion/badge.tsx +82 -0
  240. package/components/motion/banner-stacking.tsx +3 -3
  241. package/components/motion/billing-toggle.module.css +139 -0
  242. package/components/motion/billing-toggle.tsx +205 -0
  243. package/components/motion/book-call-button.tsx +332 -0
  244. package/components/motion/bottom-sheet.tsx +1 -1
  245. package/components/motion/branching-submenu.tsx +223 -0
  246. package/components/motion/button/index.tsx +1 -0
  247. package/components/motion/button-group.module.css +87 -0
  248. package/components/motion/button-group.tsx +346 -0
  249. package/components/motion/calendar.module.css +51 -0
  250. package/components/motion/calendar.tsx +313 -0
  251. package/components/motion/card-stack.module.css +63 -0
  252. package/components/motion/card-stack.tsx +372 -0
  253. package/components/motion/card.module.css +51 -0
  254. package/components/motion/card.tsx +201 -0
  255. package/components/motion/carousel.module.css +42 -0
  256. package/components/motion/carousel.tsx +347 -0
  257. package/components/motion/center-morph-modal.tsx +1 -1
  258. package/components/motion/chart.tsx +359 -0
  259. package/components/motion/chip-group.module.css +38 -0
  260. package/components/motion/chip-group.tsx +256 -0
  261. package/components/motion/combobox/content.tsx +1 -1
  262. package/components/motion/command-menu.tsx +295 -0
  263. package/components/motion/command-palette.tsx +1 -1
  264. package/components/motion/confirm-morph.module.css +146 -0
  265. package/components/motion/confirm-morph.tsx +445 -0
  266. package/components/motion/context-menu.tsx +1 -1
  267. package/components/motion/cookie-consent.module.css +68 -0
  268. package/components/motion/cookie-consent.tsx +364 -0
  269. package/components/motion/countdown.module.css +49 -0
  270. package/components/motion/countdown.tsx +218 -0
  271. package/components/motion/date-picker.module.css +34 -0
  272. package/components/motion/date-picker.tsx +131 -0
  273. package/components/motion/dialog.module.css +36 -0
  274. package/components/motion/dialog.tsx +75 -0
  275. package/components/motion/dock.tsx +1 -1
  276. package/components/motion/dropdown-menu-morph.tsx +4 -4
  277. package/components/motion/dropdown-menu.module.css +38 -0
  278. package/components/motion/dropdown-menu.tsx +76 -0
  279. package/components/motion/elastic-slider.module.css +40 -0
  280. package/components/motion/elastic-slider.tsx +296 -0
  281. package/components/motion/empty-state.module.css +13 -0
  282. package/components/motion/empty-state.tsx +88 -0
  283. package/components/motion/expandable-card.module.css +22 -0
  284. package/components/motion/expandable-card.tsx +129 -0
  285. package/components/motion/expandable-text.module.css +19 -0
  286. package/components/motion/expandable-text.tsx +168 -0
  287. package/components/motion/expanding-button-group.module.css +44 -0
  288. package/components/motion/expanding-button-group.tsx +367 -0
  289. package/components/motion/expanding-search.module.css +51 -0
  290. package/components/motion/expanding-search.tsx +336 -0
  291. package/components/motion/file-dropzone.module.css +115 -0
  292. package/components/motion/file-dropzone.tsx +442 -0
  293. package/components/motion/filter-toolbar.module.css +70 -0
  294. package/components/motion/filter-toolbar.tsx +461 -0
  295. package/components/motion/floating-button-group.module.css +74 -0
  296. package/components/motion/floating-button-group.tsx +307 -0
  297. package/components/motion/gauge.module.css +22 -0
  298. package/components/motion/gauge.tsx +106 -0
  299. package/components/motion/hamburger-menu.tsx +103 -0
  300. package/components/motion/hold-to-confirm.module.css +20 -0
  301. package/components/motion/hold-to-confirm.tsx +209 -0
  302. package/components/motion/icon-morph.module.css +5 -0
  303. package/components/motion/icon-morph.tsx +239 -0
  304. package/components/motion/image-compare.module.css +25 -0
  305. package/components/motion/image-compare.tsx +278 -0
  306. package/components/motion/in-view-title.module.css +13 -0
  307. package/components/motion/in-view-title.tsx +74 -0
  308. package/components/motion/inline-edit.module.css +73 -0
  309. package/components/motion/inline-edit.tsx +360 -0
  310. package/components/motion/input-group.tsx +172 -0
  311. package/components/motion/item.tsx +197 -0
  312. package/components/motion/label.tsx +26 -0
  313. package/components/motion/liquid-ripple-button.tsx +193 -0
  314. package/components/motion/mac-os-folder-cards.tsx +268 -0
  315. package/components/motion/magnetic-button.tsx +96 -0
  316. package/components/motion/mention-input.module.css +134 -0
  317. package/components/motion/mention-input.tsx +522 -0
  318. package/components/motion/menubar.tsx +282 -0
  319. package/components/motion/money-card.tsx +1134 -0
  320. package/components/motion/money-input.module.css +77 -0
  321. package/components/motion/money-input.tsx +563 -0
  322. package/components/motion/morph-select.module.css +86 -0
  323. package/components/motion/morph-select.tsx +463 -0
  324. package/components/motion/morphing-button.tsx +141 -0
  325. package/components/motion/morphing-mega-menu.tsx +452 -0
  326. package/components/motion/morphing-search.tsx +1 -1
  327. package/components/motion/morphing-tabs.tsx +1 -1
  328. package/components/motion/multi-select/content.tsx +1 -1
  329. package/components/motion/navigation-menu.tsx +172 -0
  330. package/components/motion/neon-edge-button.tsx +64 -0
  331. package/components/motion/onboarding-checklist.module.css +71 -0
  332. package/components/motion/onboarding-checklist.tsx +349 -0
  333. package/components/motion/organic-shimmer.tsx +6 -6
  334. package/components/motion/otp-input.tsx +7 -4
  335. package/components/motion/password-field.module.css +27 -0
  336. package/components/motion/password-field.tsx +65 -0
  337. package/components/motion/password-strength.module.css +57 -0
  338. package/components/motion/password-strength.tsx +327 -0
  339. package/components/motion/peek-card.tsx +239 -0
  340. package/components/motion/popover-morph.tsx +1 -1
  341. package/components/motion/popover.tsx +1 -1
  342. package/components/motion/preview-rail.tsx +1 -1
  343. package/components/motion/profile-card.tsx +326 -0
  344. package/components/motion/progress.module.css +1 -0
  345. package/components/motion/progress.tsx +60 -0
  346. package/components/motion/project-folder.tsx +1 -1
  347. package/components/motion/radio-cards.module.css +84 -0
  348. package/components/motion/radio-cards.tsx +153 -0
  349. package/components/motion/radio-group.module.css +30 -0
  350. package/components/motion/radio-group.tsx +52 -0
  351. package/components/motion/rainbow-button.tsx +186 -0
  352. package/components/motion/raised-button.tsx +108 -0
  353. package/components/motion/range-histogram-slider.module.css +27 -0
  354. package/components/motion/range-histogram-slider.tsx +284 -0
  355. package/components/motion/reactions.module.css +49 -0
  356. package/components/motion/reactions.tsx +288 -0
  357. package/components/motion/resizable-panels.module.css +40 -0
  358. package/components/motion/resizable-panels.tsx +376 -0
  359. package/components/motion/resizable.tsx +58 -0
  360. package/components/motion/rich-text-editor.module.css +201 -0
  361. package/components/motion/rich-text-editor.tsx +1566 -0
  362. package/components/motion/ridgeline.module.css +58 -0
  363. package/components/motion/ridgeline.tsx +355 -0
  364. package/components/motion/scroll-area.module.css +79 -0
  365. package/components/motion/scroll-area.tsx +197 -0
  366. package/components/motion/scrub-input.module.css +135 -0
  367. package/components/motion/scrub-input.tsx +468 -0
  368. package/components/motion/search-field.module.css +17 -0
  369. package/components/motion/search-field.tsx +19 -0
  370. package/components/motion/segmented-control.tsx +2 -0
  371. package/components/motion/separator.tsx +30 -0
  372. package/components/motion/shortcut-recorder.module.css +85 -0
  373. package/components/motion/shortcut-recorder.tsx +513 -0
  374. package/components/motion/signature-pad.module.css +84 -0
  375. package/components/motion/signature-pad.tsx +546 -0
  376. package/components/motion/skeleton.module.css +11 -0
  377. package/components/motion/skeleton.tsx +70 -0
  378. package/components/motion/slider.module.css +45 -0
  379. package/components/motion/slider.tsx +405 -0
  380. package/components/motion/sonner.tsx +42 -0
  381. package/components/motion/sparkline.module.css +26 -0
  382. package/components/motion/sparkline.tsx +260 -0
  383. package/components/motion/spinner.tsx +20 -0
  384. package/components/motion/split-button.module.css +54 -0
  385. package/components/motion/split-button.tsx +114 -0
  386. package/components/motion/story-card.tsx +632 -0
  387. package/components/motion/streamgraph.module.css +55 -0
  388. package/components/motion/streamgraph.tsx +398 -0
  389. package/components/motion/swipe-actions.module.css +64 -0
  390. package/components/motion/swipe-actions.tsx +360 -0
  391. package/components/motion/table/row-handle.tsx +1 -1
  392. package/components/motion/table/table-header.tsx +1 -1
  393. package/components/motion/table/table-menu.tsx +1 -1
  394. package/components/motion/tag-input.module.css +34 -0
  395. package/components/motion/tag-input.tsx +150 -0
  396. package/components/motion/textarea.module.css +22 -0
  397. package/components/motion/textarea.tsx +64 -0
  398. package/components/motion/theme-switch-eclipse.tsx +82 -0
  399. package/components/motion/theme-switch-rise.tsx +82 -0
  400. package/components/motion/theme-switch-split.tsx +82 -0
  401. package/components/motion/theme-switch.module.css +31 -0
  402. package/components/motion/theme-switch.tsx +82 -0
  403. package/components/motion/time-picker.module.css +23 -0
  404. package/components/motion/time-picker.tsx +106 -0
  405. package/components/motion/toast.module.css +100 -0
  406. package/components/motion/toast.tsx +155 -0
  407. package/components/motion/tooltip.tsx +1 -1
  408. package/components/motion/treemap.module.css +59 -0
  409. package/components/motion/treemap.tsx +333 -0
  410. package/components/motion/undo-toast.tsx +252 -0
  411. package/components/motion/usage-meter.module.css +61 -0
  412. package/components/motion/usage-meter.tsx +340 -0
  413. package/components/otp/otp-boxed-input.tsx +18 -18
  414. package/components/previews/agents/ai-agent-activity.preview.tsx +14 -0
  415. package/components/previews/agents/ai-response.preview.tsx +14 -0
  416. package/components/previews/agents/ai-status.preview.tsx +14 -0
  417. package/components/previews/agents/chat-thread.preview.tsx +18 -0
  418. package/components/previews/agents/comment-thread.preview.tsx +17 -0
  419. package/components/previews/agents/json-viewer.preview.tsx +14 -0
  420. package/components/previews/agents/matrix-orb.preview.tsx +14 -0
  421. package/components/previews/agents/text-stream.preview.tsx +19 -0
  422. package/components/previews/agents/thinking-orb.preview.tsx +14 -0
  423. package/components/previews/agents/web-search.preview.tsx +17 -0
  424. package/components/previews/blocks/active-sessions.preview.tsx +14 -0
  425. package/components/previews/blocks/activity-feed.preview.tsx +14 -0
  426. package/components/previews/blocks/activity-heatmap.preview.tsx +18 -0
  427. package/components/previews/blocks/advanced-data-table.preview.tsx +17 -0
  428. package/components/previews/blocks/analytics-dashboard.preview.tsx +14 -0
  429. package/components/previews/blocks/art-gallery.preview.tsx +14 -0
  430. package/components/previews/blocks/bar-chart.preview.tsx +18 -0
  431. package/components/previews/blocks/blog-grid.preview.tsx +14 -0
  432. package/components/previews/blocks/brush-chart.preview.tsx +17 -0
  433. package/components/previews/blocks/changelog-feed.preview.tsx +14 -0
  434. package/components/previews/blocks/chat.preview.tsx +18 -0
  435. package/components/previews/blocks/comparison-table.preview.tsx +14 -0
  436. package/components/previews/blocks/cta-section.preview.tsx +14 -0
  437. package/components/previews/blocks/dashboard-shell.preview.tsx +18 -0
  438. package/components/previews/blocks/empty-states.preview.tsx +14 -0
  439. package/components/previews/blocks/expandable-tabs.preview.tsx +1 -1
  440. package/components/previews/blocks/family-drawer.preview.tsx +14 -0
  441. package/components/previews/blocks/faq.preview.tsx +14 -0
  442. package/components/previews/blocks/footer.preview.tsx +14 -0
  443. package/components/previews/blocks/form.preview.tsx +14 -0
  444. package/components/previews/blocks/frame.preview.tsx +18 -0
  445. package/components/previews/blocks/gantt.preview.tsx +18 -0
  446. package/components/previews/blocks/hero-section.preview.tsx +14 -0
  447. package/components/previews/blocks/hook-sidebar.preview.tsx +14 -0
  448. package/components/previews/blocks/kanban.preview.tsx +68 -0
  449. package/components/previews/blocks/line-chart.preview.tsx +18 -0
  450. package/components/previews/blocks/login-centered.preview.tsx +14 -0
  451. package/components/previews/blocks/logo-marquee.preview.tsx +14 -0
  452. package/components/previews/blocks/newsletter-signup.preview.tsx +14 -0
  453. package/components/previews/blocks/notification-center.preview.tsx +14 -0
  454. package/components/previews/blocks/otp-input.preview.tsx +2 -2
  455. package/components/previews/blocks/page-header.preview.tsx +14 -0
  456. package/components/previews/blocks/plan-comparison.preview.tsx +14 -0
  457. package/components/previews/blocks/pricing.preview.tsx +14 -0
  458. package/components/previews/blocks/product-tour.preview.tsx +14 -0
  459. package/components/previews/blocks/proximity-sidebar.preview.tsx +14 -0
  460. package/components/previews/blocks/rail-toc.preview.tsx +14 -0
  461. package/components/previews/blocks/scroll-progress.preview.tsx +14 -0
  462. package/components/previews/blocks/sidebar-stackbits.preview.tsx +14 -0
  463. package/components/previews/blocks/sign-in.preview.tsx +14 -0
  464. package/components/previews/blocks/site-header.preview.tsx +14 -0
  465. package/components/previews/blocks/slope-chart.preview.tsx +19 -0
  466. package/components/previews/blocks/sortable-data-table.preview.tsx +18 -0
  467. package/components/previews/blocks/stats-band.preview.tsx +14 -0
  468. package/components/previews/blocks/status-bars.preview.tsx +17 -0
  469. package/components/previews/blocks/step-player.preview.tsx +14 -0
  470. package/components/previews/blocks/task-list.preview.tsx +14 -0
  471. package/components/previews/blocks/waffle-chart.preview.tsx +17 -0
  472. package/components/previews/craft/airport-matrix-clock.preview.tsx +14 -0
  473. package/components/previews/craft/animated-counter.preview.tsx +14 -0
  474. package/components/previews/craft/apple-notification.preview.tsx +11 -0
  475. package/components/previews/craft/batch-gesture-tray.preview.tsx +19 -0
  476. package/components/previews/craft/booking-slot-calendar.preview.tsx +11 -0
  477. package/components/previews/craft/cafe-menu-board.preview.tsx +11 -0
  478. package/components/previews/craft/calendar-reminder-notification.preview.tsx +11 -0
  479. package/components/previews/craft/car-smoke-page-transition.preview.tsx +14 -0
  480. package/components/previews/craft/chat-bubble-notification.preview.tsx +11 -0
  481. package/components/previews/craft/cinema-ticket.preview.tsx +11 -0
  482. package/components/previews/craft/circle-cut-frame.preview.tsx +11 -0
  483. package/components/previews/craft/circular-orbit.preview.tsx +14 -0
  484. package/components/previews/craft/click-spark.preview.tsx +14 -0
  485. package/components/previews/craft/code-snippet-deck.preview.tsx +14 -0
  486. package/components/previews/craft/command.preview.tsx +14 -0
  487. package/components/previews/craft/contact-profile.preview.tsx +11 -0
  488. package/components/previews/craft/credit-card-glass.preview.tsx +11 -0
  489. package/components/previews/craft/cursor-follower.preview.tsx +14 -0
  490. package/components/previews/craft/customers-table.preview.tsx +11 -0
  491. package/components/previews/craft/daily-motivation.preview.tsx +11 -0
  492. package/components/previews/craft/date-range-picker-card.preview.tsx +11 -0
  493. package/components/previews/craft/delete-button.preview.tsx +14 -0
  494. package/components/previews/craft/delivery-notification.preview.tsx +11 -0
  495. package/components/previews/craft/denim-product-editorial.preview.tsx +11 -0
  496. package/components/previews/craft/density-lens.preview.tsx +14 -0
  497. package/components/previews/craft/dependency-trace.preview.tsx +17 -0
  498. package/components/previews/craft/deploy-notification.preview.tsx +11 -0
  499. package/components/previews/craft/depth-corridor.preview.tsx +14 -0
  500. package/components/previews/craft/discord-chat.preview.tsx +11 -0
  501. package/components/previews/craft/discover-button.preview.tsx +14 -0
  502. package/components/previews/craft/doubt-button.preview.tsx +11 -0
  503. package/components/previews/craft/drag-to-confirm.preview.tsx +14 -0
  504. package/components/previews/craft/draggable-marquee.preview.tsx +17 -0
  505. package/components/previews/craft/drop-cap-editorial.preview.tsx +11 -0
  506. package/components/previews/craft/duration-picker.preview.tsx +14 -0
  507. package/components/previews/craft/editorial-staff-profile.preview.tsx +11 -0
  508. package/components/previews/craft/electric-scooter.preview.tsx +11 -0
  509. package/components/previews/craft/email-notification.preview.tsx +11 -0
  510. package/components/previews/craft/emoji-reaction.preview.tsx +14 -0
  511. package/components/previews/craft/empty.preview.tsx +14 -0
  512. package/components/previews/craft/event-ticket.preview.tsx +11 -0
  513. package/components/previews/craft/evil-eye.preview.tsx +14 -0
  514. package/components/previews/craft/expandable-data-row.preview.tsx +14 -0
  515. package/components/previews/craft/field.preview.tsx +14 -0
  516. package/components/previews/craft/file-input.preview.tsx +14 -0
  517. package/components/previews/craft/film-strip.preview.tsx +11 -0
  518. package/components/previews/craft/flight-boarding.preview.tsx +11 -0
  519. package/components/previews/craft/flip-text.preview.tsx +14 -0
  520. package/components/previews/craft/fluid-orb.preview.tsx +14 -0
  521. package/components/previews/craft/focus-mode.preview.tsx +14 -0
  522. package/components/previews/craft/folder-component.preview.tsx +14 -0
  523. package/components/previews/craft/folder-tab-card.preview.tsx +11 -0
  524. package/components/previews/craft/gallery-grid.preview.tsx +11 -0
  525. package/components/previews/craft/gallery-wall.preview.tsx +11 -0
  526. package/components/previews/craft/github-activity.preview.tsx +14 -0
  527. package/components/previews/craft/github-contribution.preview.tsx +11 -0
  528. package/components/previews/craft/github-repo.preview.tsx +11 -0
  529. package/components/previews/craft/glass-overlay-image.preview.tsx +11 -0
  530. package/components/previews/craft/glitch-text.preview.tsx +14 -0
  531. package/components/previews/craft/glyph-matrix.preview.tsx +14 -0
  532. package/components/previews/craft/golden-gate-404.preview.tsx +14 -0
  533. package/components/previews/craft/gooey-nav.preview.tsx +14 -0
  534. package/components/previews/craft/gravity-letters.preview.tsx +14 -0
  535. package/components/previews/craft/gravity-particle-burst.preview.tsx +14 -0
  536. package/components/previews/craft/grid-reveal.preview.tsx +14 -0
  537. package/components/previews/craft/hard-shadow-polaroid-frame.preview.tsx +11 -0
  538. package/components/previews/craft/hover-img.preview.tsx +14 -0
  539. package/components/previews/craft/incoming-call-notification.preview.tsx +11 -0
  540. package/components/previews/craft/ink-stamp-document.preview.tsx +11 -0
  541. package/components/previews/craft/input-group-field.preview.tsx +11 -0
  542. package/components/previews/craft/input-otp.preview.tsx +19 -0
  543. package/components/previews/craft/interactive-area-chart.preview.tsx +14 -0
  544. package/components/previews/craft/interactive-timeline.preview.tsx +14 -0
  545. package/components/previews/craft/intro-loader.preview.tsx +14 -0
  546. package/components/previews/craft/ios-search-bar.preview.tsx +15 -0
  547. package/components/previews/craft/ipad.preview.tsx +11 -0
  548. package/components/previews/craft/journal-writing.preview.tsx +11 -0
  549. package/components/previews/craft/keyboard-shortcuts.preview.tsx +11 -0
  550. package/components/previews/craft/linked-in-profile.preview.tsx +11 -0
  551. package/components/previews/craft/liquid-metal.preview.tsx +14 -0
  552. package/components/previews/craft/liquid-toggle.preview.tsx +14 -0
  553. package/components/previews/craft/loaders-gooey-blobs.preview.tsx +14 -0
  554. package/components/previews/craft/lock-input.preview.tsx +14 -0
  555. package/components/previews/craft/login.preview.tsx +14 -0
  556. package/components/previews/craft/mac-dock.preview.tsx +11 -0
  557. package/components/previews/craft/magazine-cover.preview.tsx +11 -0
  558. package/components/previews/craft/meteors.preview.tsx +14 -0
  559. package/components/previews/craft/metric-hud.preview.tsx +14 -0
  560. package/components/previews/craft/minimal-agenda.preview.tsx +11 -0
  561. package/components/previews/craft/month-picker-calendar.preview.tsx +11 -0
  562. package/components/previews/craft/morphing-blob.preview.tsx +14 -0
  563. package/components/previews/craft/morphing-dialog.preview.tsx +18 -0
  564. package/components/previews/craft/morphing-icon.preview.tsx +15 -0
  565. package/components/previews/craft/morphing-shape-loader.preview.tsx +14 -0
  566. package/components/previews/craft/museum-placard.preview.tsx +11 -0
  567. package/components/previews/craft/music-player.preview.tsx +11 -0
  568. package/components/previews/craft/music-playlist.preview.tsx +11 -0
  569. package/components/previews/craft/nimbu-mirchi.preview.tsx +14 -0
  570. package/components/previews/craft/notification-bell.preview.tsx +14 -0
  571. package/components/previews/craft/now-playing-bar.preview.tsx +11 -0
  572. package/components/previews/craft/orbital-loading-ring.preview.tsx +14 -0
  573. package/components/previews/craft/orders-table.preview.tsx +11 -0
  574. package/components/previews/craft/origin-dropdown.preview.tsx +14 -0
  575. package/components/previews/craft/otp-boxed-input.preview.tsx +11 -0
  576. package/components/previews/craft/otp-underline-input.preview.tsx +11 -0
  577. package/components/previews/craft/particle-delete.preview.tsx +14 -0
  578. package/components/previews/craft/payment-notification.preview.tsx +11 -0
  579. package/components/previews/craft/payment-receipt-printer.preview.tsx +14 -0
  580. package/components/previews/craft/payment-status.preview.tsx +14 -0
  581. package/components/previews/craft/phone.preview.tsx +11 -0
  582. package/components/previews/craft/photo-album.preview.tsx +11 -0
  583. package/components/previews/craft/progress-ring-card.preview.tsx +11 -0
  584. package/components/previews/craft/recent-transactions-table.preview.tsx +11 -0
  585. package/components/previews/craft/recovery-ledger.preview.tsx +14 -0
  586. package/components/previews/craft/resource-links-panel.preview.tsx +11 -0
  587. package/components/previews/craft/rocket-party-popper.preview.tsx +14 -0
  588. package/components/previews/craft/scroll-progress-nav.preview.tsx +14 -0
  589. package/components/previews/craft/scrollvelocitytext.preview.tsx +14 -0
  590. package/components/previews/craft/selection-basket.preview.tsx +14 -0
  591. package/components/previews/craft/sheet.preview.tsx +15 -0
  592. package/components/previews/craft/shooting-stars.preview.tsx +14 -0
  593. package/components/previews/craft/sidebar.preview.tsx +19 -0
  594. package/components/previews/craft/sign-up.preview.tsx +14 -0
  595. package/components/previews/craft/skeumorphic-music-card.preview.tsx +18 -0
  596. package/components/previews/craft/slide-pagination.preview.tsx +14 -0
  597. package/components/previews/craft/slide-to-confirm-button.preview.tsx +11 -0
  598. package/components/previews/craft/slide-to-detonate.preview.tsx +11 -0
  599. package/components/previews/craft/slot-text.preview.tsx +14 -0
  600. package/components/previews/craft/slow-living-polaroid.preview.tsx +11 -0
  601. package/components/previews/craft/smart-comparison.preview.tsx +17 -0
  602. package/components/previews/craft/smooth-scroll.preview.tsx +14 -0
  603. package/components/previews/craft/speed-warp.preview.tsx +14 -0
  604. package/components/previews/craft/split-showcase.preview.tsx +14 -0
  605. package/components/previews/craft/spotlight-search.preview.tsx +14 -0
  606. package/components/previews/craft/stack-unfold-panel.preview.tsx +14 -0
  607. package/components/previews/craft/stacked-folder-card.preview.tsx +11 -0
  608. package/components/previews/craft/step-count.preview.tsx +11 -0
  609. package/components/previews/craft/sticky-pages.preview.tsx +14 -0
  610. package/components/previews/craft/system-alert.preview.tsx +11 -0
  611. package/components/previews/craft/team-members-table.preview.tsx +11 -0
  612. package/components/previews/craft/testimonial.preview.tsx +11 -0
  613. package/components/previews/craft/text-scramble-decoder.preview.tsx +14 -0
  614. package/components/previews/craft/threads-post.preview.tsx +11 -0
  615. package/components/previews/craft/toggle-pricing-cards.preview.tsx +11 -0
  616. package/components/previews/craft/toggle.preview.tsx +14 -0
  617. package/components/previews/craft/torque-dial.preview.tsx +15 -0
  618. package/components/previews/craft/travel-postcard.preview.tsx +11 -0
  619. package/components/previews/craft/twitter-profile.preview.tsx +11 -0
  620. package/components/previews/craft/user-profile.preview.tsx +11 -0
  621. package/components/previews/craft/users-select-table.preview.tsx +11 -0
  622. package/components/previews/craft/v-prism.preview.tsx +14 -0
  623. package/components/previews/craft/voice-note.preview.tsx +14 -0
  624. package/components/previews/craft/wallet-pass.preview.tsx +11 -0
  625. package/components/previews/craft/weather-snapshot.preview.tsx +11 -0
  626. package/components/previews/craft/week-strip-calendar.preview.tsx +11 -0
  627. package/components/previews/motion/accordion.preview.tsx +14 -0
  628. package/components/previews/motion/action-button.preview.tsx +14 -0
  629. package/components/previews/motion/alert.preview.tsx +14 -0
  630. package/components/previews/motion/avatar.preview.tsx +14 -0
  631. package/components/previews/motion/badge.preview.tsx +14 -0
  632. package/components/previews/motion/banner-stacking.preview.tsx +21 -0
  633. package/components/previews/motion/billing-toggle.preview.tsx +15 -0
  634. package/components/previews/motion/book-call-button.preview.tsx +14 -0
  635. package/components/previews/motion/branching-submenu.preview.tsx +14 -0
  636. package/components/previews/motion/button-group.preview.tsx +19 -0
  637. package/components/previews/motion/calendar.preview.tsx +14 -0
  638. package/components/previews/motion/card-stack.preview.tsx +19 -0
  639. package/components/previews/motion/card.preview.tsx +14 -0
  640. package/components/previews/motion/carousel.preview.tsx +17 -0
  641. package/components/previews/motion/cascader.preview.tsx +54 -0
  642. package/components/previews/motion/chart.preview.tsx +20 -0
  643. package/components/previews/motion/chip-group.preview.tsx +20 -0
  644. package/components/previews/motion/combobox.preview.tsx +1 -1
  645. package/components/previews/motion/command-menu.preview.tsx +16 -0
  646. package/components/previews/motion/confirm-morph.preview.tsx +14 -0
  647. package/components/previews/motion/cookie-consent.preview.tsx +14 -0
  648. package/components/previews/motion/countdown.preview.tsx +15 -0
  649. package/components/previews/motion/date-picker.preview.tsx +14 -0
  650. package/components/previews/motion/delete-with-smoky-dissolve.preview.tsx +14 -0
  651. package/components/previews/motion/dialog.preview.tsx +24 -0
  652. package/components/previews/motion/drag-drop-with-physics.preview.tsx +15 -0
  653. package/components/previews/motion/dropdown-menu-morph.preview.tsx +11 -0
  654. package/components/previews/motion/dropdown-menu.preview.tsx +19 -0
  655. package/components/previews/motion/elastic-slider.preview.tsx +14 -0
  656. package/components/previews/motion/empty-state.preview.tsx +14 -0
  657. package/components/previews/motion/expandable-card.preview.tsx +14 -0
  658. package/components/previews/motion/expandable-text.preview.tsx +14 -0
  659. package/components/previews/motion/expanding-button-group.preview.tsx +18 -0
  660. package/components/previews/motion/expanding-search.preview.tsx +17 -0
  661. package/components/previews/motion/file-dropzone.preview.tsx +14 -0
  662. package/components/previews/motion/filter-toolbar.preview.tsx +15 -0
  663. package/components/previews/motion/floating-button-group.preview.tsx +14 -0
  664. package/components/previews/motion/gauge.preview.tsx +14 -0
  665. package/components/previews/motion/hamburger-menu.preview.tsx +15 -0
  666. package/components/previews/motion/hold-to-confirm.preview.tsx +16 -0
  667. package/components/previews/motion/icon-morph.preview.tsx +14 -0
  668. package/components/previews/motion/image-compare.preview.tsx +17 -0
  669. package/components/previews/motion/in-view-title.preview.tsx +14 -0
  670. package/components/previews/motion/inline-edit.preview.tsx +15 -0
  671. package/components/previews/motion/input-group.preview.tsx +14 -0
  672. package/components/previews/motion/item.preview.tsx +14 -0
  673. package/components/previews/motion/label.preview.tsx +14 -0
  674. package/components/previews/motion/liquid-ripple-button.preview.tsx +14 -0
  675. package/components/previews/motion/mac-os-folder-cards.preview.tsx +14 -0
  676. package/components/previews/motion/magnetic-button.preview.tsx +14 -0
  677. package/components/previews/motion/mention-input.preview.tsx +14 -0
  678. package/components/previews/motion/menubar.preview.tsx +14 -0
  679. package/components/previews/motion/money-card.preview.tsx +14 -0
  680. package/components/previews/motion/money-input.preview.tsx +14 -0
  681. package/components/previews/motion/morph-select.preview.tsx +14 -0
  682. package/components/previews/motion/morphing-button.preview.tsx +14 -0
  683. package/components/previews/motion/morphing-mega-menu.preview.tsx +14 -0
  684. package/components/previews/motion/navigation-menu.preview.tsx +14 -0
  685. package/components/previews/motion/neon-edge-button.preview.tsx +14 -0
  686. package/components/previews/motion/onboarding-checklist.preview.tsx +17 -0
  687. package/components/previews/motion/organic-shimmer.preview.tsx +18 -0
  688. package/components/previews/motion/page-transition.preview.tsx +35 -0
  689. package/components/previews/motion/pagination.preview.tsx +20 -0
  690. package/components/previews/motion/password-field.preview.tsx +14 -0
  691. package/components/previews/motion/password-strength.preview.tsx +14 -0
  692. package/components/previews/motion/peek-card.preview.tsx +14 -0
  693. package/components/previews/motion/popover.preview.tsx +1 -1
  694. package/components/previews/motion/profile-card.preview.tsx +14 -0
  695. package/components/previews/motion/progress.preview.tsx +14 -0
  696. package/components/previews/motion/radio-cards.preview.tsx +14 -0
  697. package/components/previews/motion/radio-group.preview.tsx +20 -0
  698. package/components/previews/motion/rainbow-button.preview.tsx +14 -0
  699. package/components/previews/motion/raised-button.preview.tsx +14 -0
  700. package/components/previews/motion/range-histogram-slider.preview.tsx +14 -0
  701. package/components/previews/motion/reactions.preview.tsx +15 -0
  702. package/components/previews/motion/resizable-panels.preview.tsx +15 -0
  703. package/components/previews/motion/resizable.preview.tsx +19 -0
  704. package/components/previews/motion/rich-text-editor.preview.tsx +14 -0
  705. package/components/previews/motion/ridgeline.preview.tsx +17 -0
  706. package/components/previews/motion/scroll-area.preview.tsx +14 -0
  707. package/components/previews/motion/scrub-input.preview.tsx +14 -0
  708. package/components/previews/motion/search-field.preview.tsx +15 -0
  709. package/components/previews/motion/segmented-control.preview.tsx +23 -0
  710. package/components/previews/motion/select.preview.tsx +1 -1
  711. package/components/previews/motion/separator.preview.tsx +14 -0
  712. package/components/previews/motion/shortcut-recorder.preview.tsx +14 -0
  713. package/components/previews/motion/signature-pad.preview.tsx +14 -0
  714. package/components/previews/motion/skeleton.preview.tsx +14 -0
  715. package/components/previews/motion/slider.preview.tsx +14 -0
  716. package/components/previews/motion/sonner.preview.tsx +14 -0
  717. package/components/previews/motion/sparkline.preview.tsx +14 -0
  718. package/components/previews/motion/spinner.preview.tsx +14 -0
  719. package/components/previews/motion/split-button.preview.tsx +14 -0
  720. package/components/previews/motion/stepper.preview.tsx +39 -0
  721. package/components/previews/motion/story-card.preview.tsx +14 -0
  722. package/components/previews/motion/streamgraph.preview.tsx +18 -0
  723. package/components/previews/motion/swipe-actions.preview.tsx +18 -0
  724. package/components/previews/motion/tag-input.preview.tsx +14 -0
  725. package/components/previews/motion/text-animation.preview.tsx +2 -2
  726. package/components/previews/motion/text-reveal.preview.tsx +14 -0
  727. package/components/previews/motion/text-shimmer.preview.tsx +14 -0
  728. package/components/previews/motion/textarea.preview.tsx +14 -0
  729. package/components/previews/motion/theme-switch-eclipse.preview.tsx +15 -0
  730. package/components/previews/motion/theme-switch-rise.preview.tsx +15 -0
  731. package/components/previews/motion/theme-switch-split.preview.tsx +15 -0
  732. package/components/previews/motion/theme-switch.preview.tsx +15 -0
  733. package/components/previews/motion/tilt-card.preview.tsx +2 -2
  734. package/components/previews/motion/time-picker.preview.tsx +14 -0
  735. package/components/previews/motion/toast.preview.tsx +14 -0
  736. package/components/previews/motion/treemap.preview.tsx +17 -0
  737. package/components/previews/motion/undo-toast.preview.tsx +14 -0
  738. package/components/previews/motion/usage-meter.preview.tsx +19 -0
  739. package/components/profile/contact-profile-card.tsx +8 -8
  740. package/components/ui/button.tsx +59 -0
  741. package/components/ui/dialog.tsx +149 -0
  742. package/components/ui/input.tsx +20 -0
  743. package/components/ui/label.tsx +1 -0
  744. package/components/ui/loaders-gooey-blobs.tsx +2 -0
  745. package/components/ui/raised-button.tsx +2 -0
  746. package/components/ui/separator.tsx +1 -0
  747. package/components/ui/textarea.tsx +17 -0
  748. package/lib/arc-provider.tsx +101 -0
  749. package/lib/colorUtils.ts +34 -0
  750. package/lib/effects/shared/webgl-surface.jsx +47 -0
  751. package/lib/foundation.css +192 -0
  752. package/lib/media.ts +90 -0
  753. package/lib/motion-tokens.ts +5 -0
  754. package/lib/particle-delete.ts +500 -0
  755. package/lib/portal.tsx +23 -0
  756. package/lib/spring-tokens.ts +25 -0
  757. package/lib/theme/useTheme.tsx +157 -0
  758. package/lib/transition-tokens.ts +75 -0
  759. package/lib/use-copy-feedback.ts +40 -0
  760. package/lib/use-today.ts +8 -0
  761. package/lib/utils.ts +10 -0
  762. package/package.json +32 -4
  763. package/references/agents/ai-agent-activity.md +45 -0
  764. package/references/agents/ai-response.md +45 -0
  765. package/references/agents/ai-status.md +45 -0
  766. package/references/agents/chat-thread.md +45 -0
  767. package/references/agents/comment-thread.md +45 -0
  768. package/references/agents/json-viewer.md +45 -0
  769. package/references/agents/matrix-orb.md +43 -0
  770. package/references/agents/text-stream.md +44 -0
  771. package/references/agents/thinking-orb.md +43 -0
  772. package/references/agents/web-search.md +44 -0
  773. package/references/blocks/active-sessions.md +45 -0
  774. package/references/blocks/activity-feed.md +45 -0
  775. package/references/blocks/activity-heatmap.md +44 -0
  776. package/references/blocks/advanced-data-table.md +45 -0
  777. package/references/blocks/analytics-dashboard.md +43 -0
  778. package/references/blocks/art-gallery.md +44 -0
  779. package/references/blocks/bar-chart.md +44 -0
  780. package/references/blocks/blog-grid.md +45 -0
  781. package/references/blocks/brush-chart.md +44 -0
  782. package/references/blocks/changelog-feed.md +47 -0
  783. package/references/blocks/chat.md +45 -0
  784. package/references/blocks/comparison-table.md +45 -0
  785. package/references/blocks/cta-section.md +45 -0
  786. package/references/blocks/dashboard-shell.md +50 -0
  787. package/references/blocks/empty-states.md +44 -0
  788. package/references/blocks/family-drawer.md +46 -0
  789. package/references/blocks/faq.md +44 -0
  790. package/references/blocks/footer.md +43 -0
  791. package/references/blocks/form.md +45 -0
  792. package/references/blocks/hero-section.md +43 -0
  793. package/references/blocks/hook-sidebar.md +45 -0
  794. package/references/blocks/line-chart.md +44 -0
  795. package/references/blocks/login-centered.md +45 -0
  796. package/references/blocks/logo-marquee.md +44 -0
  797. package/references/blocks/newsletter-signup.md +46 -0
  798. package/references/blocks/notification-center.md +46 -0
  799. package/references/blocks/page-header.md +47 -0
  800. package/references/blocks/plan-comparison.md +45 -0
  801. package/references/blocks/pricing.md +45 -0
  802. package/references/blocks/product-tour.md +46 -0
  803. package/references/blocks/proximity-sidebar.md +44 -0
  804. package/references/blocks/rail-toc.md +44 -0
  805. package/references/blocks/scroll-progress.md +44 -0
  806. package/references/blocks/sidebar-stackbits.md +45 -0
  807. package/references/blocks/sign-in.md +45 -0
  808. package/references/blocks/site-header.md +46 -0
  809. package/references/blocks/slope-chart.md +44 -0
  810. package/references/blocks/sortable-data-table.md +45 -0
  811. package/references/blocks/stats-band.md +44 -0
  812. package/references/blocks/status-bars.md +45 -0
  813. package/references/blocks/step-player.md +45 -0
  814. package/references/blocks/task-list.md +44 -0
  815. package/references/blocks/waffle-chart.md +44 -0
  816. package/references/component-preview-contract.md +42 -0
  817. package/references/craft/airport-matrix-clock.md +44 -0
  818. package/references/craft/animated-counter.md +44 -0
  819. package/references/craft/batch-gesture-tray.md +45 -0
  820. package/references/craft/car-smoke-page-transition.md +44 -0
  821. package/references/craft/circular-orbit.md +44 -0
  822. package/references/craft/click-spark.md +45 -0
  823. package/references/craft/code-snippet-deck.md +45 -0
  824. package/references/craft/command.md +45 -0
  825. package/references/craft/cursor-follower.md +44 -0
  826. package/references/craft/delete-button.md +44 -0
  827. package/references/craft/density-lens.md +44 -0
  828. package/references/craft/dependency-trace.md +44 -0
  829. package/references/craft/depth-corridor.md +45 -0
  830. package/references/craft/discover-button.md +44 -0
  831. package/references/craft/drag-to-confirm.md +45 -0
  832. package/references/craft/draggable-marquee.md +45 -0
  833. package/references/craft/duration-picker.md +48 -0
  834. package/references/craft/emoji-reaction.md +47 -0
  835. package/references/craft/empty.md +44 -0
  836. package/references/craft/evil-eye.md +44 -0
  837. package/references/craft/expandable-data-row.md +45 -0
  838. package/references/craft/field.md +44 -0
  839. package/references/craft/file-input.md +46 -0
  840. package/references/craft/flip-text.md +43 -0
  841. package/references/craft/fluid-orb.md +43 -0
  842. package/references/craft/focus-mode.md +45 -0
  843. package/references/craft/folder-component.md +44 -0
  844. package/references/craft/github-activity.md +45 -0
  845. package/references/craft/glitch-text.md +44 -0
  846. package/references/craft/glyph-matrix.md +43 -0
  847. package/references/craft/golden-gate-404.md +45 -0
  848. package/references/craft/gooey-nav.md +45 -0
  849. package/references/craft/gravity-letters.md +43 -0
  850. package/references/craft/gravity-particle-burst.md +44 -0
  851. package/references/craft/grid-reveal.md +44 -0
  852. package/references/craft/hover-img.md +44 -0
  853. package/references/craft/input-otp.md +45 -0
  854. package/references/craft/interactive-area-chart.md +44 -0
  855. package/references/craft/interactive-timeline.md +45 -0
  856. package/references/craft/intro-loader.md +45 -0
  857. package/references/craft/ios-search-bar.md +45 -0
  858. package/references/craft/liquid-metal.md +45 -0
  859. package/references/craft/liquid-toggle.md +44 -0
  860. package/references/craft/loaders-gooey-blobs.md +44 -0
  861. package/references/craft/lock-input.md +44 -0
  862. package/references/craft/login.md +45 -0
  863. package/references/craft/meteors.md +43 -0
  864. package/references/craft/metric-hud.md +45 -0
  865. package/references/craft/morphing-blob.md +44 -0
  866. package/references/craft/morphing-dialog.md +45 -0
  867. package/references/craft/morphing-icon.md +44 -0
  868. package/references/craft/morphing-shape-loader.md +44 -0
  869. package/references/craft/nimbu-mirchi.md +44 -0
  870. package/references/craft/notification-bell.md +45 -0
  871. package/references/craft/orbital-loading-ring.md +43 -0
  872. package/references/craft/origin-dropdown.md +45 -0
  873. package/references/craft/particle-delete.md +44 -0
  874. package/references/craft/payment-receipt-printer.md +45 -0
  875. package/references/craft/payment-status.md +45 -0
  876. package/references/craft/recovery-ledger.md +45 -0
  877. package/references/craft/rocket-party-popper.md +45 -0
  878. package/references/craft/scroll-progress-nav.md +45 -0
  879. package/references/craft/scrollvelocitytext.md +43 -0
  880. package/references/craft/selection-basket.md +45 -0
  881. package/references/craft/sheet.md +46 -0
  882. package/references/craft/shooting-stars.md +44 -0
  883. package/references/craft/sidebar.md +45 -0
  884. package/references/craft/sign-up.md +45 -0
  885. package/references/craft/skeumorphic-music-card.md +45 -0
  886. package/references/craft/slide-pagination.md +45 -0
  887. package/references/craft/slot-text.md +44 -0
  888. package/references/craft/smart-comparison.md +45 -0
  889. package/references/craft/smooth-scroll.md +44 -0
  890. package/references/craft/speed-warp.md +43 -0
  891. package/references/craft/split-showcase.md +44 -0
  892. package/references/craft/spotlight-search.md +45 -0
  893. package/references/craft/stack-unfold-panel.md +45 -0
  894. package/references/craft/sticky-pages.md +43 -0
  895. package/references/craft/text-scramble-decoder.md +44 -0
  896. package/references/craft/toggle.md +45 -0
  897. package/references/craft/torque-dial.md +44 -0
  898. package/references/craft/v-prism.md +46 -0
  899. package/references/craft/voice-note.md +44 -0
  900. package/references/guides/better-accessibility.md +104 -0
  901. package/references/guides/better-colors.md +88 -0
  902. package/references/guides/better-interface.md +187 -0
  903. package/references/guides/better-layout.md +79 -0
  904. package/references/guides/better-typography.md +136 -0
  905. package/references/guides/better-ui.md +113 -0
  906. package/references/guides/better-writing.md +115 -0
  907. package/references/guides/dark-neutral-design-system.md +776 -0
  908. package/references/guides/fluid-interaction-conventions.md +30 -0
  909. package/references/guides/interface-review.md +142 -0
  910. package/references/guides/spring-motion-system.md +232 -0
  911. package/references/motion/accordion.md +46 -0
  912. package/references/motion/action-button.md +45 -0
  913. package/references/motion/alert.md +45 -0
  914. package/references/motion/avatar.md +44 -0
  915. package/references/motion/badge.md +44 -0
  916. package/references/motion/billing-toggle.md +44 -0
  917. package/references/motion/book-call-button.md +44 -0
  918. package/references/motion/branching-submenu.md +45 -0
  919. package/references/motion/button-group.md +46 -0
  920. package/references/motion/calendar.md +45 -0
  921. package/references/motion/card-stack.md +45 -0
  922. package/references/motion/card.md +46 -0
  923. package/references/motion/carousel.md +45 -0
  924. package/references/motion/chart.md +52 -0
  925. package/references/motion/chip-group.md +44 -0
  926. package/references/motion/command-menu.md +45 -0
  927. package/references/motion/confirm-morph.md +45 -0
  928. package/references/motion/cookie-consent.md +45 -0
  929. package/references/motion/countdown.md +44 -0
  930. package/references/motion/date-picker.md +45 -0
  931. package/references/motion/dialog.md +46 -0
  932. package/references/motion/dropdown-menu.md +46 -0
  933. package/references/motion/elastic-slider.md +44 -0
  934. package/references/motion/empty-state.md +45 -0
  935. package/references/motion/expandable-card.md +45 -0
  936. package/references/motion/expandable-text.md +45 -0
  937. package/references/motion/expanding-button-group.md +44 -0
  938. package/references/motion/expanding-search.md +46 -0
  939. package/references/motion/file-dropzone.md +45 -0
  940. package/references/motion/filter-toolbar.md +45 -0
  941. package/references/motion/floating-button-group.md +45 -0
  942. package/references/motion/gauge.md +44 -0
  943. package/references/motion/hamburger-menu.md +44 -0
  944. package/references/motion/hold-to-confirm.md +45 -0
  945. package/references/motion/icon-morph.md +44 -0
  946. package/references/motion/image-compare.md +45 -0
  947. package/references/motion/in-view-title.md +44 -0
  948. package/references/motion/inline-edit.md +45 -0
  949. package/references/motion/input-group.md +44 -0
  950. package/references/motion/item.md +45 -0
  951. package/references/motion/label.md +44 -0
  952. package/references/motion/liquid-ripple-button.md +45 -0
  953. package/references/motion/mac-os-folder-cards.md +45 -0
  954. package/references/motion/magnetic-button.md +44 -0
  955. package/references/motion/mention-input.md +45 -0
  956. package/references/motion/menubar.md +45 -0
  957. package/references/motion/money-card.md +46 -0
  958. package/references/motion/money-input.md +45 -0
  959. package/references/motion/morph-select.md +45 -0
  960. package/references/motion/morphing-button.md +45 -0
  961. package/references/motion/morphing-mega-menu.md +44 -0
  962. package/references/motion/navigation-menu.md +46 -0
  963. package/references/motion/neon-edge-button.md +44 -0
  964. package/references/motion/onboarding-checklist.md +45 -0
  965. package/references/motion/password-field.md +44 -0
  966. package/references/motion/password-strength.md +44 -0
  967. package/references/motion/peek-card.md +45 -0
  968. package/references/motion/profile-card.md +44 -0
  969. package/references/motion/progress.md +45 -0
  970. package/references/motion/radio-cards.md +44 -0
  971. package/references/motion/radio-group.md +44 -0
  972. package/references/motion/rainbow-button.md +43 -0
  973. package/references/motion/raised-button.md +45 -0
  974. package/references/motion/range-histogram-slider.md +44 -0
  975. package/references/motion/reactions.md +46 -0
  976. package/references/motion/resizable-panels.md +45 -0
  977. package/references/motion/resizable.md +45 -0
  978. package/references/motion/rich-text-editor.md +45 -0
  979. package/references/motion/ridgeline.md +44 -0
  980. package/references/motion/scroll-area.md +43 -0
  981. package/references/motion/scrub-input.md +45 -0
  982. package/references/motion/search-field.md +45 -0
  983. package/references/motion/separator.md +44 -0
  984. package/references/motion/shortcut-recorder.md +45 -0
  985. package/references/motion/signature-pad.md +45 -0
  986. package/references/motion/skeleton.md +44 -0
  987. package/references/motion/slider.md +44 -0
  988. package/references/motion/sonner.md +46 -0
  989. package/references/motion/sparkline.md +44 -0
  990. package/references/motion/spinner.md +44 -0
  991. package/references/motion/split-button.md +46 -0
  992. package/references/motion/story-card.md +44 -0
  993. package/references/motion/streamgraph.md +44 -0
  994. package/references/motion/swipe-actions.md +46 -0
  995. package/references/motion/tag-input.md +45 -0
  996. package/references/motion/text-reveal.md +43 -0
  997. package/references/motion/text-shimmer.md +44 -0
  998. package/references/motion/textarea.md +44 -0
  999. package/references/motion/theme-switch-eclipse.md +45 -0
  1000. package/references/motion/theme-switch-rise.md +45 -0
  1001. package/references/motion/theme-switch-split.md +45 -0
  1002. package/references/motion/theme-switch.md +45 -0
  1003. package/references/motion/time-picker.md +45 -0
  1004. package/references/motion/toast.md +45 -0
  1005. package/references/motion/treemap.md +44 -0
  1006. package/references/motion/undo-toast.md +45 -0
  1007. package/references/motion/usage-meter.md +45 -0
  1008. package/scripts/build_docs.py +209 -205
  1009. package/scripts/verify_skill.py +4 -4
  1010. package/test/test_installer.mjs +31 -1
  1011. package/test/test_preview_contracts.mjs +124 -0
@@ -0,0 +1,546 @@
1
+ "use client";
2
+
3
+ import { useCallback, useEffect, useId, useRef, useState, useSyncExternalStore } from "react";
4
+ import type { KeyboardEvent as ReactKeyboardEvent, PointerEvent as ReactPointerEvent, ReactNode } from "react";
5
+ import { AnimatePresence, animate, motion, useReducedMotion } from "motion/react";
6
+ import type { Transition } from "motion/react";
7
+ import { Check, Download, Eraser, Play, Redo2, Square, Undo2, X } from "lucide-react";
8
+ import { motionTokens } from "@/lib/motion-tokens";
9
+ import styles from "./signature-pad.module.css";
10
+
11
+ /** A sampled point: position in pad units, pen pressure between 0 and 1 (or -1 when the device has none), and ms since the stroke began. */
12
+ export interface InkPoint { x: number; y: number; p: number; t: number }
13
+ export type InkColor = "black" | "blue" | "violet";
14
+ export type InkWidth = "fine" | "medium" | "bold";
15
+ export interface InkStroke {
16
+ id: string;
17
+ points: InkPoint[];
18
+ color: InkColor;
19
+ width: InkWidth;
20
+ /** When the stroke began, in ms. Replay keeps the real rhythm between strokes. */
21
+ at: number;
22
+ }
23
+
24
+ export interface OutlineOptions {
25
+ /** Diameter of the stroke at half pressure, in pad units. */
26
+ size: number;
27
+ /** How much pressure changes the width, from 0 to 1. */
28
+ thinning?: number;
29
+ /** How far each point trails the pointer, from 0 to 1. Higher is smoother but lags more. */
30
+ streamline?: number;
31
+ /** Derive pressure from speed when the device reports none: fast is thin, slow is full. */
32
+ simulatePressure?: boolean;
33
+ /** Length over which the start and the end taper, in pad units. */
34
+ taperStart?: number;
35
+ taperEnd?: number;
36
+ /** False while the stroke is still being drawn, so the end does not taper yet. */
37
+ last?: boolean;
38
+ }
39
+
40
+ /** Pad coordinates. Strokes are stored in this space and scale with the pad. */
41
+ export const PAD_WIDTH = 600, PAD_HEIGHT = 260;
42
+
43
+ const INK: Record<InkColor, { label: string; export: string }> = {
44
+ black: { label: "Black ink", export: "#17171a" },
45
+ blue: { label: "Blue ink", export: "#1d3fae" },
46
+ violet: { label: "Violet ink", export: "#5b35c8" },
47
+ };
48
+ const WIDTHS: Record<InkWidth, { label: string; size: number }> = {
49
+ fine: { label: "Fine", size: 3.4 },
50
+ medium: { label: "Medium", size: 5.6 },
51
+ bold: { label: "Bold", size: 8.4 },
52
+ };
53
+ const COLORS = Object.keys(INK) as InkColor[];
54
+ const SIZES = Object.keys(WIDTHS) as InkWidth[];
55
+
56
+ type Vec = [number, number];
57
+ const add = (a: Vec, b: Vec): Vec => [a[0] + b[0], a[1] + b[1]];
58
+ const sub = (a: Vec, b: Vec): Vec => [a[0] - b[0], a[1] - b[1]];
59
+ const mul = (a: Vec, n: number): Vec => [a[0] * n, a[1] * n];
60
+ const lerp = (a: Vec, b: Vec, t: number): Vec => [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t];
61
+ const dist = (a: Vec, b: Vec) => Math.hypot(a[0] - b[0], a[1] - b[1]);
62
+ const norm = (a: Vec): Vec => { const l = Math.hypot(a[0], a[1]); return l ? [a[0] / l, a[1] / l] : [0, 0]; };
63
+ const perp = (a: Vec): Vec => [a[1], -a[0]];
64
+ const dot = (a: Vec, b: Vec) => a[0] * b[0] + a[1] * b[1];
65
+ const rotAround = (p: Vec, c: Vec, r: number): Vec => {
66
+ const s = Math.sin(r), co = Math.cos(r), px = p[0] - c[0], py = p[1] - c[1];
67
+ return [px * co - py * s + c[0], px * s + py * co + c[1]];
68
+ };
69
+ const easeOut = (t: number) => t * (2 - t);
70
+
71
+ /**
72
+ * Turns sampled points into the outline of a variable width stroke, in the spirit of perfect-freehand. Points are streamlined
73
+ * toward the pointer, width follows pen pressure or, for a mouse or finger, speed, the ends taper, sharp turns get round joins,
74
+ * and both ends get round caps. Returns the outline polygon; pass it to `outlineToPath` for SVG.
75
+ */
76
+ export function getStrokeOutline(input: InkPoint[], options: OutlineOptions): Vec[] {
77
+ const { size, thinning = .62, streamline = .42, simulatePressure = true, taperStart = 0, taperEnd = 0, last = true } = options;
78
+ const [head] = input;
79
+ if (!head) return [];
80
+ const usePen = !simulatePressure && input.some(point => point.p > 0);
81
+
82
+ // Streamline: each point eases toward the raw input, which removes jitter without a smoothing pass.
83
+ const pts: { at: Vec; pressure: number; length: number; vector: Vec }[] = [];
84
+ let prev: Vec = [head.x, head.y], length = 0;
85
+ const start = { at: prev, pressure: usePen ? head.p : .5, length: 0, vector: [1, 0] as Vec };
86
+ pts.push(start);
87
+ for (let i = 1; i < input.length; i++) {
88
+ const sample = input[i]!;
89
+ const raw: Vec = [sample.x, sample.y];
90
+ const at = i === input.length - 1 && last ? raw : lerp(prev, raw, 1 - streamline);
91
+ const d = dist(at, prev);
92
+ if (d < .4) continue;
93
+ length += d;
94
+ pts.push({ at, pressure: usePen ? sample.p : .5, length, vector: norm(sub(prev, at)) });
95
+ prev = at;
96
+ }
97
+ const second = pts[1];
98
+ if (second) start.vector = second.vector;
99
+ const total = length;
100
+
101
+ // A dot: a round mark sized by the first pressure.
102
+ if (pts.length === 1) {
103
+ const r = Math.max(.6, size * (.5 - thinning * (.5 - start.pressure)) * .9);
104
+ return Array.from({ length: 18 }, (_, i) => add(start.at, mul([Math.cos(i / 18 * Math.PI * 2), Math.sin(i / 18 * Math.PI * 2)], r)));
105
+ }
106
+
107
+ const left: Vec[] = [], right: Vec[] = [];
108
+ let pressure = start.pressure, prevVector = start.vector;
109
+ const radii: number[] = [];
110
+ for (let i = 0; i < pts.length; i++) {
111
+ const point = pts[i]!;
112
+ if (!usePen) {
113
+ // Speed thins the line: a long step between samples reads as a fast stroke.
114
+ const step = i === 0 ? 0 : dist(point.at, pts[i - 1]!.at);
115
+ const speed = Math.min(1, step / size);
116
+ const target = Math.min(1, 1 - speed);
117
+ pressure = Math.min(1, pressure + (target - pressure) * speed * .3);
118
+ } else {
119
+ pressure = point.pressure;
120
+ }
121
+ let radius = Math.max(.25, size * (.5 - thinning * (.5 - pressure)));
122
+ const ts = taperStart ? easeOut(Math.min(1, point.length / taperStart)) : 1;
123
+ const te = taperEnd && last ? easeOut(Math.min(1, (total - point.length) / taperEnd)) : 1;
124
+ radius = Math.max(.12 * size, radius * Math.min(ts, te));
125
+ radii.push(radius);
126
+
127
+ const next = pts[i + 1]?.vector ?? point.vector;
128
+ const offset = mul(perp(lerp(next, point.vector, .5)), radius);
129
+ // A sharp turn: sweep round the corner so the outline does not pinch.
130
+ if (i > 0 && i < pts.length - 1 && dot(point.vector, next) < -.2) {
131
+ const corner = mul(perp(prevVector), radius);
132
+ for (let t = 0; t <= 1; t += 1 / 12) {
133
+ left.push(rotAround(sub(point.at, corner), point.at, Math.PI * t));
134
+ right.push(rotAround(add(point.at, corner), point.at, -Math.PI * t));
135
+ }
136
+ } else {
137
+ left.push(sub(point.at, offset));
138
+ right.push(add(point.at, offset));
139
+ }
140
+ prevVector = point.vector;
141
+ }
142
+
143
+ // Round caps: half circles swept around the first and last points, on the side facing away from the stroke.
144
+ const cap = (center: Vec, from: Vec, to: Vec, away: Vec) => {
145
+ const out: Vec[] = [];
146
+ const r = dist(center, from), start = Math.atan2(from[1] - center[1], from[0] - center[0]);
147
+ const mid = start + Math.PI / 2;
148
+ const sign = dot([Math.cos(mid), Math.sin(mid)], away) >= 0 ? 1 : -1;
149
+ for (let k = 1; k < 12; k++) {
150
+ const a = start + sign * Math.PI * k / 12;
151
+ out.push([center[0] + Math.cos(a) * r, center[1] + Math.sin(a) * r]);
152
+ }
153
+ out.push(to);
154
+ return out;
155
+ };
156
+ const end = pts[pts.length - 1]!;
157
+ const endCap = cap(end.at, left[left.length - 1]!, right[right.length - 1]!, mul(end.vector, -1));
158
+ const startCap = cap(start.at, right[0]!, left[0]!, start.vector);
159
+ return [...left, ...endCap, ...right.reverse(), ...startCap];
160
+ }
161
+
162
+ const round = (value: number) => Math.round(value * 100) / 100;
163
+ /** Draws an outline as one smooth closed path, with quadratic curves through the midpoints of its edges. */
164
+ export function outlineToPath(points: Vec[]) {
165
+ if (points.length < 3) return "";
166
+ let d = `M${round(points[0]![0])} ${round(points[0]![1])} Q`;
167
+ for (let i = 0; i < points.length; i++) {
168
+ const [x0, y0] = points[i]!, [x1, y1] = points[(i + 1) % points.length]!;
169
+ d += `${round(x0)} ${round(y0)} ${round((x0 + x1) / 2)} ${round((y0 + y1) / 2)} `;
170
+ }
171
+ return `${d}Z`;
172
+ }
173
+
174
+ function strokeOptions(stroke: Pick<InkStroke, "width" | "points">, last: boolean): OutlineOptions {
175
+ const size = WIDTHS[stroke.width].size;
176
+ const pen = stroke.points.some(point => point.p > 0);
177
+ return { size, simulatePressure: !pen, taperStart: size * 1.5, taperEnd: pen ? 0 : size * 5, last };
178
+ }
179
+ /** The SVG path of a stroke, or of its first `upTo` ms while it is replayed. */
180
+ export function strokePath(stroke: Pick<InkStroke, "width" | "points">, upTo = Infinity) {
181
+ const all = stroke.points;
182
+ const done = upTo >= all[all.length - 1]!.t;
183
+ const points = done ? all : all.filter(point => point.t <= upTo);
184
+ return outlineToPath(getStrokeOutline(points, strokeOptions(stroke, done)));
185
+ }
186
+
187
+ /** Tight bounds of the ink, padded, for export. */
188
+ function inkBounds(strokes: InkStroke[]) {
189
+ let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
190
+ for (const stroke of strokes) for (const point of stroke.points) {
191
+ minX = Math.min(minX, point.x); minY = Math.min(minY, point.y); maxX = Math.max(maxX, point.x); maxY = Math.max(maxY, point.y);
192
+ }
193
+ const pad = 16;
194
+ return { x: Math.floor(minX - pad), y: Math.floor(minY - pad), width: Math.ceil(maxX - minX + pad * 2), height: Math.ceil(maxY - minY + pad * 2) };
195
+ }
196
+
197
+ /** A standalone SVG of the signature, cropped to the ink, with print ink colors. */
198
+ export function signatureToSvg(strokes: InkStroke[]) {
199
+ if (!strokes.length) return "";
200
+ const box = inkBounds(strokes);
201
+ const paths = strokes.map(stroke => `<path d="${strokePath(stroke)}" fill="${INK[stroke.color].export}"/>`).join("");
202
+ return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${box.x} ${box.y} ${box.width} ${box.height}" width="${box.width}" height="${box.height}">${paths}</svg>`;
203
+ }
204
+
205
+ /** A transparent PNG of the signature, cropped to the ink, at `scale` times pad resolution. */
206
+ export function signatureToPng(strokes: InkStroke[], scale = 3): Promise<Blob> {
207
+ return new Promise((resolve, reject) => {
208
+ if (!strokes.length) return reject(new Error("Nothing to export"));
209
+ const box = inkBounds(strokes);
210
+ const canvas = document.createElement("canvas");
211
+ canvas.width = box.width * scale; canvas.height = box.height * scale;
212
+ const ctx = canvas.getContext("2d");
213
+ if (!ctx) return reject(new Error("Canvas is unavailable"));
214
+ ctx.scale(scale, scale);
215
+ ctx.translate(-box.x, -box.y);
216
+ for (const stroke of strokes) { ctx.fillStyle = INK[stroke.color].export; ctx.fill(new Path2D(strokePath(stroke))); }
217
+ canvas.toBlob(blob => blob ? resolve(blob) : reject(new Error("Export failed")), "image/png");
218
+ });
219
+ }
220
+
221
+ function download(blob: Blob, name: string) {
222
+ const url = URL.createObjectURL(blob);
223
+ const link = document.createElement("a");
224
+ link.href = url; link.download = name;
225
+ document.body.appendChild(link); link.click(); link.remove();
226
+ window.setTimeout(() => URL.revokeObjectURL(url), 1000);
227
+ }
228
+
229
+ /**
230
+ * A signature field with real ink. Width follows pen pressure, or speed for a mouse or finger, and the ends taper like a nib
231
+ * lifting off. It keeps undo and redo, clears with a wipe across the pad, replays the signature in its original rhythm,
232
+ * and exports a cropped PNG or SVG. A "Sign here" hint rests on the baseline until the first stroke.
233
+ * Keyboard: Mod+Z undoes, Shift+Mod+Z or Mod+Y redoes, and Delete clears.
234
+ */
235
+ export interface SignaturePadProps {
236
+ /** Printed under the baseline, such as the signer's name. */
237
+ signer?: string;
238
+ /** Resting hint on the baseline before the first stroke. */
239
+ hint?: string;
240
+ defaultColor?: InkColor;
241
+ defaultWidth?: InkWidth;
242
+ /** Receives the strokes after every change. */
243
+ onChange?: (strokes: InkStroke[]) => void;
244
+ /** File name for exports, without extension. */
245
+ fileName?: string;
246
+ /** Accessible name of the drawing surface. */
247
+ label?: string;
248
+ className?: string;
249
+ }
250
+
251
+ /** `fresh` is the stroke just drawn: it is already on screen from the live path, so it appears without a fade. */
252
+ interface History { past: InkStroke[][]; present: InkStroke[]; future: InkStroke[][]; fresh: string | null }
253
+ type Saved = null | "png" | "svg" | "failed";
254
+
255
+ const { spring, duration, ease, blur } = motionTokens;
256
+ const subscribe = () => () => {};
257
+ function useReducedFlag() {
258
+ const hydrated = useSyncExternalStore(subscribe, () => true, () => false);
259
+ return !!useReducedMotion() && hydrated;
260
+ }
261
+
262
+ export function SignaturePad({ signer, hint = "Sign here", defaultColor = "black", defaultWidth = "medium", onChange, fileName = "signature", label = "Signature pad", className }: SignaturePadProps) {
263
+ const uid = useId().replace(/[^a-zA-Z0-9-]/g, "");
264
+ const reduced = useReducedFlag();
265
+ const [history, setHistory] = useState<History>({ past: [], present: [], future: [], fresh: null });
266
+ const [color, setColor] = useState<InkColor>(defaultColor);
267
+ const [width, setWidth] = useState<InkWidth>(defaultWidth);
268
+ const [drawing, setDrawing] = useState(false);
269
+ const [wiping, setWiping] = useState(false);
270
+ const [replay, setReplay] = useState<{ at: number; offsets: number[] } | null>(null);
271
+ const [saved, setSaved] = useState<Saved>(null);
272
+ const [status, setStatus] = useState("");
273
+
274
+ const padRef = useRef<HTMLDivElement>(null);
275
+ const inkRef = useRef<HTMLDivElement>(null);
276
+ const liveRef = useRef<SVGPathElement>(null);
277
+ const live = useRef<{ id: number; stroke: InkStroke; stamp: number } | null>(null);
278
+ const replayFrame = useRef(0);
279
+ const savedTimer = useRef(0);
280
+ const wipeAnimation = useRef<{ stop: () => void; complete: () => void } | null>(null);
281
+ const counter = useRef(0);
282
+ const onChangeRef = useRef(onChange);
283
+ useEffect(() => { onChangeRef.current = onChange; });
284
+
285
+ const strokes = history.present;
286
+ const empty = strokes.length === 0;
287
+ const replaying = replay !== null;
288
+
289
+ useEffect(() => { onChangeRef.current?.(strokes); }, [strokes]);
290
+ useEffect(() => () => { cancelAnimationFrame(replayFrame.current); window.clearTimeout(savedTimer.current); }, []);
291
+
292
+ const commit = useCallback((next: InkStroke[], fresh: string | null = null) => {
293
+ setHistory(current => ({ past: [...current.past, current.present].slice(-60), present: next, future: [], fresh }));
294
+ }, []);
295
+
296
+ const stopReplay = useCallback(() => { cancelAnimationFrame(replayFrame.current); setReplay(null); }, []);
297
+ /** A wipe in flight completes at once, so whatever comes next starts from a clear pad. */
298
+ const settleWipe = useCallback(() => { wipeAnimation.current?.complete(); }, []);
299
+
300
+ function toPad(event: { clientX: number; clientY: number }) {
301
+ const box = padRef.current!.getBoundingClientRect();
302
+ return { x: (event.clientX - box.left) / box.width * PAD_WIDTH, y: (event.clientY - box.top) / box.height * PAD_HEIGHT };
303
+ }
304
+
305
+ function onPointerDown(event: ReactPointerEvent<HTMLDivElement>) {
306
+ if (live.current || (event.pointerType === "mouse" && event.button !== 0)) return;
307
+ event.preventDefault();
308
+ settleWipe();
309
+ if (replaying) stopReplay();
310
+ padRef.current?.focus({ preventScroll: true });
311
+ event.currentTarget.setPointerCapture(event.pointerId);
312
+ const { x, y } = toPad(event);
313
+ const now = event.nativeEvent.timeStamp;
314
+ counter.current += 1;
315
+ const pen = event.pointerType === "pen" && event.pressure > 0;
316
+ live.current = { id: event.pointerId, stamp: event.nativeEvent.timeStamp, stroke: { id: `${uid}-${counter.current}`, color, width, at: now, points: [{ x, y, p: pen ? event.pressure : -1, t: 0 }] } };
317
+ setDrawing(true);
318
+ paintLive();
319
+ }
320
+ function onPointerMove(event: ReactPointerEvent<HTMLDivElement>) {
321
+ const current = live.current;
322
+ if (!current || current.id !== event.pointerId) return;
323
+ const samples = typeof event.nativeEvent.getCoalescedEvents === "function" ? event.nativeEvent.getCoalescedEvents() : [];
324
+ const list = samples.length ? samples : [event.nativeEvent];
325
+ for (const sample of list) {
326
+ const { x, y } = toPad(sample);
327
+ const pen = sample.pointerType === "pen" && sample.pressure > 0;
328
+ current.stroke.points.push({ x, y, p: pen ? sample.pressure : -1, t: Math.max(current.stroke.points[current.stroke.points.length - 1]!.t, sample.timeStamp - current.stamp) });
329
+ }
330
+ paintLive();
331
+ }
332
+ function onPointerUp(event: ReactPointerEvent<HTMLDivElement>) {
333
+ const current = live.current;
334
+ if (!current || current.id !== event.pointerId) return;
335
+ live.current = null;
336
+ commit([...strokes, current.stroke], current.stroke.id);
337
+ liveRef.current?.setAttribute("d", "");
338
+ setDrawing(false);
339
+ setStatus(`Stroke added. ${strokes.length + 1} in the signature.`);
340
+ }
341
+ function paintLive() {
342
+ const current = live.current;
343
+ if (!current || !liveRef.current) return;
344
+ liveRef.current.setAttribute("d", outlineToPath(getStrokeOutline(current.stroke.points, strokeOptions(current.stroke, false))));
345
+ }
346
+
347
+ function undo() {
348
+ if (!history.past.length || live.current) return;
349
+ settleWipe(); stopReplay();
350
+ setHistory(current => current.past.length ? { past: current.past.slice(0, -1), present: current.past[current.past.length - 1]!, future: [current.present, ...current.future], fresh: null } : current);
351
+ setStatus("Undone");
352
+ }
353
+ function redo() {
354
+ if (!history.future.length || live.current) return;
355
+ settleWipe(); stopReplay();
356
+ setHistory(current => current.future.length ? { past: [...current.past, current.present], present: current.future[0]!, future: current.future.slice(1), fresh: null } : current);
357
+ setStatus("Redone");
358
+ }
359
+
360
+ function clear() {
361
+ if (empty || wiping || live.current) return;
362
+ stopReplay();
363
+ const node = inkRef.current;
364
+ const finish = () => {
365
+ wipeAnimation.current = null;
366
+ commit([]); setWiping(false); setStatus("Signature cleared. Undo brings it back.");
367
+ // Lift the clip only once the wiped strokes have left, so they never flash back for a frame.
368
+ if (node) requestAnimationFrame(() => requestAnimationFrame(() => { node.style.clipPath = ""; }));
369
+ };
370
+ if (!node || reduced) { finish(); return; }
371
+ setWiping(true);
372
+ // The ink is cut away behind a squeegee edge that sweeps across the pad; the edge itself is drawn by the sweep element.
373
+ const controls = animate(node, { clipPath: ["inset(0% 0% 0% 0%)", "inset(0% 0% 0% 100%)"] }, { duration: .56, ease: [...ease.inOut] });
374
+ wipeAnimation.current = { stop: () => controls.stop(), complete: () => { controls.complete(); } };
375
+ controls.then(finish);
376
+ }
377
+
378
+ function toggleReplay() {
379
+ if (replaying) { stopReplay(); setStatus("Replay stopped"); return; }
380
+ if (empty || live.current) return;
381
+ settleWipe();
382
+ // Build a timeline: each stroke keeps its own rhythm, and pauses between strokes are capped so the replay never stalls.
383
+ const offsets: number[] = [];
384
+ let cursor = 0;
385
+ strokes.forEach((stroke, index) => {
386
+ if (index > 0) {
387
+ const previous = strokes[index - 1]!;
388
+ const gap = stroke.at - (previous.at + previous.points[previous.points.length - 1]!.t);
389
+ cursor += Math.min(260, Math.max(90, gap));
390
+ }
391
+ offsets.push(cursor);
392
+ cursor += stroke.points[stroke.points.length - 1]!.t;
393
+ });
394
+ const speed = Math.max(1, cursor / 3200);
395
+ const total = cursor + 120;
396
+ const begin = performance.now();
397
+ const tick = (now: number) => {
398
+ const at = (now - begin) * speed;
399
+ if (at >= total) { setReplay(null); setStatus("Replay finished"); return; }
400
+ setReplay({ at, offsets });
401
+ replayFrame.current = requestAnimationFrame(tick);
402
+ };
403
+ setReplay({ at: 0, offsets });
404
+ setStatus("Replaying signature");
405
+ replayFrame.current = requestAnimationFrame(tick);
406
+ }
407
+ async function save(kind: "png" | "svg") {
408
+ if (empty) return;
409
+ window.clearTimeout(savedTimer.current);
410
+ try {
411
+ const blob = kind === "svg" ? new Blob([signatureToSvg(strokes)], { type: "image/svg+xml" }) : await signatureToPng(strokes);
412
+ download(blob, `${fileName}.${kind}`);
413
+ setSaved(kind);
414
+ setStatus(`Saved ${fileName}.${kind}`);
415
+ } catch {
416
+ setSaved("failed");
417
+ setStatus("Export failed. Try again.");
418
+ }
419
+ savedTimer.current = window.setTimeout(() => setSaved(null), 1800);
420
+ }
421
+
422
+ function onKeyDown(event: ReactKeyboardEvent<HTMLDivElement>) {
423
+ const mod = event.metaKey || event.ctrlKey;
424
+ const key = event.key.toLowerCase();
425
+ if (mod && key === "z") { event.preventDefault(); if (event.shiftKey) redo(); else undo(); }
426
+ else if (mod && key === "y") { event.preventDefault(); redo(); }
427
+ else if (!mod && (event.key === "Delete" || event.key === "Backspace") && event.currentTarget === event.target) { event.preventDefault(); clear(); }
428
+ else if (event.key === "Escape" && replaying) { stopReplay(); }
429
+ }
430
+
431
+ // During replay each stroke shows only the part drawn so far, and the nib rides its newest point.
432
+ let nib: InkPoint | null = null, nibColor: InkColor = color;
433
+ const visible: { stroke: InkStroke; d: string | null }[] = [];
434
+ for (let index = 0; index < strokes.length; index++) {
435
+ const stroke = strokes[index]!;
436
+ if (replay === null) { visible.push({ stroke, d: null }); continue; }
437
+ const local = replay.at - (replay.offsets[index] ?? 0);
438
+ const lastT = stroke.points[stroke.points.length - 1]!.t;
439
+ if (local < 0) { visible.push({ stroke, d: "" }); continue; }
440
+ if (local >= lastT) { visible.push({ stroke, d: null }); continue; }
441
+ nib = stroke.points.findLast(point => point.t <= local) ?? stroke.points[0]!;
442
+ nibColor = stroke.color;
443
+ visible.push({ stroke, d: strokePath(stroke, local) });
444
+ }
445
+ const showHint = empty && !drawing && !wiping;
446
+ const hintHidden = reduced ? { opacity: 0 } : { opacity: 0, y: 6, scale: .97, filter: `blur(${blur.soft}px)` };
447
+ const t: Transition = reduced ? { duration: duration.instant } : spring.snappy;
448
+
449
+ return <div className={[styles.root, className].filter(Boolean).join(" ")} data-ink={color}>
450
+ <div ref={padRef} className={styles.pad} tabIndex={0} role="img" aria-roledescription="signature pad"
451
+ aria-label={`${label}. ${empty ? "Empty." : `${strokes.length} ${strokes.length === 1 ? "stroke" : "strokes"}.`} Draw with a pointer, pen, or finger.`}
452
+ aria-describedby={`${uid}-keys`} data-drawing={drawing ? "" : undefined}
453
+ onPointerDown={onPointerDown} onPointerMove={onPointerMove} onPointerUp={onPointerUp} onPointerCancel={onPointerUp} onKeyDown={onKeyDown}>
454
+ <div className={styles.guide} aria-hidden="true">
455
+ <X className={styles.mark} size={14} strokeWidth={1.75} />
456
+ <span className={styles.baseline} />
457
+ {signer && <span className={styles.signer}>{signer}</span>}
458
+ <AnimatePresence initial={false}>
459
+ {showHint && <motion.span key="hint" className={styles.hint} initial={hintHidden} animate={{ opacity: 1, y: 0, scale: 1, filter: "blur(0px)" }}
460
+ exit={{ ...hintHidden, transition: { duration: duration.fast, ease: [...ease.standard] } }}
461
+ transition={reduced ? { duration: duration.instant } : { duration: duration.standard, ease: [...ease.enter] }}>{hint}</motion.span>}
462
+ </AnimatePresence>
463
+ </div>
464
+ <div ref={inkRef} className={styles.ink}>
465
+ <svg viewBox={`0 0 ${PAD_WIDTH} ${PAD_HEIGHT}`} preserveAspectRatio="none" aria-hidden="true">
466
+ <AnimatePresence initial={false}>
467
+ {visible.map(({ stroke, d }) => <motion.path key={stroke.id} className={styles.stroke} data-color={stroke.color}
468
+ d={d ?? strokePath(stroke)} initial={history.fresh === stroke.id ? false : { opacity: 0 }} animate={{ opacity: 1 }}
469
+ exit={{ opacity: 0, transition: { duration: wiping ? 0 : duration.standard, ease: [...ease.standard] } }}
470
+ transition={{ duration: duration.standard, ease: [...ease.standard] }} />)}
471
+ </AnimatePresence>
472
+ <path ref={liveRef} className={styles.stroke} data-color={color} />
473
+ {nib && <circle className={styles.nib} data-color={nibColor} cx={nib.x} cy={nib.y} r={WIDTHS[width].size * .9} />}
474
+ </svg>
475
+ </div>
476
+ {wiping && <motion.span className={styles.sweep} aria-hidden="true" initial={{ x: "0%", opacity: 0 }} animate={{ x: "100%", opacity: [0, 1, 1, 0] }}
477
+ transition={{ duration: .56, ease: [...ease.inOut], opacity: { duration: .56, times: [0, .12, .85, 1] } }} />}
478
+ </div>
479
+
480
+ <div className={styles.toolbar}>
481
+ <div className={styles.group}>
482
+ <Choice label="Ink color" options={COLORS} value={color} onChange={next => { setColor(next); setStatus(`${INK[next].label} selected`); }} layoutId={`${uid}-color`} reduced={reduced}
483
+ render={option => <span className={styles.swatch} data-color={option} />} name={option => INK[option].label} />
484
+ <span className={styles.divider} aria-hidden="true" />
485
+ <Choice label="Stroke width" options={SIZES} value={width} onChange={next => { setWidth(next); setStatus(`${WIDTHS[next].label} nib selected`); }} layoutId={`${uid}-width`} reduced={reduced}
486
+ render={option => <span className={styles.weight} style={{ width: WIDTHS[option].size + 2, height: WIDTHS[option].size + 2 }} />} name={option => WIDTHS[option].label} />
487
+ </div>
488
+ <div className={styles.group}>
489
+ <IconButton label="Undo" onClick={undo} disabled={!history.past.length || wiping}><Undo2 size={18} strokeWidth={1.75} aria-hidden="true" /></IconButton>
490
+ <IconButton label="Redo" onClick={redo} disabled={!history.future.length || wiping}><Redo2 size={18} strokeWidth={1.75} aria-hidden="true" /></IconButton>
491
+ <IconButton label={replaying ? "Stop replay" : "Replay signature"} onClick={toggleReplay} disabled={empty || wiping} pressed={replaying}>
492
+ <AnimatePresence mode="popLayout" initial={false}>
493
+ <motion.span key={replaying ? "stop" : "play"} className={styles.swap} initial={{ opacity: 0, scale: .6 }} animate={{ opacity: 1, scale: 1 }} exit={{ opacity: 0, scale: .6 }} transition={t}>
494
+ {replaying ? <Square size={15} strokeWidth={1.75} aria-hidden="true" /> : <Play size={17} strokeWidth={1.75} aria-hidden="true" />}
495
+ </motion.span>
496
+ </AnimatePresence>
497
+ </IconButton>
498
+ <IconButton label="Clear signature" onClick={clear} disabled={empty || wiping}><Eraser size={18} strokeWidth={1.75} aria-hidden="true" /></IconButton>
499
+ </div>
500
+ </div>
501
+
502
+ <div className={styles.exports}>
503
+ <span className={styles.exportLabel}>Save as</span>
504
+ {(["png", "svg"] as const).map(kind => <button key={kind} type="button" className={styles.export} onClick={() => save(kind)} disabled={empty}
505
+ aria-label={`Download ${kind.toUpperCase()}`}>
506
+ <AnimatePresence mode="popLayout" initial={false}>
507
+ <motion.span key={saved === kind ? "done" : saved === "failed" ? "failed" : "idle"} className={styles.exportContent}
508
+ initial={{ opacity: 0, y: reduced ? 0 : 4, filter: reduced ? "blur(0px)" : `blur(${blur.subtle}px)` }} animate={{ opacity: 1, y: 0, filter: "blur(0px)" }}
509
+ exit={{ opacity: 0, y: reduced ? 0 : -4, transition: { duration: duration.instant } }} transition={reduced ? { duration: duration.instant } : { duration: duration.fast, ease: [...ease.enter] }}>
510
+ {saved === kind ? <><Check size={15} strokeWidth={1.75} aria-hidden="true" />Saved</> : <><Download size={15} strokeWidth={1.75} aria-hidden="true" />{kind.toUpperCase()}</>}
511
+ </motion.span>
512
+ </AnimatePresence>
513
+ </button>)}
514
+ </div>
515
+ <p id={`${uid}-keys`} className={styles.srOnly}>Press Control or Command Z to undo, add Shift to redo, and Delete to clear.</p>
516
+ <p className={styles.srOnly} role="status" aria-live="polite">{status}</p>
517
+ </div>;
518
+ }
519
+
520
+ function IconButton({ label, onClick, disabled, pressed, children }: { label: string; onClick: () => void; disabled?: boolean; pressed?: boolean; children: ReactNode }) {
521
+ return <button type="button" className={styles.iconButton} aria-label={label} title={label} onClick={onClick} disabled={disabled} aria-pressed={pressed}>{children}</button>;
522
+ }
523
+
524
+ /** A compact radio group with a highlight that glides to the chosen option. Arrow keys move the choice. */
525
+ function Choice<T extends string>({ label, options, value, onChange, render, name, layoutId, reduced }: {
526
+ label: string; options: T[]; value: T; onChange: (value: T) => void; render: (option: T) => ReactNode; name: (option: T) => string; layoutId: string; reduced: boolean;
527
+ }) {
528
+ const refs = useRef<(HTMLButtonElement | null)[]>([]);
529
+ function onKeyDown(event: ReactKeyboardEvent<HTMLDivElement>) {
530
+ const step = event.key === "ArrowRight" || event.key === "ArrowDown" ? 1 : event.key === "ArrowLeft" || event.key === "ArrowUp" ? -1 : 0;
531
+ if (!step) return;
532
+ event.preventDefault();
533
+ const index = (options.indexOf(value) + step + options.length) % options.length;
534
+ onChange(options[index]!);
535
+ refs.current[index]?.focus();
536
+ }
537
+ return <div className={styles.choice} role="radiogroup" aria-label={label} onKeyDown={onKeyDown}>
538
+ {options.map((option, index) => <button key={option} ref={node => { refs.current[index] = node; }} type="button" role="radio" aria-checked={option === value}
539
+ aria-label={name(option)} title={name(option)} tabIndex={option === value ? 0 : -1} className={styles.option} onClick={() => onChange(option)}>
540
+ {option === value && <motion.span layoutId={layoutId} className={styles.selected} transition={reduced ? { duration: 0 } : spring.morph} />}
541
+ {render(option)}
542
+ </button>)}
543
+ </div>;
544
+ }
545
+
546
+ export default SignaturePad;
@@ -0,0 +1,11 @@
1
+ .root { display: flex; width: 100%; min-width: 0; align-items: flex-start; gap: var(--space-4); }
2
+ /* A calm, finite pulse: each block dims a beat after the one above it, then rests after about 20 seconds. */
3
+ .avatar, .line { display: block; flex: 0 0 auto; border-radius: var(--radius-control); background: color-mix(in oklab, var(--border-strong) 38%, var(--surface)); animation: skeleton-pulse 1.8s var(--ease-in-out) calc(var(--index, 0) * 90ms) 11 both; }
4
+ .avatar { width: var(--control-height-md); height: var(--control-height-md); border-radius: var(--radius-pill); }
5
+ .lines { display: grid; flex: 1; gap: var(--space-3); padding-top: var(--space-1); }
6
+ .line { width: 100%; height: var(--space-3); }
7
+ .line:first-child { width: 48%; height: var(--space-4); }
8
+ .line:last-child { width: 72%; }
9
+ .frame { position: relative; display: flow-root; }
10
+ @keyframes skeleton-pulse { 0%, 100% { opacity: 1; } 50% { opacity: .52; } }
11
+ @media (prefers-reduced-motion: reduce) { .avatar, .line { animation: none; } }
@@ -0,0 +1,70 @@
1
+ "use client";
2
+
3
+ import { useEffect, useLayoutEffect, useRef, type CSSProperties, type ReactNode } from "react";
4
+ import { AnimatePresence, animate, motion, useMotionValue, useReducedMotion, type AnimationPlaybackControls } from "motion/react";
5
+ import { motionTokens } from "@/lib/motion-tokens";
6
+ import styles from "./skeleton.module.css";
7
+
8
+ export interface SkeletonProps {
9
+ label?: string;
10
+ lines?: number;
11
+ avatar?: boolean;
12
+ className?: string;
13
+ /** Content to reveal once loading finishes. With children, the placeholder crossfades into them. */
14
+ children?: ReactNode;
15
+ /** Keeps the placeholder visible while true. Only used together with children. */
16
+ loading?: boolean;
17
+ }
18
+
19
+ /** Follows its content height. After `morphKey` changes, the height springs from the old size to the new one and then returns to auto, so passive reflows (a resize, a font swap) follow instantly. It clips only while moving, so focus rings stay visible at rest. */
20
+ function HeightFrame({ className, busy, reduce, children }: { className?: string; busy: boolean; reduce: boolean | null; children: ReactNode }) {
21
+ const frame = useRef<HTMLDivElement>(null);
22
+ const content = useRef<HTMLDivElement>(null);
23
+ const height = useMotionValue<number | "auto">("auto");
24
+ const changedAt = useRef(0);
25
+ useLayoutEffect(() => { changedAt.current = performance.now(); }, [busy]);
26
+ useEffect(() => {
27
+ const node = content.current;
28
+ if (!node || typeof ResizeObserver === "undefined") return;
29
+ let last: number | undefined;
30
+ let controls: AnimationPlaybackControls | undefined;
31
+ const settle = () => { height.jump("auto"); if (frame.current) Object.assign(frame.current.style, { overflow: "", height: "auto" }); };
32
+ const observer = new ResizeObserver(([entry]) => {
33
+ if (!entry) return;
34
+ const next = entry.borderBoxSize?.[0]?.blockSize ?? node.offsetHeight;
35
+ const current = height.get();
36
+ const from = typeof current === "number" ? current : last;
37
+ last = next;
38
+ controls?.stop();
39
+ if (reduce || from === undefined || from === next || performance.now() - changedAt.current > 120) return settle();
40
+ // Pin the old height before this frame paints, then spring to the new one.
41
+ if (frame.current) Object.assign(frame.current.style, { overflow: "hidden", height: `${from}px` });
42
+ controls = animate(height, [from, next], { ...motionTokens.spring.smooth, onComplete: settle });
43
+ });
44
+ observer.observe(node);
45
+ return () => { observer.disconnect(); controls?.stop(); };
46
+ }, [height, reduce]);
47
+ return <motion.div ref={frame} className={className} aria-busy={busy} style={{ height }}>
48
+ <div ref={content} className={styles.frame}>{children}</div>
49
+ </motion.div>;
50
+ }
51
+
52
+ export function Skeleton({ label = "Loading content", lines = 3, avatar = false, className, children, loading = true }: SkeletonProps) {
53
+ const reduce = useReducedMotion();
54
+ const count = Math.min(Math.max(Math.floor(lines), 1), 6);
55
+ // Each block pulses a beat after the one above it, so the wait reads as one calm wave.
56
+ const placeholder = (extra?: string) => <div className={[styles.root, extra].filter(Boolean).join(" ")} role="status" aria-label={label} aria-busy="true">
57
+ {avatar && <span className={styles.avatar} aria-hidden="true" />}
58
+ <span className={styles.lines} aria-hidden="true">{Array.from({ length: count }, (_, index) => <span className={styles.line} style={{ "--index": index + (avatar ? 1 : 0) } as CSSProperties} key={index} />)}</span>
59
+ </div>;
60
+ if (children === undefined) return placeholder(className);
61
+ return <HeightFrame className={className} busy={loading} reduce={reduce}>
62
+ <AnimatePresence mode="popLayout" initial={false}>
63
+ {loading
64
+ ? <motion.div key="placeholder" initial={{ opacity: 0 }} animate={{ opacity: 1 }} transition={{ duration: reduce ? motionTokens.duration.instant : motionTokens.duration.fast, ease: [...motionTokens.ease.standard] }} exit={{ opacity: 0, transition: { duration: reduce ? motionTokens.duration.instant : motionTokens.duration.fast } }}>{placeholder()}</motion.div>
65
+ : <motion.div key="content" initial={reduce ? { opacity: 0 } : { opacity: 0, y: 4 }} animate={{ opacity: 1, y: 0 }} exit={{ opacity: 0, transition: { duration: reduce ? motionTokens.duration.instant : motionTokens.duration.fast } }} transition={{ duration: reduce ? motionTokens.duration.instant : motionTokens.duration.standard, ease: [...motionTokens.ease.enter] }}>{children}</motion.div>}
66
+ </AnimatePresence>
67
+ </HeightFrame>;
68
+ }
69
+
70
+ export default Skeleton;