motion-ui-skill 2.1.1 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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,546 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import { useCallback, useEffect, useId, useRef, useState, useSyncExternalStore } from "react";
|
|
4
|
+
import type { KeyboardEvent as ReactKeyboardEvent, PointerEvent as ReactPointerEvent, ReactNode } from "react";
|
|
5
|
+
import { AnimatePresence, animate, motion, useReducedMotion } from "motion/react";
|
|
6
|
+
import type { Transition } from "motion/react";
|
|
7
|
+
import { Check, Download, Eraser, Play, Redo2, Square, Undo2, X } from "lucide-react";
|
|
8
|
+
import { motionTokens } from "@/lib/motion-tokens";
|
|
9
|
+
import styles from "./signature-pad.module.css";
|
|
10
|
+
|
|
11
|
+
/** A sampled point: position in pad units, pen pressure between 0 and 1 (or -1 when the device has none), and ms since the stroke began. */
|
|
12
|
+
export interface InkPoint { x: number; y: number; p: number; t: number }
|
|
13
|
+
export type InkColor = "black" | "blue" | "violet";
|
|
14
|
+
export type InkWidth = "fine" | "medium" | "bold";
|
|
15
|
+
export interface InkStroke {
|
|
16
|
+
id: string;
|
|
17
|
+
points: InkPoint[];
|
|
18
|
+
color: InkColor;
|
|
19
|
+
width: InkWidth;
|
|
20
|
+
/** When the stroke began, in ms. Replay keeps the real rhythm between strokes. */
|
|
21
|
+
at: number;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export interface OutlineOptions {
|
|
25
|
+
/** Diameter of the stroke at half pressure, in pad units. */
|
|
26
|
+
size: number;
|
|
27
|
+
/** How much pressure changes the width, from 0 to 1. */
|
|
28
|
+
thinning?: number;
|
|
29
|
+
/** How far each point trails the pointer, from 0 to 1. Higher is smoother but lags more. */
|
|
30
|
+
streamline?: number;
|
|
31
|
+
/** Derive pressure from speed when the device reports none: fast is thin, slow is full. */
|
|
32
|
+
simulatePressure?: boolean;
|
|
33
|
+
/** Length over which the start and the end taper, in pad units. */
|
|
34
|
+
taperStart?: number;
|
|
35
|
+
taperEnd?: number;
|
|
36
|
+
/** False while the stroke is still being drawn, so the end does not taper yet. */
|
|
37
|
+
last?: boolean;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** Pad coordinates. Strokes are stored in this space and scale with the pad. */
|
|
41
|
+
export const PAD_WIDTH = 600, PAD_HEIGHT = 260;
|
|
42
|
+
|
|
43
|
+
const INK: Record<InkColor, { label: string; export: string }> = {
|
|
44
|
+
black: { label: "Black ink", export: "#17171a" },
|
|
45
|
+
blue: { label: "Blue ink", export: "#1d3fae" },
|
|
46
|
+
violet: { label: "Violet ink", export: "#5b35c8" },
|
|
47
|
+
};
|
|
48
|
+
const WIDTHS: Record<InkWidth, { label: string; size: number }> = {
|
|
49
|
+
fine: { label: "Fine", size: 3.4 },
|
|
50
|
+
medium: { label: "Medium", size: 5.6 },
|
|
51
|
+
bold: { label: "Bold", size: 8.4 },
|
|
52
|
+
};
|
|
53
|
+
const COLORS = Object.keys(INK) as InkColor[];
|
|
54
|
+
const SIZES = Object.keys(WIDTHS) as InkWidth[];
|
|
55
|
+
|
|
56
|
+
type Vec = [number, number];
|
|
57
|
+
const add = (a: Vec, b: Vec): Vec => [a[0] + b[0], a[1] + b[1]];
|
|
58
|
+
const sub = (a: Vec, b: Vec): Vec => [a[0] - b[0], a[1] - b[1]];
|
|
59
|
+
const mul = (a: Vec, n: number): Vec => [a[0] * n, a[1] * n];
|
|
60
|
+
const lerp = (a: Vec, b: Vec, t: number): Vec => [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t];
|
|
61
|
+
const dist = (a: Vec, b: Vec) => Math.hypot(a[0] - b[0], a[1] - b[1]);
|
|
62
|
+
const norm = (a: Vec): Vec => { const l = Math.hypot(a[0], a[1]); return l ? [a[0] / l, a[1] / l] : [0, 0]; };
|
|
63
|
+
const perp = (a: Vec): Vec => [a[1], -a[0]];
|
|
64
|
+
const dot = (a: Vec, b: Vec) => a[0] * b[0] + a[1] * b[1];
|
|
65
|
+
const rotAround = (p: Vec, c: Vec, r: number): Vec => {
|
|
66
|
+
const s = Math.sin(r), co = Math.cos(r), px = p[0] - c[0], py = p[1] - c[1];
|
|
67
|
+
return [px * co - py * s + c[0], px * s + py * co + c[1]];
|
|
68
|
+
};
|
|
69
|
+
const easeOut = (t: number) => t * (2 - t);
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Turns sampled points into the outline of a variable width stroke, in the spirit of perfect-freehand. Points are streamlined
|
|
73
|
+
* toward the pointer, width follows pen pressure or, for a mouse or finger, speed, the ends taper, sharp turns get round joins,
|
|
74
|
+
* and both ends get round caps. Returns the outline polygon; pass it to `outlineToPath` for SVG.
|
|
75
|
+
*/
|
|
76
|
+
export function getStrokeOutline(input: InkPoint[], options: OutlineOptions): Vec[] {
|
|
77
|
+
const { size, thinning = .62, streamline = .42, simulatePressure = true, taperStart = 0, taperEnd = 0, last = true } = options;
|
|
78
|
+
const [head] = input;
|
|
79
|
+
if (!head) return [];
|
|
80
|
+
const usePen = !simulatePressure && input.some(point => point.p > 0);
|
|
81
|
+
|
|
82
|
+
// Streamline: each point eases toward the raw input, which removes jitter without a smoothing pass.
|
|
83
|
+
const pts: { at: Vec; pressure: number; length: number; vector: Vec }[] = [];
|
|
84
|
+
let prev: Vec = [head.x, head.y], length = 0;
|
|
85
|
+
const start = { at: prev, pressure: usePen ? head.p : .5, length: 0, vector: [1, 0] as Vec };
|
|
86
|
+
pts.push(start);
|
|
87
|
+
for (let i = 1; i < input.length; i++) {
|
|
88
|
+
const sample = input[i]!;
|
|
89
|
+
const raw: Vec = [sample.x, sample.y];
|
|
90
|
+
const at = i === input.length - 1 && last ? raw : lerp(prev, raw, 1 - streamline);
|
|
91
|
+
const d = dist(at, prev);
|
|
92
|
+
if (d < .4) continue;
|
|
93
|
+
length += d;
|
|
94
|
+
pts.push({ at, pressure: usePen ? sample.p : .5, length, vector: norm(sub(prev, at)) });
|
|
95
|
+
prev = at;
|
|
96
|
+
}
|
|
97
|
+
const second = pts[1];
|
|
98
|
+
if (second) start.vector = second.vector;
|
|
99
|
+
const total = length;
|
|
100
|
+
|
|
101
|
+
// A dot: a round mark sized by the first pressure.
|
|
102
|
+
if (pts.length === 1) {
|
|
103
|
+
const r = Math.max(.6, size * (.5 - thinning * (.5 - start.pressure)) * .9);
|
|
104
|
+
return Array.from({ length: 18 }, (_, i) => add(start.at, mul([Math.cos(i / 18 * Math.PI * 2), Math.sin(i / 18 * Math.PI * 2)], r)));
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
const left: Vec[] = [], right: Vec[] = [];
|
|
108
|
+
let pressure = start.pressure, prevVector = start.vector;
|
|
109
|
+
const radii: number[] = [];
|
|
110
|
+
for (let i = 0; i < pts.length; i++) {
|
|
111
|
+
const point = pts[i]!;
|
|
112
|
+
if (!usePen) {
|
|
113
|
+
// Speed thins the line: a long step between samples reads as a fast stroke.
|
|
114
|
+
const step = i === 0 ? 0 : dist(point.at, pts[i - 1]!.at);
|
|
115
|
+
const speed = Math.min(1, step / size);
|
|
116
|
+
const target = Math.min(1, 1 - speed);
|
|
117
|
+
pressure = Math.min(1, pressure + (target - pressure) * speed * .3);
|
|
118
|
+
} else {
|
|
119
|
+
pressure = point.pressure;
|
|
120
|
+
}
|
|
121
|
+
let radius = Math.max(.25, size * (.5 - thinning * (.5 - pressure)));
|
|
122
|
+
const ts = taperStart ? easeOut(Math.min(1, point.length / taperStart)) : 1;
|
|
123
|
+
const te = taperEnd && last ? easeOut(Math.min(1, (total - point.length) / taperEnd)) : 1;
|
|
124
|
+
radius = Math.max(.12 * size, radius * Math.min(ts, te));
|
|
125
|
+
radii.push(radius);
|
|
126
|
+
|
|
127
|
+
const next = pts[i + 1]?.vector ?? point.vector;
|
|
128
|
+
const offset = mul(perp(lerp(next, point.vector, .5)), radius);
|
|
129
|
+
// A sharp turn: sweep round the corner so the outline does not pinch.
|
|
130
|
+
if (i > 0 && i < pts.length - 1 && dot(point.vector, next) < -.2) {
|
|
131
|
+
const corner = mul(perp(prevVector), radius);
|
|
132
|
+
for (let t = 0; t <= 1; t += 1 / 12) {
|
|
133
|
+
left.push(rotAround(sub(point.at, corner), point.at, Math.PI * t));
|
|
134
|
+
right.push(rotAround(add(point.at, corner), point.at, -Math.PI * t));
|
|
135
|
+
}
|
|
136
|
+
} else {
|
|
137
|
+
left.push(sub(point.at, offset));
|
|
138
|
+
right.push(add(point.at, offset));
|
|
139
|
+
}
|
|
140
|
+
prevVector = point.vector;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
// Round caps: half circles swept around the first and last points, on the side facing away from the stroke.
|
|
144
|
+
const cap = (center: Vec, from: Vec, to: Vec, away: Vec) => {
|
|
145
|
+
const out: Vec[] = [];
|
|
146
|
+
const r = dist(center, from), start = Math.atan2(from[1] - center[1], from[0] - center[0]);
|
|
147
|
+
const mid = start + Math.PI / 2;
|
|
148
|
+
const sign = dot([Math.cos(mid), Math.sin(mid)], away) >= 0 ? 1 : -1;
|
|
149
|
+
for (let k = 1; k < 12; k++) {
|
|
150
|
+
const a = start + sign * Math.PI * k / 12;
|
|
151
|
+
out.push([center[0] + Math.cos(a) * r, center[1] + Math.sin(a) * r]);
|
|
152
|
+
}
|
|
153
|
+
out.push(to);
|
|
154
|
+
return out;
|
|
155
|
+
};
|
|
156
|
+
const end = pts[pts.length - 1]!;
|
|
157
|
+
const endCap = cap(end.at, left[left.length - 1]!, right[right.length - 1]!, mul(end.vector, -1));
|
|
158
|
+
const startCap = cap(start.at, right[0]!, left[0]!, start.vector);
|
|
159
|
+
return [...left, ...endCap, ...right.reverse(), ...startCap];
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
const round = (value: number) => Math.round(value * 100) / 100;
|
|
163
|
+
/** Draws an outline as one smooth closed path, with quadratic curves through the midpoints of its edges. */
|
|
164
|
+
export function outlineToPath(points: Vec[]) {
|
|
165
|
+
if (points.length < 3) return "";
|
|
166
|
+
let d = `M${round(points[0]![0])} ${round(points[0]![1])} Q`;
|
|
167
|
+
for (let i = 0; i < points.length; i++) {
|
|
168
|
+
const [x0, y0] = points[i]!, [x1, y1] = points[(i + 1) % points.length]!;
|
|
169
|
+
d += `${round(x0)} ${round(y0)} ${round((x0 + x1) / 2)} ${round((y0 + y1) / 2)} `;
|
|
170
|
+
}
|
|
171
|
+
return `${d}Z`;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
function strokeOptions(stroke: Pick<InkStroke, "width" | "points">, last: boolean): OutlineOptions {
|
|
175
|
+
const size = WIDTHS[stroke.width].size;
|
|
176
|
+
const pen = stroke.points.some(point => point.p > 0);
|
|
177
|
+
return { size, simulatePressure: !pen, taperStart: size * 1.5, taperEnd: pen ? 0 : size * 5, last };
|
|
178
|
+
}
|
|
179
|
+
/** The SVG path of a stroke, or of its first `upTo` ms while it is replayed. */
|
|
180
|
+
export function strokePath(stroke: Pick<InkStroke, "width" | "points">, upTo = Infinity) {
|
|
181
|
+
const all = stroke.points;
|
|
182
|
+
const done = upTo >= all[all.length - 1]!.t;
|
|
183
|
+
const points = done ? all : all.filter(point => point.t <= upTo);
|
|
184
|
+
return outlineToPath(getStrokeOutline(points, strokeOptions(stroke, done)));
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/** Tight bounds of the ink, padded, for export. */
|
|
188
|
+
function inkBounds(strokes: InkStroke[]) {
|
|
189
|
+
let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
|
|
190
|
+
for (const stroke of strokes) for (const point of stroke.points) {
|
|
191
|
+
minX = Math.min(minX, point.x); minY = Math.min(minY, point.y); maxX = Math.max(maxX, point.x); maxY = Math.max(maxY, point.y);
|
|
192
|
+
}
|
|
193
|
+
const pad = 16;
|
|
194
|
+
return { x: Math.floor(minX - pad), y: Math.floor(minY - pad), width: Math.ceil(maxX - minX + pad * 2), height: Math.ceil(maxY - minY + pad * 2) };
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
/** A standalone SVG of the signature, cropped to the ink, with print ink colors. */
|
|
198
|
+
export function signatureToSvg(strokes: InkStroke[]) {
|
|
199
|
+
if (!strokes.length) return "";
|
|
200
|
+
const box = inkBounds(strokes);
|
|
201
|
+
const paths = strokes.map(stroke => `<path d="${strokePath(stroke)}" fill="${INK[stroke.color].export}"/>`).join("");
|
|
202
|
+
return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${box.x} ${box.y} ${box.width} ${box.height}" width="${box.width}" height="${box.height}">${paths}</svg>`;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** A transparent PNG of the signature, cropped to the ink, at `scale` times pad resolution. */
|
|
206
|
+
export function signatureToPng(strokes: InkStroke[], scale = 3): Promise<Blob> {
|
|
207
|
+
return new Promise((resolve, reject) => {
|
|
208
|
+
if (!strokes.length) return reject(new Error("Nothing to export"));
|
|
209
|
+
const box = inkBounds(strokes);
|
|
210
|
+
const canvas = document.createElement("canvas");
|
|
211
|
+
canvas.width = box.width * scale; canvas.height = box.height * scale;
|
|
212
|
+
const ctx = canvas.getContext("2d");
|
|
213
|
+
if (!ctx) return reject(new Error("Canvas is unavailable"));
|
|
214
|
+
ctx.scale(scale, scale);
|
|
215
|
+
ctx.translate(-box.x, -box.y);
|
|
216
|
+
for (const stroke of strokes) { ctx.fillStyle = INK[stroke.color].export; ctx.fill(new Path2D(strokePath(stroke))); }
|
|
217
|
+
canvas.toBlob(blob => blob ? resolve(blob) : reject(new Error("Export failed")), "image/png");
|
|
218
|
+
});
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
function download(blob: Blob, name: string) {
|
|
222
|
+
const url = URL.createObjectURL(blob);
|
|
223
|
+
const link = document.createElement("a");
|
|
224
|
+
link.href = url; link.download = name;
|
|
225
|
+
document.body.appendChild(link); link.click(); link.remove();
|
|
226
|
+
window.setTimeout(() => URL.revokeObjectURL(url), 1000);
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/**
|
|
230
|
+
* A signature field with real ink. Width follows pen pressure, or speed for a mouse or finger, and the ends taper like a nib
|
|
231
|
+
* lifting off. It keeps undo and redo, clears with a wipe across the pad, replays the signature in its original rhythm,
|
|
232
|
+
* and exports a cropped PNG or SVG. A "Sign here" hint rests on the baseline until the first stroke.
|
|
233
|
+
* Keyboard: Mod+Z undoes, Shift+Mod+Z or Mod+Y redoes, and Delete clears.
|
|
234
|
+
*/
|
|
235
|
+
export interface SignaturePadProps {
|
|
236
|
+
/** Printed under the baseline, such as the signer's name. */
|
|
237
|
+
signer?: string;
|
|
238
|
+
/** Resting hint on the baseline before the first stroke. */
|
|
239
|
+
hint?: string;
|
|
240
|
+
defaultColor?: InkColor;
|
|
241
|
+
defaultWidth?: InkWidth;
|
|
242
|
+
/** Receives the strokes after every change. */
|
|
243
|
+
onChange?: (strokes: InkStroke[]) => void;
|
|
244
|
+
/** File name for exports, without extension. */
|
|
245
|
+
fileName?: string;
|
|
246
|
+
/** Accessible name of the drawing surface. */
|
|
247
|
+
label?: string;
|
|
248
|
+
className?: string;
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
/** `fresh` is the stroke just drawn: it is already on screen from the live path, so it appears without a fade. */
|
|
252
|
+
interface History { past: InkStroke[][]; present: InkStroke[]; future: InkStroke[][]; fresh: string | null }
|
|
253
|
+
type Saved = null | "png" | "svg" | "failed";
|
|
254
|
+
|
|
255
|
+
const { spring, duration, ease, blur } = motionTokens;
|
|
256
|
+
const subscribe = () => () => {};
|
|
257
|
+
function useReducedFlag() {
|
|
258
|
+
const hydrated = useSyncExternalStore(subscribe, () => true, () => false);
|
|
259
|
+
return !!useReducedMotion() && hydrated;
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
export function SignaturePad({ signer, hint = "Sign here", defaultColor = "black", defaultWidth = "medium", onChange, fileName = "signature", label = "Signature pad", className }: SignaturePadProps) {
|
|
263
|
+
const uid = useId().replace(/[^a-zA-Z0-9-]/g, "");
|
|
264
|
+
const reduced = useReducedFlag();
|
|
265
|
+
const [history, setHistory] = useState<History>({ past: [], present: [], future: [], fresh: null });
|
|
266
|
+
const [color, setColor] = useState<InkColor>(defaultColor);
|
|
267
|
+
const [width, setWidth] = useState<InkWidth>(defaultWidth);
|
|
268
|
+
const [drawing, setDrawing] = useState(false);
|
|
269
|
+
const [wiping, setWiping] = useState(false);
|
|
270
|
+
const [replay, setReplay] = useState<{ at: number; offsets: number[] } | null>(null);
|
|
271
|
+
const [saved, setSaved] = useState<Saved>(null);
|
|
272
|
+
const [status, setStatus] = useState("");
|
|
273
|
+
|
|
274
|
+
const padRef = useRef<HTMLDivElement>(null);
|
|
275
|
+
const inkRef = useRef<HTMLDivElement>(null);
|
|
276
|
+
const liveRef = useRef<SVGPathElement>(null);
|
|
277
|
+
const live = useRef<{ id: number; stroke: InkStroke; stamp: number } | null>(null);
|
|
278
|
+
const replayFrame = useRef(0);
|
|
279
|
+
const savedTimer = useRef(0);
|
|
280
|
+
const wipeAnimation = useRef<{ stop: () => void; complete: () => void } | null>(null);
|
|
281
|
+
const counter = useRef(0);
|
|
282
|
+
const onChangeRef = useRef(onChange);
|
|
283
|
+
useEffect(() => { onChangeRef.current = onChange; });
|
|
284
|
+
|
|
285
|
+
const strokes = history.present;
|
|
286
|
+
const empty = strokes.length === 0;
|
|
287
|
+
const replaying = replay !== null;
|
|
288
|
+
|
|
289
|
+
useEffect(() => { onChangeRef.current?.(strokes); }, [strokes]);
|
|
290
|
+
useEffect(() => () => { cancelAnimationFrame(replayFrame.current); window.clearTimeout(savedTimer.current); }, []);
|
|
291
|
+
|
|
292
|
+
const commit = useCallback((next: InkStroke[], fresh: string | null = null) => {
|
|
293
|
+
setHistory(current => ({ past: [...current.past, current.present].slice(-60), present: next, future: [], fresh }));
|
|
294
|
+
}, []);
|
|
295
|
+
|
|
296
|
+
const stopReplay = useCallback(() => { cancelAnimationFrame(replayFrame.current); setReplay(null); }, []);
|
|
297
|
+
/** A wipe in flight completes at once, so whatever comes next starts from a clear pad. */
|
|
298
|
+
const settleWipe = useCallback(() => { wipeAnimation.current?.complete(); }, []);
|
|
299
|
+
|
|
300
|
+
function toPad(event: { clientX: number; clientY: number }) {
|
|
301
|
+
const box = padRef.current!.getBoundingClientRect();
|
|
302
|
+
return { x: (event.clientX - box.left) / box.width * PAD_WIDTH, y: (event.clientY - box.top) / box.height * PAD_HEIGHT };
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
function onPointerDown(event: ReactPointerEvent<HTMLDivElement>) {
|
|
306
|
+
if (live.current || (event.pointerType === "mouse" && event.button !== 0)) return;
|
|
307
|
+
event.preventDefault();
|
|
308
|
+
settleWipe();
|
|
309
|
+
if (replaying) stopReplay();
|
|
310
|
+
padRef.current?.focus({ preventScroll: true });
|
|
311
|
+
event.currentTarget.setPointerCapture(event.pointerId);
|
|
312
|
+
const { x, y } = toPad(event);
|
|
313
|
+
const now = event.nativeEvent.timeStamp;
|
|
314
|
+
counter.current += 1;
|
|
315
|
+
const pen = event.pointerType === "pen" && event.pressure > 0;
|
|
316
|
+
live.current = { id: event.pointerId, stamp: event.nativeEvent.timeStamp, stroke: { id: `${uid}-${counter.current}`, color, width, at: now, points: [{ x, y, p: pen ? event.pressure : -1, t: 0 }] } };
|
|
317
|
+
setDrawing(true);
|
|
318
|
+
paintLive();
|
|
319
|
+
}
|
|
320
|
+
function onPointerMove(event: ReactPointerEvent<HTMLDivElement>) {
|
|
321
|
+
const current = live.current;
|
|
322
|
+
if (!current || current.id !== event.pointerId) return;
|
|
323
|
+
const samples = typeof event.nativeEvent.getCoalescedEvents === "function" ? event.nativeEvent.getCoalescedEvents() : [];
|
|
324
|
+
const list = samples.length ? samples : [event.nativeEvent];
|
|
325
|
+
for (const sample of list) {
|
|
326
|
+
const { x, y } = toPad(sample);
|
|
327
|
+
const pen = sample.pointerType === "pen" && sample.pressure > 0;
|
|
328
|
+
current.stroke.points.push({ x, y, p: pen ? sample.pressure : -1, t: Math.max(current.stroke.points[current.stroke.points.length - 1]!.t, sample.timeStamp - current.stamp) });
|
|
329
|
+
}
|
|
330
|
+
paintLive();
|
|
331
|
+
}
|
|
332
|
+
function onPointerUp(event: ReactPointerEvent<HTMLDivElement>) {
|
|
333
|
+
const current = live.current;
|
|
334
|
+
if (!current || current.id !== event.pointerId) return;
|
|
335
|
+
live.current = null;
|
|
336
|
+
commit([...strokes, current.stroke], current.stroke.id);
|
|
337
|
+
liveRef.current?.setAttribute("d", "");
|
|
338
|
+
setDrawing(false);
|
|
339
|
+
setStatus(`Stroke added. ${strokes.length + 1} in the signature.`);
|
|
340
|
+
}
|
|
341
|
+
function paintLive() {
|
|
342
|
+
const current = live.current;
|
|
343
|
+
if (!current || !liveRef.current) return;
|
|
344
|
+
liveRef.current.setAttribute("d", outlineToPath(getStrokeOutline(current.stroke.points, strokeOptions(current.stroke, false))));
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
function undo() {
|
|
348
|
+
if (!history.past.length || live.current) return;
|
|
349
|
+
settleWipe(); stopReplay();
|
|
350
|
+
setHistory(current => current.past.length ? { past: current.past.slice(0, -1), present: current.past[current.past.length - 1]!, future: [current.present, ...current.future], fresh: null } : current);
|
|
351
|
+
setStatus("Undone");
|
|
352
|
+
}
|
|
353
|
+
function redo() {
|
|
354
|
+
if (!history.future.length || live.current) return;
|
|
355
|
+
settleWipe(); stopReplay();
|
|
356
|
+
setHistory(current => current.future.length ? { past: [...current.past, current.present], present: current.future[0]!, future: current.future.slice(1), fresh: null } : current);
|
|
357
|
+
setStatus("Redone");
|
|
358
|
+
}
|
|
359
|
+
|
|
360
|
+
function clear() {
|
|
361
|
+
if (empty || wiping || live.current) return;
|
|
362
|
+
stopReplay();
|
|
363
|
+
const node = inkRef.current;
|
|
364
|
+
const finish = () => {
|
|
365
|
+
wipeAnimation.current = null;
|
|
366
|
+
commit([]); setWiping(false); setStatus("Signature cleared. Undo brings it back.");
|
|
367
|
+
// Lift the clip only once the wiped strokes have left, so they never flash back for a frame.
|
|
368
|
+
if (node) requestAnimationFrame(() => requestAnimationFrame(() => { node.style.clipPath = ""; }));
|
|
369
|
+
};
|
|
370
|
+
if (!node || reduced) { finish(); return; }
|
|
371
|
+
setWiping(true);
|
|
372
|
+
// The ink is cut away behind a squeegee edge that sweeps across the pad; the edge itself is drawn by the sweep element.
|
|
373
|
+
const controls = animate(node, { clipPath: ["inset(0% 0% 0% 0%)", "inset(0% 0% 0% 100%)"] }, { duration: .56, ease: [...ease.inOut] });
|
|
374
|
+
wipeAnimation.current = { stop: () => controls.stop(), complete: () => { controls.complete(); } };
|
|
375
|
+
controls.then(finish);
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
function toggleReplay() {
|
|
379
|
+
if (replaying) { stopReplay(); setStatus("Replay stopped"); return; }
|
|
380
|
+
if (empty || live.current) return;
|
|
381
|
+
settleWipe();
|
|
382
|
+
// Build a timeline: each stroke keeps its own rhythm, and pauses between strokes are capped so the replay never stalls.
|
|
383
|
+
const offsets: number[] = [];
|
|
384
|
+
let cursor = 0;
|
|
385
|
+
strokes.forEach((stroke, index) => {
|
|
386
|
+
if (index > 0) {
|
|
387
|
+
const previous = strokes[index - 1]!;
|
|
388
|
+
const gap = stroke.at - (previous.at + previous.points[previous.points.length - 1]!.t);
|
|
389
|
+
cursor += Math.min(260, Math.max(90, gap));
|
|
390
|
+
}
|
|
391
|
+
offsets.push(cursor);
|
|
392
|
+
cursor += stroke.points[stroke.points.length - 1]!.t;
|
|
393
|
+
});
|
|
394
|
+
const speed = Math.max(1, cursor / 3200);
|
|
395
|
+
const total = cursor + 120;
|
|
396
|
+
const begin = performance.now();
|
|
397
|
+
const tick = (now: number) => {
|
|
398
|
+
const at = (now - begin) * speed;
|
|
399
|
+
if (at >= total) { setReplay(null); setStatus("Replay finished"); return; }
|
|
400
|
+
setReplay({ at, offsets });
|
|
401
|
+
replayFrame.current = requestAnimationFrame(tick);
|
|
402
|
+
};
|
|
403
|
+
setReplay({ at: 0, offsets });
|
|
404
|
+
setStatus("Replaying signature");
|
|
405
|
+
replayFrame.current = requestAnimationFrame(tick);
|
|
406
|
+
}
|
|
407
|
+
async function save(kind: "png" | "svg") {
|
|
408
|
+
if (empty) return;
|
|
409
|
+
window.clearTimeout(savedTimer.current);
|
|
410
|
+
try {
|
|
411
|
+
const blob = kind === "svg" ? new Blob([signatureToSvg(strokes)], { type: "image/svg+xml" }) : await signatureToPng(strokes);
|
|
412
|
+
download(blob, `${fileName}.${kind}`);
|
|
413
|
+
setSaved(kind);
|
|
414
|
+
setStatus(`Saved ${fileName}.${kind}`);
|
|
415
|
+
} catch {
|
|
416
|
+
setSaved("failed");
|
|
417
|
+
setStatus("Export failed. Try again.");
|
|
418
|
+
}
|
|
419
|
+
savedTimer.current = window.setTimeout(() => setSaved(null), 1800);
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
function onKeyDown(event: ReactKeyboardEvent<HTMLDivElement>) {
|
|
423
|
+
const mod = event.metaKey || event.ctrlKey;
|
|
424
|
+
const key = event.key.toLowerCase();
|
|
425
|
+
if (mod && key === "z") { event.preventDefault(); if (event.shiftKey) redo(); else undo(); }
|
|
426
|
+
else if (mod && key === "y") { event.preventDefault(); redo(); }
|
|
427
|
+
else if (!mod && (event.key === "Delete" || event.key === "Backspace") && event.currentTarget === event.target) { event.preventDefault(); clear(); }
|
|
428
|
+
else if (event.key === "Escape" && replaying) { stopReplay(); }
|
|
429
|
+
}
|
|
430
|
+
|
|
431
|
+
// During replay each stroke shows only the part drawn so far, and the nib rides its newest point.
|
|
432
|
+
let nib: InkPoint | null = null, nibColor: InkColor = color;
|
|
433
|
+
const visible: { stroke: InkStroke; d: string | null }[] = [];
|
|
434
|
+
for (let index = 0; index < strokes.length; index++) {
|
|
435
|
+
const stroke = strokes[index]!;
|
|
436
|
+
if (replay === null) { visible.push({ stroke, d: null }); continue; }
|
|
437
|
+
const local = replay.at - (replay.offsets[index] ?? 0);
|
|
438
|
+
const lastT = stroke.points[stroke.points.length - 1]!.t;
|
|
439
|
+
if (local < 0) { visible.push({ stroke, d: "" }); continue; }
|
|
440
|
+
if (local >= lastT) { visible.push({ stroke, d: null }); continue; }
|
|
441
|
+
nib = stroke.points.findLast(point => point.t <= local) ?? stroke.points[0]!;
|
|
442
|
+
nibColor = stroke.color;
|
|
443
|
+
visible.push({ stroke, d: strokePath(stroke, local) });
|
|
444
|
+
}
|
|
445
|
+
const showHint = empty && !drawing && !wiping;
|
|
446
|
+
const hintHidden = reduced ? { opacity: 0 } : { opacity: 0, y: 6, scale: .97, filter: `blur(${blur.soft}px)` };
|
|
447
|
+
const t: Transition = reduced ? { duration: duration.instant } : spring.snappy;
|
|
448
|
+
|
|
449
|
+
return <div className={[styles.root, className].filter(Boolean).join(" ")} data-ink={color}>
|
|
450
|
+
<div ref={padRef} className={styles.pad} tabIndex={0} role="img" aria-roledescription="signature pad"
|
|
451
|
+
aria-label={`${label}. ${empty ? "Empty." : `${strokes.length} ${strokes.length === 1 ? "stroke" : "strokes"}.`} Draw with a pointer, pen, or finger.`}
|
|
452
|
+
aria-describedby={`${uid}-keys`} data-drawing={drawing ? "" : undefined}
|
|
453
|
+
onPointerDown={onPointerDown} onPointerMove={onPointerMove} onPointerUp={onPointerUp} onPointerCancel={onPointerUp} onKeyDown={onKeyDown}>
|
|
454
|
+
<div className={styles.guide} aria-hidden="true">
|
|
455
|
+
<X className={styles.mark} size={14} strokeWidth={1.75} />
|
|
456
|
+
<span className={styles.baseline} />
|
|
457
|
+
{signer && <span className={styles.signer}>{signer}</span>}
|
|
458
|
+
<AnimatePresence initial={false}>
|
|
459
|
+
{showHint && <motion.span key="hint" className={styles.hint} initial={hintHidden} animate={{ opacity: 1, y: 0, scale: 1, filter: "blur(0px)" }}
|
|
460
|
+
exit={{ ...hintHidden, transition: { duration: duration.fast, ease: [...ease.standard] } }}
|
|
461
|
+
transition={reduced ? { duration: duration.instant } : { duration: duration.standard, ease: [...ease.enter] }}>{hint}</motion.span>}
|
|
462
|
+
</AnimatePresence>
|
|
463
|
+
</div>
|
|
464
|
+
<div ref={inkRef} className={styles.ink}>
|
|
465
|
+
<svg viewBox={`0 0 ${PAD_WIDTH} ${PAD_HEIGHT}`} preserveAspectRatio="none" aria-hidden="true">
|
|
466
|
+
<AnimatePresence initial={false}>
|
|
467
|
+
{visible.map(({ stroke, d }) => <motion.path key={stroke.id} className={styles.stroke} data-color={stroke.color}
|
|
468
|
+
d={d ?? strokePath(stroke)} initial={history.fresh === stroke.id ? false : { opacity: 0 }} animate={{ opacity: 1 }}
|
|
469
|
+
exit={{ opacity: 0, transition: { duration: wiping ? 0 : duration.standard, ease: [...ease.standard] } }}
|
|
470
|
+
transition={{ duration: duration.standard, ease: [...ease.standard] }} />)}
|
|
471
|
+
</AnimatePresence>
|
|
472
|
+
<path ref={liveRef} className={styles.stroke} data-color={color} />
|
|
473
|
+
{nib && <circle className={styles.nib} data-color={nibColor} cx={nib.x} cy={nib.y} r={WIDTHS[width].size * .9} />}
|
|
474
|
+
</svg>
|
|
475
|
+
</div>
|
|
476
|
+
{wiping && <motion.span className={styles.sweep} aria-hidden="true" initial={{ x: "0%", opacity: 0 }} animate={{ x: "100%", opacity: [0, 1, 1, 0] }}
|
|
477
|
+
transition={{ duration: .56, ease: [...ease.inOut], opacity: { duration: .56, times: [0, .12, .85, 1] } }} />}
|
|
478
|
+
</div>
|
|
479
|
+
|
|
480
|
+
<div className={styles.toolbar}>
|
|
481
|
+
<div className={styles.group}>
|
|
482
|
+
<Choice label="Ink color" options={COLORS} value={color} onChange={next => { setColor(next); setStatus(`${INK[next].label} selected`); }} layoutId={`${uid}-color`} reduced={reduced}
|
|
483
|
+
render={option => <span className={styles.swatch} data-color={option} />} name={option => INK[option].label} />
|
|
484
|
+
<span className={styles.divider} aria-hidden="true" />
|
|
485
|
+
<Choice label="Stroke width" options={SIZES} value={width} onChange={next => { setWidth(next); setStatus(`${WIDTHS[next].label} nib selected`); }} layoutId={`${uid}-width`} reduced={reduced}
|
|
486
|
+
render={option => <span className={styles.weight} style={{ width: WIDTHS[option].size + 2, height: WIDTHS[option].size + 2 }} />} name={option => WIDTHS[option].label} />
|
|
487
|
+
</div>
|
|
488
|
+
<div className={styles.group}>
|
|
489
|
+
<IconButton label="Undo" onClick={undo} disabled={!history.past.length || wiping}><Undo2 size={18} strokeWidth={1.75} aria-hidden="true" /></IconButton>
|
|
490
|
+
<IconButton label="Redo" onClick={redo} disabled={!history.future.length || wiping}><Redo2 size={18} strokeWidth={1.75} aria-hidden="true" /></IconButton>
|
|
491
|
+
<IconButton label={replaying ? "Stop replay" : "Replay signature"} onClick={toggleReplay} disabled={empty || wiping} pressed={replaying}>
|
|
492
|
+
<AnimatePresence mode="popLayout" initial={false}>
|
|
493
|
+
<motion.span key={replaying ? "stop" : "play"} className={styles.swap} initial={{ opacity: 0, scale: .6 }} animate={{ opacity: 1, scale: 1 }} exit={{ opacity: 0, scale: .6 }} transition={t}>
|
|
494
|
+
{replaying ? <Square size={15} strokeWidth={1.75} aria-hidden="true" /> : <Play size={17} strokeWidth={1.75} aria-hidden="true" />}
|
|
495
|
+
</motion.span>
|
|
496
|
+
</AnimatePresence>
|
|
497
|
+
</IconButton>
|
|
498
|
+
<IconButton label="Clear signature" onClick={clear} disabled={empty || wiping}><Eraser size={18} strokeWidth={1.75} aria-hidden="true" /></IconButton>
|
|
499
|
+
</div>
|
|
500
|
+
</div>
|
|
501
|
+
|
|
502
|
+
<div className={styles.exports}>
|
|
503
|
+
<span className={styles.exportLabel}>Save as</span>
|
|
504
|
+
{(["png", "svg"] as const).map(kind => <button key={kind} type="button" className={styles.export} onClick={() => save(kind)} disabled={empty}
|
|
505
|
+
aria-label={`Download ${kind.toUpperCase()}`}>
|
|
506
|
+
<AnimatePresence mode="popLayout" initial={false}>
|
|
507
|
+
<motion.span key={saved === kind ? "done" : saved === "failed" ? "failed" : "idle"} className={styles.exportContent}
|
|
508
|
+
initial={{ opacity: 0, y: reduced ? 0 : 4, filter: reduced ? "blur(0px)" : `blur(${blur.subtle}px)` }} animate={{ opacity: 1, y: 0, filter: "blur(0px)" }}
|
|
509
|
+
exit={{ opacity: 0, y: reduced ? 0 : -4, transition: { duration: duration.instant } }} transition={reduced ? { duration: duration.instant } : { duration: duration.fast, ease: [...ease.enter] }}>
|
|
510
|
+
{saved === kind ? <><Check size={15} strokeWidth={1.75} aria-hidden="true" />Saved</> : <><Download size={15} strokeWidth={1.75} aria-hidden="true" />{kind.toUpperCase()}</>}
|
|
511
|
+
</motion.span>
|
|
512
|
+
</AnimatePresence>
|
|
513
|
+
</button>)}
|
|
514
|
+
</div>
|
|
515
|
+
<p id={`${uid}-keys`} className={styles.srOnly}>Press Control or Command Z to undo, add Shift to redo, and Delete to clear.</p>
|
|
516
|
+
<p className={styles.srOnly} role="status" aria-live="polite">{status}</p>
|
|
517
|
+
</div>;
|
|
518
|
+
}
|
|
519
|
+
|
|
520
|
+
function IconButton({ label, onClick, disabled, pressed, children }: { label: string; onClick: () => void; disabled?: boolean; pressed?: boolean; children: ReactNode }) {
|
|
521
|
+
return <button type="button" className={styles.iconButton} aria-label={label} title={label} onClick={onClick} disabled={disabled} aria-pressed={pressed}>{children}</button>;
|
|
522
|
+
}
|
|
523
|
+
|
|
524
|
+
/** A compact radio group with a highlight that glides to the chosen option. Arrow keys move the choice. */
|
|
525
|
+
function Choice<T extends string>({ label, options, value, onChange, render, name, layoutId, reduced }: {
|
|
526
|
+
label: string; options: T[]; value: T; onChange: (value: T) => void; render: (option: T) => ReactNode; name: (option: T) => string; layoutId: string; reduced: boolean;
|
|
527
|
+
}) {
|
|
528
|
+
const refs = useRef<(HTMLButtonElement | null)[]>([]);
|
|
529
|
+
function onKeyDown(event: ReactKeyboardEvent<HTMLDivElement>) {
|
|
530
|
+
const step = event.key === "ArrowRight" || event.key === "ArrowDown" ? 1 : event.key === "ArrowLeft" || event.key === "ArrowUp" ? -1 : 0;
|
|
531
|
+
if (!step) return;
|
|
532
|
+
event.preventDefault();
|
|
533
|
+
const index = (options.indexOf(value) + step + options.length) % options.length;
|
|
534
|
+
onChange(options[index]!);
|
|
535
|
+
refs.current[index]?.focus();
|
|
536
|
+
}
|
|
537
|
+
return <div className={styles.choice} role="radiogroup" aria-label={label} onKeyDown={onKeyDown}>
|
|
538
|
+
{options.map((option, index) => <button key={option} ref={node => { refs.current[index] = node; }} type="button" role="radio" aria-checked={option === value}
|
|
539
|
+
aria-label={name(option)} title={name(option)} tabIndex={option === value ? 0 : -1} className={styles.option} onClick={() => onChange(option)}>
|
|
540
|
+
{option === value && <motion.span layoutId={layoutId} className={styles.selected} transition={reduced ? { duration: 0 } : spring.morph} />}
|
|
541
|
+
{render(option)}
|
|
542
|
+
</button>)}
|
|
543
|
+
</div>;
|
|
544
|
+
}
|
|
545
|
+
|
|
546
|
+
export default SignaturePad;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
.root { display: flex; width: 100%; min-width: 0; align-items: flex-start; gap: var(--space-4); }
|
|
2
|
+
/* A calm, finite pulse: each block dims a beat after the one above it, then rests after about 20 seconds. */
|
|
3
|
+
.avatar, .line { display: block; flex: 0 0 auto; border-radius: var(--radius-control); background: color-mix(in oklab, var(--border-strong) 38%, var(--surface)); animation: skeleton-pulse 1.8s var(--ease-in-out) calc(var(--index, 0) * 90ms) 11 both; }
|
|
4
|
+
.avatar { width: var(--control-height-md); height: var(--control-height-md); border-radius: var(--radius-pill); }
|
|
5
|
+
.lines { display: grid; flex: 1; gap: var(--space-3); padding-top: var(--space-1); }
|
|
6
|
+
.line { width: 100%; height: var(--space-3); }
|
|
7
|
+
.line:first-child { width: 48%; height: var(--space-4); }
|
|
8
|
+
.line:last-child { width: 72%; }
|
|
9
|
+
.frame { position: relative; display: flow-root; }
|
|
10
|
+
@keyframes skeleton-pulse { 0%, 100% { opacity: 1; } 50% { opacity: .52; } }
|
|
11
|
+
@media (prefers-reduced-motion: reduce) { .avatar, .line { animation: none; } }
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import { useEffect, useLayoutEffect, useRef, type CSSProperties, type ReactNode } from "react";
|
|
4
|
+
import { AnimatePresence, animate, motion, useMotionValue, useReducedMotion, type AnimationPlaybackControls } from "motion/react";
|
|
5
|
+
import { motionTokens } from "@/lib/motion-tokens";
|
|
6
|
+
import styles from "./skeleton.module.css";
|
|
7
|
+
|
|
8
|
+
export interface SkeletonProps {
|
|
9
|
+
label?: string;
|
|
10
|
+
lines?: number;
|
|
11
|
+
avatar?: boolean;
|
|
12
|
+
className?: string;
|
|
13
|
+
/** Content to reveal once loading finishes. With children, the placeholder crossfades into them. */
|
|
14
|
+
children?: ReactNode;
|
|
15
|
+
/** Keeps the placeholder visible while true. Only used together with children. */
|
|
16
|
+
loading?: boolean;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/** Follows its content height. After `morphKey` changes, the height springs from the old size to the new one and then returns to auto, so passive reflows (a resize, a font swap) follow instantly. It clips only while moving, so focus rings stay visible at rest. */
|
|
20
|
+
function HeightFrame({ className, busy, reduce, children }: { className?: string; busy: boolean; reduce: boolean | null; children: ReactNode }) {
|
|
21
|
+
const frame = useRef<HTMLDivElement>(null);
|
|
22
|
+
const content = useRef<HTMLDivElement>(null);
|
|
23
|
+
const height = useMotionValue<number | "auto">("auto");
|
|
24
|
+
const changedAt = useRef(0);
|
|
25
|
+
useLayoutEffect(() => { changedAt.current = performance.now(); }, [busy]);
|
|
26
|
+
useEffect(() => {
|
|
27
|
+
const node = content.current;
|
|
28
|
+
if (!node || typeof ResizeObserver === "undefined") return;
|
|
29
|
+
let last: number | undefined;
|
|
30
|
+
let controls: AnimationPlaybackControls | undefined;
|
|
31
|
+
const settle = () => { height.jump("auto"); if (frame.current) Object.assign(frame.current.style, { overflow: "", height: "auto" }); };
|
|
32
|
+
const observer = new ResizeObserver(([entry]) => {
|
|
33
|
+
if (!entry) return;
|
|
34
|
+
const next = entry.borderBoxSize?.[0]?.blockSize ?? node.offsetHeight;
|
|
35
|
+
const current = height.get();
|
|
36
|
+
const from = typeof current === "number" ? current : last;
|
|
37
|
+
last = next;
|
|
38
|
+
controls?.stop();
|
|
39
|
+
if (reduce || from === undefined || from === next || performance.now() - changedAt.current > 120) return settle();
|
|
40
|
+
// Pin the old height before this frame paints, then spring to the new one.
|
|
41
|
+
if (frame.current) Object.assign(frame.current.style, { overflow: "hidden", height: `${from}px` });
|
|
42
|
+
controls = animate(height, [from, next], { ...motionTokens.spring.smooth, onComplete: settle });
|
|
43
|
+
});
|
|
44
|
+
observer.observe(node);
|
|
45
|
+
return () => { observer.disconnect(); controls?.stop(); };
|
|
46
|
+
}, [height, reduce]);
|
|
47
|
+
return <motion.div ref={frame} className={className} aria-busy={busy} style={{ height }}>
|
|
48
|
+
<div ref={content} className={styles.frame}>{children}</div>
|
|
49
|
+
</motion.div>;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function Skeleton({ label = "Loading content", lines = 3, avatar = false, className, children, loading = true }: SkeletonProps) {
|
|
53
|
+
const reduce = useReducedMotion();
|
|
54
|
+
const count = Math.min(Math.max(Math.floor(lines), 1), 6);
|
|
55
|
+
// Each block pulses a beat after the one above it, so the wait reads as one calm wave.
|
|
56
|
+
const placeholder = (extra?: string) => <div className={[styles.root, extra].filter(Boolean).join(" ")} role="status" aria-label={label} aria-busy="true">
|
|
57
|
+
{avatar && <span className={styles.avatar} aria-hidden="true" />}
|
|
58
|
+
<span className={styles.lines} aria-hidden="true">{Array.from({ length: count }, (_, index) => <span className={styles.line} style={{ "--index": index + (avatar ? 1 : 0) } as CSSProperties} key={index} />)}</span>
|
|
59
|
+
</div>;
|
|
60
|
+
if (children === undefined) return placeholder(className);
|
|
61
|
+
return <HeightFrame className={className} busy={loading} reduce={reduce}>
|
|
62
|
+
<AnimatePresence mode="popLayout" initial={false}>
|
|
63
|
+
{loading
|
|
64
|
+
? <motion.div key="placeholder" initial={{ opacity: 0 }} animate={{ opacity: 1 }} transition={{ duration: reduce ? motionTokens.duration.instant : motionTokens.duration.fast, ease: [...motionTokens.ease.standard] }} exit={{ opacity: 0, transition: { duration: reduce ? motionTokens.duration.instant : motionTokens.duration.fast } }}>{placeholder()}</motion.div>
|
|
65
|
+
: <motion.div key="content" initial={reduce ? { opacity: 0 } : { opacity: 0, y: 4 }} animate={{ opacity: 1, y: 0 }} exit={{ opacity: 0, transition: { duration: reduce ? motionTokens.duration.instant : motionTokens.duration.fast } }} transition={{ duration: reduce ? motionTokens.duration.instant : motionTokens.duration.standard, ease: [...motionTokens.ease.enter] }}>{children}</motion.div>}
|
|
66
|
+
</AnimatePresence>
|
|
67
|
+
</HeightFrame>;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export default Skeleton;
|