sa2kit 1.6.10 → 1.6.11

package/dist/useElectronStorage-Dj0rcorG.d.mts

@@ -0,0 +1,65 @@
+import { S as StorageAdapter } from './types-BaZccpvk.mjs';
+
+/**
+ * 通用存储 Hook
+ * 支持多平台：Web、React Native、小程序
+ *
+ * 优点：
+ * 1. 异步读取，不阻塞渲染
+ * 2. 统一的错误处理
+ * 3. 类型安全
+ * 4. 跨平台支持
+ * 5. 自动同步（支持的平台）
+ */
+
+declare function useStorage<T>(storage: StorageAdapter, key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * Web 平台 localStorage Hook
+ * 基于通用 useStorage 的便捷封装
+ */
+/**
+ * Web 平台的 localStorage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useLocalStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * React Native 的 AsyncStorage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useAsyncStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * 小程序的 Taro Storage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useTaroStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * Electron 桌面端的 Storage Hook
+ *
+ * 在 Electron 渲染进程中使用 localStorage
+ * 支持跨窗口同步
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ *
+ * @example
+ * ```tsx
+ * const [token, setToken, removeToken] = useElectronStorage('auth-token', '')
+ * ```
+ */
+declare function useElectronStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+export { useLocalStorage as a, useAsyncStorage as b, useTaroStorage as c, useElectronStorage as d, useStorage as u };

package/dist/useElectronStorage-DwnNfIhl.d.ts

@@ -0,0 +1,65 @@
+import { S as StorageAdapter } from './types-BaZccpvk.js';
+
+/**
+ * 通用存储 Hook
+ * 支持多平台：Web、React Native、小程序
+ *
+ * 优点：
+ * 1. 异步读取，不阻塞渲染
+ * 2. 统一的错误处理
+ * 3. 类型安全
+ * 4. 跨平台支持
+ * 5. 自动同步（支持的平台）
+ */
+
+declare function useStorage<T>(storage: StorageAdapter, key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * Web 平台 localStorage Hook
+ * 基于通用 useStorage 的便捷封装
+ */
+/**
+ * Web 平台的 localStorage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useLocalStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * React Native 的 AsyncStorage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useAsyncStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * 小程序的 Taro Storage Hook
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ */
+declare function useTaroStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+/**
+ * Electron 桌面端的 Storage Hook
+ *
+ * 在 Electron 渲染进程中使用 localStorage
+ * 支持跨窗口同步
+ *
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [value, setValue, removeValue, isLoading]
+ *
+ * @example
+ * ```tsx
+ * const [token, setToken, removeToken] = useElectronStorage('auth-token', '')
+ * ```
+ */
+declare function useElectronStorage<T>(key: string, defaultValue: T): [T, (value: T) => void, () => void, boolean];
+
+export { useLocalStorage as a, useAsyncStorage as b, useTaroStorage as c, useElectronStorage as d, useStorage as u };

package/dist/utils/index.d.mts

@@ -0,0 +1,192 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * 时间格式化工具
+ */
+declare const formatTime: {
+    /**
+     * 将秒数转换为 MM:SS 格式
+     */
+    toMinutesSeconds(seconds: number): string;
+    /**
+     * 将秒数转换为 HH:MM:SS 格式
+     */
+    toHoursMinutesSeconds(seconds: number): string;
+    /**
+     * 格式化日期为用户友好的格式
+     */
+    formatDate(date: string | Date, locale?: string): string;
+};
+
+/**
+ * 日语文本处理工具
+ */
+declare const japaneseUtils: {
+    /**
+     * 提取文本中的汉字
+     */
+    extractKanji(text: string): string[];
+    /**
+     * 提取文本中的假名
+     */
+    extractKana(text: string): string[];
+    /**
+     * 清理文本，移除特殊字符但保留日语字符
+     */
+    cleanText(text: string): string;
+};
+
+/**
+ * 验证工具
+ */
+declare const validators: {
+    /**
+     * 验证邮箱格式
+     */
+    isValidEmail(email: string): boolean;
+    /**
+     * 验证密码强度
+     */
+    isValidPassword(password: string): {
+        isValid: boolean;
+        errors: string[];
+    };
+    /**
+     * 验证用户名格式
+     */
+    isValidUsername(username: string): boolean;
+    /**
+     * 验证文件大小
+     */
+    isValidFileSize(size: number, maxSize: number): boolean;
+    /**
+     * 验证文件类型
+     */
+    isValidFileType(type: string, supportedTypes: string[]): boolean;
+    /**
+     * 验证 URL 格式
+     */
+    isValidUrl(url: string): boolean;
+};
+
+/**
+ * 文件处理工具
+ */
+declare const fileUtils: {
+    /**
+     * 格式化文件大小
+     */
+    formatFileSize(bytes: number): string;
+    /**
+     * 获取文件扩展名
+     */
+    getFileExtension(filename: string): string;
+    /**
+     * 生成唯一文件名
+     */
+    generateUniqueFileName(originalName: string): string;
+    /**
+     * 验证文件名是否有效
+     */
+    isValidFilename(filename: string): boolean;
+};
+
+/**
+ * 数组和对象工具
+ */
+declare const arrayUtils: {
+    /**
+     * 数组去重
+     */
+    unique<T>(array: T[]): T[];
+    /**
+     * 数组分组
+     */
+    groupBy<T>(array: T[], key: keyof T): Record<string, T[]>;
+    /**
+     * 数组分页
+     */
+    paginate<T>(array: T[], page: number, limit: number): {
+        data: T[];
+        total: number;
+        page: number;
+        pages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+    /**
+     * 数组随机排序
+     */
+    shuffle<T>(array: T[]): T[];
+};
+
+/**
+ * 字符串工具
+ */
+declare const stringUtils: {
+    /**
+     * 截断文本
+     */
+    truncate(text: string, length: number, suffix?: string): string;
+    /**
+     * 首字母大写
+     */
+    capitalize(text: string): string;
+    /**
+     * 驼峰转下划线
+     */
+    camelToSnake(text: string): string;
+    /**
+     * 下划线转驼峰
+     */
+    snakeToCamel(text: string): string;
+    /**
+     * 生成随机字符串
+     */
+    generateRandom(length: number): string;
+};
+
+/**
+ * 调试工具
+ */
+declare const debugUtils: {
+    /**
+     * 安全的 JSON 序列化
+     */
+    safeStringify(obj: any): string;
+    /**
+     * 性能计时器
+     */
+    createTimer(label?: string): {
+        end: () => number;
+    };
+    /**
+     * 内存使用情况（仅在 Node.js 环境）
+     */
+    getMemoryUsage(): Record<string, string> | null;
+};
+
+/**
+ * 错误处理工具
+ */
+declare const errorUtils: {
+    /**
+     * 创建标准化的错误对象
+     */
+    createError(code: string, message: string, details?: any): Error & {
+        code: string;
+        details?: any;
+    };
+    /**
+     * 安全的错误信息提取
+     */
+    extractErrorMessage(error: unknown): string;
+    /**
+     * 错误重试机制
+     */
+    retry<T>(fn: () => Promise<T>, maxAttempts?: number, delay?: number): Promise<T>;
+};
+
+declare function cn(...inputs: ClassValue[]): string;
+
+export { arrayUtils, cn, debugUtils, errorUtils, fileUtils, formatTime, japaneseUtils, stringUtils, validators };

package/dist/utils/index.d.ts

@@ -0,0 +1,192 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * 时间格式化工具
+ */
+declare const formatTime: {
+    /**
+     * 将秒数转换为 MM:SS 格式
+     */
+    toMinutesSeconds(seconds: number): string;
+    /**
+     * 将秒数转换为 HH:MM:SS 格式
+     */
+    toHoursMinutesSeconds(seconds: number): string;
+    /**
+     * 格式化日期为用户友好的格式
+     */
+    formatDate(date: string | Date, locale?: string): string;
+};
+
+/**
+ * 日语文本处理工具
+ */
+declare const japaneseUtils: {
+    /**
+     * 提取文本中的汉字
+     */
+    extractKanji(text: string): string[];
+    /**
+     * 提取文本中的假名
+     */
+    extractKana(text: string): string[];
+    /**
+     * 清理文本，移除特殊字符但保留日语字符
+     */
+    cleanText(text: string): string;
+};
+
+/**
+ * 验证工具
+ */
+declare const validators: {
+    /**
+     * 验证邮箱格式
+     */
+    isValidEmail(email: string): boolean;
+    /**
+     * 验证密码强度
+     */
+    isValidPassword(password: string): {
+        isValid: boolean;
+        errors: string[];
+    };
+    /**
+     * 验证用户名格式
+     */
+    isValidUsername(username: string): boolean;
+    /**
+     * 验证文件大小
+     */
+    isValidFileSize(size: number, maxSize: number): boolean;
+    /**
+     * 验证文件类型
+     */
+    isValidFileType(type: string, supportedTypes: string[]): boolean;
+    /**
+     * 验证 URL 格式
+     */
+    isValidUrl(url: string): boolean;
+};
+
+/**
+ * 文件处理工具
+ */
+declare const fileUtils: {
+    /**
+     * 格式化文件大小
+     */
+    formatFileSize(bytes: number): string;
+    /**
+     * 获取文件扩展名
+     */
+    getFileExtension(filename: string): string;
+    /**
+     * 生成唯一文件名
+     */
+    generateUniqueFileName(originalName: string): string;
+    /**
+     * 验证文件名是否有效
+     */
+    isValidFilename(filename: string): boolean;
+};
+
+/**
+ * 数组和对象工具
+ */
+declare const arrayUtils: {
+    /**
+     * 数组去重
+     */
+    unique<T>(array: T[]): T[];
+    /**
+     * 数组分组
+     */
+    groupBy<T>(array: T[], key: keyof T): Record<string, T[]>;
+    /**
+     * 数组分页
+     */
+    paginate<T>(array: T[], page: number, limit: number): {
+        data: T[];
+        total: number;
+        page: number;
+        pages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+    /**
+     * 数组随机排序
+     */
+    shuffle<T>(array: T[]): T[];
+};
+
+/**
+ * 字符串工具
+ */
+declare const stringUtils: {
+    /**
+     * 截断文本
+     */
+    truncate(text: string, length: number, suffix?: string): string;
+    /**
+     * 首字母大写
+     */
+    capitalize(text: string): string;
+    /**
+     * 驼峰转下划线
+     */
+    camelToSnake(text: string): string;
+    /**
+     * 下划线转驼峰
+     */
+    snakeToCamel(text: string): string;
+    /**
+     * 生成随机字符串
+     */
+    generateRandom(length: number): string;
+};
+
+/**
+ * 调试工具
+ */
+declare const debugUtils: {
+    /**
+     * 安全的 JSON 序列化
+     */
+    safeStringify(obj: any): string;
+    /**
+     * 性能计时器
+     */
+    createTimer(label?: string): {
+        end: () => number;
+    };
+    /**
+     * 内存使用情况（仅在 Node.js 环境）
+     */
+    getMemoryUsage(): Record<string, string> | null;
+};
+
+/**
+ * 错误处理工具
+ */
+declare const errorUtils: {
+    /**
+     * 创建标准化的错误对象
+     */
+    createError(code: string, message: string, details?: any): Error & {
+        code: string;
+        details?: any;
+    };
+    /**
+     * 安全的错误信息提取
+     */
+    extractErrorMessage(error: unknown): string;
+    /**
+     * 错误重试机制
+     */
+    retry<T>(fn: () => Promise<T>, maxAttempts?: number, delay?: number): Promise<T>;
+};
+
+declare function cn(...inputs: ClassValue[]): string;
+
+export { arrayUtils, cn, debugUtils, errorUtils, fileUtils, formatTime, japaneseUtils, stringUtils, validators };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sa2kit",
-  "version": "1.6.10",
+  "version": "1.6.11",
   "description": "A modern, type-safe React utility library with cross-platform support and platform adapters",
   "keywords": [
     "react",
@@ -310,6 +310,7 @@
     "@radix-ui/react-avatar": "^1.1.10",
     "@radix-ui/react-dialog": "^1.1.6",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-label": "^2.1.8",
     "@radix-ui/react-popover": "^1.1.6",
     "@radix-ui/react-progress": "^1.1.7",
     "@radix-ui/react-scroll-area": "^1.2.10",

package/dist/chunk-4FOBBWXW.mjs

@@ -1,179 +0,0 @@
-import { cn } from './chunk-3BGPZN4X.mjs';
-import React2, { useEffect } from 'react';
-
-var SearchBox = ({
-  searchQuery,
-  onSearchChange,
-  placeholder = "\u641C\u7D22\u5B9E\u9A8C\u9879\u76EE\u7684\u6807\u9898\u3001\u63CF\u8FF0\u6216\u6807\u7B7E...",
-  size = "large"
-}) => {
-  const getSizeStyles = () => {
-    switch (size) {
-      case "small":
-        return {
-          container: "h-10",
-          input: "pl-10 pr-10 text-sm",
-          icon: "w-4 h-4",
-          iconPosition: "left-3",
-          clearButton: "right-2 w-6 h-6",
-          clearIcon: "w-3 h-3"
-        };
-      case "medium":
-        return {
-          container: "h-12",
-          input: "pl-12 pr-12 text-base",
-          icon: "w-5 h-5",
-          iconPosition: "left-3",
-          clearButton: "right-3 w-7 h-7",
-          clearIcon: "w-4 h-4"
-        };
-      case "large":
-      default:
-        return {
-          container: "h-16",
-          input: "pl-6 pr-16 text-lg",
-          icon: "w-6 h-6",
-          iconPosition: "left-6",
-          clearButton: "right-4 w-8 h-8",
-          clearIcon: "w-4 h-4"
-        };
-    }
-  };
-  const styles = getSizeStyles();
-  const isLarge = size === "large";
-  return /* @__PURE__ */ React2.createElement("div", { className: "relative group w-full" }, /* @__PURE__ */ React2.createElement(
-    "input",
-    {
-      type: "text",
-      placeholder,
-      value: searchQuery,
-      onChange: (e) => onSearchChange(e.target.value),
-      className: `
-          w-full ${styles.container} ${styles.input}
-          ${isLarge ? "border-2 border-gray-200 rounded-2xl shadow-lg" : "border border-gray-300 rounded-lg shadow-sm"}
-          bg-white 
-          focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 
-          hover:border-gray-400 ${isLarge ? "hover:shadow-xl" : "hover:shadow-md"}
-          transition-all duration-300 ease-out
-          text-gray-800 placeholder-gray-500
-          ${isLarge ? "font-medium" : "font-normal"}
-        `
-    }
-  ), searchQuery && /* @__PURE__ */ React2.createElement(
-    "button",
-    {
-      onClick: () => onSearchChange(""),
-      className: `
-            absolute top-1/2 ${styles.clearButton} transform -translate-y-1/2
-            z-10 group/clear
-          `
-    },
-    /* @__PURE__ */ React2.createElement("div", { className: `
-            ${styles.clearButton} flex items-center justify-center
-            rounded-full 
-            bg-gray-100 hover:bg-gray-200 
-            transition-all duration-200 
-            group-hover/clear:scale-105
-          ` }, /* @__PURE__ */ React2.createElement(
-      "svg",
-      {
-        className: `${styles.clearIcon} text-gray-500 group-hover/clear:text-gray-700`,
-        fill: "none",
-        stroke: "currentColor",
-        viewBox: "0 0 24 24"
-      },
-      /* @__PURE__ */ React2.createElement(
-        "path",
-        {
-          strokeLinecap: "round",
-          strokeLinejoin: "round",
-          strokeWidth: 2,
-          d: "M6 18L18 6M6 6l12 12"
-        }
-      )
-    ))
-  ));
-};
-var Modal = ({
-  isOpen,
-  onClose,
-  title,
-  children,
-  width = 600,
-  height,
-  maskClosable = true,
-  className = "",
-  contentClassName = "",
-  showCloseButton = true,
-  zIndex
-}) => {
-  useEffect(() => {
-    if (isOpen) {
-      document.body.style.overflow = "hidden";
-    } else {
-      document.body.style.overflow = "unset";
-    }
-    return () => {
-      document.body.style.overflow = "unset";
-    };
-  }, [isOpen]);
-  if (!isOpen) return null;
-  return /* @__PURE__ */ React2.createElement("div", { className: "fixed inset-0 flex items-center justify-center p-4", style: { zIndex: zIndex || 50 } }, /* @__PURE__ */ React2.createElement(
-    "div",
-    {
-      className: "fixed inset-0 bg-black/50 transition-opacity",
-      onClick: () => maskClosable && onClose()
-    }
-  ), /* @__PURE__ */ React2.createElement(
-    "div",
-    {
-      className: cn(
-        "bg-white rounded-xl shadow-2xl z-10 overflow-hidden flex flex-col transition-all transform scale-100",
-        className
-      ),
-      style: {
-        width: typeof width === "number" ? `${width}px` : width,
-        height: typeof height === "number" ? `${height}px` : height,
-        maxWidth: "100%"
-      }
-    },
-    (title || showCloseButton) && /* @__PURE__ */ React2.createElement("div", { className: "px-6 py-4 border-b border-gray-200 flex justify-between items-center" }, /* @__PURE__ */ React2.createElement("h3", { className: "text-xl font-semibold text-gray-900" }, title), showCloseButton && /* @__PURE__ */ React2.createElement("button", { onClick: onClose, className: "text-gray-400 hover:text-gray-600 transition-colors" }, /* @__PURE__ */ React2.createElement("span", { className: "text-2xl" }, "\xD7"))),
-    /* @__PURE__ */ React2.createElement("div", { className: cn("flex-1 overflow-y-auto", contentClassName) }, children)
-  ));
-};
-var ConfirmModal = ({
-  isOpen,
-  onClose,
-  onConfirm,
-  title,
-  message,
-  confirmText = "\u786E\u5B9A",
-  cancelText = "\u53D6\u6D88",
-  isLoading = false,
-  className = "",
-  zIndex
-}) => {
-  if (!isOpen) return null;
-  return /* @__PURE__ */ React2.createElement(Modal, { isOpen, onClose, title, width: 400, className, zIndex }, /* @__PURE__ */ React2.createElement("div", { className: "p-6" }, /* @__PURE__ */ React2.createElement("p", { className: "text-gray-600 mb-6" }, message), /* @__PURE__ */ React2.createElement("div", { className: "flex justify-end space-x-3" }, /* @__PURE__ */ React2.createElement(
-    "button",
-    {
-      onClick: onClose,
-      className: "px-4 py-2 text-gray-700 border border-gray-300 rounded-lg hover:bg-gray-50 transition-colors",
-      disabled: isLoading
-    },
-    cancelText
-  ), /* @__PURE__ */ React2.createElement(
-    "button",
-    {
-      onClick: onConfirm,
-      className: "px-4 py-2 bg-red-600 text-white rounded-lg hover:bg-red-700 transition-colors flex items-center",
-      disabled: isLoading
-    },
-    isLoading && /* @__PURE__ */ React2.createElement("div", { className: "mr-2 w-4 h-4 border-2 border-white border-t-transparent rounded-full animate-spin" }),
-    confirmText
-  ))));
-};
-
-export { ConfirmModal, Modal, SearchBox };
-//# sourceMappingURL=chunk-4FOBBWXW.mjs.map
-//# sourceMappingURL=chunk-4FOBBWXW.mjs.map