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,364 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import { forwardRef, useCallback, useEffect, useId, useImperativeHandle, useLayoutEffect, useRef, useState, useSyncExternalStore } from "react";
|
|
4
|
+
import type { KeyboardEvent as ReactKeyboardEvent, ReactNode } from "react";
|
|
5
|
+
import { AnimatePresence, animate, motion, useIsPresent, useMotionValue, useReducedMotion } from "motion/react";
|
|
6
|
+
import type { Transition, Variants } from "motion/react";
|
|
7
|
+
import { Cookie, X } from "lucide-react";
|
|
8
|
+
import Button from "@/components/motion/button";
|
|
9
|
+
import { Switch } from "@/components/motion/switch";
|
|
10
|
+
import { motionTokens } from "@/lib/motion-tokens";
|
|
11
|
+
import styles from "./cookie-consent.module.css";
|
|
12
|
+
|
|
13
|
+
/** One group of cookies a visitor can allow or refuse. */
|
|
14
|
+
export interface CookieCategory {
|
|
15
|
+
id: string;
|
|
16
|
+
label: string;
|
|
17
|
+
description?: string;
|
|
18
|
+
/** Needed for the site to work. Always on and cannot be switched off. */
|
|
19
|
+
required?: boolean;
|
|
20
|
+
/** Starting position of the switch before a choice is saved. Non-essential categories default to off. */
|
|
21
|
+
defaultEnabled?: boolean;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** Category id to allowed. */
|
|
25
|
+
export type CookieConsentValue = Record<string, boolean>;
|
|
26
|
+
export type CookieConsentAction = "accept-all" | "reject-all" | "save" | "reset";
|
|
27
|
+
|
|
28
|
+
/** What is written to storage under `storageKey`. */
|
|
29
|
+
export interface StoredCookieConsent {
|
|
30
|
+
value: CookieConsentValue;
|
|
31
|
+
version: string;
|
|
32
|
+
updatedAt: string;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export interface CookieConsentHandle {
|
|
36
|
+
/** Opens the preferences panel, for example from a "Cookie settings" footer link. */
|
|
37
|
+
openPreferences: () => void;
|
|
38
|
+
/** Closes the preferences panel without saving. */
|
|
39
|
+
closePreferences: () => void;
|
|
40
|
+
/** Forgets the saved choice and asks again. */
|
|
41
|
+
reset: () => void;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
export interface CookieConsentLabels {
|
|
45
|
+
message: ReactNode;
|
|
46
|
+
customize: string;
|
|
47
|
+
acceptAll: string;
|
|
48
|
+
rejectAll: string;
|
|
49
|
+
save: string;
|
|
50
|
+
preferencesTitle: string;
|
|
51
|
+
preferencesDescription: ReactNode;
|
|
52
|
+
reopen: string;
|
|
53
|
+
alwaysOn: string;
|
|
54
|
+
close: string;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* A consent bar that morphs into a preferences panel and, once a choice is saved, folds into a small floating button that
|
|
59
|
+
* reopens it. One surface springs between all three shapes. Non-essential categories start off, refusing is as easy as
|
|
60
|
+
* accepting, and the choice is reported through `onChange` and can be remembered in `localStorage`.
|
|
61
|
+
*/
|
|
62
|
+
export interface CookieConsentProps {
|
|
63
|
+
categories?: CookieCategory[];
|
|
64
|
+
/** The saved choice. `null` means the visitor has not decided yet. Leave it out to let the component manage it. */
|
|
65
|
+
value?: CookieConsentValue | null;
|
|
66
|
+
defaultValue?: CookieConsentValue | null;
|
|
67
|
+
onChange?: (value: CookieConsentValue | null, detail: { action: CookieConsentAction; updatedAt: Date }) => void;
|
|
68
|
+
/** Remembers the choice in `localStorage` under this key. Read it elsewhere with `readCookieConsent`. */
|
|
69
|
+
storageKey?: string;
|
|
70
|
+
/** Bump when your categories or policy change to ask again. */
|
|
71
|
+
version?: string;
|
|
72
|
+
/** Whether the preferences panel is open. */
|
|
73
|
+
preferencesOpen?: boolean;
|
|
74
|
+
defaultPreferencesOpen?: boolean;
|
|
75
|
+
onPreferencesOpenChange?: (open: boolean) => void;
|
|
76
|
+
/** Link to the full policy, shown in the bar and panel. */
|
|
77
|
+
policy?: { label: string; href?: string; onClick?: () => void };
|
|
78
|
+
position?: "bottom" | "bottom-left" | "bottom-right";
|
|
79
|
+
/** `fixed` pins to the viewport; `absolute` fills the nearest positioned ancestor, useful for previews. */
|
|
80
|
+
strategy?: "fixed" | "absolute";
|
|
81
|
+
/** Keep a small button after a choice so visitors can change their mind. Defaults to true. */
|
|
82
|
+
showReopenButton?: boolean;
|
|
83
|
+
/** Corner for the reopen button. Defaults to the bar's side, or left when the bar is centered. */
|
|
84
|
+
reopenSide?: "left" | "right";
|
|
85
|
+
labels?: Partial<CookieConsentLabels>;
|
|
86
|
+
className?: string;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
export const defaultCookieCategories: CookieCategory[] = [
|
|
90
|
+
{ id: "necessary", label: "Strictly necessary", description: "Sign-in, security, and your cart. The site can't work without these.", required: true },
|
|
91
|
+
{ id: "preferences", label: "Preferences", description: "Remember your language, region, and display settings." },
|
|
92
|
+
{ id: "analytics", label: "Analytics", description: "Count visits and see which pages help, only in aggregate." },
|
|
93
|
+
{ id: "marketing", label: "Marketing", description: "Measure campaigns and show relevant ads on other sites." },
|
|
94
|
+
];
|
|
95
|
+
|
|
96
|
+
const defaultLabels: CookieConsentLabels = {
|
|
97
|
+
message: "We use essential cookies to run this site. With your OK, we'd also use optional ones to remember settings and learn what helps.",
|
|
98
|
+
customize: "Customize",
|
|
99
|
+
acceptAll: "Accept all",
|
|
100
|
+
rejectAll: "Reject all",
|
|
101
|
+
save: "Save choices",
|
|
102
|
+
preferencesTitle: "Cookie preferences",
|
|
103
|
+
preferencesDescription: "Choose which optional cookies we can use. You can change this any time.",
|
|
104
|
+
reopen: "Cookie preferences",
|
|
105
|
+
alwaysOn: "Always on",
|
|
106
|
+
close: "Close preferences",
|
|
107
|
+
};
|
|
108
|
+
|
|
109
|
+
/** Reads a saved choice, or `null` when there is none or it was saved for another version. Safe to call on the server. */
|
|
110
|
+
export function readCookieConsent(storageKey: string, version = "1"): StoredCookieConsent | null {
|
|
111
|
+
if (typeof window === "undefined") return null;
|
|
112
|
+
try {
|
|
113
|
+
const raw = window.localStorage.getItem(storageKey);
|
|
114
|
+
if (!raw) return null;
|
|
115
|
+
const parsed = JSON.parse(raw) as Partial<StoredCookieConsent>;
|
|
116
|
+
if (!parsed || typeof parsed.value !== "object" || parsed.value === null || parsed.version !== version) return null;
|
|
117
|
+
return { value: parsed.value, version: parsed.version, updatedAt: String(parsed.updatedAt ?? "") };
|
|
118
|
+
} catch {
|
|
119
|
+
return null;
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
function writeCookieConsent(storageKey: string, stored: StoredCookieConsent | null) {
|
|
124
|
+
try {
|
|
125
|
+
if (stored) window.localStorage.setItem(storageKey, JSON.stringify(stored));
|
|
126
|
+
else window.localStorage.removeItem(storageKey);
|
|
127
|
+
} catch { /* Storage can be blocked; the callback still reports the choice. */ }
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
type Mode = "bar" | "panel" | "chip";
|
|
131
|
+
type Bezier = [number, number, number, number];
|
|
132
|
+
const enter = [...motionTokens.ease.enter] as Bezier;
|
|
133
|
+
const standard = [...motionTokens.ease.standard] as Bezier;
|
|
134
|
+
/** Duration springs restated as stiffness and damping, so a retarget mid-flight keeps its velocity. */
|
|
135
|
+
const physical = (visualDuration: number, bounce: number): Transition => {
|
|
136
|
+
const root = 2 * Math.PI / (visualDuration * 1.2);
|
|
137
|
+
return { type: "spring", stiffness: root * root, damping: 2 * (1 - bounce) * root, mass: 1 };
|
|
138
|
+
};
|
|
139
|
+
const GROW = physical(.46, 0), SHRINK = physical(.38, 0);
|
|
140
|
+
const BAR_MAX = 660, PANEL_MAX = 420, CHIP = 44, STACK_BELOW = 560;
|
|
141
|
+
|
|
142
|
+
const subscribe = () => () => {};
|
|
143
|
+
function useHydrated() { return useSyncExternalStore(subscribe, () => true, () => false); }
|
|
144
|
+
|
|
145
|
+
const faceVariants: Variants = {
|
|
146
|
+
hidden: { opacity: 0, y: 10, filter: `blur(${motionTokens.blur.soft}px)` },
|
|
147
|
+
shown: { opacity: 1, y: 0, filter: "blur(0px)", transition: { y: physical(.42, 0), opacity: { duration: .22, ease: enter, delay: .04 }, filter: { duration: .26, ease: enter, delay: .04 } } },
|
|
148
|
+
gone: { opacity: 0, y: 4, filter: `blur(${motionTokens.blur.soft}px)`, transition: { duration: .12, ease: standard } },
|
|
149
|
+
};
|
|
150
|
+
const fadeVariants: Variants = { hidden: { opacity: 0 }, shown: { opacity: 1, transition: { duration: .16 } }, gone: { opacity: 0, transition: { duration: .1 } } };
|
|
151
|
+
|
|
152
|
+
/** A face reports its natural height while it is current, then goes inert as it leaves. It is pinned to the side the surface is placed on, so a
|
|
153
|
+
* centered bar and panel cross-fade in place instead of the incoming face sliding in from the surface's left edge. */
|
|
154
|
+
function Face({ id, width, side, reduced, focusOnMount, onSize, className, children, ...rest }: { id: Mode; width: number; side: "left" | "right" | "center"; reduced: boolean; focusOnMount: boolean; onSize: (id: Mode, height: number) => void; className?: string; children: ReactNode; role?: string; "aria-modal"?: boolean; "aria-labelledby"?: string; "aria-describedby"?: string; "aria-label"?: string; onKeyDown?: (event: ReactKeyboardEvent<HTMLDivElement>) => void }) {
|
|
155
|
+
const ref = useRef<HTMLDivElement>(null);
|
|
156
|
+
const present = useIsPresent();
|
|
157
|
+
useLayoutEffect(() => {
|
|
158
|
+
const node = ref.current;
|
|
159
|
+
if (!node || !present) return;
|
|
160
|
+
const report = () => onSize(id, node.offsetHeight);
|
|
161
|
+
report();
|
|
162
|
+
if (typeof ResizeObserver === "undefined") return;
|
|
163
|
+
const observer = new ResizeObserver(report);
|
|
164
|
+
observer.observe(node);
|
|
165
|
+
return () => observer.disconnect();
|
|
166
|
+
}, [id, onSize, present]);
|
|
167
|
+
useEffect(() => {
|
|
168
|
+
if (!focusOnMount) return;
|
|
169
|
+
ref.current?.querySelector<HTMLElement>("[data-autofocus]")?.focus({ preventScroll: true });
|
|
170
|
+
}, [focusOnMount]);
|
|
171
|
+
return <motion.div {...rest} ref={ref} className={[styles.face, className].filter(Boolean).join(" ")} style={{ width }} data-face={id} data-side={side}
|
|
172
|
+
variants={reduced ? fadeVariants : faceVariants} initial="hidden" animate="shown" exit="gone" inert={!present || undefined}>{children}</motion.div>;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
export const CookieConsent = forwardRef<CookieConsentHandle, CookieConsentProps>(function CookieConsent({
|
|
176
|
+
categories = defaultCookieCategories, value, defaultValue = null, onChange, storageKey, version = "1",
|
|
177
|
+
preferencesOpen, defaultPreferencesOpen = false, onPreferencesOpenChange, policy, position = "bottom", strategy = "fixed",
|
|
178
|
+
showReopenButton = true, reopenSide, labels: labelOverrides, className,
|
|
179
|
+
}, ref) {
|
|
180
|
+
const labels = { ...defaultLabels, ...labelOverrides };
|
|
181
|
+
const reduced = !!useReducedMotion();
|
|
182
|
+
const hydrated = useHydrated();
|
|
183
|
+
const uid = useId();
|
|
184
|
+
const titleId = `${uid}-title`, descriptionId = `${uid}-description`, messageId = `${uid}-message`;
|
|
185
|
+
|
|
186
|
+
/* The saved choice: controlled, or internal and seeded from storage once on the client. */
|
|
187
|
+
const [internal, setInternal] = useState<CookieConsentValue | null>(defaultValue);
|
|
188
|
+
const [loaded, setLoaded] = useState(!storageKey || value !== undefined);
|
|
189
|
+
useEffect(() => {
|
|
190
|
+
if (loaded || !storageKey) return;
|
|
191
|
+
const stored = readCookieConsent(storageKey, version);
|
|
192
|
+
// Storage is only readable after hydration; this runs once to seed the saved choice.
|
|
193
|
+
// eslint-disable-next-line react-hooks/set-state-in-effect
|
|
194
|
+
if (stored) setInternal(stored.value);
|
|
195
|
+
setLoaded(true);
|
|
196
|
+
}, [loaded, storageKey, version]);
|
|
197
|
+
const consent = value !== undefined ? value : internal;
|
|
198
|
+
const decided = consent != null;
|
|
199
|
+
|
|
200
|
+
const [panelInternal, setPanelInternal] = useState(defaultPreferencesOpen);
|
|
201
|
+
const panelOpen = preferencesOpen ?? panelInternal;
|
|
202
|
+
const setPanel = useCallback((next: boolean) => {
|
|
203
|
+
if (preferencesOpen === undefined) setPanelInternal(next);
|
|
204
|
+
onPreferencesOpenChange?.(next);
|
|
205
|
+
}, [onPreferencesOpenChange, preferencesOpen]);
|
|
206
|
+
|
|
207
|
+
const baseline = useCallback((from: CookieConsentValue | null) => Object.fromEntries(categories.map(category => [category.id, category.required ? true : from?.[category.id] ?? category.defaultEnabled ?? false])), [categories]);
|
|
208
|
+
const [draft, setDraft] = useState<CookieConsentValue>(() => baseline(consent));
|
|
209
|
+
const [focusTarget, setFocusTarget] = useState<Mode | null>(null);
|
|
210
|
+
|
|
211
|
+
const mode: Mode | null = !hydrated || !loaded ? null : panelOpen ? "panel" : !decided ? "bar" : showReopenButton ? "chip" : null;
|
|
212
|
+
|
|
213
|
+
const openPanel = useCallback((focus = true) => {
|
|
214
|
+
setDraft(baseline(consent));
|
|
215
|
+
setFocusTarget(focus ? "panel" : null);
|
|
216
|
+
setPanel(true);
|
|
217
|
+
}, [baseline, consent, setPanel]);
|
|
218
|
+
|
|
219
|
+
const closePanel = useCallback((focus = true) => {
|
|
220
|
+
setFocusTarget(focus ? (decided ? "chip" : "bar") : null);
|
|
221
|
+
setPanel(false);
|
|
222
|
+
}, [decided, setPanel]);
|
|
223
|
+
|
|
224
|
+
const commit = useCallback((next: CookieConsentValue | null, action: CookieConsentAction) => {
|
|
225
|
+
const updatedAt = new Date();
|
|
226
|
+
if (value === undefined) setInternal(next);
|
|
227
|
+
if (storageKey) writeCookieConsent(storageKey, next ? { value: next, version, updatedAt: updatedAt.toISOString() } : null);
|
|
228
|
+
onChange?.(next, { action, updatedAt });
|
|
229
|
+
}, [onChange, storageKey, value, version]);
|
|
230
|
+
|
|
231
|
+
const choose = (action: "accept-all" | "reject-all" | "save") => {
|
|
232
|
+
const next = action === "save" ? { ...draft } : Object.fromEntries(categories.map(category => [category.id, category.required ? true : action === "accept-all"]));
|
|
233
|
+
// Keep focus on the page: the choice folds the surface into its reopen button, which takes focus when it exists.
|
|
234
|
+
setFocusTarget(showReopenButton ? "chip" : null);
|
|
235
|
+
commit(next, action);
|
|
236
|
+
if (panelOpen) setPanel(false);
|
|
237
|
+
};
|
|
238
|
+
|
|
239
|
+
useImperativeHandle(ref, () => ({
|
|
240
|
+
openPreferences: () => openPanel(true),
|
|
241
|
+
closePreferences: () => closePanel(false),
|
|
242
|
+
reset: () => { setPanel(false); setFocusTarget(null); commit(null, "reset"); },
|
|
243
|
+
}), [closePanel, commit, openPanel, setPanel]);
|
|
244
|
+
|
|
245
|
+
/* Geometry. The layer is measured; each face gets an explicit width, reports its height, and the surface springs to it. */
|
|
246
|
+
const layerRef = useRef<HTMLDivElement>(null);
|
|
247
|
+
const [layerWidth, setLayerWidth] = useState(0);
|
|
248
|
+
useLayoutEffect(() => {
|
|
249
|
+
const node = layerRef.current;
|
|
250
|
+
if (!node) return;
|
|
251
|
+
const read = () => setLayerWidth(node.clientWidth);
|
|
252
|
+
read();
|
|
253
|
+
if (typeof ResizeObserver === "undefined") return;
|
|
254
|
+
const observer = new ResizeObserver(read);
|
|
255
|
+
observer.observe(node);
|
|
256
|
+
return () => observer.disconnect();
|
|
257
|
+
}, []);
|
|
258
|
+
|
|
259
|
+
const align = position === "bottom-left" ? "left" : position === "bottom-right" ? "right" : "center";
|
|
260
|
+
const chipSide = reopenSide ?? (align === "right" ? "right" : "left");
|
|
261
|
+
const widths = { bar: Math.min(layerWidth, BAR_MAX), panel: Math.min(layerWidth, PANEL_MAX), chip: CHIP };
|
|
262
|
+
const place = (width: number, side: "left" | "right" | "center") => side === "left" ? 0 : side === "right" ? layerWidth - width : (layerWidth - width) / 2;
|
|
263
|
+
// Reopened preferences grow out of the corner button, so the panel opens on its side once a choice exists.
|
|
264
|
+
const panelSide = decided && showReopenButton ? chipSide : align;
|
|
265
|
+
|
|
266
|
+
const x = useMotionValue(0), width = useMotionValue(0), height = useMotionValue(0), radius = useMotionValue(22);
|
|
267
|
+
const heights = useRef<Record<Mode, number>>({ bar: 0, panel: 0, chip: CHIP });
|
|
268
|
+
const shape = useRef({ w: 0, h: 0, ready: false });
|
|
269
|
+
const [tick, setTick] = useState(0);
|
|
270
|
+
const onSize = useCallback((id: Mode, h: number) => {
|
|
271
|
+
if (heights.current[id] === h) return;
|
|
272
|
+
heights.current[id] = h;
|
|
273
|
+
setTick(count => count + 1);
|
|
274
|
+
}, []);
|
|
275
|
+
|
|
276
|
+
useLayoutEffect(() => {
|
|
277
|
+
if (!mode || !layerWidth) { shape.current.ready = false; return; }
|
|
278
|
+
const w = widths[mode], h = mode === "chip" ? CHIP : heights.current[mode];
|
|
279
|
+
if (!h) return;
|
|
280
|
+
const next = { x: place(w, mode === "chip" ? chipSide : mode === "panel" ? panelSide : align), w, h, r: mode === "chip" ? CHIP / 2 : mode === "panel" ? 26 : 22 };
|
|
281
|
+
if (!shape.current.ready || reduced) {
|
|
282
|
+
x.jump(next.x); width.jump(next.w); height.jump(next.h); radius.jump(next.r);
|
|
283
|
+
shape.current = { w: next.w, h: next.h, ready: true };
|
|
284
|
+
return;
|
|
285
|
+
}
|
|
286
|
+
const transition = next.w * next.h >= shape.current.w * shape.current.h ? GROW : SHRINK;
|
|
287
|
+
shape.current = { w: next.w, h: next.h, ready: true };
|
|
288
|
+
animate(x, next.x, transition); animate(width, next.w, transition); animate(height, next.h, transition); animate(radius, next.r, transition);
|
|
289
|
+
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
290
|
+
}, [mode, layerWidth, tick, reduced, align, chipSide, panelSide]);
|
|
291
|
+
|
|
292
|
+
const onPanelKeyDown = (event: ReactKeyboardEvent<HTMLDivElement>) => {
|
|
293
|
+
if (event.key !== "Escape") return;
|
|
294
|
+
event.stopPropagation();
|
|
295
|
+
closePanel(true);
|
|
296
|
+
};
|
|
297
|
+
|
|
298
|
+
const policyLink = policy ? policy.href
|
|
299
|
+
? <a className={styles.policy} href={policy.href} onClick={policy.onClick}>{policy.label}</a>
|
|
300
|
+
: <button type="button" className={styles.policy} onClick={policy.onClick}>{policy.label}</button> : null;
|
|
301
|
+
const optional = categories.filter(category => !category.required);
|
|
302
|
+
const allowedCount = optional.filter(category => draft[category.id]).length;
|
|
303
|
+
|
|
304
|
+
return <div ref={layerRef} className={[styles.layer, strategy === "absolute" ? styles.absolute : "", className].filter(Boolean).join(" ")} data-position={position}>
|
|
305
|
+
<AnimatePresence>
|
|
306
|
+
{mode ? <motion.div key="surface" className={styles.surface} style={{ x, width, height, borderRadius: radius }}
|
|
307
|
+
initial={reduced ? { opacity: 0 } : { opacity: 0, y: 24, scale: .98 }}
|
|
308
|
+
animate={{ opacity: 1, y: 0, scale: 1, transition: reduced ? { duration: .16 } : { y: physical(.5, 0), scale: physical(.5, 0), opacity: { duration: .24, ease: enter } } }}
|
|
309
|
+
exit={reduced ? { opacity: 0, transition: { duration: .12 } } : { opacity: 0, y: 12, scale: .96, transition: { duration: .18, ease: standard } }}>
|
|
310
|
+
<AnimatePresence initial={false}>
|
|
311
|
+
{mode === "bar" ? <Face key="bar" id="bar" width={widths.bar} side={align} reduced={reduced} onSize={onSize} focusOnMount={focusTarget === "bar"}
|
|
312
|
+
className={styles.bar} role="dialog" aria-modal={false} aria-label={labels.preferencesTitle} aria-describedby={messageId}>
|
|
313
|
+
<div className={styles.barInner} data-stack={widths.bar < STACK_BELOW || undefined}>
|
|
314
|
+
<p id={messageId} className={styles.message}>{labels.message}{policyLink ? <> {policyLink}</> : null}</p>
|
|
315
|
+
<div className={styles.barActions}>
|
|
316
|
+
<Button size="sm" variant="ghost" data-autofocus onClick={() => openPanel(true)}>{labels.customize}</Button>
|
|
317
|
+
<Button size="sm" variant="secondary" onClick={() => choose("reject-all")}>{labels.rejectAll}</Button>
|
|
318
|
+
<Button size="sm" variant="secondary" onClick={() => choose("accept-all")}>{labels.acceptAll}</Button>
|
|
319
|
+
</div>
|
|
320
|
+
</div>
|
|
321
|
+
</Face> : null}
|
|
322
|
+
|
|
323
|
+
{mode === "panel" ? <Face key="panel" id="panel" width={widths.panel} side={panelSide} reduced={reduced} onSize={onSize} focusOnMount={focusTarget === "panel"}
|
|
324
|
+
className={styles.panel} role="dialog" aria-modal={false} aria-labelledby={titleId} aria-describedby={descriptionId} onKeyDown={onPanelKeyDown}>
|
|
325
|
+
<div className={styles.panelHead}>
|
|
326
|
+
<h2 id={titleId} className={styles.title} tabIndex={-1} data-autofocus>{labels.preferencesTitle}</h2>
|
|
327
|
+
<button type="button" className={styles.iconButton} aria-label={labels.close} onClick={() => closePanel(true)}><X size={16} strokeWidth={1.75} aria-hidden="true" /></button>
|
|
328
|
+
</div>
|
|
329
|
+
<p id={descriptionId} className={styles.description}>{labels.preferencesDescription}{policyLink ? <> {policyLink}</> : null}</p>
|
|
330
|
+
<ul className={styles.list}>
|
|
331
|
+
{categories.map(category => {
|
|
332
|
+
const switchId = `${uid}-${category.id}`, hintId = `${switchId}-hint`;
|
|
333
|
+
return <li key={category.id} className={styles.row}>
|
|
334
|
+
<div className={styles.rowText}>
|
|
335
|
+
<label htmlFor={category.required ? undefined : switchId} className={styles.rowLabel}>{category.label}</label>
|
|
336
|
+
{category.description ? <p id={hintId} className={styles.rowHint}>{category.description}</p> : null}
|
|
337
|
+
</div>
|
|
338
|
+
{category.required
|
|
339
|
+
? <span className={styles.always}>{labels.alwaysOn}</span>
|
|
340
|
+
: <Switch id={switchId} aria-describedby={category.description ? hintId : undefined} checked={!!draft[category.id]}
|
|
341
|
+
onCheckedChange={checked => setDraft(current => ({ ...current, [category.id]: checked }))} />}
|
|
342
|
+
</li>;
|
|
343
|
+
})}
|
|
344
|
+
</ul>
|
|
345
|
+
<div className={styles.panelActions}>
|
|
346
|
+
<Button size="sm" variant="secondary" onClick={() => choose("reject-all")}>{labels.rejectAll}</Button>
|
|
347
|
+
<Button size="sm" variant="secondary" onClick={() => choose("accept-all")}>{labels.acceptAll}</Button>
|
|
348
|
+
<Button size="sm" variant="primary" className={styles.save} onClick={() => choose("save")} aria-describedby={`${uid}-count`}>{labels.save}</Button>
|
|
349
|
+
<span id={`${uid}-count`} className={styles.srOnly}>{`${allowedCount} of ${optional.length} optional categories allowed`}</span>
|
|
350
|
+
</div>
|
|
351
|
+
</Face> : null}
|
|
352
|
+
|
|
353
|
+
{mode === "chip" ? <Face key="chip" id="chip" width={CHIP} side={chipSide} reduced={reduced} onSize={onSize} focusOnMount={focusTarget === "chip"} className={styles.chipFace}>
|
|
354
|
+
<button type="button" className={styles.chip} aria-label={labels.reopen} aria-haspopup="dialog" data-autofocus onClick={() => openPanel(true)}>
|
|
355
|
+
<Cookie size={20} strokeWidth={1.75} aria-hidden="true" />
|
|
356
|
+
</button>
|
|
357
|
+
</Face> : null}
|
|
358
|
+
</AnimatePresence>
|
|
359
|
+
</motion.div> : null}
|
|
360
|
+
</AnimatePresence>
|
|
361
|
+
</div>;
|
|
362
|
+
});
|
|
363
|
+
|
|
364
|
+
export default CookieConsent;
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
.countdown { position: relative; min-width: 0; color: var(--foreground); font-family: var(--font-body); letter-spacing: var(--tracking-body); }
|
|
2
|
+
.countdown[data-variant="large"] { container-type: inline-size; display: flex; justify-content: center; }
|
|
3
|
+
.countdown[data-variant="compact"] { display: inline-flex; vertical-align: middle; }
|
|
4
|
+
|
|
5
|
+
/* The shell springs to whatever it holds; the compact pill shows that morph as its own outline. */
|
|
6
|
+
.shell { position: relative; display: flex; justify-content: center; }
|
|
7
|
+
.content { position: relative; display: inline-flex; flex: none; align-items: center; justify-content: center; }
|
|
8
|
+
.countdown[data-variant="compact"] .shell { overflow: hidden; border: 1px solid var(--border); border-radius: var(--radius-pill); background: var(--surface); transition: border-color var(--duration-standard) var(--ease-standard), background-color var(--duration-standard) var(--ease-standard); }
|
|
9
|
+
.countdown[data-variant="compact"] .content { min-height: 32px; padding: 0 var(--space-3); }
|
|
10
|
+
.countdown[data-variant="compact"][data-complete] .shell { border-color: color-mix(in oklab, var(--success) 35%, var(--border)); background: color-mix(in oklab, var(--success) 9%, var(--surface)); }
|
|
11
|
+
|
|
12
|
+
.units { display: inline-flex; align-items: flex-start; white-space: nowrap; }
|
|
13
|
+
.unit { display: inline-flex; align-items: flex-start; }
|
|
14
|
+
.group { display: inline-grid; justify-items: center; gap: 6px; }
|
|
15
|
+
.number { display: inline-flex; font-variant-numeric: tabular-nums; transition: opacity var(--duration-considered) var(--ease-standard); }
|
|
16
|
+
.countdown[data-pending] .number { opacity: .3; }
|
|
17
|
+
.name { color: var(--text-muted); font-size: var(--text-xs); line-height: 1; }
|
|
18
|
+
.colon { color: var(--text-muted); opacity: .6; }
|
|
19
|
+
|
|
20
|
+
/* Large: display digits sized to the container, so four groups fit at 320px and breathe on a wide card. */
|
|
21
|
+
.countdown[data-variant="large"] .units { gap: 0; font-family: var(--font-display); font-size: clamp(1.75rem, 12.5cqi, var(--text-5xl)); font-weight: 500; letter-spacing: var(--tracking-display); line-height: 1; }
|
|
22
|
+
.countdown[data-variant="large"] .colon { padding-inline: .12em; line-height: 1; transform: translateY(-.06em); }
|
|
23
|
+
/* On a narrow card the unit names outgrow the digits; an even column floor keeps the colons evenly spaced instead of following each name's width. */
|
|
24
|
+
.countdown[data-variant="large"] .group { min-width: min(calc((100cqi - 1.6em) / 4), calc(var(--text-xs) * 4.2)); }
|
|
25
|
+
.countdown[data-variant="large"] .name { font-family: var(--font-body); letter-spacing: var(--tracking-body); }
|
|
26
|
+
|
|
27
|
+
/* Compact: one line, digits then a quiet unit letter. */
|
|
28
|
+
.countdown[data-variant="compact"] .units { gap: 6px; font-size: var(--text-sm); font-weight: 500; line-height: 1.3; }
|
|
29
|
+
.countdown[data-variant="compact"] .group { display: inline-flex; align-items: baseline; gap: 1px; }
|
|
30
|
+
.countdown[data-variant="compact"] .name { font-size: var(--text-sm); font-weight: 400; line-height: 1.3; }
|
|
31
|
+
|
|
32
|
+
/* Each digit is a clipped wheel whose window feathers out, so a turning digit fades at the edge instead of being cut. */
|
|
33
|
+
.wheel { --feather: .16em; position: relative; display: inline-block; overflow: hidden; margin-block: calc(var(--feather) * -1); padding-block: var(--feather); mask-image: linear-gradient(to bottom, transparent, #000 calc(var(--feather) * 1.5), #000 calc(100% - var(--feather) * 1.5), transparent); }
|
|
34
|
+
.sizer { visibility: hidden; }
|
|
35
|
+
.glyph { position: absolute; inset: var(--feather) 0; text-align: center; }
|
|
36
|
+
|
|
37
|
+
/* Finished: the digits give way to the label and a live mark. */
|
|
38
|
+
.done { display: inline-flex; align-items: center; gap: .4em; white-space: nowrap; }
|
|
39
|
+
.countdown[data-variant="large"] .done { font-family: var(--font-display); font-size: clamp(1.75rem, 11cqi, var(--text-4xl)); font-weight: 500; letter-spacing: var(--tracking-display); line-height: 1.1; }
|
|
40
|
+
.countdown[data-variant="compact"] .done { color: var(--success); font-size: var(--text-sm); font-weight: 500; line-height: 1.3; }
|
|
41
|
+
.pulse { position: relative; width: .3em; height: .3em; min-width: 8px; min-height: 8px; flex: none; border-radius: 50%; background: var(--success); }
|
|
42
|
+
.pulse::after { position: absolute; inset: 0; border-radius: inherit; background: var(--success); content: ""; animation: pulse 2s var(--ease-standard) infinite; }
|
|
43
|
+
@keyframes pulse { from { opacity: .5; transform: scale(1); } 70%, to { opacity: 0; transform: scale(2.6); } }
|
|
44
|
+
|
|
45
|
+
.srOnly { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
|
|
46
|
+
@media (prefers-reduced-motion: reduce) {
|
|
47
|
+
.pulse::after { animation: none; }
|
|
48
|
+
.number, .shell { transition: none; }
|
|
49
|
+
}
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import { useEffect, useImperativeHandle, useLayoutEffect, useRef, useState, useSyncExternalStore, type ReactNode, type Ref } from "react";
|
|
4
|
+
import { AnimatePresence, animate, motion, useInView, useMotionValue, useReducedMotion, useTransform, type MotionValue } from "motion/react";
|
|
5
|
+
import { motionTokens } from "@/lib/motion-tokens";
|
|
6
|
+
import styles from "./countdown.module.css";
|
|
7
|
+
|
|
8
|
+
export type CountdownUnit = "days" | "hours" | "minutes" | "seconds";
|
|
9
|
+
|
|
10
|
+
/** Use a countdown for a fixed moment people wait for: a launch, a live event, or a deadline. */
|
|
11
|
+
export interface CountdownProps {
|
|
12
|
+
/**
|
|
13
|
+
* The moment to count down to. A number is epoch milliseconds, a Date is used as is, and an ISO string with `Z` or an offset
|
|
14
|
+
* such as `2026-10-06T10:00:00-07:00` is exact. A string without an offset is wall time in `timeZone`, or UTC when no zone is given,
|
|
15
|
+
* so the result never depends on the visitor's own time zone.
|
|
16
|
+
*/
|
|
17
|
+
target: Date | number | string;
|
|
18
|
+
/** IANA zone for a target string without an offset, such as "America/Los_Angeles". Daylight saving is resolved for the target date. */
|
|
19
|
+
timeZone?: string;
|
|
20
|
+
/** Units to show, largest first. The largest unit absorbs the rest, so hours can pass 24 when days are left out. */
|
|
21
|
+
units?: CountdownUnit[];
|
|
22
|
+
/** Large digits with unit labels, or one compact line for banners and table cells. */
|
|
23
|
+
variant?: "large" | "compact";
|
|
24
|
+
/** Shown once the target passes. The digits morph into it. */
|
|
25
|
+
completeLabel?: ReactNode;
|
|
26
|
+
/** Fires once, the moment the countdown reaches zero while mounted. It fires on time even when the tab is hidden. */
|
|
27
|
+
onComplete?: () => void;
|
|
28
|
+
/** Accessible name, such as "Keynote starts in". */
|
|
29
|
+
label?: string;
|
|
30
|
+
/** Clock source in epoch milliseconds. Pass a server-synced clock when the visitor's device time cannot be trusted. */
|
|
31
|
+
clock?: () => number;
|
|
32
|
+
ref?: Ref<HTMLDivElement>;
|
|
33
|
+
className?: string;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
const { spring, stagger } = motionTokens;
|
|
37
|
+
const DEFAULT_UNITS: CountdownUnit[] = ["days", "hours", "minutes", "seconds"];
|
|
38
|
+
const SECONDS: Record<CountdownUnit, number> = { days: 86_400, hours: 3_600, minutes: 60, seconds: 1 };
|
|
39
|
+
/** How far each unit counts before carrying into the next, when a larger unit is shown. */
|
|
40
|
+
const LIMIT: Record<CountdownUnit, number> = { days: Infinity, hours: 24, minutes: 60, seconds: 60 };
|
|
41
|
+
const NAMES: Record<CountdownUnit, [string, string, string]> = { days: ["Days", "d", "day"], hours: ["Hours", "h", "hour"], minutes: ["Minutes", "m", "minute"], seconds: ["Seconds", "s", "second"] };
|
|
42
|
+
const MAX_TIMEOUT = 2_147_483_647;
|
|
43
|
+
const systemClock = () => Date.now();
|
|
44
|
+
|
|
45
|
+
/** Offset of a zone from UTC at an instant, in milliseconds. */
|
|
46
|
+
function zoneOffset(epoch: number, timeZone: string) {
|
|
47
|
+
const parts = new Intl.DateTimeFormat("en-US", { timeZone, hourCycle: "h23", year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit", second: "2-digit" }).formatToParts(new Date(epoch));
|
|
48
|
+
const get = (type: string) => Number(parts.find(part => part.type === type)?.value ?? 0);
|
|
49
|
+
return Date.UTC(get("year"), get("month") - 1, get("day"), get("hour"), get("minute"), get("second")) - Math.floor(epoch / 1000) * 1000;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** Resolves a countdown target to epoch milliseconds without ever reading the device's own time zone. */
|
|
53
|
+
export function toEpoch(target: Date | number | string, timeZone?: string) {
|
|
54
|
+
if (typeof target === "number") return target;
|
|
55
|
+
if (target instanceof Date) return target.getTime();
|
|
56
|
+
const wall = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?)?$/.exec(target.trim());
|
|
57
|
+
if (!wall) return Date.parse(target);
|
|
58
|
+
const utc = Date.UTC(+wall[1]!, +wall[2]! - 1, +wall[3]!, +(wall[4] ?? 0), +(wall[5] ?? 0), +(wall[6] ?? 0));
|
|
59
|
+
if (!timeZone) return utc;
|
|
60
|
+
// Two passes settle the offset across a daylight saving change.
|
|
61
|
+
const guess = utc - zoneOffset(utc, timeZone);
|
|
62
|
+
return utc - zoneOffset(guess, timeZone);
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** Whole seconds left, split across the units on show. */
|
|
66
|
+
function partsFor(seconds: number, units: CountdownUnit[]) {
|
|
67
|
+
return units.map((unit, index) => ({ unit, value: index === 0 ? Math.floor(seconds / SECONDS[unit]) : Math.floor(seconds / SECONDS[unit]) % LIMIT[unit] }));
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/** Wheel sizes per column: a tens column that only ever shows 0 to 5 turns on a six-digit wheel, so 00 → 59 is a single step. */
|
|
71
|
+
function basesFor(unit: CountdownUnit, largest: boolean, length: number) {
|
|
72
|
+
return Array.from({ length }, (_, index) => {
|
|
73
|
+
const tens = index === length - 2 && length === 2 && !largest;
|
|
74
|
+
return tens ? (unit === "hours" ? 3 : 6) : 10;
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
const subscribeNothing = () => () => {};
|
|
79
|
+
const subscribeVisibility = (notify: () => void) => { document.addEventListener("visibilitychange", notify); return () => document.removeEventListener("visibilitychange", notify); };
|
|
80
|
+
|
|
81
|
+
/** One digit on a wheel. Its offset from the wheel position decides where it sits and how clearly it shows. */
|
|
82
|
+
function Glyph({ position, digit, base }: { position: MotionValue<number>; digit: number; base: number }) {
|
|
83
|
+
const offset = useTransform(position, current => ((((digit - current) % base) + base * 1.5) % base) - base / 2);
|
|
84
|
+
const y = useTransform(offset, current => `${current}em`);
|
|
85
|
+
const opacity = useTransform(offset, current => Math.max(0, 1 - Math.abs(current)));
|
|
86
|
+
const visibility = useTransform(offset, current => Math.abs(current) >= 1 ? "hidden" : "visible");
|
|
87
|
+
const filter = useTransform(offset, current => Math.abs(current) < .02 || Math.abs(current) >= 1 ? "none" : `blur(${(Math.abs(current) * motionTokens.blur.subtle).toFixed(2)}px)`);
|
|
88
|
+
return <motion.span className={styles.glyph} style={{ y, opacity, filter, visibility }}>{digit}</motion.span>;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/** A digit wheel that takes the short way round, so a countdown ticks downward and a wrap such as 00 → 59 is one step. */
|
|
92
|
+
function Wheel({ digit, base, delay, reduced }: { digit: number; base: number; delay: number; reduced: boolean }) {
|
|
93
|
+
const position = useMotionValue(0);
|
|
94
|
+
const wheel = useRef({ digit: 0, target: 0, revealed: false });
|
|
95
|
+
useEffect(() => {
|
|
96
|
+
const state = wheel.current;
|
|
97
|
+
if (state.digit === digit) { state.revealed = true; return; }
|
|
98
|
+
const up = (digit - state.digit + base) % base, down = base - up;
|
|
99
|
+
state.target += down <= up ? -down : up;
|
|
100
|
+
state.digit = digit;
|
|
101
|
+
const first = !state.revealed;
|
|
102
|
+
state.revealed = true;
|
|
103
|
+
// A new animation on the same value takes over from the one in flight, keeping its velocity; no cleanup, so a re-run never strands a wheel mid-turn.
|
|
104
|
+
if (reduced) position.jump(state.target);
|
|
105
|
+
else animate(position, state.target, first ? { ...spring.smooth, delay } : spring.snappy);
|
|
106
|
+
}, [base, delay, digit, position, reduced]);
|
|
107
|
+
return <motion.span className={styles.wheel} initial={{ width: 0, opacity: 0 }} animate={{ width: "auto", opacity: 1 }} exit={{ width: 0, opacity: 0 }} transition={reduced ? { duration: 0 } : spring.morph}>
|
|
108
|
+
<span className={styles.sizer}>0</span>
|
|
109
|
+
{Array.from({ length: base }, (_, value) => <Glyph key={value} position={position} digit={value} base={base} />)}
|
|
110
|
+
</motion.span>;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export function Countdown({ target, timeZone, units = DEFAULT_UNITS, variant = "large", completeLabel = "Live now", onComplete, label = "Time remaining", clock = systemClock, ref, className }: CountdownProps) {
|
|
114
|
+
const root = useRef<HTMLDivElement>(null);
|
|
115
|
+
useImperativeHandle(ref, () => root.current as HTMLDivElement);
|
|
116
|
+
const hydrated = useSyncExternalStore(subscribeNothing, () => true, () => false);
|
|
117
|
+
const reduced = !!useReducedMotion() && hydrated;
|
|
118
|
+
const end = toEpoch(target, timeZone);
|
|
119
|
+
const valid = Number.isFinite(end);
|
|
120
|
+
const shownUnits = units.length ? [...units].sort((a, b) => SECONDS[b] - SECONDS[a]) : DEFAULT_UNITS;
|
|
121
|
+
|
|
122
|
+
// The clock only ticks while the countdown is on screen and the tab is visible; coming back reads the clock again, so nothing drifts.
|
|
123
|
+
const pageVisible = useSyncExternalStore(subscribeVisibility, () => document.visibilityState === "visible", () => true);
|
|
124
|
+
const inView = useInView(root, { amount: 0 });
|
|
125
|
+
const running = pageVisible && inView && valid;
|
|
126
|
+
const [now, setNow] = useState<number | null>(null);
|
|
127
|
+
const clockRef = useRef(clock);
|
|
128
|
+
useLayoutEffect(() => { clockRef.current = clock; });
|
|
129
|
+
useEffect(() => {
|
|
130
|
+
if (!running) return;
|
|
131
|
+
let timer: ReturnType<typeof setTimeout>;
|
|
132
|
+
const tick = () => {
|
|
133
|
+
const time = clockRef.current();
|
|
134
|
+
setNow(time);
|
|
135
|
+
const left = end - time;
|
|
136
|
+
// Wake just after the next whole second, aligned to the target rather than to when the page loaded.
|
|
137
|
+
if (left > 0) timer = setTimeout(tick, (left % 1000 || 1000) + 8);
|
|
138
|
+
};
|
|
139
|
+
timer = setTimeout(tick, 0);
|
|
140
|
+
return () => clearTimeout(timer);
|
|
141
|
+
}, [end, running]);
|
|
142
|
+
|
|
143
|
+
// Completion is armed separately, so it lands on time even while ticking is paused.
|
|
144
|
+
useEffect(() => {
|
|
145
|
+
if (!valid) return;
|
|
146
|
+
const left = end - clockRef.current();
|
|
147
|
+
if (left <= 0) return;
|
|
148
|
+
const timer = setTimeout(() => setNow(clockRef.current()), Math.min(MAX_TIMEOUT, left + 8));
|
|
149
|
+
return () => clearTimeout(timer);
|
|
150
|
+
}, [end, valid]);
|
|
151
|
+
|
|
152
|
+
const left = now === null || !valid ? null : Math.max(0, end - now);
|
|
153
|
+
const complete = left === 0;
|
|
154
|
+
const onCompleteRef = useRef(onComplete);
|
|
155
|
+
useLayoutEffect(() => { onCompleteRef.current = onComplete; });
|
|
156
|
+
const wasRunning = useRef<number | null>(null);
|
|
157
|
+
useEffect(() => {
|
|
158
|
+
if (left === null) return;
|
|
159
|
+
if (left > 0) { wasRunning.current = end; return; }
|
|
160
|
+
if (wasRunning.current === end) { wasRunning.current = null; onCompleteRef.current?.(); }
|
|
161
|
+
}, [end, left]);
|
|
162
|
+
|
|
163
|
+
const seconds = left === null ? 0 : Math.ceil(left / 1000);
|
|
164
|
+
const parts = partsFor(seconds, shownUnits);
|
|
165
|
+
const pending = left === null;
|
|
166
|
+
const compact = variant === "compact";
|
|
167
|
+
|
|
168
|
+
// The shell springs to the size of whatever it holds, so the digits can morph into the finished label without a jump.
|
|
169
|
+
const content = useRef<HTMLDivElement>(null);
|
|
170
|
+
const width = useMotionValue<number | "auto">("auto"), height = useMotionValue<number | "auto">("auto");
|
|
171
|
+
useLayoutEffect(() => {
|
|
172
|
+
const node = content.current;
|
|
173
|
+
if (!node || typeof ResizeObserver === "undefined") return;
|
|
174
|
+
let first = true;
|
|
175
|
+
const observer = new ResizeObserver(() => {
|
|
176
|
+
const w = node.offsetWidth, h = node.offsetHeight;
|
|
177
|
+
if (first || reduced) { width.jump(w); height.jump(h); first = false; return; }
|
|
178
|
+
animate(width, w, spring.morph);
|
|
179
|
+
animate(height, h, spring.smooth);
|
|
180
|
+
});
|
|
181
|
+
observer.observe(node);
|
|
182
|
+
return () => observer.disconnect();
|
|
183
|
+
}, [height, reduced, width]);
|
|
184
|
+
|
|
185
|
+
const spoken = complete ? (typeof completeLabel === "string" ? completeLabel : "Complete") : pending ? "" : parts.filter((part, index) => part.value > 0 || index === parts.length - 1).filter(part => seconds < 60 || part.unit !== "seconds").map(part => `${part.value} ${part.value === 1 ? NAMES[part.unit][2] : `${NAMES[part.unit][2]}s`}`).join(", ");
|
|
186
|
+
const swap = reduced
|
|
187
|
+
? { initial: { opacity: 0 }, animate: { opacity: 1 }, exit: { opacity: 0 }, transition: { duration: motionTokens.duration.fast } }
|
|
188
|
+
: { initial: { opacity: 0, scale: .92, filter: `blur(${motionTokens.blur.soft}px)` }, animate: { opacity: 1, scale: 1, filter: "blur(0px)" }, exit: { opacity: 0, scale: .92, filter: `blur(${motionTokens.blur.soft}px)`, transition: { duration: motionTokens.duration.fast } }, transition: spring.morph };
|
|
189
|
+
|
|
190
|
+
return <div ref={root} className={[styles.countdown, className].filter(Boolean).join(" ")} data-variant={variant} data-complete={complete || undefined} data-pending={pending || undefined} role="timer" aria-label={label}>
|
|
191
|
+
<motion.div className={styles.shell} style={{ width, height }}>
|
|
192
|
+
<div ref={content} className={styles.content} aria-hidden="true">
|
|
193
|
+
<AnimatePresence mode="popLayout" initial={false}>
|
|
194
|
+
{complete
|
|
195
|
+
? <motion.span key="done" className={styles.done} {...swap}><span className={styles.pulse} />{completeLabel}</motion.span>
|
|
196
|
+
: <motion.span key="running" className={styles.units} {...swap}>
|
|
197
|
+
{parts.map((part, group) => {
|
|
198
|
+
const text = String(part.value).padStart(2, "0");
|
|
199
|
+
const bases = basesFor(part.unit, group === 0, text.length);
|
|
200
|
+
return <span key={part.unit} className={styles.unit}>
|
|
201
|
+
{!compact && group > 0 && <span className={styles.colon}>:</span>}
|
|
202
|
+
<span className={styles.group}>
|
|
203
|
+
<span className={styles.number}><AnimatePresence initial={false}>
|
|
204
|
+
{[...text].map((char, index) => <Wheel key={`${part.unit}${text.length - index}`} digit={Number(char)} base={bases[index]!} delay={Math.min((group * 2 + index) * stagger.item, .3)} reduced={reduced} />)}
|
|
205
|
+
</AnimatePresence></span>
|
|
206
|
+
<span className={styles.name}>{NAMES[part.unit][compact ? 1 : 0]}</span>
|
|
207
|
+
</span>
|
|
208
|
+
</span>;
|
|
209
|
+
})}
|
|
210
|
+
</motion.span>}
|
|
211
|
+
</AnimatePresence>
|
|
212
|
+
</div>
|
|
213
|
+
</motion.div>
|
|
214
|
+
<span className={styles.srOnly}>{spoken}</span>
|
|
215
|
+
</div>;
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
export default Countdown;
|