motion-ui-skill 2.1.0 → 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,372 @@
1
+ "use client";
2
+
3
+ import { useEffect, useId, useLayoutEffect, useRef, useState, useSyncExternalStore } from "react";
4
+ import type { KeyboardEvent, PointerEvent as ReactPointerEvent, ReactNode } from "react";
5
+ import { AnimatePresence, animate, motion, useMotionValue, useReducedMotion, useSpring, useTransform } from "motion/react";
6
+ import type { MotionValue } from "motion/react";
7
+ import { Check, RotateCcw, X } from "lucide-react";
8
+ import { motionTokens } from "@/lib/motion-tokens";
9
+ import styles from "./card-stack.module.css";
10
+
11
+ export type CardDecision = "left" | "right";
12
+
13
+ /**
14
+ * A deck of cards reviewed one at a time: drag or flick the top card left or right, or use the buttons and arrow keys.
15
+ * Use it for quick, one-by-one triage where each item deserves a moment of attention: shortlisting destinations, candidates, or design options.
16
+ * Use a list or table when people need to compare items side by side.
17
+ */
18
+ export interface CardStackProps<T> {
19
+ items: T[];
20
+ getKey: (item: T) => string;
21
+ /** A short name for the card, used in its accessible label and announcements, such as "Lisbon". */
22
+ getLabel: (item: T) => string;
23
+ renderCard: (item: T) => ReactNode;
24
+ onDecide?: (item: T, decision: CardDecision) => void;
25
+ onUndo?: (item: T, decision: CardDecision) => void;
26
+ onReset?: () => void;
27
+ /** Action names for each side, used on the buttons and the stamps that appear while dragging. */
28
+ labels?: { left: string; right: string };
29
+ /** Past tense of each action for announcements, such as "skipped" and "shortlisted". */
30
+ outcomes?: { left: string; right: string };
31
+ /** Accessible name for the stack. */
32
+ label?: string;
33
+ /** Shown once every card has been decided. Receives a function that brings all cards back. */
34
+ renderEmpty?: (reset: () => void) => ReactNode;
35
+ className?: string;
36
+ }
37
+
38
+ type Point = { x: number; y: number };
39
+ type Exit = Point & { tilt: number };
40
+ type Return = Exit & { delay: number };
41
+
42
+ /** Cards rendered in the stack. The last one waits invisibly one step behind and fades in as it rises. */
43
+ const VISIBLE = 4;
44
+ /** How far each card behind peeks out below the one in front, and how much smaller it is. */
45
+ const PEEK = 12;
46
+ const SHRINK = .05;
47
+ /** How far the cards behind rise while the top card is dragged away, in stack steps. */
48
+ const LIFT = .4;
49
+ /** Drag distance at which the cards behind have fully risen. */
50
+ const LIFT_DISTANCE = 160;
51
+ /** Degrees of rotation per pixel of horizontal travel. */
52
+ const ROTATE = .065;
53
+ /** A release faster than this (px/s) throws the card even when it has only moved a little. */
54
+ const FLICK = 500;
55
+
56
+ /** Vertical travel is not a decision, so past a small free zone it resists like a rubber band. */
57
+ const FREE_Y = 48;
58
+ const STRETCH_Y = 140;
59
+
60
+ const noop = () => () => {};
61
+ const resistY = (raw: number) => {
62
+ const distance = Math.abs(raw);
63
+ return distance <= FREE_Y ? raw : Math.sign(raw) * (FREE_Y + (1 - 1 / ((distance - FREE_Y) * .55 / STRETCH_Y + 1)) * STRETCH_Y);
64
+ };
65
+ const unresistY = (shown: number) => {
66
+ const distance = Math.abs(shown);
67
+ if (distance <= FREE_Y) return shown;
68
+ const stretch = Math.min(distance - FREE_Y, STRETCH_Y - 1);
69
+ return Math.sign(shown) * (FREE_Y + (1 / (1 - stretch / STRETCH_Y) - 1) * STRETCH_Y / .55);
70
+ };
71
+ const clampUnit = (value: number) => Math.min(1, Math.max(0, value));
72
+ const throwSpring = { type: "spring", visualDuration: .5, bounce: 0 } as const;
73
+ const fadeOut = { duration: .22, delay: .12, ease: [...motionTokens.ease.standard] } as const;
74
+ const reducedFade = { duration: .15, ease: "linear" } as const;
75
+
76
+ function velocityOf(samples: { t: number; x: number; y: number }[], now: number): Point {
77
+ const recent = samples.filter(sample => now - sample.t <= 80);
78
+ const first = recent[0], last = recent[recent.length - 1];
79
+ if (!first || !last || first === last || now - last.t > 60) return { x: 0, y: 0 };
80
+ const seconds = (last.t - first.t) / 1000;
81
+ return { x: (last.x - first.x) / seconds, y: (last.y - first.y) / seconds };
82
+ }
83
+
84
+ interface CardProps {
85
+ id: string;
86
+ depth: number;
87
+ decision: CardDecision | null;
88
+ returnFrom?: Return;
89
+ interactive: boolean;
90
+ zIndex: number;
91
+ label: string;
92
+ labels: { left: string; right: string };
93
+ lift: MotionValue<number>;
94
+ reduced: boolean;
95
+ fling: (id: string) => Point | undefined;
96
+ onRelease: (id: string, offset: Point, velocity: Point, width: number) => boolean;
97
+ onThrown: (id: string, exit: Exit) => void;
98
+ onGone: (id: string) => void;
99
+ children: ReactNode;
100
+ }
101
+
102
+ function StackCard({ id, depth, decision, returnFrom, interactive, zIndex, label, labels, lift, reduced, fling, onRelease, onThrown, onGone, children }: CardProps) {
103
+ const cardRef = useRef<HTMLDivElement>(null);
104
+ // A card brought back by undo starts where it left the screen; with reduced motion it simply fades in at home.
105
+ const travel = returnFrom && !reduced ? returnFrom : undefined;
106
+ const x = useMotionValue(travel?.x ?? 0);
107
+ const y = useMotionValue(travel?.y ?? 0);
108
+ const tilt = useMotionValue(travel?.tilt ?? 1);
109
+ const opacity = useMotionValue(returnFrom ? 0 : 1);
110
+ const rotate = useTransform([x, tilt], ([offset = 0, sign = 0]: number[]) => offset * ROTATE * sign);
111
+ // Depth springs toward its slot; while the top card is dragged away, the cards behind already start to rise.
112
+ const depthTarget = useTransform(lift, value => depth - (depth > 0 ? value * LIFT : 0));
113
+ const depthSpring = useSpring(depthTarget, motionTokens.spring.smooth);
114
+ const shown = reduced ? depthTarget : depthSpring;
115
+ const scale = useTransform(shown, value => 1 - value * SHRINK);
116
+ const lower = useTransform(shown, value => value * PEEK);
117
+ const presence = useTransform(shown, [VISIBLE - 2, VISIBLE - 1], [1, 0]);
118
+ const shade = useTransform(shown, [0, 2], [0, 1]);
119
+ const keep = useTransform(x, [16, 96], [0, 1]);
120
+ const pass = useTransform(x, [-96, -16], [1, 0]);
121
+ const drag = useRef<{ ox: number; oy: number; samples: { t: number; x: number; y: number }[] } | null>(null);
122
+ const settled = useRef(!returnFrom);
123
+ const wasDecided = useRef(false);
124
+ // A card flying home from undo or start over leaves the stack alone: the cards behind make room in one motion instead of
125
+ // pausing half-risen until it lands. Grabbing it mid-flight hands the stack back to the drag.
126
+ const homing = useRef(false);
127
+
128
+ // The top card reports how far it has travelled, so the stack behind responds to the drag and the throw.
129
+ useEffect(() => {
130
+ if (!interactive) return;
131
+ const update = () => { if (!homing.current) lift.set(clampUnit(Math.hypot(x.get(), y.get() * .5) / LIFT_DISTANCE)); };
132
+ const offX = x.on("change", update), offY = y.on("change", update);
133
+ return () => { offX(); offY(); };
134
+ }, [interactive, lift, x, y]);
135
+
136
+ useLayoutEffect(() => {
137
+ if (decision) {
138
+ // A key or button can decide the card mid-drag; the throw takes over from the finger.
139
+ drag.current = null;
140
+ homing.current = false;
141
+ cardRef.current?.removeAttribute("data-dragging");
142
+ wasDecided.current = true;
143
+ const direction = decision === "right" ? 1 : -1;
144
+ const width = cardRef.current?.offsetWidth ?? 320;
145
+ const cx = x.get(), cy = y.get();
146
+ // Buttons and keys throw with a default flick; a drag keeps the finger's velocity.
147
+ const velocity = fling(id) ?? { x: direction * 900, y: -120 };
148
+ const speed = Math.hypot(velocity.x, velocity.y);
149
+ // Leave along the flick when it heads the chosen way, otherwise along the drag, otherwise straight out.
150
+ let ux = velocity.x, uy = velocity.y;
151
+ if (speed < 200 || Math.sign(ux) !== direction) { ux = Math.abs(cx) > 8 ? cx : direction; uy = Math.abs(cx) > 8 ? cy * .5 : -.12; }
152
+ const length = Math.hypot(ux, uy) || 1;
153
+ ux /= length; uy /= length;
154
+ if (Math.abs(ux) < .45) { ux = direction * .45; uy = Math.sign(uy || -1) * Math.sqrt(1 - .45 * .45); }
155
+ // Far enough to clear a typical preview or card column; the fade finishes before the spring does.
156
+ const reach = width * 1.6;
157
+ const exit = { x: cx + ux * reach, y: cy + uy * reach, tilt: tilt.get() };
158
+ onThrown(id, exit);
159
+ if (reduced) { animate(opacity, 0, { ...reducedFade, onComplete: () => onGone(id) }); return; }
160
+ animate(x, exit.x, { ...throwSpring, velocity: velocity.x });
161
+ animate(y, exit.y, { ...throwSpring, velocity: velocity.y });
162
+ animate(opacity, 0, { ...fadeOut, onComplete: () => onGone(id) });
163
+ return;
164
+ }
165
+ // Undo, or a first mount from where the card left: come back from there, catching any flight in progress.
166
+ if (!wasDecided.current && settled.current) return;
167
+ wasDecided.current = false;
168
+ settled.current = true;
169
+ const delay = returnFrom?.delay ?? 0;
170
+ if (reduced) { x.jump(0); y.jump(0); animate(opacity, 1, { ...reducedFade, delay }); return; }
171
+ homing.current = true;
172
+ animate(x, 0, { ...motionTokens.spring.smooth, delay, onComplete: () => { homing.current = false; } });
173
+ animate(y, 0, { ...motionTokens.spring.smooth, delay });
174
+ animate(opacity, 1, { duration: motionTokens.duration.fast, delay, ease: [...motionTokens.ease.enter] });
175
+ // Only the decision drives this effect; the return position is read once at that moment.
176
+ // eslint-disable-next-line react-hooks/exhaustive-deps
177
+ }, [decision]);
178
+
179
+ function down(event: ReactPointerEvent<HTMLDivElement>) {
180
+ if (!interactive || event.button !== 0 || !event.isPrimary) return;
181
+ if (event.target instanceof Element && event.target.closest("button, a, input, select, textarea, [role='button']")) return;
182
+ x.stop(); y.stop();
183
+ homing.current = false;
184
+ // Grabbing the top half tips the card the way the hand moves; grabbing the bottom half tips it the other way.
185
+ if (Math.abs(x.get()) < 2) {
186
+ const rect = event.currentTarget.getBoundingClientRect();
187
+ tilt.set(event.clientY < rect.top + rect.height / 2 ? 1 : -1);
188
+ }
189
+ drag.current = { ox: event.clientX - x.get(), oy: event.clientY - unresistY(y.get()), samples: [{ t: event.timeStamp, x: event.clientX, y: event.clientY }] };
190
+ event.currentTarget.setPointerCapture(event.pointerId);
191
+ event.currentTarget.setAttribute("data-dragging", "");
192
+ }
193
+ function move(event: ReactPointerEvent<HTMLDivElement>) {
194
+ const state = drag.current;
195
+ if (!state || !interactive) return;
196
+ x.set(event.clientX - state.ox);
197
+ y.set(resistY(event.clientY - state.oy));
198
+ state.samples.push({ t: event.timeStamp, x: event.clientX, y: event.clientY });
199
+ if (state.samples.length > 12) state.samples.shift();
200
+ }
201
+ function up(event: ReactPointerEvent<HTMLDivElement>) {
202
+ const state = drag.current;
203
+ drag.current = null;
204
+ event.currentTarget.removeAttribute("data-dragging");
205
+ if (event.currentTarget.hasPointerCapture(event.pointerId)) event.currentTarget.releasePointerCapture(event.pointerId);
206
+ if (!state || !interactive) return;
207
+ const velocity = event.type === "pointercancel" ? { x: 0, y: 0 } : velocityOf(state.samples, event.timeStamp);
208
+ if (onRelease(id, { x: x.get(), y: y.get() }, velocity, event.currentTarget.offsetWidth)) return;
209
+ // Below the threshold the card springs home, keeping the release velocity so it settles instead of stopping dead.
210
+ if (reduced) { x.jump(0); y.jump(0); return; }
211
+ animate(x, 0, { ...motionTokens.spring.morph, velocity: velocity.x });
212
+ animate(y, 0, { ...motionTokens.spring.morph, velocity: velocity.y });
213
+ }
214
+
215
+ const flying = decision !== null;
216
+ return <motion.div className={styles.slot} style={{ zIndex, scale, y: lower, opacity: presence }} aria-hidden={interactive ? undefined : true} inert={!interactive}>
217
+ <motion.div
218
+ ref={cardRef}
219
+ className={styles.card}
220
+ style={{ x, y, rotate, opacity }}
221
+ data-top={interactive ? "" : undefined}
222
+ data-flying={flying ? "" : undefined}
223
+ role={interactive ? "group" : undefined}
224
+ aria-label={interactive ? label : undefined}
225
+ onPointerDown={down}
226
+ onPointerMove={move}
227
+ onPointerUp={up}
228
+ onPointerCancel={up}
229
+ >
230
+ <div className={styles.face}>
231
+ {children}
232
+ <motion.span className={styles.shade} style={{ opacity: shade }} aria-hidden="true" />
233
+ </div>
234
+ <motion.span className={styles.stamp} data-side="right" style={{ opacity: keep }} aria-hidden="true"><Check size={16} strokeWidth={2} />{labels.right}</motion.span>
235
+ <motion.span className={styles.stamp} data-side="left" style={{ opacity: pass }} aria-hidden="true"><X size={16} strokeWidth={2} />{labels.left}</motion.span>
236
+ </motion.div>
237
+ </motion.div>;
238
+ }
239
+
240
+ function Control({ children, onClick, disabled, reduced, tone }: { children: ReactNode; onClick: () => void; disabled: boolean; reduced: boolean; tone?: "primary" | "quiet" }) {
241
+ // aria-disabled keeps focus on the button when the stack runs out, instead of dropping it to the page.
242
+ return <motion.button type="button" className={styles.control} data-tone={tone} aria-disabled={disabled || undefined} onClick={() => { if (!disabled) onClick(); }} whileTap={{ scale: reduced || disabled ? 1 : .97 }} transition={motionTokens.spring.snappy}>{children}</motion.button>;
243
+ }
244
+
245
+ /** Renders a custom empty state; the reset handler travels as a prop so render never touches the stack's refs. */
246
+ function EmptySlot({ render, onReset }: { render: (reset: () => void) => ReactNode; onReset: () => void }) { return <>{render(onReset)}</>; }
247
+
248
+ export function CardStack<T>({ items, getKey, getLabel, renderCard, onDecide, onUndo, onReset, labels = { left: "Pass", right: "Keep" }, outcomes, label = "Cards", renderEmpty, className }: CardStackProps<T>) {
249
+ const hydrated = useSyncExternalStore(noop, () => true, () => false);
250
+ const reduced = !!useReducedMotion() && hydrated;
251
+ const hintId = useId();
252
+ const [position, setPosition] = useState(0);
253
+ const [history, setHistory] = useState<{ key: string; decision: CardDecision }[]>([]);
254
+ const [flying, setFlying] = useState<string[]>([]);
255
+ const [returning, setReturning] = useState<Record<string, Return>>({});
256
+ const [message, setMessage] = useState("");
257
+ const lift = useMotionValue(0);
258
+ // Where each thrown card left the screen, so undo and start over can bring it back from there. Only those handlers read it,
259
+ // so it lives in a ref: recording an exit must not re-render the stack in the very frame the throw starts.
260
+ const exits = useRef<Record<string, Exit>>({});
261
+ const flings = useRef(new Map<string, Point>());
262
+ const top = items[position];
263
+ const remaining = Math.max(0, items.length - position);
264
+
265
+ function decide(decision: CardDecision) {
266
+ if (!top) return;
267
+ const key = getKey(top);
268
+ lift.set(0);
269
+ setPosition(position + 1);
270
+ setHistory([...history, { key, decision }]);
271
+ setFlying(current => [...current, key]);
272
+ setReturning({});
273
+ const left = remaining - 1;
274
+ setMessage(`${getLabel(top)}${outcomes ? ` ${outcomes[decision]}` : `: ${labels[decision]}`}. ${left ? `${left} left.` : "All cards reviewed."}`);
275
+ onDecide?.(top, decision);
276
+ }
277
+
278
+ function undo() {
279
+ const last = history[history.length - 1];
280
+ const item = last && items.find(entry => getKey(entry) === last.key);
281
+ if (!last || !item) return;
282
+ const exit = exits.current[last.key];
283
+ setPosition(position - 1);
284
+ setHistory(history.slice(0, -1));
285
+ setFlying(current => current.filter(key => key !== last.key));
286
+ setReturning(exit ? { [last.key]: { ...exit, delay: 0 } } : {});
287
+ setMessage(`${getLabel(item)} restored.`);
288
+ onUndo?.(item, last.decision);
289
+ }
290
+
291
+ function reset() {
292
+ if (!history.length) return;
293
+ // The deck deals itself back: the card that will sit deepest returns first, the top card last.
294
+ const count = Math.min(VISIBLE, items.length);
295
+ const back: Record<string, Return> = {};
296
+ items.slice(0, count).forEach((item, index) => {
297
+ const key = getKey(item), exit = exits.current[key];
298
+ if (exit && index < position) back[key] = { ...exit, delay: (count - 1 - index) * .06 };
299
+ });
300
+ setPosition(0);
301
+ setHistory([]);
302
+ setFlying([]);
303
+ setReturning(back);
304
+ setMessage("All cards are back in the stack.");
305
+ onReset?.();
306
+ }
307
+
308
+ function release(key: string, offset: Point, velocity: Point, width: number) {
309
+ const direction = Math.sign(offset.x);
310
+ if (!direction || !top || getKey(top) !== key) return false;
311
+ const flick = Math.abs(velocity.x) > FLICK && Math.sign(velocity.x) === direction && Math.abs(offset.x) > 12;
312
+ const far = Math.abs(offset.x) > Math.min(width * .35, 140) && !(Math.sign(velocity.x) === -direction && Math.abs(velocity.x) > 300);
313
+ if (!flick && !far) return false;
314
+ flings.current.set(key, velocity);
315
+ decide(direction > 0 ? "right" : "left");
316
+ return true;
317
+ }
318
+
319
+ function key(event: KeyboardEvent<HTMLDivElement>) {
320
+ if (event.target !== event.currentTarget) return;
321
+ if (event.key === "ArrowLeft" || event.key === "ArrowRight") { event.preventDefault(); decide(event.key === "ArrowRight" ? "right" : "left"); }
322
+ else if (event.key === "Backspace" || ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "z")) { event.preventDefault(); undo(); }
323
+ }
324
+
325
+ const decided = new Map(history.map(entry => [entry.key, entry.decision]));
326
+ const windowKeys = new Set(items.slice(position, position + VISIBLE).map(getKey));
327
+ const rendered = items.filter(item => windowKeys.has(getKey(item)) || flying.includes(getKey(item)));
328
+ const empty = position >= items.length && flying.length === 0;
329
+
330
+ return <div className={[styles.root, className].filter(Boolean).join(" ")}>
331
+ <div className={styles.stage} role="group" aria-roledescription="card stack" aria-label={label} aria-describedby={hintId} tabIndex={0} onKeyDown={key}>
332
+ {rendered.map(item => {
333
+ const id = getKey(item), index = items.indexOf(item), decision = decided.get(id) ?? null;
334
+ const depth = decision ? 0 : index - position;
335
+ return <StackCard
336
+ key={id}
337
+ id={id}
338
+ depth={depth}
339
+ decision={decision}
340
+ returnFrom={returning[id]}
341
+ interactive={!decision && depth === 0}
342
+ zIndex={decision ? 20 + flying.indexOf(id) : VISIBLE - depth}
343
+ label={`${getLabel(item)}, ${index + 1} of ${items.length}`}
344
+ labels={labels}
345
+ lift={lift}
346
+ reduced={reduced}
347
+ fling={cardKey => { const velocity = flings.current.get(cardKey); flings.current.delete(cardKey); return velocity; }}
348
+ onRelease={release}
349
+ onThrown={(cardKey, exit) => { exits.current[cardKey] = exit; }}
350
+ onGone={cardKey => setFlying(current => current.filter(entry => entry !== cardKey))}
351
+ >{renderCard(item)}</StackCard>;
352
+ })}
353
+ <AnimatePresence initial={false}>
354
+ {empty && <motion.div key="empty" className={styles.empty} initial={reduced ? { opacity: 0 } : { opacity: 0, y: 8, filter: `blur(${motionTokens.blur.soft}px)` }} animate={{ opacity: 1, y: 0, filter: "blur(0px)" }} exit={{ opacity: 0, transition: { duration: motionTokens.duration.instant } }} transition={reduced ? reducedFade : { duration: motionTokens.duration.standard, ease: [...motionTokens.ease.enter] }}>
355
+ {renderEmpty ? <EmptySlot render={renderEmpty} onReset={reset} /> : <>
356
+ <p className={styles.emptyTitle}>All cards reviewed</p>
357
+ <button type="button" className={styles.control} onClick={reset}><RotateCcw size={16} strokeWidth={1.75} aria-hidden="true" />Start over</button>
358
+ </>}
359
+ </motion.div>}
360
+ </AnimatePresence>
361
+ </div>
362
+ <div className={styles.controls}>
363
+ <Control onClick={() => decide("left")} disabled={!top} reduced={reduced}><X size={16} strokeWidth={1.75} aria-hidden="true" />{labels.left}</Control>
364
+ <Control onClick={undo} disabled={!history.length} reduced={reduced} tone="quiet"><RotateCcw size={16} strokeWidth={1.75} aria-hidden="true" /><span className={styles.controlLabel}>Undo</span></Control>
365
+ <Control onClick={() => decide("right")} disabled={!top} reduced={reduced} tone="primary"><Check size={16} strokeWidth={1.75} aria-hidden="true" />{labels.right}</Control>
366
+ </div>
367
+ <p id={hintId} className={styles.srOnly}>Drag the top card, or use the left and right arrow keys to {labels.left.toLowerCase()} or {labels.right.toLowerCase()} it. Backspace undoes the last decision.</p>
368
+ <p className={styles.srOnly} role="status" aria-live="polite">{message}</p>
369
+ </div>;
370
+ }
371
+
372
+ export default CardStack;
@@ -0,0 +1,51 @@
1
+ /* Isolation keeps the rounded clip on the media while the card lifts on its own layer (Safari drops it otherwise).
2
+ Motion drives the lift and the quick look morph, so transform never gets a CSS transition here. */
3
+ .card { position: relative; min-width: 0; overflow: hidden; isolation: isolate; border: 1px solid var(--border); border-radius: var(--radius-panel); background: var(--surface); color: var(--foreground); transition: border-color var(--duration-fast) var(--ease-standard), box-shadow var(--duration-standard) var(--ease-standard); }
4
+ /* A pointed-at card floats a little, so the shadow arrives with the lift. Touch and pen never lift. */
5
+ .card[data-hover] { border-color: var(--border-strong); box-shadow: var(--shadow-raised); }
6
+ .card:has(.trigger:focus-visible) { border-color: var(--border-strong); }
7
+ .media { position: relative; overflow: hidden; background: var(--surface-muted); }
8
+ .zoom { display: grid; min-height: 112px; place-items: center; }
9
+ .content { padding: var(--space-5); }
10
+ /* Fit-content width keeps the title's box the shape of its text, so it scales evenly when it grows into the quick look. */
11
+ .title { width: fit-content; max-width: 100%; margin: 0; font-size: var(--text-lg); font-weight: 500; letter-spacing: var(--tracking-body); line-height: 1.3; text-wrap: balance; }
12
+ .trigger { padding: 0; border: 0; background: none; color: inherit; font: inherit; letter-spacing: inherit; text-align: inherit; cursor: pointer; -webkit-tap-highlight-color: transparent; }
13
+ /* The title's hit area stretches over the whole card, so pointing anywhere opens the quick look while the action stays on top. */
14
+ .trigger::after { content: ""; position: absolute; inset: 0; }
15
+ .trigger:focus-visible { outline: none; }
16
+ .description { max-width: 34ch; margin: var(--space-2) 0 0; color: var(--text-secondary); font-size: var(--text-sm); line-height: var(--leading-body); text-wrap: pretty; }
17
+ .footer { display: flex; align-items: center; justify-content: space-between; gap: var(--space-3); margin-top: var(--space-5); }
18
+ .byline { display: flex; flex: 1 1 auto; align-items: center; gap: var(--space-3); min-width: 0; }
19
+ .avatar { display: grid; flex: none; width: var(--space-8); height: var(--space-8); overflow: hidden; border-radius: var(--radius-pill); background: var(--surface-muted); }
20
+ .avatar > * { width: 100%; height: 100%; object-fit: cover; }
21
+ /* A shrinkable column, so a narrow footer truncates the byline instead of sliding it under the action. */
22
+ .bylineText { display: grid; grid-template-columns: minmax(0, 1fr); min-width: 0; font-size: var(--text-xs); line-height: var(--leading-body); }
23
+ .meta { overflow: hidden; color: var(--foreground); font-weight: 500; text-overflow: ellipsis; white-space: nowrap; }
24
+ .status { position: relative; overflow: clip visible; color: var(--text-muted); white-space: nowrap; font-variant-numeric: tabular-nums; }
25
+ /* The line clips sideways only, so a status too long for its column ends in an ellipsis while its words still rise in unclipped. */
26
+ .roll { position: relative; display: block; }
27
+ .line { display: block; overflow: clip visible; text-overflow: ellipsis; }
28
+ .word { display: inline-block; white-space: pre; }
29
+ .srOnly { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
30
+ .action { position: relative; z-index: 1; display: flex; flex: none; flex-wrap: wrap; gap: var(--space-3); }
31
+
32
+ .overlay { position: fixed; inset: 0; z-index: 50; background: oklch(10% 0 0 / .46); -webkit-backdrop-filter: blur(7px); backdrop-filter: blur(7px); }
33
+ /* Centered with auto margins, so transform stays free for the morph. */
34
+ .panel { position: fixed; inset: 0; z-index: 51; width: min(calc(100vw - var(--space-8)), 30rem); height: fit-content; max-height: calc(100dvh - var(--space-8)); margin: auto; overflow: hidden auto; overscroll-behavior: contain; border: 1px solid var(--border); border-radius: var(--radius-surface); background: var(--surface-raised); color: var(--foreground); box-shadow: var(--shadow-floating); transition: background-color var(--duration-standard) var(--ease-standard), box-shadow var(--duration-standard) var(--ease-standard); }
35
+ .panel:focus { outline: none; }
36
+ /* Closing: the panel takes the card's box and look, so it lands exactly where the card sits and hands back without a seam. */
37
+ .panel[data-returning] { inset: auto; top: var(--landing-top); left: var(--landing-left); width: var(--landing-width); height: var(--landing-height); max-height: none; margin: 0; overflow: hidden; border-color: var(--border); background: var(--surface); box-shadow: none; pointer-events: none; }
38
+ .panel[data-returning] .content { padding: var(--space-5); }
39
+ .panel[data-returning] .title { font-size: var(--text-lg); }
40
+ .panel .content { padding: var(--space-6); }
41
+ .panel .title { font-size: var(--text-xl); }
42
+ .panel .description { max-width: var(--card-measure, 34ch); }
43
+ /* The slot carries the entrance, so the button's own press answers instantly. */
44
+ .closeSlot { position: absolute; top: var(--space-4); right: var(--space-4); z-index: 2; display: grid; }
45
+ .close { display: grid; width: var(--space-8); height: var(--space-8); place-items: center; padding: 0; border: 1px solid color-mix(in oklab, var(--border) 70%, transparent); border-radius: var(--radius-pill); background: color-mix(in oklab, var(--surface-raised) 74%, transparent); -webkit-backdrop-filter: blur(12px); backdrop-filter: blur(12px); color: var(--foreground); cursor: pointer; -webkit-tap-highlight-color: transparent; transition: background-color var(--duration-fast) var(--ease-standard); }
46
+ @media (hover: hover) and (pointer: fine) { .close:hover { background: var(--surface-raised); } }
47
+ .details { margin-top: var(--space-6); padding-top: var(--space-5); border-top: 1px solid var(--border); color: var(--text-secondary); font-size: var(--text-sm); line-height: var(--leading-body); }
48
+
49
+ @media (prefers-reduced-motion: reduce) {
50
+ .card, .close { transition-duration: var(--duration-instant); }
51
+ }
@@ -0,0 +1,201 @@
1
+ "use client";
2
+
3
+ import { usePortalTheme } from "@/lib/portal";
4
+
5
+ import * as Dialog from "@radix-ui/react-dialog";
6
+ import { useCallback, useEffect, useId, useLayoutEffect, useRef, useState } from "react";
7
+ import type { CSSProperties, HTMLAttributes, ReactNode } from "react";
8
+ import { AnimatePresence, LayoutGroup, motion, useReducedMotion } from "motion/react";
9
+ import type { HTMLMotionProps, MotionProps, Transition, Variants } from "motion/react";
10
+ import { X } from "lucide-react";
11
+ import { motionTokens } from "@/lib/motion-tokens";
12
+ import styles from "./card.module.css";
13
+
14
+ export interface CardProps extends HTMLAttributes<HTMLElement> {
15
+ title: string;
16
+ description?: string;
17
+ media?: ReactNode;
18
+ action?: ReactNode;
19
+ /** A small leading visual for the footer, such as the owner's avatar. */
20
+ avatar?: ReactNode;
21
+ /** Who the card belongs to, such as the owner's name. */
22
+ meta?: ReactNode;
23
+ /** A short status under the meta, such as "Updated 2 hours ago". Changed words rise in and are announced politely. */
24
+ status?: string;
25
+ /** Content for a quick look. When set, the whole card opens and grows into a larger view; Escape or the close control morphs it back. */
26
+ details?: ReactNode;
27
+ open?: boolean;
28
+ defaultOpen?: boolean;
29
+ onOpenChange?: (open: boolean) => void;
30
+ }
31
+
32
+ type Side = "card" | "panel";
33
+ type Geometry = { card?: number; panel?: number; measure?: number };
34
+ type Landing = { top: number; left: number; width: number; height: number };
35
+
36
+ const { blur, duration, ease, spring, stagger } = motionTokens;
37
+ /** One critically damped spring carries the surface both ways, so it never overshoots and can reverse mid-flight. Closing is a touch quicker. */
38
+ const grow: Transition = { ...spring.smooth, visualDuration: .3 };
39
+ const settle: Transition = { ...spring.smooth, visualDuration: .26 };
40
+ const RETURN_MS = 300;
41
+ const fade: Transition = { duration: duration.instant };
42
+ /** The photo drifts in slowly while the card is pointed at, and eases back a little faster. */
43
+ const ZOOM = 1.04;
44
+ const zoomIn: Transition = { duration: duration.considered * 2, ease: [...ease.standard] };
45
+ const zoomOut: Transition = { duration: duration.considered, ease: [...ease.standard] };
46
+ /** Quick look extras arrive once the surface has mostly grown, so they never ride the stretch. */
47
+ const reveal: Transition = { delay: duration.instant, duration: duration.standard, ease: [...ease.enter] };
48
+ const closeIn: Transition = { delay: duration.instant, duration: duration.fast, ease: [...ease.enter] };
49
+
50
+ /** A new status replaces the whole line: the old one lifts away quickly while the new words rise in one after another. */
51
+ const lineMotion: Variants = {
52
+ enter: {},
53
+ center: {},
54
+ exit: { opacity: 0, y: "-.3em", filter: `blur(${blur.subtle}px)`, transition: { duration: duration.fast, ease: [...ease.standard] } },
55
+ };
56
+ const wordMotion: Variants = {
57
+ enter: { opacity: 0, y: ".3em", filter: `blur(${blur.soft}px)` },
58
+ center: (order: number) => ({ opacity: 1, y: 0, filter: "blur(0px)", transition: { duration: duration.standard, ease: [...ease.enter], delay: order * stagger.word } }),
59
+ };
60
+
61
+ function Status({ text, reduced }: { text: string; reduced: boolean }) {
62
+ return <span className={styles.status} role="status">
63
+ <span className={styles.srOnly}>{text}</span>
64
+ <span className={styles.roll} aria-hidden="true"><AnimatePresence mode="popLayout" initial={false}>
65
+ <motion.span key={text} className={styles.line} variants={lineMotion} initial={reduced ? false : "enter"} animate="center" exit={reduced ? undefined : "exit"}>
66
+ {text.split(/(\s+)/).map((part, index) => <motion.span key={index} className={styles.word} custom={index / 2} variants={wordMotion}>{part}</motion.span>)}
67
+ </motion.span>
68
+ </AnimatePresence></span>
69
+ </span>;
70
+ }
71
+
72
+ /** Motion only scale-corrects pixel radii, so token radii are read back in pixels for the morph. */
73
+ function px(node: Element, value: string) {
74
+ const amount = parseFloat(value);
75
+ if (!Number.isFinite(amount)) return undefined;
76
+ return value.trim().endsWith("rem") ? amount * parseFloat(getComputedStyle(node.ownerDocument.documentElement).fontSize) : amount;
77
+ }
78
+
79
+ export function Card({ title, description, media, action, avatar, meta, status, details, open: openProp, defaultOpen = false, onOpenChange, children, className, style, ...props }: CardProps) {
80
+ const portalTheme = usePortalTheme();
81
+ const reduced = useReducedMotion() ?? false;
82
+ const group = useId();
83
+ const cardRef = useRef<HTMLElement>(null);
84
+ const descriptionRef = useRef<HTMLParagraphElement>(null);
85
+ const [uncontrolled, setUncontrolled] = useState(defaultOpen);
86
+ const [hovered, setHovered] = useState(false);
87
+ const [geometry, setGeometry] = useState<Geometry>({});
88
+ /** Where the quick look lands when it closes: the card's box on screen. The panel travels there above the page, then hands back to the card. */
89
+ const [landing, setLanding] = useState<Landing | null>(null);
90
+ const open = details ? openProp ?? uncontrolled : false;
91
+ const morph = Boolean(details) && !reduced;
92
+ const returning = !open && landing !== null;
93
+ const hasDescription = Boolean(description);
94
+ const setOpen = useCallback((next: boolean) => { if (openProp === undefined) setUncontrolled(next); onOpenChange?.(next); }, [openProp, onOpenChange]);
95
+
96
+ // The quick look keeps the card's line length, so the description never rewraps while it travels.
97
+ useEffect(() => {
98
+ const node = cardRef.current, text = descriptionRef.current;
99
+ if (!morph || !node || typeof ResizeObserver === "undefined") return;
100
+ const observer = new ResizeObserver(() => {
101
+ const computed = getComputedStyle(node);
102
+ const radius = px(node, computed.borderTopLeftRadius), surface = px(node, computed.getPropertyValue("--radius-surface")), measure = text?.offsetWidth || undefined;
103
+ setGeometry(current => current.card !== undefined && current.measure === measure ? current : { card: current.card ?? radius, panel: current.panel ?? surface, measure });
104
+ });
105
+ observer.observe(node);
106
+ if (text) observer.observe(text);
107
+ return () => observer.disconnect();
108
+ }, [morph, hasDescription]);
109
+
110
+ // Closing keeps the quick look mounted and sends it back to the card's box, so the surface never drops behind the page or a clipped preview.
111
+ const wasOpen = useRef(open);
112
+ useLayoutEffect(() => {
113
+ const closed = wasOpen.current && !open;
114
+ wasOpen.current = open;
115
+ const node = cardRef.current;
116
+ if (open) setLanding(null); // eslint-disable-line react-hooks/set-state-in-effect -- reopening mid-return cancels the landing
117
+ else if (closed && morph && node) {
118
+ const box = node.getBoundingClientRect();
119
+ setLanding({ top: box.top, left: box.left, width: box.width, height: box.height });
120
+ }
121
+ }, [open, morph]);
122
+ // Once the surface has visually landed, the card takes over. Any last sub-pixel of travel carries on in the card itself, so the handoff has no seam.
123
+ useEffect(() => {
124
+ if (!returning) return;
125
+ const timer = window.setTimeout(() => setLanding(null), RETURN_MS);
126
+ return () => window.clearTimeout(timer);
127
+ }, [returning]);
128
+
129
+ /** The same pieces live in the card and in the quick look; a shared id lets each one travel between them.
130
+ Crossfade is off: the arriving piece takes over at full opacity and the other hides, so one solid surface moves instead of two translucent copies. */
131
+ const shared = (id: string, side: Side, layout: true | "position" = true): MotionProps => morph ? { layoutId: id, layout, layoutCrossfade: false, layoutDependency: side === "card" ? open : returning ? "return" : "panel", transition: { layout: side === "card" ? settle : grow } } : {};
132
+
133
+ const footer = (side: Side) => avatar || meta || status || action ? <div className={styles.footer}>
134
+ {avatar || meta || status ? <motion.div className={styles.byline} {...shared("byline", side, "position")}>
135
+ {avatar ? <span className={styles.avatar}>{avatar}</span> : null}
136
+ <span className={styles.bylineText}>{meta ? <span className={styles.meta}>{meta}</span> : null}{status ? <Status text={status} reduced={reduced} /> : null}</span>
137
+ </motion.div> : null}
138
+ {action ? <motion.div className={styles.action} {...shared("action", side, "position")}>{action}</motion.div> : null}
139
+ </div> : null;
140
+
141
+ const card = <motion.article
142
+ {...(props as HTMLMotionProps<"article">)}
143
+ ref={cardRef}
144
+ className={[styles.card, className].filter(Boolean).join(" ")}
145
+ style={{ ...style, borderRadius: geometry.card ?? style?.borderRadius }}
146
+ data-hover={hovered || undefined}
147
+ whileHover={reduced ? undefined : { y: -2 }}
148
+ onHoverStart={() => setHovered(true)}
149
+ onHoverEnd={() => setHovered(false)}
150
+ {...shared("card", "card")}
151
+ transition={{ default: spring.snappy, layout: settle }}
152
+ >
153
+ {media ? <motion.div className={styles.media} {...shared("media", "card")}><motion.div className={styles.zoom} initial={false} animate={{ scale: hovered && !reduced ? ZOOM : 1 }} transition={hovered ? zoomIn : zoomOut}>{media}</motion.div></motion.div> : null}
154
+ <div className={styles.content}>
155
+ <motion.h3 className={styles.title} {...shared("title", "card")}>{details ? <Dialog.Trigger asChild><button type="button" className={styles.trigger}>{title}</button></Dialog.Trigger> : title}</motion.h3>
156
+ {description ? <motion.p ref={descriptionRef} className={styles.description} {...shared("description", "card", "position")}>{description}</motion.p> : null}
157
+ {children}
158
+ {footer("card")}
159
+ </div>
160
+ </motion.article>;
161
+
162
+ if (!details) return card;
163
+
164
+ // The quick look grows out of the card: the surface, photo, and copy travel on one spring while the details settle in beneath them.
165
+ return <Dialog.Root open={open} onOpenChange={setOpen}>
166
+ <LayoutGroup id={group}>
167
+ {card}
168
+ <AnimatePresence>
169
+ {(open || returning) && <Dialog.Portal key="quick-look" forceMount>
170
+ <AnimatePresence>{open && <Dialog.Overlay className={portalTheme} key="overlay" asChild forceMount><motion.div className={styles.overlay} initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0, transition: reduced ? fade : { duration: duration.exit, ease: [...ease.standard] } }} transition={reduced ? fade : { duration: duration.standard, ease: [...ease.enter] }} /></Dialog.Overlay>}</AnimatePresence>
171
+ <Dialog.Content className={portalTheme} asChild forceMount {...(description ? {} : { "aria-describedby": undefined })}>
172
+ <motion.div
173
+ className={styles.panel}
174
+ data-framer-portal-id={group}
175
+ data-returning={returning || undefined}
176
+ layoutScroll
177
+ style={{ borderRadius: geometry.panel, "--card-measure": geometry.measure ? `${geometry.measure}px` : undefined, ...(landing && returning ? { "--landing-top": `${landing.top}px`, "--landing-left": `${landing.left}px`, "--landing-width": `${landing.width}px`, "--landing-height": `${landing.height}px` } : {}) } as CSSProperties}
178
+ {...(morph ? {
179
+ ...shared("card", "panel"),
180
+ initial: false,
181
+ animate: geometry.card !== undefined && geometry.panel !== undefined ? { borderRadius: returning ? geometry.card : geometry.panel } : undefined,
182
+ transition: { layout: returning ? settle : grow, borderRadius: returning ? settle : grow },
183
+ exit: { opacity: 0, transition: { duration: 0 } },
184
+ } : { initial: { opacity: 0 }, animate: { opacity: 1 }, exit: { opacity: 0, transition: fade }, transition: fade })}
185
+ >
186
+ {media ? <motion.div className={styles.media} {...shared("media", "panel")}><motion.div className={styles.zoom} initial={{ scale: hovered && !reduced ? ZOOM : 1 }} animate={{ scale: 1 }} transition={grow}>{media}</motion.div></motion.div> : null}
187
+ <motion.span className={styles.closeSlot} initial={reduced ? { opacity: 0 } : { opacity: 0, scale: .9 }} animate={returning ? { opacity: 0, scale: .9 } : { opacity: 1, scale: 1 }} transition={returning ? fade : reduced ? fade : closeIn}><Dialog.Close asChild><motion.button type="button" className={styles.close} aria-label="Close quick look" whileTap={reduced ? undefined : { scale: .94 }} transition={spring.snappy}><X width={16} height={16} strokeWidth={1.75} aria-hidden="true" /></motion.button></Dialog.Close></motion.span>
188
+ <div className={styles.content}>
189
+ <Dialog.Title asChild><motion.h2 className={styles.title} {...shared("title", "panel")}>{title}</motion.h2></Dialog.Title>
190
+ {description ? <Dialog.Description asChild><motion.p className={styles.description} {...shared("description", "panel", "position")}>{description}</motion.p></Dialog.Description> : null}
191
+ {children}
192
+ {footer("panel")}
193
+ <motion.div className={styles.details} initial={reduced ? false : { opacity: 0, y: 6 }} animate={returning ? { opacity: 0, y: 0 } : { opacity: 1, y: 0 }} exit={{ opacity: 0, transition: fade }} transition={returning || reduced ? fade : reveal}>{details}</motion.div>
194
+ </div>
195
+ </motion.div>
196
+ </Dialog.Content>
197
+ </Dialog.Portal>}
198
+ </AnimatePresence>
199
+ </LayoutGroup>
200
+ </Dialog.Root>;
201
+ }