Versions

Added

• Source-only React Native renderer and shared design contracts for the 0.4.0 canary track; stable Web installation remains unchanged.
• Localized Native catalog discovery, dependency/capability comparison, and extensible React/React Native source tabs in a single component preview surface.
• Accessibility gate - the Storybook test-runner runs axe-core (WCAG 2.0, 2.1 and 2.2, levels A and AA) on every story in the light and dark theme and fails on any violation. A story can turn a rule off only through parameters.a11y.config.rules with a written reason. (#543)
• Optional accessibility props (English defaults, nothing required): popoverLabel on Combobox, MultiSelect, DatePicker, DateRangePicker, TimePicker and ColorPicker; aria-label / aria-labelledby / aria-describedby / id on Combobox; aria-label / aria-labelledby on InlineInput and ScrollArea; NumberInput incrementLabel / decrementLabel; Marquee and TickerTape pauseControl + labels; TabsContent tabIndex; GanttChartLabels region; CompletionDialog modal; Pagination labels; AIArtifactLabels content; ModelSelector listLabel; DataTableFilter ariaLabel; VideoEmbed playLabel. (#543)
• New exports - moveRovingFocus (+ RovingFocusOptions, RovingOrientation), useReturnFocus (+ ReturnFocusHandlers), focusCalendarDay, CHECKLIST_PROGRESS_EVENT, parseChecklistStorageValue, MarqueeLabels, TickerTapeLabels, PaginationLabels. Registry items now import these from @vllnt/ui, so installing them needs a @vllnt/ui release that contains them (the registry pins ^0.3.0, which does not). registry:integrity now fails when a registry item imports a name that @vllnt/ui does not export. (#543)

Changed

• Accessibility behaviour changes (#543):
  • Drawer moves focus into its content on open (autoFocus now defaults to true; pass autoFocus={false} for vaul's previous behaviour).
  • CompletionDialog is built on the Radix dialog: it traps focus, closes on Escape and returns focus to the opener. modal (default true) maps to Radix modal; modal={false} leaves the page behind it interactive. Shortcuts work only while focus is inside the dialog, an empty string turns one off, and Enter no longer confirms from any focused element.
  • Marquee and TickerTape show a 24px pause/play button by default (pauseControl={false} hides it). It overlays the top-right corner of the Marquee and the right edge of the TickerTape, and hides under reduced motion, when nothing moves.
  • Pagination renders a nav landmark of single links styled as buttons, with aria-current="page" on the current page (it used to nest a button in each link).
  • CodeBlock syntax colours come from the --vllnt-code-* CSS variables (OKLCH channels) instead of JS theme detection. The defaults reach 4.5:1 on the background in light and dark mode for the default theme and every preset; override the variables to restyle.
  • CommandSeparator renders an aria-hidden divider.
  • Under prefers-reduced-motion, components stop their own decorative animation and AnimatedText shows its final text at once; loaders marked data-motion="essential" keep spinning, slower. The stylesheet changes motion only on library components, never on your own elements.
  • TabsContent is a tab stop only when the panel holds no focusable element; the ScrollArea viewport is a tab stop only while its content scrolls.
  • TreeView supports Home / End, ArrowRight to the first child and ArrowLeft to the parent, and keeps the active row in view.

Fixed

• Preserve nested scrolling, reduced-motion behavior and sidebar keyboard focus in the affected Web components.
• Forward explicit tab accessibility relationships and label/keyboard handlers without changing default tab navigation.
• Emit JSON-LD graph documents and localized Native discovery metadata without advertising unpublished npm packages.
• Accessible names, ARIA structure, APG keyboard patterns (tabs, radio groups, listbox, tree, dialogs and focus return), reduced motion and hard-coded palette contrast across the Web components flagged by the #535 audit. (#543)

Added

• Release intelligence surface — /changelog, /releases, /rss.xml, and /atom.xml expose one changelog source through HTML, GitHub release cards, and feed readers. /docs/changelog redirects to /changelog.

• Hooks + utility primitives — CopyButton (+ useCopyToClipboard hook), Banner + BannerAction, Kbd, EmptyState, DocumentSiblingNav.

• Pricing + identity cards — PricingTable + PricingPlan, HistoricalFigureCard, CivilizationCard (+ CivilizationComparison).

• Newsletter — NewsletterSignup (state-machine driven submit flow).

• AI compound families — ModelComparison (+ Column, Meta, Vote), PromptTemplates, AgentActivity, AISidebar, AIArtifact.

• Era / financial — EraComparison, TransactionList.

• Forms — Form, MultiSelect, SegmentedControl, TagsInput, AutoReload.

• Educational — KnowledgeCheck (inline question runner).

• Charts + timelines — GanttChart, ParallelTimeline, Timeline + TimelineItem, HistoricTimeline, InteractiveTimeline, ChronologicalTimeline, TreeView.

• Document + reading — PrimarySourceViewer compound family.

• Maps + geography — Map2D, ChoroplethMap, RouteMap, HeatMapOverlay, GeographyQuizMap, MapTimeline, StoryMap, Globe3D.

• Canvas foundation — CanvasShell, CanvasView, InfinitePlane, ViewportBookmarks, WorldBreadcrumbs, TopBar, LeftRail, RightDock, ZoomHud, MiniMapPanel, WorkspaceSwitcher.

• Canvas selection + manipulation — SelectionHalo, SnapGuides, FloatingToolbar, MultiSelectLasso, FollowMode, HandoffBeacon.

• Canvas spatial objects — ObjectCard, ObjectHandle, AnchorPort, ConnectorEdge, EdgeLabel, GroupHull.

• Canvas collaboration primitives — LiveCursor, CommentPin, PresenceSyncIndicator, PresenceStack, SelectionPresence, ThreadBubble.

• Inspector + dock panels — PropertySection, ObjectInspector, RelationshipInspector, RuntimeOverviewPanel, RoutingAssignmentPanel, PolicyDeliveryPanel.

• Runtime overlays — AlertPulse, ThresholdRing, StickyMetric, HeatOverlay, StateBadgeOverlay, MetricCluster, JarvisDock, ContextLens.

• Time navigation — TimelineScrubber, PlaybackGhost, BottomActivityStrip, RunTimeline.

• Form primitives (18) — ButtonGroup, InputGroup, Field, Fieldset, Item, ColorPicker, CheckboxGroup, NativeSelect, ListBox, SearchField, TextField, PhoneInput, TimePicker, TimeField, DateField, DateRangePicker, RangeCalendar, TagGroup.

• Charts / dataviz (5) — PieChart, RadarChart, GaugeChart, SankeyChart, ContributionGraph (joining the existing BarChart / LineChart / AreaChart).

• AI primitives (3) — Reasoning, ChainOfThought, PromptInput.

• Core primitives (7) — Typography, Link, Toolbar, Meter, QrCode, Grid, Panel.

• Motion / effects (37) — BentoGrid, Sparkles, Typewriter, AnimatedList, Dock, MagneticButton, TextShimmer, AnimatedBeam, AnimatedTabs, ScrollProgress, ShimmerButton, ShimmerText, AnimatedGridPattern, AnimatedTestimonials, AnimatedTooltip, BlurReveal, CardFlip, Cursor, DotPattern, ExpandableCards, FloatingNavbar, GlassCard, GlassProgress, LiquidGlass, Magnetic, Meteors, Particles, ProgressiveBlur, RevealText, ScrambleText, ShineBorder, ShinyButton, SpinningText, SpotlightCard, TextAnimate, TextReveal, TiltCard.

• Total component count: 309 (up from 140).

• OKLCH theming system — color tokens migrated to the OKLCH color space, with 13 runtime theme presets (default, matrix, dracula, synthwave, tron, cyberpunk, nord, claude, chatgpt, gemini, dusk, cyberlime, aura). New public theme exports from @vllnt/ui: THEME_PRESETS, DEFAULT_THEME_PRESET, CUSTOM_THEME_NAME, isThemePresetName, the ThemePreset and ThemePresetName types, plus the useThemePreset hook (with UseThemePresetResult), setThemePreset, and setCustomTheme for runtime preset switching and user-supplied custom themes.

• A11y heading-level override — every title-bearing component (ProfileSection, FAQ, Slideshow, WorldClockBar, TableOfContentsPanel, TableOfContents, KeyboardShortcutsHelp, Watchlist, OrderBook, HorizontalScrollRow, MarketTreemap, ActivityHeatmap, Glossary, StatusBoard, CodePlayground, Comparison, Quiz, Exercise, ShareSection, CompletionDialog, Checklist, LearningObjectives, CandlestickChart, StepByStep) accepts an as prop ("h1"–"h6"); multi-title components (ContentIntro, TutorialComplete) expose titleAs + tocLabelAs / sectionLabelAs. Defaults preserve existing heading tags. HeadingTag is re-exported from @vllnt/ui.

Changed

• BREAKING — React 19 required. The peer dependency moved to react / react-dom >=19; React 18 is no longer supported. Components migrated from React.forwardRef to the React 19 ref-as-prop pattern, and useContext → use(). React-18 consumers must upgrade to React 19.
• Internal quality sweep — cleared the react-doctor backlog: no-react19-deprecated-apis 456 → 0, plus state/effect warnings (useEffectEvent for effect-captured handlers, derived-state, cascading setState) and structural warnings (giant-component splits, render-in-render, polymorphic children, passive listeners).
• Shared internals — extracted reusable hooks/utilities (reference-counted body-scroll-lock that fixes a multi-overlay unlock bug, escape-key, live-date, cached Intl formatters, clipboard migration) and a Zod parse seam for the registry shape.
• Registry installs use a hybrid CLI strategy — leaf component source is inlined, sibling registry items resolve via @vllnt/ui to keep installs minimal and dedupe shared primitives.

Fixed

• Docs sidebar dropped components — the registry category union omitted four categories (ai, billing, data-display, educational), silently hiding ~32 components from the docs sidebar; all now render, with a structural fallback so a missing category can no longer regress.
• Theme-adaptive chart colors — CandlestickChart and SparklineGrid series colors now follow the active theme and dark mode instead of hardcoded values.

Fixed

• Public API: ProgressCard now re-exported from @vllnt/ui — it shipped in 0.2.0's tarball but was missing from the barrel, so import { ProgressCard } from "@vllnt/ui" resolved to undefined.

Docs

• Correct casing for the AI family (AIChatInput, AIMessageBubble, AISourceCitation, AIStreamingText, AIToolCallDisplay) and SocialFAB across README, package README, CHANGELOG, and llms-full.txt.

Added

• AI family — AIChatInput, AIMessageBubble, AISourceCitation, AIStreamingText, AIToolCallDisplay, ThinkingBlock, ModelSelector.
• Financial family — CandlestickChart, MarketTreemap, OrderBook, TickerTape, SparklineGrid, WalletCard, Watchlist.
• Ops / Status family — StatusBoard, StatusIndicator, LiveFeed, WorldClockBar, SeverityBadge, RoleBadge, ScopeSelector.
• Billing & Plans family — SubscriptionCard, PlanBadge, CreditBadge, UsageBreakdown.
• Animation family — AnimatedText, BorderBeam, Marquee, NumberTicker, and a standalone spinner library exported via Spinner.
• Educational family — Flashcard, Stepper, Tour, Annotation, CompletionDialog, TruncatedText, TableOfContentsPanel.
• Form additions — DatePicker, FileUpload, NumberInput, PasswordInput, InlineInput, Combobox, Rating.
• Data / metric additions — DataTable, DataList, StatCard, MetricGauge, ActivityHeatmap, ActivityLog.
• App shell additions — CategoryFilter, FilterBar, CookieConsent, Slideshow, CountdownTimer, AvatarGroup, FloatingActionButton, SocialFab, KeyboardShortcutsHelp, ShareDialog, HorizontalScrollRow, ViewSwitcher.
• Total component count: 144 (up from 93).
• Full Storybook integration with E2E smoke tests in CI.
• OG image generation for every registry page.
• Signed provenance attestations on every published artifact (sigstore).

Changed

• Documentation domain moved to ui.vllnt.com / storybook.vllnt.ai.
• Default package registry is the public npm registry (no longer GitHub Packages).
• README component tables expanded to cover all 144 components organized by family.

Fixed

• Publish workflow now uses npx --yes npm@latest publish so OIDC trusted publishing survives GitHub runners that ship pre-11.5.1 npm.

Fixed

• Re-extract tarball path from pnpm pack output for publish step.

Changed

• Switched to pnpm pack + npm publish flow to support publishConfig with OIDC auth.

Fixed

• Use pnpm publish and repair release creation step in CI.

Fixed

• Annotated tags + --notes-file for release creation.

Added

• HorizontalScrollRow, ViewSwitcher, and useHorizontalScroll hook.

Fixed

• Comparison: defensive prop validation to prevent runtime crash on malformed input.

Fixed

• Bundle-free build to preserve per-file "use client" directives in published chunks.

Fixed

• Add "use client" to all dist JS including index.js.

Fixed

• Exclude index.js from "use client" banner.

Fixed

• Add "use client" directive to published dist chunks.

Added

• Initial public publish to the public npm registry.

@vllnt/ui v0.1.0

Initial open-source release of the React component library.

Highlights

• 93 components built on Radix UI primitives, Tailwind CSS, and CVA
• Full Tailwind preset with theme colors, animations, and dark mode
• CSS variable theming system
• Tree-shakeable ESM build
• TypeScript strict mode with full type exports

Install

Components

Form controls, layout, feedback & overlays, navigation, data display, app shells, and content/tutorial components. See README for full list.

Requirements

• React >= 18
• Tailwind CSS >= 3
• Next.js >= 14 (optional)
• next-themes >= 0.4 (optional)