@vllnt/ui 0.4.0-canary.sha8741950 → 0.4.0-canary.sha8d4b5cd

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 (372) hide show
  1. package/CHANGELOG.md +195 -1
  2. package/README.md +97 -12
  3. package/dist/components/{accordion → atoms/accordion}/accordion.js +30 -8
  4. package/dist/components/{agent-activity → atoms/agent-activity}/agent-activity.js +10 -3
  5. package/dist/components/{ai-source-citation → atoms/ai-source-citation}/ai-source-citation.js +2 -2
  6. package/dist/components/{ai-streaming-text → atoms/ai-streaming-text}/ai-streaming-text.js +2 -2
  7. package/dist/components/{alert → atoms/alert}/alert.js +1 -1
  8. package/dist/components/{alert-pulse → atoms/alert-pulse}/alert-pulse.js +2 -2
  9. package/dist/components/{anchor-port → atoms/anchor-port}/anchor-port.js +1 -1
  10. package/dist/components/{animated-beam → atoms/animated-beam}/animated-beam.js +1 -1
  11. package/dist/components/{animated-grid-pattern → atoms/animated-grid-pattern}/animated-grid-pattern.js +1 -1
  12. package/dist/components/{animated-list → atoms/animated-list}/animated-list.js +1 -1
  13. package/dist/components/{animated-tabs → atoms/animated-tabs}/animated-tabs.js +16 -4
  14. package/dist/components/{animated-testimonials → atoms/animated-testimonials}/animated-testimonials.js +1 -1
  15. package/dist/components/{animated-text → atoms/animated-text}/animated-text.js +29 -8
  16. package/dist/components/{animated-tooltip → atoms/animated-tooltip}/animated-tooltip.js +11 -1
  17. package/dist/components/atoms/avatar/avatar.js +159 -0
  18. package/dist/components/{badge → atoms/badge}/badge.js +1 -1
  19. package/dist/components/{banner → atoms/banner}/banner.js +1 -1
  20. package/dist/components/{bento-grid → atoms/bento-grid}/bento-grid.js +1 -1
  21. package/dist/components/{blur-reveal → atoms/blur-reveal}/blur-reveal.js +1 -1
  22. package/dist/components/{border-beam → atoms/border-beam}/border-beam.js +2 -5
  23. package/dist/components/{bottom-activity-strip → atoms/bottom-activity-strip}/bottom-activity-strip.js +4 -3
  24. package/dist/components/{bottom-bar → atoms/bottom-bar}/bottom-bar.js +1 -1
  25. package/dist/components/atoms/breadcrumb/breadcrumb.js +120 -0
  26. package/dist/components/{button → atoms/button}/button.js +1 -1
  27. package/dist/components/{button-group → atoms/button-group}/button-group.js +1 -1
  28. package/dist/components/{callout → atoms/callout}/callout.js +1 -1
  29. package/dist/components/{card → atoms/card}/card.js +1 -1
  30. package/dist/components/{card-flip → atoms/card-flip}/card-flip.js +1 -1
  31. package/dist/components/{chain-of-thought → atoms/chain-of-thought}/chain-of-thought.js +8 -2
  32. package/dist/components/{checkbox → atoms/checkbox}/checkbox.js +1 -1
  33. package/dist/components/{checklist → atoms/checklist}/checklist.js +7 -4
  34. package/dist/components/{comment-pin → atoms/comment-pin}/comment-pin.js +8 -5
  35. package/dist/components/{comparison → atoms/comparison}/comparison.js +41 -27
  36. package/dist/components/{context-lens → atoms/context-lens}/context-lens.js +1 -1
  37. package/dist/components/{context-menu → atoms/context-menu}/context-menu.js +1 -1
  38. package/dist/components/{curriculum → atoms/curriculum}/curriculum.js +12 -10
  39. package/dist/components/atoms/cursor/cursor.js +91 -0
  40. package/dist/components/{data-list → atoms/data-list}/data-list.js +1 -1
  41. package/dist/components/{date-field → atoms/date-field}/date-field.js +1 -1
  42. package/dist/components/{dialog → atoms/dialog}/dialog.js +1 -1
  43. package/dist/components/{display → atoms/display}/display.js +1 -1
  44. package/dist/components/atoms/dock/dock.js +167 -0
  45. package/dist/components/{document-sibling-nav → atoms/document-sibling-nav}/document-sibling-nav.js +1 -1
  46. package/dist/components/{dot-pattern → atoms/dot-pattern}/dot-pattern.js +1 -1
  47. package/dist/components/{drawer → atoms/drawer}/drawer.js +4 -2
  48. package/dist/components/{dropdown-menu → atoms/dropdown-menu}/dropdown-menu.js +2 -2
  49. package/dist/components/{edge-label → atoms/edge-label}/edge-label.js +1 -1
  50. package/dist/components/{empty-state → atoms/empty-state}/empty-state.js +1 -1
  51. package/dist/components/{era-comparison → atoms/era-comparison}/era-comparison.js +2 -2
  52. package/dist/components/{expandable-cards → atoms/expandable-cards}/expandable-cards.js +1 -1
  53. package/dist/components/{faq → atoms/faq}/faq.js +1 -1
  54. package/dist/components/{fieldset → atoms/fieldset}/fieldset.js +1 -1
  55. package/dist/components/{floating-action-button → atoms/floating-action-button}/floating-action-button.js +1 -1
  56. package/dist/components/{floating-navbar → atoms/floating-navbar}/floating-navbar.js +1 -1
  57. package/dist/components/{floating-toolbar → atoms/floating-toolbar}/floating-toolbar.js +1 -1
  58. package/dist/components/{follow-mode → atoms/follow-mode}/follow-mode.js +7 -7
  59. package/dist/components/{gauge-chart → atoms/gauge-chart}/gauge-chart.js +2 -2
  60. package/dist/components/{glass-card → atoms/glass-card}/glass-card.js +1 -1
  61. package/dist/components/{glass-panel → atoms/glass-panel}/glass-panel.js +1 -1
  62. package/dist/components/{glass-progress → atoms/glass-progress}/glass-progress.js +3 -2
  63. package/dist/components/{grid → atoms/grid}/grid.js +1 -1
  64. package/dist/components/{group-hull → atoms/group-hull}/group-hull.js +1 -1
  65. package/dist/components/{handoff-beacon → atoms/handoff-beacon}/handoff-beacon.js +2 -2
  66. package/dist/components/{heading → atoms/heading}/heading.js +1 -1
  67. package/dist/components/{heat-overlay → atoms/heat-overlay}/heat-overlay.js +1 -1
  68. package/dist/components/{hover-card → atoms/hover-card}/hover-card.js +1 -1
  69. package/dist/components/{infinite-plane → atoms/infinite-plane}/infinite-plane.js +1 -1
  70. package/dist/components/{input → atoms/input}/input.js +1 -1
  71. package/dist/components/{input-group → atoms/input-group}/input-group.js +1 -1
  72. package/dist/components/{input-otp → atoms/input-otp}/input-otp.js +2 -2
  73. package/dist/components/{item → atoms/item}/item.js +1 -1
  74. package/dist/components/{jarvis-dock → atoms/jarvis-dock}/jarvis-dock.js +3 -3
  75. package/dist/components/{kbd → atoms/kbd}/kbd.js +44 -14
  76. package/dist/components/{key-concept → atoms/key-concept}/key-concept.js +5 -3
  77. package/dist/components/{keyboard-shortcuts-help → atoms/keyboard-shortcuts-help}/keyboard-shortcuts-help.js +11 -6
  78. package/dist/components/{label → atoms/label}/label.js +1 -1
  79. package/dist/components/{learning-objectives → atoms/learning-objectives}/learning-objectives.js +24 -10
  80. package/dist/components/{left-rail → atoms/left-rail}/left-rail.js +1 -1
  81. package/dist/components/{link → atoms/link}/link.js +1 -1
  82. package/dist/components/{liquid-glass → atoms/liquid-glass}/liquid-glass.js +2 -3
  83. package/dist/components/{list-box → atoms/list-box}/list-box.js +56 -5
  84. package/dist/components/{live-cursor → atoms/live-cursor}/live-cursor.js +10 -5
  85. package/dist/components/atoms/magnetic/magnetic.js +110 -0
  86. package/dist/components/atoms/magnetic-button/magnetic-button.js +111 -0
  87. package/dist/components/atoms/marquee/marquee.js +156 -0
  88. package/dist/components/{menubar → atoms/menubar}/menubar.js +2 -2
  89. package/dist/components/{meteors → atoms/meteors}/meteors.js +3 -3
  90. package/dist/components/{meter → atoms/meter}/meter.js +3 -3
  91. package/dist/components/{metric-cluster → atoms/metric-cluster}/metric-cluster.js +1 -1
  92. package/dist/components/{mini-map-panel → atoms/mini-map-panel}/mini-map-panel.js +1 -1
  93. package/dist/components/{multi-select-lasso → atoms/multi-select-lasso}/multi-select-lasso.js +1 -1
  94. package/dist/components/{native-select → atoms/native-select}/native-select.js +1 -1
  95. package/dist/components/{navigation-menu → atoms/navigation-menu}/navigation-menu.js +1 -1
  96. package/dist/components/{number-ticker → atoms/number-ticker}/number-ticker.js +1 -1
  97. package/dist/components/{object-handle → atoms/object-handle}/object-handle.js +2 -2
  98. package/dist/components/{object-inspector → atoms/object-inspector}/object-inspector.js +2 -2
  99. package/dist/components/{order-book → atoms/order-book}/order-book.js +14 -8
  100. package/dist/components/{panel → atoms/panel}/panel.js +1 -1
  101. package/dist/components/{particles → atoms/particles}/particles.js +3 -3
  102. package/dist/components/{password-input → atoms/password-input}/password-input.js +1 -1
  103. package/dist/components/{phone-input → atoms/phone-input}/phone-input.js +1 -1
  104. package/dist/components/{playback-ghost → atoms/playback-ghost}/playback-ghost.js +13 -5
  105. package/dist/components/{policy-delivery-panel → atoms/policy-delivery-panel}/policy-delivery-panel.js +2 -2
  106. package/dist/components/{popover → atoms/popover}/popover.js +1 -1
  107. package/dist/components/{presence-stack → atoms/presence-stack}/presence-stack.js +9 -4
  108. package/dist/components/{presence-sync-indicator → atoms/presence-sync-indicator}/presence-sync-indicator.js +3 -3
  109. package/dist/components/{pro-tip → atoms/pro-tip}/pro-tip.js +4 -1
  110. package/dist/components/atoms/progress-bar/progress-bar.js +191 -0
  111. package/dist/components/{progressive-blur → atoms/progressive-blur}/progressive-blur.js +1 -1
  112. package/dist/components/{prompt-input → atoms/prompt-input}/prompt-input.js +9 -3
  113. package/dist/components/{property-section → atoms/property-section}/property-section.js +2 -2
  114. package/dist/components/{prose → atoms/prose}/prose.js +1 -1
  115. package/dist/components/atoms/pull-quote/pull-quote.js +77 -0
  116. package/dist/components/{qr-code → atoms/qr-code}/qr-code.js +28 -4
  117. package/dist/components/{quiz → atoms/quiz}/quiz.js +5 -3
  118. package/dist/components/{radio-group → atoms/radio-group}/radio-group.js +1 -1
  119. package/dist/components/{rating → atoms/rating}/rating.js +14 -3
  120. package/dist/components/{reasoning → atoms/reasoning}/reasoning.js +17 -8
  121. package/dist/components/{relationship-inspector → atoms/relationship-inspector}/relationship-inspector.js +2 -2
  122. package/dist/components/{resizable → atoms/resizable}/resizable.js +1 -1
  123. package/dist/components/{reveal-text → atoms/reveal-text}/reveal-text.js +1 -1
  124. package/dist/components/{right-dock → atoms/right-dock}/right-dock.js +1 -1
  125. package/dist/components/{routing-assignment-panel → atoms/routing-assignment-panel}/routing-assignment-panel.js +3 -3
  126. package/dist/components/{runtime-overview-panel → atoms/runtime-overview-panel}/runtime-overview-panel.js +1 -1
  127. package/dist/components/{scramble-text → atoms/scramble-text}/scramble-text.js +6 -12
  128. package/dist/components/atoms/scrim/scrim.js +32 -0
  129. package/dist/components/atoms/scroll-area/scroll-area.js +90 -0
  130. package/dist/components/{scroll-progress → atoms/scroll-progress}/scroll-progress.js +12 -3
  131. package/dist/components/{search-field → atoms/search-field}/search-field.js +3 -3
  132. package/dist/components/{segmented-control → atoms/segmented-control}/segmented-control.js +2 -2
  133. package/dist/components/{select → atoms/select}/select.js +2 -2
  134. package/dist/components/{selection-halo → atoms/selection-halo}/selection-halo.js +11 -3
  135. package/dist/components/{selection-presence → atoms/selection-presence}/selection-presence.js +4 -2
  136. package/dist/components/{separator → atoms/separator}/separator.js +1 -1
  137. package/dist/components/{severity-badge → atoms/severity-badge}/severity-badge.js +11 -11
  138. package/dist/components/{sheet → atoms/sheet}/sheet.js +4 -3
  139. package/dist/components/{shimmer-button → atoms/shimmer-button}/shimmer-button.js +1 -1
  140. package/dist/components/{shimmer-text → atoms/shimmer-text}/shimmer-text.js +1 -1
  141. package/dist/components/{shine-border → atoms/shine-border}/shine-border.js +2 -5
  142. package/dist/components/{shiny-button → atoms/shiny-button}/shiny-button.js +1 -1
  143. package/dist/components/{skeleton → atoms/skeleton}/skeleton.js +5 -2
  144. package/dist/components/{slider → atoms/slider}/slider.js +13 -2
  145. package/dist/components/{snap-guides → atoms/snap-guides}/snap-guides.js +2 -1
  146. package/dist/components/{social-fab → atoms/social-fab}/social-fab.js +1 -1
  147. package/dist/components/{sparkles → atoms/sparkles}/sparkles.js +3 -3
  148. package/dist/components/{sparkline-grid → atoms/sparkline-grid}/sparkline-grid.js +6 -6
  149. package/dist/components/{spinner → atoms/spinner}/spinner.js +3 -2
  150. package/dist/components/{spinner → atoms/spinner}/unicode-spinner.js +1 -1
  151. package/dist/components/{spinning-text → atoms/spinning-text}/spinning-text.js +15 -13
  152. package/dist/components/atoms/spotlight-card/spotlight-card.js +77 -0
  153. package/dist/components/{state-badge-overlay → atoms/state-badge-overlay}/state-badge-overlay.js +3 -3
  154. package/dist/components/{status-indicator → atoms/status-indicator}/status-indicator.js +2 -2
  155. package/dist/components/{step-by-step → atoms/step-by-step}/step-by-step.js +4 -2
  156. package/dist/components/{step-navigation → atoms/step-navigation}/step-navigation.js +1 -1
  157. package/dist/components/{stepper → atoms/stepper}/stepper.js +3 -2
  158. package/dist/components/{sticky-metric → atoms/sticky-metric}/sticky-metric.js +1 -1
  159. package/dist/components/{switch → atoms/switch}/switch.js +1 -1
  160. package/dist/components/{table → atoms/table}/table.js +2 -2
  161. package/dist/components/{table-of-contents → atoms/table-of-contents}/table-of-contents.js +2 -2
  162. package/dist/components/{table-of-contents-panel → atoms/table-of-contents-panel}/table-of-contents-panel.js +11 -7
  163. package/dist/components/atoms/tabs/tabs.js +250 -0
  164. package/dist/components/{tag-group → atoms/tag-group}/tag-group.js +11 -6
  165. package/dist/components/{tags-input → atoms/tags-input}/tags-input.js +2 -2
  166. package/dist/components/{text → atoms/text}/text.js +1 -1
  167. package/dist/components/{text-animate → atoms/text-animate}/text-animate.js +1 -1
  168. package/dist/components/{text-reveal → atoms/text-reveal}/text-reveal.js +33 -18
  169. package/dist/components/{text-shimmer → atoms/text-shimmer}/text-shimmer.js +1 -1
  170. package/dist/components/{textarea → atoms/textarea}/textarea.js +1 -1
  171. package/dist/components/{theme-preset-provider → atoms/theme-preset-provider}/theme-preset-provider.js +21 -7
  172. package/dist/components/{theme-switcher → atoms/theme-switcher}/theme-switcher.js +15 -4
  173. package/dist/components/{thinking-block → atoms/thinking-block}/thinking-block.js +10 -8
  174. package/dist/components/{thread-bubble → atoms/thread-bubble}/thread-bubble.js +5 -3
  175. package/dist/components/{threshold-ring → atoms/threshold-ring}/threshold-ring.js +2 -2
  176. package/dist/components/atoms/tilt-card/tilt-card.js +115 -0
  177. package/dist/components/{time-field → atoms/time-field}/time-field.js +1 -1
  178. package/dist/components/{timeline → atoms/timeline}/timeline.js +16 -4
  179. package/dist/components/{timeline-scrubber → atoms/timeline-scrubber}/timeline-scrubber.js +2 -2
  180. package/dist/components/{tldr-section → atoms/tldr-section}/tldr-section.js +12 -7
  181. package/dist/components/atoms/toast/sonner-toast.js +4 -0
  182. package/dist/components/{toast → atoms/toast}/toast.js +17 -18
  183. package/dist/components/{toast → atoms/toast}/toaster.js +7 -1
  184. package/dist/components/{toggle → atoms/toggle}/toggle.js +2 -2
  185. package/dist/components/{toolbar → atoms/toolbar}/toolbar.js +2 -1
  186. package/dist/components/{tooltip → atoms/tooltip}/tooltip.js +1 -1
  187. package/dist/components/{top-bar → atoms/top-bar}/top-bar.js +1 -1
  188. package/dist/components/{truncated-text → atoms/truncated-text}/truncated-text.js +1 -1
  189. package/dist/components/{tutorial-intro-content → atoms/tutorial-intro-content}/tutorial-intro-content.js +3 -6
  190. package/dist/components/{typewriter → atoms/typewriter}/typewriter.js +3 -2
  191. package/dist/components/{typography → atoms/typography}/typography.js +1 -1
  192. package/dist/components/{video-embed → atoms/video-embed}/video-embed.js +3 -1
  193. package/dist/components/{view-switcher → atoms/view-switcher}/view-switcher.js +55 -44
  194. package/dist/components/{viewport-bookmarks → atoms/viewport-bookmarks}/viewport-bookmarks.js +2 -2
  195. package/dist/components/{watchlist → atoms/watchlist}/watchlist.js +11 -10
  196. package/dist/components/{workspace-switcher → atoms/workspace-switcher}/workspace-switcher.js +41 -12
  197. package/dist/components/{world-breadcrumbs → atoms/world-breadcrumbs}/world-breadcrumbs.js +1 -1
  198. package/dist/components/index.js +415 -322
  199. package/dist/components/{activity-log → molecules/activity-log}/activity-log.js +7 -7
  200. package/dist/components/{ai-artifact → molecules/ai-artifact}/ai-artifact.js +18 -6
  201. package/dist/components/{ai-chat-input → molecules/ai-chat-input}/ai-chat-input.js +12 -5
  202. package/dist/components/{ai-message-bubble → molecules/ai-message-bubble}/ai-message-bubble.js +3 -3
  203. package/dist/components/{ai-sidebar → molecules/ai-sidebar}/ai-sidebar.js +3 -3
  204. package/dist/components/{ai-tool-call-display → molecules/ai-tool-call-display}/ai-tool-call-display.js +3 -3
  205. package/dist/components/{alert-dialog → molecules/alert-dialog}/alert-dialog.js +2 -2
  206. package/dist/components/{annotation → molecules/annotation}/annotation.js +6 -2
  207. package/dist/components/molecules/approval-request/approval-request.js +168 -0
  208. package/dist/components/{auto-reload → molecules/auto-reload}/auto-reload.js +4 -4
  209. package/dist/components/{avatar-group → molecules/avatar-group}/avatar-group.js +3 -3
  210. package/dist/components/{blog-card → molecules/blog-card}/blog-card.js +2 -2
  211. package/dist/components/{calendar → molecules/calendar}/calendar.js +2 -2
  212. package/dist/components/{carousel → molecules/carousel}/carousel.js +2 -2
  213. package/dist/components/{category-filter → molecules/category-filter}/category-filter.js +1 -1
  214. package/dist/components/{chat-dock-section → molecules/chat-dock-section}/chat-dock-section.js +2 -2
  215. package/dist/components/{checkbox-group → molecules/checkbox-group}/checkbox-group.js +3 -3
  216. package/dist/components/{civilization-card → molecules/civilization-card}/civilization-card.js +3 -3
  217. package/dist/components/{color-picker → molecules/color-picker}/color-picker.js +55 -42
  218. package/dist/components/{command → molecules/command}/command.js +35 -16
  219. package/dist/components/molecules/completion-dialog/completion-dialog.js +163 -0
  220. package/dist/components/{connector-edge → molecules/connector-edge}/connector-edge.js +3 -2
  221. package/dist/components/{content-intro → molecules/content-intro}/content-intro.js +6 -4
  222. package/dist/components/{conversation-thread → molecules/conversation-thread}/conversation-thread.js +12 -11
  223. package/dist/components/molecules/cookie-consent/cookie-consent.js +282 -0
  224. package/dist/components/{copy-button → molecules/copy-button}/copy-button.js +7 -47
  225. package/dist/components/molecules/copy-button/use-copy-to-clipboard.js +42 -0
  226. package/dist/components/{countdown-timer → molecules/countdown-timer}/countdown-timer.js +6 -6
  227. package/dist/components/{credit-badge → molecules/credit-badge}/credit-badge.js +2 -2
  228. package/dist/components/{exercise → molecules/exercise}/exercise.js +5 -5
  229. package/dist/components/{field → molecules/field}/field.js +2 -2
  230. package/dist/components/{file-upload → molecules/file-upload}/file-upload.js +45 -43
  231. package/dist/components/{filter-bar → molecules/filter-bar}/filter-bar.js +8 -8
  232. package/dist/components/{flashcard → molecules/flashcard}/flashcard.js +4 -4
  233. package/dist/components/{form → molecules/form}/form.js +2 -2
  234. package/dist/components/{historical-figure-card → molecules/historical-figure-card}/historical-figure-card.js +5 -5
  235. package/dist/components/{horizontal-scroll-row → molecules/horizontal-scroll-row}/horizontal-scroll-row.js +3 -3
  236. package/dist/components/{inline-input → molecules/inline-input}/inline-input.js +6 -2
  237. package/dist/components/{knowledge-check → molecules/knowledge-check}/knowledge-check.js +3 -3
  238. package/dist/components/{live-feed → molecules/live-feed}/live-feed.js +7 -7
  239. package/dist/components/{metric-gauge → molecules/metric-gauge}/metric-gauge.js +5 -5
  240. package/dist/components/{model-comparison → molecules/model-comparison}/model-comparison.js +3 -3
  241. package/dist/components/{newsletter-signup → molecules/newsletter-signup}/newsletter-signup.js +11 -4
  242. package/dist/components/{number-input → molecules/number-input}/number-input.js +8 -2
  243. package/dist/components/{object-card → molecules/object-card}/object-card.js +8 -7
  244. package/dist/components/{overview-board → molecules/overview-board}/overview-board.js +3 -2
  245. package/dist/components/molecules/pagination/pagination.js +76 -0
  246. package/dist/components/{plan-badge → molecules/plan-badge}/plan-badge.js +2 -2
  247. package/dist/components/{pricing-table → molecules/pricing-table}/pricing-table.js +3 -3
  248. package/dist/components/{profile-section → molecules/profile-section}/profile-section.js +1 -1
  249. package/dist/components/{progress-card → molecules/progress-card}/progress-card.js +21 -11
  250. package/dist/components/{progress-tracker → molecules/progress-tracker}/progress-tracker.js +52 -53
  251. package/dist/components/{prompt-templates → molecules/prompt-templates}/prompt-templates.js +4 -4
  252. package/dist/components/{role-badge → molecules/role-badge}/role-badge.js +2 -2
  253. package/dist/components/{scope-selector → molecules/scope-selector}/scope-selector.js +13 -9
  254. package/dist/components/{search-bar → molecules/search-bar}/search-bar.js +18 -12
  255. package/dist/components/{sidebar → molecules/sidebar}/sidebar.js +30 -15
  256. package/dist/components/{sidebar-toggle → molecules/sidebar-toggle}/sidebar-toggle.js +2 -2
  257. package/dist/components/{stat-card → molecules/stat-card}/stat-card.js +9 -4
  258. package/dist/components/{status-board → molecules/status-board}/status-board.js +10 -4
  259. package/dist/components/{text-field → molecules/text-field}/text-field.js +3 -3
  260. package/dist/components/{theme-toggle → molecules/theme-toggle}/theme-toggle.js +3 -3
  261. package/dist/components/{ticker-tape → molecules/ticker-tape}/ticker-tape.js +43 -15
  262. package/dist/components/{time-picker → molecules/time-picker}/time-picker.js +72 -29
  263. package/dist/components/{toggle-group → molecules/toggle-group}/toggle-group.js +2 -2
  264. package/dist/components/{tour → molecules/tour}/tour.js +19 -11
  265. package/dist/components/{transaction-list → molecules/transaction-list}/transaction-list.js +3 -3
  266. package/dist/components/{tutorial-card → molecules/tutorial-card}/tutorial-card.js +11 -9
  267. package/dist/components/{tutorial-filters → molecules/tutorial-filters}/tutorial-filters.js +7 -7
  268. package/dist/components/{usage-breakdown → molecules/usage-breakdown}/usage-breakdown.js +4 -4
  269. package/dist/components/{world-clock-bar → molecules/world-clock-bar}/world-clock-bar.js +3 -3
  270. package/dist/components/{zoom-hud → molecules/zoom-hud}/zoom-hud.js +3 -2
  271. package/dist/components/organisms/access-matrix/access-matrix.js +271 -0
  272. package/dist/components/{activity-heatmap → organisms/activity-heatmap}/activity-heatmap.js +3 -3
  273. package/dist/components/{candlestick-chart → organisms/candlestick-chart}/candlestick-chart.js +5 -5
  274. package/dist/components/{canvas-view → organisms/canvas-view}/canvas-view.js +11 -15
  275. package/dist/components/{chart → organisms/chart}/area-chart.js +1 -1
  276. package/dist/components/{chart → organisms/chart}/bar-chart.js +2 -2
  277. package/dist/components/{chart → organisms/chart}/line-chart.js +1 -1
  278. package/dist/components/{choropleth-map → organisms/choropleth-map}/choropleth-map.js +10 -3
  279. package/dist/components/{chronological-timeline → organisms/chronological-timeline}/chronological-timeline.js +3 -5
  280. package/dist/components/organisms/code-block/code-block.js +235 -0
  281. package/dist/components/{code-playground → organisms/code-playground}/code-playground.js +11 -4
  282. package/dist/components/{combobox → organisms/combobox}/combobox.js +33 -11
  283. package/dist/components/{contribution-graph → organisms/contribution-graph}/contribution-graph.js +1 -1
  284. package/dist/components/organisms/cta-band/cta-band.js +79 -0
  285. package/dist/components/{data-table → organisms/data-table}/data-table.js +45 -25
  286. package/dist/components/{date-picker → organisms/date-picker}/date-picker.js +30 -12
  287. package/dist/components/{date-range-picker → organisms/date-range-picker}/date-range-picker.js +28 -12
  288. package/dist/components/{flow-diagram → organisms/flow-diagram}/flow-canvas.js +4 -1
  289. package/dist/components/{flow-diagram → organisms/flow-diagram}/flow-controls.js +9 -3
  290. package/dist/components/{flow-diagram → organisms/flow-diagram}/flow-diagram.js +1 -1
  291. package/dist/components/{flow-diagram → organisms/flow-diagram}/flow-error-boundary.js +1 -1
  292. package/dist/components/{flow-diagram → organisms/flow-diagram}/flow-fullscreen.js +8 -4
  293. package/dist/components/{flow-diagram → organisms/flow-diagram}/index.js +2 -0
  294. package/dist/components/{flow-diagram → organisms/flow-diagram}/use-flow-diagram.js +27 -13
  295. package/dist/components/{gantt-chart → organisms/gantt-chart}/gantt-chart.js +8 -4
  296. package/dist/components/{geography-quiz-map → organisms/geography-quiz-map}/geography-quiz-map.js +44 -21
  297. package/dist/components/{globe-3d → organisms/globe-3d}/globe-3d.js +2 -2
  298. package/dist/components/{heat-map-overlay → organisms/heat-map-overlay}/heat-map-overlay.js +1 -1
  299. package/dist/components/{historic-timeline → organisms/historic-timeline}/historic-timeline.js +3 -3
  300. package/dist/components/{interactive-timeline → organisms/interactive-timeline}/interactive-timeline.js +7 -7
  301. package/dist/components/{map-2d → organisms/map-2d}/map-2d.js +4 -1
  302. package/dist/components/{map-timeline → organisms/map-timeline}/map-timeline.js +1 -1
  303. package/dist/components/{market-treemap → organisms/market-treemap}/market-treemap.js +11 -4
  304. package/dist/components/{model-selector → organisms/model-selector}/model-selector.js +69 -52
  305. package/dist/components/{multi-select → organisms/multi-select}/multi-select.js +23 -6
  306. package/dist/components/{navbar-saas → organisms/navbar-saas}/navbar-saas.js +5 -5
  307. package/dist/components/organisms/order-summary/order-summary.js +172 -0
  308. package/dist/components/{parallel-timeline → organisms/parallel-timeline}/parallel-timeline.js +3 -2
  309. package/dist/components/{pie-chart → organisms/pie-chart}/pie-chart.js +1 -1
  310. package/dist/components/{primary-source-viewer → organisms/primary-source-viewer}/primary-source-viewer.js +2 -2
  311. package/dist/components/{radar-chart → organisms/radar-chart}/radar-chart.js +1 -1
  312. package/dist/components/{range-calendar → organisms/range-calendar}/range-calendar.js +1 -1
  313. package/dist/components/{route-map → organisms/route-map}/route-map.js +1 -1
  314. package/dist/components/{run-timeline → organisms/run-timeline}/run-timeline.js +3 -3
  315. package/dist/components/{sankey-chart → organisms/sankey-chart}/sankey-chart.js +1 -1
  316. package/dist/components/{search-dialog → organisms/search-dialog}/search-dialog.js +3 -3
  317. package/dist/components/organisms/settings-list/settings-list.js +125 -0
  318. package/dist/components/{share-dialog → organisms/share-dialog}/share-dialog.js +41 -27
  319. package/dist/components/organisms/share-dialog-people/share-dialog-people.js +412 -0
  320. package/dist/components/{slideshow → organisms/slideshow}/slideshow.js +36 -21
  321. package/dist/components/{static-code → organisms/static-code}/static-code-copy.js +2 -2
  322. package/dist/components/{static-code → organisms/static-code}/static-code.js +1 -1
  323. package/dist/components/{story-map → organisms/story-map}/story-map.js +1 -1
  324. package/dist/components/{subscription-card → organisms/subscription-card}/subscription-card.js +6 -4
  325. package/dist/components/{terminal → organisms/terminal}/terminal.js +6 -6
  326. package/dist/components/{tree-view → organisms/tree-view}/tree-view.js +42 -5
  327. package/dist/components/{tutorial-complete → organisms/tutorial-complete}/tutorial-complete.js +5 -5
  328. package/dist/components/{tutorial-mdx → organisms/tutorial-mdx}/tutorial-mdx.js +27 -21
  329. package/dist/components/{wallet-card → organisms/wallet-card}/wallet-card.js +4 -4
  330. package/dist/components/{canvas-shell → templates/canvas-shell}/canvas-shell.js +1 -1
  331. package/dist/index.d.ts +2237 -1068
  332. package/dist/index.js +14 -0
  333. package/dist/lib/focus-calendar-day.js +13 -0
  334. package/dist/lib/roving-focus.js +70 -0
  335. package/dist/lib/use-escape-key.js +6 -3
  336. package/dist/lib/use-event-callback.js +15 -0
  337. package/dist/lib/use-focus-containment.js +74 -0
  338. package/dist/lib/use-return-focus.js +23 -0
  339. package/dist/tailwind-preset.js +16 -0
  340. package/dist/types/side-effect-imports.d.js +0 -0
  341. package/package.json +73 -71
  342. package/styles.css +59 -11
  343. package/themes/default.css +30 -11
  344. package/themes/presets.css +76 -76
  345. package/themes/products.css +146 -0
  346. package/dist/components/avatar/avatar.js +0 -54
  347. package/dist/components/breadcrumb/breadcrumb.js +0 -68
  348. package/dist/components/code-block/code-block.js +0 -144
  349. package/dist/components/completion-dialog/completion-dialog.js +0 -204
  350. package/dist/components/cookie-consent/cookie-consent.js +0 -174
  351. package/dist/components/cursor/cursor.js +0 -52
  352. package/dist/components/dock/dock.js +0 -109
  353. package/dist/components/magnetic/magnetic.js +0 -63
  354. package/dist/components/magnetic-button/magnetic-button.js +0 -64
  355. package/dist/components/marquee/marquee.js +0 -97
  356. package/dist/components/pagination/pagination.js +0 -44
  357. package/dist/components/progress-bar/progress-bar.js +0 -56
  358. package/dist/components/scroll-area/scroll-area.js +0 -48
  359. package/dist/components/spotlight-card/spotlight-card.js +0 -53
  360. package/dist/components/tabs/tabs.js +0 -132
  361. package/dist/components/tilt-card/tilt-card.js +0 -70
  362. /package/dist/components/{aspect-ratio → atoms/aspect-ratio}/aspect-ratio.js +0 -0
  363. /package/dist/components/{collapsible → atoms/collapsible}/collapsible.js +0 -0
  364. /package/dist/components/{lang-provider → atoms/lang-provider}/lang-provider.js +0 -0
  365. /package/dist/components/{share-section → atoms/share-section}/share-section.js +0 -0
  366. /package/dist/components/{sidebar-provider → atoms/sidebar-provider}/sidebar-provider.js +0 -0
  367. /package/dist/components/{social-fab → atoms/social-fab}/use-social-fab.js +0 -0
  368. /package/dist/components/{theme-provider → atoms/theme-provider}/theme-provider.js +0 -0
  369. /package/dist/components/{flow-diagram → organisms/flow-diagram}/types.js +0 -0
  370. /package/dist/components/{mdx-content → organisms/mdx-content}/mdx-content.js +0 -0
  371. /package/dist/components/{navbar-saas → organisms/navbar-saas}/use-mobile.js +0 -0
  372. /package/dist/components/{canvas-shell → templates/canvas-shell}/canvas-shell-route-config.js +0 -0
package/CHANGELOG.md CHANGED
@@ -6,16 +6,210 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ### Changed
10
+
11
+ - **Dark surfaces are pure black** - the default dark theme now renders
12
+ `--background`, `--muted`, `--card` and `--popover` as `0 0 0` (#000000).
13
+ Hairline borders separate the surfaces: `--border`, `--secondary` and
14
+ `--accent` stay `0.2686` (#262626), and `--input` is unchanged. Before,
15
+ `--muted` was `0.2686` (#262626) and `--card` / `--popover` were `0.1445`
16
+ (#0a0a0a). A `bg-card` or `bg-popover` surface needs a `border` to show its
17
+ edge; every shipped one has it, and a test now fails on one that does not.
18
+ The separators in `DropdownMenu`, `Menubar` and `Select` draw with
19
+ `bg-border` instead of `bg-muted`, which is the page color now, and a test
20
+ fails on any one-pixel divider that uses `bg-muted`. Light mode is unchanged.
21
+ Themes that override these roles (presets, Maia) keep their values; PaaS and
22
+ any app that reads the dark `--muted`, `--card` or `--popover` directly get
23
+ black.
24
+ - **Hover, selected and data-state fills use `secondary`** - 32 component files
25
+ (`Table`, `Tabs` pill, `Toggle`, `Slideshow`, `FilterBar` and others) used
26
+ `bg-muted` for that feedback, which is now the page color in dark.
27
+ They use `bg-secondary` with the same opacity. In the default and PaaS themes
28
+ the fill is the same color as before in light and dark, because `--secondary`
29
+ equals the old `--muted` there. Theme presets keep a quiet neutral
30
+ `--secondary` (their `--accent` is a brand color), so text on these fills
31
+ stays at 6.65 to 12.53:1 in dark. The Maia theme has its own dark `--muted`
32
+ (`0.2002`) and a core dark `--secondary` (`0.2686`), so its dark hover fills
33
+ are one step lighter than before.
34
+ `SegmentedControl`, `ViewSwitcher`, `WorkspaceSwitcher` and the `PricingTable`
35
+ period toggle draw their track with `bg-secondary` for the same reason: the
36
+ selected segment is `bg-background` on that track.
37
+ - **Skeletons, tracks and handles use `secondary`** - 29 `bg-muted` fills in 23
38
+ component files were the whole visual of their element: `Skeleton`, the
39
+ `ProgressBar`, `Meter`, `Tour`, `Checklist`, `UsageBreakdown` and other
40
+ progress, meter and usage tracks, the `Drawer` handle, the empty cells of
41
+ `ActivityHeatmap` and the neutral `GanttChart` bar. They use `bg-secondary`
42
+ (#262626) with the same opacity, because `bg-muted` is the page color in dark
43
+ and they would disappear. Chips, code spans and panels keep `bg-muted`: their
44
+ text and border carry them. A test fails on a `bg-muted` skeleton or bar.
45
+
9
46
  ### Added
10
47
 
11
- - Source-only React Native renderer and shared design contracts for the 0.4.0 canary track; stable Web installation remains unchanged.
48
+ - **Product themes stylesheet** - `@vllnt/ui/themes/products.css` ships the
49
+ Maia and PaaS themes as `html[data-theme="maia"]` and
50
+ `html[data-theme="paas"]`, each with a `.dark` block. It is generated from
51
+ `packages/design/tokens.json`. Load Figtree (Maia) and JetBrains Mono
52
+ (Maia, PaaS) in your app; the package does not ship the fonts.
53
+ - **Status and diff colors** - CSS variables `--success`, `--warning`,
54
+ `--info`, their `-foreground` pairs, `--diff-added` and `--diff-removed` in
55
+ `themes/default.css` and `styles.css`, and matching Tailwind colors
56
+ (`success`, `warning`, `info`, `diff.added`, `diff.removed`) in the preset.
57
+ - **Label type step** - `--font-size-label`, `--line-height-label` and
58
+ `--font-weight-label`.
59
+ - **Sidebar `pathname` prop** - names the page the sidebar marks as current.
60
+ It defaults to the router's pathname, so existing usage is unchanged. Pass
61
+ it when the URL the visitor sees differs from the route that renders, such as
62
+ a prerendered locale or variant route, instead of overriding the router's
63
+ pathname context.
64
+ - **Sidebar `prefetch` prop** - set it to `false` to stop the sidebar's links
65
+ from prefetching their pages. Left unset, the links keep the router's default
66
+ prefetching, so existing usage is unchanged. A sidebar with dozens of links
67
+ in view otherwise prefetches every one of them on page load.
68
+
69
+ ### Fixed
70
+
71
+ - **Tap targets** - the NavbarSaas links, the Breadcrumb crumbs, the
72
+ TableOfContents buttons and the Sidebar family heading link are at least
73
+ 24 px tall (WCAG 2.5.8); they were 20 px.
74
+
75
+ ### Fixed
76
+
77
+ - **Accordion accessibility** - each trigger now has `aria-controls` pointing
78
+ at its panel, and each panel is a `region` labelled by its trigger. Closed
79
+ panels are `inert`, so screen readers no longer read closed answers and Tab
80
+ skips links inside them. The open and close animation is unchanged.
81
+
82
+ ## [0.4.0] - 2026-10-31
83
+
84
+ ### Added
85
+
86
+ - **New hooks** - `useFocusContainment` (trap Tab inside a custom modal and
87
+ restore focus on close) and `useEventCallback` (stable callback that always
88
+ calls the latest closure). Registry items import them from `@vllnt/ui`.
89
+ - **Props types exported from the barrel** - `BreadcrumbProps`,
90
+ `CommandDialogProps`, `SheetContentProps`, `CarouselProps`, `CodeBlockProps`,
91
+ `MDXContentProps`, `SidebarProps`, `TableOfContentsProps`,
92
+ `CategoryFilterProps`, `SearchBarProps`, `ShareSectionProps`,
93
+ `SearchDialogProps`, `LangProviderProps`, `ThemeToggleProps`,
94
+ `ProfileSectionProps`, `TLDRSectionProps`, `AreaChartProps`, `BarChartProps`,
95
+ `LineChartProps` and `ThemePresetProviderProps`.
96
+
97
+ - Source-only React Native renderer and shared design contracts (`@vllnt/ui-core`, `@vllnt/ui-native`). They are experimental and not published with this release; installing `@vllnt/ui` is unchanged.
12
98
  - Localized Native catalog discovery, dependency/capability comparison, and extensible React/React Native source tabs in a single component preview surface.
99
+ - **Accessibility gate** - the Storybook test-runner runs axe-core (WCAG 2.0,
100
+ 2.1 and 2.2, levels A and AA) on every story in the light and dark theme and
101
+ fails on any violation. A story can turn a rule off only through
102
+ `parameters.a11y.config.rules` with a written `reason`. (#543)
103
+ - **Optional accessibility props** (English defaults, nothing required):
104
+ `popoverLabel` on Combobox, MultiSelect, DatePicker, DateRangePicker,
105
+ TimePicker and ColorPicker; `aria-label` / `aria-labelledby` /
106
+ `aria-describedby` / `id` on Combobox; `aria-label` / `aria-labelledby` on
107
+ InlineInput and ScrollArea; NumberInput `incrementLabel` / `decrementLabel`;
108
+ Marquee and TickerTape `pauseControl` + `labels`; TabsContent `tabIndex`;
109
+ GanttChartLabels `region`; CompletionDialog `modal`; Pagination `labels`;
110
+ AIArtifactLabels `content`; ModelSelector `listLabel`; DataTableFilter
111
+ `ariaLabel`; VideoEmbed `playLabel`. (#543)
112
+ - **New exports** - `moveRovingFocus` (+ `RovingFocusOptions`,
113
+ `RovingOrientation`), `useReturnFocus` (+ `ReturnFocusHandlers`),
114
+ `focusCalendarDay`, `CHECKLIST_PROGRESS_EVENT`, `parseChecklistStorageValue`,
115
+ `MarqueeLabels`, `TickerTapeLabels`, `PaginationLabels`. Registry items now
116
+ import these from `@vllnt/ui`, so installing them needs a `@vllnt/ui` release
117
+ that contains them (the registry pins `^0.3.0`, which does not).
118
+ `registry:integrity` now fails when a registry item imports a name that
119
+ `@vllnt/ui` does not export. (#543)
120
+
121
+ ### Changed
122
+
123
+ - **Colour tokens meet WCAG AA** (#538). The default light theme uses a darker
124
+ `--muted-foreground`, `--destructive` and `--input`; in the dark theme
125
+ `--destructive` is lighter with a dark foreground and `--input` is lighter, so
126
+ input borders are easier to see in both. Presets adjust `--primary`,
127
+ `--destructive`, `--input` and `--ring` the same way. Visual snapshots change.
128
+ - **Font tokens on `:root`** - `styles.css` now defines `--font-sans`,
129
+ `--font-display` and `--font-mono` on `:root`. If your app sets variables
130
+ with these names, declare them later in the cascade or on `body` so yours win.
131
+ - **Lighter imports** (#541) - CodeBlock renders its code as plain text first
132
+ and highlights it once the Prism build loads on the client; TutorialMDX loads
133
+ the MDX compiler only for content with JSX, and FlowDiagram loads
134
+ `html-to-image` only when copied. Apps that use neither `toast` nor
135
+ `Toaster` no longer bundle sonner.
136
+ - **Smaller package** - the tarball has 361 files instead of 659: the
137
+ per-component re-export stubs and `dist/test-setup.js` are gone.
138
+ Only the `exports` entry points are public, so imports do not change.
139
+
140
+ - **Peer dependency ranges now match what the package needs.** `next` is
141
+ `>=15.0.0` (Next 14 peers React 18, which the React 19 build cannot use),
142
+ `tailwindcss` is `^3.4.0` (components use `size-*`, `text-balance` and
143
+ `has-[]`, and the preset and CSS are Tailwind v3 only), and `next-themes` is
144
+ now a required peer because the root entry imports it. `next` stays optional
145
+ in metadata, but the root entry still imports `next/link`, `next/image` and
146
+ `next/navigation`, so non-Next apps must alias them (see the README
147
+ workaround). `react` and `react-dom` stay `>=19.0.0`: SearchBar and Slideshow
148
+ no longer call React 19.2's `useEffectEvent`, so 19.0 and 19.1 work.
149
+
150
+ - **Accessibility behaviour changes** (#543):
151
+ - Drawer moves focus into its content on open (`autoFocus` now defaults to
152
+ `true`; pass `autoFocus={false}` for vaul's previous behaviour).
153
+ - CompletionDialog is built on the Radix dialog: it traps focus, closes on
154
+ Escape and returns focus to the opener. `modal` (default `true`) maps to
155
+ Radix `modal`; `modal={false}` leaves the page behind it interactive.
156
+ Shortcuts work only while focus is inside the dialog, an empty string turns
157
+ one off, and Enter no longer confirms from any focused element.
158
+ - Marquee and TickerTape show a 24px pause/play button by default
159
+ (`pauseControl={false}` hides it). It overlays the top-right corner of the
160
+ Marquee and the right edge of the TickerTape, and hides under reduced
161
+ motion, when nothing moves.
162
+ - Pagination renders a `nav` landmark of single links styled as buttons, with
163
+ `aria-current="page"` on the current page (it used to nest a button in each
164
+ link).
165
+ - CodeBlock syntax colours come from the `--vllnt-code-*` CSS variables
166
+ (OKLCH channels) instead of JS theme detection. The defaults reach 4.5:1 on
167
+ the background in light and dark mode for the default theme and every
168
+ preset; override the variables to restyle.
169
+ - CommandSeparator renders an `aria-hidden` divider.
170
+ - Under `prefers-reduced-motion`, components stop their own decorative
171
+ animation and AnimatedText shows its final text at once; loaders marked
172
+ `data-motion="essential"` keep spinning, slower. The stylesheet changes
173
+ motion only on library components, never on your own elements.
174
+ - TabsContent is a tab stop only when the panel holds no focusable element;
175
+ the ScrollArea viewport is a tab stop only while its content scrolls.
176
+ - TreeView supports Home / End, ArrowRight to the first child and ArrowLeft
177
+ to the parent, and keeps the active row in view.
13
178
 
14
179
  ### Fixed
15
180
 
181
+ - **Setup docs** - the Tailwind config in both READMEs, the installation page
182
+ and the agent skill now lists `./node_modules/@vllnt/ui/dist/**/*.js` in
183
+ `content`. Tailwind 3 ignores a preset's `content` once the app sets its own,
184
+ so the documented config generated no component styles. The agent skill's
185
+ peer ranges and colour format (OKLCH) are corrected too.
186
+ - **Tailwind preset dependency** - `tailwindcss-animate`, which
187
+ `@vllnt/ui/tailwind-preset` imports, is now a runtime dependency. With 0.3.0
188
+ the preset failed to load unless the app installed it.
189
+ - **Duplicate React keys** - Terminal, FileUpload, AvatarGroup, Breadcrumb and
190
+ about 20 other list renderers no longer key rows by content or label alone,
191
+ so repeated or blank entries stop triggering duplicate-key errors. FileUpload
192
+ adds an identical file (same name, size and lastModified) once, so removal
193
+ removes one entry, and a selection that adds nothing new does not call
194
+ `onFilesChange`.
195
+ - **`"use client"` directives** - Toolbar, Stepper, AIChatInput, ObjectCard,
196
+ OverviewBoard and ZoomHUD use event handlers or browser globals and now carry
197
+ the directive. `check:use-client` also flags handler props and browser globals.
198
+ - **Focus in custom dialogs** - KeyboardShortcutsHelp, TableOfContentsPanel,
199
+ the FlowDiagram fullscreen view and the Slideshow contents panel keep Tab and
200
+ Shift+Tab inside the dialog and return focus to the opener on close.
201
+ - **DataTable** sortable headers expose `aria-sort`.
202
+ - **Contrast** - Rating stars and the green success icons in Checklist,
203
+ Curriculum and LearningObjectives reach 3:1 against the background in light
204
+ and dark themes.
205
+ - **Decorative inline `<svg>` icons** are hidden from assistive technology.
206
+
16
207
  - Preserve nested scrolling, reduced-motion behavior and sidebar keyboard focus in the affected Web components.
17
208
  - Forward explicit tab accessibility relationships and label/keyboard handlers without changing default tab navigation.
18
209
  - Emit JSON-LD graph documents and localized Native discovery metadata without advertising unpublished npm packages.
210
+ - Accessible names, ARIA structure, APG keyboard patterns (tabs, radio groups,
211
+ listbox, tree, dialogs and focus return), reduced motion and hard-coded
212
+ palette contrast across the Web components flagged by the #535 audit. (#543)
19
213
 
20
214
  ## [0.3.0] - 2026-06-26
21
215
 
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @vllnt/ui
2
2
 
3
- React component library — 309 components built on Radix UI primitives, Tailwind CSS, and CVA.
3
+ React component library — 321 components built on Radix UI primitives, Tailwind CSS, and CVA.
4
4
 
5
5
  See [CHANGELOG.md](./CHANGELOG.md) for release history.
6
6
 
@@ -15,15 +15,69 @@ pnpm add @vllnt/ui
15
15
  Required:
16
16
 
17
17
  ```bash
18
- pnpm add react react-dom tailwindcss
18
+ pnpm add react react-dom tailwindcss next-themes
19
19
  ```
20
20
 
21
- Optional (only if using ThemeProvider, NavbarSaas, or other Next.js-specific components):
21
+ `react` and `react-dom` >= 19.0.0, `tailwindcss` ^3.4.0, `next-themes` >= 0.4.0 (a React-only library; it works outside Next.js).
22
+
23
+ Next.js (>= 15.0.0) is an optional peer, but the root entry imports `next/link`, `next/image` and `next/navigation` at module level. Install `next` unless you alias those modules (below).
22
24
 
23
25
  ```bash
24
- pnpm add next next-themes
26
+ pnpm add next
27
+ ```
28
+
29
+ #### Without Next.js (workaround)
30
+
31
+ Importing anything from `@vllnt/ui` loads every component, including the ones that use `next/*`. In a bundler without Next.js (for example Vite), alias the three modules to small stubs. Verified to build with Vite 7; runtime behaviour of the stubbed components (`Breadcrumb`, `Pagination`, `Sidebar`, `SearchBar`, `NavbarSaas`, ...) is not guaranteed.
32
+
33
+ ```ts
34
+ // vite.config.ts - workaround, not an officially supported setup
35
+ import { fileURLToPath } from "node:url";
36
+ import { defineConfig } from "vite";
37
+
38
+ const stub = (file: string) =>
39
+ fileURLToPath(new URL(`./next-stubs/${file}`, import.meta.url));
40
+
41
+ export default defineConfig({
42
+ resolve: {
43
+ alias: [
44
+ { find: /^next\/link$/, replacement: stub("link.js") },
45
+ { find: /^next\/image$/, replacement: stub("image.js") },
46
+ { find: /^next\/navigation$/, replacement: stub("navigation.js") },
47
+ ],
48
+ },
49
+ });
50
+ ```
51
+
52
+ Stub files (workaround for non-Next bundlers; place them in `next-stubs/`):
53
+
54
+ ```jsx
55
+ // next-stubs/link.js
56
+ import { createElement } from "react";
57
+ export default function Link({ href, prefetch, replace, scroll, ...props }) {
58
+ return createElement("a", { href: typeof href === "string" ? href : href?.pathname, ...props });
59
+ }
60
+ ```
61
+
62
+ ```jsx
63
+ // next-stubs/image.js
64
+ import { createElement } from "react";
65
+ export default function Image({ src, alt = "", fill, priority, quality, placeholder, blurDataURL, loader, unoptimized, ...props }) {
66
+ return createElement("img", { src: typeof src === "string" ? src : src?.src, alt, ...props });
67
+ }
68
+ ```
69
+
70
+ ```js
71
+ // next-stubs/navigation.js
72
+ export const usePathname = () => "/";
73
+ export const useRouter = () => ({
74
+ push() {}, replace() {}, back() {}, forward() {}, refresh() {}, prefetch() {},
75
+ });
76
+ export const useSearchParams = () => new URLSearchParams();
25
77
  ```
26
78
 
79
+ Plain Node ESM import is not supported.
80
+
27
81
  ## Setup
28
82
 
29
83
  ### 1. Tailwind Preset
@@ -38,7 +92,9 @@ export default {
38
92
  presets: [uiPreset],
39
93
  content: [
40
94
  "./src/**/*.{ts,tsx}",
41
- // The preset auto-includes @vllnt/ui content paths
95
+ // Required: Tailwind 3 ignores a preset's `content` once your config sets
96
+ // its own, so list the package's compiled components here.
97
+ "./node_modules/@vllnt/ui/dist/**/*.js",
42
98
  ],
43
99
  };
44
100
  ```
@@ -60,6 +116,8 @@ import "@vllnt/ui/styles.css";
60
116
 
61
117
  This imports Tailwind base/components/utilities + default theme variables + safe-area utilities.
62
118
 
119
+ If TypeScript reports TS2882 for this import (newer versions check side-effect imports), add `declare module "*.css";` to a `.d.ts` file in your app.
120
+
63
121
  ### 3. Use Components
64
122
 
65
123
  ```tsx
@@ -84,6 +142,7 @@ export function Example() {
84
142
  | `@vllnt/ui/styles.css` | Full styles (Tailwind base + theme variables + utilities) |
85
143
  | `@vllnt/ui/themes/default.css` | Theme CSS variables only (no Tailwind base) |
86
144
  | `@vllnt/ui/themes/presets.css` | Built-in color presets (applied via `data-theme`) |
145
+ | `@vllnt/ui/themes/products.css` | Product themes `maia` and `paas` (generated; applied via `data-theme`) |
87
146
 
88
147
  ## Theming
89
148
 
@@ -100,13 +159,13 @@ All colors are **OKLCH channel** CSS variables (`L C H`), consumed as
100
159
  --secondary: 0.9703 0 0;
101
160
  --secondary-foreground: 0.2044 0 0;
102
161
  --muted: 0.9703 0 0;
103
- --muted-foreground: 0.5555 0 0;
162
+ --muted-foreground: 0.525 0 0;
104
163
  --accent: 0.9703 0 0;
105
164
  --accent-foreground: 0.2044 0 0;
106
- --destructive: 0.6368 0.2078 25.326;
165
+ --destructive: 0.55 0.2078 25.326;
107
166
  --destructive-foreground: 0.9848 0 0;
108
167
  --border: 0.9219 0 0;
109
- --input: 0.9219 0 0;
168
+ --input: 0.66 0 0;
110
169
  --ring: 0.1445 0 0;
111
170
  --radius: 0.5rem;
112
171
  --card: 1 0 0;
@@ -133,6 +192,32 @@ at runtime with `<ThemeSwitcher />` (or `setThemePreset` / `useThemePreset`),
133
192
  which set `data-theme` on the document root. Render `<ThemePresetProvider />`
134
193
  once near the root to restore the saved preset before paint.
135
194
 
195
+ ### Product themes
196
+
197
+ `@vllnt/ui/themes/products.css` adds two full product themes, generated from
198
+ `packages/design/tokens.json`. Import it after `styles.css`, set
199
+ `data-theme="maia"` or `data-theme="paas"` on `<html>`, and keep using the
200
+ `dark` class for dark mode:
201
+
202
+ ```html
203
+ <html data-theme="maia" class="dark">
204
+ ```
205
+
206
+ - `maia`: pink primary, Figtree and JetBrains Mono, tighter type scale and radius.
207
+ Its Label step is capitals in the design: add `uppercase` where you use it.
208
+ - `paas`: core neutrals and status tones in JetBrains Mono. Dark is the design
209
+ default; light works too.
210
+
211
+ The package does not ship fonts. Core puts Inter (sans) and JetBrains Mono
212
+ (mono) first, then the system stacks. Load Inter, JetBrains Mono (core, Maia and
213
+ PaaS) and Figtree (Maia) in your app, for example with `next/font` or a font
214
+ `<link>`; without them each stack falls back to the system font stack
215
+ (`system-ui` for core sans and Maia, `ui-monospace` for core mono and PaaS).
216
+
217
+ Both define `success`, `warning`, `info`, `diff-added` and `diff-removed` roles
218
+ (the core theme defines them as well). Web `--radius` carries the theme's
219
+ `md` step only; the other radius steps ship in the `@vllnt/ui-core` outputs.
220
+
136
221
  To design and export your own theme, use the visual editor at
137
222
  [`/themes`](https://ui.vllnt.com/themes) — it exports a CSS block, a
138
223
  `npx shadcn add` command, or design tokens.
@@ -436,10 +521,10 @@ import type {
436
521
 
437
522
  ## Requirements
438
523
 
439
- - React >= 18.0.0
440
- - Tailwind CSS >= 3.0.0
441
- - Next.js >= 14.0.0 (optional — only for `ThemeProvider`, `NavbarSaas`, `LangProvider`)
442
- - `next-themes` >= 0.4.0 (optional — only for `ThemeProvider`, `ThemeToggle`)
524
+ - React >= 19.0.0
525
+ - Tailwind CSS ^3.4.0 (`size-*`, `text-balance` and `has-[...]` utilities need 3.4; Tailwind 4 is not supported)
526
+ - `next-themes` >= 0.4.0 (required peer)
527
+ - Next.js >= 15.0.0 (optional peer, but the root entry imports `next/*`; see Peer Dependencies for the no-Next workaround). Next 14 only supports React 18.
443
528
 
444
529
  ## License
445
530
 
@@ -1,8 +1,22 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
- import { createContext, use, useCallback, useMemo, useState } from "react";
4
- import { cn } from "../../lib/utils.js";
3
+ import {
4
+ createContext,
5
+ use,
6
+ useCallback,
7
+ useId,
8
+ useMemo,
9
+ useState
10
+ } from "react";
11
+ import { cn } from "../../../lib/utils.js";
5
12
  const AccordionContext = createContext(null);
13
+ function getPartId(baseId, part, value) {
14
+ const key = value.replaceAll(
15
+ /[^\dA-Za-z-]/g,
16
+ (character) => `_${(character.codePointAt(0) ?? 0).toString(16)}_`
17
+ );
18
+ return `${baseId}-${part}-${key}`;
19
+ }
6
20
  function useAccordionContext() {
7
21
  const context = use(AccordionContext);
8
22
  if (!context) {
@@ -16,6 +30,7 @@ function Accordion({
16
30
  defaultValue,
17
31
  type = "single"
18
32
  }) {
33
+ const baseId = useId();
19
34
  const [openItems, setOpenItems] = useState(() => {
20
35
  if (!defaultValue) return /* @__PURE__ */ new Set();
21
36
  if (Array.isArray(defaultValue)) return new Set(defaultValue);
@@ -39,8 +54,8 @@ function Accordion({
39
54
  [type]
40
55
  );
41
56
  const contextValue = useMemo(
42
- () => ({ openItems, toggleItem, type }),
43
- [openItems, toggleItem, type]
57
+ () => ({ baseId, openItems, toggleItem, type }),
58
+ [baseId, openItems, toggleItem, type]
44
59
  );
45
60
  return /* @__PURE__ */ jsx(AccordionContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsx(
46
61
  "div",
@@ -76,18 +91,20 @@ function AccordionTrigger({
76
91
  icon,
77
92
  value
78
93
  }) {
79
- const { openItems, toggleItem } = useAccordionContext();
94
+ const { baseId, openItems, toggleItem } = useAccordionContext();
80
95
  const isOpen = openItems.has(value);
81
96
  return /* @__PURE__ */ jsxs(
82
97
  "button",
83
98
  {
99
+ "aria-controls": getPartId(baseId, "content", value),
84
100
  "aria-expanded": isOpen,
85
101
  className: cn(
86
102
  "w-full flex items-center justify-between p-4 text-left font-medium transition-colors",
87
- "hover:bg-muted/50",
88
- isOpen && "bg-muted/30",
103
+ "hover:bg-secondary/50",
104
+ isOpen && "bg-secondary/30",
89
105
  className
90
106
  ),
107
+ id: getPartId(baseId, "trigger", value),
91
108
  onClick: () => {
92
109
  toggleItem(value);
93
110
  },
@@ -106,6 +123,7 @@ function AccordionTrigger({
106
123
  ) : /* @__PURE__ */ jsx(
107
124
  "svg",
108
125
  {
126
+ "aria-hidden": "true",
109
127
  className: cn(
110
128
  "size-4 flex-shrink-0 transition-transform duration-200",
111
129
  isOpen && "rotate-180"
@@ -133,15 +151,19 @@ function AccordionContent({
133
151
  className,
134
152
  value
135
153
  }) {
136
- const { openItems } = useAccordionContext();
154
+ const { baseId, openItems } = useAccordionContext();
137
155
  const isOpen = openItems.has(value);
138
156
  return /* @__PURE__ */ jsx(
139
157
  "div",
140
158
  {
159
+ "aria-labelledby": getPartId(baseId, "trigger", value),
141
160
  className: cn(
142
161
  "overflow-hidden transition-all duration-200",
143
162
  isOpen ? "max-h-[1000px] opacity-100" : "max-h-0 opacity-0"
144
163
  ),
164
+ id: getPartId(baseId, "content", value),
165
+ inert: !isOpen,
166
+ role: "region",
145
167
  children: /* @__PURE__ */ jsx(
146
168
  "div",
147
169
  {
@@ -16,7 +16,7 @@ import {
16
16
  Loader2,
17
17
  MinusCircle
18
18
  } from "lucide-react";
19
- import { cn } from "../../lib/utils.js";
19
+ import { cn } from "../../../lib/utils.js";
20
20
  const STATUS_CLASSES = {
21
21
  completed: {
22
22
  iconClass: "text-emerald-600 dark:text-emerald-400",
@@ -48,7 +48,14 @@ const DEFAULT_STATUS_ICON = {
48
48
  completed: /* @__PURE__ */ jsx(CheckCircle2, { "aria-hidden": "true", className: "size-4" }),
49
49
  error: /* @__PURE__ */ jsx(AlertTriangle, { "aria-hidden": "true", className: "size-4" }),
50
50
  pending: /* @__PURE__ */ jsx(Circle, { "aria-hidden": "true", className: "size-4" }),
51
- running: /* @__PURE__ */ jsx(Loader2, { "aria-hidden": "true", className: "size-4 animate-spin" }),
51
+ running: /* @__PURE__ */ jsx(
52
+ Loader2,
53
+ {
54
+ "aria-hidden": "true",
55
+ className: "size-4 animate-spin motion-reduce:[animation-duration:1.5s]",
56
+ "data-motion": "essential"
57
+ }
58
+ ),
52
59
  skipped: /* @__PURE__ */ jsx(MinusCircle, { "aria-hidden": "true", className: "size-4" })
53
60
  };
54
61
  const StepContext = createContext({ status: "pending" });
@@ -289,7 +296,7 @@ const AgentStepProgress = ({
289
296
  "aria-valuemax": 100,
290
297
  "aria-valuemin": 0,
291
298
  "aria-valuenow": clamped,
292
- className: cn("h-1.5 w-full rounded-full bg-muted", className),
299
+ className: cn("h-1.5 w-full rounded-full bg-secondary", className),
293
300
  ref,
294
301
  role: "progressbar",
295
302
  ...rest,
@@ -1,6 +1,6 @@
1
1
  import { jsx, jsxs } from "react/jsx-runtime";
2
2
  import { ExternalLink, Quote } from "lucide-react";
3
- import { cn } from "../../lib/utils.js";
3
+ import { cn } from "../../../lib/utils.js";
4
4
  const AISourceCitation = ({
5
5
  className,
6
6
  href,
@@ -15,7 +15,7 @@ const AISourceCitation = ({
15
15
  "a",
16
16
  {
17
17
  className: cn(
18
- "group inline-flex max-w-full flex-col gap-2 rounded-xl border border-border/70 bg-background px-3 py-2 text-left shadow-sm transition-colors hover:bg-muted/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
18
+ "group inline-flex max-w-full flex-col gap-2 rounded-xl border border-border/70 bg-background px-3 py-2 text-left shadow-sm transition-colors hover:bg-secondary/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
19
19
  className
20
20
  ),
21
21
  href,
@@ -1,5 +1,5 @@
1
1
  import { jsx, jsxs } from "react/jsx-runtime";
2
- import { cn } from "../../lib/utils.js";
2
+ import { cn } from "../../../lib/utils.js";
3
3
  const AIStreamingText = ({
4
4
  className,
5
5
  cursor = "\u258D",
@@ -25,7 +25,7 @@ const AIStreamingText = ({
25
25
  "span",
26
26
  {
27
27
  "aria-hidden": "true",
28
- className: "ml-0.5 inline-block animate-pulse text-muted-foreground",
28
+ className: "ml-0.5 inline-block animate-pulse text-muted-foreground motion-reduce:animate-none",
29
29
  children: cursor
30
30
  }
31
31
  ) : null
@@ -1,6 +1,6 @@
1
1
  import { jsx } from "react/jsx-runtime";
2
2
  import { cva } from "class-variance-authority";
3
- import { cn } from "../../lib/utils.js";
3
+ import { cn } from "../../../lib/utils.js";
4
4
  const alertVariants = cva(
5
5
  "relative w-full rounded-lg border p-4 [&>svg~*]:pl-7 [&>svg+div]:translate-y-[-3px] [&>svg]:absolute [&>svg]:left-4 [&>svg]:top-4 [&>svg]:text-foreground",
6
6
  {
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
- import { cn } from "../../lib/utils.js";
3
+ import { cn } from "../../../lib/utils.js";
4
4
  const SEVERITY_STROKE = {
5
5
  error: "stroke-red-500",
6
6
  info: "stroke-blue-500",
@@ -73,7 +73,7 @@ const AlertPulse = ({
73
73
  "origin-center",
74
74
  SEVERITY_STROKE[severity],
75
75
  SEVERITY_FILL[severity],
76
- reducedMotion ? null : "animate-ping"
76
+ reducedMotion ? null : "animate-ping motion-reduce:animate-none"
77
77
  ),
78
78
  cx: size / 2,
79
79
  cy: size / 2,
@@ -1,5 +1,5 @@
1
1
  import { jsx } from "react/jsx-runtime";
2
- import { cn } from "../../lib/utils.js";
2
+ import { cn } from "../../../lib/utils.js";
3
3
  const toneClasses = {
4
4
  bidirectional: "border-violet-500/40 bg-violet-500/15 text-violet-700 dark:text-violet-300",
5
5
  input: "border-sky-500/40 bg-sky-500/15 text-sky-700 dark:text-sky-300",
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
3
3
  import * as React from "react";
4
- import { cn } from "../../lib/utils.js";
4
+ import { cn } from "../../../lib/utils.js";
5
5
  function usePrefersReducedMotion() {
6
6
  const [reduced, setReduced] = React.useState(false);
7
7
  React.useEffect(() => {
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
3
  import * as React from "react";
4
- import { cn } from "../../lib/utils.js";
4
+ import { cn } from "../../../lib/utils.js";
5
5
  function createSquares(count) {
6
6
  return Array.from({ length: count }, () => ({
7
7
  delay: Math.random() * 5,
@@ -1,6 +1,6 @@
1
1
  import { jsx } from "react/jsx-runtime";
2
2
  import * as React from "react";
3
- import { cn } from "../../lib/utils.js";
3
+ import { cn } from "../../../lib/utils.js";
4
4
  const AnimatedList = ({
5
5
  children,
6
6
  className,