@qhr123/sa2kit 0.1.1

package/dist/logger/index.d.mts

@@ -0,0 +1,125 @@
+/**
+ * 日志级别
+ */
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+/**
+ * 日志条目
+ */
+interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: Date;
+    data?: any;
+    context?: string;
+    error?: Error;
+}
+/**
+ * 日志适配器接口
+ * 不同平台实现不同的日志输出方式
+ */
+interface LoggerAdapter {
+    /**
+     * 输出日志
+     */
+    log(entry: LogEntry): void;
+    /**
+     * 批量输出日志（可选）
+     */
+    logBatch?(entries: LogEntry[]): void;
+}
+/**
+ * 日志配置
+ */
+interface LoggerConfig {
+    /**
+     * 最小日志级别
+     * 只有大于等于此级别的日志才会输出
+     */
+    minLevel: LogLevel;
+    /**
+     * 是否启用时间戳
+     */
+    enableTimestamp?: boolean;
+    /**
+     * 是否启用上下文（模块名）
+     */
+    enableContext?: boolean;
+    /**
+     * 环境（development/production）
+     */
+    environment?: 'development' | 'production';
+    /**
+     * 自定义适配器
+     */
+    adapter?: LoggerAdapter;
+}
+
+/**
+ * 统一日志管理类
+ */
+declare class Logger {
+    private config;
+    private adapter;
+    private context?;
+    constructor(config?: Partial<LoggerConfig>, context?: string);
+    /**
+     * 创建带上下文的子 Logger
+     */
+    createChild(context: string): Logger;
+    /**
+     * 调试日志
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * 信息日志
+     */
+    info(message: string, data?: any): void;
+    /**
+     * 警告日志
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * 错误日志
+     */
+    error(message: string, error?: Error | any): void;
+    /**
+     * 核心日志方法
+     */
+    private log;
+    /**
+     * 设置日志级别
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * 获取当前日志级别
+     */
+    getLevel(): LogLevel;
+}
+/**
+ * 默认全局 Logger 实例
+ */
+declare const logger: Logger;
+/**
+ * 创建带上下文的 Logger
+ */
+declare function createLogger(context: string, config?: Partial<LoggerConfig>): Logger;
+
+/**
+ * 控制台日志适配器
+ * 使用 console.info/warn/error 输出日志
+ */
+declare class ConsoleLoggerAdapter implements LoggerAdapter {
+    private readonly colors;
+    log(entry: LogEntry): void;
+    private formatTimestamp;
+    private getLevelName;
+    private colorize;
+}
+
+export { ConsoleLoggerAdapter, type LogEntry, LogLevel, Logger, type LoggerAdapter, type LoggerConfig, createLogger, logger };

package/dist/logger/index.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 日志级别
+ */
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+/**
+ * 日志条目
+ */
+interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: Date;
+    data?: any;
+    context?: string;
+    error?: Error;
+}
+/**
+ * 日志适配器接口
+ * 不同平台实现不同的日志输出方式
+ */
+interface LoggerAdapter {
+    /**
+     * 输出日志
+     */
+    log(entry: LogEntry): void;
+    /**
+     * 批量输出日志（可选）
+     */
+    logBatch?(entries: LogEntry[]): void;
+}
+/**
+ * 日志配置
+ */
+interface LoggerConfig {
+    /**
+     * 最小日志级别
+     * 只有大于等于此级别的日志才会输出
+     */
+    minLevel: LogLevel;
+    /**
+     * 是否启用时间戳
+     */
+    enableTimestamp?: boolean;
+    /**
+     * 是否启用上下文（模块名）
+     */
+    enableContext?: boolean;
+    /**
+     * 环境（development/production）
+     */
+    environment?: 'development' | 'production';
+    /**
+     * 自定义适配器
+     */
+    adapter?: LoggerAdapter;
+}
+
+/**
+ * 统一日志管理类
+ */
+declare class Logger {
+    private config;
+    private adapter;
+    private context?;
+    constructor(config?: Partial<LoggerConfig>, context?: string);
+    /**
+     * 创建带上下文的子 Logger
+     */
+    createChild(context: string): Logger;
+    /**
+     * 调试日志
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * 信息日志
+     */
+    info(message: string, data?: any): void;
+    /**
+     * 警告日志
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * 错误日志
+     */
+    error(message: string, error?: Error | any): void;
+    /**
+     * 核心日志方法
+     */
+    private log;
+    /**
+     * 设置日志级别
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * 获取当前日志级别
+     */
+    getLevel(): LogLevel;
+}
+/**
+ * 默认全局 Logger 实例
+ */
+declare const logger: Logger;
+/**
+ * 创建带上下文的 Logger
+ */
+declare function createLogger(context: string, config?: Partial<LoggerConfig>): Logger;
+
+/**
+ * 控制台日志适配器
+ * 使用 console.info/warn/error 输出日志
+ */
+declare class ConsoleLoggerAdapter implements LoggerAdapter {
+    private readonly colors;
+    log(entry: LogEntry): void;
+    private formatTimestamp;
+    private getLevelName;
+    private colorize;
+}
+
+export { ConsoleLoggerAdapter, type LogEntry, LogLevel, Logger, type LoggerAdapter, type LoggerConfig, createLogger, logger };

package/dist/logger/index.js

@@ -0,0 +1,28 @@
+'use strict';
+
+var chunk6PRFP5EG_js = require('../chunk-6PRFP5EG.js');
+
+
+
+Object.defineProperty(exports, "ConsoleLoggerAdapter", {
+  enumerable: true,
+  get: function () { return chunk6PRFP5EG_js.ConsoleLoggerAdapter; }
+});
+Object.defineProperty(exports, "LogLevel", {
+  enumerable: true,
+  get: function () { return chunk6PRFP5EG_js.LogLevel; }
+});
+Object.defineProperty(exports, "Logger", {
+  enumerable: true,
+  get: function () { return chunk6PRFP5EG_js.Logger; }
+});
+Object.defineProperty(exports, "createLogger", {
+  enumerable: true,
+  get: function () { return chunk6PRFP5EG_js.createLogger; }
+});
+Object.defineProperty(exports, "logger", {
+  enumerable: true,
+  get: function () { return chunk6PRFP5EG_js.logger; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/logger/index.mjs

@@ -0,0 +1,3 @@
+export { ConsoleLoggerAdapter, LogLevel, Logger, createLogger, logger } from '../chunk-KQGP6BTS.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/logger/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/storage/index.d.mts

@@ -0,0 +1,20 @@
+import { S as StorageAdapter } from '../types-BaZccpvk.mjs';
+export { a as StorageChangeEvent } from '../types-BaZccpvk.mjs';
+
+/**
+ * Web 平台存储适配器 (localStorage)
+ */
+
+declare class WebStorageAdapter implements StorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    addChangeListener(callback: (key: string, value: string | null) => void): () => void;
+    /**
+     * 触发自定义事件，通知同标签页的其他组件
+     */
+    dispatchChange(key: string, value: string | null): void;
+}
+
+export { StorageAdapter, WebStorageAdapter };

package/dist/storage/index.d.ts

@@ -0,0 +1,20 @@
+import { S as StorageAdapter } from '../types-BaZccpvk.js';
+export { a as StorageChangeEvent } from '../types-BaZccpvk.js';
+
+/**
+ * Web 平台存储适配器 (localStorage)
+ */
+
+declare class WebStorageAdapter implements StorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    addChangeListener(callback: (key: string, value: string | null) => void): () => void;
+    /**
+     * 触发自定义事件，通知同标签页的其他组件
+     */
+    dispatchChange(key: string, value: string | null): void;
+}
+
+export { StorageAdapter, WebStorageAdapter };

package/dist/storage/index.js

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunk4JTIYLS6_js = require('../chunk-4JTIYLS6.js');
+
+
+
+Object.defineProperty(exports, "WebStorageAdapter", {
+  enumerable: true,
+  get: function () { return chunk4JTIYLS6_js.WebStorageAdapter; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/storage/index.mjs

@@ -0,0 +1,3 @@
+export { WebStorageAdapter } from '../chunk-M7CA3DTF.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/storage/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/types-BaZccpvk.d.mts

@@ -0,0 +1,48 @@
+/**
+ * 存储适配器类型定义
+ */
+/**
+ * 存储适配器接口
+ * 用于抽象不同平台的本地存储实现
+ */
+interface StorageAdapter {
+    /**
+     * 获取存储的值
+     * @param key 存储键
+     * @returns 存储的值，不存在则返回 null
+     */
+    getItem(key: string): Promise<string | null>;
+    /**
+     * 设置存储的值
+     * @param key 存储键
+     * @param value 要存储的值
+     */
+    setItem(key: string, value: string): Promise<void>;
+    /**
+     * 删除存储的值
+     * @param key 存储键
+     */
+    removeItem(key: string): Promise<void>;
+    /**
+     * 清空所有存储（可选）
+     */
+    clear?(): Promise<void>;
+    /**
+     * 监听存储变化（可选，部分平台支持）
+     */
+    addChangeListener?(callback: (key: string, value: string | null) => void): () => void;
+    /**
+     * 移除存储变化监听器（可选）
+     */
+    removeChangeListener?(callback: (key: string, value: string | null) => void): void;
+}
+/**
+ * 存储事件
+ */
+interface StorageChangeEvent {
+    key: string;
+    value: any;
+    oldValue?: any;
+}
+
+export type { StorageAdapter as S, StorageChangeEvent as a };

package/dist/types-BaZccpvk.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 存储适配器类型定义
+ */
+/**
+ * 存储适配器接口
+ * 用于抽象不同平台的本地存储实现
+ */
+interface StorageAdapter {
+    /**
+     * 获取存储的值
+     * @param key 存储键
+     * @returns 存储的值，不存在则返回 null
+     */
+    getItem(key: string): Promise<string | null>;
+    /**
+     * 设置存储的值
+     * @param key 存储键
+     * @param value 要存储的值
+     */
+    setItem(key: string, value: string): Promise<void>;
+    /**
+     * 删除存储的值
+     * @param key 存储键
+     */
+    removeItem(key: string): Promise<void>;
+    /**
+     * 清空所有存储（可选）
+     */
+    clear?(): Promise<void>;
+    /**
+     * 监听存储变化（可选，部分平台支持）
+     */
+    addChangeListener?(callback: (key: string, value: string | null) => void): () => void;
+    /**
+     * 移除存储变化监听器（可选）
+     */
+    removeChangeListener?(callback: (key: string, value: string | null) => void): void;
+}
+/**
+ * 存储事件
+ */
+interface StorageChangeEvent {
+    key: string;
+    value: any;
+    oldValue?: any;
+}
+
+export type { StorageAdapter as S, StorageChangeEvent as a };

package/dist/utils/index.d.mts

@@ -0,0 +1,170 @@
+/**
+ * 时间格式化工具
+ */
+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 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>;
+};
+
+export { arrayUtils, debugUtils, errorUtils, fileUtils, formatTime, stringUtils, validators };