@qhr123/sa2kit 0.1.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 React Utils Kit Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,113 @@
+# React Utils Kit
+
+A modern, type-safe React utility library with cross-platform support for building scalable applications.
+
+## 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
+
+## Installation
+
+```bash
+npm install @react-utils-kit/core
+# or
+yarn add @react-utils-kit/core
+# or
+pnpm add @react-utils-kit/core
+```
+
+## Quick Start
+
+### Logger
+
+```typescript
+import { logger, createLogger, LogLevel } from '@react-utils-kit/core/logger';
+
+// Use default logger
+logger.info('Application started');
+logger.debug('Debug information', { user: 'John' });
+logger.error('Something went wrong', new Error('Error details'));
+
+// Create custom logger with context
+const apiLogger = createLogger('API', {
+  minLevel: LogLevel.INFO,
+  enableTimestamp: true,
+});
+
+apiLogger.info('API request completed');
+```
+
+### Utility Functions
+
+```typescript
+import { stringUtils, arrayUtils, fileUtils } from '@react-utils-kit/core/utils';
+
+// String utilities
+const capitalized = stringUtils.capitalize('hello world');
+const truncated = stringUtils.truncate('Long text...', 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');
+```
+
+### React Hooks
+
+```typescript
+import { useLocalStorage, useAsyncStorage } from '@react-utils-kit/core/hooks';
+
+function MyComponent() {
+  // Persistent state with localStorage
+  const [theme, setTheme] = useLocalStorage('theme', 'light');
+
+  // Async storage operations
+  const { data, loading, error } = useAsyncStorage('user-data');
+
+  return <div>Theme: {theme}</div>;
+}
+```
+
+## Documentation
+
+- [Logger Documentation](./docs/logger.md)
+- [Utility Functions](./docs/utils.md)
+- [React Hooks](./docs/hooks.md)
+- [Storage Adapters](./docs/storage.md)
+
+## Examples
+
+Check out the [examples](./examples) directory for complete working examples:
+
+- React App Example
+- Next.js Integration
+- TypeScript Configuration
+
+## API Reference
+
+Full API documentation is available at [https://react-utils-kit.dev](https://react-utils-kit.dev)
+
+## Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
+
+## 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)
+

package/dist/chunk-3R73CUAY.js

@@ -0,0 +1,80 @@
+'use strict';
+
+var chunk4JTIYLS6_js = require('./chunk-4JTIYLS6.js');
+var react = require('react');
+
+function useStorage(storage, key, defaultValue) {
+  const [value, setValue] = react.useState(defaultValue);
+  const [loading, setLoading] = react.useState(true);
+  react.useEffect(() => {
+    const loadValue = async () => {
+      try {
+        const stored = await storage.getItem(key);
+        if (stored !== null) {
+          setValue(JSON.parse(stored));
+        }
+      } catch (error) {
+        console.error(`Error reading storage key "${key}":`, error);
+      } finally {
+        setLoading(false);
+      }
+    };
+    void loadValue();
+  }, [storage, key]);
+  const updateValue = react.useCallback(
+    async (newValue) => {
+      try {
+        setValue(newValue);
+        await storage.setItem(key, JSON.stringify(newValue));
+        if ("dispatchChange" in storage && typeof storage.dispatchChange === "function") {
+          storage.dispatchChange(key, JSON.stringify(newValue));
+        }
+      } catch (error) {
+        console.error(`Error setting storage key "${key}":`, error);
+      }
+    },
+    [storage, key]
+  );
+  const removeValue = react.useCallback(async () => {
+    try {
+      setValue(defaultValue);
+      await storage.removeItem(key);
+      if ("dispatchChange" in storage && typeof storage.dispatchChange === "function") {
+        storage.dispatchChange(key, null);
+      }
+    } catch (error) {
+      console.error(`Error removing storage key "${key}":`, error);
+    }
+  }, [storage, key, defaultValue]);
+  react.useEffect(() => {
+    if (!storage.addChangeListener) {
+      return;
+    }
+    const cleanup = storage.addChangeListener((changedKey, newValue) => {
+      if (changedKey === key) {
+        try {
+          if (newValue === null) {
+            setValue(defaultValue);
+          } else {
+            setValue(JSON.parse(newValue));
+          }
+        } catch (error) {
+          console.error("Error parsing storage change event:", error);
+        }
+      }
+    });
+    return cleanup;
+  }, [storage, key, defaultValue]);
+  return [value, updateValue, removeValue, loading];
+}
+
+// src/hooks/useLocalStorage.ts
+var webStorage = new chunk4JTIYLS6_js.WebStorageAdapter();
+function useLocalStorage(key, defaultValue) {
+  return useStorage(webStorage, key, defaultValue);
+}
+
+exports.useLocalStorage = useLocalStorage;
+exports.useStorage = useStorage;
+//# sourceMappingURL=chunk-3R73CUAY.js.map
+//# sourceMappingURL=chunk-3R73CUAY.js.map

package/dist/chunk-3R73CUAY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useStorage.ts","../src/hooks/useLocalStorage.ts"],"names":["useState","useEffect","useCallback","WebStorageAdapter"],"mappings":"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","file":"chunk-3R73CUAY.js","sourcesContent":["/**\n * 通用存储 Hook\n * 支持多平台：Web、React Native、小程序\n *\n * 优点：\n * 1. 异步读取，不阻塞渲染\n * 2. 统一的错误处理\n * 3. 类型安全\n * 4. 跨平台支持\n * 5. 自动同步（支持的平台）\n */\n\nimport { useState, useEffect, useCallback } from 'react';\nimport type { StorageAdapter } from '../storage/types';\n\nexport function useStorage<T>(\n  storage: StorageAdapter,\n  key: string,\n  defaultValue: T\n): [T, (value: T) => void, () => void, boolean] {\n  const [value, setValue] = useState<T>(defaultValue);\n  const [loading, setLoading] = useState(true);\n\n  // 初始化时从存储读取\n  useEffect(() => {\n    const loadValue = async () => {\n      try {\n        const stored = await storage.getItem(key);\n        if (stored !== null) {\n          setValue(JSON.parse(stored));\n        }\n      } catch (error) {\n        console.error(`Error reading storage key \"${key}\":`, error);\n      } finally {\n        setLoading(false);\n      }\n    };\n\n    void loadValue();\n  }, [storage, key]);\n\n  // 更新值并同步到存储\n  const updateValue = useCallback(\n    async (newValue: T) => {\n      try {\n        setValue(newValue);\n        await storage.setItem(key, JSON.stringify(newValue));\n\n        // 如果是 Web 适配器，触发自定义事件\n        if ('dispatchChange' in storage && typeof storage.dispatchChange === 'function') {\n          (storage as any).dispatchChange(key, JSON.stringify(newValue));\n        }\n      } catch (error) {\n        console.error(`Error setting storage key \"${key}\":`, error);\n      }\n    },\n    [storage, key]\n  );\n\n  // 删除值\n  const removeValue = useCallback(async () => {\n    try {\n      setValue(defaultValue);\n      await storage.removeItem(key);\n\n      // 如果是 Web 适配器，触发自定义事件\n      if ('dispatchChange' in storage && typeof storage.dispatchChange === 'function') {\n        (storage as any).dispatchChange(key, null);\n      }\n    } catch (error) {\n      console.error(`Error removing storage key \"${key}\":`, error);\n    }\n  }, [storage, key, defaultValue]);\n\n  // 监听存储变化\n  useEffect(() => {\n    if (!storage.addChangeListener) {\n      return;\n    }\n\n    const cleanup = storage.addChangeListener((changedKey: string, newValue: string | null) => {\n      if (changedKey === key) {\n        try {\n          if (newValue === null) {\n            setValue(defaultValue);\n          } else {\n            setValue(JSON.parse(newValue));\n          }\n        } catch (error) {\n          console.error('Error parsing storage change event:', error);\n        }\n      }\n    });\n\n    return cleanup;\n  }, [storage, key, defaultValue]);\n\n  return [value, updateValue, removeValue, loading];\n}\n\n","/**\n * Web 平台 localStorage Hook\n * 基于通用 useStorage 的便捷封装\n */\n\nimport { useStorage } from './useStorage';\nimport { WebStorageAdapter } from '../storage';\n\n// 创建单例适配器\nconst webStorage = new WebStorageAdapter();\n\n/**\n * Web 平台的 localStorage Hook\n *\n * @param key - 存储键名\n * @param defaultValue - 默认值\n * @returns [value, setValue, removeValue, isLoading]\n */\nexport function useLocalStorage<T>(\n  key: string,\n  defaultValue: T\n): [T, (value: T) => void, () => void, boolean] {\n  return useStorage(webStorage, key, defaultValue);\n}\n\n"]}

package/dist/chunk-4JTIYLS6.js

@@ -0,0 +1,88 @@
+'use strict';
+
+// src/storage/web-adapter.ts
+var isBrowser = typeof window !== "undefined" && typeof window.localStorage !== "undefined";
+var WebStorageAdapter = class {
+  async getItem(key) {
+    if (!isBrowser) {
+      return null;
+    }
+    try {
+      return localStorage.getItem(key);
+    } catch (error) {
+      console.error(`[WebStorage] Error getting item "${key}":`, error);
+      return null;
+    }
+  }
+  async setItem(key, value) {
+    if (!isBrowser) {
+      return;
+    }
+    try {
+      localStorage.setItem(key, value);
+    } catch (error) {
+      console.error(`[WebStorage] Error setting item "${key}":`, error);
+      throw error;
+    }
+  }
+  async removeItem(key) {
+    if (!isBrowser) {
+      return;
+    }
+    try {
+      localStorage.removeItem(key);
+    } catch (error) {
+      console.error(`[WebStorage] Error removing item "${key}":`, error);
+      throw error;
+    }
+  }
+  async clear() {
+    if (!isBrowser) {
+      return;
+    }
+    try {
+      localStorage.clear();
+    } catch (error) {
+      console.error("[WebStorage] Error clearing storage:", error);
+      throw error;
+    }
+  }
+  addChangeListener(callback) {
+    if (!isBrowser) {
+      return () => {
+      };
+    }
+    const handleStorageEvent = (e) => {
+      if (e.key) {
+        callback(e.key, e.newValue);
+      }
+    };
+    const handleCustomEvent = (e) => {
+      const customEvent = e;
+      callback(customEvent.detail.key, customEvent.detail.value);
+    };
+    window.addEventListener("storage", handleStorageEvent);
+    window.addEventListener("local-storage-change", handleCustomEvent);
+    return () => {
+      window.removeEventListener("storage", handleStorageEvent);
+      window.removeEventListener("local-storage-change", handleCustomEvent);
+    };
+  }
+  /**
+   * 触发自定义事件，通知同标签页的其他组件
+   */
+  dispatchChange(key, value) {
+    if (!isBrowser) {
+      return;
+    }
+    window.dispatchEvent(
+      new CustomEvent("local-storage-change", {
+        detail: { key, value }
+      })
+    );
+  }
+};
+
+exports.WebStorageAdapter = WebStorageAdapter;
+//# sourceMappingURL=chunk-4JTIYLS6.js.map
+//# sourceMappingURL=chunk-4JTIYLS6.js.map

package/dist/chunk-4JTIYLS6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/web-adapter.ts"],"names":[],"mappings":"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","file":"chunk-4JTIYLS6.js","sourcesContent":["/**\n * Web 平台存储适配器 (localStorage)\n */\n\nimport type { StorageAdapter } from './types';\n\n/**\n * 检查是否在浏览器环境中\n */\nconst isBrowser = typeof window !== 'undefined' && typeof window.localStorage !== 'undefined';\n\nexport class WebStorageAdapter implements StorageAdapter {\n  async getItem(key: string): Promise<string | null> {\n    // SSR 环境下返回 null\n    if (!isBrowser) {\n      return null;\n    }\n\n    try {\n      return localStorage.getItem(key);\n    } catch (error) {\n      console.error(`[WebStorage] Error getting item \"${key}\":`, error);\n      return null;\n    }\n  }\n\n  async setItem(key: string, value: string): Promise<void> {\n    // SSR 环境下静默忽略\n    if (!isBrowser) {\n      return;\n    }\n\n    try {\n      localStorage.setItem(key, value);\n    } catch (error) {\n      console.error(`[WebStorage] Error setting item \"${key}\":`, error);\n      throw error;\n    }\n  }\n\n  async removeItem(key: string): Promise<void> {\n    // SSR 环境下静默忽略\n    if (!isBrowser) {\n      return;\n    }\n\n    try {\n      localStorage.removeItem(key);\n    } catch (error) {\n      console.error(`[WebStorage] Error removing item \"${key}\":`, error);\n      throw error;\n    }\n  }\n\n  async clear(): Promise<void> {\n    // SSR 环境下静默忽略\n    if (!isBrowser) {\n      return;\n    }\n\n    try {\n      localStorage.clear();\n    } catch (error) {\n      console.error('[WebStorage] Error clearing storage:', error);\n      throw error;\n    }\n  }\n\n  addChangeListener(callback: (key: string, value: string | null) => void): () => void {\n    // SSR 环境下返回空函数\n    if (!isBrowser) {\n      return () => {};\n    }\n\n    // 监听 storage 事件（跨标签页）\n    const handleStorageEvent = (e: StorageEvent) => {\n      if (e.key) {\n        callback(e.key, e.newValue);\n      }\n    };\n\n    // 监听自定义事件（同标签页）\n    const handleCustomEvent = (e: Event) => {\n      const customEvent = e as CustomEvent;\n      callback(customEvent.detail.key, customEvent.detail.value);\n    };\n\n    window.addEventListener('storage', handleStorageEvent);\n    window.addEventListener('local-storage-change', handleCustomEvent);\n\n    // 返回清理函数\n    return () => {\n      window.removeEventListener('storage', handleStorageEvent);\n      window.removeEventListener('local-storage-change', handleCustomEvent);\n    };\n  }\n\n  /**\n   * 触发自定义事件，通知同标签页的其他组件\n   */\n  dispatchChange(key: string, value: string | null): void {\n    // SSR 环境下静默忽略\n    if (!isBrowser) {\n      return;\n    }\n\n    window.dispatchEvent(\n      new CustomEvent('local-storage-change', {\n        detail: { key, value },\n      })\n    );\n  }\n}\n\n"]}

package/dist/chunk-6PRFP5EG.js

@@ -0,0 +1,171 @@
+'use strict';
+
+// src/logger/types.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
+  LogLevel2[LogLevel2["INFO"] = 1] = "INFO";
+  LogLevel2[LogLevel2["WARN"] = 2] = "WARN";
+  LogLevel2[LogLevel2["ERROR"] = 3] = "ERROR";
+  LogLevel2[LogLevel2["NONE"] = 4] = "NONE";
+  return LogLevel2;
+})(LogLevel || {});
+
+// src/logger/console-adapter.ts
+var ConsoleLoggerAdapter = class {
+  constructor() {
+    this.colors = {
+      DEBUG: "\x1B[36m",
+      // Cyan
+      INFO: "\x1B[32m",
+      // Green
+      WARN: "\x1B[33m",
+      // Yellow
+      ERROR: "\x1B[31m",
+      // Red
+      RESET: "\x1B[0m"
+    };
+  }
+  log(entry) {
+    const { level, message, timestamp, data, context, error } = entry;
+    let logMessage = "";
+    if (timestamp) {
+      logMessage += `[${this.formatTimestamp(timestamp)}] `;
+    }
+    const levelName = this.getLevelName(level);
+    logMessage += `${levelName}: `;
+    if (context) {
+      logMessage += `[${context}] `;
+    }
+    logMessage += message;
+    switch (level) {
+      case 0:
+        console.debug(this.colorize(logMessage, "DEBUG"), data || "");
+        break;
+      case 1:
+        console.info(this.colorize(logMessage, "INFO"), data || "");
+        break;
+      case 2:
+        console.warn(this.colorize(logMessage, "WARN"), data || "");
+        break;
+      case 3:
+        console.error(this.colorize(logMessage, "ERROR"), data || "");
+        if (error) {
+          console.error(error);
+        }
+        break;
+    }
+  }
+  formatTimestamp(date) {
+    return date.toISOString();
+  }
+  getLevelName(level) {
+    const names = ["DEBUG", "INFO", "WARN", "ERROR", "NONE"];
+    return names[level] || "UNKNOWN";
+  }
+  colorize(message, level) {
+    if (typeof process !== "undefined" && process.stdout?.isTTY) {
+      return `${this.colors[level]}${message}${this.colors.RESET}`;
+    }
+    return message;
+  }
+};
+
+// src/logger/Logger.ts
+var Logger = class _Logger {
+  constructor(config, context) {
+    const isProduction = typeof process !== "undefined" ? process.env.NODE_ENV === "production" : false;
+    this.config = {
+      minLevel: config?.minLevel ?? (isProduction ? 1 : 0),
+      // INFO in prod, DEBUG in dev
+      enableTimestamp: config?.enableTimestamp ?? true,
+      enableContext: config?.enableContext ?? true,
+      environment: config?.environment ?? (isProduction ? "production" : "development"),
+      adapter: config?.adapter ?? new ConsoleLoggerAdapter()
+    };
+    this.adapter = this.config.adapter;
+    this.context = context;
+  }
+  /**
+   * 创建带上下文的子 Logger
+   */
+  createChild(context) {
+    return new _Logger(this.config, context);
+  }
+  /**
+   * 调试日志
+   */
+  debug(message, data) {
+    this.log(0, message, data);
+  }
+  /**
+   * 信息日志
+   */
+  info(message, data) {
+    this.log(1, message, data);
+  }
+  /**
+   * 警告日志
+   */
+  warn(message, data) {
+    this.log(2, message, data);
+  }
+  /**
+   * 错误日志
+   */
+  error(message, error) {
+    this.log(
+      3,
+      // LogLevel.ERROR
+      message,
+      error instanceof Error ? void 0 : error,
+      error instanceof Error ? error : void 0
+    );
+  }
+  /**
+   * 核心日志方法
+   */
+  log(level, message, data, error) {
+    if (level < this.config.minLevel) {
+      return;
+    }
+    if (typeof window !== "undefined" && typeof localStorage !== "undefined") {
+      const loggerDebug = localStorage.getItem("logger-debug");
+      if (loggerDebug === "false" && level < 3) {
+        return;
+      }
+    }
+    const entry = {
+      level,
+      message,
+      timestamp: this.config.enableTimestamp ? /* @__PURE__ */ new Date() : void 0,
+      data,
+      context: this.config.enableContext ? this.context : void 0,
+      error
+    };
+    this.adapter.log(entry);
+  }
+  /**
+   * 设置日志级别
+   */
+  setLevel(level) {
+    this.config.minLevel = level;
+  }
+  /**
+   * 获取当前日志级别
+   */
+  getLevel() {
+    return this.config.minLevel;
+  }
+};
+var logger = new Logger();
+function createLogger(context, config) {
+  return new Logger(config, context);
+}
+
+exports.ConsoleLoggerAdapter = ConsoleLoggerAdapter;
+exports.LogLevel = LogLevel;
+exports.Logger = Logger;
+exports.createLogger = createLogger;
+exports.logger = logger;
+//# sourceMappingURL=chunk-6PRFP5EG.js.map
+//# sourceMappingURL=chunk-6PRFP5EG.js.map

package/dist/chunk-6PRFP5EG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger/types.ts","../src/logger/console-adapter.ts","../src/logger/Logger.ts"],"names":["LogLevel"],"mappings":"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","file":"chunk-6PRFP5EG.js","sourcesContent":["/**\n * 日志级别\n */\nexport enum LogLevel {\n  DEBUG = 0,\n  INFO = 1,\n  WARN = 2,\n  ERROR = 3,\n  NONE = 4, // 禁用所有日志\n}\n\n/**\n * 日志条目\n */\nexport interface LogEntry {\n  level: LogLevel;\n  message: string;\n  timestamp: Date;\n  data?: any;\n  context?: string;\n  error?: Error;\n}\n\n/**\n * 日志适配器接口\n * 不同平台实现不同的日志输出方式\n */\nexport interface LoggerAdapter {\n  /**\n   * 输出日志\n   */\n  log(entry: LogEntry): void;\n\n  /**\n   * 批量输出日志（可选）\n   */\n  logBatch?(entries: LogEntry[]): void;\n}\n\n/**\n * 日志配置\n */\nexport interface LoggerConfig {\n  /**\n   * 最小日志级别\n   * 只有大于等于此级别的日志才会输出\n   */\n  minLevel: LogLevel;\n\n  /**\n   * 是否启用时间戳\n   */\n  enableTimestamp?: boolean;\n\n  /**\n   * 是否启用上下文（模块名）\n   */\n  enableContext?: boolean;\n\n  /**\n   * 环境（development/production）\n   */\n  environment?: 'development' | 'production';\n\n  /**\n   * 自定义适配器\n   */\n  adapter?: LoggerAdapter;\n}\n\n","import type { LoggerAdapter, LogEntry, LogLevel } from './types';\n\n/**\n * 控制台日志适配器\n * 使用 console.info/warn/error 输出日志\n */\nexport class ConsoleLoggerAdapter implements LoggerAdapter {\n  private readonly colors = {\n    DEBUG: '\\x1b[36m', // Cyan\n    INFO: '\\x1b[32m', // Green\n    WARN: '\\x1b[33m', // Yellow\n    ERROR: '\\x1b[31m', // Red\n    RESET: '\\x1b[0m',\n  };\n\n  log(entry: LogEntry): void {\n    const { level, message, timestamp, data, context, error } = entry;\n\n    // 构建日志消息\n    let logMessage = '';\n\n    // 添加时间戳\n    if (timestamp) {\n      logMessage += `[${this.formatTimestamp(timestamp)}] `;\n    }\n\n    // 添加日志级别\n    const levelName = this.getLevelName(level);\n    logMessage += `${levelName}: `;\n\n    // 添加上下文\n    if (context) {\n      logMessage += `[${context}] `;\n    }\n\n    // 添加消息\n    logMessage += message;\n\n    // 根据日志级别选择输出方式\n    switch (level) {\n      case 0: // DEBUG\n        console.debug(this.colorize(logMessage, 'DEBUG'), data || '');\n        break;\n      case 1: // INFO\n        console.info(this.colorize(logMessage, 'INFO'), data || '');\n        break;\n      case 2: // WARN\n        console.warn(this.colorize(logMessage, 'WARN'), data || '');\n        break;\n      case 3: // ERROR\n        console.error(this.colorize(logMessage, 'ERROR'), data || '');\n        if (error) {\n          console.error(error);\n        }\n        break;\n    }\n  }\n\n  private formatTimestamp(date: Date): string {\n    return date.toISOString();\n  }\n\n  private getLevelName(level: LogLevel): string {\n    const names = ['DEBUG', 'INFO', 'WARN', 'ERROR', 'NONE'];\n    return names[level] || 'UNKNOWN';\n  }\n\n  private colorize(message: string, level: keyof typeof this.colors): string {\n    // 只在支持颜色的环境中使用颜色\n    if (typeof process !== 'undefined' && process.stdout?.isTTY) {\n      return `${this.colors[level]}${message}${this.colors.RESET}`;\n    }\n    return message;\n  }\n}\n\n","import type { LogLevel, LogEntry, LoggerConfig, LoggerAdapter } from './types';\nimport { ConsoleLoggerAdapter } from './console-adapter';\n\n/**\n * 统一日志管理类\n */\nexport class Logger {\n  private config: Required<LoggerConfig>;\n  private adapter: LoggerAdapter;\n  private context?: string;\n\n  constructor(config?: Partial<LoggerConfig>, context?: string) {\n    const isProduction =\n      typeof process !== 'undefined' ? process.env.NODE_ENV === 'production' : false;\n\n    this.config = {\n      minLevel: config?.minLevel ?? (isProduction ? 1 : 0), // INFO in prod, DEBUG in dev\n      enableTimestamp: config?.enableTimestamp ?? true,\n      enableContext: config?.enableContext ?? true,\n      environment: config?.environment ?? (isProduction ? 'production' : 'development'),\n      adapter: config?.adapter ?? new ConsoleLoggerAdapter(),\n    };\n    this.adapter = this.config.adapter;\n    this.context = context;\n  }\n\n  /**\n   * 创建带上下文的子 Logger\n   */\n  createChild(context: string): Logger {\n    return new Logger(this.config, context);\n  }\n\n  /**\n   * 调试日志\n   */\n  debug(message: string, data?: any): void {\n    this.log(0, message, data); // LogLevel.DEBUG\n  }\n\n  /**\n   * 信息日志\n   */\n  info(message: string, data?: any): void {\n    this.log(1, message, data); // LogLevel.INFO\n  }\n\n  /**\n   * 警告日志\n   */\n  warn(message: string, data?: any): void {\n    this.log(2, message, data); // LogLevel.WARN\n  }\n\n  /**\n   * 错误日志\n   */\n  error(message: string, error?: Error | any): void {\n    this.log(\n      3, // LogLevel.ERROR\n      message,\n      error instanceof Error ? undefined : error,\n      error instanceof Error ? error : undefined\n    );\n  }\n\n  /**\n   * 核心日志方法\n   */\n  private log(level: LogLevel, message: string, data?: any, error?: Error): void {\n    // 检查日志级别\n    if (level < this.config.minLevel) {\n      return;\n    }\n\n    // 检查动态调试配置（仅在浏览器环境）\n    if (typeof window !== 'undefined' && typeof localStorage !== 'undefined') {\n      const loggerDebug = localStorage.getItem('logger-debug');\n      // 如果明确设置为 false，则不输出（但 Error 级别始终输出）\n      if (loggerDebug === 'false' && level < 3) {\n        // level < ERROR\n        return;\n      }\n    }\n\n    const entry: LogEntry = {\n      level,\n      message,\n      timestamp: this.config.enableTimestamp ? new Date() : (undefined as any),\n      data,\n      context: this.config.enableContext ? this.context : undefined,\n      error,\n    };\n\n    this.adapter.log(entry);\n  }\n\n  /**\n   * 设置日志级别\n   */\n  setLevel(level: LogLevel): void {\n    this.config.minLevel = level;\n  }\n\n  /**\n   * 获取当前日志级别\n   */\n  getLevel(): LogLevel {\n    return this.config.minLevel;\n  }\n}\n\n/**\n * 默认全局 Logger 实例\n */\nexport const logger = new Logger();\n\n/**\n * 创建带上下文的 Logger\n */\nexport function createLogger(context: string, config?: Partial<LoggerConfig>): Logger {\n  return new Logger(config, context);\n}\n\n"]}

package/dist/chunk-C7VOMO3L.mjs

@@ -0,0 +1,77 @@
+import { WebStorageAdapter } from './chunk-M7CA3DTF.mjs';
+import { useState, useEffect, useCallback } from 'react';
+
+function useStorage(storage, key, defaultValue) {
+  const [value, setValue] = useState(defaultValue);
+  const [loading, setLoading] = useState(true);
+  useEffect(() => {
+    const loadValue = async () => {
+      try {
+        const stored = await storage.getItem(key);
+        if (stored !== null) {
+          setValue(JSON.parse(stored));
+        }
+      } catch (error) {
+        console.error(`Error reading storage key "${key}":`, error);
+      } finally {
+        setLoading(false);
+      }
+    };
+    void loadValue();
+  }, [storage, key]);
+  const updateValue = useCallback(
+    async (newValue) => {
+      try {
+        setValue(newValue);
+        await storage.setItem(key, JSON.stringify(newValue));
+        if ("dispatchChange" in storage && typeof storage.dispatchChange === "function") {
+          storage.dispatchChange(key, JSON.stringify(newValue));
+        }
+      } catch (error) {
+        console.error(`Error setting storage key "${key}":`, error);
+      }
+    },
+    [storage, key]
+  );
+  const removeValue = useCallback(async () => {
+    try {
+      setValue(defaultValue);
+      await storage.removeItem(key);
+      if ("dispatchChange" in storage && typeof storage.dispatchChange === "function") {
+        storage.dispatchChange(key, null);
+      }
+    } catch (error) {
+      console.error(`Error removing storage key "${key}":`, error);
+    }
+  }, [storage, key, defaultValue]);
+  useEffect(() => {
+    if (!storage.addChangeListener) {
+      return;
+    }
+    const cleanup = storage.addChangeListener((changedKey, newValue) => {
+      if (changedKey === key) {
+        try {
+          if (newValue === null) {
+            setValue(defaultValue);
+          } else {
+            setValue(JSON.parse(newValue));
+          }
+        } catch (error) {
+          console.error("Error parsing storage change event:", error);
+        }
+      }
+    });
+    return cleanup;
+  }, [storage, key, defaultValue]);
+  return [value, updateValue, removeValue, loading];
+}
+
+// src/hooks/useLocalStorage.ts
+var webStorage = new WebStorageAdapter();
+function useLocalStorage(key, defaultValue) {
+  return useStorage(webStorage, key, defaultValue);
+}
+
+export { useLocalStorage, useStorage };
+//# sourceMappingURL=chunk-C7VOMO3L.mjs.map
+//# sourceMappingURL=chunk-C7VOMO3L.mjs.map

package/dist/chunk-C7VOMO3L.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useStorage.ts","../src/hooks/useLocalStorage.ts"],"names":[],"mappings":"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","file":"chunk-C7VOMO3L.mjs","sourcesContent":["/**\n * 通用存储 Hook\n * 支持多平台：Web、React Native、小程序\n *\n * 优点：\n * 1. 异步读取，不阻塞渲染\n * 2. 统一的错误处理\n * 3. 类型安全\n * 4. 跨平台支持\n * 5. 自动同步（支持的平台）\n */\n\nimport { useState, useEffect, useCallback } from 'react';\nimport type { StorageAdapter } from '../storage/types';\n\nexport function useStorage<T>(\n  storage: StorageAdapter,\n  key: string,\n  defaultValue: T\n): [T, (value: T) => void, () => void, boolean] {\n  const [value, setValue] = useState<T>(defaultValue);\n  const [loading, setLoading] = useState(true);\n\n  // 初始化时从存储读取\n  useEffect(() => {\n    const loadValue = async () => {\n      try {\n        const stored = await storage.getItem(key);\n        if (stored !== null) {\n          setValue(JSON.parse(stored));\n        }\n      } catch (error) {\n        console.error(`Error reading storage key \"${key}\":`, error);\n      } finally {\n        setLoading(false);\n      }\n    };\n\n    void loadValue();\n  }, [storage, key]);\n\n  // 更新值并同步到存储\n  const updateValue = useCallback(\n    async (newValue: T) => {\n      try {\n        setValue(newValue);\n        await storage.setItem(key, JSON.stringify(newValue));\n\n        // 如果是 Web 适配器，触发自定义事件\n        if ('dispatchChange' in storage && typeof storage.dispatchChange === 'function') {\n          (storage as any).dispatchChange(key, JSON.stringify(newValue));\n        }\n      } catch (error) {\n        console.error(`Error setting storage key \"${key}\":`, error);\n      }\n    },\n    [storage, key]\n  );\n\n  // 删除值\n  const removeValue = useCallback(async () => {\n    try {\n      setValue(defaultValue);\n      await storage.removeItem(key);\n\n      // 如果是 Web 适配器，触发自定义事件\n      if ('dispatchChange' in storage && typeof storage.dispatchChange === 'function') {\n        (storage as any).dispatchChange(key, null);\n      }\n    } catch (error) {\n      console.error(`Error removing storage key \"${key}\":`, error);\n    }\n  }, [storage, key, defaultValue]);\n\n  // 监听存储变化\n  useEffect(() => {\n    if (!storage.addChangeListener) {\n      return;\n    }\n\n    const cleanup = storage.addChangeListener((changedKey: string, newValue: string | null) => {\n      if (changedKey === key) {\n        try {\n          if (newValue === null) {\n            setValue(defaultValue);\n          } else {\n            setValue(JSON.parse(newValue));\n          }\n        } catch (error) {\n          console.error('Error parsing storage change event:', error);\n        }\n      }\n    });\n\n    return cleanup;\n  }, [storage, key, defaultValue]);\n\n  return [value, updateValue, removeValue, loading];\n}\n\n","/**\n * Web 平台 localStorage Hook\n * 基于通用 useStorage 的便捷封装\n */\n\nimport { useStorage } from './useStorage';\nimport { WebStorageAdapter } from '../storage';\n\n// 创建单例适配器\nconst webStorage = new WebStorageAdapter();\n\n/**\n * Web 平台的 localStorage Hook\n *\n * @param key - 存储键名\n * @param defaultValue - 默认值\n * @returns [value, setValue, removeValue, isLoading]\n */\nexport function useLocalStorage<T>(\n  key: string,\n  defaultValue: T\n): [T, (value: T) => void, () => void, boolean] {\n  return useStorage(webStorage, key, defaultValue);\n}\n\n"]}