my-uniapp-tools 1.0.13 → 1.0.15

package/dist/system/index.d.ts

@@ -65,3 +65,24 @@ export declare const getTopNavBarHeight: () => {
     statusBarHeight: number;
     navHeight: number;
 };
+/**
+ * 修改浏览器标题
+ * @param title 新的页面标题
+ * @description 动态修改浏览器标签页显示的标题，仅在H5/Web平台有效
+ * @example
+ * // 修改页面标题
+ * setPageTitle('新的页面标题')
+ */
+export declare const setPageTitle: (title: string) => boolean | null;
+/**
+ * 修改浏览器图标（favicon）
+ * @param iconUrl 新的图标URL地址
+ * @param iconType 图标类型，默认为 'image/x-icon'
+ * @description 动态修改浏览器标签页显示的图标，仅在H5/Web平台有效
+ * @example
+ * // 修改页面图标
+ * setPageIcon('https://example.com/new-icon.ico')
+ * // 或使用PNG格式
+ * setPageIcon('https://example.com/new-icon.png', 'image/png')
+ */
+export declare const setPageIcon: (iconUrl: string, iconType?: string) => boolean | null;

package/dist/upload/index.d.ts

@@ -0,0 +1,153 @@
+/**
+ * 文件上传相关工具函数
+ * 支持微信小程序、支付宝小程序、H5多端兼容
+ */
+/**
+ * 上传配置接口
+ */
+export interface UploadConfig {
+    /** 上传服务器地址 */
+    url: string;
+    /** 文件对应的 key，开发者在服务端可以通过这个 key 获取文件的二进制内容 */
+    name?: string;
+    /** HTTP 请求中其他额外的 form data */
+    formData?: Record<string, any>;
+    /** HTTP 请求 Header，Header 中不能设置 Referer */
+    header?: Record<string, string>;
+    /** 文件大小限制(MB) */
+    maxSize?: number;
+    /** 允许的文件类型 */
+    allowedTypes?: string[];
+    /** 是否显示提示信息 */
+    showToast?: boolean;
+    /** 超时时间(ms) */
+    timeout?: number;
+    /** 成功提示信息 */
+    successMessage?: string;
+    /** 失败提示信息 */
+    failMessage?: string;
+}
+/**
+ * 文件选择类型
+ */
+export type FileSelectType = 'image' | 'messagefile' | 'local';
+/**
+ * 选择文件配置接口
+ */
+export interface ChooseFileConfig {
+    /** 文件选择类型 */
+    type?: FileSelectType;
+    /** 最多可以选择的文件数量 */
+    count?: number;
+    /** 所选的图片的尺寸（仅image类型有效） */
+    sizeType?: ('original' | 'compressed')[];
+    /** 选择图片的来源（仅image类型有效） */
+    sourceType?: ('album' | 'camera')[];
+    /** 文件类型限制（仅local类型有效） */
+    extension?: string[];
+    /** 文件大小限制(MB) */
+    maxSize?: number;
+    /** 是否显示提示信息 */
+    showToast?: boolean;
+    /** 失败提示信息 */
+    failMessage?: string;
+}
+/**
+ * 选择图片配置接口（向后兼容）
+ */
+export interface ChooseImageConfig extends Omit<ChooseFileConfig, 'type' | 'extension'> {
+}
+/**
+ * 上传结果接口
+ */
+export interface UploadResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 服务器返回的数据 */
+    data?: any;
+    /** 提示信息 */
+    message?: string;
+    /** 本地临时文件路径 */
+    tempFilePath?: string;
+    /** HTTP 状态码 */
+    statusCode?: number;
+}
+/**
+ * 选择文件结果接口
+ */
+export interface ChooseFileResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 临时文件路径数组 */
+    tempFilePaths?: string[];
+    /** 临时文件对象数组 */
+    tempFiles?: Array<{
+        path: string;
+        size: number;
+    }>;
+    /** 提示信息 */
+    message?: string;
+    /** 文件选择类型 */
+    type: FileSelectType;
+}
+/**
+ * 选择图片结果接口（向后兼容）
+ */
+export interface ChooseImageResult extends Omit<ChooseFileResult, 'type'> {
+}
+/**
+ * 上传进度回调函数类型
+ */
+export type ProgressCallback = (progress: {
+    /** 上传进度百分比 */
+    progress: number;
+    /** 已经上传的数据长度 */
+    totalBytesSent: number;
+    /** 预期需要上传的数据总长度 */
+    totalBytesExpectedToSend: number;
+}) => void;
+export declare function chooseFile(config?: ChooseFileConfig): Promise<ChooseFileResult>;
+/**
+ * 选择图片（向后兼容）
+ * @param config 选择配置
+ * @returns Promise<ChooseImageResult> 选择结果
+ */
+export declare function chooseImage(config?: ChooseImageConfig): Promise<ChooseImageResult>;
+/**
+ * 上传文件
+ * @param filePath 文件路径
+ * @param config 上传配置
+ * @param onProgress 进度回调
+ * @returns Promise<UploadResult> 上传结果
+ */
+export declare function uploadFile(filePath: string, config: UploadConfig, onProgress?: ProgressCallback): Promise<UploadResult>;
+/**
+ * 选择并上传文件（一体化功能）
+ * @param config 上传配置
+ * @param chooseConfig 选择文件配置
+ * @param onProgress 进度回调
+ * @returns Promise<UploadResult[]> 上传结果数组
+ */
+export declare function chooseAndUploadFile(config: UploadConfig, chooseConfig?: ChooseFileConfig, onProgress?: ProgressCallback): Promise<UploadResult[]>;
+/**
+ * 选择并上传图片（向后兼容）
+ * @param config 上传配置
+ * @param chooseConfig 选择图片配置
+ * @param onProgress 进度回调
+ * @returns Promise<UploadResult[]> 上传结果数组
+ */
+export declare function chooseAndUploadImage(config: UploadConfig, chooseConfig?: ChooseImageConfig, onProgress?: ProgressCallback): Promise<UploadResult[]>;
+/**
+ * 检查是否支持文件上传
+ * @returns boolean 是否支持
+ */
+export declare function isUploadSupported(): boolean;
+/**
+ * 获取文件信息
+ * @param filePath 文件路径
+ * @returns Promise<{size: number, type?: string}> 文件信息
+ */
+export declare function getFileInfo(filePath: string): Promise<{
+    size: number;
+    digest?: string;
+} | null>;

package/package.json

@@ -1,72 +1,76 @@
-{
-    "name": "my-uniapp-tools",
-    "version": "1.0.13",
-    "type": "module",
-    "description": "一个功能强大、性能优化的 uni-app 开发工具库，提供剪贴板、本地存储、导航、系统信息等常用功能",
-    "main": "dist/my-uniapp-tools.cjs.js",
-    "module": "dist/my-uniapp-tools.esm.js",
-    "types": "dist/index.d.ts",
-    "files": [
-        "dist",
-        "README.md"
-    ],
-    "scripts": {
-        "build": "rollup -c && tsc --declaration --emitDeclarationOnly --outDir dist",
-        "prepublishOnly": "npm run build",
-        "test": "echo \"Error: no test specified\" && exit 1",
-        "dev": "node src/index.js",
-        "docs:dev": "vuepress dev docs",
-        "docs:build": "vuepress build docs"
-    },
-    "keywords": [
-        "uniapp",
-        "uni-app",
-        "utils",
-        "tools",
-        "clipboard",
-        "storage",
-        "navigation",
-        "system",
-        "performance",
-        "typescript",
-        "微信小程序",
-        "支付宝小程序",
-        "H5",
-        "App"
-    ],
-    "author": "Your Name <your.email@example.com>",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/yourusername/my-uniapp-tools.git"
-    },
-    "bugs": {
-        "url": "https://github.com/yourusername/my-uniapp-tools/issues"
-    },
-    "homepage": "https://github.com/yourusername/my-uniapp-tools#readme",
-    "engines": {
-        "node": ">=14.0.0"
-    },
-    "peerDependencies": {
-        "@dcloudio/types": "^3.0.0"
-    },
-    "dependencies": {
-        "tslib": "^2.8.1"
-    },
-    "devDependencies": {
-        "@dcloudio/types": "^3.4.14",
-        "@rollup/plugin-node-resolve": "^16.0.1",
-        "@rollup/plugin-typescript": "^12.1.4",
-        "@vuepress/bundler-vite": "^2.0.0-rc.24",
-        "@vuepress/client": "^2.0.0-rc.24",
-        "@vuepress/theme-default": "^2.0.0-rc.112",
-        "@vuepress/utils": "^2.0.0-rc.24",
-        "rollup": "^4.45.1",
-        "sass-embedded": "^1.89.2",
-        "typescript": "^5.8.3",
-        "vuepress": "^2.0.0-rc.24"
-    },
-    "directories": {
-        "example": "examples"
-    }
-}
+{
+    "name": "my-uniapp-tools",
+    "version": "1.0.15",
+    "type": "module",
+    "description": "一个功能强大、性能优化的 uni-app 开发工具库，提供剪贴板、本地存储、导航、系统信息等常用功能",
+    "main": "dist/my-uniapp-tools.cjs.js",
+    "module": "dist/my-uniapp-tools.esm.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist/*.js",
+        "dist/*.d.ts",
+        "dist/*/index.d.ts",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "rollup -c && tsc --declaration --emitDeclarationOnly --outDir dist",
+        "build:prod": "NODE_ENV=production rollup -c && tsc --declaration --emitDeclarationOnly --outDir dist",
+        "prepublishOnly": "npm run build:prod",
+        "test": "echo \"Error: no test specified\" && exit 1",
+        "dev": "node src/index.js",
+        "docs:dev": "vuepress dev docs",
+        "docs:build": "vuepress build docs"
+    },
+    "keywords": [
+        "uniapp",
+        "uni-app",
+        "utils",
+        "tools",
+        "clipboard",
+        "storage",
+        "navigation",
+        "system",
+        "performance",
+        "typescript",
+        "微信小程序",
+        "支付宝小程序",
+        "H5",
+        "App"
+    ],
+    "author": "Your Name <your.email@example.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/yourusername/my-uniapp-tools.git"
+    },
+    "bugs": {
+        "url": "https://github.com/yourusername/my-uniapp-tools/issues"
+    },
+    "homepage": "https://github.com/yourusername/my-uniapp-tools#readme",
+    "engines": {
+        "node": ">=14.0.0"
+    },
+    "peerDependencies": {
+        "@dcloudio/types": "^3.0.0"
+    },
+    "dependencies": {
+        "tslib": "^2.8.1"
+    },
+    "devDependencies": {
+        "@dcloudio/types": "^3.4.14",
+        "@rollup/plugin-node-resolve": "^16.0.1",
+        "@rollup/plugin-terser": "^0.4.4",
+        "@rollup/plugin-typescript": "^12.1.4",
+        "@vuepress/bundler-vite": "^2.0.0-rc.24",
+        "@vuepress/client": "^2.0.0-rc.24",
+        "@vuepress/theme-default": "^2.0.0-rc.112",
+        "@vuepress/utils": "^2.0.0-rc.24",
+        "rollup": "^4.45.1",
+        "sass-embedded": "^1.89.2",
+        "typescript": "^5.8.3",
+        "vuepress": "^2.0.0-rc.24"
+    },
+    "directories": {
+        "example": "examples"
+    }
+}

package/dist/core/errorHandler.d.ts

@@ -1,44 +0,0 @@
-/**
- * 统一错误处理机制
- */
-export interface ErrorInfo {
-    code: string;
-    message: string;
-    module: string;
-    timestamp: number;
-    stack?: string;
-}
-export declare class UniAppToolsError extends Error {
-    code: string;
-    module: string;
-    timestamp: number;
-    constructor(code: string, message: string, module: string);
-}
-/**
- * 全局错误处理器
- */
-export declare class ErrorHandler {
-    private static instance;
-    private errorCallbacks;
-    static getInstance(): ErrorHandler;
-    /**
-     * 注册错误回调
-     */
-    onError(callback: (error: ErrorInfo) => void): void;
-    /**
-     * 处理错误
-     */
-    handleError(error: Error | UniAppToolsError, module: string): void;
-    /**
-     * 创建模块专用的错误处理函数
-     */
-    createModuleErrorHandler(moduleName: string): (code: string, message: string, originalError?: Error) => UniAppToolsError;
-}
-/**
- * 异步操作包装器，统一错误处理
- */
-export declare function safeAsync<T>(operation: () => Promise<T>, moduleName: string, errorCode?: string): Promise<T | null>;
-/**
- * 同步操作包装器，统一错误处理
- */
-export declare function safeSync<T>(operation: () => T, moduleName: string, errorCode?: string, defaultValue?: T | null): T | null;

package/dist/core/performance.d.ts

@@ -1,42 +0,0 @@
-/**
- * 性能监控工具
- */
-export interface PerformanceMetric {
-    name: string;
-    startTime: number;
-    endTime?: number;
-    duration?: number;
-    module: string;
-    metadata?: Record<string, any>;
-}
-export declare class PerformanceMonitor {
-    private static instance;
-    private metrics;
-    private completedMetrics;
-    private maxStoredMetrics;
-    static getInstance(): PerformanceMonitor;
-    /**
-     * 开始性能测量
-     */
-    start(name: string, module: string, metadata?: Record<string, any>): void;
-    /**
-     * 结束性能测量
-     */
-    end(name: string): PerformanceMetric | null;
-    /**
-     * 获取性能报告
-     */
-    getReport(): {
-        byModule: Record<string, PerformanceMetric[]>;
-        slowest: PerformanceMetric[];
-        average: Record<string, number>;
-    };
-    /**
-     * 清除性能记录
-     */
-    clear(): void;
-}
-/**
- * 性能装饰器
- */
-export declare function measurePerformance(moduleName: string): (target: any, propertyName: string, descriptor: PropertyDescriptor) => void;