@qhr123/sa2kit 0.1.1

package/dist/utils/index.d.ts

@@ -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 };

package/dist/utils/index.js

@@ -0,0 +1,37 @@
+'use strict';
+
+var chunkWO3H4BMN_js = require('../chunk-WO3H4BMN.js');
+require('../chunk-6PRFP5EG.js');
+
+
+
+Object.defineProperty(exports, "arrayUtils", {
+  enumerable: true,
+  get: function () { return chunkWO3H4BMN_js.arrayUtils; }
+});
+Object.defineProperty(exports, "debugUtils", {
+  enumerable: true,
+  get: function () { return chunkWO3H4BMN_js.debugUtils; }
+});
+Object.defineProperty(exports, "errorUtils", {
+  enumerable: true,
+  get: function () { return chunkWO3H4BMN_js.errorUtils; }
+});
+Object.defineProperty(exports, "fileUtils", {
+  enumerable: true,
+  get: function () { return chunkWO3H4BMN_js.fileUtils; }
+});
+Object.defineProperty(exports, "formatTime", {
+  enumerable: true,
+  get: function () { return chunkWO3H4BMN_js.formatTime; }
+});
+Object.defineProperty(exports, "stringUtils", {
+  enumerable: true,
+  get: function () { return chunkWO3H4BMN_js.stringUtils; }
+});
+Object.defineProperty(exports, "validators", {
+  enumerable: true,
+  get: function () { return chunkWO3H4BMN_js.validators; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/utils/index.mjs

@@ -0,0 +1,4 @@
+export { arrayUtils, debugUtils, errorUtils, fileUtils, formatTime, stringUtils, validators } from '../chunk-WFWG4UZF.mjs';
+import '../chunk-KQGP6BTS.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

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

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@qhr123/sa2kit",
+  "version": "0.1.1",
+  "description": "A modern, type-safe React utility library with cross-platform support",
+  "keywords": [
+    "react",
+    "typescript",
+    "utils",
+    "logger",
+    "storage",
+    "hooks",
+    "cross-platform"
+  ],
+  "author": "qxdqhr",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qxdqhr/sa2kit"
+  },
+  "homepage": "https://github.com/qxdqhr/sa2kit#readme",
+  "bugs": {
+    "url": "https://github.com/qxdqhr/sa2kit/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./logger": {
+      "types": "./dist/logger/index.d.ts",
+      "import": "./dist/logger/index.mjs",
+      "require": "./dist/logger/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.mjs",
+      "require": "./dist/utils/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.mjs",
+      "require": "./dist/hooks/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.mjs",
+      "require": "./dist/storage/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run build && pnpm run test",
+    "publish:beta": "npm publish --tag beta --access public",
+    "publish:latest": "npm publish --access public"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "@vitest/ui": "^1.2.0",
+    "@testing-library/react": "^14.0.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-react": "^7.33.2",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "jsdom": "^23.0.0",
+    "prettier": "^3.1.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "packageManager": "pnpm@9.15.2"
+}
+