Skip to main content

Changelog

All notable changes to VhyxUI are documented here. This project follows Semantic Versioning.

v0.1.0-alpha.1

Alpha

First public alpha release of VhyxUI. All 22 Tier 1 components are implemented, tested, and documented. The token system, accessibility layer, motion system, and VhyxSeal agent contracts all ship together.

What's included

  • @vhyxui/tokens — Full CSS custom property system. Primitives, semantic layer, dark mode, reset, and motion keyframes. Zero JavaScript. No build step.
  • @vhyxui/core — Shared TypeScript types, VhyxSeal default contracts for all 22 components, Slot implementation for the asChild pattern, and VhyxUIError error class.
  • @vhyxui/react — All 22 Tier 1 components with full prop APIs, accessibility (WCAG 2.1 AA), motion, and VhyxSeal contracts. Dual CJS / ESM build. Tree-shakeable per-component imports.
  • VhyxUIProvider — Root provider with skip-link, Toast region, and theme context.
  • toast() imperative API — Call toast(), toast.success(), toast.danger() from anywhere without props or context wiring.
  • Form + Field architecture — First-class Field component auto-wires label, hint, and error to the child input. Native react-hook-form + Zod integration.
  • Agent contracts — Every component ships with a default VhyxSeal contract readable via data-vhyx-contract. Destructive Button variant auto-upgrades to safetyLevel: critical.
  • Dark mode — Full semantic token set for [data-theme="dark"]. No extra CSS to write.
  • prefers-reduced-motion — All duration tokens collapse to 0ms automatically. Zero JavaScript required.

All 22 components

Inputs & Forms

  • Button
  • Input
  • Textarea
  • Select
  • Checkbox
  • Radio
  • Switch
  • Form & Field

Feedback

  • Toast
  • Alert
  • Badge
  • Progress
  • Spinner

Overlay

  • Dialog
  • Drawer
  • Tooltip
  • Popover

Layout

  • Card
  • Separator

Navigation

  • Tabs
  • Breadcrumb
  • Pagination

Known limitations

  • No React Native support — web only in alpha.
  • Form component requires react-hook-form; standalone usage with native form state is not yet documented.
  • VhyxSeal contracts ship as data attributes but the full manifest generation CLI is not yet published.
  • SSR-safe animation is handled via CSS only; JavaScript-driven exit animations on unmount are not supported.
  • No Storybook integration yet — the Playground (play.vhyxui.com) serves as the interactive reference.
  • Dark mode requires data-theme="dark" on a parent element — automatic system-preference detection requires opt-in via ThemeProvider.
  • Accordion and Combobox are Tier 2 components and are not yet included.
Alpha notice. This is a pre-release. APIs are stable but not semver-frozen until v0.1.0. Minor breaking changes may occur between alpha versions. Pin your version and check this changelog before upgrading.