2.0.3

[haaarshsingh]

Based on the context and the major rewrite to v2, here's a comprehensive changelog for the v2.0.3 release:

kmenu v2.0.3

Major Rewrite: Welcome to kmenu v2

This release represents a complete architectural overhaul of kmenu with a focus on performance, developer experience, and maintainability.

Breaking Changes

This is a major version with breaking changes. If you're upgrading from v1.x, please follow our comprehensive Migration Guide to update your implementation.

New Architecture

• Monorepo Structure: Split into separate @kmenu/core and @kmenu/react packages
• Headless Core: Framework-agnostic command palette logic
• React Components: Composable, accessible React components
• TypeScript First: Complete TypeScript rewrite with improved type safety

New Features

Composable API

Replace the old MenuProvider/CommandWrapper pattern with a more flexible component-based approach:

// v2 API
import { Command, CommandInput, CommandList, CommandOption } from '@kmenu/react'

<Command>
  <CommandInput placeholder="Search..." />
  <CommandList>
    <CommandOption>Option 1</CommandOption>
    <CommandOption>Option 2</CommandOption>
  </CommandList>
</Command>

Performance Improvements

• Faster Filtering: Improved fuzzy search algorithm
• Better SSR: Enhanced server-side rendering support
• Reduced Bundle Size: Optimized package splitting

Enhanced Styling

• CSS Variables: Easy theming with CSS custom properties
• Better Accessibility: Improved ARIA support and keyboard navigation
• Responsive Design: Better mobile experience

Bug Fixes (v2.0.3)

• Fixed: Build errors when importing from @kmenu/core and @kmenu/react packages
• Fixed: SSR compatibility issues with React 19
• Fixed: React Hook dependency warnings in development
• Fixed: Icon rendering issues during server-side prerendering
• Fixed: Model viewer component hydration mismatches
• Fixed: Import path resolution in monorepo structure

Improvements

• Enhanced: TypeScript definitions for better IDE support
• Enhanced: Error messages and debugging experience
• Enhanced: Documentation and examples
• Enhanced: Package.json exports for better module resolution

Package Structure

• kmenu: Core headless logic (framework-agnostic)
• @kmenu/react: React components and hooks

Migration Required

Important: This release requires code changes to upgrade from v1.x. The API has been completely redesigned for better developer experience and performance.

Follow the Migration Guide for step-by-step instructions.

Updated Documentation

• New examples showcasing v2 capabilities
• Complete API reference
• Migration guide with before/after comparisons
• TypeScript usage patterns

---

Installation

npm install kmenu @kmenu/react
# or
pnpm add kmenu @kmenu/react
# or
yarn add kmenu @kmenu/react
# or
bun add kmenu @kmenu/react

Full Changelog: v1.4.32...v2.0.3

---

This discussion was created from the release 2.0.3.