Changelog

Release history and version notes for Hareru UI

0.8.0

@hareru/ui@0.8.0

New Components

  • PreviewCard — Hover-triggered floating preview card for links, built on Base UI PreviewCard. Follows Tooltip/Popover pattern with Portal + Positioner + Popup composition. Trigger renders <a> by default with asChild support. Popover-like card style with scale animation.
  • Toolbar — Action control container with ToolbarButton (CVA variant/size), ToolbarGroup, ToolbarSeparator, and ToolbarLink. Built on Base UI Toolbar with roving tabindex keyboard navigation. Supports horizontal/vertical orientation and disabled state.
  • CheckboxGroup — Group wrapper for multiple Checkbox components with shared value/defaultValue/onValueChange state management. Supports "select all" via allValues + parent prop on Checkbox.
  • Component count: 57 → 60.

0.7.0

@hareru/ui@0.7.0

New Components

  • ToggleGroup — Group of toggle buttons where one or multiple can be pressed. Built on Base UI ToggleGroup + Toggle primitives. Supports single/multiple mode, controlled/uncontrolled value, disabled state (group and individual), orientation (horizontal/vertical), keyboard navigation, and CVA size/variant props matching the standalone Toggle.
  • ContextMenu — Right-click context menu with the same sub-component structure as DropdownMenu (items, checkboxes, radio items, separators, labels, shortcuts, submenus). Built on Base UI ContextMenu. Trigger renders a <div> by default with asChild support and always applies the hui-context-menu__trigger BEM class.
  • Component count: 55 → 57.

0.6.0

@hareru/ui@0.6.0

New Components

  • Breadcrumb — Navigation breadcrumb trail showing the current page location within a hierarchy. Composite component with BreadcrumbList, BreadcrumbItem, BreadcrumbLink (asChild for router integration), BreadcrumbPage, BreadcrumbSeparator (customizable), and BreadcrumbEllipsis.
  • Pagination — Page navigation with numbered links, previous/next controls, and ellipsis for long page ranges. PaginationLink supports isActive state, CVA size variants (sm, md, lg), and asChild. PaginationPrevious/Next support disabled prop with 4-layer disabled control (CSS pointer-events, tabIndex, onClick preventDefault, aria-disabled).
  • Component count: 53 → 55.

Fixes

  • Added Accordion and Slider to docs sidebar (meta.json) and README component tables (omitted in previous release).

0.5.0

@hareru/ui@0.5.0

New Components

  • Accordion — Vertically stacked set of interactive headings that each reveal a section of content. Built on Base UI Accordion primitives. Supports single/multiple mode, controlled/uncontrolled value, disabled items, and keyboard navigation.
  • Slider — Input control for selecting a numeric value or range by dragging a thumb. Built on Base UI Slider primitives. CVA size variants (sm, md, lg), range slider support, and full keyboard/a11y.
  • Component count: 51 → 53.

0.5.1

@hareru/registry@0.4.2 · @hareru/mcp@0.4.2 · @hareru/cli@0.4.1

Error Hardening

  • Registry loader — Per-step error handling (read/parse/resolve) with { cause } chain preservation. Error messages now include filename, path, and root cause for easier debugging.
  • MCP server — No longer crashes when registry artifacts are missing at startup. Resources return JSON error objects, tools return isError: true, and prompts return error text instead of throwing.
  • CLI — Shared printRegistryError() helper with contextual hints: "not found" suggests pnpm build, "parse" suggests corruption, "read" suggests permissions. Consistent styled error output across add, list, and info commands.

0.5.0

@hareru/cli@0.4.0

CLI

  • hareru init — New command for project setup. Auto-detects framework (Next.js, Vite, Remix, Astro) and CSS mode, generates a managed CSS block with /* hareru:start managed */ markers and hareru.json config.
  • hareru update — New command for CSS mode switching. Rewrites the managed block content (standalone ↔ portable ↔ tailwind) and updates hareru.json.
  • Colored output — All CLI output now uses semantic colors via picocolors. Automatically disabled in non-TTY environments and when NO_COLOR is set.
  • Managed block — CSS imports are wrapped in marker comments. The CLI only modifies content inside the block. @import 'tailwindcss' is kept outside as an app-managed line.
  • Security — Path traversal prevention on cssFile in hareru.json. ENOENT/EACCES errors handled gracefully.

0.4.0

@hareru/ui@0.4.0 · @hareru/registry@0.4.1 · @hareru/mcp@0.4.1 · @hareru/cli@0.3.1

New Components

  • Checkbox — Binary selection control with checked, unchecked, and indeterminate states. Built on Base UI Checkbox primitives.
  • RadioGroup — Single-select radio group with implicit label association via <label> + aria-labelledby. Built on Base UI RadioGroup/Radio primitives.

Enhancements

  • FormField group mode — New group prop and FormFieldGroupLabel sub-component for accessible labelling of grouped controls (e.g., RadioGroup). Uses role="group" + aria-labelledby instead of <label htmlFor>.
  • Component count: 49 → 51.

Documentation

  • Added Registry documentation page — Loaders, Types, CSS Mode, Slot Tree, Stability.
  • Added React Hook Form guide — register/Controller patterns with complete form example.

0.3.0

@hareru/ui@0.3.0 · @hareru/registry@0.4.0 · @hareru/mcp@0.4.0 · @hareru/cli@0.3.0

Slot Contracts

  • Added SlotDef and SlotRole types for describing JSX nesting contracts of compound components.
  • Added buildSlotTree() shared helper for rendering slot trees as formatted ASCII text.
  • 25 compound components now include slots data (117 slot definitions).
  • MCP get-component-usage and CLI hareru info include a Structure section.

Documentation

  • Registry-driven Structure, States, and Accessibility sections on component pages.

0.2.0

@hareru/ui@0.2.0 · @hareru/registry@0.3.0 · @hareru/mcp@0.3.0 · @hareru/cli@0.2.0

Registry Enrichment

  • StateDef, A11yDef, ExampleDef types added to @hareru/registry.
  • All 49 components enriched with hand-written a11y, states, and examples data.
  • MCP get-component-usage and CLI hareru info include States, Accessibility, and Example sections.

MCP & CLI

  • Added recommend-css-mode and list-components-by-group tools.
  • Added create-ui-tailwind prompt (5 tools, 3 prompts total).
  • CssMode type and recommendCssMode() shared via @hareru/registry.

0.1.1

@hareru/ui@0.1.1 · @hareru/tokens@0.1.1

Fixes

  • Replaced Japanese UI strings with English in AsyncComboboxField.
  • Updated package metadata (homepage, LICENSE).

0.1.0

Initial public release of Hareru UI.

  • 49 React components with accessible Base UI primitives
  • OKLCH-based semantic color system with light/dark themes
  • 150+ design tokens as CSS custom properties (DTCG format)
  • 4 CSS distribution modes: standalone, portable, Tailwind v4 (Cascade Layers), per-component
  • @hareru/mcp — MCP server with 6 resources, 5 tools, 3 prompts
  • @hareru/cli — CLI for component management (list, info, add with --write)
  • @hareru/registry — Shared types, loaders, and CSS mode recommendation
  • AG-UI chat components (ChatContainer, ChatMessage, ChatComposer, StreamingText, ToolCallCard, ApprovalCard, ReasoningPanel)
  • Typography composite tokens (h1–h4, body, body-sm, caption)
  • .cursorrules and llms.txt for AI agent guidance
  • BEM naming convention with CVA variant management

React Hook Form

Official recipes for connecting Hareru UI components to React Hook Form

On this page

0.8.0New Components0.7.0New Components0.6.0New ComponentsFixes0.5.0New Components0.5.1Error Hardening0.5.0CLI0.4.0New ComponentsEnhancementsDocumentation0.3.0Slot ContractsDocumentation0.2.0Registry EnrichmentMCP & CLI0.1.1Fixes0.1.0