@qhr123/sa2kit 0.2.0 → 0.3.0

package/README.md

@@ -14,6 +14,8 @@ A modern, type-safe React utility library with cross-platform support for buildi
 - 💾 **Storage Adapters** - Universal storage abstraction
 - 📁 **File Upload** - Complete file management with progress tracking
 - 📊 **Data Export** - Flexible export to CSV, Excel, JSON formats
+- 🌍 **i18n** - Complete internationalization solution
+- 📈 **Analytics** - Comprehensive event tracking and analytics
 
 ## Installation
 
@@ -146,6 +148,84 @@ const exportData = async () => {
 };
 ```
 
+### Internationalization (i18n)
+
+```typescript
+import { createI18n, useTranslation } from '@qhr123/sa2kit/i18n';
+import { zhCN, enUS } from '@qhr123/sa2kit/i18n';
+
+// Create i18n instance
+const i18n = createI18n({
+  locale: 'zh-CN',
+  fallbackLocale: 'en-US',
+  resources: {
+    'zh-CN': zhCN,
+    'en-US': enUS,
+  },
+});
+
+// In React component
+function MyComponent() {
+  const { t, locale, setLocale } = useTranslation();
+
+  return (
+    <div>
+      <p>{t('common.welcome')}</p>
+      <button onClick={() => setLocale('en-US')}>
+        Switch to English
+      </button>
+    </div>
+  );
+}
+```
+
+### Analytics
+
+```typescript
+import { Analytics, createAnalytics } from '@qhr123/sa2kit/analytics';
+
+// Create analytics instance (需要提供适配器)
+const analytics = createAnalytics('my-app', {
+  appId: 'my-app',
+  appVersion: '1.0.0',
+  endpoint: '/api/analytics/events',
+  platform: 'web',
+  adapter: yourPlatformAdapter, // 需要自行实现
+});
+
+// Track events
+analytics.trackEvent('button_click', {
+  button_id: 'submit',
+  page: 'home',
+});
+
+// Use decorators (TypeScript)
+class MyService {
+  @Track('user_login')
+  async login(username: string) {
+    // Login logic
+  }
+
+  @CatchError()
+  async fetchData() {
+    // Fetch logic
+  }
+}
+
+// Use React Hooks
+function MyComponent() {
+  const trackEvent = useAnalyticsEvent(analytics);
+
+  usePageView(analytics); // Auto track page views
+
+  const handleClick = () => {
+    trackEvent('button_click', { action: 'submit' });
+  };
+
+  return <button onClick={handleClick}>Submit</button>;
+}
+```
+
 ## Documentation
 
 - [Logger Documentation](./docs/logger.md)
@@ -154,6 +234,8 @@ const exportData = async () => {
 - [Storage Adapters](./docs/storage.md)
 - [File Upload Service](./docs/universalFile.md)
 - [Data Export Service](./docs/universalExport.md)
+- [i18n Internationalization](./docs/i18n.md)
+- [Analytics Tracking](./docs/analytics.md)
 
 ## Examples