sa2kit 1.6.1 → 1.6.3

package/README.md

@@ -1,67 +1,67 @@
 # SA2Kit
 
-A modern, type-safe React utility library with cross-platform support for building scalable applications.
+一个现代的、类型安全的 React 工具库，具有跨平台支持，用于构建可扩展的应用程序。
 
-## Features
+## 特性
 
-- 🚀 **Modern TypeScript** - Full type safety and IntelliSense support
-- 📦 **Tree-shakeable** - Optimized bundle size with ESM support
-- 🔄 **Cross-platform** - Works in browser and Node.js environments
-- ⚡ **Zero dependencies** - Minimal footprint (React as peer dependency)
-- 🧩 **Modular** - Import only what you need
-- 🎯 **React Hooks** - Custom hooks for common patterns
-- 📝 **Logger System** - Unified logging with multiple adapters
-- 💾 **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
+- 🚀 **现代 TypeScript** - 完整的类型安全和 IntelliSense 支持
+- 📦 **Tree-shakeable** - 使用 ESM 支持优化包大小
+- 🔄 **跨平台** - 适用于浏览器和 Node.js 环境
+- ⚡ **零依赖** - 极小的体积（React 作为 peer dependency）
+- 🧩 **模块化** - 仅导入你需要的部分
+- 🎯 **React Hooks** - 常用模式的自定义 Hook
+- 📝 **日志系统** - 统一的日志记录，支持多个适配器
+- 💾 **存储适配器** - 通用存储抽象
+- 📁 **文件上传** - 完整的文件管理，支持进度追踪
+- 📊 **数据导出** - 灵活导出为 CSV、Excel、JSON 格式
+- 🌍 **i18n** - 完整的国际化解决方案
+- 📈 **数据分析** - 全面的事件跟踪和分析
 
-## Installation
+## 安装
 
 ```bash
 npm install @qhr123/sa2kit
-# or
+# 或
 yarn add @qhr123/sa2kit
-# or
+# 或
 pnpm add @qhr123/sa2kit
 ```
 
-## Quick Start
+## 快速开始
 
-### Logger
+### 日志 (Logger)
 
 ```typescript
 import { logger, createLogger, LogLevel } from '@qhr123/sa2kit/logger';
 
-// Use default logger
-logger.info('Application started');
-logger.debug('Debug information', { user: 'John' });
-logger.error('Something went wrong', new Error('Error details'));
+// 使用默认日志记录器
+logger.info('应用程序已启动');
+logger.debug('调试信息', { user: 'John' });
+logger.error('发生错误', new Error('错误详情'));
 
-// Create custom logger with context
+// 创建带有上下文的自定义日志记录器
 const apiLogger = createLogger('API', {
   minLevel: LogLevel.INFO,
   enableTimestamp: true,
 });
 
-apiLogger.info('API request completed');
+apiLogger.info('API 请求已完成');
 ```
 
-### Utility Functions
+### 工具函数 (Utility Functions)
 
 ```typescript
 import { stringUtils, arrayUtils, fileUtils } from '@qhr123/sa2kit/utils';
 
-// String utilities
+// 字符串工具
 const capitalized = stringUtils.capitalize('hello world');
-const truncated = stringUtils.truncate('Long text...', 10);
+const truncated = stringUtils.truncate('这是一段很长的文本...', 10);
 
-// Array utilities
+// 数组工具
 const unique = arrayUtils.unique([1, 2, 2, 3, 3, 4]);
 const grouped = arrayUtils.groupBy(items, 'category');
 
-// File utilities
+// 文件工具
 const size = fileUtils.formatFileSize(1024000);
 const isValid = fileUtils.isValidFilename('document.pdf');
 ```
@@ -72,22 +72,22 @@ const isValid = fileUtils.isValidFilename('document.pdf');
 import { useLocalStorage, useAsyncStorage } from '@qhr123/sa2kit/hooks';
 
 function MyComponent() {
-  // Persistent state with localStorage
+  // 使用 localStorage 进行持久化状态管理
   const [theme, setTheme] = useLocalStorage('theme', 'light');
 
-  // Async storage operations
+  // 异步存储操作
   const { data, loading, error } = useAsyncStorage('user-data');
 
-  return <div>Theme: {theme}</div>;
+  return <div>当前主题: {theme}</div>;
 }
 ```
 
-### File Upload
+### 文件上传 (File Upload)
 
 ```typescript
 import { universalFileClient } from '@qhr123/sa2kit/universalFile';
 
-// Upload a file with progress tracking
+// 上传文件并追踪进度
 const uploadFile = async (file: File) => {
   const fileMetadata = await universalFileClient.uploadFile(
     {
@@ -97,31 +97,31 @@ const uploadFile = async (file: File) => {
       permission: 'public',
     },
     (progress) => {
-      console.log(`Upload progress: ${progress.progress}%`);
-      console.log(`Speed: ${progress.speed} bytes/sec`);
+      console.log(`上传进度: ${progress.progress}%`);
+      console.log(`上传速度: ${progress.speed} 字节/秒`);
     }
   );
 
-  console.log('File uploaded:', fileMetadata.id);
+  console.log('文件已上传，ID:', fileMetadata.id);
   return fileMetadata;
 };
 
-// Query files
+// 查询文件
 const files = await universalFileClient.queryFiles({
   moduleId: 'user-avatars',
   pageSize: 20,
 });
 
-// Get file URL
+// 获取文件 URL
 const fileUrl = await universalFileClient.getFileUrl(fileId);
 ```
 
-### Data Export
+### 数据导出 (Data Export)
 
 ```typescript
 import { universalExportClient } from '@qhr123/sa2kit/universalExport';
 
-// Export data to CSV
+// 导出数据为 CSV
 const exportData = async () => {
   const result = await universalExportClient.exportData({
     configId: 'my-export-config',
@@ -132,11 +132,11 @@ const exportData = async () => {
     format: 'csv',
     callbacks: {
       onProgress: (progress) => {
-        console.log(`Export progress: ${progress.progress}%`);
+        console.log(`导出进度: ${progress.progress}%`);
       },
       onSuccess: (result) => {
-        console.log('Export completed:', result.fileName);
-        // Download the file
+        console.log('导出完成:', result.fileName);
+        // 下载文件
         const url = URL.createObjectURL(result.fileBlob!);
         const a = document.createElement('a');
         a.href = url;
@@ -148,13 +148,13 @@ const exportData = async () => {
 };
 ```
 
-### Internationalization (i18n)
+### 国际化 (i18n)
 
 ```typescript
 import { createI18n, useTranslation } from '@qhr123/sa2kit/i18n';
 import { zhCN, enUS } from '@qhr123/sa2kit/i18n';
 
-// Create i18n instance
+// 创建 i18n 实例
 const i18n = createI18n({
   locale: 'zh-CN',
   fallbackLocale: 'en-US',
@@ -164,7 +164,7 @@ const i18n = createI18n({
   },
 });
 
-// In React component
+// 在 React 组件中使用
 function MyComponent() {
   const { t, locale, setLocale } = useTranslation();
 
@@ -172,51 +172,50 @@ function MyComponent() {
     <div>
       <p>{t('common.welcome')}</p>
       <button onClick={() => setLocale('en-US')}>
-        Switch to English
+        切换为英文
       </button>
     </div>
   );
 }
 ```
 
-#### UI Components (Tailwind CSS)
+#### UI 组件 (Tailwind CSS)
 
 ```typescript
 import { LanguageSwitcher } from '@qhr123/sa2kit/i18n';
 
-// Button group style (default)
+// 按钮组样式 (默认)
 <LanguageSwitcher variant="buttons" />
 
-// Dropdown style
+// 下拉菜单样式
 <LanguageSwitcher variant="dropdown" />
 
-// Icon button with dropdown
+// 带有下拉菜单的图标按钮
 <LanguageSwitcher variant="icon" />
 
-// With custom className and callback
+// 带有自定义类名和回调
 <LanguageSwitcher
   variant="buttons"
   className="my-custom-class"
   onLanguageChange={(locale) => {
-    console.log('Language changed to:', locale);
+    console.log('语言已切换为:', locale);
   }}
 />
 ```
 
-**Requirements:**
+**要求：**
 - ✅ React >= 18.0.0
-- ✅ Tailwind CSS configured in your project ([Setup Guide](./docs/tailwind-setup.md))
-- ✅ Next.js App Router compatible ('use client' included)
-```
+- ✅ 项目中已配置 Tailwind CSS ([设置指南](./docs/tailwind-setup.md))
+- ✅ 兼容 Next.js App Router (已包含 'use client')
 
-**Note:** UI components use Tailwind CSS. See the [Tailwind Setup Guide](./docs/tailwind-setup.md) for configuration instructions.
+**注意：** UI 组件使用 Tailwind CSS。请参阅 [Tailwind 设置指南](./docs/tailwind-setup.md) 获取配置说明。
 
-### Analytics
+### 数据分析 (Analytics)
 
 ```typescript
 import { Analytics, createAnalytics } from '@qhr123/sa2kit/analytics';
 
-// Create analytics instance (需要提供适配器)
+// 创建分析实例 (需要提供适配器)
 const analytics = createAnalytics('my-app', {
   appId: 'my-app',
   appVersion: '1.0.0',
@@ -225,74 +224,74 @@ const analytics = createAnalytics('my-app', {
   adapter: yourPlatformAdapter, // 需要自行实现
 });
 
-// Track events
+// 追踪事件
 analytics.trackEvent('button_click', {
   button_id: 'submit',
   page: 'home',
 });
 
-// Use decorators (TypeScript)
+// 使用装饰器 (TypeScript)
 class MyService {
   @Track('user_login')
   async login(username: string) {
-    // Login logic
+    // 登录逻辑
   }
 
   @CatchError()
   async fetchData() {
-    // Fetch logic
+    // 获取数据逻辑
   }
 }
 
-// Use React Hooks
+// 使用 React Hooks
 function MyComponent() {
   const trackEvent = useAnalyticsEvent(analytics);
 
-  usePageView(analytics); // Auto track page views
+  usePageView(analytics); // 自动追踪页面访问
 
   const handleClick = () => {
     trackEvent('button_click', { action: 'submit' });
   };
 
-  return <button onClick={handleClick}>Submit</button>;
+  return <button onClick={handleClick}>提交</button>;
 }
 ```
 
-## Documentation
+## 文档
 
-- [Tailwind CSS Setup](./docs/tailwind-setup.md) - **UI Components Configuration**
-- [Logger Documentation](./docs/logger.md)
-- [Utility Functions](./docs/utils.md)
-- [React Hooks](./docs/hooks.md)
-- [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)
+- [Tailwind CSS 设置](./docs/tailwind-setup.md) - **UI 组件配置**
+- [日志文档](./docs/logger.md)
+- [工具函数文档](./docs/utils.md)
+- [React Hooks 文档](./docs/hooks.md)
+- [存储适配器文档](./docs/storage.md)
+- [文件上传服务文档](./docs/universalFile.md)
+- [OSS 管理模块文档](./docs/ossManager.md) - **阿里云 OSS 管理界面**
+- [数据导出服务文档](./docs/universalExport.md)
+- [i18n 国际化文档](./docs/i18n.md)
+- [数据分析追踪文档](./docs/analytics.md)
 
-## Examples
+## 示例
 
-Check out the [examples](./examples) directory for complete working examples:
+查看 [examples](./examples) 目录以获取完整的运行示例：
 
-- React App Example
-- Next.js Integration
-- TypeScript Configuration
+- React 应用示例
+- Next.js 集成
+- TypeScript 配置
 
-## API Reference
+## API 参考
 
-Full API documentation is available at [https://react-utils-kit.dev](https://react-utils-kit.dev)
+完整的 API 文档可在 [https://react-utils-kit.dev](https://react-utils-kit.dev) 找到
 
-## Contributing
+## 贡献
 
-We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
+我们欢迎贡献！详情请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md)。
 
-## License
+## 许可证
 
 MIT © [Your Name](LICENSE)
 
-## Support
-
-- 🐛 [Report a bug](https://github.com/your-org/react-utils-kit/issues)
-- 💡 [Request a feature](https://github.com/your-org/react-utils-kit/issues)
-- 📖 [Documentation](https://react-utils-kit.dev)
+## 支持
 
+- 🐛 [报告错误](https://github.com/your-org/react-utils-kit/issues)
+- 💡 [请求特性](https://github.com/your-org/react-utils-kit/issues)
+- 📖 [文档中心](https://react-utils-kit.dev)

package/dist/AliyunOSSProvider-2UZRIGT3.mjs

@@ -0,0 +1,6 @@
+export { AliyunOSSProvider } from './chunk-OHUE7EL6.mjs';
+import './chunk-ZGVB35L2.mjs';
+import './chunk-KQGP6BTS.mjs';
+import './chunk-BJTO5JO5.mjs';
+//# sourceMappingURL=AliyunOSSProvider-2UZRIGT3.mjs.map
+//# sourceMappingURL=AliyunOSSProvider-2UZRIGT3.mjs.map

package/dist/{AliyunOSSProvider-GQMSDJGZ.mjs.map → AliyunOSSProvider-2UZRIGT3.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"AliyunOSSProvider-GQMSDJGZ.mjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"AliyunOSSProvider-2UZRIGT3.mjs"}

package/dist/AliyunOSSProvider-XCTK3QQA.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkEXT3IKQA_js = require('./chunk-EXT3IKQA.js');
+require('./chunk-KH6RQ4J5.js');
+require('./chunk-6PRFP5EG.js');
+require('./chunk-DGUM43GV.js');
+
+
+
+Object.defineProperty(exports, "AliyunOSSProvider", {
+  enumerable: true,
+  get: function () { return chunkEXT3IKQA_js.AliyunOSSProvider; }
+});
+//# sourceMappingURL=AliyunOSSProvider-XCTK3QQA.js.map
+//# sourceMappingURL=AliyunOSSProvider-XCTK3QQA.js.map

package/dist/{AliyunOSSProvider-7JLMJDXK.js.map → AliyunOSSProvider-XCTK3QQA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"AliyunOSSProvider-7JLMJDXK.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"AliyunOSSProvider-XCTK3QQA.js"}