motion-ui-skill 2.0.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 (886) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +637 -0
  3. package/SKILL.md +529 -0
  4. package/agents/openai.yaml +8 -0
  5. package/bin/index.mjs +242 -0
  6. package/bin/installer.mjs +457 -0
  7. package/bin/updater.mjs +207 -0
  8. package/catalog.json +8120 -0
  9. package/components/agents/agent-activity/activity-row.tsx +242 -0
  10. package/components/agents/agent-activity/index.tsx +287 -0
  11. package/components/agents/agent-activity/types.ts +106 -0
  12. package/components/agents/agent-code.tsx +171 -0
  13. package/components/agents/agent-disclosure.tsx +55 -0
  14. package/components/agents/ai-sidebar.tsx +981 -0
  15. package/components/agents/approval-card/index.tsx +467 -0
  16. package/components/agents/approval-card/types.ts +56 -0
  17. package/components/agents/chat-app.tsx +97 -0
  18. package/components/agents/citations.tsx +288 -0
  19. package/components/agents/code-block.tsx +202 -0
  20. package/components/agents/file-diff.tsx +288 -0
  21. package/components/agents/image-generation.tsx +388 -0
  22. package/components/agents/loading-states/agent-progress.tsx +105 -0
  23. package/components/agents/loading-states/index.ts +13 -0
  24. package/components/agents/loading-states/reasoning-text.tsx +224 -0
  25. package/components/agents/loading-states/thinking-shimmer.tsx +27 -0
  26. package/components/agents/message-bubble.tsx +369 -0
  27. package/components/agents/message-context.tsx +9 -0
  28. package/components/agents/message-scroller.tsx +487 -0
  29. package/components/agents/message.tsx +272 -0
  30. package/components/agents/prompt-input.tsx +327 -0
  31. package/components/agents/streaming-response.tsx +263 -0
  32. package/components/agents/todo-list.tsx +387 -0
  33. package/components/agents/tool-approval.tsx +276 -0
  34. package/components/agents/tool-result.tsx +352 -0
  35. package/components/app/icons.tsx +19 -0
  36. package/components/audio/music-player-card.tsx +146 -0
  37. package/components/audio/music-playlist-card.tsx +172 -0
  38. package/components/audio/now-playing-bar.tsx +116 -0
  39. package/components/background-gradient/arc-bands-background.tsx +54 -0
  40. package/components/background-gradient/aurora-background.tsx +49 -0
  41. package/components/background-gradient/cherry-petal-background.tsx +50 -0
  42. package/components/background-gradient/coral-glow-background.tsx +47 -0
  43. package/components/background-gradient/dark-arc-bands-background.tsx +52 -0
  44. package/components/background-gradient/dark-aurora-background.tsx +52 -0
  45. package/components/background-gradient/dark-carbon-spotlight-background.tsx +47 -0
  46. package/components/background-gradient/dark-ember-background.tsx +47 -0
  47. package/components/background-gradient/dark-ink-field-background.tsx +46 -0
  48. package/components/background-gradient/dark-midnight-mesh-background.tsx +61 -0
  49. package/components/background-gradient/dark-rose-noir-background.tsx +52 -0
  50. package/components/background-gradient/dark-teal-depth-background.tsx +52 -0
  51. package/components/background-gradient/frost-mesh-background.tsx +56 -0
  52. package/components/background-gradient/halftone-pop-background.tsx +52 -0
  53. package/components/background-gradient/honey-ember-background.tsx +47 -0
  54. package/components/background-gradient/ink-wash-background.tsx +49 -0
  55. package/components/background-gradient/linen-weave-background.tsx +47 -0
  56. package/components/background-gradient/mint-lagoon-background.tsx +47 -0
  57. package/components/background-gradient/paper-fold-background.tsx +52 -0
  58. package/components/background-gradient/rain-prism-background.tsx +52 -0
  59. package/components/background-gradient/sand-drift-background.tsx +47 -0
  60. package/components/background-gradient/soft-spotlight-background.tsx +47 -0
  61. package/components/background-gradient/sunrise-horizon-background.tsx +51 -0
  62. package/components/background-gradient/sunset-bloom-background.tsx +47 -0
  63. package/components/background-gradient/terrazzo-fragment-background.tsx +53 -0
  64. package/components/background-gradient/tropical-tide-background.tsx +47 -0
  65. package/components/background-pattern/diagonal-box-pattern.tsx +29 -0
  66. package/components/background-pattern/dot-grid-pattern.tsx +29 -0
  67. package/components/background-pattern/fine-grain-pattern.tsx +39 -0
  68. package/components/background-pattern/graph-paper-pattern.tsx +29 -0
  69. package/components/background-pattern/line-grid-pattern.tsx +39 -0
  70. package/components/background-pattern/reverse-diagonal-box-pattern.tsx +30 -0
  71. package/components/buttons/add-to-cart-button.tsx +190 -0
  72. package/components/buttons/bookmark-save-button.tsx +105 -0
  73. package/components/buttons/cinder-latch-button.tsx +80 -0
  74. package/components/buttons/copy-button.tsx +155 -0
  75. package/components/buttons/depth-outline-button.tsx +72 -0
  76. package/components/buttons/dimple-switch.tsx +114 -0
  77. package/components/buttons/download-button.tsx +186 -0
  78. package/components/buttons/follow-button.tsx +98 -0
  79. package/components/buttons/hold-to-delete-button.tsx +205 -0
  80. package/components/buttons/inset-button.tsx +82 -0
  81. package/components/buttons/like-button.tsx +135 -0
  82. package/components/buttons/linen-tab-button.tsx +92 -0
  83. package/components/buttons/prism-depth-button.tsx +90 -0
  84. package/components/buttons/quantity-stepper-button.tsx +104 -0
  85. package/components/buttons/segmented-toggle-button.tsx +134 -0
  86. package/components/buttons/sheen-pill-button.tsx +127 -0
  87. package/components/buttons/slate-chip-switch.tsx +94 -0
  88. package/components/buttons/slide-to-confirm-button.tsx +163 -0
  89. package/components/buttons/soft-pill-button.tsx +86 -0
  90. package/components/buttons/soft-ui-button.tsx +59 -0
  91. package/components/buttons/three-d-button.tsx +99 -0
  92. package/components/buttons/three-d-icon-button.tsx +88 -0
  93. package/components/calendar/booking-slot-calendar.tsx +315 -0
  94. package/components/calendar/date-range-picker-card.tsx +216 -0
  95. package/components/calendar/event-countdown-card.tsx +105 -0
  96. package/components/calendar/month-picker-calendar.tsx +183 -0
  97. package/components/calendar/week-strip-calendar.tsx +182 -0
  98. package/components/contact/copy-email.tsx +94 -0
  99. package/components/docks/Icons.tsx +222 -0
  100. package/components/docks/app-dock.tsx +111 -0
  101. package/components/docks/editor-tool-dock.tsx +113 -0
  102. package/components/docks/mac-dock.tsx +144 -0
  103. package/components/docks/presence-dock.tsx +178 -0
  104. package/components/docks/spotlight-bar.tsx +188 -0
  105. package/components/dropdowns/file-menu-dropdown.tsx +192 -0
  106. package/components/dropdowns/filter-sort-dropdown.tsx +189 -0
  107. package/components/dropdowns/kebab-actions-dropdown.tsx +195 -0
  108. package/components/dropdowns/notification-dropdown.tsx +235 -0
  109. package/components/dropdowns/share-menu-dropdown.tsx +197 -0
  110. package/components/dropdowns/user-menu-dropdown.tsx +251 -0
  111. package/components/dropdowns/workspace-switcher-dropdown.tsx +248 -0
  112. package/components/event/event-ticket-card.tsx +116 -0
  113. package/components/files/ink-stamp-document-card.tsx +88 -0
  114. package/components/files/stacked-folder-card.tsx +176 -0
  115. package/components/folder/folder-tab-card.tsx +123 -0
  116. package/components/forms/contact-form.tsx +417 -0
  117. package/components/forms/forgot-password-form.tsx +264 -0
  118. package/components/forms/login-form.tsx +342 -0
  119. package/components/forms/newsletter-form.tsx +212 -0
  120. package/components/forms/signup-form.tsx +487 -0
  121. package/components/frames/circle-cut-frame.tsx +198 -0
  122. package/components/frames/hard-shadow-polaroid-frame.tsx +158 -0
  123. package/components/frames/sticky-note-polaroid-frame.tsx +230 -0
  124. package/components/frames/transform-box-frame.tsx +287 -0
  125. package/components/frames/transform-plus-frame.tsx +308 -0
  126. package/components/gallery/film-strip-card.tsx +103 -0
  127. package/components/gallery/gallery-grid-card.tsx +106 -0
  128. package/components/gallery/gallery-wall-card.tsx +71 -0
  129. package/components/gallery/glass-overlay-image-card.tsx +156 -0
  130. package/components/gallery/museum-placard-card.tsx +105 -0
  131. package/components/gallery/photo-album-card.tsx +114 -0
  132. package/components/gallery/photo-contact-sheet-card.tsx +71 -0
  133. package/components/gallery/polaroid-image-card.tsx +81 -0
  134. package/components/gallery/slow-living-polaroid-card.tsx +88 -0
  135. package/components/gallery/stamp-postcard-card.tsx +78 -0
  136. package/components/inputs/checkbox-field-input.tsx +148 -0
  137. package/components/inputs/combobox-field-input.tsx +466 -0
  138. package/components/inputs/date-field-input.tsx +472 -0
  139. package/components/inputs/file-upload-field-input.tsx +578 -0
  140. package/components/inputs/floating-label-field-input.tsx +206 -0
  141. package/components/inputs/input-group-field.tsx +132 -0
  142. package/components/inputs/password-field-input.tsx +125 -0
  143. package/components/inputs/phone-field-input.tsx +157 -0
  144. package/components/inputs/radio-group-field-input.tsx +220 -0
  145. package/components/inputs/search-input.tsx +163 -0
  146. package/components/inputs/select-field-input.tsx +416 -0
  147. package/components/inputs/switch-field-input.tsx +179 -0
  148. package/components/inputs/text-field-input.tsx +89 -0
  149. package/components/inputs/textarea-field-input.tsx +152 -0
  150. package/components/loaders/apple-hello-loader.tsx +86 -0
  151. package/components/loaders/spin-loader.tsx +51 -0
  152. package/components/loaders/text-loader.tsx +148 -0
  153. package/components/mockups/apple-ipod-mockup-card.tsx +155 -0
  154. package/components/mockups/apple-watch-mockup-card.tsx +278 -0
  155. package/components/mockups/browser-mockup-card.tsx +109 -0
  156. package/components/mockups/laptop-mockup-card.tsx +118 -0
  157. package/components/mockups/phone-mockup-card.tsx +210 -0
  158. package/components/mockups/tablet-mockup-card.tsx +212 -0
  159. package/components/motion/action-sheet.tsx +218 -0
  160. package/components/motion/action-swap-roll.tsx +32 -0
  161. package/components/motion/action-swap.tsx +340 -0
  162. package/components/motion/adaptive-stepper.tsx +442 -0
  163. package/components/motion/animated-badge.tsx +213 -0
  164. package/components/motion/animated-number.tsx +50 -0
  165. package/components/motion/animated-sidebar.tsx +1174 -0
  166. package/components/motion/animated-toast-stack.tsx +503 -0
  167. package/components/motion/aspect-ratio.tsx +55 -0
  168. package/components/motion/attachment-upload.tsx +1080 -0
  169. package/components/motion/audio-player.tsx +266 -0
  170. package/components/motion/autocomplete.tsx +183 -0
  171. package/components/motion/availability-scheduler/copy-menu.tsx +119 -0
  172. package/components/motion/availability-scheduler/day-row.tsx +231 -0
  173. package/components/motion/availability-scheduler/icon-button.tsx +46 -0
  174. package/components/motion/availability-scheduler/index.tsx +154 -0
  175. package/components/motion/availability-scheduler/time-select.tsx +49 -0
  176. package/components/motion/availability-scheduler/types.ts +189 -0
  177. package/components/motion/avatar-group.tsx +154 -0
  178. package/components/motion/bloom-menu.tsx +216 -0
  179. package/components/motion/bottom-sheet.tsx +249 -0
  180. package/components/motion/bounce-sidebar.tsx +266 -0
  181. package/components/motion/bouncy-accordion.tsx +325 -0
  182. package/components/motion/breadcrumb.tsx +122 -0
  183. package/components/motion/button/base.tsx +189 -0
  184. package/components/motion/button/index.tsx +13 -0
  185. package/components/motion/button/magnetic.tsx +25 -0
  186. package/components/motion/button/metallic.tsx +100 -0
  187. package/components/motion/button/stateful.tsx +237 -0
  188. package/components/motion/card-folder.tsx +345 -0
  189. package/components/motion/card-resize.tsx +229 -0
  190. package/components/motion/cascader.tsx +279 -0
  191. package/components/motion/center-morph-modal.tsx +366 -0
  192. package/components/motion/checkbox.tsx +123 -0
  193. package/components/motion/chip.tsx +121 -0
  194. package/components/motion/chromatic-text-reveal.tsx +203 -0
  195. package/components/motion/collapsible.tsx +108 -0
  196. package/components/motion/color-picker.tsx +206 -0
  197. package/components/motion/combobox/content.tsx +163 -0
  198. package/components/motion/combobox/context.tsx +359 -0
  199. package/components/motion/combobox/list.tsx +222 -0
  200. package/components/motion/combobox/trigger.tsx +191 -0
  201. package/components/motion/combobox/use-active-option.ts +130 -0
  202. package/components/motion/combobox.tsx +33 -0
  203. package/components/motion/command-palette.tsx +381 -0
  204. package/components/motion/confetti.tsx +128 -0
  205. package/components/motion/context-menu.tsx +790 -0
  206. package/components/motion/copy-button.tsx +103 -0
  207. package/components/motion/cylinder-carousel.tsx +459 -0
  208. package/components/motion/date-range-picker.tsx +218 -0
  209. package/components/motion/digit-swap.tsx +125 -0
  210. package/components/motion/dock.tsx +113 -0
  211. package/components/motion/drawer.tsx +108 -0
  212. package/components/motion/dynamic-island.tsx +221 -0
  213. package/components/motion/error-shake.tsx +66 -0
  214. package/components/motion/event-calendar.tsx +224 -0
  215. package/components/motion/expandable-action-bar.tsx +412 -0
  216. package/components/motion/expandable-control.tsx +254 -0
  217. package/components/motion/expandable-tabs.tsx +444 -0
  218. package/components/motion/expanding-arrow-button.tsx +171 -0
  219. package/components/motion/feedback-widget.tsx +473 -0
  220. package/components/motion/file-tree.tsx +429 -0
  221. package/components/motion/file-upload.tsx +606 -0
  222. package/components/motion/filter-builder.tsx +283 -0
  223. package/components/motion/frame.tsx +116 -0
  224. package/components/motion/gantt.tsx +156 -0
  225. package/components/motion/glow-button.tsx +101 -0
  226. package/components/motion/haptic-pressable.tsx +107 -0
  227. package/components/motion/hold-action-button.tsx +279 -0
  228. package/components/motion/hover-card.tsx +118 -0
  229. package/components/motion/icon-stack.tsx +138 -0
  230. package/components/motion/infinite-masonry.tsx +349 -0
  231. package/components/motion/input.tsx +242 -0
  232. package/components/motion/kanban.tsx +255 -0
  233. package/components/motion/kbd.tsx +127 -0
  234. package/components/motion/knockout-bracket.tsx +909 -0
  235. package/components/motion/knockout-wheel.tsx +1112 -0
  236. package/components/motion/liquid.tsx +351 -0
  237. package/components/motion/loader.tsx +616 -0
  238. package/components/motion/magnet-dock.tsx +117 -0
  239. package/components/motion/magnetic.tsx +50 -0
  240. package/components/motion/marquee.tsx +66 -0
  241. package/components/motion/metric-card.tsx +116 -0
  242. package/components/motion/morphing-modal.tsx +160 -0
  243. package/components/motion/morphing-search.tsx +643 -0
  244. package/components/motion/morphing-tabs.tsx +940 -0
  245. package/components/motion/multi-select/content.tsx +164 -0
  246. package/components/motion/multi-select/context.tsx +381 -0
  247. package/components/motion/multi-select/index.tsx +33 -0
  248. package/components/motion/multi-select/list.tsx +239 -0
  249. package/components/motion/multi-select/trigger.tsx +262 -0
  250. package/components/motion/not-found/glitch.tsx +107 -0
  251. package/components/motion/not-found/index.tsx +11 -0
  252. package/components/motion/not-found/magnetic.tsx +57 -0
  253. package/components/motion/not-found/shared.tsx +96 -0
  254. package/components/motion/not-found/spotlight.tsx +86 -0
  255. package/components/motion/not-found/stacked.tsx +77 -0
  256. package/components/motion/not-found/terminal.tsx +83 -0
  257. package/components/motion/notification-stack.tsx +380 -0
  258. package/components/motion/number-field.tsx +178 -0
  259. package/components/motion/number-ticker.tsx +185 -0
  260. package/components/motion/otp-input.tsx +392 -0
  261. package/components/motion/overflow-actions.tsx +375 -0
  262. package/components/motion/page-transition.tsx +92 -0
  263. package/components/motion/pagination.tsx +163 -0
  264. package/components/motion/parallax.tsx +64 -0
  265. package/components/motion/password-input.tsx +165 -0
  266. package/components/motion/phone-input.tsx +181 -0
  267. package/components/motion/popover-morph.tsx +317 -0
  268. package/components/motion/popover-position.ts +86 -0
  269. package/components/motion/popover.tsx +694 -0
  270. package/components/motion/prediction-market.tsx +682 -0
  271. package/components/motion/preview-rail.tsx +390 -0
  272. package/components/motion/progress-ring.tsx +115 -0
  273. package/components/motion/project-folder.tsx +418 -0
  274. package/components/motion/pull-to-refresh.tsx +522 -0
  275. package/components/motion/radio.tsx +148 -0
  276. package/components/motion/range-slider.tsx +93 -0
  277. package/components/motion/rating.tsx +171 -0
  278. package/components/motion/reorder-grid.tsx +123 -0
  279. package/components/motion/resizable-panel.tsx +160 -0
  280. package/components/motion/scroll-progress.tsx +127 -0
  281. package/components/motion/scroll-reveal.tsx +60 -0
  282. package/components/motion/scroll-to.tsx +48 -0
  283. package/components/motion/segmented-control.tsx +130 -0
  284. package/components/motion/segmented-progress.tsx +128 -0
  285. package/components/motion/select.tsx +440 -0
  286. package/components/motion/shader-background.tsx +134 -0
  287. package/components/motion/shared-layout-bg.tsx +151 -0
  288. package/components/motion/signup-form.tsx +467 -0
  289. package/components/motion/slide-action-button.tsx +203 -0
  290. package/components/motion/smooth-scroll.tsx +264 -0
  291. package/components/motion/sortable-list.tsx +98 -0
  292. package/components/motion/speed-dial.tsx +144 -0
  293. package/components/motion/split-text.tsx +115 -0
  294. package/components/motion/spotlight-card.tsx +89 -0
  295. package/components/motion/stepper.tsx +127 -0
  296. package/components/motion/success-check.tsx +142 -0
  297. package/components/motion/swap/constants.ts +2 -0
  298. package/components/motion/swap/controls.tsx +201 -0
  299. package/components/motion/swap/data.ts +186 -0
  300. package/components/motion/swap/field.tsx +115 -0
  301. package/components/motion/swap/quote-row.tsx +46 -0
  302. package/components/motion/swap/token-badges.tsx +83 -0
  303. package/components/motion/swap/token-picker.tsx +219 -0
  304. package/components/motion/swap/types.ts +20 -0
  305. package/components/motion/swap/utils.ts +28 -0
  306. package/components/motion/swap.tsx +182 -0
  307. package/components/motion/swipeable-list.tsx +507 -0
  308. package/components/motion/switch.tsx +96 -0
  309. package/components/motion/table/editable-cell.tsx +22 -0
  310. package/components/motion/table/index.tsx +431 -0
  311. package/components/motion/table/row-handle.tsx +81 -0
  312. package/components/motion/table/skeleton-rows.tsx +39 -0
  313. package/components/motion/table/table-header.tsx +344 -0
  314. package/components/motion/table/table-menu.tsx +129 -0
  315. package/components/motion/table/types.ts +86 -0
  316. package/components/motion/table/use-column-reorder.ts +105 -0
  317. package/components/motion/table/use-column-resize.ts +81 -0
  318. package/components/motion/table/use-column-sort.ts +64 -0
  319. package/components/motion/table/use-row-selection.ts +59 -0
  320. package/components/motion/table/utils.ts +33 -0
  321. package/components/motion/tabs.tsx +207 -0
  322. package/components/motion/text-cascade.tsx +22 -0
  323. package/components/motion/text-reveal.tsx +143 -0
  324. package/components/motion/text-scramble.tsx +84 -0
  325. package/components/motion/text-shimmer.tsx +34 -0
  326. package/components/motion/text-swap.tsx +56 -0
  327. package/components/motion/theme-toggle.tsx +210 -0
  328. package/components/motion/tilt-card.tsx +68 -0
  329. package/components/motion/timeline.tsx +236 -0
  330. package/components/motion/toggle-group.tsx +128 -0
  331. package/components/motion/tooltip.tsx +297 -0
  332. package/components/motion/tree-view.tsx +200 -0
  333. package/components/motion/wallet-card/account-avatar.tsx +21 -0
  334. package/components/motion/wallet-card/account-switcher.tsx +199 -0
  335. package/components/motion/wallet-card/actions.tsx +59 -0
  336. package/components/motion/wallet-card/balance-delta.tsx +69 -0
  337. package/components/motion/wallet-card/constants.ts +18 -0
  338. package/components/motion/wallet-card/copy-button.tsx +58 -0
  339. package/components/motion/wallet-card/index.tsx +151 -0
  340. package/components/motion/wallet-card/search-bar.tsx +198 -0
  341. package/components/motion/wallet-card/types.ts +34 -0
  342. package/components/motion/wallet-card/utils.ts +9 -0
  343. package/components/motion/wheel-picker.tsx +610 -0
  344. package/components/notifications/apple-notification-banner.tsx +155 -0
  345. package/components/notifications/calendar-reminder-notification-banner.tsx +138 -0
  346. package/components/notifications/chat-bubble-notification-banner.tsx +136 -0
  347. package/components/notifications/delivery-notification-banner.tsx +126 -0
  348. package/components/notifications/deploy-notification-banner.tsx +140 -0
  349. package/components/notifications/email-notification-banner.tsx +148 -0
  350. package/components/notifications/incoming-call-notification-banner.tsx +144 -0
  351. package/components/notifications/payment-notification-banner.tsx +137 -0
  352. package/components/notifications/system-alert-banner.tsx +137 -0
  353. package/components/notifications/toast-notification-banner.tsx +130 -0
  354. package/components/others/progress-ring-card.tsx +217 -0
  355. package/components/others/stacked-cards-effect.tsx +62 -0
  356. package/components/others/terminal-log-card.tsx +107 -0
  357. package/components/others/thermal-receipt-card.tsx +132 -0
  358. package/components/others/weather-snapshot-card.tsx +124 -0
  359. package/components/otp/otp-boxed-input.tsx +482 -0
  360. package/components/otp/otp-underline-input.tsx +356 -0
  361. package/components/previews/agents/agent-activity.preview.tsx +136 -0
  362. package/components/previews/agents/ai-sidebar.preview.tsx +236 -0
  363. package/components/previews/agents/chat-app-usage.tsx +689 -0
  364. package/components/previews/agents/chat-app.preview.tsx +130 -0
  365. package/components/previews/agents/chat-preview.tsx +285 -0
  366. package/components/previews/agents/citations.preview.tsx +78 -0
  367. package/components/previews/agents/code-block.preview.tsx +67 -0
  368. package/components/previews/agents/file-diff.preview.tsx +64 -0
  369. package/components/previews/agents/image-generation.preview.tsx +117 -0
  370. package/components/previews/agents/message-bubble.preview.tsx +12 -0
  371. package/components/previews/agents/message-scroller.preview.tsx +70 -0
  372. package/components/previews/agents/message.preview.tsx +14 -0
  373. package/components/previews/agents/prompt-input.preview.tsx +145 -0
  374. package/components/previews/agents/streaming-response.preview.tsx +156 -0
  375. package/components/previews/agents/todo-list.preview.tsx +73 -0
  376. package/components/previews/agents/tool-approval.preview.tsx +80 -0
  377. package/components/previews/agents/use-tool-result-demo.ts +28 -0
  378. package/components/previews/blocks/availability-scheduler.preview.tsx +11 -0
  379. package/components/previews/blocks/bloom-menu.preview.tsx +11 -0
  380. package/components/previews/blocks/card-folder.preview.tsx +105 -0
  381. package/components/previews/blocks/command-palette.preview.tsx +40 -0
  382. package/components/previews/blocks/dynamic-island.preview.tsx +150 -0
  383. package/components/previews/blocks/expandable-action-bar.preview.tsx +136 -0
  384. package/components/previews/blocks/expandable-tabs.preview.tsx +136 -0
  385. package/components/previews/blocks/feedback-widget.preview.tsx +34 -0
  386. package/components/previews/blocks/file-upload.preview.tsx +175 -0
  387. package/components/previews/blocks/infinite-masonry.preview.tsx +145 -0
  388. package/components/previews/blocks/knockout-bracket.preview.tsx +43 -0
  389. package/components/previews/blocks/morphing-search.preview.tsx +59 -0
  390. package/components/previews/blocks/morphing-tabs.preview.tsx +91 -0
  391. package/components/previews/blocks/notification-stack.preview.tsx +39 -0
  392. package/components/previews/blocks/otp-input.preview.tsx +29 -0
  393. package/components/previews/blocks/overflow-actions.preview.tsx +51 -0
  394. package/components/previews/blocks/prediction-market.preview.tsx +41 -0
  395. package/components/previews/blocks/project-folder.preview.tsx +41 -0
  396. package/components/previews/blocks/signup-form.preview.tsx +36 -0
  397. package/components/previews/blocks/swap.preview.tsx +11 -0
  398. package/components/previews/blocks/swipeable-list.preview.tsx +149 -0
  399. package/components/previews/blocks/wallet-card.preview.tsx +36 -0
  400. package/components/previews/motion/action-swap.preview.tsx +82 -0
  401. package/components/previews/motion/adaptive-stepper.preview.tsx +20 -0
  402. package/components/previews/motion/animated-badge.preview.tsx +43 -0
  403. package/components/previews/motion/animated-sidebar.preview.tsx +269 -0
  404. package/components/previews/motion/animated-toast-stack.preview.tsx +151 -0
  405. package/components/previews/motion/bottom-sheet.preview.tsx +35 -0
  406. package/components/previews/motion/bounce-sidebar.preview.tsx +30 -0
  407. package/components/previews/motion/bouncy-accordion.preview.tsx +66 -0
  408. package/components/previews/motion/center-morph-modal.preview.tsx +75 -0
  409. package/components/previews/motion/checkbox.preview.tsx +26 -0
  410. package/components/previews/motion/combobox.preview.tsx +119 -0
  411. package/components/previews/motion/context-menu.preview.tsx +144 -0
  412. package/components/previews/motion/cylinder-carousel.preview.tsx +96 -0
  413. package/components/previews/motion/dock.preview.tsx +46 -0
  414. package/components/previews/motion/drawer.preview.tsx +46 -0
  415. package/components/previews/motion/expandable-control.preview.tsx +27 -0
  416. package/components/previews/motion/expanding-arrow-button.preview.tsx +11 -0
  417. package/components/previews/motion/file-tree.preview.tsx +67 -0
  418. package/components/previews/motion/input.preview.tsx +55 -0
  419. package/components/previews/motion/loader.preview.tsx +36 -0
  420. package/components/previews/motion/marquee.preview.tsx +22 -0
  421. package/components/previews/motion/morphing-modal.preview.tsx +184 -0
  422. package/components/previews/motion/multi-select.preview.tsx +73 -0
  423. package/components/previews/motion/number.preview.tsx +61 -0
  424. package/components/previews/motion/popover.preview.tsx +53 -0
  425. package/components/previews/motion/preview-rail.preview.tsx +108 -0
  426. package/components/previews/motion/pull-to-refresh.preview.tsx +117 -0
  427. package/components/previews/motion/radio.preview.tsx +17 -0
  428. package/components/previews/motion/range-slider.preview.tsx +19 -0
  429. package/components/previews/motion/select.preview.tsx +29 -0
  430. package/components/previews/motion/shader-background.preview.tsx +308 -0
  431. package/components/previews/motion/shared-layout-bg.preview.tsx +33 -0
  432. package/components/previews/motion/switch.preview.tsx +15 -0
  433. package/components/previews/motion/table.preview.tsx +140 -0
  434. package/components/previews/motion/tabs.preview.tsx +49 -0
  435. package/components/previews/motion/text-animation.preview.tsx +63 -0
  436. package/components/previews/motion/theme-toggle.preview.tsx +28 -0
  437. package/components/previews/motion/tilt-card.preview.tsx +15 -0
  438. package/components/previews/motion/tooltip.preview.tsx +34 -0
  439. package/components/previews/motion/wheel-picker.preview.tsx +91 -0
  440. package/components/pricing/retail-price-tag-card.tsx +104 -0
  441. package/components/pricing/toggle-pricing-cards.tsx +209 -0
  442. package/components/profile/contact-profile-card.tsx +100 -0
  443. package/components/profile/editorial-staff-profile-card.tsx +79 -0
  444. package/components/profile/team-member-profile-grid.tsx +159 -0
  445. package/components/profile/user-profile-card.tsx +125 -0
  446. package/components/resources/resource-links-panel.tsx +176 -0
  447. package/components/socials/discord-chat-card.tsx +157 -0
  448. package/components/socials/facebook-post-card.tsx +198 -0
  449. package/components/socials/github-contribution.tsx +716 -0
  450. package/components/socials/github-repo-card.tsx +111 -0
  451. package/components/socials/instagram-post-card.tsx +204 -0
  452. package/components/socials/linked-in-post-card.tsx +213 -0
  453. package/components/socials/linked-in-profile-card.tsx +173 -0
  454. package/components/socials/threads-post-card.tsx +162 -0
  455. package/components/socials/twitter-post-card.tsx +184 -0
  456. package/components/socials/twitter-profile-card.tsx +180 -0
  457. package/components/system/loaders/index.ts +1 -0
  458. package/components/system/loaders/page-loader-overlay.tsx +16 -0
  459. package/components/table/customers-table.tsx +146 -0
  460. package/components/table/orders-table.tsx +195 -0
  461. package/components/table/recent-transactions-table.tsx +125 -0
  462. package/components/table/tasks-table.tsx +163 -0
  463. package/components/table/team-members-table.tsx +155 -0
  464. package/components/table/users-select-table.tsx +184 -0
  465. package/components/text/cafe-menu-board-card.tsx +101 -0
  466. package/components/text/cinema-ticket-card.tsx +99 -0
  467. package/components/text/daily-motivation-card.tsx +80 -0
  468. package/components/text/denim-product-editorial-card.tsx +101 -0
  469. package/components/text/drop-cap-editorial-card.tsx +54 -0
  470. package/components/text/editorial-quote-card.tsx +98 -0
  471. package/components/text/journal-writing-card.tsx +131 -0
  472. package/components/text/keyboard-shortcuts-card.tsx +92 -0
  473. package/components/text/magazine-cover-card.tsx +109 -0
  474. package/components/text/notepad-card.tsx +95 -0
  475. package/components/travel/flight-boarding-card.tsx +177 -0
  476. package/components/travel/travel-postcard-card.tsx +96 -0
  477. package/components/underlines/annotated-text-showcase.tsx +37 -0
  478. package/components/underlines/annotated-text.tsx +471 -0
  479. package/components/users/credit-card-glass.tsx +113 -0
  480. package/components/users/team-member-card.tsx +50 -0
  481. package/components/users/testimonial-card.tsx +239 -0
  482. package/components/wallet/wallet-pass-card.tsx +220 -0
  483. package/components/widgets/analog-clock-widget.tsx +203 -0
  484. package/components/widgets/audio-recorder-widget.tsx +87 -0
  485. package/components/widgets/battery-face-widget.tsx +152 -0
  486. package/components/widgets/blob-profile.tsx +64 -0
  487. package/components/widgets/bluetooth-face-widget.tsx +125 -0
  488. package/components/widgets/compass-widget.tsx +296 -0
  489. package/components/widgets/daily-activity-calendar-widget.tsx +133 -0
  490. package/components/widgets/dnd-face-widget.tsx +129 -0
  491. package/components/widgets/electric-scooter-widget.tsx +88 -0
  492. package/components/widgets/flight-arrival-widget.tsx +76 -0
  493. package/components/widgets/focus-breath-widget.tsx +71 -0
  494. package/components/widgets/heart-rate-widget.tsx +93 -0
  495. package/components/widgets/hydration-widget.tsx +109 -0
  496. package/components/widgets/ios-calendar-widget.tsx +87 -0
  497. package/components/widgets/ios-digital-clock-widget.tsx +192 -0
  498. package/components/widgets/ios-earbuds-widget.tsx +120 -0
  499. package/components/widgets/ios-map-location-widget.tsx +133 -0
  500. package/components/widgets/minimal-agenda-widget.tsx +123 -0
  501. package/components/widgets/pomodoro-widget.tsx +155 -0
  502. package/components/widgets/recorder-face-widget.tsx +146 -0
  503. package/components/widgets/ride-pickup-widget.tsx +72 -0
  504. package/components/widgets/sleep-score-widget.tsx +107 -0
  505. package/components/widgets/step-count-widget.tsx +53 -0
  506. package/components/widgets/stopwatch-widget.tsx +176 -0
  507. package/components/widgets/torch-face-widget.tsx +128 -0
  508. package/components/widgets/voice-assistant-widget.tsx +103 -0
  509. package/components/widgets/wifi-toggle-widget.tsx +108 -0
  510. package/lib/cn.ts +1 -0
  511. package/lib/ease.ts +108 -0
  512. package/lib/favicon.ts +8 -0
  513. package/lib/hooks/use-dismiss.ts +120 -0
  514. package/lib/hooks/use-favicon.ts +39 -0
  515. package/lib/hooks/use-haptic.ts +44 -0
  516. package/lib/hooks/use-hover-capable.ts +23 -0
  517. package/lib/hooks/use-hover-gesture.ts +61 -0
  518. package/lib/hooks/use-in-view-animation.ts +35 -0
  519. package/lib/hooks/use-measure.ts +39 -0
  520. package/lib/hooks/use-on-open.ts +24 -0
  521. package/lib/hooks/use-row-cursor.ts +86 -0
  522. package/lib/hooks/use-slider.ts +176 -0
  523. package/lib/hooks/use-tap-gesture.ts +66 -0
  524. package/lib/hooks/use-touch-capable.ts +31 -0
  525. package/lib/presence-gate.tsx +52 -0
  526. package/lib/styles.ts +124 -0
  527. package/lib/text-shimmer.ts +21 -0
  528. package/lib/tick-sound.ts +151 -0
  529. package/lib/touch.ts +117 -0
  530. package/lib/utils.ts +6 -0
  531. package/package.json +49 -0
  532. package/references/agents/agent-activity.md +747 -0
  533. package/references/agents/ai-sidebar.md +293 -0
  534. package/references/agents/approval-card.md +233 -0
  535. package/references/agents/chat-app.md +184 -0
  536. package/references/agents/citations.md +159 -0
  537. package/references/agents/code-block.md +122 -0
  538. package/references/agents/file-diff.md +119 -0
  539. package/references/agents/image-generation.md +173 -0
  540. package/references/agents/loading-states.md +186 -0
  541. package/references/agents/message-bubble.md +274 -0
  542. package/references/agents/message-scroller.md +128 -0
  543. package/references/agents/message.md +162 -0
  544. package/references/agents/prompt-input.md +204 -0
  545. package/references/agents/streaming-response.md +216 -0
  546. package/references/agents/todo-list.md +123 -0
  547. package/references/agents/tool-approval.md +143 -0
  548. package/references/agents/tool-result.md +199 -0
  549. package/references/blocks/availability-scheduler.md +59 -0
  550. package/references/blocks/bloom-menu.md +56 -0
  551. package/references/blocks/card-folder.md +165 -0
  552. package/references/blocks/command-palette.md +89 -0
  553. package/references/blocks/dynamic-island.md +203 -0
  554. package/references/blocks/expandable-action-bar.md +191 -0
  555. package/references/blocks/expandable-tabs.md +184 -0
  556. package/references/blocks/feedback-widget.md +82 -0
  557. package/references/blocks/file-upload.md +406 -0
  558. package/references/blocks/infinite-masonry.md +211 -0
  559. package/references/blocks/knockout-bracket.md +161 -0
  560. package/references/blocks/morphing-search.md +113 -0
  561. package/references/blocks/morphing-tabs.md +143 -0
  562. package/references/blocks/not-found.md +228 -0
  563. package/references/blocks/notification-stack.md +92 -0
  564. package/references/blocks/otp-input.md +85 -0
  565. package/references/blocks/overflow-actions.md +105 -0
  566. package/references/blocks/prediction-market.md +97 -0
  567. package/references/blocks/project-folder.md +99 -0
  568. package/references/blocks/signup-form.md +92 -0
  569. package/references/blocks/swap.md +58 -0
  570. package/references/blocks/swipeable-list.md +202 -0
  571. package/references/blocks/wallet-card.md +97 -0
  572. package/references/codex-install.md +59 -0
  573. package/references/craft/3d-button.md +51 -0
  574. package/references/craft/3d-icon-button.md +51 -0
  575. package/references/craft/add-to-cart-button.md +52 -0
  576. package/references/craft/analog-clock-minimal.md +51 -0
  577. package/references/craft/analog-clock-numeric.md +51 -0
  578. package/references/craft/analog-clock-roman.md +51 -0
  579. package/references/craft/annotated-text.md +51 -0
  580. package/references/craft/app-dock.md +52 -0
  581. package/references/craft/apple-hello-loader.md +51 -0
  582. package/references/craft/apple-notification.md +53 -0
  583. package/references/craft/apple-watch.md +51 -0
  584. package/references/craft/arc-bands-background.md +51 -0
  585. package/references/craft/audio-recorder.md +52 -0
  586. package/references/craft/aurora-background.md +51 -0
  587. package/references/craft/battery-face.md +52 -0
  588. package/references/craft/blob-profile.md +53 -0
  589. package/references/craft/bluetooth-face.md +52 -0
  590. package/references/craft/booking-slot-calendar.md +52 -0
  591. package/references/craft/bookmark-save-button.md +52 -0
  592. package/references/craft/browser.md +51 -0
  593. package/references/craft/cafe-menu-board.md +52 -0
  594. package/references/craft/calendar-reminder-notification.md +52 -0
  595. package/references/craft/chat-bubble-notification.md +53 -0
  596. package/references/craft/checkbox-field-input.md +52 -0
  597. package/references/craft/cherry-petal-background.md +51 -0
  598. package/references/craft/cinder-latch-button.md +51 -0
  599. package/references/craft/cinema-ticket.md +52 -0
  600. package/references/craft/circle-cut-frame.md +51 -0
  601. package/references/craft/combobox-field-input.md +52 -0
  602. package/references/craft/compass.md +51 -0
  603. package/references/craft/contact-form.md +52 -0
  604. package/references/craft/contact-profile.md +52 -0
  605. package/references/craft/copy-email.md +53 -0
  606. package/references/craft/coral-glow-background.md +51 -0
  607. package/references/craft/craft-copy-button.md +52 -0
  608. package/references/craft/craft-signup-form.md +53 -0
  609. package/references/craft/credit-card-glass.md +51 -0
  610. package/references/craft/customers-table.md +52 -0
  611. package/references/craft/daily-activity-calendar.md +52 -0
  612. package/references/craft/daily-motivation.md +53 -0
  613. package/references/craft/dark-arc-bands-background.md +51 -0
  614. package/references/craft/dark-aurora-background.md +51 -0
  615. package/references/craft/dark-carbon-spotlight-background.md +51 -0
  616. package/references/craft/dark-ember-background.md +51 -0
  617. package/references/craft/dark-ink-field-background.md +51 -0
  618. package/references/craft/dark-midnight-mesh-background.md +51 -0
  619. package/references/craft/dark-rose-noir-background.md +51 -0
  620. package/references/craft/dark-teal-depth-background.md +51 -0
  621. package/references/craft/date-field-input.md +52 -0
  622. package/references/craft/date-range-picker-card.md +52 -0
  623. package/references/craft/delivery-notification.md +52 -0
  624. package/references/craft/denim-product-editorial.md +52 -0
  625. package/references/craft/deploy-notification.md +52 -0
  626. package/references/craft/depth-outline-button.md +51 -0
  627. package/references/craft/diagonal-box-pattern.md +51 -0
  628. package/references/craft/dimple-switch.md +51 -0
  629. package/references/craft/discord-chat.md +53 -0
  630. package/references/craft/dnd-face.md +52 -0
  631. package/references/craft/dot-grid-pattern.md +51 -0
  632. package/references/craft/download-button.md +52 -0
  633. package/references/craft/drop-cap-editorial.md +52 -0
  634. package/references/craft/editor-tool-dock.md +52 -0
  635. package/references/craft/editorial-quote.md +52 -0
  636. package/references/craft/editorial-staff-profile.md +51 -0
  637. package/references/craft/electric-scooter.md +53 -0
  638. package/references/craft/email-notification.md +53 -0
  639. package/references/craft/event-countdown-card.md +51 -0
  640. package/references/craft/event-ticket.md +53 -0
  641. package/references/craft/facebook-post.md +53 -0
  642. package/references/craft/file-menu.md +52 -0
  643. package/references/craft/file-upload-field-input.md +52 -0
  644. package/references/craft/film-strip.md +52 -0
  645. package/references/craft/filter-sort.md +52 -0
  646. package/references/craft/fine-grain-pattern.md +51 -0
  647. package/references/craft/flight-arrival.md +52 -0
  648. package/references/craft/flight-boarding.md +52 -0
  649. package/references/craft/floating-label-field-input.md +51 -0
  650. package/references/craft/focus-breath.md +51 -0
  651. package/references/craft/folder-tab-card.md +52 -0
  652. package/references/craft/follow-button.md +52 -0
  653. package/references/craft/forgot-password-form.md +53 -0
  654. package/references/craft/frost-mesh-background.md +51 -0
  655. package/references/craft/gallery-grid.md +53 -0
  656. package/references/craft/gallery-wall.md +52 -0
  657. package/references/craft/github-contribution.md +52 -0
  658. package/references/craft/github-repo.md +52 -0
  659. package/references/craft/glass-overlay-image.md +53 -0
  660. package/references/craft/graph-paper-pattern.md +51 -0
  661. package/references/craft/halftone-pop-background.md +51 -0
  662. package/references/craft/hard-shadow-polaroid-frame.md +51 -0
  663. package/references/craft/heart-rate.md +52 -0
  664. package/references/craft/hold-to-delete-button.md +52 -0
  665. package/references/craft/honey-ember-background.md +51 -0
  666. package/references/craft/hydration.md +51 -0
  667. package/references/craft/incoming-call-notification.md +53 -0
  668. package/references/craft/ink-stamp-document.md +52 -0
  669. package/references/craft/ink-wash-background.md +51 -0
  670. package/references/craft/input-group-field.md +51 -0
  671. package/references/craft/inset-button.md +51 -0
  672. package/references/craft/instagram-post.md +53 -0
  673. package/references/craft/ios-calendar-widget.md +51 -0
  674. package/references/craft/ios-digital-clock.md +51 -0
  675. package/references/craft/ios-earbuds.md +51 -0
  676. package/references/craft/ios-map-location.md +51 -0
  677. package/references/craft/ipad.md +51 -0
  678. package/references/craft/ipod.md +51 -0
  679. package/references/craft/journal-writing.md +52 -0
  680. package/references/craft/kebab-actions.md +52 -0
  681. package/references/craft/keyboard-shortcuts.md +52 -0
  682. package/references/craft/laptop.md +51 -0
  683. package/references/craft/like-button.md +52 -0
  684. package/references/craft/line-grid-pattern.md +51 -0
  685. package/references/craft/linen-tab-button.md +51 -0
  686. package/references/craft/linen-weave-background.md +51 -0
  687. package/references/craft/linked-in-post.md +53 -0
  688. package/references/craft/linked-in-profile.md +52 -0
  689. package/references/craft/login-form.md +53 -0
  690. package/references/craft/mac-dock.md +52 -0
  691. package/references/craft/magazine-cover.md +53 -0
  692. package/references/craft/minimal-agenda.md +52 -0
  693. package/references/craft/mint-lagoon-background.md +51 -0
  694. package/references/craft/month-picker-calendar.md +52 -0
  695. package/references/craft/museum-placard.md +51 -0
  696. package/references/craft/music-player.md +53 -0
  697. package/references/craft/music-playlist.md +53 -0
  698. package/references/craft/newsletter-form.md +52 -0
  699. package/references/craft/notepad.md +52 -0
  700. package/references/craft/notification.md +52 -0
  701. package/references/craft/now-playing-bar.md +53 -0
  702. package/references/craft/orders-table.md +52 -0
  703. package/references/craft/otp-boxed-input.md +52 -0
  704. package/references/craft/otp-underline-input.md +51 -0
  705. package/references/craft/page-loader-overlay.md +46 -0
  706. package/references/craft/paper-fold-background.md +51 -0
  707. package/references/craft/password-field-input.md +52 -0
  708. package/references/craft/payment-notification.md +52 -0
  709. package/references/craft/phone-field-input.md +51 -0
  710. package/references/craft/phone.md +51 -0
  711. package/references/craft/photo-album.md +52 -0
  712. package/references/craft/photo-contact-sheet.md +52 -0
  713. package/references/craft/polaroid-image.md +52 -0
  714. package/references/craft/pomodoro.md +52 -0
  715. package/references/craft/presence-dock.md +51 -0
  716. package/references/craft/prism-depth-button.md +51 -0
  717. package/references/craft/progress-ring-card.md +51 -0
  718. package/references/craft/quantity-stepper-button.md +52 -0
  719. package/references/craft/radio-group-field-input.md +51 -0
  720. package/references/craft/rain-prism-background.md +51 -0
  721. package/references/craft/recent-transactions-table.md +52 -0
  722. package/references/craft/recorder-face.md +52 -0
  723. package/references/craft/resource-links-panel.md +52 -0
  724. package/references/craft/retail-price-tag.md +51 -0
  725. package/references/craft/reverse-diagonal-box-pattern.md +51 -0
  726. package/references/craft/ride-pickup.md +53 -0
  727. package/references/craft/sand-drift-background.md +51 -0
  728. package/references/craft/search-input.md +52 -0
  729. package/references/craft/segmented-toggle-button.md +51 -0
  730. package/references/craft/select-field-input.md +52 -0
  731. package/references/craft/share-menu.md +52 -0
  732. package/references/craft/sheen-pill-button.md +51 -0
  733. package/references/craft/slate-chip-switch.md +51 -0
  734. package/references/craft/sleep-score.md +52 -0
  735. package/references/craft/slide-to-confirm-button.md +52 -0
  736. package/references/craft/slow-living-polaroid.md +52 -0
  737. package/references/craft/soft-pill-button.md +51 -0
  738. package/references/craft/soft-spotlight-background.md +51 -0
  739. package/references/craft/soft-ui-button.md +51 -0
  740. package/references/craft/spin-loader.md +52 -0
  741. package/references/craft/spotlight-bar.md +52 -0
  742. package/references/craft/stacked-cards-effect.md +52 -0
  743. package/references/craft/stacked-folder-card.md +52 -0
  744. package/references/craft/stamp-postcard.md +52 -0
  745. package/references/craft/step-count.md +51 -0
  746. package/references/craft/sticky-note-polaroid-frame.md +51 -0
  747. package/references/craft/stopwatch.md +52 -0
  748. package/references/craft/sunrise-horizon-background.md +51 -0
  749. package/references/craft/sunset-bloom-background.md +51 -0
  750. package/references/craft/switch-field-input.md +51 -0
  751. package/references/craft/system-alert.md +52 -0
  752. package/references/craft/tasks-table.md +53 -0
  753. package/references/craft/team-member-profile-grid.md +52 -0
  754. package/references/craft/team-member.md +53 -0
  755. package/references/craft/team-members-table.md +53 -0
  756. package/references/craft/terminal-log.md +52 -0
  757. package/references/craft/terrazzo-fragment-background.md +51 -0
  758. package/references/craft/testimonial.md +53 -0
  759. package/references/craft/text-field-input.md +51 -0
  760. package/references/craft/text-loader.md +51 -0
  761. package/references/craft/textarea-field-input.md +51 -0
  762. package/references/craft/thermal-receipt.md +52 -0
  763. package/references/craft/threads-post.md +53 -0
  764. package/references/craft/toast-notification.md +52 -0
  765. package/references/craft/toggle-pricing-cards.md +52 -0
  766. package/references/craft/torch-face.md +52 -0
  767. package/references/craft/transform-box-frame.md +51 -0
  768. package/references/craft/transform-plus-frame.md +51 -0
  769. package/references/craft/travel-postcard.md +53 -0
  770. package/references/craft/tropical-tide-background.md +51 -0
  771. package/references/craft/twitter-post.md +53 -0
  772. package/references/craft/twitter-profile.md +53 -0
  773. package/references/craft/user-menu.md +53 -0
  774. package/references/craft/user-profile.md +53 -0
  775. package/references/craft/users-select-table.md +53 -0
  776. package/references/craft/voice-assistant.md +52 -0
  777. package/references/craft/wallet-pass.md +52 -0
  778. package/references/craft/weather-snapshot.md +52 -0
  779. package/references/craft/week-strip-calendar.md +52 -0
  780. package/references/craft/wifi-toggle.md +52 -0
  781. package/references/craft/workspace-switcher.md +52 -0
  782. package/references/guides/baseline-ui-craft.md +61 -0
  783. package/references/guides/craft-surface-design-system.md +120 -0
  784. package/references/guides/design-system-checklist.md +98 -0
  785. package/references/guides/enterprise-dashboard-patterns.md +53 -0
  786. package/references/guides/interaction-transitions.md +71 -0
  787. package/references/guides/motion-engineering.md +137 -0
  788. package/references/guides/motion-patterns.md +106 -0
  789. package/references/guides/motion-performance.md +66 -0
  790. package/references/guides/style-presets.md +115 -0
  791. package/references/guides/universal-mobile-patterns.md +72 -0
  792. package/references/motion/action-sheet.md +98 -0
  793. package/references/motion/action-swap.md +339 -0
  794. package/references/motion/adaptive-stepper.md +95 -0
  795. package/references/motion/animated-badge.md +92 -0
  796. package/references/motion/animated-sidebar.md +446 -0
  797. package/references/motion/animated-toast-stack.md +214 -0
  798. package/references/motion/aspect-ratio.md +59 -0
  799. package/references/motion/audio-player.md +59 -0
  800. package/references/motion/autocomplete.md +69 -0
  801. package/references/motion/avatar-group.md +93 -0
  802. package/references/motion/bottom-sheet.md +85 -0
  803. package/references/motion/bounce-sidebar.md +80 -0
  804. package/references/motion/bouncy-accordion.md +115 -0
  805. package/references/motion/breadcrumb.md +62 -0
  806. package/references/motion/button.md +271 -0
  807. package/references/motion/card-resize.md +60 -0
  808. package/references/motion/cascader.md +99 -0
  809. package/references/motion/center-morph-modal.md +133 -0
  810. package/references/motion/checkbox.md +76 -0
  811. package/references/motion/chip.md +81 -0
  812. package/references/motion/collapsible.md +73 -0
  813. package/references/motion/color-picker.md +57 -0
  814. package/references/motion/combobox.md +247 -0
  815. package/references/motion/confetti.md +65 -0
  816. package/references/motion/context-menu.md +269 -0
  817. package/references/motion/copy-button.md +59 -0
  818. package/references/motion/cylinder-carousel.md +151 -0
  819. package/references/motion/date-range-picker.md +68 -0
  820. package/references/motion/dock.md +105 -0
  821. package/references/motion/drawer.md +94 -0
  822. package/references/motion/error-shake.md +85 -0
  823. package/references/motion/event-calendar.md +81 -0
  824. package/references/motion/expandable-control.md +89 -0
  825. package/references/motion/expanding-arrow-button.md +178 -0
  826. package/references/motion/file-tree.md +139 -0
  827. package/references/motion/filter-builder.md +106 -0
  828. package/references/motion/frame.md +61 -0
  829. package/references/motion/gantt.md +61 -0
  830. package/references/motion/glow-button.md +59 -0
  831. package/references/motion/haptic-pressable.md +64 -0
  832. package/references/motion/hover-card.md +86 -0
  833. package/references/motion/icon-stack.md +64 -0
  834. package/references/motion/input.md +108 -0
  835. package/references/motion/kanban.md +111 -0
  836. package/references/motion/kbd.md +66 -0
  837. package/references/motion/loader.md +82 -0
  838. package/references/motion/magnet-dock.md +64 -0
  839. package/references/motion/marquee.md +68 -0
  840. package/references/motion/metric-card.md +81 -0
  841. package/references/motion/morphing-modal.md +230 -0
  842. package/references/motion/multi-select.md +202 -0
  843. package/references/motion/number-field.md +70 -0
  844. package/references/motion/number.md +198 -0
  845. package/references/motion/page-transition.md +78 -0
  846. package/references/motion/pagination.md +64 -0
  847. package/references/motion/password-input.md +77 -0
  848. package/references/motion/phone-input.md +63 -0
  849. package/references/motion/popover.md +209 -0
  850. package/references/motion/preview-rail.md +165 -0
  851. package/references/motion/progress-ring.md +73 -0
  852. package/references/motion/pull-to-refresh.md +172 -0
  853. package/references/motion/radio.md +73 -0
  854. package/references/motion/range-slider.md +290 -0
  855. package/references/motion/rating.md +69 -0
  856. package/references/motion/reorder-grid.md +69 -0
  857. package/references/motion/resizable-panel.md +75 -0
  858. package/references/motion/scroll-animation.md +397 -0
  859. package/references/motion/segmented-control.md +68 -0
  860. package/references/motion/segmented-progress.md +70 -0
  861. package/references/motion/select.md +196 -0
  862. package/references/motion/shader-background.md +351 -0
  863. package/references/motion/shared-layout-bg.md +80 -0
  864. package/references/motion/sortable-list.md +62 -0
  865. package/references/motion/speed-dial.md +63 -0
  866. package/references/motion/split-text.md +62 -0
  867. package/references/motion/spotlight-card.md +67 -0
  868. package/references/motion/stepper.md +83 -0
  869. package/references/motion/success-check.md +67 -0
  870. package/references/motion/switch.md +62 -0
  871. package/references/motion/table.md +519 -0
  872. package/references/motion/tabs.md +116 -0
  873. package/references/motion/text-animation.md +285 -0
  874. package/references/motion/text-swap.md +64 -0
  875. package/references/motion/theme-toggle.md +82 -0
  876. package/references/motion/tilt-card.md +59 -0
  877. package/references/motion/timeline.md +85 -0
  878. package/references/motion/toggle-group.md +70 -0
  879. package/references/motion/tooltip.md +82 -0
  880. package/references/motion/tree-view.md +87 -0
  881. package/references/motion/wheel-picker.md +142 -0
  882. package/scripts/build_docs.py +557 -0
  883. package/scripts/install-component.py +232 -0
  884. package/scripts/test_release.py +119 -0
  885. package/scripts/updater.mjs +9 -0
  886. package/scripts/verify_skill.py +84 -0
@@ -0,0 +1,981 @@
1
+ "use client";
2
+
3
+ import {
4
+ ArrowDown,
5
+ ArrowUp,
6
+ Bookmark,
7
+ FileText,
8
+ Folder,
9
+ FolderInput,
10
+ FolderOpen,
11
+ type LucideIcon,
12
+ MoreHorizontal,
13
+ Pencil,
14
+ Undo2,
15
+ } from "lucide-react";
16
+ import { AnimatePresence, motion, useReducedMotion } from "motion/react";
17
+ import {
18
+ type DragEvent,
19
+ type KeyboardEvent,
20
+ type ReactNode,
21
+ useCallback,
22
+ useEffect,
23
+ useMemo,
24
+ useRef,
25
+ useState,
26
+ } from "react";
27
+ import {
28
+ MorphPopover,
29
+ MorphPopoverContent,
30
+ MorphPopoverTrigger,
31
+ } from "@/components/motion/popover-morph";
32
+ import { EASE_OUT, SPRING_LAYOUT } from "@/lib/ease";
33
+ import { useTouchCapable } from "@/lib/hooks/use-touch-capable";
34
+ import { cn } from "@/lib/utils";
35
+
36
+ export type SidebarResourceKind =
37
+ | "folder"
38
+ | "project"
39
+ | "file"
40
+ | "bookmark";
41
+
42
+ export interface SidebarResource {
43
+ id: string;
44
+ label: string;
45
+ kind: SidebarResourceKind;
46
+ children?: SidebarResource[];
47
+ disabled?: boolean;
48
+ }
49
+
50
+ export type SidebarResourceDropPosition = "before" | "inside" | "after";
51
+
52
+ export interface SidebarResourceMove {
53
+ itemId: string;
54
+ targetId: string | null;
55
+ position: SidebarResourceDropPosition;
56
+ }
57
+
58
+ /**
59
+ * The moves this row can make right now, the same four the keyboard offers on
60
+ * `Alt+Shift+Arrow`. A pointer drag is the fast path for them; a finger has no
61
+ * drag to give, so the row menu carries them too. Absent keys are moves this
62
+ * row cannot make from where it sits.
63
+ */
64
+ export interface SidebarResourceMoveCommands {
65
+ up?: () => void;
66
+ down?: () => void;
67
+ into?: { label: string; run: () => void };
68
+ out?: () => void;
69
+ }
70
+
71
+ export interface SidebarResourceMenuControls {
72
+ close: () => void;
73
+ rename: () => void;
74
+ moves: SidebarResourceMoveCommands;
75
+ }
76
+
77
+ export interface AISidebarProps {
78
+ items?: SidebarResource[];
79
+ defaultItems?: SidebarResource[];
80
+ onItemsChange?: (items: SidebarResource[]) => void;
81
+ /** Reject the promise to roll the optimistic move back. */
82
+ onMove?: (move: SidebarResourceMove) => void | Promise<void>;
83
+ onMoveError?: (error: unknown, move: SidebarResourceMove) => void;
84
+ onRename?: (item: SidebarResource, label: string) => void | Promise<void>;
85
+ activeId?: string | null;
86
+ defaultActiveId?: string | null;
87
+ onActiveChange?: (id: string) => void;
88
+ defaultExpandedIds?: string[];
89
+ renderIcon?: (item: SidebarResource) => ReactNode;
90
+ renderMenu?: (
91
+ item: SidebarResource,
92
+ controls: SidebarResourceMenuControls,
93
+ ) => ReactNode;
94
+ ariaLabel?: string;
95
+ className?: string;
96
+ }
97
+
98
+ interface FlatResource {
99
+ item: SidebarResource;
100
+ depth: number;
101
+ parentId: string | null;
102
+ }
103
+
104
+ interface DropTarget {
105
+ id: string | null;
106
+ position: SidebarResourceDropPosition;
107
+ }
108
+
109
+ const ROW_REVEAL = {
110
+ duration: 0.16,
111
+ ease: EASE_OUT,
112
+ } as const;
113
+
114
+ function canContain(item: SidebarResource) {
115
+ return item.kind === "folder" || item.kind === "project";
116
+ }
117
+
118
+ function flattenResources(
119
+ items: SidebarResource[],
120
+ expanded: Set<string>,
121
+ depth = 0,
122
+ parentId: string | null = null,
123
+ ): FlatResource[] {
124
+ return items.flatMap((item) => {
125
+ const row = { item, depth, parentId };
126
+ if (!item.children?.length || !expanded.has(item.id)) return [row];
127
+ return [
128
+ row,
129
+ ...flattenResources(item.children, expanded, depth + 1, item.id),
130
+ ];
131
+ });
132
+ }
133
+
134
+ function findResource(
135
+ items: SidebarResource[],
136
+ id: string,
137
+ ): SidebarResource | undefined {
138
+ for (const item of items) {
139
+ if (item.id === id) return item;
140
+ const child = item.children ? findResource(item.children, id) : undefined;
141
+ if (child) return child;
142
+ }
143
+ }
144
+
145
+ function containsResource(item: SidebarResource, id: string): boolean {
146
+ return (
147
+ item.id === id ||
148
+ item.children?.some((child) => containsResource(child, id)) === true
149
+ );
150
+ }
151
+
152
+ function removeResource(
153
+ items: SidebarResource[],
154
+ id: string,
155
+ ): { items: SidebarResource[]; removed?: SidebarResource } {
156
+ let removed: SidebarResource | undefined;
157
+ const next: SidebarResource[] = [];
158
+
159
+ for (const item of items) {
160
+ if (item.id === id) {
161
+ removed = item;
162
+ continue;
163
+ }
164
+
165
+ if (item.children?.length) {
166
+ const childResult = removeResource(item.children, id);
167
+ if (childResult.removed) {
168
+ removed = childResult.removed;
169
+ next.push({ ...item, children: childResult.items });
170
+ continue;
171
+ }
172
+ }
173
+
174
+ next.push(item);
175
+ }
176
+
177
+ return { items: next, removed };
178
+ }
179
+
180
+ function insertResource(
181
+ items: SidebarResource[],
182
+ resource: SidebarResource,
183
+ targetId: string | null,
184
+ position: SidebarResourceDropPosition,
185
+ ): SidebarResource[] {
186
+ if (targetId === null) return [...items, resource];
187
+
188
+ const next: SidebarResource[] = [];
189
+ for (const item of items) {
190
+ if (item.id === targetId) {
191
+ if (position === "before") next.push(resource, item);
192
+ else if (position === "after") next.push(item, resource);
193
+ else next.push({ ...item, children: [...(item.children ?? []), resource] });
194
+ continue;
195
+ }
196
+
197
+ if (item.children?.length) {
198
+ next.push({
199
+ ...item,
200
+ children: insertResource(item.children, resource, targetId, position),
201
+ });
202
+ } else {
203
+ next.push(item);
204
+ }
205
+ }
206
+ return next;
207
+ }
208
+
209
+ function moveResource(
210
+ items: SidebarResource[],
211
+ move: SidebarResourceMove,
212
+ ): SidebarResource[] | null {
213
+ const source = findResource(items, move.itemId);
214
+ if (!source || source.disabled) return null;
215
+ if (move.targetId && containsResource(source, move.targetId)) return null;
216
+
217
+ const target = move.targetId ? findResource(items, move.targetId) : undefined;
218
+ if (
219
+ move.position === "inside" &&
220
+ (!target || target.disabled || !canContain(target))
221
+ )
222
+ return null;
223
+
224
+ const removed = removeResource(items, move.itemId);
225
+ if (!removed.removed) return null;
226
+ return insertResource(
227
+ removed.items,
228
+ removed.removed,
229
+ move.targetId,
230
+ move.position,
231
+ );
232
+ }
233
+
234
+ function renameResource(
235
+ items: SidebarResource[],
236
+ id: string,
237
+ label: string,
238
+ ): SidebarResource[] {
239
+ return items.map((item) => ({
240
+ ...item,
241
+ label: item.id === id ? label : item.label,
242
+ children: item.children
243
+ ? renameResource(item.children, id, label)
244
+ : undefined,
245
+ }));
246
+ }
247
+
248
+ function defaultIcon(item: SidebarResource, expanded: boolean) {
249
+ const Icon =
250
+ item.kind === "folder" || item.kind === "project"
251
+ ? expanded
252
+ ? FolderOpen
253
+ : Folder
254
+ : item.kind === "bookmark"
255
+ ? Bookmark
256
+ : FileText;
257
+ return <Icon className="size-4" />;
258
+ }
259
+
260
+ function MarqueeLabel({ active, children }: { active: boolean; children: string }) {
261
+ const reduce = useReducedMotion() ?? false;
262
+ const viewportRef = useRef<HTMLSpanElement>(null);
263
+ const labelRef = useRef<HTMLSpanElement>(null);
264
+ const [distance, setDistance] = useState(0);
265
+
266
+ useEffect(() => {
267
+ const measure = () => {
268
+ const viewport = viewportRef.current;
269
+ const label = labelRef.current;
270
+ if (!viewport || !label) return;
271
+ setDistance(label.scrollWidth > viewport.clientWidth ? label.scrollWidth + 24 : 0);
272
+ };
273
+ measure();
274
+ const observer = new ResizeObserver(measure);
275
+ if (viewportRef.current) observer.observe(viewportRef.current);
276
+ if (labelRef.current) observer.observe(labelRef.current);
277
+ return () => observer.disconnect();
278
+ }, []);
279
+
280
+ const running = active && distance > 0 && !reduce;
281
+
282
+ return (
283
+ <span ref={viewportRef} className="block min-w-0 flex-1 overflow-hidden">
284
+ <motion.span
285
+ className="flex w-max items-center gap-6 whitespace-nowrap"
286
+ animate={{ x: running ? [0, -distance] : 0 }}
287
+ transition={
288
+ running
289
+ ? {
290
+ duration: Math.max(2.4, distance / 34),
291
+ ease: "linear",
292
+ repeat: Number.POSITIVE_INFINITY,
293
+ repeatDelay: 2,
294
+ }
295
+ : ROW_REVEAL
296
+ }
297
+ >
298
+ <span ref={labelRef}>{children}</span>
299
+ {running ? <span aria-hidden="true">{children}</span> : null}
300
+ </motion.span>
301
+ </span>
302
+ );
303
+ }
304
+
305
+ function ResourceMenuAction({
306
+ icon: Icon,
307
+ onSelect,
308
+ children,
309
+ }: {
310
+ icon: LucideIcon;
311
+ onSelect: () => void;
312
+ children: ReactNode;
313
+ }) {
314
+ return (
315
+ <button
316
+ type="button"
317
+ onClick={onSelect}
318
+ className="flex h-8 w-full items-center gap-2 rounded-lg px-2.5 text-left text-xs text-foreground outline-none transition-colors hover:bg-muted focus-visible:bg-muted focus-visible:ring-2 focus-visible:ring-ring"
319
+ >
320
+ <Icon aria-hidden="true" className="size-3.5 shrink-0" />
321
+ <span className="min-w-0 truncate">{children}</span>
322
+ </button>
323
+ );
324
+ }
325
+
326
+ interface ResourceRowProps {
327
+ row: FlatResource;
328
+ active: boolean;
329
+ expanded: boolean;
330
+ focused: boolean;
331
+ draggingId: string | null;
332
+ dropTarget: DropTarget | null;
333
+ menuOpen: boolean;
334
+ moves: SidebarResourceMoveCommands;
335
+ renaming: boolean;
336
+ onDragEnd: () => void;
337
+ onDragOver: (event: DragEvent<HTMLDivElement>, row: FlatResource) => void;
338
+ onDragStart: (event: DragEvent<HTMLDivElement>, id: string) => void;
339
+ onDrop: (event: DragEvent<HTMLDivElement>) => void;
340
+ onFocus: () => void;
341
+ onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
342
+ onMenuOpenChange: (open: boolean) => void;
343
+ onRenameCancel: () => void;
344
+ onRenameCommit: (label: string) => void;
345
+ onRenameStart: () => void;
346
+ onSelect: () => void;
347
+ onToggle: () => void;
348
+ renderIcon?: (item: SidebarResource) => ReactNode;
349
+ renderMenu?: AISidebarProps["renderMenu"];
350
+ setRef: (node: HTMLDivElement | null) => void;
351
+ }
352
+
353
+ function ResourceRow({
354
+ row,
355
+ active,
356
+ expanded,
357
+ focused,
358
+ draggingId,
359
+ dropTarget,
360
+ menuOpen,
361
+ moves,
362
+ renaming,
363
+ onDragEnd,
364
+ onDragOver,
365
+ onDragStart,
366
+ onDrop,
367
+ onFocus,
368
+ onKeyDown,
369
+ onMenuOpenChange,
370
+ onRenameCancel,
371
+ onRenameCommit,
372
+ onRenameStart,
373
+ onSelect,
374
+ onToggle,
375
+ renderIcon,
376
+ renderMenu,
377
+ setRef,
378
+ }: ResourceRowProps) {
379
+ const reduce = useReducedMotion() ?? false;
380
+ const canTouch = useTouchCapable();
381
+ const [hovered, setHovered] = useState(false);
382
+ const inputRef = useRef<HTMLInputElement>(null);
383
+ const skipRenameBlurRef = useRef(false);
384
+ const draggedRef = useRef(false);
385
+ const [draft, setDraft] = useState(row.item.label);
386
+ const acceptsChildren = canContain(row.item);
387
+ const isDragging = draggingId === row.item.id;
388
+ const dropPosition = dropTarget?.id === row.item.id ? dropTarget.position : null;
389
+
390
+ useEffect(() => {
391
+ if (!renaming) return;
392
+ skipRenameBlurRef.current = false;
393
+ setDraft(row.item.label);
394
+ requestAnimationFrame(() => {
395
+ inputRef.current?.focus();
396
+ inputRef.current?.select();
397
+ });
398
+ }, [renaming, row.item.label]);
399
+
400
+ const runFromMenu = (action: () => void) => () => {
401
+ onMenuOpenChange(false);
402
+ action();
403
+ };
404
+
405
+ const menu = renderMenu?.(row.item, {
406
+ close: () => onMenuOpenChange(false),
407
+ rename: () => {
408
+ onMenuOpenChange(false);
409
+ onRenameStart();
410
+ },
411
+ moves,
412
+ }) ?? (
413
+ <>
414
+ <ResourceMenuAction icon={Pencil} onSelect={runFromMenu(onRenameStart)}>
415
+ Rename
416
+ </ResourceMenuAction>
417
+ {moves.up || moves.down || moves.into || moves.out ? (
418
+ <div aria-hidden="true" className="my-1 h-px bg-border" />
419
+ ) : null}
420
+ {moves.up ? (
421
+ <ResourceMenuAction icon={ArrowUp} onSelect={runFromMenu(moves.up)}>
422
+ Move up
423
+ </ResourceMenuAction>
424
+ ) : null}
425
+ {moves.down ? (
426
+ <ResourceMenuAction icon={ArrowDown} onSelect={runFromMenu(moves.down)}>
427
+ Move down
428
+ </ResourceMenuAction>
429
+ ) : null}
430
+ {moves.into ? (
431
+ <ResourceMenuAction
432
+ icon={FolderInput}
433
+ onSelect={runFromMenu(moves.into.run)}
434
+ >
435
+ Move into {moves.into.label}
436
+ </ResourceMenuAction>
437
+ ) : null}
438
+ {moves.out ? (
439
+ <ResourceMenuAction icon={Undo2} onSelect={runFromMenu(moves.out)}>
440
+ Move out
441
+ </ResourceMenuAction>
442
+ ) : null}
443
+ </>
444
+ );
445
+
446
+ return (
447
+ <motion.div
448
+ ref={setRef}
449
+ layout="position"
450
+ transition={reduce ? { duration: 0 } : SPRING_LAYOUT}
451
+ role="treeitem"
452
+ aria-level={row.depth + 1}
453
+ aria-selected={acceptsChildren ? undefined : active}
454
+ aria-expanded={acceptsChildren ? expanded : undefined}
455
+ aria-disabled={row.item.disabled || undefined}
456
+ tabIndex={focused ? 0 : -1}
457
+ draggable={!row.item.disabled && !renaming}
458
+ data-menu-open={menuOpen || undefined}
459
+ data-drop={dropPosition ?? undefined}
460
+ data-dragging={isDragging || undefined}
461
+ onFocus={onFocus}
462
+ onKeyDown={onKeyDown}
463
+ onClick={(event) => {
464
+ if (
465
+ event.defaultPrevented ||
466
+ draggedRef.current ||
467
+ renaming ||
468
+ row.item.disabled
469
+ )
470
+ return;
471
+ if (acceptsChildren) onToggle();
472
+ else onSelect();
473
+ }}
474
+ onDoubleClick={(event) => {
475
+ if (acceptsChildren || row.item.disabled) return;
476
+ event.preventDefault();
477
+ onRenameStart();
478
+ }}
479
+ onMouseEnter={() => setHovered(true)}
480
+ onMouseLeave={() => setHovered(false)}
481
+ onDragStartCapture={(event) => {
482
+ draggedRef.current = true;
483
+ onDragStart(event, row.item.id);
484
+ }}
485
+ onDragEndCapture={() => {
486
+ onDragEnd();
487
+ requestAnimationFrame(() => {
488
+ draggedRef.current = false;
489
+ });
490
+ }}
491
+ onDragOver={(event) => onDragOver(event, row)}
492
+ onDrop={onDrop}
493
+ className={cn(
494
+ "group/resource relative flex min-h-9 min-w-0 cursor-pointer items-center gap-2.5 rounded-xl pr-3 text-sm outline-none",
495
+ "text-muted-foreground transition-colors hover:bg-muted hover:text-foreground",
496
+ "focus-visible:bg-muted/70 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-inset",
497
+ "data-[menu-open=true]:bg-muted data-[menu-open=true]:text-foreground",
498
+ "data-[dragging=true]:opacity-40",
499
+ "data-[drop=inside]:bg-primary/10 data-[drop=inside]:ring-1 data-[drop=inside]:ring-primary/45",
500
+ "data-[drop=before]:before:absolute data-[drop=before]:before:-top-0.5 data-[drop=before]:before:right-2 data-[drop=before]:before:left-2 data-[drop=before]:before:h-0.5 data-[drop=before]:before:rounded-full data-[drop=before]:before:bg-primary",
501
+ "data-[drop=after]:after:absolute data-[drop=after]:after:-bottom-0.5 data-[drop=after]:after:right-2 data-[drop=after]:after:left-2 data-[drop=after]:after:h-0.5 data-[drop=after]:after:rounded-full data-[drop=after]:after:bg-primary",
502
+ !acceptsChildren && active && "bg-muted text-foreground",
503
+ row.item.disabled && "cursor-not-allowed opacity-45",
504
+ )}
505
+ style={{ paddingLeft: `${12 + row.depth * 16}px` }}
506
+ >
507
+ <span aria-hidden="true" className="grid size-5 shrink-0 place-items-center">
508
+ {renderIcon?.(row.item) ?? defaultIcon(row.item, expanded)}
509
+ </span>
510
+
511
+ {renaming ? (
512
+ <input
513
+ ref={inputRef}
514
+ value={draft}
515
+ aria-label={`Rename ${row.item.label}`}
516
+ onChange={(event) => setDraft(event.target.value)}
517
+ draggable={false}
518
+ onClick={(event) => event.stopPropagation()}
519
+ onDoubleClick={(event) => event.stopPropagation()}
520
+ onBlur={() => {
521
+ if (!skipRenameBlurRef.current) onRenameCommit(draft);
522
+ }}
523
+ onKeyDown={(event) => {
524
+ event.stopPropagation();
525
+ if (event.key === "Enter") {
526
+ skipRenameBlurRef.current = true;
527
+ onRenameCommit(draft);
528
+ }
529
+ if (event.key === "Escape") {
530
+ skipRenameBlurRef.current = true;
531
+ onRenameCancel();
532
+ }
533
+ }}
534
+ className="mx-1 h-7 min-w-0 flex-1 rounded-md border border-border bg-background px-2 text-sm text-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring"
535
+ />
536
+ ) : (
537
+ <MarqueeLabel active={hovered || menuOpen}>{row.item.label}</MarqueeLabel>
538
+ )}
539
+
540
+ {!renaming && !row.item.disabled ? (
541
+ <MorphPopover
542
+ open={menuOpen}
543
+ onOpenChange={onMenuOpenChange}
544
+ >
545
+ <MorphPopoverTrigger>
546
+ <button
547
+ type="button"
548
+ draggable={false}
549
+ tabIndex={-1}
550
+ aria-label={`Actions for ${row.item.label}`}
551
+ onClick={(event) => event.stopPropagation()}
552
+ className={cn(
553
+ "grid size-7 shrink-0 place-items-center rounded-lg outline-none transition-opacity hover:bg-foreground/5 focus-visible:opacity-100 focus-visible:ring-2 focus-visible:ring-ring group-hover/resource:opacity-100 group-data-[menu-open=true]/resource:opacity-100",
554
+ // A finger never hovers, and this menu is the only path to
555
+ // rename and move without a drag — keep it on screen there.
556
+ canTouch ? "opacity-100" : "opacity-0",
557
+ )}
558
+ >
559
+ <MoreHorizontal aria-hidden="true" className="size-4" />
560
+ </button>
561
+ </MorphPopoverTrigger>
562
+ <MorphPopoverContent
563
+ side="bottom"
564
+ align="end"
565
+ sideOffset={8}
566
+ radius={12}
567
+ className="w-40 p-1.5"
568
+ >
569
+ <div data-sidebar-resource-menu={row.item.id}>{menu}</div>
570
+ </MorphPopoverContent>
571
+ </MorphPopover>
572
+ ) : null}
573
+ </motion.div>
574
+ );
575
+ }
576
+
577
+ export function AISidebar({
578
+ items,
579
+ defaultItems = [],
580
+ onItemsChange,
581
+ onMove,
582
+ onMoveError,
583
+ onRename,
584
+ activeId,
585
+ defaultActiveId = null,
586
+ onActiveChange,
587
+ defaultExpandedIds = [],
588
+ renderIcon,
589
+ renderMenu,
590
+ ariaLabel = "Resources",
591
+ className,
592
+ }: AISidebarProps) {
593
+ const [internalItems, setInternalItems] = useState(items ?? defaultItems);
594
+ const [internalActiveId, setInternalActiveId] = useState(defaultActiveId);
595
+ const [expandedIds, setExpandedIds] = useState(
596
+ () => new Set(defaultExpandedIds),
597
+ );
598
+ const [focusedId, setFocusedId] = useState<string | null>(
599
+ activeId ?? defaultActiveId,
600
+ );
601
+ const [draggingId, setDraggingId] = useState<string | null>(null);
602
+ const [dropTarget, setDropTarget] = useState<DropTarget | null>(null);
603
+ const [menuOpenId, setMenuOpenId] = useState<string | null>(null);
604
+ const [renamingId, setRenamingId] = useState<string | null>(null);
605
+ const [announcement, setAnnouncement] = useState("");
606
+ const rowRefs = useRef(new Map<string, HTMLDivElement>());
607
+ const movePendingRef = useRef(false);
608
+ const renderedItems = internalItems;
609
+ const selectedId = activeId ?? internalActiveId;
610
+
611
+ useEffect(() => {
612
+ if (items) setInternalItems(items);
613
+ }, [items]);
614
+
615
+ const flat = useMemo(
616
+ () => flattenResources(renderedItems, expandedIds),
617
+ [expandedIds, renderedItems],
618
+ );
619
+
620
+ // Which row carries the roving tabindex is resolved during render, never in
621
+ // a passive effect: an effect lands after the browser paints, so the first
622
+ // commit — and, on a server-rendered page, the markup itself — would have no
623
+ // tabbable row and Tab would skip the whole tree. The same hole opens again
624
+ // whenever a collapse or a rolled-back move takes the focused row out of it.
625
+ const focusedRow =
626
+ focusedId !== null && flat.some((row) => row.item.id === focusedId)
627
+ ? focusedId
628
+ : (flat[0]?.item.id ?? null);
629
+ if (focusedId !== focusedRow) setFocusedId(focusedRow);
630
+
631
+ useEffect(() => {
632
+ if (!menuOpenId) return;
633
+ const frame = requestAnimationFrame(() => {
634
+ const menus = Array.from(
635
+ document.querySelectorAll<HTMLElement>("[data-sidebar-resource-menu]"),
636
+ );
637
+ menus
638
+ .find((menu) => menu.dataset.sidebarResourceMenu === menuOpenId)
639
+ ?.querySelector<HTMLElement>("button, a[href]")
640
+ ?.focus();
641
+ });
642
+ return () => cancelAnimationFrame(frame);
643
+ }, [menuOpenId]);
644
+
645
+ const updateItems = useCallback(
646
+ (next: SidebarResource[]) => {
647
+ setInternalItems(next);
648
+ onItemsChange?.(next);
649
+ },
650
+ [onItemsChange],
651
+ );
652
+
653
+ const performMove = useCallback(
654
+ async (move: SidebarResourceMove) => {
655
+ if (movePendingRef.current) {
656
+ setAnnouncement("Wait for the current move to finish.");
657
+ return;
658
+ }
659
+ const before = renderedItems;
660
+ const next = moveResource(before, move);
661
+ if (!next || next === before) return;
662
+
663
+ movePendingRef.current = true;
664
+ updateItems(next);
665
+ setDropTarget(null);
666
+ setDraggingId(null);
667
+ const moved = findResource(before, move.itemId);
668
+ const target = move.targetId ? findResource(before, move.targetId) : null;
669
+ setAnnouncement(
670
+ target
671
+ ? `Moved ${moved?.label ?? "item"} ${move.position} ${target.label}.`
672
+ : `Moved ${moved?.label ?? "item"} to the top level.`,
673
+ );
674
+
675
+ try {
676
+ await onMove?.(move);
677
+ } catch (error) {
678
+ updateItems(before);
679
+ setAnnouncement(`Move failed. ${moved?.label ?? "Item"} was restored.`);
680
+ onMoveError?.(error, move);
681
+ } finally {
682
+ movePendingRef.current = false;
683
+ }
684
+ },
685
+ [onMove, onMoveError, renderedItems, updateItems],
686
+ );
687
+
688
+ const focusRow = useCallback((id: string) => {
689
+ setFocusedId(id);
690
+ requestAnimationFrame(() => rowRefs.current.get(id)?.focus());
691
+ }, []);
692
+
693
+ const select = useCallback(
694
+ (id: string) => {
695
+ if (activeId === undefined) setInternalActiveId(id);
696
+ onActiveChange?.(id);
697
+ },
698
+ [activeId, onActiveChange],
699
+ );
700
+
701
+ const toggle = useCallback((id: string) => {
702
+ setExpandedIds((current) => {
703
+ const next = new Set(current);
704
+ if (next.has(id)) next.delete(id);
705
+ else next.add(id);
706
+ return next;
707
+ });
708
+ }, []);
709
+
710
+ // The same four moves `Alt+Shift+Arrow` performs, handed to the row menu so
711
+ // they survive on a device with no drag and no modifier keys.
712
+ const moveCommands = useCallback(
713
+ (row: FlatResource): SidebarResourceMoveCommands => {
714
+ if (row.item.disabled) return {};
715
+ const index = flat.findIndex(({ item }) => item.id === row.item.id);
716
+ const previous = flat[index - 1];
717
+ const next = flat[index + 1];
718
+ const parentId = row.parentId;
719
+ const commands: SidebarResourceMoveCommands = {};
720
+
721
+ if (previous) {
722
+ commands.up = () =>
723
+ void performMove({
724
+ itemId: row.item.id,
725
+ targetId: previous.item.id,
726
+ position: "before",
727
+ });
728
+ }
729
+ if (next) {
730
+ commands.down = () =>
731
+ void performMove({
732
+ itemId: row.item.id,
733
+ targetId: next.item.id,
734
+ position: "after",
735
+ });
736
+ }
737
+ // Only offer the reparent when it lands somewhere new — the row above a
738
+ // folder's first child is the folder it already lives in.
739
+ if (previous && canContain(previous.item) && previous.item.id !== parentId) {
740
+ commands.into = {
741
+ label: previous.item.label,
742
+ run: () => {
743
+ setExpandedIds((current) => new Set(current).add(previous.item.id));
744
+ void performMove({
745
+ itemId: row.item.id,
746
+ targetId: previous.item.id,
747
+ position: "inside",
748
+ });
749
+ },
750
+ };
751
+ }
752
+ if (parentId) {
753
+ commands.out = () =>
754
+ void performMove({
755
+ itemId: row.item.id,
756
+ targetId: parentId,
757
+ position: "after",
758
+ });
759
+ }
760
+
761
+ return commands;
762
+ },
763
+ [flat, performMove],
764
+ );
765
+
766
+ const handleKeyDown = useCallback(
767
+ (event: KeyboardEvent<HTMLDivElement>, row: FlatResource) => {
768
+ const index = flat.findIndex(({ item }) => item.id === row.item.id);
769
+ const previous = flat[index - 1];
770
+ const next = flat[index + 1];
771
+ const moveModifier = event.altKey && event.shiftKey;
772
+
773
+ if (event.key === "ArrowDown" && !moveModifier && next) {
774
+ event.preventDefault();
775
+ focusRow(next.item.id);
776
+ return;
777
+ }
778
+ if (event.key === "ArrowUp" && !moveModifier && previous) {
779
+ event.preventDefault();
780
+ focusRow(previous.item.id);
781
+ return;
782
+ }
783
+ if (event.key === "Home" && flat[0]) {
784
+ event.preventDefault();
785
+ focusRow(flat[0].item.id);
786
+ return;
787
+ }
788
+ if (event.key === "End" && flat.at(-1)) {
789
+ event.preventDefault();
790
+ focusRow(flat.at(-1)?.item.id ?? row.item.id);
791
+ return;
792
+ }
793
+
794
+ if (row.item.disabled) {
795
+ if (event.key === "ArrowLeft" && row.parentId) {
796
+ event.preventDefault();
797
+ focusRow(row.parentId);
798
+ } else if (
799
+ moveModifier ||
800
+ ["ArrowRight", "Enter", " ", "F2", "ContextMenu"].includes(
801
+ event.key,
802
+ ) ||
803
+ (event.shiftKey && event.key === "F10")
804
+ ) {
805
+ event.preventDefault();
806
+ }
807
+ return;
808
+ }
809
+
810
+ if (moveModifier && event.key === "ArrowUp" && previous) {
811
+ event.preventDefault();
812
+ void performMove({ itemId: row.item.id, targetId: previous.item.id, position: "before" });
813
+ return;
814
+ }
815
+ if (moveModifier && event.key === "ArrowDown" && next) {
816
+ event.preventDefault();
817
+ void performMove({ itemId: row.item.id, targetId: next.item.id, position: "after" });
818
+ return;
819
+ }
820
+ if (moveModifier && event.key === "ArrowRight" && previous && canContain(previous.item)) {
821
+ event.preventDefault();
822
+ setExpandedIds((current) => new Set(current).add(previous.item.id));
823
+ void performMove({ itemId: row.item.id, targetId: previous.item.id, position: "inside" });
824
+ return;
825
+ }
826
+ if (moveModifier && event.key === "ArrowLeft" && row.parentId) {
827
+ event.preventDefault();
828
+ void performMove({ itemId: row.item.id, targetId: row.parentId, position: "after" });
829
+ return;
830
+ }
831
+
832
+ if (event.key === "ArrowRight" && canContain(row.item)) {
833
+ event.preventDefault();
834
+ if (!expandedIds.has(row.item.id)) toggle(row.item.id);
835
+ else if (next?.parentId === row.item.id) focusRow(next.item.id);
836
+ } else if (event.key === "ArrowLeft") {
837
+ event.preventDefault();
838
+ if (expandedIds.has(row.item.id)) toggle(row.item.id);
839
+ else if (row.parentId) focusRow(row.parentId);
840
+ } else if (event.key === "Enter" || event.key === " ") {
841
+ event.preventDefault();
842
+ if (canContain(row.item)) toggle(row.item.id);
843
+ else select(row.item.id);
844
+ } else if (event.key === "F2") {
845
+ event.preventDefault();
846
+ setRenamingId(row.item.id);
847
+ } else if (event.key === "ContextMenu" || (event.shiftKey && event.key === "F10")) {
848
+ event.preventDefault();
849
+ setMenuOpenId(row.item.id);
850
+ }
851
+ },
852
+ [expandedIds, flat, focusRow, performMove, select, toggle],
853
+ );
854
+
855
+ return (
856
+ <>
857
+ <div
858
+ role="tree"
859
+ aria-label={ariaLabel}
860
+ aria-multiselectable="false"
861
+ onDragOver={(event) => {
862
+ if (!draggingId || event.target !== event.currentTarget) return;
863
+ event.preventDefault();
864
+ setDropTarget({ id: null, position: "after" });
865
+ }}
866
+ onDrop={(event) => {
867
+ event.preventDefault();
868
+ if (draggingId && dropTarget) {
869
+ void performMove({
870
+ itemId: draggingId,
871
+ targetId: dropTarget.id,
872
+ position: dropTarget.position,
873
+ });
874
+ }
875
+ }}
876
+ className={cn(
877
+ "relative flex min-w-0 flex-col gap-0.5 [overflow-anchor:none] group-data-[state=collapsed]/sidebar:hidden",
878
+ draggingId && "select-none pb-9",
879
+ className,
880
+ )}
881
+ >
882
+ <AnimatePresence initial={false}>
883
+ {flat.map((row) => (
884
+ <ResourceRow
885
+ key={row.item.id}
886
+ row={row}
887
+ active={selectedId === row.item.id}
888
+ expanded={expandedIds.has(row.item.id)}
889
+ focused={focusedRow === row.item.id}
890
+ draggingId={draggingId}
891
+ dropTarget={dropTarget}
892
+ menuOpen={menuOpenId === row.item.id}
893
+ moves={moveCommands(row)}
894
+ renaming={renamingId === row.item.id}
895
+ onFocus={() => setFocusedId(row.item.id)}
896
+ onSelect={() => select(row.item.id)}
897
+ onToggle={() => toggle(row.item.id)}
898
+ onKeyDown={(event) => handleKeyDown(event, row)}
899
+ onRenameStart={() => setRenamingId(row.item.id)}
900
+ onRenameCancel={() => setRenamingId(null)}
901
+ onRenameCommit={(label) => {
902
+ const trimmed = label.trim();
903
+ setRenamingId(null);
904
+ if (!trimmed || trimmed === row.item.label) return;
905
+ const before = renderedItems;
906
+ updateItems(renameResource(before, row.item.id, trimmed));
907
+ void Promise.resolve(onRename?.(row.item, trimmed)).catch(() => {
908
+ updateItems(before);
909
+ setAnnouncement(`Rename failed. ${row.item.label} was restored.`);
910
+ });
911
+ }}
912
+ onMenuOpenChange={(open) => {
913
+ setMenuOpenId(open ? row.item.id : null);
914
+ if (!open) focusRow(row.item.id);
915
+ }}
916
+ onDragStart={(event, id) => {
917
+ setDraggingId(id);
918
+ event.dataTransfer.effectAllowed = "move";
919
+ event.dataTransfer.setData("text/plain", id);
920
+ }}
921
+ onDragEnd={() => {
922
+ setDraggingId(null);
923
+ setDropTarget(null);
924
+ }}
925
+ onDragOver={(event, targetRow) => {
926
+ if (!draggingId || draggingId === targetRow.item.id) return;
927
+ const source = findResource(renderedItems, draggingId);
928
+ if (source && containsResource(source, targetRow.item.id)) return;
929
+ event.preventDefault();
930
+ event.stopPropagation();
931
+ const rect = event.currentTarget.getBoundingClientRect();
932
+ const ratio = (event.clientY - rect.top) / rect.height;
933
+ const position =
934
+ !targetRow.item.disabled &&
935
+ canContain(targetRow.item) &&
936
+ ratio >= 0.25 &&
937
+ ratio <= 0.75
938
+ ? "inside"
939
+ : ratio < 0.5
940
+ ? "before"
941
+ : "after";
942
+ setDropTarget({ id: targetRow.item.id, position });
943
+ }}
944
+ onDrop={(event) => {
945
+ event.preventDefault();
946
+ event.stopPropagation();
947
+ if (draggingId && dropTarget) {
948
+ void performMove({
949
+ itemId: draggingId,
950
+ targetId: dropTarget.id,
951
+ position: dropTarget.position,
952
+ });
953
+ }
954
+ }}
955
+ renderIcon={renderIcon}
956
+ renderMenu={renderMenu}
957
+ setRef={(node) => {
958
+ if (node) rowRefs.current.set(row.item.id, node);
959
+ else rowRefs.current.delete(row.item.id);
960
+ }}
961
+ />
962
+ ))}
963
+ </AnimatePresence>
964
+
965
+ {draggingId ? (
966
+ <div
967
+ aria-hidden="true"
968
+ data-active={dropTarget?.id === null || undefined}
969
+ className="absolute inset-x-1 bottom-0 flex h-8 items-center justify-center rounded-lg border border-dashed border-border text-[10px] text-muted-foreground data-[active=true]:border-primary/50 data-[active=true]:bg-primary/10 data-[active=true]:text-foreground"
970
+ >
971
+ Move to top level
972
+ </div>
973
+ ) : null}
974
+
975
+ </div>
976
+ <span className="sr-only" aria-live="polite">
977
+ {announcement}
978
+ </span>
979
+ </>
980
+ );
981
+ }