zcw-shared 1.14.0 → 1.16.1

package/dist/functions/image/compressToTargetSize.d.ts

@@ -0,0 +1,6 @@
+import type { File, Window } from '../../../references/browser.d';
+export declare function compressToTargetSize(file: File, options: {
+    targetSize?: number;
+    maxIterations?: number;
+    mimeType?: string;
+} | undefined, window: Window): Promise<File>;

package/dist/functions/image/compressToTargetSize.js

@@ -0,0 +1,107 @@
+export async function compressToTargetSize(file, options = {}, window) {
+    const { targetSize = 30 * 1024, maxIterations = 30, mimeType = 'image/jpeg' } = options;
+    if (file.size <= targetSize) {
+        return file;
+    }
+    const dimensions = await getImageDimensions(file, window);
+    let currentWidth = dimensions.width;
+    let currentHeight = dimensions.height;
+    let currentQuality = 0.9;
+    let iteration = 0;
+    async function attemptCompress() {
+        iteration++;
+        if (iteration > maxIterations) {
+            throw new Error(`压缩失败：达到最大尝试次数(${maxIterations})，仍未达到目标大小`);
+        }
+        const result = await compressImage(file, {
+            quality: currentQuality,
+            maxWidth: currentWidth,
+            maxHeight: currentHeight,
+            mimeType
+        }, window);
+        if (result.size <= targetSize) {
+            return result;
+        }
+        const ratio = targetSize / result.size;
+        if (ratio < 0.05) {
+            currentWidth = Math.max(50, Math.floor(currentWidth * 0.5));
+            currentHeight = Math.max(50, Math.floor(currentHeight * 0.5));
+            currentQuality = Math.max(0.05, currentQuality * 0.5);
+        }
+        else if (ratio < 0.15) {
+            currentWidth = Math.max(80, Math.floor(currentWidth * 0.6));
+            currentHeight = Math.max(80, Math.floor(currentHeight * 0.6));
+            currentQuality = Math.max(0.08, currentQuality * 0.6);
+        }
+        else if (ratio < 0.3) {
+            currentWidth = Math.max(100, Math.floor(currentWidth * 0.7));
+            currentHeight = Math.max(100, Math.floor(currentHeight * 0.7));
+            currentQuality = Math.max(0.1, currentQuality * 0.8);
+        }
+        else if (ratio < 0.7) {
+            currentWidth = Math.max(100, Math.floor(currentWidth * 0.85));
+            currentHeight = Math.max(100, Math.floor(currentHeight * 0.85));
+            currentQuality = Math.max(0.1, currentQuality * 0.85);
+        }
+        else {
+            currentQuality = Math.max(0.1, currentQuality * 0.9);
+        }
+        return attemptCompress();
+    }
+    return attemptCompress();
+}
+async function getImageDimensions(file, window) {
+    return new Promise((resolve, reject) => {
+        const img = new window.Image();
+        img.onload = () => {
+            resolve({
+                width: img.naturalWidth,
+                height: img.naturalHeight
+            });
+        };
+        img.onerror = () => {
+            reject(new Error('获取图片尺寸失败'));
+        };
+        img.src = window.URL.createObjectURL(file);
+    });
+}
+async function compressImage(file, options, window) {
+    const { quality, maxWidth, maxHeight, mimeType } = options;
+    return new Promise((resolve, reject) => {
+        const img = new window.Image();
+        img.onload = () => {
+            const canvas = window.document.createElement('canvas');
+            let width = img.naturalWidth;
+            let height = img.naturalHeight;
+            if (width > maxWidth || height > maxHeight) {
+                const ratio = Math.min(maxWidth / width, maxHeight / height);
+                width = Math.floor(width * ratio);
+                height = Math.floor(height * ratio);
+            }
+            canvas.width = width;
+            canvas.height = height;
+            const ctx = canvas.getContext('2d');
+            if (!ctx) {
+                reject(new Error('无法创建canvas上下文'));
+                return;
+            }
+            ctx.drawImage(img, 0, 0, width, height);
+            canvas.toBlob((blob) => {
+                if (!blob) {
+                    reject(new Error('图片压缩失败'));
+                    return;
+                }
+                const newFile = new window.File([blob], file.name, {
+                    type: mimeType,
+                    lastModified: Date.now()
+                });
+                resolve(newFile);
+            }, mimeType, quality);
+        };
+        img.onerror = () => {
+            reject(new Error('图片加载失败'));
+        };
+        img.src = window.URL.createObjectURL(file);
+    });
+}
+//# sourceMappingURL=compressToTargetSize.js.map

package/dist/functions/image/compressToTargetSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressToTargetSize.js","sourceRoot":"","sources":["../../../src/functions/image/compressToTargetSize.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAU,EACV,UAII,EAAE,EACN,MAAc;IAEd,MAAM,EACJ,UAAU,GAAG,EAAE,GAAG,IAAI,EACtB,aAAa,GAAG,EAAE,EAClB,QAAQ,GAAG,YAAY,EACxB,GAAG,OAAO,CAAA;IAGX,IAAI,IAAI,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAGD,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACzD,IAAI,YAAY,GAAG,UAAU,CAAC,KAAK,CAAA;IACnC,IAAI,aAAa,GAAG,UAAU,CAAC,MAAM,CAAA;IACrC,IAAI,cAAc,GAAG,GAAG,CAAA;IACxB,IAAI,SAAS,GAAG,CAAC,CAAA;IAGjB,KAAK,UAAU,eAAe;QAC5B,SAAS,EAAE,CAAA;QAEX,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,iBAAiB,aAAa,YAAY,CAAC,CAAA;QAC7D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE;YACvC,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,aAAa;YACxB,QAAQ;SACT,EAAE,MAAM,CAAC,CAAA;QAGV,IAAI,MAAM,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAA;QACf,CAAC;QAGD,MAAM,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC,IAAI,CAAA;QAEtC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;YAEjB,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAA;YAC3D,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAA;YAC7D,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,GAAG,CAAC,CAAA;QACvD,CAAC;aAAM,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;YAExB,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAA;YAC3D,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAA;YAC7D,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,GAAG,CAAC,CAAA;QACvD,CAAC;aAAM,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAEvB,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAA;YAC5D,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAA;YAC9D,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,GAAG,CAAC,CAAA;QACtD,CAAC;aAAM,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAEvB,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAA;YAC7D,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAA;YAC/D,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC,CAAA;QACvD,CAAC;aAAM,CAAC;YAEN,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,GAAG,CAAC,CAAA;QACtD,CAAC;QAGD,OAAO,eAAe,EAAE,CAAA;IAC1B,CAAC;IAED,OAAO,eAAe,EAAE,CAAA;AAC1B,CAAC;AAKD,KAAK,UAAU,kBAAkB,CAAC,IAAU,EAAE,MAAc;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAA;QAC9B,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE;YAChB,OAAO,CAAC;gBACN,KAAK,EAAE,GAAG,CAAC,YAAY;gBACvB,MAAM,EAAE,GAAG,CAAC,aAAa;aAC1B,CAAC,CAAA;QACJ,CAAC,CAAA;QACD,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE;YACjB,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;QAC/B,CAAC,CAAA;QACD,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;AACJ,CAAC;AAKD,KAAK,UAAU,aAAa,CAC1B,IAAU,EACV,OAKC,EACD,MAAc;IAEd,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAA;IAE1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAA;QAC9B,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE;YAEhB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;YACtD,IAAI,KAAK,GAAG,GAAG,CAAC,YAAY,CAAA;YAC5B,IAAI,MAAM,GAAG,GAAG,CAAC,aAAa,CAAA;YAG9B,IAAI,KAAK,GAAG,QAAQ,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,CAAA;gBAC5D,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAA;gBACjC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAA;YACrC,CAAC;YAED,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;YACpB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;YAGtB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;YACnC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAA;gBAClC,OAAM;YACR,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;YAGvC,MAAM,CAAC,MAAM,CACX,CAAC,IAAI,EAAE,EAAE;gBACP,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;oBAC3B,OAAM;gBACR,CAAC;gBAED,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE;oBACjD,IAAI,EAAE,QAAQ;oBACd,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;iBACzB,CAAC,CAAA;gBACF,OAAO,CAAC,OAAO,CAAC,CAAA;YAClB,CAAC,EACD,QAAQ,EACR,OAAO,CACR,CAAA;QACH,CAAC,CAAA;QACD,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE;YACjB,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC7B,CAAC,CAAA;QACD,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/functions/ipc/dispatchIpcRequest.d.ts

@@ -3,4 +3,14 @@ export interface IpcRequest {
     event: string;
     args: any;
 }
-export declare function dispatchIpcRequest(req: IpcRequest, functionsDir: string, path: Path): Promise<any>;
+export interface IpcHandlerMap {
+    [eventName: string]: {
+        default: (...args: any[]) => any | Promise<any>;
+    };
+}
+export declare function dispatchIpcRequest(req: IpcRequest, options: {
+    handlerMap: IpcHandlerMap;
+} | {
+    functionsDir: string;
+    path: Path;
+}): Promise<any>;

package/dist/functions/ipc/dispatchIpcRequest.js

@@ -1,10 +1,23 @@
-export async function dispatchIpcRequest(req, functionsDir, path) {
-    const funcPath = path.resolve(functionsDir, req.event);
-    const mod = await import(funcPath);
-    if (typeof mod.default !== 'function') {
-        throw new Error('Handler not found or handler is not a function');
+export async function dispatchIpcRequest(req, options) {
+    if ('handlerMap' in options) {
+        const module = options.handlerMap[req.event];
+        if (!module) {
+            throw new Error(`Handler not found for event: ${req.event}`);
+        }
+        if (typeof module.default !== 'function') {
+            throw new Error(`Handler for event '${req.event}' is not a function`);
+        }
+        return await module.default(req.args);
     }
-    const data = await mod.default(req.args);
-    return data;
+    if ('functionsDir' in options && 'path' in options) {
+        const funcPath = options.path.resolve(options.functionsDir, req.event);
+        const mod = await import(funcPath);
+        if (typeof mod.default !== 'function') {
+            throw new Error('Handler not found or handler is not a function');
+        }
+        const data = await mod.default(req.args);
+        return data;
+    }
+    throw new Error('Invalid options: must provide either handlerMap or functionsDir with path');
 }
 //# sourceMappingURL=dispatchIpcRequest.js.map

package/dist/functions/ipc/dispatchIpcRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"dispatchIpcRequest.js","sourceRoot":"","sources":["../../../src/functions/ipc/dispatchIpcRequest.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAe,EACf,YAAoB,EACpB,IAAU;IAEV,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"dispatchIpcRequest.js","sourceRoot":"","sources":["../../../src/functions/ipc/dispatchIpcRequest.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAe,EACf,OAEwC;IAGxC,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,KAAK,qBAAqB,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAGD,IAAI,cAAc,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;AAC/F,CAAC"}

package/dist/functions/tencent-cloud/deploy.tcb.d.ts

@@ -0,0 +1,3 @@
+import type { DeployOptions, DeployResult, DeployDependencies } from '../../../types/tencent-cloud.d';
+export declare function deployToTCB(options: DeployOptions, dependencies: DeployDependencies): Promise<DeployResult>;
+export default deployToTCB;

package/dist/functions/tencent-cloud/deploy.tcb.js

@@ -0,0 +1,47 @@
+export async function deployToTCB(options, dependencies) {
+    const { localPath, cloudPath = '/', envId, secretType, showProgress = true } = options;
+    const { cloudBase, path, fs, console, getSecret } = dependencies;
+    try {
+        if (!fs.existsSync(localPath)) {
+            return {
+                success: false,
+                error: `本地路径不存在: ${localPath}`
+            };
+        }
+        const secret = getSecret(secretType);
+        if (!secret || !secret.secretId || !secret.secretKey) {
+            return {
+                success: false,
+                error: `无效的密钥类型: ${secretType}`
+            };
+        }
+        const app = cloudBase.init({
+            secretId: secret.secretId,
+            secretKey: secret.secretKey,
+            envId
+        });
+        const hosting = app.hosting;
+        await hosting.uploadFiles({
+            localPath,
+            cloudPath,
+            onProgress: showProgress ? (progressData) => {
+                console.log(`上传进度: ${progressData.percent}%`);
+            } : undefined
+        });
+        console.log('文件上传成功');
+        return {
+            success: true,
+            message: '部署成功'
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error('部署失败:', error);
+        return {
+            success: false,
+            error: `部署失败: ${errorMessage}`
+        };
+    }
+}
+export default deployToTCB;
+//# sourceMappingURL=deploy.tcb.js.map

package/dist/functions/tencent-cloud/deploy.tcb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.tcb.js","sourceRoot":"","sources":["../../../src/functions/tencent-cloud/deploy.tcb.ts"],"names":[],"mappings":"AAwCA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAsB,EACtB,YAAgC;IAEhC,MAAM,EACJ,SAAS,EACT,SAAS,GAAG,GAAG,EACf,KAAK,EACL,UAAU,EACV,YAAY,GAAG,IAAI,EACpB,GAAG,OAAO,CAAA;IAEX,MAAM,EACJ,SAAS,EACT,IAAI,EACJ,EAAE,EACF,OAAO,EACP,SAAS,EACV,GAAG,YAAY,CAAA;IAEhB,IAAI,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY,SAAS,EAAE;aAC/B,CAAA;QACH,CAAC;QAGD,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;QACpC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACrD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY,UAAU,EAAE;aAChC,CAAA;QACH,CAAC;QAGD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK;SACN,CAAC,CAAA;QAGF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;QAG3B,MAAM,OAAO,CAAC,WAAW,CAAC;YACxB,SAAS;YACT,SAAS;YACT,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,YAAgC,EAAE,EAAE;gBAC7D,OAAO,CAAC,GAAG,CAAC,SAAS,YAAY,CAAC,OAAO,GAAG,CAAC,CAAA;YAC/C,CAAC,CAAC,CAAC,CAAC,SAAS;SACf,CAAC,CAAA;QAGF,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACrB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM;SAChB,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3E,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC7B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,SAAS,YAAY,EAAE;SAC/B,CAAA;IACH,CAAC;AACH,CAAC;AAQD,eAAe,WAAW,CAAA"}

package/dist/functions/tencent-cloud/getSecret.d.ts

@@ -1,6 +1,4 @@
-export interface Secret {
-    secretId: string;
-    secretKey: string;
-}
-export type SecretType = 'personal' | 'individual' | 'enterprise';
-export declare function getSecret(type: SecretType): Secret;
+import type { TencentCloudSecret } from '../../../references/tencent-cloud.d';
+import type { SecretType } from '../../../types/tencent-cloud.d';
+export declare function getSecret(type: SecretType): TencentCloudSecret;
+export default getSecret;

package/dist/functions/tencent-cloud/getSecret.js

@@ -15,4 +15,5 @@ const secretMap = {
 export function getSecret(type) {
     return secretMap[type];
 }
+export default getSecret;
 //# sourceMappingURL=getSecret.js.map

package/dist/functions/tencent-cloud/getSecret.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSecret.js","sourceRoot":"","sources":["../../../src/functions/tencent-cloud/getSecret.ts"],"names":[],"mappings":"AAUA,MAAM,SAAS,GAA+B;IAC5C,QAAQ,EAAE;QAER,QAAQ,EAAE,sCAAsC;QAChD,SAAS,EAAE,kCAAkC;KAC9C;IACD,UAAU,EAAE;QAEV,QAAQ,EAAE,sCAAsC;QAChD,SAAS,EAAE,kCAAkC;KAC9C;IACD,UAAU,EAAE;QAEV,QAAQ,EAAE,sCAAsC;QAChD,SAAS,EAAE,kCAAkC;KAC9C;CACF,CAAA;AAiBD,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC"}
+{"version":3,"file":"getSecret.js","sourceRoot":"","sources":["../../../src/functions/tencent-cloud/getSecret.ts"],"names":[],"mappings":"AAIA,MAAM,SAAS,GAA2C;IACxD,QAAQ,EAAE;QAER,QAAQ,EAAE,sCAAsC;QAChD,SAAS,EAAE,kCAAkC;KAC9C;IACD,UAAU,EAAE;QAEV,QAAQ,EAAE,sCAAsC;QAChD,SAAS,EAAE,kCAAkC;KAC9C;IACD,UAAU,EAAE;QAEV,QAAQ,EAAE,sCAAsC;QAChD,SAAS,EAAE,kCAAkC;KAC9C;CACF,CAAA;AAoCD,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAKD,eAAe,SAAS,CAAA"}

package/dist/functions/version/incrementVersion.d.ts

@@ -0,0 +1,3 @@
+import type { VersionType } from '../../../types/semver.d';
+export declare function incrementVersion(currentVersion: string, type: VersionType, prerelease?: string): string;
+export declare function suggestVersionType(changes: string[]): VersionType;

package/dist/functions/version/incrementVersion.js

@@ -0,0 +1,57 @@
+import { parseVersion, stringifyVersion } from './parseVersion';
+export function incrementVersion(currentVersion, type, prerelease) {
+    const version = parseVersion(currentVersion);
+    switch (type) {
+        case 'major':
+            return stringifyVersion({
+                major: version.major + 1,
+                minor: 0,
+                patch: 0
+            });
+        case 'minor':
+            return stringifyVersion({
+                major: version.major,
+                minor: version.minor + 1,
+                patch: 0
+            });
+        case 'patch':
+            return stringifyVersion({
+                major: version.major,
+                minor: version.minor,
+                patch: version.patch + 1
+            });
+        case 'prerelease':
+            if (!prerelease) {
+                throw new Error('预发布版本需要指定 prerelease 标识符');
+            }
+            if (version.prerelease) {
+                const match = version.prerelease.match(/^(.+?)\.(\d+)$/);
+                if (match && match[1] === prerelease) {
+                    const prereleaseNumber = parseInt(match[2], 10) + 1;
+                    return stringifyVersion({
+                        ...version,
+                        prerelease: `${prerelease}.${prereleaseNumber}`
+                    });
+                }
+            }
+            return stringifyVersion({
+                major: version.major,
+                minor: version.minor,
+                patch: version.patch + 1,
+                prerelease: `${prerelease}.0`
+            });
+        default:
+            throw new Error(`不支持的版本类型: ${type}`);
+    }
+}
+export function suggestVersionType(changes) {
+    const changeText = changes.join(' ').toLowerCase();
+    if (changeText.includes('breaking') || changeText.includes('major')) {
+        return 'major';
+    }
+    if (changeText.includes('feat') || changeText.includes('feature') || changeText.includes('add')) {
+        return 'minor';
+    }
+    return 'patch';
+}
+//# sourceMappingURL=incrementVersion.js.map

package/dist/functions/version/incrementVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incrementVersion.js","sourceRoot":"","sources":["../../../src/functions/version/incrementVersion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAU/D,MAAM,UAAU,gBAAgB,CAC9B,cAAsB,EACtB,IAAiB,EACjB,UAAmB;IAEnB,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;IAE5C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC;gBACxB,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;aACT,CAAC,CAAA;QAEJ,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC;gBACxB,KAAK,EAAE,CAAC;aACT,CAAC,CAAA;QAEJ,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC;aACzB,CAAC,CAAA;QAEJ,KAAK,YAAY;YACf,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;YAC7C,CAAC;YAGD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;gBACxD,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;oBACrC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;oBACnD,OAAO,gBAAgB,CAAC;wBACtB,GAAG,OAAO;wBACV,UAAU,EAAE,GAAG,UAAU,IAAI,gBAAgB,EAAE;qBAChD,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;YAGD,OAAO,gBAAgB,CAAC;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC;gBACxB,UAAU,EAAE,GAAG,UAAU,IAAI;aAC9B,CAAC,CAAA;QAEJ;YACE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAA;IACxC,CAAC;AACH,CAAC;AAQD,MAAM,UAAU,kBAAkB,CAAC,OAAiB;IAClD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;IAGlD,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpE,OAAO,OAAO,CAAA;IAChB,CAAC;IAGD,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChG,OAAO,OAAO,CAAA;IAChB,CAAC;IAGD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/functions/version/parseVersion.d.ts

@@ -0,0 +1,4 @@
+import type { Version } from '../../../types/semver.d';
+export declare function parseVersion(version: string): Version;
+export declare function stringifyVersion(version: Version): string;
+export declare function compareVersions(a: Version, b: Version): number;

package/dist/functions/version/parseVersion.js

@@ -0,0 +1,35 @@
+export function parseVersion(version) {
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/);
+    if (!match) {
+        throw new Error(`无效的版本号格式: ${version}`);
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3], 10),
+        prerelease: match[4]
+    };
+}
+export function stringifyVersion(version) {
+    const base = `${version.major}.${version.minor}.${version.patch}`;
+    return version.prerelease ? `${base}-${version.prerelease}` : base;
+}
+export function compareVersions(a, b) {
+    if (a.major !== b.major) {
+        return a.major > b.major ? 1 : -1;
+    }
+    if (a.minor !== b.minor) {
+        return a.minor > b.minor ? 1 : -1;
+    }
+    if (a.patch !== b.patch) {
+        return a.patch > b.patch ? 1 : -1;
+    }
+    if (a.prerelease && !b.prerelease)
+        return -1;
+    if (!a.prerelease && b.prerelease)
+        return 1;
+    if (!a.prerelease && !b.prerelease)
+        return 0;
+    return a.prerelease > b.prerelease ? 1 : (a.prerelease < b.prerelease ? -1 : 0);
+}
+//# sourceMappingURL=parseVersion.js.map

package/dist/functions/version/parseVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseVersion.js","sourceRoot":"","sources":["../../../src/functions/version/parseVersion.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAE9D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,EAAE,CAAC,CAAA;IACzC,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;KACrB,CAAA;AACH,CAAC;AAQD,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAA;IACjE,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACpE,CAAC;AASD,MAAM,UAAU,eAAe,CAAC,CAAU,EAAE,CAAU;IAEpD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnC,CAAC;IAGD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnC,CAAC;IAGD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnC,CAAC;IAGD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC,CAAA;IAC5C,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU;QAAE,OAAO,CAAC,CAAA;IAC3C,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,UAAU;QAAE,OAAO,CAAC,CAAA;IAG5C,OAAO,CAAC,CAAC,UAAW,GAAG,CAAC,CAAC,UAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAW,GAAG,CAAC,CAAC,UAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACrF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.14.0",
+  "version": "1.16.1",
   "files": [
     "references",
     "dist",
@@ -20,11 +20,15 @@
     "publish:patch": "npx tsx scripts/publish.ts patch",
     "publish:minor": "npx tsx scripts/publish.ts minor",
     "publish:major": "npx tsx scripts/publish.ts major",
-    "publish:prerelease": "npx tsx scripts/publish.ts prerelease"
+    "publish:prerelease": "npx tsx scripts/publish.ts prerelease",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   },
   "devDependencies": {
     "tsx": "^4.20.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "vitepress": "^1.6.4"
   },
   "exports": {
     "./constants/colorPatterns": "./dist/constants/colorPatterns.js",
@@ -47,6 +51,7 @@
     "./functions/dom/getElementRect": "./dist/functions/dom/getElementRect.js",
     "./functions/dom/getRelativePosition": "./dist/functions/dom/getRelativePosition.js",
     "./functions/dom/getViewportRect": "./dist/functions/dom/getViewportRect.js",
+    "./functions/image/compressToTargetSize": "./dist/functions/image/compressToTargetSize.js",
     "./functions/image/generateMacIcons": "./dist/functions/image/generateMacIcons.js",
     "./functions/image/generateMacTrayIcon": "./dist/functions/image/generateMacTrayIcon.js",
     "./functions/image/generatePaddedImage": "./dist/functions/image/generatePaddedImage.js",
@@ -66,6 +71,7 @@
     "./functions/string/similarity": "./dist/functions/string/similarity.js",
     "./functions/string/template": "./dist/functions/string/template.js",
     "./functions/string/wordCount": "./dist/functions/string/wordCount.js",
+    "./functions/tencent-cloud/deploy.tcb": "./dist/functions/tencent-cloud/deploy.tcb.js",
     "./functions/tencent-cloud/getSecret": "./dist/functions/tencent-cloud/getSecret.js",
     "./functions/uniapp/app-plus/buildAndroidApp": "./dist/functions/uniapp/app-plus/buildAndroidApp.js",
     "./functions/uniapp/build": "./dist/functions/uniapp/build.js",
@@ -91,6 +97,8 @@
     "./functions/utils/until": "./dist/functions/utils/until.js",
     "./functions/utils/validate": "./dist/functions/utils/validate.js",
     "./functions/utils/walk": "./dist/functions/utils/walk.js",
+    "./functions/version/incrementVersion": "./dist/functions/version/incrementVersion.js",
+    "./functions/version/parseVersion": "./dist/functions/version/parseVersion.js",
     "./functions/vue/dynamicMount": "./dist/functions/vue/dynamicMount.js",
     "./functions/vue/extractColorsFromVueFile": "./dist/functions/vue/extractColorsFromVueFile.js",
     "./functions/vue/extractColorsFromVueSection": "./dist/functions/vue/extractColorsFromVueSection.js",
@@ -116,8 +124,10 @@
     "./types/design-system": "./types/design-system.d.ts",
     "./types/geometry": "./types/geometry.d.ts",
     "./types/platform": "./types/platform.d.ts",
+    "./types/semver": "./types/semver.d.ts",
     "./types/software": "./types/software.d.ts",
     "./types/storage": "./types/storage.d.ts",
+    "./types/tencent-cloud": "./types/tencent-cloud.d.ts",
     "./types/uniapp-android-build": "./types/uniapp-android-build.d.ts",
     "./types/vue": "./types/vue.d.ts",
     "./types/worker": "./types/worker.d.ts"

package/references/browser.d.ts

@@ -4,13 +4,25 @@ import type { AbortController, Response, FetchFunction } from './fetch.d'
 import type { URLSearchParams } from './url.d'
 import type { Storage } from './storage.d'
 import type { WorkerConstructor } from './worker.d'
-import type { Document, HTMLElement, Element } from './dom.d'
+import type { Document, HTMLElement, Element, HTMLImageElement } from './dom.d'
 import type { IDBFactory } from './indexeddb.d'
 import type { Blob, BlobPart, BlobPropertyBag, MediaSource, ReadableStream } from './blob.d'
 import type { TextDecoderConstructor, TextEncoderConstructor } from './encoding.d'
 import type { Location } from './location.d'
 import type { ArrayBufferConstructor, Uint8ArrayConstructor, DataViewConstructor } from './arraybuffer.d'
 
+// File 接口定义
+export interface FilePropertyBag extends BlobPropertyBag {
+  lastModified?: number
+}
+
+export interface File extends Blob {
+  readonly name: string
+  readonly size: number
+  readonly type: string
+  readonly lastModified: number
+}
+
 
 
 // 浏览器Window对象 - 包含所有浏览器API
@@ -58,6 +70,16 @@ export interface Window {
     new (blobParts?: BlobPart[], options?: BlobPropertyBag): Blob
   }
   
+  // File API
+  File: {
+    new (fileBits: BlobPart[], fileName: string, options?: FilePropertyBag): File
+  }
+  
+  // Image API
+  Image: {
+    new (width?: number, height?: number): HTMLImageElement
+  }
+  
   // ArrayBuffer API
   ArrayBuffer: ArrayBufferConstructor
   Uint8Array: Uint8ArrayConstructor

package/references/dom.d.ts

@@ -18,7 +18,27 @@ export interface HTMLElement extends Element {
   }
 }
 
+export interface HTMLImageElement extends HTMLElement {
+  src: string
+  naturalWidth: number
+  naturalHeight: number
+  onload: (() => void) | null
+  onerror: (() => void) | null
+}
+
+export interface CanvasRenderingContext2D {
+  drawImage(image: HTMLImageElement, dx: number, dy: number, dWidth: number, dHeight: number): void
+}
+
+export interface HTMLCanvasElement extends HTMLElement {
+  width: number
+  height: number
+  getContext(contextId: '2d'): CanvasRenderingContext2D | null
+  toBlob(callback: (blob: Blob | null) => void, type?: string, quality?: number): void
+}
+
 export interface Document {
+  createElement(tagName: 'canvas'): HTMLCanvasElement
   createElement(tagName: string): HTMLElement
   documentElement: {
     clientWidth: number

package/references/tencent-cloud.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 腾讯云相关类型定义
+ * 
+ * @description
+ * 定义腾讯云服务相关的接口和类型，用于依赖注入
+ * 确保函数的环境无关性
+ * 
+ * @since 1.0.0
+ * @author Assistant
+ */
+
+import type { Console } from './console.d'
+import type { FileSystem, Path, Process } from './node.d'
+
+// 腾讯云密钥接口
+export interface TencentCloudSecret {
+  secretId: string
+  secretKey: string
+}
+
+// 腾讯云配置接口
+export interface TencentCloudConfig {
+  secretId: string
+  secretKey: string
+  envId: string
+}
+
+// 上传进度数据
+export interface UploadProgressData {
+  percent: number
+  loaded: number
+  total: number
+}
+
+// 上传文件选项
+export interface UploadFilesOptions {
+  localPath: string
+  cloudPath: string
+  onProgress?: (progressData: UploadProgressData) => void
+}
+
+// 静态网站托管服务接口
+export interface HostingService {
+  uploadFiles(options: UploadFilesOptions): Promise<void>
+}
+
+// CloudBase 应用接口
+export interface CloudBaseApp {
+  hosting: HostingService
+}
+
+// CloudBase 管理器接口
+export interface CloudBaseManager {
+  init(config: TencentCloudConfig): CloudBaseApp
+}
+
+// 腾讯云系统依赖接口
+export interface TencentCloudSystemDependencies {
+  cloudBase: CloudBaseManager
+  path: Path
+  fs: FileSystem
+  process: Process
+  console: Console
+  getSecret: (type: string) => TencentCloudSecret
+}

package/types/semver.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Semantic Versioning (SemVer) 类型定义
+ * 遵循 https://semver.org/ 规范
+ */
+
+/**
+ * 版本递增类型
+ */
+export type VersionType = 'major' | 'minor' | 'patch' | 'prerelease'
+
+/**
+ * 语义化版本对象
+ */
+export interface Version {
+  /** 主版本号 - 不兼容的 API 修改 */
+  major: number
+  /** 次版本号 - 向下兼容的功能性新增 */
+  minor: number
+  /** 修订号 - 向下兼容的问题修正 */
+  patch: number
+  /** 预发布版本标识符 */
+  prerelease?: string
+}
+
+/**
+ * 版本比较结果
+ */
+export type VersionComparison = -1 | 0 | 1
+
+/**
+ * 版本范围操作符
+ */
+export type VersionRangeOperator = 
+  | '^'  // 兼容版本（不改变主版本号）
+  | '~'  // 近似版本（不改变主次版本号）
+  | '>=' // 大于等于
+  | '>'  // 大于
+  | '<=' // 小于等于
+  | '<'  // 小于
+  | '='  // 等于
+
+/**
+ * 版本范围
+ */
+export interface VersionRange {
+  operator: VersionRangeOperator
+  version: string
+}
+
+/**
+ * 版本解析选项
+ */
+export interface VersionParseOptions {
+  /** 是否允许前缀 'v' */
+  allowPrefix?: boolean
+  /** 是否严格模式（严格遵循 SemVer 规范） */
+  strict?: boolean
+}
+
+/**
+ * 版本递增选项
+ */
+export interface VersionIncrementOptions {
+  /** 预发布标识符（如 'alpha', 'beta', 'rc'） */
+  prerelease?: string
+  /** 预发布版本号 */
+  prereleaseNumber?: number
+}

package/types/tencent-cloud.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 腾讯云相关应用层类型定义
+ * 
+ * @description
+ * 定义腾讯云部署功能使用的接口和类型
+ * 不包含环境相关的类型，环境相关类型请从 references/tencent-cloud.d 导入
+ * 
+ * @since 1.0.0
+ * @author Assistant
+ */
+
+import type {
+  TencentCloudSystemDependencies,
+  TencentCloudSecret
+} from '../references/tencent-cloud.d'
+
+// 密钥类型
+export type SecretType = 'personal' | 'individual' | 'enterprise'
+
+// 部署配置选项
+export interface DeployOptions {
+  /** 本地文件路径 */
+  localPath: string
+  /** 云端路径 */
+  cloudPath?: string
+  /** 环境ID */
+  envId: string
+  /** 密钥类型 */
+  secretType: SecretType
+  /** 是否显示进度 */
+  showProgress?: boolean
+}
+
+// 部署结果
+export interface DeployResult {
+  success: boolean
+  message?: string
+  error?: string
+}
+
+// 部署函数依赖接口
+export interface DeployDependencies extends TencentCloudSystemDependencies {
+  // 可以扩展特定于部署功能的依赖
+}