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.
- package/README.md +449 -219
- package/SKILL.md +268 -22
- package/bin/index.mjs +4 -3
- package/bin/installer.mjs +11 -1
- package/catalog.json +5989 -239
- package/components/agents/ai-agent-activity.tsx +443 -0
- package/components/agents/ai-response.tsx +829 -0
- package/components/agents/ai-status.tsx +373 -0
- package/components/agents/chat-thread.module.css +242 -0
- package/components/agents/chat-thread.tsx +700 -0
- package/components/agents/citations.tsx +1 -1
- package/components/agents/comment-thread.module.css +195 -0
- package/components/agents/comment-thread.tsx +593 -0
- package/components/agents/json-viewer.module.css +92 -0
- package/components/agents/json-viewer.tsx +530 -0
- package/components/agents/matrix-orb.tsx +252 -0
- package/components/agents/text-stream.css +17 -0
- package/components/agents/text-stream.tsx +169 -0
- package/components/agents/thinking-orb.tsx +653 -0
- package/components/agents/web-search.tsx +932 -0
- package/components/analytics-dashboard/context.ts +47 -0
- package/components/analytics-dashboard/data.ts +351 -0
- package/components/analytics-dashboard/details.tsx +282 -0
- package/components/analytics-dashboard/icons.tsx +219 -0
- package/components/analytics-dashboard/number-animation.module.css +19 -0
- package/components/analytics-dashboard/number-animation.tsx +183 -0
- package/components/analytics-dashboard/pages.tsx +673 -0
- package/components/analytics-dashboard/ui.tsx +238 -0
- package/components/blocks/active-sessions.css +52 -0
- package/components/blocks/active-sessions.tsx +679 -0
- package/components/blocks/activity-feed.tsx +432 -0
- package/components/blocks/activity-heatmap.module.css +83 -0
- package/components/blocks/activity-heatmap.tsx +416 -0
- package/components/blocks/advanced-data-table.tsx +1078 -0
- package/components/blocks/analytics-dashboard.css +2822 -0
- package/components/blocks/analytics-dashboard.tsx +394 -0
- package/components/blocks/art-gallery.tsx +508 -0
- package/components/blocks/bar-chart.module.css +49 -0
- package/components/blocks/bar-chart.tsx +394 -0
- package/components/blocks/blog-grid-data.ts +127 -0
- package/components/blocks/blog-grid.module.css +93 -0
- package/components/blocks/blog-grid.tsx +263 -0
- package/components/blocks/brush-chart.module.css +69 -0
- package/components/blocks/brush-chart.tsx +459 -0
- package/components/blocks/changelog-feed.module.css +138 -0
- package/components/blocks/changelog-feed.tsx +401 -0
- package/components/blocks/chat.tsx +785 -0
- package/components/blocks/comparison-table-data.ts +63 -0
- package/components/blocks/comparison-table.module.css +92 -0
- package/components/blocks/comparison-table.tsx +209 -0
- package/components/blocks/cta-section-data.ts +42 -0
- package/components/blocks/cta-section.module.css +95 -0
- package/components/blocks/cta-section.tsx +261 -0
- package/components/blocks/dashboard-shell.css +110 -0
- package/components/blocks/dashboard-shell.tsx +1067 -0
- package/components/blocks/empty-states-art.ts +331 -0
- package/components/blocks/empty-states.module.css +52 -0
- package/components/blocks/empty-states.tsx +326 -0
- package/components/blocks/family-drawer.tsx +695 -0
- package/components/blocks/faq.tsx +214 -0
- package/components/blocks/footer.tsx +117 -0
- package/components/blocks/form.tsx +594 -0
- package/components/blocks/hero-cadence.module.css +46 -0
- package/components/blocks/hero-cadence.tsx +68 -0
- package/components/blocks/hero-content.module.css +49 -0
- package/components/blocks/hero-content.tsx +93 -0
- package/components/blocks/hero-lumen-data.ts +97 -0
- package/components/blocks/hero-lumen.module.css +127 -0
- package/components/blocks/hero-lumen.tsx +204 -0
- package/components/blocks/hero-mesh.module.css +5 -0
- package/components/blocks/hero-mesh.tsx +200 -0
- package/components/blocks/hero-motion.ts +31 -0
- package/components/blocks/hero-relay.module.css +102 -0
- package/components/blocks/hero-relay.tsx +252 -0
- package/components/blocks/hero-section.module.css +31 -0
- package/components/blocks/hero-section.tsx +83 -0
- package/components/blocks/hook-sidebar.tsx +233 -0
- package/components/blocks/line-chart.module.css +60 -0
- package/components/blocks/line-chart.tsx +434 -0
- package/components/blocks/login-centered.module.css +94 -0
- package/components/blocks/login-centered.tsx +444 -0
- package/components/blocks/logo-marquee.module.css +162 -0
- package/components/blocks/logo-marquee.tsx +106 -0
- package/components/blocks/newsletter-signup-data.ts +95 -0
- package/components/blocks/newsletter-signup.module.css +175 -0
- package/components/blocks/newsletter-signup.tsx +369 -0
- package/components/blocks/notification-center.module.css +79 -0
- package/components/blocks/notification-center.tsx +244 -0
- package/components/blocks/page-header.module.css +161 -0
- package/components/blocks/page-header.tsx +495 -0
- package/components/blocks/plan-comparison.module.css +87 -0
- package/components/blocks/plan-comparison.tsx +120 -0
- package/components/blocks/pricing.tsx +421 -0
- package/components/blocks/product-tour.tsx +621 -0
- package/components/blocks/proximity-sidebar.tsx +397 -0
- package/components/blocks/rail-toc.tsx +468 -0
- package/components/blocks/scroll-progress.tsx +375 -0
- package/components/blocks/sidebar-stackbits.tsx +362 -0
- package/components/blocks/sign-in.module.css +73 -0
- package/components/blocks/sign-in.tsx +337 -0
- package/components/blocks/site-header.module.css +115 -0
- package/components/blocks/site-header.tsx +548 -0
- package/components/blocks/slope-chart.module.css +51 -0
- package/components/blocks/slope-chart.tsx +256 -0
- package/components/blocks/sortable-data-table.module.css +118 -0
- package/components/blocks/sortable-data-table.tsx +312 -0
- package/components/blocks/stats-band-data.ts +67 -0
- package/components/blocks/stats-band-world.ts +20 -0
- package/components/blocks/stats-band.module.css +150 -0
- package/components/blocks/stats-band.tsx +236 -0
- package/components/blocks/status-bars.css +52 -0
- package/components/blocks/status-bars.tsx +406 -0
- package/components/blocks/step-player.tsx +344 -0
- package/components/blocks/task-list.tsx +374 -0
- package/components/blocks/waffle-chart.module.css +52 -0
- package/components/blocks/waffle-chart.tsx +303 -0
- package/components/buttons/ash-burst-button.tsx +1 -1
- package/components/buttons/minecraft-button.tsx +1 -1
- package/components/craft/Button.tsx +137 -0
- package/components/craft/Form.tsx +594 -0
- package/components/craft/airport-matrix-clock.tsx +389 -0
- package/components/craft/animated-counter.tsx +384 -0
- package/components/craft/batch-gesture-tray.tsx +273 -0
- package/components/craft/car-smoke-page-transition.tsx +1147 -0
- package/components/craft/circular-orbit.tsx +270 -0
- package/components/craft/click-spark.tsx +205 -0
- package/components/craft/code-snippet-deck.tsx +275 -0
- package/components/craft/command.tsx +186 -0
- package/components/craft/cursor-follower.tsx +156 -0
- package/components/craft/delete-button.tsx +285 -0
- package/components/craft/density-lens.tsx +115 -0
- package/components/craft/dependency-trace.tsx +219 -0
- package/components/craft/depth-corridor.tsx +179 -0
- package/components/craft/discover-button.css +83 -0
- package/components/craft/discover-button.tsx +46 -0
- package/components/craft/drag-to-confirm.tsx +387 -0
- package/components/craft/draggable-marquee.css +5 -0
- package/components/craft/draggable-marquee.tsx +352 -0
- package/components/craft/duration-picker.tsx +291 -0
- package/components/craft/emoji-reaction.tsx +610 -0
- package/components/craft/empty.tsx +108 -0
- package/components/craft/evil-eye.tsx +350 -0
- package/components/craft/expandable-data-row.tsx +419 -0
- package/components/craft/field.tsx +250 -0
- package/components/craft/file-input.tsx +553 -0
- package/components/craft/flip-text.tsx +128 -0
- package/components/craft/fluid-orb.tsx +199 -0
- package/components/craft/focus-mode.tsx +262 -0
- package/components/craft/folder-component.tsx +474 -0
- package/components/craft/framing.ts +53 -0
- package/components/craft/github-activity.tsx +682 -0
- package/components/craft/glitch-text.tsx +414 -0
- package/components/craft/glyph-matrix.tsx +411 -0
- package/components/craft/golden-gate-404/framing.ts +53 -0
- package/components/craft/golden-gate-404/golden-gate-404.css +271 -0
- package/components/craft/golden-gate-404/golden-gate-404.mdx +55 -0
- package/components/craft/golden-gate-404/golden-gate-scene.tsx +73 -0
- package/components/craft/golden-gate-404/golden-gate.css +157 -0
- package/components/craft/golden-gate-404/live.ts +592 -0
- package/components/craft/golden-gate-404/model.json +176 -0
- package/components/craft/golden-gate-404/projection.ts +41 -0
- package/components/craft/golden-gate-404.css +271 -0
- package/components/craft/golden-gate-404.tsx +67 -0
- package/components/craft/golden-gate-scene.tsx +73 -0
- package/components/craft/golden-gate.css +157 -0
- package/components/craft/gooey-nav.tsx +286 -0
- package/components/craft/gravity-letters.tsx +687 -0
- package/components/craft/gravity-particle-burst.tsx +150 -0
- package/components/craft/grid-reveal.tsx +683 -0
- package/components/craft/hover-img.css +156 -0
- package/components/craft/hover-img.tsx +160 -0
- package/components/craft/input-otp.tsx +79 -0
- package/components/craft/interactive-area-chart.tsx +482 -0
- package/components/craft/interactive-timeline.tsx +315 -0
- package/components/craft/intro-loader.tsx +250 -0
- package/components/craft/ios-search-bar.tsx +130 -0
- package/components/craft/liquid-metal.tsx +212 -0
- package/components/craft/liquid-toggle.tsx +308 -0
- package/components/craft/live.ts +592 -0
- package/components/craft/loaders-gooey-blobs.tsx +61 -0
- package/components/craft/lock-input.tsx +169 -0
- package/components/craft/login.tsx +276 -0
- package/components/craft/meteors.tsx +139 -0
- package/components/craft/metric-hud.tsx +371 -0
- package/components/craft/model.json +176 -0
- package/components/craft/morphing-blob.tsx +289 -0
- package/components/craft/morphing-dialog.tsx +118 -0
- package/components/craft/morphing-icon.tsx +74 -0
- package/components/craft/morphing-shape-loader.tsx +241 -0
- package/components/craft/nimbu-mirchi.tsx +360 -0
- package/components/craft/notification-bell.tsx +357 -0
- package/components/craft/orbital-loading-ring.tsx +104 -0
- package/components/craft/origin-dropdown.tsx +196 -0
- package/components/craft/particle-delete.tsx +266 -0
- package/components/craft/payment-receipt-printer.tsx +600 -0
- package/components/craft/payment-status.tsx +359 -0
- package/components/craft/projection.ts +41 -0
- package/components/craft/recovery-ledger.tsx +215 -0
- package/components/craft/rocket-party-popper.tsx +308 -0
- package/components/craft/scroll-progress-nav.tsx +256 -0
- package/components/craft/scrollvelocitytext.tsx +285 -0
- package/components/craft/selection-basket.tsx +147 -0
- package/components/craft/sheet.tsx +324 -0
- package/components/craft/shooting-stars.tsx +710 -0
- package/components/craft/sidebar.tsx +448 -0
- package/components/craft/sign-up.tsx +396 -0
- package/components/craft/skeumorphic-music-card.tsx +177 -0
- package/components/craft/slide-pagination.tsx +170 -0
- package/components/craft/slot-text.module.css +19 -0
- package/components/craft/slot-text.tsx +183 -0
- package/components/craft/smart-comparison.tsx +375 -0
- package/components/craft/smooth-scroll.tsx +63 -0
- package/components/craft/speed-warp.tsx +179 -0
- package/components/craft/split-showcase.tsx +268 -0
- package/components/craft/spotlight-search.tsx +337 -0
- package/components/craft/stack-unfold-panel.tsx +137 -0
- package/components/craft/sticky-pages.tsx +210 -0
- package/components/craft/text-scramble-decoder.tsx +139 -0
- package/components/craft/toggle.tsx +49 -0
- package/components/craft/torque-dial.tsx +293 -0
- package/components/craft/v-prism-settings.ts +31 -0
- package/components/craft/v-prism.tsx +797 -0
- package/components/craft/voice-note.tsx +730 -0
- package/components/docks/mac-dock.tsx +1 -1
- package/components/motion/accordion.module.css +15 -0
- package/components/motion/accordion.tsx +59 -0
- package/components/motion/action-button.module.css +20 -0
- package/components/motion/action-button.tsx +120 -0
- package/components/motion/action-sheet.tsx +1 -1
- package/components/motion/alert.module.css +15 -0
- package/components/motion/alert.tsx +109 -0
- package/components/motion/animated-counter.tsx +2 -0
- package/components/motion/animated-sidebar.tsx +1 -1
- package/components/motion/animated-toast-stack.tsx +1 -1
- package/components/motion/attachment-upload.tsx +1 -1
- package/components/motion/avatar.module.css +60 -0
- package/components/motion/avatar.tsx +21 -0
- package/components/motion/badge.module.css +52 -0
- package/components/motion/badge.tsx +82 -0
- package/components/motion/banner-stacking.tsx +3 -3
- package/components/motion/billing-toggle.module.css +139 -0
- package/components/motion/billing-toggle.tsx +205 -0
- package/components/motion/book-call-button.tsx +332 -0
- package/components/motion/bottom-sheet.tsx +1 -1
- package/components/motion/branching-submenu.tsx +223 -0
- package/components/motion/button/index.tsx +1 -0
- package/components/motion/button-group.module.css +87 -0
- package/components/motion/button-group.tsx +346 -0
- package/components/motion/calendar.module.css +51 -0
- package/components/motion/calendar.tsx +313 -0
- package/components/motion/card-stack.module.css +63 -0
- package/components/motion/card-stack.tsx +372 -0
- package/components/motion/card.module.css +51 -0
- package/components/motion/card.tsx +201 -0
- package/components/motion/carousel.module.css +42 -0
- package/components/motion/carousel.tsx +347 -0
- package/components/motion/center-morph-modal.tsx +1 -1
- package/components/motion/chart.tsx +359 -0
- package/components/motion/chip-group.module.css +38 -0
- package/components/motion/chip-group.tsx +256 -0
- package/components/motion/combobox/content.tsx +1 -1
- package/components/motion/command-menu.tsx +295 -0
- package/components/motion/command-palette.tsx +1 -1
- package/components/motion/confirm-morph.module.css +146 -0
- package/components/motion/confirm-morph.tsx +445 -0
- package/components/motion/context-menu.tsx +1 -1
- package/components/motion/cookie-consent.module.css +68 -0
- package/components/motion/cookie-consent.tsx +364 -0
- package/components/motion/countdown.module.css +49 -0
- package/components/motion/countdown.tsx +218 -0
- package/components/motion/date-picker.module.css +34 -0
- package/components/motion/date-picker.tsx +131 -0
- package/components/motion/dialog.module.css +36 -0
- package/components/motion/dialog.tsx +75 -0
- package/components/motion/dock.tsx +1 -1
- package/components/motion/dropdown-menu-morph.tsx +4 -4
- package/components/motion/dropdown-menu.module.css +38 -0
- package/components/motion/dropdown-menu.tsx +76 -0
- package/components/motion/elastic-slider.module.css +40 -0
- package/components/motion/elastic-slider.tsx +296 -0
- package/components/motion/empty-state.module.css +13 -0
- package/components/motion/empty-state.tsx +88 -0
- package/components/motion/expandable-card.module.css +22 -0
- package/components/motion/expandable-card.tsx +129 -0
- package/components/motion/expandable-text.module.css +19 -0
- package/components/motion/expandable-text.tsx +168 -0
- package/components/motion/expanding-button-group.module.css +44 -0
- package/components/motion/expanding-button-group.tsx +367 -0
- package/components/motion/expanding-search.module.css +51 -0
- package/components/motion/expanding-search.tsx +336 -0
- package/components/motion/file-dropzone.module.css +115 -0
- package/components/motion/file-dropzone.tsx +442 -0
- package/components/motion/filter-toolbar.module.css +70 -0
- package/components/motion/filter-toolbar.tsx +461 -0
- package/components/motion/floating-button-group.module.css +74 -0
- package/components/motion/floating-button-group.tsx +307 -0
- package/components/motion/gauge.module.css +22 -0
- package/components/motion/gauge.tsx +106 -0
- package/components/motion/hamburger-menu.tsx +103 -0
- package/components/motion/hold-to-confirm.module.css +20 -0
- package/components/motion/hold-to-confirm.tsx +209 -0
- package/components/motion/icon-morph.module.css +5 -0
- package/components/motion/icon-morph.tsx +239 -0
- package/components/motion/image-compare.module.css +25 -0
- package/components/motion/image-compare.tsx +278 -0
- package/components/motion/in-view-title.module.css +13 -0
- package/components/motion/in-view-title.tsx +74 -0
- package/components/motion/inline-edit.module.css +73 -0
- package/components/motion/inline-edit.tsx +360 -0
- package/components/motion/input-group.tsx +172 -0
- package/components/motion/item.tsx +197 -0
- package/components/motion/label.tsx +26 -0
- package/components/motion/liquid-ripple-button.tsx +193 -0
- package/components/motion/mac-os-folder-cards.tsx +268 -0
- package/components/motion/magnetic-button.tsx +96 -0
- package/components/motion/mention-input.module.css +134 -0
- package/components/motion/mention-input.tsx +522 -0
- package/components/motion/menubar.tsx +282 -0
- package/components/motion/money-card.tsx +1134 -0
- package/components/motion/money-input.module.css +77 -0
- package/components/motion/money-input.tsx +563 -0
- package/components/motion/morph-select.module.css +86 -0
- package/components/motion/morph-select.tsx +463 -0
- package/components/motion/morphing-button.tsx +141 -0
- package/components/motion/morphing-mega-menu.tsx +452 -0
- package/components/motion/morphing-search.tsx +1 -1
- package/components/motion/morphing-tabs.tsx +1 -1
- package/components/motion/multi-select/content.tsx +1 -1
- package/components/motion/navigation-menu.tsx +172 -0
- package/components/motion/neon-edge-button.tsx +64 -0
- package/components/motion/onboarding-checklist.module.css +71 -0
- package/components/motion/onboarding-checklist.tsx +349 -0
- package/components/motion/organic-shimmer.tsx +6 -6
- package/components/motion/otp-input.tsx +7 -4
- package/components/motion/password-field.module.css +27 -0
- package/components/motion/password-field.tsx +65 -0
- package/components/motion/password-strength.module.css +57 -0
- package/components/motion/password-strength.tsx +327 -0
- package/components/motion/peek-card.tsx +239 -0
- package/components/motion/popover-morph.tsx +1 -1
- package/components/motion/popover.tsx +1 -1
- package/components/motion/preview-rail.tsx +1 -1
- package/components/motion/profile-card.tsx +326 -0
- package/components/motion/progress.module.css +1 -0
- package/components/motion/progress.tsx +60 -0
- package/components/motion/project-folder.tsx +1 -1
- package/components/motion/radio-cards.module.css +84 -0
- package/components/motion/radio-cards.tsx +153 -0
- package/components/motion/radio-group.module.css +30 -0
- package/components/motion/radio-group.tsx +52 -0
- package/components/motion/rainbow-button.tsx +186 -0
- package/components/motion/raised-button.tsx +108 -0
- package/components/motion/range-histogram-slider.module.css +27 -0
- package/components/motion/range-histogram-slider.tsx +284 -0
- package/components/motion/reactions.module.css +49 -0
- package/components/motion/reactions.tsx +288 -0
- package/components/motion/resizable-panels.module.css +40 -0
- package/components/motion/resizable-panels.tsx +376 -0
- package/components/motion/resizable.tsx +58 -0
- package/components/motion/rich-text-editor.module.css +201 -0
- package/components/motion/rich-text-editor.tsx +1566 -0
- package/components/motion/ridgeline.module.css +58 -0
- package/components/motion/ridgeline.tsx +355 -0
- package/components/motion/scroll-area.module.css +79 -0
- package/components/motion/scroll-area.tsx +197 -0
- package/components/motion/scrub-input.module.css +135 -0
- package/components/motion/scrub-input.tsx +468 -0
- package/components/motion/search-field.module.css +17 -0
- package/components/motion/search-field.tsx +19 -0
- package/components/motion/segmented-control.tsx +2 -0
- package/components/motion/separator.tsx +30 -0
- package/components/motion/shortcut-recorder.module.css +85 -0
- package/components/motion/shortcut-recorder.tsx +513 -0
- package/components/motion/signature-pad.module.css +84 -0
- package/components/motion/signature-pad.tsx +546 -0
- package/components/motion/skeleton.module.css +11 -0
- package/components/motion/skeleton.tsx +70 -0
- package/components/motion/slider.module.css +45 -0
- package/components/motion/slider.tsx +405 -0
- package/components/motion/sonner.tsx +42 -0
- package/components/motion/sparkline.module.css +26 -0
- package/components/motion/sparkline.tsx +260 -0
- package/components/motion/spinner.tsx +20 -0
- package/components/motion/split-button.module.css +54 -0
- package/components/motion/split-button.tsx +114 -0
- package/components/motion/story-card.tsx +632 -0
- package/components/motion/streamgraph.module.css +55 -0
- package/components/motion/streamgraph.tsx +398 -0
- package/components/motion/swipe-actions.module.css +64 -0
- package/components/motion/swipe-actions.tsx +360 -0
- package/components/motion/table/row-handle.tsx +1 -1
- package/components/motion/table/table-header.tsx +1 -1
- package/components/motion/table/table-menu.tsx +1 -1
- package/components/motion/tag-input.module.css +34 -0
- package/components/motion/tag-input.tsx +150 -0
- package/components/motion/textarea.module.css +22 -0
- package/components/motion/textarea.tsx +64 -0
- package/components/motion/theme-switch-eclipse.tsx +82 -0
- package/components/motion/theme-switch-rise.tsx +82 -0
- package/components/motion/theme-switch-split.tsx +82 -0
- package/components/motion/theme-switch.module.css +31 -0
- package/components/motion/theme-switch.tsx +82 -0
- package/components/motion/time-picker.module.css +23 -0
- package/components/motion/time-picker.tsx +106 -0
- package/components/motion/toast.module.css +100 -0
- package/components/motion/toast.tsx +155 -0
- package/components/motion/tooltip.tsx +1 -1
- package/components/motion/treemap.module.css +59 -0
- package/components/motion/treemap.tsx +333 -0
- package/components/motion/undo-toast.tsx +252 -0
- package/components/motion/usage-meter.module.css +61 -0
- package/components/motion/usage-meter.tsx +340 -0
- package/components/otp/otp-boxed-input.tsx +18 -18
- package/components/previews/agents/ai-agent-activity.preview.tsx +14 -0
- package/components/previews/agents/ai-response.preview.tsx +14 -0
- package/components/previews/agents/ai-status.preview.tsx +14 -0
- package/components/previews/agents/chat-thread.preview.tsx +18 -0
- package/components/previews/agents/comment-thread.preview.tsx +17 -0
- package/components/previews/agents/json-viewer.preview.tsx +14 -0
- package/components/previews/agents/matrix-orb.preview.tsx +14 -0
- package/components/previews/agents/text-stream.preview.tsx +19 -0
- package/components/previews/agents/thinking-orb.preview.tsx +14 -0
- package/components/previews/agents/web-search.preview.tsx +17 -0
- package/components/previews/blocks/active-sessions.preview.tsx +14 -0
- package/components/previews/blocks/activity-feed.preview.tsx +14 -0
- package/components/previews/blocks/activity-heatmap.preview.tsx +18 -0
- package/components/previews/blocks/advanced-data-table.preview.tsx +17 -0
- package/components/previews/blocks/analytics-dashboard.preview.tsx +14 -0
- package/components/previews/blocks/art-gallery.preview.tsx +14 -0
- package/components/previews/blocks/bar-chart.preview.tsx +18 -0
- package/components/previews/blocks/blog-grid.preview.tsx +14 -0
- package/components/previews/blocks/brush-chart.preview.tsx +17 -0
- package/components/previews/blocks/changelog-feed.preview.tsx +14 -0
- package/components/previews/blocks/chat.preview.tsx +18 -0
- package/components/previews/blocks/comparison-table.preview.tsx +14 -0
- package/components/previews/blocks/cta-section.preview.tsx +14 -0
- package/components/previews/blocks/dashboard-shell.preview.tsx +18 -0
- package/components/previews/blocks/empty-states.preview.tsx +14 -0
- package/components/previews/blocks/expandable-tabs.preview.tsx +1 -1
- package/components/previews/blocks/family-drawer.preview.tsx +14 -0
- package/components/previews/blocks/faq.preview.tsx +14 -0
- package/components/previews/blocks/footer.preview.tsx +14 -0
- package/components/previews/blocks/form.preview.tsx +14 -0
- package/components/previews/blocks/frame.preview.tsx +18 -0
- package/components/previews/blocks/gantt.preview.tsx +18 -0
- package/components/previews/blocks/hero-section.preview.tsx +14 -0
- package/components/previews/blocks/hook-sidebar.preview.tsx +14 -0
- package/components/previews/blocks/kanban.preview.tsx +68 -0
- package/components/previews/blocks/line-chart.preview.tsx +18 -0
- package/components/previews/blocks/login-centered.preview.tsx +14 -0
- package/components/previews/blocks/logo-marquee.preview.tsx +14 -0
- package/components/previews/blocks/newsletter-signup.preview.tsx +14 -0
- package/components/previews/blocks/notification-center.preview.tsx +14 -0
- package/components/previews/blocks/otp-input.preview.tsx +2 -2
- package/components/previews/blocks/page-header.preview.tsx +14 -0
- package/components/previews/blocks/plan-comparison.preview.tsx +14 -0
- package/components/previews/blocks/pricing.preview.tsx +14 -0
- package/components/previews/blocks/product-tour.preview.tsx +14 -0
- package/components/previews/blocks/proximity-sidebar.preview.tsx +14 -0
- package/components/previews/blocks/rail-toc.preview.tsx +14 -0
- package/components/previews/blocks/scroll-progress.preview.tsx +14 -0
- package/components/previews/blocks/sidebar-stackbits.preview.tsx +14 -0
- package/components/previews/blocks/sign-in.preview.tsx +14 -0
- package/components/previews/blocks/site-header.preview.tsx +14 -0
- package/components/previews/blocks/slope-chart.preview.tsx +19 -0
- package/components/previews/blocks/sortable-data-table.preview.tsx +18 -0
- package/components/previews/blocks/stats-band.preview.tsx +14 -0
- package/components/previews/blocks/status-bars.preview.tsx +17 -0
- package/components/previews/blocks/step-player.preview.tsx +14 -0
- package/components/previews/blocks/task-list.preview.tsx +14 -0
- package/components/previews/blocks/waffle-chart.preview.tsx +17 -0
- package/components/previews/craft/airport-matrix-clock.preview.tsx +14 -0
- package/components/previews/craft/animated-counter.preview.tsx +14 -0
- package/components/previews/craft/apple-notification.preview.tsx +11 -0
- package/components/previews/craft/batch-gesture-tray.preview.tsx +19 -0
- package/components/previews/craft/booking-slot-calendar.preview.tsx +11 -0
- package/components/previews/craft/cafe-menu-board.preview.tsx +11 -0
- package/components/previews/craft/calendar-reminder-notification.preview.tsx +11 -0
- package/components/previews/craft/car-smoke-page-transition.preview.tsx +14 -0
- package/components/previews/craft/chat-bubble-notification.preview.tsx +11 -0
- package/components/previews/craft/cinema-ticket.preview.tsx +11 -0
- package/components/previews/craft/circle-cut-frame.preview.tsx +11 -0
- package/components/previews/craft/circular-orbit.preview.tsx +14 -0
- package/components/previews/craft/click-spark.preview.tsx +14 -0
- package/components/previews/craft/code-snippet-deck.preview.tsx +14 -0
- package/components/previews/craft/command.preview.tsx +14 -0
- package/components/previews/craft/contact-profile.preview.tsx +11 -0
- package/components/previews/craft/credit-card-glass.preview.tsx +11 -0
- package/components/previews/craft/cursor-follower.preview.tsx +14 -0
- package/components/previews/craft/customers-table.preview.tsx +11 -0
- package/components/previews/craft/daily-motivation.preview.tsx +11 -0
- package/components/previews/craft/date-range-picker-card.preview.tsx +11 -0
- package/components/previews/craft/delete-button.preview.tsx +14 -0
- package/components/previews/craft/delivery-notification.preview.tsx +11 -0
- package/components/previews/craft/denim-product-editorial.preview.tsx +11 -0
- package/components/previews/craft/density-lens.preview.tsx +14 -0
- package/components/previews/craft/dependency-trace.preview.tsx +17 -0
- package/components/previews/craft/deploy-notification.preview.tsx +11 -0
- package/components/previews/craft/depth-corridor.preview.tsx +14 -0
- package/components/previews/craft/discord-chat.preview.tsx +11 -0
- package/components/previews/craft/discover-button.preview.tsx +14 -0
- package/components/previews/craft/doubt-button.preview.tsx +11 -0
- package/components/previews/craft/drag-to-confirm.preview.tsx +14 -0
- package/components/previews/craft/draggable-marquee.preview.tsx +17 -0
- package/components/previews/craft/drop-cap-editorial.preview.tsx +11 -0
- package/components/previews/craft/duration-picker.preview.tsx +14 -0
- package/components/previews/craft/editorial-staff-profile.preview.tsx +11 -0
- package/components/previews/craft/electric-scooter.preview.tsx +11 -0
- package/components/previews/craft/email-notification.preview.tsx +11 -0
- package/components/previews/craft/emoji-reaction.preview.tsx +14 -0
- package/components/previews/craft/empty.preview.tsx +14 -0
- package/components/previews/craft/event-ticket.preview.tsx +11 -0
- package/components/previews/craft/evil-eye.preview.tsx +14 -0
- package/components/previews/craft/expandable-data-row.preview.tsx +14 -0
- package/components/previews/craft/field.preview.tsx +14 -0
- package/components/previews/craft/file-input.preview.tsx +14 -0
- package/components/previews/craft/film-strip.preview.tsx +11 -0
- package/components/previews/craft/flight-boarding.preview.tsx +11 -0
- package/components/previews/craft/flip-text.preview.tsx +14 -0
- package/components/previews/craft/fluid-orb.preview.tsx +14 -0
- package/components/previews/craft/focus-mode.preview.tsx +14 -0
- package/components/previews/craft/folder-component.preview.tsx +14 -0
- package/components/previews/craft/folder-tab-card.preview.tsx +11 -0
- package/components/previews/craft/gallery-grid.preview.tsx +11 -0
- package/components/previews/craft/gallery-wall.preview.tsx +11 -0
- package/components/previews/craft/github-activity.preview.tsx +14 -0
- package/components/previews/craft/github-contribution.preview.tsx +11 -0
- package/components/previews/craft/github-repo.preview.tsx +11 -0
- package/components/previews/craft/glass-overlay-image.preview.tsx +11 -0
- package/components/previews/craft/glitch-text.preview.tsx +14 -0
- package/components/previews/craft/glyph-matrix.preview.tsx +14 -0
- package/components/previews/craft/golden-gate-404.preview.tsx +14 -0
- package/components/previews/craft/gooey-nav.preview.tsx +14 -0
- package/components/previews/craft/gravity-letters.preview.tsx +14 -0
- package/components/previews/craft/gravity-particle-burst.preview.tsx +14 -0
- package/components/previews/craft/grid-reveal.preview.tsx +14 -0
- package/components/previews/craft/hard-shadow-polaroid-frame.preview.tsx +11 -0
- package/components/previews/craft/hover-img.preview.tsx +14 -0
- package/components/previews/craft/incoming-call-notification.preview.tsx +11 -0
- package/components/previews/craft/ink-stamp-document.preview.tsx +11 -0
- package/components/previews/craft/input-group-field.preview.tsx +11 -0
- package/components/previews/craft/input-otp.preview.tsx +19 -0
- package/components/previews/craft/interactive-area-chart.preview.tsx +14 -0
- package/components/previews/craft/interactive-timeline.preview.tsx +14 -0
- package/components/previews/craft/intro-loader.preview.tsx +14 -0
- package/components/previews/craft/ios-search-bar.preview.tsx +15 -0
- package/components/previews/craft/ipad.preview.tsx +11 -0
- package/components/previews/craft/journal-writing.preview.tsx +11 -0
- package/components/previews/craft/keyboard-shortcuts.preview.tsx +11 -0
- package/components/previews/craft/linked-in-profile.preview.tsx +11 -0
- package/components/previews/craft/liquid-metal.preview.tsx +14 -0
- package/components/previews/craft/liquid-toggle.preview.tsx +14 -0
- package/components/previews/craft/loaders-gooey-blobs.preview.tsx +14 -0
- package/components/previews/craft/lock-input.preview.tsx +14 -0
- package/components/previews/craft/login.preview.tsx +14 -0
- package/components/previews/craft/mac-dock.preview.tsx +11 -0
- package/components/previews/craft/magazine-cover.preview.tsx +11 -0
- package/components/previews/craft/meteors.preview.tsx +14 -0
- package/components/previews/craft/metric-hud.preview.tsx +14 -0
- package/components/previews/craft/minimal-agenda.preview.tsx +11 -0
- package/components/previews/craft/month-picker-calendar.preview.tsx +11 -0
- package/components/previews/craft/morphing-blob.preview.tsx +14 -0
- package/components/previews/craft/morphing-dialog.preview.tsx +18 -0
- package/components/previews/craft/morphing-icon.preview.tsx +15 -0
- package/components/previews/craft/morphing-shape-loader.preview.tsx +14 -0
- package/components/previews/craft/museum-placard.preview.tsx +11 -0
- package/components/previews/craft/music-player.preview.tsx +11 -0
- package/components/previews/craft/music-playlist.preview.tsx +11 -0
- package/components/previews/craft/nimbu-mirchi.preview.tsx +14 -0
- package/components/previews/craft/notification-bell.preview.tsx +14 -0
- package/components/previews/craft/now-playing-bar.preview.tsx +11 -0
- package/components/previews/craft/orbital-loading-ring.preview.tsx +14 -0
- package/components/previews/craft/orders-table.preview.tsx +11 -0
- package/components/previews/craft/origin-dropdown.preview.tsx +14 -0
- package/components/previews/craft/otp-boxed-input.preview.tsx +11 -0
- package/components/previews/craft/otp-underline-input.preview.tsx +11 -0
- package/components/previews/craft/particle-delete.preview.tsx +14 -0
- package/components/previews/craft/payment-notification.preview.tsx +11 -0
- package/components/previews/craft/payment-receipt-printer.preview.tsx +14 -0
- package/components/previews/craft/payment-status.preview.tsx +14 -0
- package/components/previews/craft/phone.preview.tsx +11 -0
- package/components/previews/craft/photo-album.preview.tsx +11 -0
- package/components/previews/craft/progress-ring-card.preview.tsx +11 -0
- package/components/previews/craft/recent-transactions-table.preview.tsx +11 -0
- package/components/previews/craft/recovery-ledger.preview.tsx +14 -0
- package/components/previews/craft/resource-links-panel.preview.tsx +11 -0
- package/components/previews/craft/rocket-party-popper.preview.tsx +14 -0
- package/components/previews/craft/scroll-progress-nav.preview.tsx +14 -0
- package/components/previews/craft/scrollvelocitytext.preview.tsx +14 -0
- package/components/previews/craft/selection-basket.preview.tsx +14 -0
- package/components/previews/craft/sheet.preview.tsx +15 -0
- package/components/previews/craft/shooting-stars.preview.tsx +14 -0
- package/components/previews/craft/sidebar.preview.tsx +19 -0
- package/components/previews/craft/sign-up.preview.tsx +14 -0
- package/components/previews/craft/skeumorphic-music-card.preview.tsx +18 -0
- package/components/previews/craft/slide-pagination.preview.tsx +14 -0
- package/components/previews/craft/slide-to-confirm-button.preview.tsx +11 -0
- package/components/previews/craft/slide-to-detonate.preview.tsx +11 -0
- package/components/previews/craft/slot-text.preview.tsx +14 -0
- package/components/previews/craft/slow-living-polaroid.preview.tsx +11 -0
- package/components/previews/craft/smart-comparison.preview.tsx +17 -0
- package/components/previews/craft/smooth-scroll.preview.tsx +14 -0
- package/components/previews/craft/speed-warp.preview.tsx +14 -0
- package/components/previews/craft/split-showcase.preview.tsx +14 -0
- package/components/previews/craft/spotlight-search.preview.tsx +14 -0
- package/components/previews/craft/stack-unfold-panel.preview.tsx +14 -0
- package/components/previews/craft/stacked-folder-card.preview.tsx +11 -0
- package/components/previews/craft/step-count.preview.tsx +11 -0
- package/components/previews/craft/sticky-pages.preview.tsx +14 -0
- package/components/previews/craft/system-alert.preview.tsx +11 -0
- package/components/previews/craft/team-members-table.preview.tsx +11 -0
- package/components/previews/craft/testimonial.preview.tsx +11 -0
- package/components/previews/craft/text-scramble-decoder.preview.tsx +14 -0
- package/components/previews/craft/threads-post.preview.tsx +11 -0
- package/components/previews/craft/toggle-pricing-cards.preview.tsx +11 -0
- package/components/previews/craft/toggle.preview.tsx +14 -0
- package/components/previews/craft/torque-dial.preview.tsx +15 -0
- package/components/previews/craft/travel-postcard.preview.tsx +11 -0
- package/components/previews/craft/twitter-profile.preview.tsx +11 -0
- package/components/previews/craft/user-profile.preview.tsx +11 -0
- package/components/previews/craft/users-select-table.preview.tsx +11 -0
- package/components/previews/craft/v-prism.preview.tsx +14 -0
- package/components/previews/craft/voice-note.preview.tsx +14 -0
- package/components/previews/craft/wallet-pass.preview.tsx +11 -0
- package/components/previews/craft/weather-snapshot.preview.tsx +11 -0
- package/components/previews/craft/week-strip-calendar.preview.tsx +11 -0
- package/components/previews/motion/accordion.preview.tsx +14 -0
- package/components/previews/motion/action-button.preview.tsx +14 -0
- package/components/previews/motion/alert.preview.tsx +14 -0
- package/components/previews/motion/avatar.preview.tsx +14 -0
- package/components/previews/motion/badge.preview.tsx +14 -0
- package/components/previews/motion/banner-stacking.preview.tsx +21 -0
- package/components/previews/motion/billing-toggle.preview.tsx +15 -0
- package/components/previews/motion/book-call-button.preview.tsx +14 -0
- package/components/previews/motion/branching-submenu.preview.tsx +14 -0
- package/components/previews/motion/button-group.preview.tsx +19 -0
- package/components/previews/motion/calendar.preview.tsx +14 -0
- package/components/previews/motion/card-stack.preview.tsx +19 -0
- package/components/previews/motion/card.preview.tsx +14 -0
- package/components/previews/motion/carousel.preview.tsx +17 -0
- package/components/previews/motion/cascader.preview.tsx +54 -0
- package/components/previews/motion/chart.preview.tsx +20 -0
- package/components/previews/motion/chip-group.preview.tsx +20 -0
- package/components/previews/motion/combobox.preview.tsx +1 -1
- package/components/previews/motion/command-menu.preview.tsx +16 -0
- package/components/previews/motion/confirm-morph.preview.tsx +14 -0
- package/components/previews/motion/cookie-consent.preview.tsx +14 -0
- package/components/previews/motion/countdown.preview.tsx +15 -0
- package/components/previews/motion/date-picker.preview.tsx +14 -0
- package/components/previews/motion/delete-with-smoky-dissolve.preview.tsx +14 -0
- package/components/previews/motion/dialog.preview.tsx +24 -0
- package/components/previews/motion/drag-drop-with-physics.preview.tsx +15 -0
- package/components/previews/motion/dropdown-menu-morph.preview.tsx +11 -0
- package/components/previews/motion/dropdown-menu.preview.tsx +19 -0
- package/components/previews/motion/elastic-slider.preview.tsx +14 -0
- package/components/previews/motion/empty-state.preview.tsx +14 -0
- package/components/previews/motion/expandable-card.preview.tsx +14 -0
- package/components/previews/motion/expandable-text.preview.tsx +14 -0
- package/components/previews/motion/expanding-button-group.preview.tsx +18 -0
- package/components/previews/motion/expanding-search.preview.tsx +17 -0
- package/components/previews/motion/file-dropzone.preview.tsx +14 -0
- package/components/previews/motion/filter-toolbar.preview.tsx +15 -0
- package/components/previews/motion/floating-button-group.preview.tsx +14 -0
- package/components/previews/motion/gauge.preview.tsx +14 -0
- package/components/previews/motion/hamburger-menu.preview.tsx +15 -0
- package/components/previews/motion/hold-to-confirm.preview.tsx +16 -0
- package/components/previews/motion/icon-morph.preview.tsx +14 -0
- package/components/previews/motion/image-compare.preview.tsx +17 -0
- package/components/previews/motion/in-view-title.preview.tsx +14 -0
- package/components/previews/motion/inline-edit.preview.tsx +15 -0
- package/components/previews/motion/input-group.preview.tsx +14 -0
- package/components/previews/motion/item.preview.tsx +14 -0
- package/components/previews/motion/label.preview.tsx +14 -0
- package/components/previews/motion/liquid-ripple-button.preview.tsx +14 -0
- package/components/previews/motion/mac-os-folder-cards.preview.tsx +14 -0
- package/components/previews/motion/magnetic-button.preview.tsx +14 -0
- package/components/previews/motion/mention-input.preview.tsx +14 -0
- package/components/previews/motion/menubar.preview.tsx +14 -0
- package/components/previews/motion/money-card.preview.tsx +14 -0
- package/components/previews/motion/money-input.preview.tsx +14 -0
- package/components/previews/motion/morph-select.preview.tsx +14 -0
- package/components/previews/motion/morphing-button.preview.tsx +14 -0
- package/components/previews/motion/morphing-mega-menu.preview.tsx +14 -0
- package/components/previews/motion/navigation-menu.preview.tsx +14 -0
- package/components/previews/motion/neon-edge-button.preview.tsx +14 -0
- package/components/previews/motion/onboarding-checklist.preview.tsx +17 -0
- package/components/previews/motion/organic-shimmer.preview.tsx +18 -0
- package/components/previews/motion/page-transition.preview.tsx +35 -0
- package/components/previews/motion/pagination.preview.tsx +20 -0
- package/components/previews/motion/password-field.preview.tsx +14 -0
- package/components/previews/motion/password-strength.preview.tsx +14 -0
- package/components/previews/motion/peek-card.preview.tsx +14 -0
- package/components/previews/motion/popover.preview.tsx +1 -1
- package/components/previews/motion/profile-card.preview.tsx +14 -0
- package/components/previews/motion/progress.preview.tsx +14 -0
- package/components/previews/motion/radio-cards.preview.tsx +14 -0
- package/components/previews/motion/radio-group.preview.tsx +20 -0
- package/components/previews/motion/rainbow-button.preview.tsx +14 -0
- package/components/previews/motion/raised-button.preview.tsx +14 -0
- package/components/previews/motion/range-histogram-slider.preview.tsx +14 -0
- package/components/previews/motion/reactions.preview.tsx +15 -0
- package/components/previews/motion/resizable-panels.preview.tsx +15 -0
- package/components/previews/motion/resizable.preview.tsx +19 -0
- package/components/previews/motion/rich-text-editor.preview.tsx +14 -0
- package/components/previews/motion/ridgeline.preview.tsx +17 -0
- package/components/previews/motion/scroll-area.preview.tsx +14 -0
- package/components/previews/motion/scrub-input.preview.tsx +14 -0
- package/components/previews/motion/search-field.preview.tsx +15 -0
- package/components/previews/motion/segmented-control.preview.tsx +23 -0
- package/components/previews/motion/select.preview.tsx +1 -1
- package/components/previews/motion/separator.preview.tsx +14 -0
- package/components/previews/motion/shortcut-recorder.preview.tsx +14 -0
- package/components/previews/motion/signature-pad.preview.tsx +14 -0
- package/components/previews/motion/skeleton.preview.tsx +14 -0
- package/components/previews/motion/slider.preview.tsx +14 -0
- package/components/previews/motion/sonner.preview.tsx +14 -0
- package/components/previews/motion/sparkline.preview.tsx +14 -0
- package/components/previews/motion/spinner.preview.tsx +14 -0
- package/components/previews/motion/split-button.preview.tsx +14 -0
- package/components/previews/motion/stepper.preview.tsx +39 -0
- package/components/previews/motion/story-card.preview.tsx +14 -0
- package/components/previews/motion/streamgraph.preview.tsx +18 -0
- package/components/previews/motion/swipe-actions.preview.tsx +18 -0
- package/components/previews/motion/tag-input.preview.tsx +14 -0
- package/components/previews/motion/text-animation.preview.tsx +2 -2
- package/components/previews/motion/text-reveal.preview.tsx +14 -0
- package/components/previews/motion/text-shimmer.preview.tsx +14 -0
- package/components/previews/motion/textarea.preview.tsx +14 -0
- package/components/previews/motion/theme-switch-eclipse.preview.tsx +15 -0
- package/components/previews/motion/theme-switch-rise.preview.tsx +15 -0
- package/components/previews/motion/theme-switch-split.preview.tsx +15 -0
- package/components/previews/motion/theme-switch.preview.tsx +15 -0
- package/components/previews/motion/tilt-card.preview.tsx +2 -2
- package/components/previews/motion/time-picker.preview.tsx +14 -0
- package/components/previews/motion/toast.preview.tsx +14 -0
- package/components/previews/motion/treemap.preview.tsx +17 -0
- package/components/previews/motion/undo-toast.preview.tsx +14 -0
- package/components/previews/motion/usage-meter.preview.tsx +19 -0
- package/components/profile/contact-profile-card.tsx +8 -8
- package/components/ui/button.tsx +59 -0
- package/components/ui/dialog.tsx +149 -0
- package/components/ui/input.tsx +20 -0
- package/components/ui/label.tsx +1 -0
- package/components/ui/loaders-gooey-blobs.tsx +2 -0
- package/components/ui/raised-button.tsx +2 -0
- package/components/ui/separator.tsx +1 -0
- package/components/ui/textarea.tsx +17 -0
- package/lib/arc-provider.tsx +101 -0
- package/lib/colorUtils.ts +34 -0
- package/lib/effects/shared/webgl-surface.jsx +47 -0
- package/lib/foundation.css +192 -0
- package/lib/media.ts +90 -0
- package/lib/motion-tokens.ts +5 -0
- package/lib/particle-delete.ts +500 -0
- package/lib/portal.tsx +23 -0
- package/lib/spring-tokens.ts +25 -0
- package/lib/theme/useTheme.tsx +157 -0
- package/lib/transition-tokens.ts +75 -0
- package/lib/use-copy-feedback.ts +40 -0
- package/lib/use-today.ts +8 -0
- package/lib/utils.ts +10 -0
- package/package.json +32 -4
- package/references/agents/ai-agent-activity.md +45 -0
- package/references/agents/ai-response.md +45 -0
- package/references/agents/ai-status.md +45 -0
- package/references/agents/chat-thread.md +45 -0
- package/references/agents/comment-thread.md +45 -0
- package/references/agents/json-viewer.md +45 -0
- package/references/agents/matrix-orb.md +43 -0
- package/references/agents/text-stream.md +44 -0
- package/references/agents/thinking-orb.md +43 -0
- package/references/agents/web-search.md +44 -0
- package/references/blocks/active-sessions.md +45 -0
- package/references/blocks/activity-feed.md +45 -0
- package/references/blocks/activity-heatmap.md +44 -0
- package/references/blocks/advanced-data-table.md +45 -0
- package/references/blocks/analytics-dashboard.md +43 -0
- package/references/blocks/art-gallery.md +44 -0
- package/references/blocks/bar-chart.md +44 -0
- package/references/blocks/blog-grid.md +45 -0
- package/references/blocks/brush-chart.md +44 -0
- package/references/blocks/changelog-feed.md +47 -0
- package/references/blocks/chat.md +45 -0
- package/references/blocks/comparison-table.md +45 -0
- package/references/blocks/cta-section.md +45 -0
- package/references/blocks/dashboard-shell.md +50 -0
- package/references/blocks/empty-states.md +44 -0
- package/references/blocks/family-drawer.md +46 -0
- package/references/blocks/faq.md +44 -0
- package/references/blocks/footer.md +43 -0
- package/references/blocks/form.md +45 -0
- package/references/blocks/hero-section.md +43 -0
- package/references/blocks/hook-sidebar.md +45 -0
- package/references/blocks/line-chart.md +44 -0
- package/references/blocks/login-centered.md +45 -0
- package/references/blocks/logo-marquee.md +44 -0
- package/references/blocks/newsletter-signup.md +46 -0
- package/references/blocks/notification-center.md +46 -0
- package/references/blocks/page-header.md +47 -0
- package/references/blocks/plan-comparison.md +45 -0
- package/references/blocks/pricing.md +45 -0
- package/references/blocks/product-tour.md +46 -0
- package/references/blocks/proximity-sidebar.md +44 -0
- package/references/blocks/rail-toc.md +44 -0
- package/references/blocks/scroll-progress.md +44 -0
- package/references/blocks/sidebar-stackbits.md +45 -0
- package/references/blocks/sign-in.md +45 -0
- package/references/blocks/site-header.md +46 -0
- package/references/blocks/slope-chart.md +44 -0
- package/references/blocks/sortable-data-table.md +45 -0
- package/references/blocks/stats-band.md +44 -0
- package/references/blocks/status-bars.md +45 -0
- package/references/blocks/step-player.md +45 -0
- package/references/blocks/task-list.md +44 -0
- package/references/blocks/waffle-chart.md +44 -0
- package/references/component-preview-contract.md +42 -0
- package/references/craft/airport-matrix-clock.md +44 -0
- package/references/craft/animated-counter.md +44 -0
- package/references/craft/batch-gesture-tray.md +45 -0
- package/references/craft/car-smoke-page-transition.md +44 -0
- package/references/craft/circular-orbit.md +44 -0
- package/references/craft/click-spark.md +45 -0
- package/references/craft/code-snippet-deck.md +45 -0
- package/references/craft/command.md +45 -0
- package/references/craft/cursor-follower.md +44 -0
- package/references/craft/delete-button.md +44 -0
- package/references/craft/density-lens.md +44 -0
- package/references/craft/dependency-trace.md +44 -0
- package/references/craft/depth-corridor.md +45 -0
- package/references/craft/discover-button.md +44 -0
- package/references/craft/drag-to-confirm.md +45 -0
- package/references/craft/draggable-marquee.md +45 -0
- package/references/craft/duration-picker.md +48 -0
- package/references/craft/emoji-reaction.md +47 -0
- package/references/craft/empty.md +44 -0
- package/references/craft/evil-eye.md +44 -0
- package/references/craft/expandable-data-row.md +45 -0
- package/references/craft/field.md +44 -0
- package/references/craft/file-input.md +46 -0
- package/references/craft/flip-text.md +43 -0
- package/references/craft/fluid-orb.md +43 -0
- package/references/craft/focus-mode.md +45 -0
- package/references/craft/folder-component.md +44 -0
- package/references/craft/github-activity.md +45 -0
- package/references/craft/glitch-text.md +44 -0
- package/references/craft/glyph-matrix.md +43 -0
- package/references/craft/golden-gate-404.md +45 -0
- package/references/craft/gooey-nav.md +45 -0
- package/references/craft/gravity-letters.md +43 -0
- package/references/craft/gravity-particle-burst.md +44 -0
- package/references/craft/grid-reveal.md +44 -0
- package/references/craft/hover-img.md +44 -0
- package/references/craft/input-otp.md +45 -0
- package/references/craft/interactive-area-chart.md +44 -0
- package/references/craft/interactive-timeline.md +45 -0
- package/references/craft/intro-loader.md +45 -0
- package/references/craft/ios-search-bar.md +45 -0
- package/references/craft/liquid-metal.md +45 -0
- package/references/craft/liquid-toggle.md +44 -0
- package/references/craft/loaders-gooey-blobs.md +44 -0
- package/references/craft/lock-input.md +44 -0
- package/references/craft/login.md +45 -0
- package/references/craft/meteors.md +43 -0
- package/references/craft/metric-hud.md +45 -0
- package/references/craft/morphing-blob.md +44 -0
- package/references/craft/morphing-dialog.md +45 -0
- package/references/craft/morphing-icon.md +44 -0
- package/references/craft/morphing-shape-loader.md +44 -0
- package/references/craft/nimbu-mirchi.md +44 -0
- package/references/craft/notification-bell.md +45 -0
- package/references/craft/orbital-loading-ring.md +43 -0
- package/references/craft/origin-dropdown.md +45 -0
- package/references/craft/particle-delete.md +44 -0
- package/references/craft/payment-receipt-printer.md +45 -0
- package/references/craft/payment-status.md +45 -0
- package/references/craft/recovery-ledger.md +45 -0
- package/references/craft/rocket-party-popper.md +45 -0
- package/references/craft/scroll-progress-nav.md +45 -0
- package/references/craft/scrollvelocitytext.md +43 -0
- package/references/craft/selection-basket.md +45 -0
- package/references/craft/sheet.md +46 -0
- package/references/craft/shooting-stars.md +44 -0
- package/references/craft/sidebar.md +45 -0
- package/references/craft/sign-up.md +45 -0
- package/references/craft/skeumorphic-music-card.md +45 -0
- package/references/craft/slide-pagination.md +45 -0
- package/references/craft/slot-text.md +44 -0
- package/references/craft/smart-comparison.md +45 -0
- package/references/craft/smooth-scroll.md +44 -0
- package/references/craft/speed-warp.md +43 -0
- package/references/craft/split-showcase.md +44 -0
- package/references/craft/spotlight-search.md +45 -0
- package/references/craft/stack-unfold-panel.md +45 -0
- package/references/craft/sticky-pages.md +43 -0
- package/references/craft/text-scramble-decoder.md +44 -0
- package/references/craft/toggle.md +45 -0
- package/references/craft/torque-dial.md +44 -0
- package/references/craft/v-prism.md +46 -0
- package/references/craft/voice-note.md +44 -0
- package/references/guides/better-accessibility.md +104 -0
- package/references/guides/better-colors.md +88 -0
- package/references/guides/better-interface.md +187 -0
- package/references/guides/better-layout.md +79 -0
- package/references/guides/better-typography.md +136 -0
- package/references/guides/better-ui.md +113 -0
- package/references/guides/better-writing.md +115 -0
- package/references/guides/dark-neutral-design-system.md +776 -0
- package/references/guides/fluid-interaction-conventions.md +30 -0
- package/references/guides/interface-review.md +142 -0
- package/references/guides/spring-motion-system.md +232 -0
- package/references/motion/accordion.md +46 -0
- package/references/motion/action-button.md +45 -0
- package/references/motion/alert.md +45 -0
- package/references/motion/avatar.md +44 -0
- package/references/motion/badge.md +44 -0
- package/references/motion/billing-toggle.md +44 -0
- package/references/motion/book-call-button.md +44 -0
- package/references/motion/branching-submenu.md +45 -0
- package/references/motion/button-group.md +46 -0
- package/references/motion/calendar.md +45 -0
- package/references/motion/card-stack.md +45 -0
- package/references/motion/card.md +46 -0
- package/references/motion/carousel.md +45 -0
- package/references/motion/chart.md +52 -0
- package/references/motion/chip-group.md +44 -0
- package/references/motion/command-menu.md +45 -0
- package/references/motion/confirm-morph.md +45 -0
- package/references/motion/cookie-consent.md +45 -0
- package/references/motion/countdown.md +44 -0
- package/references/motion/date-picker.md +45 -0
- package/references/motion/dialog.md +46 -0
- package/references/motion/dropdown-menu.md +46 -0
- package/references/motion/elastic-slider.md +44 -0
- package/references/motion/empty-state.md +45 -0
- package/references/motion/expandable-card.md +45 -0
- package/references/motion/expandable-text.md +45 -0
- package/references/motion/expanding-button-group.md +44 -0
- package/references/motion/expanding-search.md +46 -0
- package/references/motion/file-dropzone.md +45 -0
- package/references/motion/filter-toolbar.md +45 -0
- package/references/motion/floating-button-group.md +45 -0
- package/references/motion/gauge.md +44 -0
- package/references/motion/hamburger-menu.md +44 -0
- package/references/motion/hold-to-confirm.md +45 -0
- package/references/motion/icon-morph.md +44 -0
- package/references/motion/image-compare.md +45 -0
- package/references/motion/in-view-title.md +44 -0
- package/references/motion/inline-edit.md +45 -0
- package/references/motion/input-group.md +44 -0
- package/references/motion/item.md +45 -0
- package/references/motion/label.md +44 -0
- package/references/motion/liquid-ripple-button.md +45 -0
- package/references/motion/mac-os-folder-cards.md +45 -0
- package/references/motion/magnetic-button.md +44 -0
- package/references/motion/mention-input.md +45 -0
- package/references/motion/menubar.md +45 -0
- package/references/motion/money-card.md +46 -0
- package/references/motion/money-input.md +45 -0
- package/references/motion/morph-select.md +45 -0
- package/references/motion/morphing-button.md +45 -0
- package/references/motion/morphing-mega-menu.md +44 -0
- package/references/motion/navigation-menu.md +46 -0
- package/references/motion/neon-edge-button.md +44 -0
- package/references/motion/onboarding-checklist.md +45 -0
- package/references/motion/password-field.md +44 -0
- package/references/motion/password-strength.md +44 -0
- package/references/motion/peek-card.md +45 -0
- package/references/motion/profile-card.md +44 -0
- package/references/motion/progress.md +45 -0
- package/references/motion/radio-cards.md +44 -0
- package/references/motion/radio-group.md +44 -0
- package/references/motion/rainbow-button.md +43 -0
- package/references/motion/raised-button.md +45 -0
- package/references/motion/range-histogram-slider.md +44 -0
- package/references/motion/reactions.md +46 -0
- package/references/motion/resizable-panels.md +45 -0
- package/references/motion/resizable.md +45 -0
- package/references/motion/rich-text-editor.md +45 -0
- package/references/motion/ridgeline.md +44 -0
- package/references/motion/scroll-area.md +43 -0
- package/references/motion/scrub-input.md +45 -0
- package/references/motion/search-field.md +45 -0
- package/references/motion/separator.md +44 -0
- package/references/motion/shortcut-recorder.md +45 -0
- package/references/motion/signature-pad.md +45 -0
- package/references/motion/skeleton.md +44 -0
- package/references/motion/slider.md +44 -0
- package/references/motion/sonner.md +46 -0
- package/references/motion/sparkline.md +44 -0
- package/references/motion/spinner.md +44 -0
- package/references/motion/split-button.md +46 -0
- package/references/motion/story-card.md +44 -0
- package/references/motion/streamgraph.md +44 -0
- package/references/motion/swipe-actions.md +46 -0
- package/references/motion/tag-input.md +45 -0
- package/references/motion/text-reveal.md +43 -0
- package/references/motion/text-shimmer.md +44 -0
- package/references/motion/textarea.md +44 -0
- package/references/motion/theme-switch-eclipse.md +45 -0
- package/references/motion/theme-switch-rise.md +45 -0
- package/references/motion/theme-switch-split.md +45 -0
- package/references/motion/theme-switch.md +45 -0
- package/references/motion/time-picker.md +45 -0
- package/references/motion/toast.md +45 -0
- package/references/motion/treemap.md +44 -0
- package/references/motion/undo-toast.md +45 -0
- package/references/motion/usage-meter.md +45 -0
- package/scripts/build_docs.py +209 -205
- package/scripts/verify_skill.py +4 -4
- package/test/test_installer.mjs +31 -1
- 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
|
+
}
|