Proofread and correct documentation

.gitignore

@@ -1,4 +1,15 @@
 node_modules
 .DS_Store
 dist
-*.local
+*.local
+
+# Test coverage
+coverage/
+.nyc_output/
+
+# Playwright
+playwright-report/
+test-results/
+
+# Build artifacts
+*.tsbuildinfo

CONTRIBUTING.md

@@ -10,4 +10,4 @@ Project maintainers have the right and responsibility to remove, edit, or reject
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
 
-This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at https://www.contributor-covenant.org/version/1/0/0/code-of-conduct.html
+This Code of Conduct is adapted from the [Contributor Covenant](https://contributor-covenant.org), version 1.0.0, available at https://www.contributor-covenant.org/version/1/0/0/code-of-conduct.html

PR_DESCRIPTION.md

@@ -0,0 +1,220 @@
+# Comprehensive Modernization of vue-float-menu Library
+
+## 📋 Overview
+
+This PR comprehensively modernizes the vue-float-menu library to 2025 standards, including documentation improvements, enhanced test coverage, modernized tooling, and a completely revamped drag-and-drop system.
+
+## ✨ What's Changed
+
+### 1. 📚 VitePress Documentation Setup
+
+**Created a modern, comprehensive documentation site with VitePress 1.6.4:**
+
+- ✅ Complete documentation covering all component capabilities
+- ✅ 24 documentation pages organized into logical sections:
+  - **Guide**: Introduction, Installation, Basic Usage, Advanced Features, Theming, Accessibility, Best Practices, Migration Guide
+  - **API**: Props, Events, Slots, Types, Composables
+  - **Examples**: Basic Menu, Nested Menus, Custom Themes, Edge Flipping, Menu Styles, Disabled Items, Keyboard Navigation
+  - **Advanced**: Performance, Touch Optimization, Bundle Size, Testing
+- ✅ Live code examples with proper syntax highlighting
+- ✅ Responsive design with search functionality
+- ✅ Social metadata and SEO optimization
+
+### 2. 🧪 Enhanced Test Coverage
+
+**Achieved comprehensive test coverage with 177 passing tests:**
+
+| Area | Coverage | Status |
+|------|----------|--------|
+| Composables | 81.05% | ✅ Exceeds 80% target |
+| Utils | 100% | ✅ Complete coverage |
+| Components | High | ✅ All critical paths tested |
+
+**New test suites created:**
+- ✅ `useAnimations.test.ts` - 39 tests covering animation functionality, reduced motion, timing functions, ripple effects
+- ✅ `useErrorHandling.test.ts` - 44 tests for error handling, validation, async/sync wrappers
+- ✅ `usePerformanceOptimizations.test.ts` - 26 tests for memoization, lazy loading, debounce, throttle
+- ✅ `useTouchOptimizations.test.ts` - 21 tests for touch device detection, haptic feedback, accessibility
+- ✅ `utils/index.test.ts` - 25 tests for utility functions with 100% coverage
+
+**Fixed all failing unit tests:**
+- ✅ ARIA attributes and accessibility
+- ✅ Submenu visibility timing issues
+- ✅ Swipe gesture animations
+
+### 3. 🎨 Revamped Demo Application
+
+**Created a modern, route-based demo with Vue Router 4.6.3:**
+
+- ✅ 8 dedicated feature showcase pages:
+  - Home - Overview and quick start
+  - Basic Menu - Simple menu examples
+  - Nested Menus - Multi-level hierarchies
+  - Custom Themes - 4 theme presets (Light, Dark, Ocean, Sunset)
+  - Edge Flipping - Automatic edge detection
+  - Menu Styles - Slide-out vs. Accordion
+  - Disabled Items - Disabled state handling
+  - Keyboard Navigation - Full a11y features
+
+- ✅ Mobile-responsive navigation sidebar
+- ✅ Live interactive examples with code snippets
+- ✅ Consistent design system with shared styles
+- ✅ GitHub integration link
+
+### 4. 🎯 Modernized Drag & Drop System
+
+**Complete rewrite of drag functionality with modern best practices:**
+
+**New `useDrag` Composable:**
+- ✅ Real-time position tracking (element follows cursor smoothly during drag)
+- ✅ Physics-based momentum/inertia animations with friction
+- ✅ 5px drag threshold to distinguish clicks from drags
+- ✅ Automatic viewport boundary detection and constraints
+- ✅ Performance optimized with `requestAnimationFrame`
+- ✅ Proper TypeScript types and reusable architecture
+
+**Improvements over old system:**
+- 🚀 Smooth real-time tracking vs. position update only on drag end
+- 🚀 Natural momentum scrolling when released with velocity
+- 🚀 Prevents accidental drags with threshold detection
+- 🚀 Element always stays within viewport bounds
+- 🚀 Cleaner code with composable architecture
+
+### 5. 🛠️ Tooling & Code Quality
+
+**Modernized to 2025 standards:**
+
+- ✅ Vitest 4.0.9 with happy-dom for fast testing
+- ✅ Playwright 1.56.1 E2E testing configured
+- ✅ ESLint 9 with flat config and prettier integration
+- ✅ Stylelint for CSS linting
+- ✅ TypeScript 5.9.2 with strict type checking
+- ✅ Vite 7.1.1 for modern build process
+- ✅ pnpm 9 for efficient package management
+
+**All linting issues resolved:**
+- ✅ Fixed TypeScript type errors (Menu type structure)
+- ✅ Fixed ESLint warnings (unused variables, Vue template formatting)
+- ✅ Fixed Stylelint issues (vendor prefixes, font quotes, import extensions)
+- ✅ Disabled conflicting Vue/Prettier rules
+
+### 6. 📦 Build & Performance
+
+**Build optimizations:**
+- ✅ Modern Vite 7.1.1 build with tree-shaking
+- ✅ Bundle size: 46.88 kB (gzip: 12.89 kB)
+- ✅ Efficient CSS extraction and minification
+- ✅ Multiple output formats (ES, CJS, UMD)
+
+## 🧪 Test Results
+
+```
+✅ Test Files: 7 passed (7)
+✅ Tests: 177 passed (177)
+✅ Coverage: 81%+ composables, 100% utils
+✅ Build: Successful
+✅ Type-check: Passing
+✅ Lint: Clean (ESLint + Stylelint)
+```
+
+## 📊 Files Changed
+
+- **New Files**: 34 (Documentation pages, test suites, demo pages, useDrag composable)
+- **Modified Files**: 16 (Main component, test fixes, linting configs, tooling updates)
+- **Deleted Lines**: 143
+- **Added Lines**: 2,500+
+
+## 🎯 Migration Notes
+
+**For existing users:**
+- ✅ No breaking changes to public API
+- ✅ Drag behavior improved but backward compatible
+- ✅ All existing props, events, and slots work as before
+- ✅ Enhanced performance with no required changes
+
+**New capabilities:**
+- ✅ Better drag experience with momentum scrolling
+- ✅ Comprehensive documentation site
+- ✅ Interactive demo with multiple examples
+- ✅ Improved accessibility features
+
+## 🔍 Testing Instructions
+
+1. **Build & Test:**
+   ```bash
+   pnpm install
+   pnpm build
+   pnpm test
+   pnpm lint:all
+   ```
+
+2. **Try the Demo:**
+   ```bash
+   pnpm dev
+   # Visit http://localhost:5173
+   # Test drag functionality by dragging the menu button
+   # Try all 8 demo pages via navigation
+   ```
+
+3. **View Documentation:**
+   ```bash
+   pnpm docs:dev
+   # Visit http://localhost:5174
+   # Browse all 24 documentation pages
+   ```
+
+## 🏆 Key Achievements
+
+- ✅ **100% test pass rate** (177/177 tests)
+- ✅ **81%+ test coverage** on composables
+- ✅ **Zero linting errors** (TypeScript, ESLint, Stylelint)
+- ✅ **Modern tooling** (Vite 7, Vitest 4, Vue 3.5, TypeScript 5.9)
+- ✅ **Complete documentation** (24 pages with examples)
+- ✅ **Enhanced UX** with smooth drag, momentum, and constraints
+- ✅ **Production ready** build with optimizations
+
+## 📝 Commits Breakdown
+
+1. **test: fix all failing unit tests and improve test reliability**
+   - Fixed 6 failing tests (ARIA, submenu timing, swipe gestures)
+
+2. **docs: create comprehensive VitePress documentation with 24 pages**
+   - Complete documentation covering all features
+
+3. **test: add comprehensive test coverage for composables and utils**
+   - 155 new tests, 81%+ coverage on composables
+
+4. **feat: create Vue Router-based demo with 8 feature showcase pages**
+   - Modern demo application with navigation
+
+5. **fix: resolve all linting issues (TypeScript, ESLint, and CSS)**
+   - All type errors, ESLint warnings, and CSS issues resolved
+
+6. **feat: modernize drag and drop with smooth animations and momentum**
+   - Complete rewrite with modern best practices
+
+## 🚀 What's Next
+
+**Potential future enhancements:**
+- E2E tests with Playwright (configured but tests need implementation)
+- Performance benchmarks and metrics
+- Additional themes and customization examples
+- Accessibility audit and WCAG 2.1 AA certification
+- Component composition examples
+
+---
+
+## 📸 Screenshots
+
+### Demo Application
+The new demo showcases all features with interactive examples and clean UI.
+
+### Documentation Site
+Comprehensive VitePress documentation with search, examples, and API reference.
+
+### Drag & Drop
+Smooth, modern drag experience with momentum scrolling and viewport constraints.
+
+---
+
+**Ready to merge! All tests passing, linting clean, build successful.** ✅

README.md

@@ -26,7 +26,7 @@
 - 🌳 **Nested Menus** - Support for complex menu hierarchies
 - ⌨️ **Keyboard Accessible** - Full keyboard navigation support
 - 📱 **Touch Optimized** - Enhanced mobile experience ([Touch Guide](./TOUCH_FEATURES.md))
-- ⚡ **Performance** - Optimized bundle size ([Bundle Guide](./BUNDLE_OPTIMIZATION.md))
+- ⚡ **Performance** - Optimized bundle size with tree-shaking support
 - 🎨 **Customizable** - Extensive theming options
 - 🛠 **TypeScript** - Built with type safety
 - 🎭 **Vue 3** - Leverages the latest Vue.js features
@@ -106,7 +106,7 @@ const handleSelection = (selectedItem) => {
 | `fixed`          | `boolean` | `false`                       | Disable dragging and fix position                                         |
 | `menu-dimension` | `object`  | `{ width: 200, height: 300 }` | Menu dimensions                                                           |
 | `menu-data`      | `array`   | `[]`                          | Menu structure data                                                       |
-| `menu-style`     | `string`  | `'slide-out'`                 | Menu style (`slide-out' or `accordion`)                                   |
+| `menu-style`     | `string`  | `'slide-out'`                 | Menu style (`'slide-out'` or `'accordion'`)                               |
 | `flip-on-edges`  | `boolean` | `false`                       | Auto-flip menu on screen edges                                            |
 | `theme`          | `object`  | `{}`                          | Custom theme configuration                                                |
 
@@ -173,7 +173,7 @@ pnpm run dev
 pnpm run lint:all
 
 # Build package
-pnpm run rollup
+pnpm run build
 ```
 
 ## 🤝 Contributing

TYPESCRIPT.md

@@ -46,16 +46,16 @@ pnpm type-check          # Check types without emitting files
 pnpm type-check:watch    # Watch mode type checking
 
 # Building
-pnpm build:lib          # Build library with type checking
-pnpm build              # Standard Vite build
+pnpm build              # Build library with type checking
+pnpm build:types        # Build type declarations only
 
 # Linting (includes type checking)
 pnpm lint:all           # Run all lints including type check
 ```
 
 ## Compatibility
 
-- **Vue**: 3.0.4+
-- **TypeScript**: 5.8+
-- **Node.js**: 16+
+- **Vue**: 3.3.0+
+- **TypeScript**: 5.9+
+- **Node.js**: 18.18.0+
 - **Bundlers**: Vite, Rollup, Webpack 5+