directix 1.7.0 → 1.9.0

package/README.md

@@ -3,6 +3,8 @@
 [![npm version](https://img.shields.io/npm/v/directix.svg)](https://www.npmjs.com/package/directix)
 [![npm downloads](https://img.shields.io/npm/dm/directix.svg)](https://www.npmjs.com/package/directix)
 [![GitHub license](https://img.shields.io/github/license/saqqdy/directix)](https://github.com/saqqdy/directix/blob/master/LICENSE)
+[![CI](https://github.com/saqqdy/directix/actions/workflows/ci.yml/badge.svg)](https://github.com/saqqdy/directix/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/saqqdy/directix/branch/master/graph/badge.svg)](https://codecov.io/gh/saqqdy/directix)
 
 **English** | **[中文文档](README_CN.md)**
 
@@ -19,6 +21,139 @@ A comprehensive, easy-to-use, and high-performance Vue custom directives library
 - ⚡ **Zero Dependencies** - Lightweight with minimal bundle size
 - 🎨 **Composables** - Every directive has a corresponding composable for Composition API
 - 🔧 **Utility Exports** - Export `configurePermission`, `getPermissionConfig` and other utilities for advanced usage
+- 🌐 **i18n Support** - Built-in internationalization with Chinese, English, and Japanese translations
+- 🔌 **Plugin System** - Extensible plugin architecture for community contributions
+
+## What's New in v1.9.0
+
+### Internationalization (i18n)
+
+Full i18n support for directive messages and documentation.
+
+```typescript
+import { createI18n, setLocale } from 'directix'
+
+// Initialize with locale
+createI18n({
+  locale: 'en-US',
+  fallbackLocale: 'en-US',
+  messages: { 'en-US': enUS, 'zh-CN': zhCN, 'ja-JP': jaJP }
+})
+
+// Switch locale at runtime
+setLocale('zh-CN')
+```
+
+### Unified Warning System
+
+Improved developer experience with structured error messages.
+
+```typescript
+import { warn, directiveWarn, assertType } from 'directix'
+
+// Directive-specific warnings
+directiveWarn('debounce', 'errors.invalid_wait', { wait: 'abc' })
+
+// Type assertions
+assertType<number>(value, 'number', 'debounce', 'wait')
+```
+
+### Plugin System
+
+Extensible plugin architecture for community contributions.
+
+```typescript
+import { definePlugin, getPluginManager } from 'directix'
+
+const myPlugin = definePlugin({
+  meta: { name: 'my-plugin', version: '1.0.0' },
+  install(ctx) {
+    ctx.registerDirective('my-directive', vMyDirective)
+  }
+})
+
+getPluginManager().register(myPlugin)
+```
+
+### Community Plugin Registry
+
+Discover and install community plugins programmatically.
+
+```typescript
+import { getPluginRegistry } from 'directix'
+
+const registry = getPluginRegistry()
+
+// Search plugins
+const results = await registry.search('animation')
+
+// Get all plugins
+const plugins = await registry.getAll()
+
+// Install a plugin
+await registry.install('directix-animate', manager)
+```
+
+### Timezone & Locale Utilities
+
+Region-specific formatting for dates, numbers, and currencies.
+
+```typescript
+import { getTimezoneInfo, formatDateLocale, formatCurrencyLocale } from 'directix'
+
+// Get timezone info
+const tz = getTimezoneInfo() // { id: 'Asia/Shanghai', offset: 8, ... }
+
+// Format date by locale
+formatDateLocale(new Date()) // Auto-detects user locale
+
+// Format currency
+formatCurrencyLocale(99.99) // '$99.99' (US) or '99,99€' (DE)
+```
+
+### Vue DevTools Integration
+
+Debug directives directly in Vue DevTools.
+
+```typescript
+import { enableDevtools, trackDirective } from 'directix'
+
+// Enable DevTools integration
+enableDevtools()
+
+// Track directive usage
+trackDirective('debounce', { element: 'input' })
+```
+
+### Performance Monitoring
+
+Measure directive performance with detailed metrics.
+
+```typescript
+import { enablePerformance, getPerformanceReport } from 'directix'
+
+// Enable monitoring
+enablePerformance()
+
+// Get performance report
+const report = getPerformanceReport()
+// [{ name: 'debounce', mount: { p50: 0.5ms, p95: 1.2ms }, ... }]
+```
+
+### Scenario Examples
+
+10+ real-world examples demonstrating directive combinations:
+
+- **Form Validation** - v-debounce, v-mask, v-trim, v-focus
+- **Permission Management** - v-permission, v-click-outside
+- **Image Gallery** - v-lazy, v-image-preview, v-swipe
+- **Infinite Scroll** - v-infinite-scroll, v-virtual-list, v-loading
+- **Rich Text Editor** - v-sanitize, v-highlight, v-emoji
+- **Gesture Interaction** - v-touch, v-swipe, v-pan, v-pinch
+- **Data Visualization** - v-progress, v-counter, v-countdown
+- **Drag & Sort** - v-draggable, v-intersect
+- **Print & Export** - v-print, v-export
+- **Fullscreen Media** - v-fullscreen, v-lottie
 
 ## Online Demo
 
@@ -1789,6 +1924,11 @@ Each directive accepts different options. See the [documentation](https://github
 
 ## Roadmap
 
+### v1.7.1 (2026-04-11) - Bug Fixes & Improvements ✅
+
+- **Playground Fixes** - Monaco Editor loading, syntax highlighting, Vue version sync
+- **UI Improvements** - Removed redundant controls, unified documentation layout
+
 ### v1.7.0 (2026-04-15) - Visual Configuration Tool ✅
 
 - **Online Playground** - Live editing environment with Vue 2/3 support
@@ -1798,7 +1938,7 @@ Each directive accepts different options. See the [documentation](https://github
 - **Monaco Editor** - CDN-loaded code editor with syntax highlighting
 - **Live Preview** - Real-time directive effect preview
 
-### v1.8.0 (Planned - 2026-04-22) - Quality & Ecosystem
+### v1.8.0 (2026-04-22) - Quality & Ecosystem ✅
 
 - **Test Coverage** - 90%+ unit test coverage, E2E testing with Playwright
 - **Performance Optimization** - Bundle size optimization, tree-shaking improvements