motion-ui-skill 2.1.1 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1011) hide show
  1. package/README.md +449 -219
  2. package/SKILL.md +268 -22
  3. package/bin/index.mjs +4 -3
  4. package/bin/installer.mjs +11 -1
  5. package/catalog.json +5989 -239
  6. package/components/agents/ai-agent-activity.tsx +443 -0
  7. package/components/agents/ai-response.tsx +829 -0
  8. package/components/agents/ai-status.tsx +373 -0
  9. package/components/agents/chat-thread.module.css +242 -0
  10. package/components/agents/chat-thread.tsx +700 -0
  11. package/components/agents/citations.tsx +1 -1
  12. package/components/agents/comment-thread.module.css +195 -0
  13. package/components/agents/comment-thread.tsx +593 -0
  14. package/components/agents/json-viewer.module.css +92 -0
  15. package/components/agents/json-viewer.tsx +530 -0
  16. package/components/agents/matrix-orb.tsx +252 -0
  17. package/components/agents/text-stream.css +17 -0
  18. package/components/agents/text-stream.tsx +169 -0
  19. package/components/agents/thinking-orb.tsx +653 -0
  20. package/components/agents/web-search.tsx +932 -0
  21. package/components/analytics-dashboard/context.ts +47 -0
  22. package/components/analytics-dashboard/data.ts +351 -0
  23. package/components/analytics-dashboard/details.tsx +282 -0
  24. package/components/analytics-dashboard/icons.tsx +219 -0
  25. package/components/analytics-dashboard/number-animation.module.css +19 -0
  26. package/components/analytics-dashboard/number-animation.tsx +183 -0
  27. package/components/analytics-dashboard/pages.tsx +673 -0
  28. package/components/analytics-dashboard/ui.tsx +238 -0
  29. package/components/blocks/active-sessions.css +52 -0
  30. package/components/blocks/active-sessions.tsx +679 -0
  31. package/components/blocks/activity-feed.tsx +432 -0
  32. package/components/blocks/activity-heatmap.module.css +83 -0
  33. package/components/blocks/activity-heatmap.tsx +416 -0
  34. package/components/blocks/advanced-data-table.tsx +1078 -0
  35. package/components/blocks/analytics-dashboard.css +2822 -0
  36. package/components/blocks/analytics-dashboard.tsx +394 -0
  37. package/components/blocks/art-gallery.tsx +508 -0
  38. package/components/blocks/bar-chart.module.css +49 -0
  39. package/components/blocks/bar-chart.tsx +394 -0
  40. package/components/blocks/blog-grid-data.ts +127 -0
  41. package/components/blocks/blog-grid.module.css +93 -0
  42. package/components/blocks/blog-grid.tsx +263 -0
  43. package/components/blocks/brush-chart.module.css +69 -0
  44. package/components/blocks/brush-chart.tsx +459 -0
  45. package/components/blocks/changelog-feed.module.css +138 -0
  46. package/components/blocks/changelog-feed.tsx +401 -0
  47. package/components/blocks/chat.tsx +785 -0
  48. package/components/blocks/comparison-table-data.ts +63 -0
  49. package/components/blocks/comparison-table.module.css +92 -0
  50. package/components/blocks/comparison-table.tsx +209 -0
  51. package/components/blocks/cta-section-data.ts +42 -0
  52. package/components/blocks/cta-section.module.css +95 -0
  53. package/components/blocks/cta-section.tsx +261 -0
  54. package/components/blocks/dashboard-shell.css +110 -0
  55. package/components/blocks/dashboard-shell.tsx +1067 -0
  56. package/components/blocks/empty-states-art.ts +331 -0
  57. package/components/blocks/empty-states.module.css +52 -0
  58. package/components/blocks/empty-states.tsx +326 -0
  59. package/components/blocks/family-drawer.tsx +695 -0
  60. package/components/blocks/faq.tsx +214 -0
  61. package/components/blocks/footer.tsx +117 -0
  62. package/components/blocks/form.tsx +594 -0
  63. package/components/blocks/hero-cadence.module.css +46 -0
  64. package/components/blocks/hero-cadence.tsx +68 -0
  65. package/components/blocks/hero-content.module.css +49 -0
  66. package/components/blocks/hero-content.tsx +93 -0
  67. package/components/blocks/hero-lumen-data.ts +97 -0
  68. package/components/blocks/hero-lumen.module.css +127 -0
  69. package/components/blocks/hero-lumen.tsx +204 -0
  70. package/components/blocks/hero-mesh.module.css +5 -0
  71. package/components/blocks/hero-mesh.tsx +200 -0
  72. package/components/blocks/hero-motion.ts +31 -0
  73. package/components/blocks/hero-relay.module.css +102 -0
  74. package/components/blocks/hero-relay.tsx +252 -0
  75. package/components/blocks/hero-section.module.css +31 -0
  76. package/components/blocks/hero-section.tsx +83 -0
  77. package/components/blocks/hook-sidebar.tsx +233 -0
  78. package/components/blocks/line-chart.module.css +60 -0
  79. package/components/blocks/line-chart.tsx +434 -0
  80. package/components/blocks/login-centered.module.css +94 -0
  81. package/components/blocks/login-centered.tsx +444 -0
  82. package/components/blocks/logo-marquee.module.css +162 -0
  83. package/components/blocks/logo-marquee.tsx +106 -0
  84. package/components/blocks/newsletter-signup-data.ts +95 -0
  85. package/components/blocks/newsletter-signup.module.css +175 -0
  86. package/components/blocks/newsletter-signup.tsx +369 -0
  87. package/components/blocks/notification-center.module.css +79 -0
  88. package/components/blocks/notification-center.tsx +244 -0
  89. package/components/blocks/page-header.module.css +161 -0
  90. package/components/blocks/page-header.tsx +495 -0
  91. package/components/blocks/plan-comparison.module.css +87 -0
  92. package/components/blocks/plan-comparison.tsx +120 -0
  93. package/components/blocks/pricing.tsx +421 -0
  94. package/components/blocks/product-tour.tsx +621 -0
  95. package/components/blocks/proximity-sidebar.tsx +397 -0
  96. package/components/blocks/rail-toc.tsx +468 -0
  97. package/components/blocks/scroll-progress.tsx +375 -0
  98. package/components/blocks/sidebar-stackbits.tsx +362 -0
  99. package/components/blocks/sign-in.module.css +73 -0
  100. package/components/blocks/sign-in.tsx +337 -0
  101. package/components/blocks/site-header.module.css +115 -0
  102. package/components/blocks/site-header.tsx +548 -0
  103. package/components/blocks/slope-chart.module.css +51 -0
  104. package/components/blocks/slope-chart.tsx +256 -0
  105. package/components/blocks/sortable-data-table.module.css +118 -0
  106. package/components/blocks/sortable-data-table.tsx +312 -0
  107. package/components/blocks/stats-band-data.ts +67 -0
  108. package/components/blocks/stats-band-world.ts +20 -0
  109. package/components/blocks/stats-band.module.css +150 -0
  110. package/components/blocks/stats-band.tsx +236 -0
  111. package/components/blocks/status-bars.css +52 -0
  112. package/components/blocks/status-bars.tsx +406 -0
  113. package/components/blocks/step-player.tsx +344 -0
  114. package/components/blocks/task-list.tsx +374 -0
  115. package/components/blocks/waffle-chart.module.css +52 -0
  116. package/components/blocks/waffle-chart.tsx +303 -0
  117. package/components/buttons/ash-burst-button.tsx +1 -1
  118. package/components/buttons/minecraft-button.tsx +1 -1
  119. package/components/craft/Button.tsx +137 -0
  120. package/components/craft/Form.tsx +594 -0
  121. package/components/craft/airport-matrix-clock.tsx +389 -0
  122. package/components/craft/animated-counter.tsx +384 -0
  123. package/components/craft/batch-gesture-tray.tsx +273 -0
  124. package/components/craft/car-smoke-page-transition.tsx +1147 -0
  125. package/components/craft/circular-orbit.tsx +270 -0
  126. package/components/craft/click-spark.tsx +205 -0
  127. package/components/craft/code-snippet-deck.tsx +275 -0
  128. package/components/craft/command.tsx +186 -0
  129. package/components/craft/cursor-follower.tsx +156 -0
  130. package/components/craft/delete-button.tsx +285 -0
  131. package/components/craft/density-lens.tsx +115 -0
  132. package/components/craft/dependency-trace.tsx +219 -0
  133. package/components/craft/depth-corridor.tsx +179 -0
  134. package/components/craft/discover-button.css +83 -0
  135. package/components/craft/discover-button.tsx +46 -0
  136. package/components/craft/drag-to-confirm.tsx +387 -0
  137. package/components/craft/draggable-marquee.css +5 -0
  138. package/components/craft/draggable-marquee.tsx +352 -0
  139. package/components/craft/duration-picker.tsx +291 -0
  140. package/components/craft/emoji-reaction.tsx +610 -0
  141. package/components/craft/empty.tsx +108 -0
  142. package/components/craft/evil-eye.tsx +350 -0
  143. package/components/craft/expandable-data-row.tsx +419 -0
  144. package/components/craft/field.tsx +250 -0
  145. package/components/craft/file-input.tsx +553 -0
  146. package/components/craft/flip-text.tsx +128 -0
  147. package/components/craft/fluid-orb.tsx +199 -0
  148. package/components/craft/focus-mode.tsx +262 -0
  149. package/components/craft/folder-component.tsx +474 -0
  150. package/components/craft/framing.ts +53 -0
  151. package/components/craft/github-activity.tsx +682 -0
  152. package/components/craft/glitch-text.tsx +414 -0
  153. package/components/craft/glyph-matrix.tsx +411 -0
  154. package/components/craft/golden-gate-404/framing.ts +53 -0
  155. package/components/craft/golden-gate-404/golden-gate-404.css +271 -0
  156. package/components/craft/golden-gate-404/golden-gate-404.mdx +55 -0
  157. package/components/craft/golden-gate-404/golden-gate-scene.tsx +73 -0
  158. package/components/craft/golden-gate-404/golden-gate.css +157 -0
  159. package/components/craft/golden-gate-404/live.ts +592 -0
  160. package/components/craft/golden-gate-404/model.json +176 -0
  161. package/components/craft/golden-gate-404/projection.ts +41 -0
  162. package/components/craft/golden-gate-404.css +271 -0
  163. package/components/craft/golden-gate-404.tsx +67 -0
  164. package/components/craft/golden-gate-scene.tsx +73 -0
  165. package/components/craft/golden-gate.css +157 -0
  166. package/components/craft/gooey-nav.tsx +286 -0
  167. package/components/craft/gravity-letters.tsx +687 -0
  168. package/components/craft/gravity-particle-burst.tsx +150 -0
  169. package/components/craft/grid-reveal.tsx +683 -0
  170. package/components/craft/hover-img.css +156 -0
  171. package/components/craft/hover-img.tsx +160 -0
  172. package/components/craft/input-otp.tsx +79 -0
  173. package/components/craft/interactive-area-chart.tsx +482 -0
  174. package/components/craft/interactive-timeline.tsx +315 -0
  175. package/components/craft/intro-loader.tsx +250 -0
  176. package/components/craft/ios-search-bar.tsx +130 -0
  177. package/components/craft/liquid-metal.tsx +212 -0
  178. package/components/craft/liquid-toggle.tsx +308 -0
  179. package/components/craft/live.ts +592 -0
  180. package/components/craft/loaders-gooey-blobs.tsx +61 -0
  181. package/components/craft/lock-input.tsx +169 -0
  182. package/components/craft/login.tsx +276 -0
  183. package/components/craft/meteors.tsx +139 -0
  184. package/components/craft/metric-hud.tsx +371 -0
  185. package/components/craft/model.json +176 -0
  186. package/components/craft/morphing-blob.tsx +289 -0
  187. package/components/craft/morphing-dialog.tsx +118 -0
  188. package/components/craft/morphing-icon.tsx +74 -0
  189. package/components/craft/morphing-shape-loader.tsx +241 -0
  190. package/components/craft/nimbu-mirchi.tsx +360 -0
  191. package/components/craft/notification-bell.tsx +357 -0
  192. package/components/craft/orbital-loading-ring.tsx +104 -0
  193. package/components/craft/origin-dropdown.tsx +196 -0
  194. package/components/craft/particle-delete.tsx +266 -0
  195. package/components/craft/payment-receipt-printer.tsx +600 -0
  196. package/components/craft/payment-status.tsx +359 -0
  197. package/components/craft/projection.ts +41 -0
  198. package/components/craft/recovery-ledger.tsx +215 -0
  199. package/components/craft/rocket-party-popper.tsx +308 -0
  200. package/components/craft/scroll-progress-nav.tsx +256 -0
  201. package/components/craft/scrollvelocitytext.tsx +285 -0
  202. package/components/craft/selection-basket.tsx +147 -0
  203. package/components/craft/sheet.tsx +324 -0
  204. package/components/craft/shooting-stars.tsx +710 -0
  205. package/components/craft/sidebar.tsx +448 -0
  206. package/components/craft/sign-up.tsx +396 -0
  207. package/components/craft/skeumorphic-music-card.tsx +177 -0
  208. package/components/craft/slide-pagination.tsx +170 -0
  209. package/components/craft/slot-text.module.css +19 -0
  210. package/components/craft/slot-text.tsx +183 -0
  211. package/components/craft/smart-comparison.tsx +375 -0
  212. package/components/craft/smooth-scroll.tsx +63 -0
  213. package/components/craft/speed-warp.tsx +179 -0
  214. package/components/craft/split-showcase.tsx +268 -0
  215. package/components/craft/spotlight-search.tsx +337 -0
  216. package/components/craft/stack-unfold-panel.tsx +137 -0
  217. package/components/craft/sticky-pages.tsx +210 -0
  218. package/components/craft/text-scramble-decoder.tsx +139 -0
  219. package/components/craft/toggle.tsx +49 -0
  220. package/components/craft/torque-dial.tsx +293 -0
  221. package/components/craft/v-prism-settings.ts +31 -0
  222. package/components/craft/v-prism.tsx +797 -0
  223. package/components/craft/voice-note.tsx +730 -0
  224. package/components/docks/mac-dock.tsx +1 -1
  225. package/components/motion/accordion.module.css +15 -0
  226. package/components/motion/accordion.tsx +59 -0
  227. package/components/motion/action-button.module.css +20 -0
  228. package/components/motion/action-button.tsx +120 -0
  229. package/components/motion/action-sheet.tsx +1 -1
  230. package/components/motion/alert.module.css +15 -0
  231. package/components/motion/alert.tsx +109 -0
  232. package/components/motion/animated-counter.tsx +2 -0
  233. package/components/motion/animated-sidebar.tsx +1 -1
  234. package/components/motion/animated-toast-stack.tsx +1 -1
  235. package/components/motion/attachment-upload.tsx +1 -1
  236. package/components/motion/avatar.module.css +60 -0
  237. package/components/motion/avatar.tsx +21 -0
  238. package/components/motion/badge.module.css +52 -0
  239. package/components/motion/badge.tsx +82 -0
  240. package/components/motion/banner-stacking.tsx +3 -3
  241. package/components/motion/billing-toggle.module.css +139 -0
  242. package/components/motion/billing-toggle.tsx +205 -0
  243. package/components/motion/book-call-button.tsx +332 -0
  244. package/components/motion/bottom-sheet.tsx +1 -1
  245. package/components/motion/branching-submenu.tsx +223 -0
  246. package/components/motion/button/index.tsx +1 -0
  247. package/components/motion/button-group.module.css +87 -0
  248. package/components/motion/button-group.tsx +346 -0
  249. package/components/motion/calendar.module.css +51 -0
  250. package/components/motion/calendar.tsx +313 -0
  251. package/components/motion/card-stack.module.css +63 -0
  252. package/components/motion/card-stack.tsx +372 -0
  253. package/components/motion/card.module.css +51 -0
  254. package/components/motion/card.tsx +201 -0
  255. package/components/motion/carousel.module.css +42 -0
  256. package/components/motion/carousel.tsx +347 -0
  257. package/components/motion/center-morph-modal.tsx +1 -1
  258. package/components/motion/chart.tsx +359 -0
  259. package/components/motion/chip-group.module.css +38 -0
  260. package/components/motion/chip-group.tsx +256 -0
  261. package/components/motion/combobox/content.tsx +1 -1
  262. package/components/motion/command-menu.tsx +295 -0
  263. package/components/motion/command-palette.tsx +1 -1
  264. package/components/motion/confirm-morph.module.css +146 -0
  265. package/components/motion/confirm-morph.tsx +445 -0
  266. package/components/motion/context-menu.tsx +1 -1
  267. package/components/motion/cookie-consent.module.css +68 -0
  268. package/components/motion/cookie-consent.tsx +364 -0
  269. package/components/motion/countdown.module.css +49 -0
  270. package/components/motion/countdown.tsx +218 -0
  271. package/components/motion/date-picker.module.css +34 -0
  272. package/components/motion/date-picker.tsx +131 -0
  273. package/components/motion/dialog.module.css +36 -0
  274. package/components/motion/dialog.tsx +75 -0
  275. package/components/motion/dock.tsx +1 -1
  276. package/components/motion/dropdown-menu-morph.tsx +4 -4
  277. package/components/motion/dropdown-menu.module.css +38 -0
  278. package/components/motion/dropdown-menu.tsx +76 -0
  279. package/components/motion/elastic-slider.module.css +40 -0
  280. package/components/motion/elastic-slider.tsx +296 -0
  281. package/components/motion/empty-state.module.css +13 -0
  282. package/components/motion/empty-state.tsx +88 -0
  283. package/components/motion/expandable-card.module.css +22 -0
  284. package/components/motion/expandable-card.tsx +129 -0
  285. package/components/motion/expandable-text.module.css +19 -0
  286. package/components/motion/expandable-text.tsx +168 -0
  287. package/components/motion/expanding-button-group.module.css +44 -0
  288. package/components/motion/expanding-button-group.tsx +367 -0
  289. package/components/motion/expanding-search.module.css +51 -0
  290. package/components/motion/expanding-search.tsx +336 -0
  291. package/components/motion/file-dropzone.module.css +115 -0
  292. package/components/motion/file-dropzone.tsx +442 -0
  293. package/components/motion/filter-toolbar.module.css +70 -0
  294. package/components/motion/filter-toolbar.tsx +461 -0
  295. package/components/motion/floating-button-group.module.css +74 -0
  296. package/components/motion/floating-button-group.tsx +307 -0
  297. package/components/motion/gauge.module.css +22 -0
  298. package/components/motion/gauge.tsx +106 -0
  299. package/components/motion/hamburger-menu.tsx +103 -0
  300. package/components/motion/hold-to-confirm.module.css +20 -0
  301. package/components/motion/hold-to-confirm.tsx +209 -0
  302. package/components/motion/icon-morph.module.css +5 -0
  303. package/components/motion/icon-morph.tsx +239 -0
  304. package/components/motion/image-compare.module.css +25 -0
  305. package/components/motion/image-compare.tsx +278 -0
  306. package/components/motion/in-view-title.module.css +13 -0
  307. package/components/motion/in-view-title.tsx +74 -0
  308. package/components/motion/inline-edit.module.css +73 -0
  309. package/components/motion/inline-edit.tsx +360 -0
  310. package/components/motion/input-group.tsx +172 -0
  311. package/components/motion/item.tsx +197 -0
  312. package/components/motion/label.tsx +26 -0
  313. package/components/motion/liquid-ripple-button.tsx +193 -0
  314. package/components/motion/mac-os-folder-cards.tsx +268 -0
  315. package/components/motion/magnetic-button.tsx +96 -0
  316. package/components/motion/mention-input.module.css +134 -0
  317. package/components/motion/mention-input.tsx +522 -0
  318. package/components/motion/menubar.tsx +282 -0
  319. package/components/motion/money-card.tsx +1134 -0
  320. package/components/motion/money-input.module.css +77 -0
  321. package/components/motion/money-input.tsx +563 -0
  322. package/components/motion/morph-select.module.css +86 -0
  323. package/components/motion/morph-select.tsx +463 -0
  324. package/components/motion/morphing-button.tsx +141 -0
  325. package/components/motion/morphing-mega-menu.tsx +452 -0
  326. package/components/motion/morphing-search.tsx +1 -1
  327. package/components/motion/morphing-tabs.tsx +1 -1
  328. package/components/motion/multi-select/content.tsx +1 -1
  329. package/components/motion/navigation-menu.tsx +172 -0
  330. package/components/motion/neon-edge-button.tsx +64 -0
  331. package/components/motion/onboarding-checklist.module.css +71 -0
  332. package/components/motion/onboarding-checklist.tsx +349 -0
  333. package/components/motion/organic-shimmer.tsx +6 -6
  334. package/components/motion/otp-input.tsx +7 -4
  335. package/components/motion/password-field.module.css +27 -0
  336. package/components/motion/password-field.tsx +65 -0
  337. package/components/motion/password-strength.module.css +57 -0
  338. package/components/motion/password-strength.tsx +327 -0
  339. package/components/motion/peek-card.tsx +239 -0
  340. package/components/motion/popover-morph.tsx +1 -1
  341. package/components/motion/popover.tsx +1 -1
  342. package/components/motion/preview-rail.tsx +1 -1
  343. package/components/motion/profile-card.tsx +326 -0
  344. package/components/motion/progress.module.css +1 -0
  345. package/components/motion/progress.tsx +60 -0
  346. package/components/motion/project-folder.tsx +1 -1
  347. package/components/motion/radio-cards.module.css +84 -0
  348. package/components/motion/radio-cards.tsx +153 -0
  349. package/components/motion/radio-group.module.css +30 -0
  350. package/components/motion/radio-group.tsx +52 -0
  351. package/components/motion/rainbow-button.tsx +186 -0
  352. package/components/motion/raised-button.tsx +108 -0
  353. package/components/motion/range-histogram-slider.module.css +27 -0
  354. package/components/motion/range-histogram-slider.tsx +284 -0
  355. package/components/motion/reactions.module.css +49 -0
  356. package/components/motion/reactions.tsx +288 -0
  357. package/components/motion/resizable-panels.module.css +40 -0
  358. package/components/motion/resizable-panels.tsx +376 -0
  359. package/components/motion/resizable.tsx +58 -0
  360. package/components/motion/rich-text-editor.module.css +201 -0
  361. package/components/motion/rich-text-editor.tsx +1566 -0
  362. package/components/motion/ridgeline.module.css +58 -0
  363. package/components/motion/ridgeline.tsx +355 -0
  364. package/components/motion/scroll-area.module.css +79 -0
  365. package/components/motion/scroll-area.tsx +197 -0
  366. package/components/motion/scrub-input.module.css +135 -0
  367. package/components/motion/scrub-input.tsx +468 -0
  368. package/components/motion/search-field.module.css +17 -0
  369. package/components/motion/search-field.tsx +19 -0
  370. package/components/motion/segmented-control.tsx +2 -0
  371. package/components/motion/separator.tsx +30 -0
  372. package/components/motion/shortcut-recorder.module.css +85 -0
  373. package/components/motion/shortcut-recorder.tsx +513 -0
  374. package/components/motion/signature-pad.module.css +84 -0
  375. package/components/motion/signature-pad.tsx +546 -0
  376. package/components/motion/skeleton.module.css +11 -0
  377. package/components/motion/skeleton.tsx +70 -0
  378. package/components/motion/slider.module.css +45 -0
  379. package/components/motion/slider.tsx +405 -0
  380. package/components/motion/sonner.tsx +42 -0
  381. package/components/motion/sparkline.module.css +26 -0
  382. package/components/motion/sparkline.tsx +260 -0
  383. package/components/motion/spinner.tsx +20 -0
  384. package/components/motion/split-button.module.css +54 -0
  385. package/components/motion/split-button.tsx +114 -0
  386. package/components/motion/story-card.tsx +632 -0
  387. package/components/motion/streamgraph.module.css +55 -0
  388. package/components/motion/streamgraph.tsx +398 -0
  389. package/components/motion/swipe-actions.module.css +64 -0
  390. package/components/motion/swipe-actions.tsx +360 -0
  391. package/components/motion/table/row-handle.tsx +1 -1
  392. package/components/motion/table/table-header.tsx +1 -1
  393. package/components/motion/table/table-menu.tsx +1 -1
  394. package/components/motion/tag-input.module.css +34 -0
  395. package/components/motion/tag-input.tsx +150 -0
  396. package/components/motion/textarea.module.css +22 -0
  397. package/components/motion/textarea.tsx +64 -0
  398. package/components/motion/theme-switch-eclipse.tsx +82 -0
  399. package/components/motion/theme-switch-rise.tsx +82 -0
  400. package/components/motion/theme-switch-split.tsx +82 -0
  401. package/components/motion/theme-switch.module.css +31 -0
  402. package/components/motion/theme-switch.tsx +82 -0
  403. package/components/motion/time-picker.module.css +23 -0
  404. package/components/motion/time-picker.tsx +106 -0
  405. package/components/motion/toast.module.css +100 -0
  406. package/components/motion/toast.tsx +155 -0
  407. package/components/motion/tooltip.tsx +1 -1
  408. package/components/motion/treemap.module.css +59 -0
  409. package/components/motion/treemap.tsx +333 -0
  410. package/components/motion/undo-toast.tsx +252 -0
  411. package/components/motion/usage-meter.module.css +61 -0
  412. package/components/motion/usage-meter.tsx +340 -0
  413. package/components/otp/otp-boxed-input.tsx +18 -18
  414. package/components/previews/agents/ai-agent-activity.preview.tsx +14 -0
  415. package/components/previews/agents/ai-response.preview.tsx +14 -0
  416. package/components/previews/agents/ai-status.preview.tsx +14 -0
  417. package/components/previews/agents/chat-thread.preview.tsx +18 -0
  418. package/components/previews/agents/comment-thread.preview.tsx +17 -0
  419. package/components/previews/agents/json-viewer.preview.tsx +14 -0
  420. package/components/previews/agents/matrix-orb.preview.tsx +14 -0
  421. package/components/previews/agents/text-stream.preview.tsx +19 -0
  422. package/components/previews/agents/thinking-orb.preview.tsx +14 -0
  423. package/components/previews/agents/web-search.preview.tsx +17 -0
  424. package/components/previews/blocks/active-sessions.preview.tsx +14 -0
  425. package/components/previews/blocks/activity-feed.preview.tsx +14 -0
  426. package/components/previews/blocks/activity-heatmap.preview.tsx +18 -0
  427. package/components/previews/blocks/advanced-data-table.preview.tsx +17 -0
  428. package/components/previews/blocks/analytics-dashboard.preview.tsx +14 -0
  429. package/components/previews/blocks/art-gallery.preview.tsx +14 -0
  430. package/components/previews/blocks/bar-chart.preview.tsx +18 -0
  431. package/components/previews/blocks/blog-grid.preview.tsx +14 -0
  432. package/components/previews/blocks/brush-chart.preview.tsx +17 -0
  433. package/components/previews/blocks/changelog-feed.preview.tsx +14 -0
  434. package/components/previews/blocks/chat.preview.tsx +18 -0
  435. package/components/previews/blocks/comparison-table.preview.tsx +14 -0
  436. package/components/previews/blocks/cta-section.preview.tsx +14 -0
  437. package/components/previews/blocks/dashboard-shell.preview.tsx +18 -0
  438. package/components/previews/blocks/empty-states.preview.tsx +14 -0
  439. package/components/previews/blocks/expandable-tabs.preview.tsx +1 -1
  440. package/components/previews/blocks/family-drawer.preview.tsx +14 -0
  441. package/components/previews/blocks/faq.preview.tsx +14 -0
  442. package/components/previews/blocks/footer.preview.tsx +14 -0
  443. package/components/previews/blocks/form.preview.tsx +14 -0
  444. package/components/previews/blocks/frame.preview.tsx +18 -0
  445. package/components/previews/blocks/gantt.preview.tsx +18 -0
  446. package/components/previews/blocks/hero-section.preview.tsx +14 -0
  447. package/components/previews/blocks/hook-sidebar.preview.tsx +14 -0
  448. package/components/previews/blocks/kanban.preview.tsx +68 -0
  449. package/components/previews/blocks/line-chart.preview.tsx +18 -0
  450. package/components/previews/blocks/login-centered.preview.tsx +14 -0
  451. package/components/previews/blocks/logo-marquee.preview.tsx +14 -0
  452. package/components/previews/blocks/newsletter-signup.preview.tsx +14 -0
  453. package/components/previews/blocks/notification-center.preview.tsx +14 -0
  454. package/components/previews/blocks/otp-input.preview.tsx +2 -2
  455. package/components/previews/blocks/page-header.preview.tsx +14 -0
  456. package/components/previews/blocks/plan-comparison.preview.tsx +14 -0
  457. package/components/previews/blocks/pricing.preview.tsx +14 -0
  458. package/components/previews/blocks/product-tour.preview.tsx +14 -0
  459. package/components/previews/blocks/proximity-sidebar.preview.tsx +14 -0
  460. package/components/previews/blocks/rail-toc.preview.tsx +14 -0
  461. package/components/previews/blocks/scroll-progress.preview.tsx +14 -0
  462. package/components/previews/blocks/sidebar-stackbits.preview.tsx +14 -0
  463. package/components/previews/blocks/sign-in.preview.tsx +14 -0
  464. package/components/previews/blocks/site-header.preview.tsx +14 -0
  465. package/components/previews/blocks/slope-chart.preview.tsx +19 -0
  466. package/components/previews/blocks/sortable-data-table.preview.tsx +18 -0
  467. package/components/previews/blocks/stats-band.preview.tsx +14 -0
  468. package/components/previews/blocks/status-bars.preview.tsx +17 -0
  469. package/components/previews/blocks/step-player.preview.tsx +14 -0
  470. package/components/previews/blocks/task-list.preview.tsx +14 -0
  471. package/components/previews/blocks/waffle-chart.preview.tsx +17 -0
  472. package/components/previews/craft/airport-matrix-clock.preview.tsx +14 -0
  473. package/components/previews/craft/animated-counter.preview.tsx +14 -0
  474. package/components/previews/craft/apple-notification.preview.tsx +11 -0
  475. package/components/previews/craft/batch-gesture-tray.preview.tsx +19 -0
  476. package/components/previews/craft/booking-slot-calendar.preview.tsx +11 -0
  477. package/components/previews/craft/cafe-menu-board.preview.tsx +11 -0
  478. package/components/previews/craft/calendar-reminder-notification.preview.tsx +11 -0
  479. package/components/previews/craft/car-smoke-page-transition.preview.tsx +14 -0
  480. package/components/previews/craft/chat-bubble-notification.preview.tsx +11 -0
  481. package/components/previews/craft/cinema-ticket.preview.tsx +11 -0
  482. package/components/previews/craft/circle-cut-frame.preview.tsx +11 -0
  483. package/components/previews/craft/circular-orbit.preview.tsx +14 -0
  484. package/components/previews/craft/click-spark.preview.tsx +14 -0
  485. package/components/previews/craft/code-snippet-deck.preview.tsx +14 -0
  486. package/components/previews/craft/command.preview.tsx +14 -0
  487. package/components/previews/craft/contact-profile.preview.tsx +11 -0
  488. package/components/previews/craft/credit-card-glass.preview.tsx +11 -0
  489. package/components/previews/craft/cursor-follower.preview.tsx +14 -0
  490. package/components/previews/craft/customers-table.preview.tsx +11 -0
  491. package/components/previews/craft/daily-motivation.preview.tsx +11 -0
  492. package/components/previews/craft/date-range-picker-card.preview.tsx +11 -0
  493. package/components/previews/craft/delete-button.preview.tsx +14 -0
  494. package/components/previews/craft/delivery-notification.preview.tsx +11 -0
  495. package/components/previews/craft/denim-product-editorial.preview.tsx +11 -0
  496. package/components/previews/craft/density-lens.preview.tsx +14 -0
  497. package/components/previews/craft/dependency-trace.preview.tsx +17 -0
  498. package/components/previews/craft/deploy-notification.preview.tsx +11 -0
  499. package/components/previews/craft/depth-corridor.preview.tsx +14 -0
  500. package/components/previews/craft/discord-chat.preview.tsx +11 -0
  501. package/components/previews/craft/discover-button.preview.tsx +14 -0
  502. package/components/previews/craft/doubt-button.preview.tsx +11 -0
  503. package/components/previews/craft/drag-to-confirm.preview.tsx +14 -0
  504. package/components/previews/craft/draggable-marquee.preview.tsx +17 -0
  505. package/components/previews/craft/drop-cap-editorial.preview.tsx +11 -0
  506. package/components/previews/craft/duration-picker.preview.tsx +14 -0
  507. package/components/previews/craft/editorial-staff-profile.preview.tsx +11 -0
  508. package/components/previews/craft/electric-scooter.preview.tsx +11 -0
  509. package/components/previews/craft/email-notification.preview.tsx +11 -0
  510. package/components/previews/craft/emoji-reaction.preview.tsx +14 -0
  511. package/components/previews/craft/empty.preview.tsx +14 -0
  512. package/components/previews/craft/event-ticket.preview.tsx +11 -0
  513. package/components/previews/craft/evil-eye.preview.tsx +14 -0
  514. package/components/previews/craft/expandable-data-row.preview.tsx +14 -0
  515. package/components/previews/craft/field.preview.tsx +14 -0
  516. package/components/previews/craft/file-input.preview.tsx +14 -0
  517. package/components/previews/craft/film-strip.preview.tsx +11 -0
  518. package/components/previews/craft/flight-boarding.preview.tsx +11 -0
  519. package/components/previews/craft/flip-text.preview.tsx +14 -0
  520. package/components/previews/craft/fluid-orb.preview.tsx +14 -0
  521. package/components/previews/craft/focus-mode.preview.tsx +14 -0
  522. package/components/previews/craft/folder-component.preview.tsx +14 -0
  523. package/components/previews/craft/folder-tab-card.preview.tsx +11 -0
  524. package/components/previews/craft/gallery-grid.preview.tsx +11 -0
  525. package/components/previews/craft/gallery-wall.preview.tsx +11 -0
  526. package/components/previews/craft/github-activity.preview.tsx +14 -0
  527. package/components/previews/craft/github-contribution.preview.tsx +11 -0
  528. package/components/previews/craft/github-repo.preview.tsx +11 -0
  529. package/components/previews/craft/glass-overlay-image.preview.tsx +11 -0
  530. package/components/previews/craft/glitch-text.preview.tsx +14 -0
  531. package/components/previews/craft/glyph-matrix.preview.tsx +14 -0
  532. package/components/previews/craft/golden-gate-404.preview.tsx +14 -0
  533. package/components/previews/craft/gooey-nav.preview.tsx +14 -0
  534. package/components/previews/craft/gravity-letters.preview.tsx +14 -0
  535. package/components/previews/craft/gravity-particle-burst.preview.tsx +14 -0
  536. package/components/previews/craft/grid-reveal.preview.tsx +14 -0
  537. package/components/previews/craft/hard-shadow-polaroid-frame.preview.tsx +11 -0
  538. package/components/previews/craft/hover-img.preview.tsx +14 -0
  539. package/components/previews/craft/incoming-call-notification.preview.tsx +11 -0
  540. package/components/previews/craft/ink-stamp-document.preview.tsx +11 -0
  541. package/components/previews/craft/input-group-field.preview.tsx +11 -0
  542. package/components/previews/craft/input-otp.preview.tsx +19 -0
  543. package/components/previews/craft/interactive-area-chart.preview.tsx +14 -0
  544. package/components/previews/craft/interactive-timeline.preview.tsx +14 -0
  545. package/components/previews/craft/intro-loader.preview.tsx +14 -0
  546. package/components/previews/craft/ios-search-bar.preview.tsx +15 -0
  547. package/components/previews/craft/ipad.preview.tsx +11 -0
  548. package/components/previews/craft/journal-writing.preview.tsx +11 -0
  549. package/components/previews/craft/keyboard-shortcuts.preview.tsx +11 -0
  550. package/components/previews/craft/linked-in-profile.preview.tsx +11 -0
  551. package/components/previews/craft/liquid-metal.preview.tsx +14 -0
  552. package/components/previews/craft/liquid-toggle.preview.tsx +14 -0
  553. package/components/previews/craft/loaders-gooey-blobs.preview.tsx +14 -0
  554. package/components/previews/craft/lock-input.preview.tsx +14 -0
  555. package/components/previews/craft/login.preview.tsx +14 -0
  556. package/components/previews/craft/mac-dock.preview.tsx +11 -0
  557. package/components/previews/craft/magazine-cover.preview.tsx +11 -0
  558. package/components/previews/craft/meteors.preview.tsx +14 -0
  559. package/components/previews/craft/metric-hud.preview.tsx +14 -0
  560. package/components/previews/craft/minimal-agenda.preview.tsx +11 -0
  561. package/components/previews/craft/month-picker-calendar.preview.tsx +11 -0
  562. package/components/previews/craft/morphing-blob.preview.tsx +14 -0
  563. package/components/previews/craft/morphing-dialog.preview.tsx +18 -0
  564. package/components/previews/craft/morphing-icon.preview.tsx +15 -0
  565. package/components/previews/craft/morphing-shape-loader.preview.tsx +14 -0
  566. package/components/previews/craft/museum-placard.preview.tsx +11 -0
  567. package/components/previews/craft/music-player.preview.tsx +11 -0
  568. package/components/previews/craft/music-playlist.preview.tsx +11 -0
  569. package/components/previews/craft/nimbu-mirchi.preview.tsx +14 -0
  570. package/components/previews/craft/notification-bell.preview.tsx +14 -0
  571. package/components/previews/craft/now-playing-bar.preview.tsx +11 -0
  572. package/components/previews/craft/orbital-loading-ring.preview.tsx +14 -0
  573. package/components/previews/craft/orders-table.preview.tsx +11 -0
  574. package/components/previews/craft/origin-dropdown.preview.tsx +14 -0
  575. package/components/previews/craft/otp-boxed-input.preview.tsx +11 -0
  576. package/components/previews/craft/otp-underline-input.preview.tsx +11 -0
  577. package/components/previews/craft/particle-delete.preview.tsx +14 -0
  578. package/components/previews/craft/payment-notification.preview.tsx +11 -0
  579. package/components/previews/craft/payment-receipt-printer.preview.tsx +14 -0
  580. package/components/previews/craft/payment-status.preview.tsx +14 -0
  581. package/components/previews/craft/phone.preview.tsx +11 -0
  582. package/components/previews/craft/photo-album.preview.tsx +11 -0
  583. package/components/previews/craft/progress-ring-card.preview.tsx +11 -0
  584. package/components/previews/craft/recent-transactions-table.preview.tsx +11 -0
  585. package/components/previews/craft/recovery-ledger.preview.tsx +14 -0
  586. package/components/previews/craft/resource-links-panel.preview.tsx +11 -0
  587. package/components/previews/craft/rocket-party-popper.preview.tsx +14 -0
  588. package/components/previews/craft/scroll-progress-nav.preview.tsx +14 -0
  589. package/components/previews/craft/scrollvelocitytext.preview.tsx +14 -0
  590. package/components/previews/craft/selection-basket.preview.tsx +14 -0
  591. package/components/previews/craft/sheet.preview.tsx +15 -0
  592. package/components/previews/craft/shooting-stars.preview.tsx +14 -0
  593. package/components/previews/craft/sidebar.preview.tsx +19 -0
  594. package/components/previews/craft/sign-up.preview.tsx +14 -0
  595. package/components/previews/craft/skeumorphic-music-card.preview.tsx +18 -0
  596. package/components/previews/craft/slide-pagination.preview.tsx +14 -0
  597. package/components/previews/craft/slide-to-confirm-button.preview.tsx +11 -0
  598. package/components/previews/craft/slide-to-detonate.preview.tsx +11 -0
  599. package/components/previews/craft/slot-text.preview.tsx +14 -0
  600. package/components/previews/craft/slow-living-polaroid.preview.tsx +11 -0
  601. package/components/previews/craft/smart-comparison.preview.tsx +17 -0
  602. package/components/previews/craft/smooth-scroll.preview.tsx +14 -0
  603. package/components/previews/craft/speed-warp.preview.tsx +14 -0
  604. package/components/previews/craft/split-showcase.preview.tsx +14 -0
  605. package/components/previews/craft/spotlight-search.preview.tsx +14 -0
  606. package/components/previews/craft/stack-unfold-panel.preview.tsx +14 -0
  607. package/components/previews/craft/stacked-folder-card.preview.tsx +11 -0
  608. package/components/previews/craft/step-count.preview.tsx +11 -0
  609. package/components/previews/craft/sticky-pages.preview.tsx +14 -0
  610. package/components/previews/craft/system-alert.preview.tsx +11 -0
  611. package/components/previews/craft/team-members-table.preview.tsx +11 -0
  612. package/components/previews/craft/testimonial.preview.tsx +11 -0
  613. package/components/previews/craft/text-scramble-decoder.preview.tsx +14 -0
  614. package/components/previews/craft/threads-post.preview.tsx +11 -0
  615. package/components/previews/craft/toggle-pricing-cards.preview.tsx +11 -0
  616. package/components/previews/craft/toggle.preview.tsx +14 -0
  617. package/components/previews/craft/torque-dial.preview.tsx +15 -0
  618. package/components/previews/craft/travel-postcard.preview.tsx +11 -0
  619. package/components/previews/craft/twitter-profile.preview.tsx +11 -0
  620. package/components/previews/craft/user-profile.preview.tsx +11 -0
  621. package/components/previews/craft/users-select-table.preview.tsx +11 -0
  622. package/components/previews/craft/v-prism.preview.tsx +14 -0
  623. package/components/previews/craft/voice-note.preview.tsx +14 -0
  624. package/components/previews/craft/wallet-pass.preview.tsx +11 -0
  625. package/components/previews/craft/weather-snapshot.preview.tsx +11 -0
  626. package/components/previews/craft/week-strip-calendar.preview.tsx +11 -0
  627. package/components/previews/motion/accordion.preview.tsx +14 -0
  628. package/components/previews/motion/action-button.preview.tsx +14 -0
  629. package/components/previews/motion/alert.preview.tsx +14 -0
  630. package/components/previews/motion/avatar.preview.tsx +14 -0
  631. package/components/previews/motion/badge.preview.tsx +14 -0
  632. package/components/previews/motion/banner-stacking.preview.tsx +21 -0
  633. package/components/previews/motion/billing-toggle.preview.tsx +15 -0
  634. package/components/previews/motion/book-call-button.preview.tsx +14 -0
  635. package/components/previews/motion/branching-submenu.preview.tsx +14 -0
  636. package/components/previews/motion/button-group.preview.tsx +19 -0
  637. package/components/previews/motion/calendar.preview.tsx +14 -0
  638. package/components/previews/motion/card-stack.preview.tsx +19 -0
  639. package/components/previews/motion/card.preview.tsx +14 -0
  640. package/components/previews/motion/carousel.preview.tsx +17 -0
  641. package/components/previews/motion/cascader.preview.tsx +54 -0
  642. package/components/previews/motion/chart.preview.tsx +20 -0
  643. package/components/previews/motion/chip-group.preview.tsx +20 -0
  644. package/components/previews/motion/combobox.preview.tsx +1 -1
  645. package/components/previews/motion/command-menu.preview.tsx +16 -0
  646. package/components/previews/motion/confirm-morph.preview.tsx +14 -0
  647. package/components/previews/motion/cookie-consent.preview.tsx +14 -0
  648. package/components/previews/motion/countdown.preview.tsx +15 -0
  649. package/components/previews/motion/date-picker.preview.tsx +14 -0
  650. package/components/previews/motion/delete-with-smoky-dissolve.preview.tsx +14 -0
  651. package/components/previews/motion/dialog.preview.tsx +24 -0
  652. package/components/previews/motion/drag-drop-with-physics.preview.tsx +15 -0
  653. package/components/previews/motion/dropdown-menu-morph.preview.tsx +11 -0
  654. package/components/previews/motion/dropdown-menu.preview.tsx +19 -0
  655. package/components/previews/motion/elastic-slider.preview.tsx +14 -0
  656. package/components/previews/motion/empty-state.preview.tsx +14 -0
  657. package/components/previews/motion/expandable-card.preview.tsx +14 -0
  658. package/components/previews/motion/expandable-text.preview.tsx +14 -0
  659. package/components/previews/motion/expanding-button-group.preview.tsx +18 -0
  660. package/components/previews/motion/expanding-search.preview.tsx +17 -0
  661. package/components/previews/motion/file-dropzone.preview.tsx +14 -0
  662. package/components/previews/motion/filter-toolbar.preview.tsx +15 -0
  663. package/components/previews/motion/floating-button-group.preview.tsx +14 -0
  664. package/components/previews/motion/gauge.preview.tsx +14 -0
  665. package/components/previews/motion/hamburger-menu.preview.tsx +15 -0
  666. package/components/previews/motion/hold-to-confirm.preview.tsx +16 -0
  667. package/components/previews/motion/icon-morph.preview.tsx +14 -0
  668. package/components/previews/motion/image-compare.preview.tsx +17 -0
  669. package/components/previews/motion/in-view-title.preview.tsx +14 -0
  670. package/components/previews/motion/inline-edit.preview.tsx +15 -0
  671. package/components/previews/motion/input-group.preview.tsx +14 -0
  672. package/components/previews/motion/item.preview.tsx +14 -0
  673. package/components/previews/motion/label.preview.tsx +14 -0
  674. package/components/previews/motion/liquid-ripple-button.preview.tsx +14 -0
  675. package/components/previews/motion/mac-os-folder-cards.preview.tsx +14 -0
  676. package/components/previews/motion/magnetic-button.preview.tsx +14 -0
  677. package/components/previews/motion/mention-input.preview.tsx +14 -0
  678. package/components/previews/motion/menubar.preview.tsx +14 -0
  679. package/components/previews/motion/money-card.preview.tsx +14 -0
  680. package/components/previews/motion/money-input.preview.tsx +14 -0
  681. package/components/previews/motion/morph-select.preview.tsx +14 -0
  682. package/components/previews/motion/morphing-button.preview.tsx +14 -0
  683. package/components/previews/motion/morphing-mega-menu.preview.tsx +14 -0
  684. package/components/previews/motion/navigation-menu.preview.tsx +14 -0
  685. package/components/previews/motion/neon-edge-button.preview.tsx +14 -0
  686. package/components/previews/motion/onboarding-checklist.preview.tsx +17 -0
  687. package/components/previews/motion/organic-shimmer.preview.tsx +18 -0
  688. package/components/previews/motion/page-transition.preview.tsx +35 -0
  689. package/components/previews/motion/pagination.preview.tsx +20 -0
  690. package/components/previews/motion/password-field.preview.tsx +14 -0
  691. package/components/previews/motion/password-strength.preview.tsx +14 -0
  692. package/components/previews/motion/peek-card.preview.tsx +14 -0
  693. package/components/previews/motion/popover.preview.tsx +1 -1
  694. package/components/previews/motion/profile-card.preview.tsx +14 -0
  695. package/components/previews/motion/progress.preview.tsx +14 -0
  696. package/components/previews/motion/radio-cards.preview.tsx +14 -0
  697. package/components/previews/motion/radio-group.preview.tsx +20 -0
  698. package/components/previews/motion/rainbow-button.preview.tsx +14 -0
  699. package/components/previews/motion/raised-button.preview.tsx +14 -0
  700. package/components/previews/motion/range-histogram-slider.preview.tsx +14 -0
  701. package/components/previews/motion/reactions.preview.tsx +15 -0
  702. package/components/previews/motion/resizable-panels.preview.tsx +15 -0
  703. package/components/previews/motion/resizable.preview.tsx +19 -0
  704. package/components/previews/motion/rich-text-editor.preview.tsx +14 -0
  705. package/components/previews/motion/ridgeline.preview.tsx +17 -0
  706. package/components/previews/motion/scroll-area.preview.tsx +14 -0
  707. package/components/previews/motion/scrub-input.preview.tsx +14 -0
  708. package/components/previews/motion/search-field.preview.tsx +15 -0
  709. package/components/previews/motion/segmented-control.preview.tsx +23 -0
  710. package/components/previews/motion/select.preview.tsx +1 -1
  711. package/components/previews/motion/separator.preview.tsx +14 -0
  712. package/components/previews/motion/shortcut-recorder.preview.tsx +14 -0
  713. package/components/previews/motion/signature-pad.preview.tsx +14 -0
  714. package/components/previews/motion/skeleton.preview.tsx +14 -0
  715. package/components/previews/motion/slider.preview.tsx +14 -0
  716. package/components/previews/motion/sonner.preview.tsx +14 -0
  717. package/components/previews/motion/sparkline.preview.tsx +14 -0
  718. package/components/previews/motion/spinner.preview.tsx +14 -0
  719. package/components/previews/motion/split-button.preview.tsx +14 -0
  720. package/components/previews/motion/stepper.preview.tsx +39 -0
  721. package/components/previews/motion/story-card.preview.tsx +14 -0
  722. package/components/previews/motion/streamgraph.preview.tsx +18 -0
  723. package/components/previews/motion/swipe-actions.preview.tsx +18 -0
  724. package/components/previews/motion/tag-input.preview.tsx +14 -0
  725. package/components/previews/motion/text-animation.preview.tsx +2 -2
  726. package/components/previews/motion/text-reveal.preview.tsx +14 -0
  727. package/components/previews/motion/text-shimmer.preview.tsx +14 -0
  728. package/components/previews/motion/textarea.preview.tsx +14 -0
  729. package/components/previews/motion/theme-switch-eclipse.preview.tsx +15 -0
  730. package/components/previews/motion/theme-switch-rise.preview.tsx +15 -0
  731. package/components/previews/motion/theme-switch-split.preview.tsx +15 -0
  732. package/components/previews/motion/theme-switch.preview.tsx +15 -0
  733. package/components/previews/motion/tilt-card.preview.tsx +2 -2
  734. package/components/previews/motion/time-picker.preview.tsx +14 -0
  735. package/components/previews/motion/toast.preview.tsx +14 -0
  736. package/components/previews/motion/treemap.preview.tsx +17 -0
  737. package/components/previews/motion/undo-toast.preview.tsx +14 -0
  738. package/components/previews/motion/usage-meter.preview.tsx +19 -0
  739. package/components/profile/contact-profile-card.tsx +8 -8
  740. package/components/ui/button.tsx +59 -0
  741. package/components/ui/dialog.tsx +149 -0
  742. package/components/ui/input.tsx +20 -0
  743. package/components/ui/label.tsx +1 -0
  744. package/components/ui/loaders-gooey-blobs.tsx +2 -0
  745. package/components/ui/raised-button.tsx +2 -0
  746. package/components/ui/separator.tsx +1 -0
  747. package/components/ui/textarea.tsx +17 -0
  748. package/lib/arc-provider.tsx +101 -0
  749. package/lib/colorUtils.ts +34 -0
  750. package/lib/effects/shared/webgl-surface.jsx +47 -0
  751. package/lib/foundation.css +192 -0
  752. package/lib/media.ts +90 -0
  753. package/lib/motion-tokens.ts +5 -0
  754. package/lib/particle-delete.ts +500 -0
  755. package/lib/portal.tsx +23 -0
  756. package/lib/spring-tokens.ts +25 -0
  757. package/lib/theme/useTheme.tsx +157 -0
  758. package/lib/transition-tokens.ts +75 -0
  759. package/lib/use-copy-feedback.ts +40 -0
  760. package/lib/use-today.ts +8 -0
  761. package/lib/utils.ts +10 -0
  762. package/package.json +32 -4
  763. package/references/agents/ai-agent-activity.md +45 -0
  764. package/references/agents/ai-response.md +45 -0
  765. package/references/agents/ai-status.md +45 -0
  766. package/references/agents/chat-thread.md +45 -0
  767. package/references/agents/comment-thread.md +45 -0
  768. package/references/agents/json-viewer.md +45 -0
  769. package/references/agents/matrix-orb.md +43 -0
  770. package/references/agents/text-stream.md +44 -0
  771. package/references/agents/thinking-orb.md +43 -0
  772. package/references/agents/web-search.md +44 -0
  773. package/references/blocks/active-sessions.md +45 -0
  774. package/references/blocks/activity-feed.md +45 -0
  775. package/references/blocks/activity-heatmap.md +44 -0
  776. package/references/blocks/advanced-data-table.md +45 -0
  777. package/references/blocks/analytics-dashboard.md +43 -0
  778. package/references/blocks/art-gallery.md +44 -0
  779. package/references/blocks/bar-chart.md +44 -0
  780. package/references/blocks/blog-grid.md +45 -0
  781. package/references/blocks/brush-chart.md +44 -0
  782. package/references/blocks/changelog-feed.md +47 -0
  783. package/references/blocks/chat.md +45 -0
  784. package/references/blocks/comparison-table.md +45 -0
  785. package/references/blocks/cta-section.md +45 -0
  786. package/references/blocks/dashboard-shell.md +50 -0
  787. package/references/blocks/empty-states.md +44 -0
  788. package/references/blocks/family-drawer.md +46 -0
  789. package/references/blocks/faq.md +44 -0
  790. package/references/blocks/footer.md +43 -0
  791. package/references/blocks/form.md +45 -0
  792. package/references/blocks/hero-section.md +43 -0
  793. package/references/blocks/hook-sidebar.md +45 -0
  794. package/references/blocks/line-chart.md +44 -0
  795. package/references/blocks/login-centered.md +45 -0
  796. package/references/blocks/logo-marquee.md +44 -0
  797. package/references/blocks/newsletter-signup.md +46 -0
  798. package/references/blocks/notification-center.md +46 -0
  799. package/references/blocks/page-header.md +47 -0
  800. package/references/blocks/plan-comparison.md +45 -0
  801. package/references/blocks/pricing.md +45 -0
  802. package/references/blocks/product-tour.md +46 -0
  803. package/references/blocks/proximity-sidebar.md +44 -0
  804. package/references/blocks/rail-toc.md +44 -0
  805. package/references/blocks/scroll-progress.md +44 -0
  806. package/references/blocks/sidebar-stackbits.md +45 -0
  807. package/references/blocks/sign-in.md +45 -0
  808. package/references/blocks/site-header.md +46 -0
  809. package/references/blocks/slope-chart.md +44 -0
  810. package/references/blocks/sortable-data-table.md +45 -0
  811. package/references/blocks/stats-band.md +44 -0
  812. package/references/blocks/status-bars.md +45 -0
  813. package/references/blocks/step-player.md +45 -0
  814. package/references/blocks/task-list.md +44 -0
  815. package/references/blocks/waffle-chart.md +44 -0
  816. package/references/component-preview-contract.md +42 -0
  817. package/references/craft/airport-matrix-clock.md +44 -0
  818. package/references/craft/animated-counter.md +44 -0
  819. package/references/craft/batch-gesture-tray.md +45 -0
  820. package/references/craft/car-smoke-page-transition.md +44 -0
  821. package/references/craft/circular-orbit.md +44 -0
  822. package/references/craft/click-spark.md +45 -0
  823. package/references/craft/code-snippet-deck.md +45 -0
  824. package/references/craft/command.md +45 -0
  825. package/references/craft/cursor-follower.md +44 -0
  826. package/references/craft/delete-button.md +44 -0
  827. package/references/craft/density-lens.md +44 -0
  828. package/references/craft/dependency-trace.md +44 -0
  829. package/references/craft/depth-corridor.md +45 -0
  830. package/references/craft/discover-button.md +44 -0
  831. package/references/craft/drag-to-confirm.md +45 -0
  832. package/references/craft/draggable-marquee.md +45 -0
  833. package/references/craft/duration-picker.md +48 -0
  834. package/references/craft/emoji-reaction.md +47 -0
  835. package/references/craft/empty.md +44 -0
  836. package/references/craft/evil-eye.md +44 -0
  837. package/references/craft/expandable-data-row.md +45 -0
  838. package/references/craft/field.md +44 -0
  839. package/references/craft/file-input.md +46 -0
  840. package/references/craft/flip-text.md +43 -0
  841. package/references/craft/fluid-orb.md +43 -0
  842. package/references/craft/focus-mode.md +45 -0
  843. package/references/craft/folder-component.md +44 -0
  844. package/references/craft/github-activity.md +45 -0
  845. package/references/craft/glitch-text.md +44 -0
  846. package/references/craft/glyph-matrix.md +43 -0
  847. package/references/craft/golden-gate-404.md +45 -0
  848. package/references/craft/gooey-nav.md +45 -0
  849. package/references/craft/gravity-letters.md +43 -0
  850. package/references/craft/gravity-particle-burst.md +44 -0
  851. package/references/craft/grid-reveal.md +44 -0
  852. package/references/craft/hover-img.md +44 -0
  853. package/references/craft/input-otp.md +45 -0
  854. package/references/craft/interactive-area-chart.md +44 -0
  855. package/references/craft/interactive-timeline.md +45 -0
  856. package/references/craft/intro-loader.md +45 -0
  857. package/references/craft/ios-search-bar.md +45 -0
  858. package/references/craft/liquid-metal.md +45 -0
  859. package/references/craft/liquid-toggle.md +44 -0
  860. package/references/craft/loaders-gooey-blobs.md +44 -0
  861. package/references/craft/lock-input.md +44 -0
  862. package/references/craft/login.md +45 -0
  863. package/references/craft/meteors.md +43 -0
  864. package/references/craft/metric-hud.md +45 -0
  865. package/references/craft/morphing-blob.md +44 -0
  866. package/references/craft/morphing-dialog.md +45 -0
  867. package/references/craft/morphing-icon.md +44 -0
  868. package/references/craft/morphing-shape-loader.md +44 -0
  869. package/references/craft/nimbu-mirchi.md +44 -0
  870. package/references/craft/notification-bell.md +45 -0
  871. package/references/craft/orbital-loading-ring.md +43 -0
  872. package/references/craft/origin-dropdown.md +45 -0
  873. package/references/craft/particle-delete.md +44 -0
  874. package/references/craft/payment-receipt-printer.md +45 -0
  875. package/references/craft/payment-status.md +45 -0
  876. package/references/craft/recovery-ledger.md +45 -0
  877. package/references/craft/rocket-party-popper.md +45 -0
  878. package/references/craft/scroll-progress-nav.md +45 -0
  879. package/references/craft/scrollvelocitytext.md +43 -0
  880. package/references/craft/selection-basket.md +45 -0
  881. package/references/craft/sheet.md +46 -0
  882. package/references/craft/shooting-stars.md +44 -0
  883. package/references/craft/sidebar.md +45 -0
  884. package/references/craft/sign-up.md +45 -0
  885. package/references/craft/skeumorphic-music-card.md +45 -0
  886. package/references/craft/slide-pagination.md +45 -0
  887. package/references/craft/slot-text.md +44 -0
  888. package/references/craft/smart-comparison.md +45 -0
  889. package/references/craft/smooth-scroll.md +44 -0
  890. package/references/craft/speed-warp.md +43 -0
  891. package/references/craft/split-showcase.md +44 -0
  892. package/references/craft/spotlight-search.md +45 -0
  893. package/references/craft/stack-unfold-panel.md +45 -0
  894. package/references/craft/sticky-pages.md +43 -0
  895. package/references/craft/text-scramble-decoder.md +44 -0
  896. package/references/craft/toggle.md +45 -0
  897. package/references/craft/torque-dial.md +44 -0
  898. package/references/craft/v-prism.md +46 -0
  899. package/references/craft/voice-note.md +44 -0
  900. package/references/guides/better-accessibility.md +104 -0
  901. package/references/guides/better-colors.md +88 -0
  902. package/references/guides/better-interface.md +187 -0
  903. package/references/guides/better-layout.md +79 -0
  904. package/references/guides/better-typography.md +136 -0
  905. package/references/guides/better-ui.md +113 -0
  906. package/references/guides/better-writing.md +115 -0
  907. package/references/guides/dark-neutral-design-system.md +776 -0
  908. package/references/guides/fluid-interaction-conventions.md +30 -0
  909. package/references/guides/interface-review.md +142 -0
  910. package/references/guides/spring-motion-system.md +232 -0
  911. package/references/motion/accordion.md +46 -0
  912. package/references/motion/action-button.md +45 -0
  913. package/references/motion/alert.md +45 -0
  914. package/references/motion/avatar.md +44 -0
  915. package/references/motion/badge.md +44 -0
  916. package/references/motion/billing-toggle.md +44 -0
  917. package/references/motion/book-call-button.md +44 -0
  918. package/references/motion/branching-submenu.md +45 -0
  919. package/references/motion/button-group.md +46 -0
  920. package/references/motion/calendar.md +45 -0
  921. package/references/motion/card-stack.md +45 -0
  922. package/references/motion/card.md +46 -0
  923. package/references/motion/carousel.md +45 -0
  924. package/references/motion/chart.md +52 -0
  925. package/references/motion/chip-group.md +44 -0
  926. package/references/motion/command-menu.md +45 -0
  927. package/references/motion/confirm-morph.md +45 -0
  928. package/references/motion/cookie-consent.md +45 -0
  929. package/references/motion/countdown.md +44 -0
  930. package/references/motion/date-picker.md +45 -0
  931. package/references/motion/dialog.md +46 -0
  932. package/references/motion/dropdown-menu.md +46 -0
  933. package/references/motion/elastic-slider.md +44 -0
  934. package/references/motion/empty-state.md +45 -0
  935. package/references/motion/expandable-card.md +45 -0
  936. package/references/motion/expandable-text.md +45 -0
  937. package/references/motion/expanding-button-group.md +44 -0
  938. package/references/motion/expanding-search.md +46 -0
  939. package/references/motion/file-dropzone.md +45 -0
  940. package/references/motion/filter-toolbar.md +45 -0
  941. package/references/motion/floating-button-group.md +45 -0
  942. package/references/motion/gauge.md +44 -0
  943. package/references/motion/hamburger-menu.md +44 -0
  944. package/references/motion/hold-to-confirm.md +45 -0
  945. package/references/motion/icon-morph.md +44 -0
  946. package/references/motion/image-compare.md +45 -0
  947. package/references/motion/in-view-title.md +44 -0
  948. package/references/motion/inline-edit.md +45 -0
  949. package/references/motion/input-group.md +44 -0
  950. package/references/motion/item.md +45 -0
  951. package/references/motion/label.md +44 -0
  952. package/references/motion/liquid-ripple-button.md +45 -0
  953. package/references/motion/mac-os-folder-cards.md +45 -0
  954. package/references/motion/magnetic-button.md +44 -0
  955. package/references/motion/mention-input.md +45 -0
  956. package/references/motion/menubar.md +45 -0
  957. package/references/motion/money-card.md +46 -0
  958. package/references/motion/money-input.md +45 -0
  959. package/references/motion/morph-select.md +45 -0
  960. package/references/motion/morphing-button.md +45 -0
  961. package/references/motion/morphing-mega-menu.md +44 -0
  962. package/references/motion/navigation-menu.md +46 -0
  963. package/references/motion/neon-edge-button.md +44 -0
  964. package/references/motion/onboarding-checklist.md +45 -0
  965. package/references/motion/password-field.md +44 -0
  966. package/references/motion/password-strength.md +44 -0
  967. package/references/motion/peek-card.md +45 -0
  968. package/references/motion/profile-card.md +44 -0
  969. package/references/motion/progress.md +45 -0
  970. package/references/motion/radio-cards.md +44 -0
  971. package/references/motion/radio-group.md +44 -0
  972. package/references/motion/rainbow-button.md +43 -0
  973. package/references/motion/raised-button.md +45 -0
  974. package/references/motion/range-histogram-slider.md +44 -0
  975. package/references/motion/reactions.md +46 -0
  976. package/references/motion/resizable-panels.md +45 -0
  977. package/references/motion/resizable.md +45 -0
  978. package/references/motion/rich-text-editor.md +45 -0
  979. package/references/motion/ridgeline.md +44 -0
  980. package/references/motion/scroll-area.md +43 -0
  981. package/references/motion/scrub-input.md +45 -0
  982. package/references/motion/search-field.md +45 -0
  983. package/references/motion/separator.md +44 -0
  984. package/references/motion/shortcut-recorder.md +45 -0
  985. package/references/motion/signature-pad.md +45 -0
  986. package/references/motion/skeleton.md +44 -0
  987. package/references/motion/slider.md +44 -0
  988. package/references/motion/sonner.md +46 -0
  989. package/references/motion/sparkline.md +44 -0
  990. package/references/motion/spinner.md +44 -0
  991. package/references/motion/split-button.md +46 -0
  992. package/references/motion/story-card.md +44 -0
  993. package/references/motion/streamgraph.md +44 -0
  994. package/references/motion/swipe-actions.md +46 -0
  995. package/references/motion/tag-input.md +45 -0
  996. package/references/motion/text-reveal.md +43 -0
  997. package/references/motion/text-shimmer.md +44 -0
  998. package/references/motion/textarea.md +44 -0
  999. package/references/motion/theme-switch-eclipse.md +45 -0
  1000. package/references/motion/theme-switch-rise.md +45 -0
  1001. package/references/motion/theme-switch-split.md +45 -0
  1002. package/references/motion/theme-switch.md +45 -0
  1003. package/references/motion/time-picker.md +45 -0
  1004. package/references/motion/toast.md +45 -0
  1005. package/references/motion/treemap.md +44 -0
  1006. package/references/motion/undo-toast.md +45 -0
  1007. package/references/motion/usage-meter.md +45 -0
  1008. package/scripts/build_docs.py +209 -205
  1009. package/scripts/verify_skill.py +4 -4
  1010. package/test/test_installer.mjs +31 -1
  1011. package/test/test_preview_contracts.mjs +124 -0
@@ -0,0 +1,776 @@
1
+ # motion-ui Design System Specification
2
+
3
+ > **Source of Truth:** Every value in this document was extracted directly from the actual motion-ui codebase.
4
+ > No generic Tailwind defaults, no guesses, and no invented colors.
5
+ > File locations and lines are cited for every token and pattern.
6
+
7
+ ---
8
+
9
+ ## Table of Contents
10
+
11
+ 1. [Exact Color System](#1-exact-color-system)
12
+ 2. [Exact Typography](#2-exact-typography)
13
+ 3. [Spacing System](#3-spacing-system)
14
+ 4. [Border Radius System](#4-border-radius-system)
15
+ 5. [Border System](#5-border-system)
16
+ 6. [Shadow System](#6-shadow-system)
17
+ 7. [Glow / Effect System](#7-glow--effect-system)
18
+ 8. [Animation System](#8-animation-system)
19
+ 9. [Hover States](#9-hover-states)
20
+ 10. [Focus States](#10-focus-states)
21
+ 11. [Responsive System](#11-responsive-system)
22
+ 12. [Component Visual Language](#12-component-visual-language)
23
+ 13. [Icon System](#13-icon-system)
24
+ 14. [Component States](#14-component-states)
25
+ 15. [Design Principles](#15-design-principles)
26
+ 16. [Machine-Readable Token Table](#16-machine-readable-token-table)
27
+ 17. [Source Locations](#17-source-locations)
28
+
29
+ ---
30
+
31
+ # 1. EXACT COLOR SYSTEM
32
+
33
+ motion-ui uses a refined **dark neutral palette** matching the Claude interface aesthetic. Grayscale and dark charcoal surface steps establish surface elevation, visual hierarchy, and calm contrast without deep pitch blacks.
34
+
35
+ ### 1.1 Backgrounds & Surfaces
36
+
37
+ #### Main Background (Page Canvas)
38
+ - **Color name:** `bg` / Main Canvas
39
+ - **Exact HEX:** `#151515`
40
+ - **RGB:** `rgb(21, 21, 21)`
41
+ - **HSL:** `hsl(0, 0%, 8.2%)`
42
+ - **CSS variable:** `var(--bg)`
43
+ - **Tailwind class:** `bg-background` or `bg-[#151515]`
44
+ - **Where it is used:** `body`, `html`, main layout wrapper, App root, section canvas backgrounds, fullscreen preview stage, footer
45
+ - **Example component:** `src/App.tsx`, `src/styles/tokens.css` (line 3), `src/components/layout/Navbar.tsx` (`bg-[#151515]/90`), `src/components/layout/Footer.tsx`
46
+ - **Source:** `src/styles/tokens.css` (line 3), `tailwind.config.js` (line 11)
47
+
48
+ #### Surface Background (Default Cards & Containers)
49
+ - **Color name:** `surface` / Component Surface
50
+ - **Exact HEX:** `#202020`
51
+ - **RGB:** `rgb(32, 32, 32)`
52
+ - **HSL:** `hsl(0, 0%, 12.5%)`
53
+ - **CSS variable:** `var(--surface)`
54
+ - **Tailwind class:** `bg-surface` or `bg-[#202020]`
55
+ - **Where it is used:** Component preview cards, catalog cards, showcase boxes, modal surface, CommandMenu container, SmoothAccordion, Philosophy cards
56
+ - **Example component:** `src/components/common/ComponentCard.tsx`, `src/components/ui/SpotlightCard.tsx`, `src/components/docs/ComponentDetailPage.tsx`
57
+ - **Source:** `src/styles/tokens.css` (line 4), `tailwind.config.js` (line 13)
58
+
59
+ #### Surface Raised (Elevated Elements, Controls & Inputs)
60
+ - **Color name:** `surface-raised` / Elevated Surface
61
+ - **Exact HEX:** `#242424`
62
+ - **RGB:** `rgb(36, 36, 36)`
63
+ - **HSL:** `hsl(0, 0%, 14.1%)`
64
+ - **CSS variable:** `var(--surface-raised)`
65
+ - **Tailwind class:** `bg-surface-raised` or `bg-[#242424]`
66
+ - **Where it is used:** Secondary buttons, raised control states, input fields, active tabs, floating docks, badges, table headers, toolbar containers
67
+ - **Example component:** `src/components/ui/BatchGestureTray.tsx`, `src/components/ui/NotificationBell.tsx`, `src/components/ui/ExpandableDataRow.tsx`
68
+ - **Source:** `src/styles/tokens.css` (line 6), `tailwind.config.js` (line 15)
69
+
70
+ #### Surface Hover (Interactive Hover Target)
71
+ - **Color name:** `surface-hover`
72
+ - **Exact HEX:** `#262626` / `#2C2C2C`
73
+ - **RGB:** `rgb(38, 38, 38)`
74
+ - **HSL:** `hsl(0, 0%, 14.9%)`
75
+ - **CSS variable:** `var(--surface-hover)`
76
+ - **Tailwind class:** `bg-surface-hover` or `hover:bg-[#262626]`
77
+ - **Where it is used:** Hover background on buttons, accordion headers, dropdown rows, ghost buttons, command list rows
78
+ - **Source:** `src/styles/tokens.css` (line 5), `tailwind.config.js` (line 14)
79
+
80
+ #### Code Block Background
81
+ - **Color name:** Code Body Background
82
+ - **Exact HEX:** `#151515` (inner pre) / `#202020` (wrapper deck) / `#242424` (titlebar)
83
+ - **Tailwind class:** `bg-[#151515]`, `bg-[#202020]`, `bg-[#242424]`
84
+ - **Where it is used:** `<pre>` and `<code>` blocks in documentation and CodeSnippetDeck
85
+ - **Example component:** `src/components/ui/CodeSnippetDeck.tsx`
86
+
87
+ ---
88
+
89
+ ### 1.2 Foreground / Text Colors
90
+
91
+ #### Primary Text
92
+ - **Color name:** `text-primary`
93
+ - **Exact HEX:** `#F5F5F5`
94
+ - **RGB:** `rgb(245, 245, 245)`
95
+ - **HSL:** `hsl(0, 0%, 96.1%)`
96
+ - **CSS variable:** `var(--text-primary)`
97
+ - **Tailwind class:** `text-text-primary` or `text-[#F5F5F5]`
98
+ - **Where it is used:** `h1`, `h2`, `h3`, `h4`, `h5`, `h6`, primary headings, modal titles, card titles, active indicators
99
+ - **Source:** `src/styles/tokens.css` (line 24), `tailwind.config.js` (line 23)
100
+
101
+ #### Secondary Text
102
+ - **Color name:** `text-secondary`
103
+ - **Exact HEX:** `#A3A3A3`
104
+ - **RGB:** `rgb(163, 163, 163)`
105
+ - **HSL:** `hsl(0, 0%, 63.9%)`
106
+ - **CSS variable:** `var(--text-secondary)`
107
+ - **Tailwind class:** `text-text-secondary` or `text-[#A3A3A3]`
108
+ - **Where it is used:** Subtitles, body descriptions, key labels, accordion descriptions, ghost button default
109
+ - **Source:** `src/styles/tokens.css` (line 25), `tailwind.config.js` (line 24)
110
+
111
+ #### Muted Text
112
+ - **Color name:** `text-muted`
113
+ - **Exact HEX:** `#737373`
114
+ - **RGB:** `rgb(115, 115, 115)`
115
+ - **HSL:** `hsl(0, 0%, 45.1%)`
116
+ - **CSS variable:** `var(--text-muted)`
117
+ - **Tailwind class:** `text-text-muted` or `text-[#737373]`
118
+ - **Where it is used:** Eyebrow uppercase tags, inactive tab text, input placeholders, notification timestamps, footer metadata
119
+ - **Source:** `src/styles/tokens.css` (line 26), `tailwind.config.js` (line 25)
120
+
121
+ #### Subtle Icon / Text
122
+ - **Color name:** `text-subtle`
123
+ - **Exact HEX:** `#8A8A8A`
124
+ - **RGB:** `rgb(138, 138, 138)`
125
+ - **HSL:** `hsl(0, 0%, 54.1%)`
126
+ - **CSS variable:** `var(--text-subtle)`
127
+ - **Tailwind class:** `text-text-subtle` or `text-[#8A8A8A]`
128
+ - **Where it is used:** Default icons, chevron indicators, search icons, tooltips
129
+ - **Source:** `src/styles/tokens.css` (line 27), `tailwind.config.js` (line 26)
130
+
131
+ #### Pure White
132
+ - **Color name:** White
133
+ - **Exact HEX:** `#FFFFFF`
134
+ - **Tailwind class:** `text-white`
135
+ - **Where it is used:** High-contrast active tags, hover states, logo emphasis
136
+
137
+ ---
138
+
139
+ ### 1.3 Borders
140
+
141
+ #### Default Border (Token)
142
+ - **Color name:** `border`
143
+ - **Exact HEX:** `#363636`
144
+ - **RGB:** `rgb(54, 54, 54)`
145
+ - **HSL:** `hsl(0, 0%, 21.2%)`
146
+ - **CSS variable:** `var(--border)`
147
+ - **Tailwind class:** `border-border` or `border-[#363636]`
148
+ - **Where it is used:** All component cards, panels, modal borders, code blocks, dividers, buttons
149
+ - **Source:** `src/styles/tokens.css` (line 9), `tailwind.config.js` (line 18)
150
+
151
+ #### Border Hover (Token)
152
+ - **Color name:** `border-hover`
153
+ - **Exact HEX:** `#484848` / `#4A4A4A`
154
+ - **RGB:** `rgb(72, 72, 72)`
155
+ - **HSL:** `hsl(0, 0%, 28.2%)`
156
+ - **CSS variable:** `var(--border-hover)`
157
+ - **Tailwind class:** `border-border-hover` or `hover:border-[#484848]` / `hover:border-[#4A4A4A]`
158
+ - **Where it is used:** Interactive card hover states, focused inputs, active pill border
159
+ - **Source:** `src/styles/tokens.css` (line 10), `tailwind.config.js` (line 19)
160
+
161
+ #### Border Subtle (Token)
162
+ - **Color name:** `border-subtle`
163
+ - **Exact HEX:** `#2C2C2C`
164
+ - **CSS variable:** `var(--border-subtle)`
165
+ - **Tailwind class:** `border-border-subtle` or `border-[#2C2C2C]`
166
+ - **Where it is used:** Inner card separators, subtle grid lines
167
+ - **Source:** `src/styles/tokens.css` (line 11), `tailwind.config.js` (line 20)
168
+
169
+ ---
170
+
171
+ ### 1.4 Accent & Indicators
172
+
173
+ #### Primary Accent (Monochrome Light Neutral)
174
+ - **Color name:** `accent`
175
+ - **Exact HEX:** `#F5F5F5`
176
+ - **CSS variable:** `var(--accent)`
177
+ - **Tailwind class:** `bg-accent` or `text-accent`
178
+ - **Where it is used:** Primary buttons, active tabs, checked state pills
179
+ - **Source:** `src/styles/tokens.css` (line 30), `tailwind.config.js` (line 28)
180
+
181
+ #### Accent Subtle & Glow
182
+ - **`accent-subtle`:** `rgba(255, 255, 255, 0.06)`
183
+ - **`accent-glow`:** `rgba(255, 255, 255, 0.08)`
184
+ - **`accent-ring`:** `rgba(255, 255, 255, 0.2)`
185
+
186
+ #### Active Indicator Blue (Telemetry & Highlights)
187
+ - **Exact HEX:** `#3B82F6`
188
+ - **CSS variable:** `var(--indicator-active)`
189
+ - **Tailwind class:** `text-accent-blue` or `bg-[#3B82F6]`
190
+ - **Where it is used:** Optional telemetry indicators and live charts
191
+ - **Source:** `src/styles/tokens.css` (line 34), `tailwind.config.js` (line 32)
192
+ - **CRITICAL NOTE:** This is the *only* chromatic hue used in motion-ui, reserved strictly for accessibility focus states and subtle sensor illumination.
193
+ - **Source:** `src/styles/index.css` (line 79), `src/components/ui/SpotlightCard.tsx` (line 14), `index.html` (line 37)
194
+
195
+ ---
196
+
197
+ ### 1.5 Gradients
198
+
199
+ #### Hero Atmospheric Gradient
200
+ - **Colors:** `#050505/60` -> `transparent` -> `#050505`
201
+ - **Direction:** `to bottom` (`bg-gradient-to-b`)
202
+ - **Usage:** Smooth fade overlay on top of canvas DotField in Hero
203
+ - **Source:** `src/components/sections/HeroSection.tsx` (line 101)
204
+
205
+ #### Hero Vignette Gradient
206
+ - **Colors:** `transparent 30%` -> `#050505 90%`
207
+ - **Type:** Radial ellipse (`radial-gradient(ellipse at center, transparent 30%, #050505 90%)`)
208
+ - **Usage:** Screen-edge dark fade around interactive background
209
+ - **Source:** `src/components/sections/HeroSection.tsx` (line 102)
210
+
211
+ #### Ambient Neutral Glow (Hero top)
212
+ - **Colors:** `white/15` -> `transparent`
213
+ - **Direction:** `to bottom` (`bg-gradient-to-b`)
214
+ - **Blur & Opacity:** `blur-[130px]`, `opacity-15`
215
+ - **Size & Pos:** `w-[850px] h-[400px] top-0 left-1/2 -translate-x-1/2`
216
+ - **Source:** `src/components/sections/HeroSection.tsx` (line 106–108)
217
+
218
+ #### Ambient Neutral Glow (Final CTA bottom)
219
+ - **Colors:** `white/15` -> `transparent`
220
+ - **Direction:** `to top` (`bg-gradient-to-t`)
221
+ - **Blur & Opacity:** `blur-[80px]`, `opacity-10`
222
+ - **Size & Pos:** `w-[500px] h-[200px] bottom-0 left-1/2 -translate-x-1/2`
223
+ - **Source:** `src/components/sections/FinalCta.tsx` (line 16)
224
+
225
+ #### MagneticButton Shimmer / Glow Overlay
226
+ - **Colors:** `from-transparent via-white/10 to-transparent`
227
+ - **Direction:** `to right` (`bg-gradient-to-r`)
228
+ - **Blur & Opacity:** `blur-sm`, `opacity-40`
229
+ - **Usage:** Animated hover sheen inside `MagneticButton`
230
+ - **Source:** `src/components/ui/MagneticButton.tsx` (line 86)
231
+
232
+ #### Dynamic Cursor Spotlight Gradient (SpotlightCard)
233
+ - **Colors:** `rgba(56, 189, 248, 0.08)` -> `transparent 80%`
234
+ - **Type / Size:** Radial circle, dynamic mouse coordinates `${spotlightSize}px circle at ${mouseX}px ${mouseY}px`
235
+ - **Source:** `src/components/ui/SpotlightCard.tsx` (line 30)
236
+
237
+ #### Spotlight Dynamic Border Gradient
238
+ - **Colors:** `rgba(255, 255, 255, 0.18)` -> `transparent 80%`
239
+ - **Type / Size:** Radial circle, dynamic mouse coordinates `220px circle at ${mouseX}px ${mouseY}px`
240
+ - **Source:** `src/components/ui/SpotlightCard.tsx` (line 31)
241
+
242
+ #### RevealCard Glare Gradient
243
+ - **Colors:** `rgba(255, 255, 255, 0.4)` -> `transparent 60%`
244
+ - **Type / Size:** Radial circle at `${glareX}% ${glareY}%`
245
+ - **Source:** `src/components/ui/RevealCard.tsx` (line 26)
246
+
247
+ ---
248
+
249
+ # 2. EXACT TYPOGRAPHY
250
+
251
+ ### 2.1 Font Families
252
+
253
+ #### Primary Sans / Heading / Body Font
254
+ - **Family definition:** `'Geist', 'Geist Sans', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif`
255
+ - **CSS variable:** `var(--font-sans)`, `var(--font-heading)`, `var(--font-body)`
256
+ - **Tailwind class:** `font-sans`, `font-heading`, `font-body`
257
+ - **Google Fonts source:** Loaded in `index.html`: `Geist:wght@400;500;600;700;800` & `Inter:wght@400;500;600;700`
258
+ - **Source:** `src/styles/tokens.css` (lines 14–16), `tailwind.config.js` (lines 34–36), `index.html` (line 35)
259
+
260
+ #### Monospace Font
261
+ - **Family definition:** `'JetBrains Mono', 'Fira Code', monospace`
262
+ - **CSS variable:** `var(--font-mono)`
263
+ - **Tailwind class:** `font-mono`
264
+ - **Google Fonts source:** Loaded in `index.html`: `JetBrains+Mono:wght@400;500;600`
265
+ - **Where used:** Code snippets, terminal commands, badge tags, kbd shortcuts, step numbers, timestamps, catalog tags
266
+ - **Source:** `src/styles/tokens.css` (line 17), `tailwind.config.js` (line 38), `index.html` (line 35)
267
+
268
+ ---
269
+
270
+ ### 2.2 Font Sizes & Weights
271
+
272
+ | Element | Tailwind Class | CSS Value | Weight | Letter Spacing | Line Height | Source Example |
273
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
274
+ | **Hero Title (H1)** | `text-3xl sm:text-6xl md:text-[68px]` | 30px / 60px / 68px | `font-bold` (700) | `tracking-tight` / `--tracking-tight-heading: -0.035em` | `leading-[1.1] sm:leading-[1.08]` | `HeroSection.tsx` (line 137) |
275
+ | **Section Title (H2)** | `text-3xl sm:text-4xl` | 30px / 36px | `font-semibold` (600) | `tracking-tight` (-0.025em / -0.028em) | `leading-tight` | `FeaturedShowcase.tsx` (line 35) |
276
+ | **Secondary Section H2** | `text-2xl sm:text-3xl` | 24px / 30px | `font-semibold` (600) | `tracking-tight` | `leading-normal` | `PhilosophySection.tsx` (line 37) |
277
+ | **Featured Component Title (H3)** | `text-xl sm:text-2xl` | 20px / 24px | `font-semibold` (600) | `tracking-tight` | `leading-snug` | `FeaturedShowcase.tsx` (line 69) |
278
+ | **Dialog Modal Title (H3)** | `text-lg sm:text-xl` | 18px / 20px | `font-semibold` (600) | `tracking-tight` | `leading-normal` | `MorphingDialog.tsx` (line 77) |
279
+ | **Standard Card Heading (H3/H4)**| `text-sm font-semibold` | 14px | `font-semibold` (600) | `tracking-tight` | `leading-normal` | `PhilosophySection.tsx` (line 52) |
280
+ | **Component Card Title** | `text-xs font-medium` | 12px | `font-medium` (500) | `normal` | `leading-normal` | `ComponentCard.tsx` (line 306) |
281
+ | **Body Paragraph** | `text-sm text-[#808080]` | 14px | `font-normal` (400) | `--tracking-body: -0.011em` | `leading-relaxed` (1.625) | `PhilosophySection.tsx` (line 55) |
282
+ | **Small / Micro Description** | `text-xs text-[#808080]` | 12px | `font-normal` (400) | `-0.011em` | `leading-relaxed` | `DevExperience.tsx` (line 82) |
283
+ | **Section Eyebrow Label** | `text-[11px] font-mono` | 11px | `font-normal` (400) | `uppercase tracking-widest` (0.1em) | `leading-none` | `FeaturedShowcase.tsx` (line 32) |
284
+ | **Pill / Category Tag** | `text-[10px] font-mono` | 10px | `font-normal` (400) | `tracking-normal` | `leading-none` | `ComponentCard.tsx` (line 311) |
285
+ | **New Badge** | `text-[10px] font-mono` | 10px | `font-medium` (500) | `uppercase tracking-wider` (0.05em) | `leading-none` | `NewBadge.tsx` (line 16) |
286
+ | **Keyboard Shortcut (kbd)** | `text-[10px] font-mono` | 10px | `font-normal` (400) | `normal` | `leading-none` | `Navbar.tsx` (line 85) |
287
+ | **Code Block Content** | `text-xs` / `text-[11px]` / `text-[13px]` | 11px–13px | `font-normal` (400) | `normal` | `leading-relaxed` | `CodePhilosophy.tsx` (line 156), `HeroSection.tsx` (line 231) |
288
+
289
+ ---
290
+
291
+ ### 2.3 Letter Spacing Tokens
292
+
293
+ * `--tracking-tighter`: `-0.04em` (`src/styles/tokens.css` line 19)
294
+ * `--tracking-tight-heading`: `-0.035em` (`src/styles/tokens.css` line 20, `tailwind.config.js` line 41)
295
+ * `h2` heading letter spacing: `-0.028em` (`src/styles/index.css` line 39)
296
+ * `--tracking-snug` / `h3`: `-0.02em` (`src/styles/tokens.css` line 21, `tailwind.config.js` line 42)
297
+ * `h4`, `h5`, `h6`: `-0.015em` (`src/styles/index.css` line 49)
298
+ * `--tracking-body`: `-0.011em` (`src/styles/tokens.css` line 22, `src/styles/index.css` line 20)
299
+ * `tracking-widest`: `0.1em` (used universally on all uppercase section eyebrows)
300
+
301
+ ---
302
+
303
+ # 3. SPACING SYSTEM
304
+
305
+ ### 3.1 Page & Container
306
+ - **Container max widths (`src/components/layout/Container.tsx`):**
307
+ - `sm`: `max-w-3xl` (768px)
308
+ - `md`: `max-w-5xl` (1024px)
309
+ - `lg`: `max-w-7xl` (1280px)
310
+ - `xl`: `max-w-[1400px]` (1400px)
311
+ - `full`: `max-w-full`
312
+ - **Container horizontal padding:** `px-4 sm:px-6 lg:px-8` (16px mobile, 24px tablet, 32px desktop)
313
+
314
+ ### 3.2 Section Spacing
315
+ - **Standard section vertical padding:** `py-20` (80px top & bottom)
316
+ - **Hero section vertical padding:** `pt-12 sm:pt-24 pb-14 sm:pb-20` (48px / 96px top, 56px / 80px bottom)
317
+ - **Final CTA vertical padding:** `py-24` (96px top & bottom)
318
+ - **Section header margin bottom:** `mb-12` (48px)
319
+
320
+ ### 3.3 Component Internal Padding
321
+ - **SpotlightCard:** `p-6` (24px) or `p-7` (28px)
322
+ - **MorphingDialog:** `p-6 sm:p-8` (24px mobile, 32px desktop)
323
+ - **SmoothAccordion item header:** `p-4` (16px)
324
+ - **SmoothAccordion content body:** `px-4 pb-4 pt-1`
325
+ - **FloatingActionDock:** `px-3 py-2.5` (12px horizontal, 10px vertical)
326
+ - **AnimatedTabs wrapper:** `p-1` (4px)
327
+ - **AnimatedTabs item button:** `px-3.5 py-1.5` (14px horizontal, 6px vertical)
328
+ - **ComponentCard info bar:** `px-4 py-3.5` (16px horizontal, 14px vertical)
329
+ - **NotificationStack card:** `p-3.5` (14px)
330
+ - **CommandMenu input row:** `px-4 py-3`
331
+ - **CommandMenu list item:** `px-3 py-2`
332
+
333
+ ### 3.4 Button Spacing (`src/components/ui/MagneticButton.tsx`)
334
+ - **Size `sm`:** `px-3.5 py-1.5 text-xs gap-1.5`
335
+ - **Size `md`:** `px-5 py-2.5 text-sm gap-2`
336
+ - **Size `lg`:** `px-7 py-3.5 text-base gap-2.5`
337
+ - **Hero Primary Pill CTA:** `px-5 sm:px-6 py-2 sm:py-2.5 text-xs sm:text-sm`
338
+ - **Hero Secondary Pill CTA:** `px-4.5 sm:px-5 py-2 sm:py-2.5 text-xs sm:text-sm`
339
+
340
+ ---
341
+
342
+ # 4. BORDER RADIUS SYSTEM
343
+
344
+ ### 4.1 Design Tokens (`src/styles/tokens.css`)
345
+
346
+ | Token Name | Exact CSS Value | Equivalent Tailwind | Primary Usage in Codebase |
347
+ | :--- | :--- | :--- | :--- |
348
+ | `--radius-sm` | `6px` | `rounded-md` | Tab items, tab indicator, small badges, copy buttons |
349
+ | `--radius-md` | `10px` | `rounded-lg` / `rounded-[8px]` | Inputs, search bars, Medium MagneticButtons (`rounded-[8px]`), Large MagneticButtons (`rounded-[10px]`), icon boxes |
350
+ | `--radius-lg` | `14px` | `rounded-xl` | All standard cards, SpotlightCard, RevealCard, SmoothAccordion, ComponentCards, Notification cards |
351
+ | `--radius-xl` | `20px` | `rounded-2xl` | MorphingDialog modal, FloatingActionDock, Terminal Hero window |
352
+ | `--radius-full`| `9999px` | `rounded-full` | Pills, Eyebrow badge, Hero CTA buttons, Scrollbar thumb |
353
+
354
+ ### 4.2 Component-by-Component Radius Inventory
355
+ * **Cards (`SpotlightCard`, `RevealCard`, `ComponentCard`):** `rounded-xl`
356
+ * **Accordion (`SmoothAccordion`):** `rounded-xl`
357
+ * **Modal Dialog (`MorphingDialog`):** `rounded-2xl`
358
+ * **Floating Dock (`FloatingActionDock`):** `rounded-2xl`
359
+ * **Dock Icon Buttons:** `rounded-xl`
360
+ * **Tabs Container (`AnimatedTabs`):** `rounded-lg`
361
+ * **Tab Active Indicator:** `rounded-md`
362
+ * **Notification Cards (`NotificationStack`):** `rounded-xl`
363
+ * **Inputs & Search (`ExpandableSearch`):** `rounded-lg`
364
+ * **Hero CTA Buttons:** `rounded-full`
365
+ * **Eyebrow Badges:** `rounded-full`
366
+ * **NewBadge / Category Badges:** `rounded` (4px)
367
+ * **Kbd Badges:** `rounded` (4px)
368
+
369
+ ---
370
+
371
+ # 5. BORDER SYSTEM
372
+
373
+ * **Standard Border Width:** `1px` (`border` in Tailwind). 2px borders are never used except on `:focus-visible` outlines.
374
+ * **Global Border Default:** `* { border-color: var(--border); }` (`src/styles/index.css` line 7)
375
+ * **Default Border Color:** `#1D1D1D` (`var(--border)`)
376
+ * **Divider & Section Separator:** `#141414` (e.g. `border-t border-b border-[#141414]`)
377
+ * **Card Baseline Border:** `#161616` (e.g. `border border-[#161616]`)
378
+ * **Active / Focused Control Border:** `#222222` / `#252525` / `#282828`
379
+ * **Hover Border Color:** `#2A2A2A` (`var(--border-hover)`) or `#262626`
380
+ * **High-contrast Hover Border (Dock icon):** `#383838`
381
+
382
+ ---
383
+
384
+ # 6. SHADOW SYSTEM
385
+
386
+ ### 6.1 Token Shadows (`src/styles/tokens.css`)
387
+ * **Subtle Shadow:**
388
+ ```css
389
+ --shadow-subtle: 0 1px 2px 0 rgba(0, 0, 0, 0.4), 0 0 0 1px rgba(255, 255, 255, 0.03);
390
+ ```
391
+ * **Elevated Shadow:**
392
+ ```css
393
+ --shadow-elevated: 0 12px 30px -10px rgba(0, 0, 0, 0.8), 0 0 0 1px rgba(255, 255, 255, 0.06);
394
+ ```
395
+ * **Glow Shadow:**
396
+ ```css
397
+ --shadow-glow: 0 0 20px -5px rgba(255, 255, 255, 0.15);
398
+ ```
399
+
400
+ ### 6.2 Component Shadows
401
+ * **Primary MagneticButton Glow Shadow:** `shadow-[0_0_20px_-3px_rgba(255,255,255,0.15)]` (`MagneticButton.tsx` line 54)
402
+ * **Hero Primary CTA Glow Shadow:** `shadow-[0_0_25px_rgba(255,255,255,0.1)]` (`HeroSection.tsx` line 161)
403
+ * **MorphingDialog Elevation Shadow:** `shadow-[0_20px_50px_rgba(0,0,0,0.8)]` (`MorphingDialog.tsx` line 66)
404
+ * **CommandMenu Elevation Shadow:** `shadow-[0_24px_60px_rgba(0,0,0,0.9)]` (`CommandMenu.tsx` line 195)
405
+ * **FloatingActionDock Elevation Shadow:** `shadow-[0_12px_32px_rgba(0,0,0,0.6)]` (`FloatingActionDock.tsx` line 82)
406
+ * **Terminal Window Shadow:** `shadow-[0_25px_60px_-15px_rgba(0,0,0,0.9)]` (`HeroSection.tsx` line 190)
407
+ * **Mobile Dropdown Shadow:** `shadow-[0_20px_40px_rgba(0,0,0,0.85)]` (`Navbar.tsx` line 127)
408
+
409
+ ---
410
+
411
+ # 7. GLOW / EFFECT SYSTEM
412
+
413
+ ### 7.1 Background Dot Mesh Patterns (`src/styles/index.css`)
414
+ * **Showroom Grid Mesh (`.bg-grid-pattern`):**
415
+ ```css
416
+ .bg-grid-pattern {
417
+ background-size: 24px 24px;
418
+ background-image: radial-gradient(circle, rgba(255, 255, 255, 0.05) 1px, transparent 1px);
419
+ }
420
+ ```
421
+ * **Subtle Playground Dot Pattern (`.bg-dot-subtle`):**
422
+ ```css
423
+ .bg-dot-subtle {
424
+ background-size: 16px 16px;
425
+ background-image: radial-gradient(circle, rgba(255, 255, 255, 0.035) 1px, transparent 1px);
426
+ }
427
+ ```
428
+
429
+ ### 7.2 Glassmorphism Surface (`.glass-surface`)
430
+ ```css
431
+ .glass-surface {
432
+ background: rgba(10, 10, 10, 0.75);
433
+ backdrop-filter: blur(12px);
434
+ -webkit-backdrop-filter: blur(12px);
435
+ border: 1px solid var(--border);
436
+ }
437
+ ```
438
+
439
+ ### 7.3 Backdrops
440
+ * **Navbar:** `bg-[#050505]/90 backdrop-blur-md`
441
+ * **Mobile Menu:** `bg-[#070707]/95 backdrop-blur-xl`
442
+ * **Modal Backdrop:** `fixed inset-0 bg-black/70 backdrop-blur-md` (`MorphingDialog.tsx` line 58)
443
+ * **Command Palette Backdrop:** `fixed inset-0 bg-black/75 backdrop-blur-sm` (`CommandMenu.tsx` line 186)
444
+
445
+ ---
446
+
447
+ # 8. ANIMATION SYSTEM
448
+
449
+ motion-ui's animation philosophy is **Soft + Physical + Immediate + Controlled**.
450
+ Every motion transition is strictly defined in `src/lib/motion-tokens.ts`.
451
+
452
+ ### 8.1 Framer Motion Spring Presets
453
+
454
+ #### 1. Gentle Springs (`springGentle`)
455
+ * **Philosophy:** Gentle fluid transitions for tabs, accordion expansion, and dialog content
456
+ * **Config:**
457
+ ```ts
458
+ {
459
+ type: "spring",
460
+ stiffness: 280,
461
+ damping: 30,
462
+ mass: 0.8
463
+ }
464
+ ```
465
+ * **Where used:** `AnimatedTabs.tsx` (content fade/slide), `SmoothAccordion.tsx` (height reveal)
466
+
467
+ #### 2. Snappy Springs (`springSnappy`)
468
+ * **Philosophy:** Snappy responsive feedback for interactive triggers, hover indicators, dock icons, chevrons
469
+ * **Config:**
470
+ ```ts
471
+ {
472
+ type: "spring",
473
+ stiffness: 400,
474
+ damping: 25,
475
+ mass: 0.5
476
+ }
477
+ ```
478
+ * **Where used:** `MagneticButton.tsx` (`whileTap`), `SmoothAccordion.tsx` (chevron rotation), `ExpandableSearch.tsx` (width expansion), `FloatingActionDock.tsx` (icon tap), `CommandMenu.tsx` (modal entrance)
479
+
480
+ #### 3. Morphing Shared Layout Springs (`springMorph`)
481
+ * **Philosophy:** Morphing shared layout transitions for expanding surfaces and tab background indicators
482
+ * **Config:**
483
+ ```ts
484
+ {
485
+ type: "spring",
486
+ stiffness: 320,
487
+ damping: 28,
488
+ mass: 0.9
489
+ }
490
+ ```
491
+ * **Where used:** `AnimatedTabs.tsx` (`layoutId` active tab pill), `MorphingDialog.tsx` (`layoutId` dialog container)
492
+
493
+ #### 4. Responsive Physics Springs (`springResponsive`)
494
+ * **Philosophy:** Responsive bounce physics for magnetic return and stacked notifications
495
+ * **Config:**
496
+ ```ts
497
+ {
498
+ type: "spring",
499
+ stiffness: 350,
500
+ damping: 22,
501
+ mass: 0.6
502
+ }
503
+ ```
504
+ * **Where used:** `NotificationStack.tsx` (card drag, enter, exit, and stack offset)
505
+
506
+ ### 8.2 Standard Bezier Curves
507
+ * **`easeSoft`:**
508
+ ```ts
509
+ {
510
+ duration: 0.22,
511
+ ease: [0.16, 1, 0.3, 1]
512
+ }
513
+ ```
514
+ *Where used:* `MorphingDialog.tsx` (backdrop fade), `Navbar.tsx` (mobile menu dropdown)
515
+ * **`easeFast`:**
516
+ ```ts
517
+ {
518
+ duration: 0.15,
519
+ ease: [0.2, 0, 0, 1]
520
+ }
521
+ ```
522
+
523
+ ### 8.3 Custom Interactive Springs
524
+ * **Magnetic Cursor Pull (`MagneticButton.tsx` lines 29–30):**
525
+ `useSpring(0, { stiffness: 280, damping: 20 })` with pull multiplier `strength = 0.35`
526
+ * **Dock Magnification (`FloatingActionDock.tsx` line 37):**
527
+ `useSpring(widthSync, { mass: 0.1, stiffness: 180, damping: 14 })`
528
+ * **3D Tilt Rotation (`RevealCard.tsx` lines 21–22):**
529
+ `useSpring(0, { stiffness: 260, damping: 20 })` with `maxTilt = 12`
530
+
531
+ ### 8.4 CSS Keyframe Animations
532
+ * **`pulse-subtle` (`tailwind.config.js` lines 44–52):**
533
+ ```css
534
+ @keyframes pulseSubtle {
535
+ 0%, 100% { opacity: 1; }
536
+ 50% { opacity: 0.6; }
537
+ }
538
+ animation: pulseSubtle 3s cubic-bezier(0.4, 0, 0.6, 1) infinite;
539
+ ```
540
+
541
+ ---
542
+
543
+ # 9. HOVER STATES
544
+
545
+ * **Card Borders:** `border-[#1D1D1D] hover:border-[#2A2A2A]` or `border-[#161616] hover:border-[#262626]` with `transition-colors duration-200` or `duration-300`
546
+ * **Nav Links:** `text-[#808080] hover:text-[#F5F5F5]` with `transition-colors`
547
+ * **Action Buttons:**
548
+ - Primary: `bg-[#F5F5F5] hover:bg-[#FFFFFF]`
549
+ - Secondary: `bg-[#151515] border-[#1D1D1D] hover:border-[#2A2A2A] hover:bg-[#1A1A1A]`
550
+ - Outline: `border-[#2A2A2A] hover:border-[#F5F5F5]/30 hover:bg-[#101010]`
551
+ - Ghost: `text-[#A1A1A1] hover:text-[#F5F5F5] hover:bg-[#101010]`
552
+ * **Interactive Hover Scale:**
553
+ - Hero Primary Button: `hover:scale-[1.02] active:scale-[0.98]`
554
+ - Showcase Cards: Pointer tracking with dynamic opacity reveal (`opacity-0 group-hover:opacity-100 transition-opacity duration-300`)
555
+ - Chevron / Arrow nudges: `group-hover:translate-x-0.5 transition-transform`
556
+
557
+ ---
558
+
559
+ # 10. FOCUS STATES
560
+
561
+ motion-ui uses an accessible, restrained focus ring system.
562
+
563
+ ### Focus Ring Specification (`src/styles/index.css` lines 75–81)
564
+ ```css
565
+ .focus-ring {
566
+ outline: none;
567
+ }
568
+ .focus-ring:focus-visible {
569
+ outline: 2px solid rgba(56, 189, 248, 0.5);
570
+ outline-offset: 2px;
571
+ }
572
+ ```
573
+ * **Ring Outline Width:** `2px`
574
+ * **Ring Offset:** `2px`
575
+ * **Ring Color:** `rgba(56, 189, 248, 0.5)` (Sky-400 at 50% opacity)
576
+ * **Trigger:** strictly `:focus-visible` (no intrusive focus outline on mouse click, only on keyboard navigation)
577
+ * **Input Elements:** `focus:outline-none` with surrounding container border highlight (`border-[#2A2A2A]`)
578
+
579
+ ---
580
+
581
+ # 11. RESPONSIVE SYSTEM
582
+
583
+ motion-ui adheres to Tailwind's mobile-first responsive breakpoints:
584
+ * **Mobile (`< 640px`):** Default styles, stacked single-column grids (`grid-cols-1`), hidden labels (`hidden sm:inline`), full-width controls
585
+ * **Tablet (`sm:` `>= 640px`):** 2-column grids (`sm:grid-cols-2`), increased vertical padding (`sm:pt-24 sm:pb-20`), enlarged title sizes (`sm:text-6xl`)
586
+ * **Desktop (`md:` `>= 768px`):** Horizontal flex alignment (`md:flex-row md:items-center`), desktop navigation menu visible (`hidden md:flex`), hamburger menu hidden (`md:hidden`)
587
+ * **Large Desktop (`lg:` `>= 1024px`):** 3-column / 4-column component grids (`lg:grid-cols-3`, `lg:grid-cols-4`), 12-column editorial splits (`lg:grid-cols-12`)
588
+ * **Max Display Width (`xl:` `>= 1280px` / `1400px`):** `Container size="xl"` caps content cleanly at `1400px`
589
+
590
+ ---
591
+
592
+ # 12. COMPONENT VISUAL LANGUAGE
593
+
594
+ ### 12.1 Card Archetype
595
+ ```tsx
596
+ <div className="group relative rounded-xl border border-[#1D1D1D] bg-[#0A0A0A] p-6 transition-colors duration-300 hover:border-[#2A2A2A] overflow-hidden">
597
+ {/* Optional dynamic light effect / grid pattern */}
598
+ <div className="relative z-10">{children}</div>
599
+ </div>
600
+ ```
601
+
602
+ ### 12.2 Button Archetype (`MagneticButton`)
603
+ ```tsx
604
+ <motion.button
605
+ whileTap={{ scale: 0.96 }}
606
+ transition={motionTransitions.springSnappy}
607
+ className="relative inline-flex items-center justify-center font-medium select-none focus-ring px-5 py-2.5 text-sm rounded-[8px] gap-2 bg-[#F5F5F5] text-[#050505] hover:bg-[#FFFFFF] shadow-[0_0_20px_-3px_rgba(255,255,255,0.15)]"
608
+ >
609
+ <span>{children}</span>
610
+ </motion.button>
611
+ ```
612
+
613
+ ### 12.3 Pill Filter Archetype
614
+ ```tsx
615
+ <button className="px-3 py-1.5 text-xs rounded-lg font-medium transition-colors whitespace-nowrap focus-ring bg-[#181818] text-[#F5F5F5] border border-[#282828]">
616
+ {label}
617
+ </button>
618
+ ```
619
+
620
+ ### 12.4 Eyebrow / Section Header Archetype
621
+ ```tsx
622
+ <span className="text-[11px] font-mono text-[#737373] uppercase tracking-widest">
623
+ Category
624
+ </span>
625
+ <h2 className="text-3xl sm:text-4xl font-semibold text-[#F5F5F5] tracking-tight mt-1">
626
+ Section Title
627
+ </h2>
628
+ <p className="text-sm text-[#808080] mt-1.5 max-w-lg">
629
+ Descriptive subtitle text.
630
+ </p>
631
+ ```
632
+
633
+ ---
634
+
635
+ # 13. ICON SYSTEM
636
+
637
+ * **Icon Library:** `lucide-react` (v1.31.0)
638
+ * **Standard Icon Sizes:**
639
+ - Micro / Inline: `w-3 h-3` or `w-3.5 h-3.5` (12px / 14px)
640
+ - Standard Button / Trigger: `w-4 h-4` (16px)
641
+ - Dock / Feature Card: `w-5 h-5` (20px)
642
+ * **Icon Colors:**
643
+ - Default: `text-[#808080]` or `text-[#A1A1A1]`
644
+ - Muted: `text-[#6F6F6F]`
645
+ - Header / Feature Tint: `text-[#D4D4D4]` or `text-[#ECECEC]`
646
+ - Active / Hovered: `text-white` or `text-[#F5F5F5]`
647
+ * **Stroke Width:** Default Lucide stroke (`2px`)
648
+
649
+ ---
650
+
651
+ # 14. COMPONENT STATES
652
+
653
+ | State | Background | Border | Text | Transform / Effects |
654
+ | :--- | :--- | :--- | :--- | :--- |
655
+ | **Default** | `#080808` / `#0A0A0A` | `#161616` / `#1D1D1D` | `#F5F5F5` (headings), `#808080` (body) | — |
656
+ | **Hover** | `#101010` (controls) | `#2A2A2A` / `#262626` | `#F5F5F5` / `#FFFFFF` | Subtle scale, arrow nudge, spotlight glow |
657
+ | **Active / Press** | `#1A1A1A` | `#282828` | `#FFFFFF` | `whileTap={{ scale: 0.96 }}` (springSnappy) |
658
+ | **Focus** | (unchanged) | Container border `#2A2A2A` | (unchanged) | `outline: 2px solid rgba(56, 189, 248, 0.5)` offset 2px |
659
+ | **Disabled** | `#070707` | `#161616` | `#555555` | `opacity-30 cursor-not-allowed` |
660
+ | **Selected** | `#181818` | `#282828` / `#2A2A2A` | `#F5F5F5` | White indicator dot or morphing pill background |
661
+ | **Success (Feedback)** | `#141414` | `#222222` | `#FFFFFF` | `<Check>` icon reveal, 2000ms duration |
662
+
663
+ ---
664
+
665
+ # 15. DESIGN PRINCIPLES
666
+
667
+ 1. **Monochrome Dominance:** The interface is built upon a tailored 10-step neutral dark grayscale hierarchy (`#050505` to `#F5F5F5`). No saturated accent backgrounds exist.
668
+ 2. **Atmospheric Depth:** Visual depth is created by stacking slightly elevated dark surfaces with 1px borders and subtle ambient blur reflections rather than drop shadows.
669
+ 3. **Physical Motion:** Animations are never linear or basic ease-in-out; every interaction is driven by Framer Motion spring physics with real mass, damping, and stiffness.
670
+ 4. **Restrained Blue Focus:** `rgba(56, 189, 248, 0.5)` is strictly reserved for accessibility focus rings and sensor beams.
671
+ 5. **Unified Typography:** `Geist` is used for all narrative and headings; `JetBrains Mono` is used for technical data, commands, tags, and metrics.
672
+ 6. **Subtle Tactility:** Interactive elements respond to cursor proximity (magnetic pull, spotlight mask, 3D tilt glare).
673
+ 7. **Copy-Paste Architecture:** Components are self-contained TypeScript + Tailwind CSS files with zero vendor lock-in wrappers.
674
+ 8. **Consistent Micro-Radius:** `rounded-md` (6px) for small items, `rounded-lg` (10px) for controls, `rounded-xl` (14px) for cards, `rounded-2xl` (20px) for modals.
675
+ 9. **Precise Spacing Rhythms:** 20px grid gaps (`gap-5`), 80px section spacing (`py-20`), 48px header margins (`mb-12`).
676
+ 10. **Information-Dense Minimalism:** Text sizes are compact (`text-xs` and `text-sm`), with uppercase tracking-widest eyebrows providing structural guidance.
677
+
678
+ ---
679
+
680
+ # 16. MACHINE-READABLE TOKEN TABLE
681
+
682
+ ```text
683
+ motion-ui DESIGN TOKENS (CLAUDE DARK NEUTRAL SYSTEM)
684
+
685
+ Background & Surfaces:
686
+ - main-canvas (bg): #151515
687
+ - component-surface: #202020
688
+ - surface-raised: #242424
689
+ - surface-hover: #262626
690
+ - code-inner: #151515
691
+ - code-deck: #202020
692
+ - code-titlebar: #242424
693
+
694
+ Foreground / Typography:
695
+ - primary (text-primary): #F5F5F5
696
+ - secondary (text-secondary): #A3A3A3
697
+ - muted (text-muted): #737373
698
+ - subtle-icon (text-subtle): #8A8A8A
699
+ - pure-white: #FFFFFF
700
+
701
+ Accent & Indicators:
702
+ - primary-accent: #F5F5F5
703
+ - accent-subtle: rgba(255, 255, 255, 0.06)
704
+ - accent-glow: rgba(255, 255, 255, 0.08)
705
+ - accent-ring: rgba(255, 255, 255, 0.20)
706
+ - indicator-blue: #3B82F6
707
+
708
+ Borders:
709
+ - default (border): #363636
710
+ - hover (border-hover): #484848 / #4A4A4A
711
+ - subtle (border-subtle): #2C2C2C
712
+
713
+ Radius:
714
+ - small: 6px (rounded-md)
715
+ - medium: 10px (rounded-lg)
716
+ - large: 14px (rounded-xl)
717
+ - extra-large: 20px (rounded-2xl)
718
+ - full: 9999px (rounded-full)
719
+
720
+ Typography:
721
+ - font-sans: 'Geist', 'Geist Sans', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif
722
+ - font-mono: 'JetBrains Mono', 'Fira Code', monospace
723
+ - heading-h1: text-3xl sm:text-6xl md:text-[68px] font-bold tracking-tight
724
+ - heading-h2: text-3xl sm:text-4xl font-semibold tracking-tight
725
+ - heading-h3: text-xl sm:text-2xl font-semibold tracking-tight
726
+ - card-title: text-sm font-semibold tracking-tight
727
+ - body: text-sm font-normal leading-relaxed text-[#A3A3A3]
728
+ - small: text-xs text-[#A3A3A3]
729
+ - eyebrow: text-[11px] font-mono uppercase tracking-widest text-[#737373]
730
+ - tag: text-[10px] font-mono
731
+
732
+ Animation Springs:
733
+ - gentle: { stiffness: 280, damping: 30, mass: 0.8 }
734
+ - snappy: { stiffness: 400, damping: 25, mass: 0.5 }
735
+ - morph: { stiffness: 320, damping: 28, mass: 0.9 }
736
+ - responsive: { stiffness: 350, damping: 22, mass: 0.6 }
737
+ - ease-soft: { duration: 0.22, ease: [0.16, 1, 0.3, 1] }
738
+ - ease-fast: { duration: 0.15, ease: [0.2, 0, 0, 1] }
739
+ ```
740
+
741
+ ---
742
+
743
+ # 17. SOURCE LOCATIONS
744
+
745
+ | Token / Asset | Exact Value | Source File & Line Number |
746
+ | :--- | :--- | :--- |
747
+ | `var(--bg)` | `#151515` | `src/styles/tokens.css:3`, `tailwind.config.js:11` |
748
+ | `var(--surface)` | `#202020` | `src/styles/tokens.css:4`, `tailwind.config.js:13` |
749
+ | `var(--surface-hover)` | `#262626` | `src/styles/tokens.css:5`, `tailwind.config.js:14` |
750
+ | `var(--surface-raised)` | `#242424` | `src/styles/tokens.css:6`, `tailwind.config.js:15` |
751
+ | `var(--border)` | `#363636` | `src/styles/tokens.css:9`, `tailwind.config.js:18` |
752
+ | `var(--border-hover)` | `#484848` | `src/styles/tokens.css:10`, `tailwind.config.js:19` |
753
+ | `var(--border-subtle)` | `#2C2C2C` | `src/styles/tokens.css:11`, `tailwind.config.js:20` |
754
+ | `var(--font-sans)` | `'Geist', 'Geist Sans', 'Inter', ...` | `src/styles/tokens.css:14`, `tailwind.config.js:36` |
755
+ | `var(--font-mono)` | `'JetBrains Mono', 'Fira Code', monospace` | `src/styles/tokens.css:17`, `tailwind.config.js:40` |
756
+ | `var(--text-primary)` | `#F5F5F5` | `src/styles/tokens.css:24`, `tailwind.config.js:23` |
757
+ | `var(--text-secondary)` | `#A3A3A3` | `src/styles/tokens.css:25`, `tailwind.config.js:24` |
758
+ | `var(--text-muted)` | `#737373` | `src/styles/tokens.css:26`, `tailwind.config.js:25` |
759
+ | `var(--text-subtle)` | `#8A8A8A` | `src/styles/tokens.css:27`, `tailwind.config.js:26` |
760
+ | `var(--accent)` | `#F5F5F5` | `src/styles/tokens.css:30`, `tailwind.config.js:29` |
761
+ | `var(--indicator-active)`| `#3B82F6` | `src/styles/tokens.css:34`, `tailwind.config.js:32` |
762
+ | `var(--radius-sm)` | `6px` | `src/styles/tokens.css:37` |
763
+ | `var(--radius-md)` | `10px` | `src/styles/tokens.css:38` |
764
+ | `var(--radius-lg)` | `14px` | `src/styles/tokens.css:39` |
765
+ | `var(--radius-xl)` | `20px` | `src/styles/tokens.css:40` |
766
+ | `var(--radius-full)` | `9999px` | `src/styles/tokens.css:41` |
767
+ | `var(--shadow-subtle)` | `0 1px 2px 0 rgba(0,0,0,0.25)...` | `src/styles/tokens.css:44` |
768
+ | `var(--shadow-elevated)` | `0 10px 25px -8px rgba(0,0,0,0.4)...` | `src/styles/tokens.css:45` |
769
+ | `var(--shadow-glow)` | `0 0 15px -3px rgba(255,255,255,0.08)` | `src/styles/tokens.css:46` |
770
+ | `springGentle` | `{ stiffness: 280, damping: 30, mass: 0.8 }` | `src/lib/motion-tokens.ts:10–15` |
771
+ | `springSnappy` | `{ stiffness: 400, damping: 25, mass: 0.5 }` | `src/lib/motion-tokens.ts:17–22` |
772
+ | `springMorph` | `{ stiffness: 320, damping: 28, mass: 0.9 }` | `src/lib/motion-tokens.ts:24–31` |
773
+ | `springResponsive` | `{ stiffness: 350, damping: 22, mass: 0.6 }` | `src/lib/motion-tokens.ts:33–39` |
774
+ | `easeSoft` | `{ duration: 0.22, ease: [0.16, 1, 0.3, 1] }` | `src/lib/motion-tokens.ts:42–45` |
775
+ | `easeFast` | `{ duration: 0.15, ease: [0.2, 0, 0, 1] }` | `src/lib/motion-tokens.ts:47–50` |
776
+ | App Main Background | `bg-[#151515] text-[#F5F5F5]` | `src/App.tsx` |\n