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,187 @@
1
+ ---
2
+ name: better-interface
3
+ description: >-
4
+ Cross-discipline interface review: routes a screen, flow, feature, or product interface to every `better-*` domain skill and consolidates one ranked verdict. Use when asked for a holistic review rather than a single domain, and when `interface-review` hands up a change to route. Triggers on better-interface, holistic interface review, review the whole screen.
5
+ ---
6
+
7
+ # Review the interface as one system
8
+
9
+ A strong interface is not a stack of independent audits stapled together. Review the whole experience, let each `better-*` skill own its domain rules, then consolidate the evidence into one prioritized verdict.
10
+
11
+ This skill owns orchestration only. Accessibility rules belong to `better-accessibility`; structure to `better-layout`; copy to `better-writing`; type to `better-typography`; color to `better-colors`; visual polish and motion to `better-ui`. Never duplicate or override their rules here. Change-scoped review of uncommitted work, branches, and pull requests belongs to `interface-review`, which resolves the scope and classifies findings before handing the review back here.
12
+
13
+ ## Core Principles
14
+
15
+ ### 1. Resolve Scope and Mode First
16
+
17
+ Parse the invocation as `[quick|full] [scope]`. The first token is a mode only when it is exactly `quick` or `full`; anything else is part of the scope. Mode defaults to `full`.
18
+
19
+ Infer the screen, flow, feature, or repository scope from the request and current workspace. State the resolved scope in the output.
20
+
21
+ | Mode | Coverage | Finding cap |
22
+ | --- | --- | --- |
23
+ | `quick` | The primary path through the scope and the states it actually reaches; report only `HIGH` and `MEDIUM` issues | 5 |
24
+ | `full` | Entire requested scope across every domain skill listed in principle 3, including empty, loading, error, and narrow-width states when present | 15 |
25
+
26
+ If the requested scope is too large to inspect credibly, narrow it to one complete flow: the one the request itself centers on, or failing that the entry path every user of the scope must pass through. State the boundary and what it excluded. Never imply uninspected surfaces were reviewed.
27
+
28
+ When the request names a branch, pull request, commit range, or uncommitted changes, that is a change review, not a screen review. Say so and ask the user to run `interface-review`; it is user-invoked, so this skill cannot start it. Never resolve a change scope here: reading a diff, classifying findings, and expanding changed files to affected surfaces are all `interface-review`'s, and guessing at them produces a report whose scope nobody can check.
29
+
30
+ `interface-review` hands the review back the other way. When it does, it supplies the resolved change scope, the affected surfaces, and a status for each finding; severity, consolidation, the cap, the output format, and the verdict stay here, under **Change-Scoped Reviews** below.
31
+
32
+ ### 2. Recon Before Judgment
33
+
34
+ Identify the framework, styling system, component library, design tokens, supported viewports, and available preview or test commands. Write every fix in the project's own idiom so no finding arrives as a request to adopt a different stack. That governs the form of the fix, not whether the current code is good enough.
35
+
36
+ Then read what the project has written about its own interface: `CONTRIBUTING.md`, `CODING_STANDARDS.md`, `AGENTS.md`, `CLAUDE.md`, a design-system doc, Storybook docs, interface ADRs. Name in the output which you found, or that there are none.
37
+
38
+ Read them for leverage, not permission. A documented convention is not evidence the convention is good, and "it's in the style guide" does not retire a finding. What they change is **where** you report: when a guideline or shared token is the cause, report it once against that source with the components as its locations.
39
+
40
+ ### 3. Use Domain Skills as the Sources of Truth
41
+
42
+ Before reviewing, confirm that every owning skill below is available. Load and apply every available owner. In `quick` mode, inspect every domain but spend depth only where the primary flow has evidence. In `full` mode, complete each available domain review before consolidation.
43
+
44
+ Review in this order so foundational failures are not hidden by polish:
45
+
46
+ 1. `better-accessibility`
47
+ 2. `better-layout`
48
+ 3. `better-writing`
49
+ 4. `better-typography`
50
+ 5. `better-colors`
51
+ 6. `better-ui`
52
+
53
+ This skill owns the final response. When a domain skill is loaded through `better-interface`, apply its principles and references but ignore its **Reporting** section and the `review-output.md` it points at. Use the consolidated format, shared severity, and finding cap in this file instead.
54
+
55
+ If an owning skill is unavailable, mark that domain `Not reviewed`, name the missing skill, and continue with the remaining domains. Do not recreate its rules from memory, substitute a neighboring skill, or claim holistic coverage.
56
+
57
+ When two skills appear to cover the same issue, assign it to the skill that owns the underlying rule and mention secondary effects in the **Why** cell. Report it once.
58
+
59
+ ### 4. Require Evidence
60
+
61
+ Every finding cites `path/to/file:line` and shows the current implementation. If the review artifact has no source files, cite the exact screen and component. Do not report a code-level finding from visual appearance alone or a visual finding from source code alone when runtime behavior determines the result.
62
+
63
+ ### 5. Rank by User Impact
64
+
65
+ Use one shared severity scale:
66
+
67
+ - `HIGH`: blocks a task, misleads the user, hides content or controls, causes data-loss risk, or creates a repeated systemic failure.
68
+ - `MEDIUM`: meaningfully harms comprehension, efficiency, adaptability, or consistency.
69
+ - `LOW`: isolated polish with limited task impact. Include only in `full` mode.
70
+
71
+ Within a severity, rank by reach and leverage. A token or shared-component fix outranks the same symptom in one leaf component.
72
+
73
+ **Escalation triggers.** Once the owning skill confirms one of these, it is `HIGH` on sight, not averaged down because the surface is minor and not withheld in `quick` mode:
74
+
75
+ - An interactive control with no accessible name.
76
+ - A keyboard-reachable control with no visible focus indicator.
77
+ - A control or path reachable by pointer but not by keyboard.
78
+ - Motion or auto-playing content that ignores `prefers-reduced-motion`.
79
+ - Content or a control clipped, overlapped, or unreachable at 320px width or 200% zoom.
80
+ - Body or control text whose rendered contrast pair fails its required ratio.
81
+ - State or meaning carried by color alone.
82
+ - A destructive action with no confirmation, undo, or distinct treatment.
83
+
84
+ Triggers rank above every other finding. When more fire than the cap allows, list them first and state how many findings the cap excluded; a cap may shorten a report but may never be why a blocker went unreported.
85
+
86
+ These set severity, not new rules. The owning skill still decides whether the symptom is present, and this list decides what it costs. In a change review, a confirmed `Regression` against a trigger is `HIGH` even where the same symptom would be `MEDIUM` as pre-existing.
87
+
88
+ ### 6. Consolidate Systemic Findings
89
+
90
+ One root cause is one finding. List every confirmed location in the same row rather than producing a row per occurrence. Do not pad the report to reach the finding cap; a short review or no findings is a valid result.
91
+
92
+ ### 7. Make Restraint Visible
93
+
94
+ Record candidates considered but deliberately rejected. A candidate is rejected when the owning skill permits the current implementation, evidence is insufficient, the project's convention is a defensible choice and not merely an established one, or the proposed change would add complexity without user benefit.
95
+
96
+ ### 8. Verify What Can Be Verified
97
+
98
+ Run safe, relevant checks available in the project. Inspect the rendered interface when runtime behavior or visual judgment matters. Report the exact command or interaction and observed result. If a check cannot be run, label it **Not verified** and state what remains; never convert a verification gap into a finding.
99
+
100
+ ### 9. Review Without Mutating by Default
101
+
102
+ Treat a review request as read-only. Do not edit source code unless the user also asks to implement the findings. When implementation is requested, preserve the consolidated report as the change scope and re-run the relevant verification afterward.
103
+
104
+ ## Common Mistakes
105
+
106
+ | Mistake | Fix |
107
+ | --- | --- |
108
+ | Six disconnected domain reports | Consolidate into one ranked findings table |
109
+ | Same issue reported by multiple skills | Assign it to the skill that owns the underlying rule |
110
+ | Finding with no exact location | Cite `path/to/file:line` and the current implementation |
111
+ | Visual claim inferred only from source | Inspect the rendered state or mark it not verified |
112
+ | Unlimited low-impact polish | Respect the mode cap; omit `LOW` findings in `quick` |
113
+ | Silent gaps in coverage | Show which domains and states were actually inspected |
114
+ | Missing owning skill silently treated as covered | Mark the domain `Not reviewed` and name the unavailable skill |
115
+ | No rejected candidates | Include the required considered-but-rejected table |
116
+ | Review silently edits code | Stay read-only unless implementation was requested |
117
+ | “Approve” with pending actionable findings | Use `Needs changes` or `Block` |
118
+ | Every legacy issue in a touched file reported | Cap pre-existing findings at three in their own section |
119
+ | A pre-existing issue blocking a change review | Keep pre-existing findings out of the cap and out of the verdict |
120
+ | Domain marked `Clear` when the change never touched it | Mark it `Not reviewed: no evidence in the change scope` |
121
+
122
+ ## Review Output Format
123
+
124
+ Always use the following sections.
125
+
126
+ ### Scope and Coverage
127
+
128
+ State the mode, exact scope, stack and styling conventions, the project convention documents found in recon, and any review boundary. Then show coverage:
129
+
130
+ | Domain | Evidence inspected | Result |
131
+ | --- | --- | --- |
132
+ | Accessibility | Files, components, states, or checks | Findings count or `Clear` |
133
+
134
+ Include every domain listed in principle 3. `Clear` means inspected with no actionable finding; `Not reviewed` must explain why.
135
+
136
+ ### Findings
137
+
138
+ Use one table ordered by severity, then reach and leverage:
139
+
140
+ | # | Severity | Domain | Location | Before | After | Why |
141
+ | --- | --- | --- | --- | --- | --- | --- |
142
+ | 1 | HIGH | Accessibility | `src/Dialog.tsx:42` | `<button><XIcon /></button>` | Add `aria-label="Close"` and hide the icon from the accessibility tree | The icon-only control has no accessible name |
143
+
144
+ Each row is one root cause. The **Domain** value is the owning skill without the `better-` prefix. Respect the mode's finding cap. If there are no findings, omit the table and state "No actionable interface findings."
145
+
146
+ ### Considered but Rejected
147
+
148
+ Include 1–3 candidates in `quick` mode and 2–5 in `full` mode:
149
+
150
+ | Location | Candidate | Rejected because |
151
+ | --- | --- | --- |
152
+ | `src/Card.tsx:28` | Increase the shadow | Existing depth matches the shared surface token; changing one card would reduce consistency |
153
+
154
+ These are real candidates inspected during the review, not invented filler. If the scope genuinely contains fewer borderline candidates, include the ones that exist and say so.
155
+
156
+ ### Verification
157
+
158
+ List each check or interaction, the exact command or steps, and the observed result. Separate checks that passed from checks marked **Not verified**.
159
+
160
+ ### Verdict
161
+
162
+ End with exactly one:
163
+
164
+ - `Block`: one or more `HIGH` findings remain.
165
+ - `Needs changes`: only `MEDIUM` or `LOW` findings remain.
166
+ - `Approve`: no actionable findings remain and the claimed coverage was verified.
167
+
168
+ ### Change-Scoped Reviews
169
+
170
+ When `interface-review` resolved the scope from version control, the format above applies with these four additions. They live here because this file owns the format, the cap, and the verdict; `interface-review` supplies the scope and the statuses.
171
+
172
+ 1. **Scope block.** Open **Scope and Coverage** with the change scope table `interface-review` produced, then the coverage table above unchanged. A domain with no evidence in the change scope is `Not reviewed: no evidence in the change scope`, which is a coverage statement, not a gap.
173
+ 2. **Status column.** The findings table gains a `Status` column after `Domain`, carrying `Introduced` or `Regression`:
174
+
175
+ | # | Severity | Domain | Status | Location | Before | After | Why |
176
+ | --- | --- | --- | --- | --- | --- | --- | --- |
177
+ | 1 | HIGH | Accessibility | Regression | `src/Dialog.tsx:42` | `aria-label="Close"` removed in this change | Restore `aria-label="Close"` on the icon-only control | The close control had an accessible name before this change and no longer does |
178
+
179
+ With no `Introduced` or `Regression` findings, omit the table and state "No actionable interface findings in this change."
180
+
181
+ 3. **Pre-existing section.** Place it after **Considered but Rejected**, at most three, highest severity first, stated plainly as not this change's responsibility. Omit when there are none.
182
+
183
+ | Severity | Domain | Location | Issue |
184
+ | --- | --- | --- | --- |
185
+ | MEDIUM | Typography | `src/Toolbar.tsx:7` | Numeric badges use proportional figures; predates this change |
186
+
187
+ 4. **Cap and verdict.** Both cover `Introduced` and `Regression` only. `Pre-existing` findings sit outside the cap, so touching a legacy file cannot turn into a full-file audit, and outside the verdict, so a change whose only findings are pre-existing is an `Approve`.
@@ -0,0 +1,79 @@
1
+ ---
2
+ name: better-layout
3
+ description: Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.
4
+ ---
5
+
6
+ # Layout that communicates structure
7
+
8
+ Layout communicates before a single word is read: position, spacing, and alignment carry hierarchy on their own, and generous space beats decoration. A good layout also survives stress: resize it, translate it, mirror it for RTL, and it should still hold together. Apply these principles when building or reviewing UI code, and write every fix in the project's own idiom: the styling system already in use, never a second one alongside it.
9
+
10
+ Hit-area sizes and focus behavior are covered by the `better-accessibility` skill; visual polish (radius, shadows, animation) by the `better-ui` skill; line length and text spacing by the `better-typography` skill.
11
+
12
+ Treat the numeric values below as starting points for interfaces without an established density or spacing system. Preserve deliberate platform chrome, compact professional tools, and project tokens when they remain usable under hit-area, zoom, localization, and viewport stress tests.
13
+
14
+ ## Quick Reference
15
+
16
+ | Category | When to Use |
17
+ | --- | --- |
18
+ | [Grouping & Alignment](grouping-and-alignment.md) | Space vs separators, alignment edges, logical properties, importance ordering |
19
+ | [Spacing & Adaptivity](spacing-and-adaptivity.md) | Spacing between targets, layout margins, progressive disclosure, full-bleed content, breakpoints, i18n growth |
20
+ | [Review Output Format](review-output.md) | Severity scale, findings table, verification, verdict |
21
+
22
+ ## Core Principles
23
+
24
+ ### 1. Group with Space, Not Lines
25
+
26
+ Negative space is the primary grouping tool; background shapes second; separator lines last, only where space alone can't carry the structure. The gap between groups must be at least 2× the gap within a group (`8px` intra-group → `16px`+ inter-group), or the grouping reads as noise.
27
+
28
+ ### 2. Keep Controls Distinct from Content
29
+
30
+ Interactive elements must look interactive: a background shape, a border, or a consistent placement zone. Never style a control identically to adjacent static text.
31
+
32
+ ### 3. Align to Shared Edges
33
+
34
+ Pick alignment edges and stick to them; every stray edge reads as noise. Use one project spacing step for each level of subordination (`16px` is a useful default). Use logical properties (`padding-inline-start`, `margin-inline-end`) for direction-dependent layout; reserve physical left/right for genuinely physical geometry.
35
+
36
+ ### 4. Order by Importance
37
+
38
+ The most important content sits near the top and the leading edge; reading order flows top-to-bottom, leading-to-trailing. Think in leading/trailing, not left/right.
39
+
40
+ ### 5. Hint at Hidden Content
41
+
42
+ Progressive disclosure needs a visible affordance. Use the project's established cue; without one, let the next item peek `16–32px` past the scroll edge or show a disclosure control. Content hidden with zero cue may as well not exist.
43
+
44
+ ### 6. Breathing Room Between Targets
45
+
46
+ Without an established density system, start with `12px` between adjacent bordered or filled controls and `24px` of clearance around borderless text- and icon-only controls. Compact layouts may use less when `better-accessibility` hit areas do not overlap and the controls remain visually distinct.
47
+
48
+ ### 7. Inset Buttons from the Edges
49
+
50
+ In content layouts, keep full-width buttons inside the layout margins (start near `16px` inline on mobile) with a visible radius. Edge-to-edge actions are acceptable when they intentionally follow established platform or application chrome, account for safe areas, and remain distinguishable from system UI.
51
+
52
+ ### 8. Content Bleeds, Controls Float
53
+
54
+ Backgrounds and media extend to the viewport edges; controls and text stay inside the layout margins and safe areas (`env(safe-area-inset-*)`). Sticky chrome floats above the content layer, it doesn't dam it.
55
+
56
+ ### 9. Hold Structure Until It Breaks
57
+
58
+ Breakpoints come from the content, not device presets. Keep the expanded layout as long as it genuinely fits and collapse late; prefer container queries for component-level adaptation. Test the smallest and largest sizes first.
59
+
60
+ ### 10. Plan for Growth and Clipping
61
+
62
+ Plan for substantial and language-dependent string growth rather than relying on a universal percentage: no fixed widths or heights on text containers, and let rows wrap. Never park critical actions where resizing or scrolling clips them; keep them reachable in the normal flow or stable chrome appropriate to the product.
63
+
64
+ ## Common Mistakes
65
+
66
+ | Mistake | Fix |
67
+ | --- | --- |
68
+ | Separator line where spacing would do | Remove the line, double the gap between groups |
69
+ | `margin-left` / `padding-right` in a localizable layout | `margin-inline-start` / `padding-inline-end` |
70
+ | Content-layout button accidentally touches the viewport | Inset within the project margins; preserve intentional platform chrome |
71
+ | Carousel/scroller that looks complete | Let the next item peek `16–32px` past the edge |
72
+ | Adjacent controls merge or expanded hit areas overlap | Increase the gap using the project scale; use `12px`/`24px` as starting points |
73
+ | Breakpoints at 768/1024 because they're the defaults | Break where the content actually stops fitting |
74
+ | Fixed-width text container sized to one language | `max-width` + wrapping; test pseudo-localization and representative locales |
75
+ | Primary action at the clip-prone bottom of a pane | Sticky positioning or stable chrome with safe-area padding |
76
+
77
+ ## Reporting
78
+
79
+ A standalone layout review is finished when every confirmed finding is reported in the format in [review-output.md](review-output.md), with verification and a verdict. Under `better-interface`, its format governs instead.
@@ -0,0 +1,136 @@
1
+ ---
2
+ name: better-typography
3
+ description: Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.
4
+ ---
5
+
6
+ # Great typography
7
+
8
+ Good typography is mostly restraint. A sensible scale, comfortable spacing and enough contrast beat any clever effect. A label, a table cell, a marketing headline and an article paragraph should not share one set of rules. Apply these principles when building or reviewing anything with text in it.
9
+
10
+ When reviewing, read the page instead of scanning the code: squint to check the hierarchy holds, read one full paragraph for comfort, and resize the viewport to catch bad wrapping, widows and truncation at real content lengths.
11
+
12
+ The words themselves (button labels, error messages, empty states) are covered by the `better-writing` skill; semantic heading structure by `better-accessibility`; spatial RTL layout and logical CSS properties by `better-layout`; rendered-pair contrast measurement and color remediation by `better-colors`. This skill owns how text renders, wraps, and behaves in mixed-direction content.
13
+
14
+ Write every fix in the project's own idiom: the styling system already in use, never a second one alongside it. The [cheat sheet](css-cheat-sheet.md) maps each declaration to its Tailwind equivalent.
15
+
16
+ ## Quick Reference
17
+
18
+ | Category | When to use | Reference |
19
+ | --- | --- | --- |
20
+ | Choosing fonts | Font categories, pairing, formats, typeface anatomy | [choosing-fonts.md](choosing-fonts.md) |
21
+ | Variable fonts & OpenType | Axes, weights, tabular numbers, stylistic sets | [variable-fonts-and-opentype.md](variable-fonts-and-opentype.md) |
22
+ | Spacing & sizing | Type scale, heading hierarchy, line-height, letter-spacing, text trimming | [spacing-and-sizing.md](spacing-and-sizing.md) |
23
+ | Wrapping & punctuation | Measure, wrapping, truncation, smart punctuation, RTL | [wrapping-and-punctuation.md](wrapping-and-punctuation.md) |
24
+ | Details & accessibility | Underlines, selection, forms, decorative text, contrast | [details-and-accessibility.md](details-and-accessibility.md) |
25
+ | CSS cheat sheet | Quick lookup of every property covered, with Tailwind equivalents | [css-cheat-sheet.md](css-cheat-sheet.md) |
26
+ | Review output format | Severity scale, findings table, verification, verdict | [review-output.md](review-output.md) |
27
+
28
+ ## Core Principles
29
+
30
+ ### 1. Serve the Right Format
31
+
32
+ Use `.woff2` (Brotli compression, broadly supported) on the web. `.woff` is a fallback only for very old browsers; `.ttf` and `.otf` are raw desktop formats with no web compression. How the files are loaded is the project's own concern, this skill does not prescribe it.
33
+
34
+ ### 2. Properties Over Raw Tags
35
+
36
+ When a CSS property exists, use it. `font-weight: 650` instead of `font-variation-settings: "wght" 650`, `font-optical-sizing: auto` instead of `"opsz"`, `font-variant-numeric: tabular-nums` instead of `font-feature-settings: "tnum" 1`. Properties keep working when a non-variable fallback renders. Reserve the raw-tag properties for custom axes (`"GRAD" 80`) and niche features (`"ss01" 1`) that have no property of their own.
37
+
38
+ ### 3. Load Intended Weights and Styles
39
+
40
+ Browsers may synthesize a requested weight or style that the active family does not provide. Prefer loading the faces the design actually uses. Set `font-synthesis: none` only after verifying that every required bold, italic, small-cap, superscript, and subscript form remains visually distinct across the complete fallback stack; disabling synthesis is not a diagnostic and must not erase emphasis.
41
+
42
+ ### 4. Fewer Fonts, Sizes and Weights
43
+
44
+ Rarely use more than three fonts. Weight and size define hierarchy, but overusing them hurts readability quickly. Pair for contrast, not similarity: a serif headline with a sans body reads as deliberate, two near-identical sans-serifs read as a mistake. Below `18px`, stay at weight `400`+; weights under `300` are display-only (`28px`+), they disappear at text sizes.
45
+
46
+ ### 5. Use a Type Scale with Semantic Names
47
+
48
+ Define a small set of sizes and deviate from it as little as possible. Hard-coded sizes without a system break down at scale. For solo projects, default names like `text-sm` work fine as long as the usage rules are clear. On a team, name sizes by use (`text-body-sm`), not by size, so the rules stay consistent.
49
+
50
+ ### 6. Heading Sizes Descend with Level
51
+
52
+ Within a coherent page hierarchy, map heading levels to descending steps of the type scale: a visually subordinate heading should not accidentally overpower its parent. Adjacent levels may share a size toward the small end of the scale as long as weight or spacing keeps them distinct. Pick semantic heading elements according to `better-accessibility`; this skill controls only their visual treatment.
53
+
54
+ ### 7. Line-Height by Role
55
+
56
+ Headings tighter, around `1.1`. Body copy `1.5` to `1.6`. Prefer unitless values so line-height scales with the font size; fixed values like `24px` do not. Tight line-height is for short text: anything that wraps to three or more lines needs at least `1.4`, even in height-constrained rows.
57
+
58
+ ### 8. Letter-Spacing by Size
59
+
60
+ Large headings often look better with slightly negative letter-spacing. Small uppercase labels need a little positive letter-spacing so letters do not feel crowded. Body copy at reading sizes needs neither.
61
+
62
+ ### 9. Cap the Measure
63
+
64
+ Long lines make it hard for the eye to find the next line. Cap long-form text around 60–75 characters per line. Any unit works; what matters is that a cap exists and the resulting line length sits in range. [Unit choices and the pixel equivalents](wrapping-and-punctuation.md#measure-line-length).
65
+
66
+ ### 10. Wrap Deliberately
67
+
68
+ `text-wrap: balance` distributes text evenly across lines: use it on headings. `text-wrap: pretty` avoids leaving a single short word on the final line: use it on descriptions. Skip both in long-form text. `overflow-wrap: break-word` where long words, links or IDs could escape the container. `white-space: nowrap` on labels and badges where a line break looks broken.
69
+
70
+ ### 11. Tabular Numbers on Changing Values
71
+
72
+ Digits have different widths by default, so timers, counters and prices shift layout as they update. Apply `font-variant-numeric: tabular-nums` to any value that changes.
73
+
74
+ ### 12. Truncate Without Losing Content
75
+
76
+ Single line: `text-overflow: ellipsis` with `overflow: hidden` and `white-space: nowrap`. Multiple lines: `line-clamp`. Truncation hides content, so if the missing text matters, keep the full value reachable in a tooltip or expanded view.
77
+
78
+ ### 13. Write Copy Naturally, Style with CSS
79
+
80
+ Store text in natural case and control presentation with `text-transform`, so redesigns never require rewriting copy. Use smart punctuation: curly quotes in prose (straight quotes in code), an en dash for ranges like `2010–2020`, an em dash to set off a thought, the single ellipsis character, `&nbsp;` to keep values like `16 px` together and `&shy;` to control where long words may break.
81
+
82
+ ### 14. Underlines from the Font
83
+
84
+ Default underlines sit wherever the browser decides. Pull position and thickness from the font's own metrics with `text-underline-position: from-font` and `text-decoration-thickness: from-font`, or tune manually with `text-decoration-thickness`, `text-underline-offset` and `text-decoration-skip-ink`. `text-decoration-style` draws the line dotted, dashed or wavy; a dotted underline is a common hint that a word carries extra information, like an abbreviation or a defined term. Unless the only thing animating is a color change, build the underline as a separate element instead of using `text-decoration`: color is the only part of a real underline that animates reliably.
85
+
86
+ ### 15. Inputs at 16px on Mobile
87
+
88
+ iOS Safari zooms the whole page when an input's text is smaller than `16px`. Two fixes hold the font size at `16px` in different ways, so ask which one the design wants instead of choosing silently: size the input up on mobile (`text-base sm:text-sm`), which changes how it looks on small screens, or keep `font-size: 16px` and render the intended size with `transform: scale()`, compensating width and `line-height` so the design is identical at every viewport. [Both recipes](details-and-accessibility.md).
89
+
90
+ ### 16. Size and Contrast Floors
91
+
92
+ Start long-form body text near the browser default of `16px`, then judge it in the actual typeface, measure, platform, and product density. UI text can go smaller: `14px` is a useful starting point for inputs and menus (inputs still need `16px` on mobile, see principle 15), `13px` for captions, rarely below `12px`. When text appears low-contrast, use `better-colors` to measure the rendered pair and `better-accessibility` to classify the requirement; do not change colors unless asked.
93
+
94
+ ### 17. Font Smoothing on the Root
95
+
96
+ On macOS text renders heavier than intended. Apply `-webkit-font-smoothing: antialiased` and `-moz-osx-font-smoothing: grayscale` (both covered by Tailwind's `antialiased`) once on the root layout, never per component.
97
+
98
+ ### 18. Language and Bidi Behavior
99
+
100
+ Set `lang` so browsers and assistive technology choose the right pronunciation, quotes, and hyphenation. Set `dir` at the document or content boundary where direction changes, preserve digit order, and use `<bdi>` for isolated mixed-direction values when needed. Spatial mirroring and logical CSS properties belong to `better-layout`.
101
+
102
+ ### 19. Keep Useful Text Selectable
103
+
104
+ `::selection` can carry brand into the reading experience when the selected combination stays legible. Keep text selectable by default. Use `user-select: none` only on a specific draggable or gesture-driven surface where accidental selection demonstrably interferes with the interaction; never disable selection across the interface or merely because a button label can be highlighted.
105
+
106
+ ## Common Mistakes
107
+
108
+ | Mistake | Fix |
109
+ | --- | --- |
110
+ | `.ttf`/`.otf` served on the web | Convert to `.woff2` |
111
+ | `font-variation-settings: "wght"` for weight | `font-weight` (works with non-variable fallbacks) |
112
+ | `font-feature-settings: "tnum" 1` | `font-variant-numeric: tabular-nums` |
113
+ | Synthesized face differs from the intended design | Load the required face; disable only the verified synthesis mode without erasing emphasis |
114
+ | Hard-coded one-off font sizes | Use the type scale |
115
+ | Child heading visually overpowers its parent | Map that section's hierarchy to descending scale steps |
116
+ | Heading element picked for its default size | Choose semantics with `better-accessibility`, then set the visual size in CSS |
117
+ | `line-height: 24px` on scalable text | Unitless value (`1.5`) |
118
+ | Full-width paragraphs | Cap around 60–75 characters per line |
119
+ | Orphan on the last line of a paragraph | `text-wrap: pretty` |
120
+ | Lopsided two-line heading | `text-wrap: balance` |
121
+ | Numbers cause layout shift | `tabular-nums` |
122
+ | Truncated text with no way to read it | Tooltip or expanded view for the full value |
123
+ | `UPPERCASE` typed into copy | Natural case + `text-transform` |
124
+ | Justified text in an interface | `text-align: start`; reserve justify for specific editorial layouts |
125
+ | Underline cuts through descenders | `text-decoration-skip-ink: auto`, `from-font` metrics |
126
+ | Inputs below `16px` zoom on iOS | Ask first: `text-base sm:text-sm`, or `16px` scaled down with `transform` to keep the designed size |
127
+ | Root layout omits font smoothing | Apply `antialiased` once at the root |
128
+ | Mixed-direction value renders in the wrong order | Set the correct `lang`/`dir`; isolate the value with `<bdi>` when needed |
129
+ | Selection disabled across application chrome | Restore selection; suppress it only on a specific interaction that conflicts with dragging or gestures |
130
+ | Extra-info hint with no visual cue | Dotted underline via `text-decoration-style: dotted` |
131
+ | Thin/Light weight on `14px` UI text | Weight `400`+ below `18px`; thin weights are display-only |
132
+ | `leading-none` on a three-line card description | At least `1.4` on any text that wraps to 3+ lines |
133
+
134
+ ## Reporting
135
+
136
+ A standalone typography review is finished when every confirmed finding is reported in the format in [review-output.md](review-output.md), with verification and a verdict. Under `better-interface`, its format governs instead.
@@ -0,0 +1,113 @@
1
+ ---
2
+ name: better-ui
3
+ description: Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, theme switch transitions, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.
4
+ ---
5
+
6
+ # Details that make interfaces feel better
7
+
8
+ Great interfaces rarely come from a single thing. It's usually a collection of small details that compound into a great experience. Apply these principles when building or reviewing UI code.
9
+
10
+ When reviewing, slow the interface down: replay motion at 10% speed in the browser's Animations panel and walk every state: hover, focus, active, loading, empty. What feels off at 10% speed is what's subtly wrong at full speed.
11
+
12
+ Preserve the project's component library, tokens, and density. Match its established motion language except where a principle below prescribes an exact interaction pattern.
13
+
14
+ Typography (text wrapping, font rendering, tabular numbers, spacing) is covered by the `better-typography` skill; use that for anything text-related. Accessibility (hit areas, focus states, keyboard support, ARIA, reduced motion) is covered by the `better-accessibility` skill. Layout structure (grouping, spacing between sections, breakpoints, spatial RTL) is covered by the `better-layout` skill.
15
+
16
+ ## Quick Reference
17
+
18
+ | Category | When to Use |
19
+ | --- | --- |
20
+ | [Surfaces](surfaces.md) | Border radius, optical alignment, shadows, image outlines |
21
+ | [Animations](animations.md) | Interruptible transitions, scale on press, skipping animation on page load, theme switching, motion restraint |
22
+ | [Enter & Exit](enter-exit.md) | Staged entrances, stagger timing, exit transitions |
23
+ | [Icon Transitions](icon-transitions.md) | Cross-fading an icon on state change, with and without a motion library |
24
+ | [Icons](icons.md) | Icon stroke weight, states via `currentColor`, outline vs fill, sizing, RTL flipping |
25
+ | [Performance](performance.md) | Transition specificity, `will-change` usage |
26
+ | [Review Output Format](review-output.md) | Severity scale, findings table, verification, verdict |
27
+
28
+ ## Core Principles
29
+
30
+ ### 1. Concentric Border Radius
31
+
32
+ Outer radius = inner radius + padding. Mismatched radii on nested elements is the most common thing that makes interfaces feel off.
33
+
34
+ ### 2. Optical Over Geometric Alignment
35
+
36
+ When geometric centering looks off, align optically. Buttons with icons, play triangles, and asymmetric icons all need manual adjustment.
37
+
38
+ ### 3. Shadows for Elevation, Borders for Structure
39
+
40
+ For buttons, cards, and containers whose border exists only to create depth, prefer layered transparent `box-shadow` values. Keep borders that communicate structure or state: dividers, layout separators, and selected or focus states.
41
+
42
+ ### 4. Interruptible Animations
43
+
44
+ Use CSS transitions for interactive state changes: they can be interrupted mid-animation. Reserve keyframes for staged sequences that run once.
45
+
46
+ ### 5. Split and Stagger Enter Animations
47
+
48
+ For an infrequent staged entrance where sequence helps communicate hierarchy, break content into semantic chunks and stagger them by ~100ms instead of animating one container. Do not stagger routine, high-frequency interactions. [Stagger and exit recipes](enter-exit.md).
49
+
50
+ ### 6. Subtle Exit Animations
51
+
52
+ Use a small fixed `translateY` instead of full height. Exits should be softer than enters. Use `ease-out` for both enter and exit transitions.
53
+
54
+ ### 7. Contextual Icon Animations
55
+
56
+ Animate icons with `opacity`, `scale`, and `blur` instead of toggling visibility. Use exactly these values: scale from `0.25` to `1`, opacity from `0` to `1`, blur from `4px` to `0px`. If the project has `motion` or `framer-motion` in `package.json`, match that package's import path (or the established nearby imports when both exist) and use `transition: { type: "spring", duration: 0.3, bounce: 0 }`; bounce must always be `0`. If no motion library is installed, keep both icons in the DOM (one absolute-positioned) and cross-fade with CSS transitions using `cubic-bezier(0.2, 0, 0, 1)`; this gives both enter and exit animations without any dependency. [Both recipes](icon-transitions.md).
57
+
58
+ ### 8. Image Outlines
59
+
60
+ Add a subtle `1px` outline with low opacity to images for consistent depth. The color must be pure black in light mode (`oklch(0 0 0 / 0.1)`) and pure white in dark mode (`oklch(1 0 0 / 0.1)`), never a near-black like slate, zinc, or any tinted neutral. A tinted outline picks up the surface color underneath it and reads as dirt on the image edge.
61
+
62
+ ### 9. Scale on Press
63
+
64
+ A subtle `scale(0.96)` on click gives buttons tactile feedback. Always use `0.96`; anything below `0.95` feels exaggerated. Add a `static` prop to disable it when motion would be distracting. [Recipes for CSS, Tailwind, and Motion](animations.md#scale-on-press).
65
+
66
+ ### 10. Skip Animation on Page Load
67
+
68
+ Use `initial={false}` on `AnimatePresence` to prevent enter animations on first render. Verify it doesn't break intentional entrance animations.
69
+
70
+ ### 11. Suppress Transitions on Theme Switch
71
+
72
+ A theme flip changes color, background, border, and shadow on nearly every element at once, so every transition on those properties fires together and the switch smears instead of snapping. Inject `*,*::before,*::after{transition:none !important}`, force a reflow, then remove it on the next frame. [Recipe](animations.md#suppress-transitions-on-theme-switch).
73
+
74
+ ### 12. Transition Only What Changes
75
+
76
+ Always specify exact properties: `transition-property: scale, opacity`. Tailwind's `transition-transform` covers `transform, translate, scale, rotate`.
77
+
78
+ ### 13. Use `will-change` Sparingly
79
+
80
+ Only for `transform`, `opacity`, `filter`, the properties the GPU can composite. Never use `will-change: all`. Only add when you notice first-frame stutter.
81
+
82
+ ### 14. Match Icon Stroke to Text Weight
83
+
84
+ An icon next to text carries the text's optical weight: `1.5px` stroke beside regular (400) text, `2px` beside semibold (600). One stroke weight per icon set; never mix libraries on one surface.
85
+
86
+ ### 15. One SVG, Recolored per State
87
+
88
+ Icons use `currentColor` and get their states (hover, selected, disabled) from CSS color and opacity, never from separate assets. Outline variant is the default; fill variant marks the active state.
89
+
90
+ ### 16. Motion Restraint
91
+
92
+ No custom animation on high-frequency interactions: the attention cost repeats on every trigger. Motion is never the only feedback channel; every animated state change also needs a static cue (color, icon, label).
93
+
94
+ ## Common Mistakes
95
+
96
+ | Mistake | Fix |
97
+ | --- | --- |
98
+ | Same border radius on closely nested parent and child | Calculate `outerRadius = innerRadius + padding` |
99
+ | Icons look off-center | Adjust optically with padding or fix SVG directly |
100
+ | Border used only to fake elevation | Use layered `box-shadow` with transparency; keep structural and state borders |
101
+ | Jarring staged entrance or contextual exit | Stagger infrequent entrances and keep context-preserving exits subtle |
102
+ | Stateful icon or toggle animates its default state on page load | Add `initial={false}` to that `AnimatePresence`; preserve intentional page entrances |
103
+ | Theme toggle crossfades the whole page | Disable transitions for the swap, force a reflow, restore on the next frame |
104
+ | `transition: all` on elements | Specify exact properties |
105
+ | First-frame animation stutter | Add `will-change: transform` (sparingly) |
106
+ | Hairline icon beside bold text | Match the stroke width to the text weight |
107
+ | Separate icon assets per state | One `currentColor` SVG, states via CSS |
108
+ | Filled icons everywhere | Outline as default, fill only for the active state |
109
+ | Entrance animation on every hover or keystroke | Instant feedback or ≤150ms opacity/color transition |
110
+
111
+ ## Reporting
112
+
113
+ A standalone UI-polish review is finished when every confirmed finding is reported in the format in [review-output.md](review-output.md), with verification and a verdict. Under `better-interface`, its format governs instead.
@@ -0,0 +1,115 @@
1
+ ---
2
+ name: better-writing
3
+ description: >-
4
+ UX writing and interface copy, from voice and button labels to error messages and empty states. Use when writing or reviewing any user-facing text: button and link labels, form errors, placeholders, settings labels, onboarding flows, notifications, or empty states. Triggers on UX writing, microcopy, interface copy, product copy, copywriting, button labels, link text, error messages, empty states, placeholder text, settings labels, capitalization, title case, sentence case, voice and tone.
5
+ ---
6
+
7
+ # Writing that disappears into the interface
8
+
9
+ Clear and brief beats clever, consistency beats variety, and the best error message is the interaction redesigned so the error can't happen. Apply these principles when writing or reviewing any user-facing text.
10
+
11
+ How copy renders (capitalization via `text-transform`, truncation, smart punctuation) is covered by the `better-typography` skill; error markup and announcements (`aria-invalid`, live regions) by the `better-accessibility` skill; room for translated strings by the `better-layout` skill.
12
+
13
+ ## Quick Reference
14
+
15
+ | Category | When to Use |
16
+ | --- | --- |
17
+ | [Review Output Format](review-output.md) | Severity scale, findings table, verification, verdict |
18
+
19
+ ## Core Principles
20
+
21
+ ### 1. Recon the Existing Voice
22
+
23
+ Before writing or reviewing, inspect nearby interface copy, the product's terminology, localization conventions, and any voice or content style guide. Preserve intentional brand character when it remains clear and appropriate to the stakes. Treat a difference from generic plain language as a finding only when it creates inconsistency, ambiguity, translation risk, or an inappropriate tone.
24
+
25
+ ### 2. One Voice, Flexible Tone
26
+
27
+ The product has one voice, established by its existing system rather than invented during a local edit. Keep terms consistent: if it's "Archive" in the menu, it isn't "Move to storage" in the toast. Tone flexes with the stakes:
28
+
29
+ | Context | Tone |
30
+ | --- | --- |
31
+ | Success, onboarding, empty states | Warm, can be light |
32
+ | Routine actions, settings | Neutral, minimal |
33
+ | Errors, destructive confirmations | Calm, plain, zero playfulness |
34
+ | Data loss, security | Serious, explicit |
35
+
36
+ ### 3. Address the Reader Directly
37
+
38
+ In instructional interface copy, address the reader directly as "you" rather than "the user." Avoid “we” in errors when it creates ambiguity or reads as deflection: prefer “Unable to load content” over “We're having trouble loading this content.” Preserve an established first-person brand voice in low-stakes contexts when it remains clear. Use possessives sparingly (“Favorites” over “Your Favorites”) and never switch perspective accidentally.
39
+
40
+ ### 4. Plain Words Over Clever Ones
41
+
42
+ Choose easily understood words and delete every word that isn't needed. No idioms, colloquialisms, or humor that won't translate. Skip unnecessary gender: "Subscribers can post recipes", not "each subscriber can post his or her recipes". Match the input device: "tap" on touch, "click" with a pointer, "select" when both are possible. Never build sentences by concatenating fragments around variables (`"You have " + n + " new messages"`); word order changes per language, so use full templated strings with proper pluralization.
43
+
44
+ ### 5. Verb-First Buttons
45
+
46
+ Button labels start with a verb naming the specific action: "Send", "Save draft", "Delete project". Never "OK!", "Let's go!", or bare "Yes"/"No" on consequential actions. Confirmation buttons repeat the consequence so the dialog is answerable without reading the body: "Delete this project?" offers `Delete project` and `Cancel`, not `Yes` and `No`.
47
+
48
+ ### 6. Consistent Flow Vocabulary
49
+
50
+ Multi-step flows use one vocabulary: "Get Started" to enter, "Continue" or "Next" (pick one) to advance, "Done" to finish. Alternating synonyms across steps makes users wonder if the buttons do different things.
51
+
52
+ ### 7. Links Describe Their Destination
53
+
54
+ Link text makes sense out of context; screen-reader users navigate by a list of the page's links. "Read the billing docs", never "Click here" (which also fails the device-verb rule on touch), and never a bare "Learn more" when several appear on one page. Suffix each: "Learn more about exports".
55
+
56
+ ### 8. One Capitalization Policy
57
+
58
+ Pick title case or sentence case per element type (all buttons, all headings) and apply it consistently; sentence case is the safer default: calmer, no per-word case rules, localizes cleanly. "Save Changes" beside "Discard changes" reads as sloppiness.
59
+
60
+ ### 9. Settings Describe the ON State
61
+
62
+ Label a toggle for what happens when it's on: "Send read receipts", and users infer the off state. Never label the negative ("Don't send read receipts"), which turns the toggle into a double negative. Link directly to a referenced setting instead of describing the path to it: a "Notification settings" link, not "Go to Settings > Notifications > Email".
63
+
64
+ ### 10. Errors Say How to Fix, Next to Where It Broke
65
+
66
+ An error is an instruction, adjacent to the failing field:
67
+
68
+ | Bad | Good |
69
+ | --- | --- |
70
+ | That password is too short | Choose a password with at least 8 characters |
71
+ | Invalid name | Use only letters for your name |
72
+ | Oops! Something went wrong. | Unable to save. Check your connection and try again. |
73
+
74
+ No blame, no "oops", no exclamation marks. Phrase hints positively ("Use only letters", not "Don't use numbers or symbols") and show them before the mistake, not after. If the same error keeps firing for many users, redesign the interaction instead of rewording it.
75
+
76
+ ### 11. Empty States Point Forward
77
+
78
+ An empty state says what this place is and how to fill it, with one clear next action:
79
+
80
+ ```html
81
+ <!-- Bad: a shrug -->
82
+ <p>No results.</p>
83
+
84
+ <!-- Good: orientation plus a next step -->
85
+ <p class="font-medium">No projects yet</p>
86
+ <p class="text-sm text-zinc-500">Projects keep your tasks and files together.</p>
87
+ <button class="mt-4">Create a project</button>
88
+ ```
89
+
90
+ Search and filter empty states name the query and offer an exit: "No results for 'quarterly'. Clear filters". Never park crucial persistent information in an empty state; it disappears the moment content exists.
91
+
92
+ ### 12. Placeholders Are Examples, Not Labels
93
+
94
+ Placeholders show the expected format (`name@example.com`, `DD/MM/YYYY`). A placeholder is never the field's only label: it vanishes on input, and every field keeps a visible label.
95
+
96
+ ## Common Mistakes
97
+
98
+ | Mistake | Fix |
99
+ | --- | --- |
100
+ | Local rewrite ignores the product's established terminology or voice | Inspect nearby copy and the style guide before proposing a change |
101
+ | "The user" in instructional interface copy | Address the reader directly as "you" |
102
+ | "We're having trouble…" obscures responsibility or recovery | Use a direct status and next step: "Unable to load content" |
103
+ | `OK` / `Yes` confirming a destructive dialog | Repeat the consequence: "Delete project" |
104
+ | "Continue" on step 2, "Next" on step 3 | One flow vocabulary throughout |
105
+ | "Click here" or bare "Learn more" link | Describe the destination: "Read the billing docs" |
106
+ | "Save Changes" beside "Discard changes" | One capitalization policy per element type |
107
+ | "Don't send read receipts" toggle | Label the ON state: "Send read receipts" |
108
+ | "Oops! Something went wrong." | Say what to do, next to the failing field |
109
+ | "No results." as the whole empty state | Orient and point forward with a next action |
110
+ | Placeholder doing the label's job | Visible label; placeholder shows the format |
111
+ | `"You have " + n + " messages"` | Full templated strings with pluralization |
112
+
113
+ ## Reporting
114
+
115
+ A standalone writing review is finished when every confirmed finding is reported in the format in [review-output.md](review-output.md), with verification and a verdict. Under `better-interface`, its format governs instead.