@cloudcome/utils-browser 1.2.16 → 1.2.18

package/dist/cache.mjs

@@ -1,87 +1,96 @@
 import { AbstractCache } from "@cloudcome/utils-core/cache";
-class StorageCache extends AbstractCache {
-  /**
-   * 创建一个新的 StorageCache 实例
-   * @param storage - 使用的存储实现（localStorage 或 sessionStorage）
-   * @param namespace - 可选，用于为缓存键添加前缀的命名空间
-   */
-  constructor(storage, namespace = "") {
-    super();
-    this.storage = storage;
-    this.namespace = namespace;
-  }
-  /**
-   * 通过ID获取缓存数据
-   * @param id - 要获取的缓存键
-   * @returns 如果找到且未过期则返回缓存数据，否则返回null
-   */
-  get(id) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      const cachedString = storage.getItem(fullId);
-      if (!cachedString) return null;
-      const cached = JSON.parse(cachedString);
-      if (cached.createdAt + cached.maxAge < Date.now()) {
-        this.del(id);
-        return null;
-      }
-      return cached;
-    } catch (e) {
-      return null;
-    }
-  }
-  /**
-   * 将数据存储到缓存中
-   * @param id - 存储数据使用的缓存键
-   * @param data - 要缓存的数据
-   * @param options - 可选的缓存配置
-   * @returns 成功返回true，存储失败返回false
-   */
-  set(id, data, options) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      storage.setItem(
-        fullId,
-        JSON.stringify({
-          id,
-          data,
-          createdAt: Date.now(),
-          maxAge: options?.maxAge || 0
-        })
-      );
-    } catch (cause) {
-    }
-  }
-  /**
-   * 通过ID删除缓存数据
-   * @param id - 要删除的缓存键
-   */
-  del(id) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      storage.removeItem(fullId);
-    } catch (cause) {
-    }
-  }
-  clear() {
-    try {
-      this.storage.clear();
-    } catch (err) {
-    }
-  }
-}
+//#region src/cache.ts
+/**
+* 使用浏览器存储（localStorage 或 sessionStorage）实现的缓存类
+* @template T - 缓存数据的类型
+*/
+var StorageCache = class extends AbstractCache {
+	/**
+	* 创建一个新的 StorageCache 实例
+	* @param storage - 使用的存储实现（localStorage 或 sessionStorage）
+	* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+	*/
+	constructor(storage, namespace = "") {
+		super();
+		this.storage = storage;
+		this.namespace = namespace;
+	}
+	/**
+	* 通过ID获取缓存数据
+	* @param id - 要获取的缓存键
+	* @returns 如果找到且未过期则返回缓存数据，否则返回null
+	*/
+	get(id) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			const cachedString = storage.getItem(fullId);
+			if (!cachedString) return null;
+			const cached = JSON.parse(cachedString);
+			if (cached.createdAt + cached.maxAge < Date.now()) {
+				this.del(id);
+				return null;
+			}
+			return cached;
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* 将数据存储到缓存中
+	* @param id - 存储数据使用的缓存键
+	* @param data - 要缓存的数据
+	* @param options - 可选的缓存配置
+	* @returns 成功返回true，存储失败返回false
+	*/
+	set(id, data, options) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			storage.setItem(fullId, JSON.stringify({
+				id,
+				data,
+				createdAt: Date.now(),
+				maxAge: options?.maxAge || 0
+			}));
+		} catch {}
+	}
+	/**
+	* 通过ID删除缓存数据
+	* @param id - 要删除的缓存键
+	*/
+	del(id) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			storage.removeItem(fullId);
+		} catch {}
+	}
+	clear() {
+		try {
+			this.storage.clear();
+		} catch {}
+	}
+};
+/**
+* 创建一个使用 localStorage 的缓存实例
+* @template T - 缓存数据的类型
+* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+* @returns 使用 localStorage 的新 StorageCache 实例
+*/
 function createLocalCache(namespace) {
-  return new StorageCache(localStorage, namespace);
+	return new StorageCache(localStorage, namespace);
 }
+/**
+* 创建一个使用 sessionStorage 的缓存实例
+* @template T - 缓存数据的类型
+* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+* @returns 使用 sessionStorage 的新 StorageCache 实例
+*/
 function createSessionCache(namespace) {
-  return new StorageCache(sessionStorage, namespace);
+	return new StorageCache(sessionStorage, namespace);
 }
-export {
-  StorageCache,
-  createLocalCache,
-  createSessionCache
-};
-//# sourceMappingURL=cache.mjs.map
+//#endregion
+export { StorageCache, createLocalCache, createSessionCache };
+
+//# sourceMappingURL=cache.mjs.map

package/dist/cache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cache.mjs","sources":["../src/cache.ts"],"sourcesContent":["import { AbstractCache, type CacheOptions, type Cached } from '@cloudcome/utils-core/cache';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\n\n/**\n * 使用浏览器存储（localStorage 或 sessionStorage）实现的缓存类\n * @template T - 缓存数据的类型\n */\nexport class StorageCache<T> extends AbstractCache<T> {\n  /**\n   * 创建一个新的 StorageCache 实例\n   * @param storage - 使用的存储实现（localStorage 或 sessionStorage）\n   * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n   */\n  constructor(\n    readonly storage: Storage,\n    readonly namespace = '',\n  ) {\n    super();\n  }\n\n  /**\n   * 通过ID获取缓存数据\n   * @param id - 要获取的缓存键\n   * @returns 如果找到且未过期则返回缓存数据，否则返回null\n   */\n  get(id: string): Cached<T> | null {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      const cachedString = storage.getItem(fullId);\n      if (!cachedString) return null;\n\n      const cached = JSON.parse(cachedString);\n\n      if (cached.createdAt + cached.maxAge < Date.now()) {\n        this.del(id);\n        return null;\n      }\n\n      return cached;\n    } catch (e) {\n      return null;\n    }\n  }\n\n  /**\n   * 将数据存储到缓存中\n   * @param id - 存储数据使用的缓存键\n   * @param data - 要缓存的数据\n   * @param options - 可选的缓存配置\n   * @returns 成功返回true，存储失败返回false\n   */\n  set(id: string, data: T, options?: CacheOptions) {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      storage.setItem(\n        fullId,\n        JSON.stringify({\n          id,\n          data,\n          createdAt: Date.now(),\n          maxAge: options?.maxAge || 0,\n        }),\n      );\n    } catch (cause) {\n      //\n    }\n  }\n\n  /**\n   * 通过ID删除缓存数据\n   * @param id - 要删除的缓存键\n   */\n  del(id: string) {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      storage.removeItem(fullId);\n    } catch (cause) {\n      //\n    }\n  }\n\n  clear() {\n    try {\n      this.storage.clear();\n    } catch (err) {\n      //\n    }\n  }\n}\n\n/**\n * 创建一个使用 localStorage 的缓存实例\n * @template T - 缓存数据的类型\n * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n * @returns 使用 localStorage 的新 StorageCache 实例\n */\nexport function createLocalCache<T>(namespace?: string): AbstractCache<T> {\n  return new StorageCache<T>(localStorage, namespace);\n}\n\n/**\n * 创建一个使用 sessionStorage 的缓存实例\n * @template T - 缓存数据的类型\n * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n * @returns 使用 sessionStorage 的新 StorageCache 实例\n */\nexport function createSessionCache<T>(namespace?: string): AbstractCache<T> {\n  return new StorageCache<T>(sessionStorage, namespace);\n}\n"],"names":[],"mappings":";AAOO,MAAM,qBAAwB,cAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpD,YACW,SACA,YAAY,IACrB;AACM,UAAA;AAHG,SAAA,UAAA;AACA,SAAA,YAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUX,IAAI,IAA8B;AAC1B,UAAA,EAAE,SAAS,UAAA,IAAc;AAC/B,UAAM,SAAS,YAAY,GAAG,SAAS,IAAI,EAAE,KAAK;AAE9C,QAAA;AACI,YAAA,eAAe,QAAQ,QAAQ,MAAM;AACvC,UAAA,CAAC,aAAqB,QAAA;AAEpB,YAAA,SAAS,KAAK,MAAM,YAAY;AAEtC,UAAI,OAAO,YAAY,OAAO,SAAS,KAAK,OAAO;AACjD,aAAK,IAAI,EAAE;AACJ,eAAA;AAAA,MAAA;AAGF,aAAA;AAAA,aACA,GAAG;AACH,aAAA;AAAA,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUF,IAAI,IAAY,MAAS,SAAwB;AACzC,UAAA,EAAE,SAAS,UAAA,IAAc;AAC/B,UAAM,SAAS,YAAY,GAAG,SAAS,IAAI,EAAE,KAAK;AAE9C,QAAA;AACM,cAAA;AAAA,QACN;AAAA,QACA,KAAK,UAAU;AAAA,UACb;AAAA,UACA;AAAA,UACA,WAAW,KAAK,IAAI;AAAA,UACpB,QAAQ,SAAS,UAAU;AAAA,QAC5B,CAAA;AAAA,MACH;AAAA,aACO,OAAO;AAAA,IAAA;AAAA,EAEhB;AAAA;AAAA;AAAA;AAAA;AAAA,EAOF,IAAI,IAAY;AACR,UAAA,EAAE,SAAS,UAAA,IAAc;AAC/B,UAAM,SAAS,YAAY,GAAG,SAAS,IAAI,EAAE,KAAK;AAE9C,QAAA;AACF,cAAQ,WAAW,MAAM;AAAA,aAClB,OAAO;AAAA,IAAA;AAAA,EAEhB;AAAA,EAGF,QAAQ;AACF,QAAA;AACF,WAAK,QAAQ,MAAM;AAAA,aACZ,KAAK;AAAA,IAAA;AAAA,EAEd;AAEJ;AAQO,SAAS,iBAAoB,WAAsC;AACjE,SAAA,IAAI,aAAgB,cAAc,SAAS;AACpD;AAQO,SAAS,mBAAsB,WAAsC;AACnE,SAAA,IAAI,aAAgB,gBAAgB,SAAS;AACtD;"}
+{"version":3,"file":"cache.mjs","names":[],"sources":["../src/cache.ts"],"sourcesContent":["import { AbstractCache, type Cached, type CacheOptions } from '@cloudcome/utils-core/cache';\n\n/**\n * 使用浏览器存储（localStorage 或 sessionStorage）实现的缓存类\n * @template T - 缓存数据的类型\n */\nexport class StorageCache<T> extends AbstractCache<T> {\n  /**\n   * 创建一个新的 StorageCache 实例\n   * @param storage - 使用的存储实现（localStorage 或 sessionStorage）\n   * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n   */\n  constructor(\n    readonly storage: Storage,\n    readonly namespace = '',\n  ) {\n    super();\n  }\n\n  /**\n   * 通过ID获取缓存数据\n   * @param id - 要获取的缓存键\n   * @returns 如果找到且未过期则返回缓存数据，否则返回null\n   */\n  get(id: string): Cached<T> | null {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      const cachedString = storage.getItem(fullId);\n      if (!cachedString) return null;\n\n      const cached = JSON.parse(cachedString);\n\n      if (cached.createdAt + cached.maxAge < Date.now()) {\n        this.del(id);\n        return null;\n      }\n\n      return cached;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * 将数据存储到缓存中\n   * @param id - 存储数据使用的缓存键\n   * @param data - 要缓存的数据\n   * @param options - 可选的缓存配置\n   * @returns 成功返回true，存储失败返回false\n   */\n  set(id: string, data: T, options?: CacheOptions) {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      storage.setItem(\n        fullId,\n        JSON.stringify({\n          id,\n          data,\n          createdAt: Date.now(),\n          maxAge: options?.maxAge || 0,\n        }),\n      );\n    } catch {\n      //\n    }\n  }\n\n  /**\n   * 通过ID删除缓存数据\n   * @param id - 要删除的缓存键\n   */\n  del(id: string) {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      storage.removeItem(fullId);\n    } catch {\n      //\n    }\n  }\n\n  clear() {\n    try {\n      this.storage.clear();\n    } catch {\n      //\n    }\n  }\n}\n\n/**\n * 创建一个使用 localStorage 的缓存实例\n * @template T - 缓存数据的类型\n * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n * @returns 使用 localStorage 的新 StorageCache 实例\n */\nexport function createLocalCache<T>(namespace?: string): AbstractCache<T> {\n  return new StorageCache<T>(localStorage, namespace);\n}\n\n/**\n * 创建一个使用 sessionStorage 的缓存实例\n * @template T - 缓存数据的类型\n * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n * @returns 使用 sessionStorage 的新 StorageCache 实例\n */\nexport function createSessionCache<T>(namespace?: string): AbstractCache<T> {\n  return new StorageCache<T>(sessionStorage, namespace);\n}\n"],"mappings":";;;;;;AAMA,IAAa,eAAb,cAAqC,cAAiB;;;;;;CAMpD,YACE,SACA,YAAqB,IACrB;EACA,OAAO;EAHE,KAAA,UAAA;EACA,KAAA,YAAA;;;;;;;CAUX,IAAI,IAA8B;EAChC,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,MAAM,eAAe,QAAQ,QAAQ,OAAO;GAC5C,IAAI,CAAC,cAAc,OAAO;GAE1B,MAAM,SAAS,KAAK,MAAM,aAAa;GAEvC,IAAI,OAAO,YAAY,OAAO,SAAS,KAAK,KAAK,EAAE;IACjD,KAAK,IAAI,GAAG;IACZ,OAAO;;GAGT,OAAO;UACD;GACN,OAAO;;;;;;;;;;CAWX,IAAI,IAAY,MAAS,SAAwB;EAC/C,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,QAAQ,QACN,QACA,KAAK,UAAU;IACb;IACA;IACA,WAAW,KAAK,KAAK;IACrB,QAAQ,SAAS,UAAU;IAC5B,CAAC,CACH;UACK;;;;;;CASV,IAAI,IAAY;EACd,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,QAAQ,WAAW,OAAO;UACpB;;CAKV,QAAQ;EACN,IAAI;GACF,KAAK,QAAQ,OAAO;UACd;;;;;;;;;AAYZ,SAAgB,iBAAoB,WAAsC;CACxE,OAAO,IAAI,aAAgB,cAAc,UAAU;;;;;;;;AASrD,SAAgB,mBAAsB,WAAsC;CAC1E,OAAO,IAAI,aAAgB,gBAAgB,UAAU"}

package/dist/canvas.cjs

@@ -1,58 +1,74 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const object = require("@cloudcome/utils-core/object");
-const image = require("./image.cjs");
+const require_image = require("./image.cjs");
+let _cloudcome_utils_core_object = require("@cloudcome/utils-core/object");
+//#region src/canvas.ts
+/**
+* 将 Canvas 转换为 Base64 编码的字符串
+* @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素
+* @param {string} [type] - 图片格式，默认为 'image/png'
+* @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'
+* @returns {string} Base64 编码的图片数据
+* @example
+* const base64 = canvasToBase64(canvas, 'image/jpeg', 0.8);
+*/
 function canvasToBase64(canvas, type, quality) {
-  return canvas.toDataURL(type, quality);
+	return canvas.toDataURL(type, quality);
 }
+/**
+* 将 Canvas 转换为 Blob 对象
+* @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素
+* @param {string} [type] - 图片格式，默认为 'image/png'
+* @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'
+* @returns {Promise<Blob>} 返回一个包含 Blob 对象的 Promise
+* @example
+* const blob = await canvasToBlob(canvas, 'image/jpeg', 0.8);
+*/
 async function canvasToBlob(canvas, type, quality) {
-  return new Promise((resolve, reject) => {
-    canvas.toBlob(
-      (blob) => {
-        if (blob) {
-          resolve(blob);
-        } else {
-          reject(new Error("canvas 导出二进制对象失败"));
-        }
-      },
-      type,
-      quality
-    );
-  });
+	return new Promise((resolve, reject) => {
+		canvas.toBlob((blob) => {
+			if (blob) resolve(blob);
+			else reject(/* @__PURE__ */ new Error("canvas 导出二进制对象失败"));
+		}, type, quality);
+	});
 }
+/**
+* 在 Canvas 上绘制图片
+* @param {HTMLCanvasElement} canvas - 目标 Canvas 元素
+* @param {string} url - 图片的 URL
+* @param {CanvasDrawImageOptions} [options] - 绘制图片的配置选项
+* @returns {Promise<void>} 返回一个 Promise，表示绘制完成
+* @example
+* await canvasDrawImage(canvas, 'https://example.com/image.png', {
+*   srcLeft: 10,
+*   srcTop: 10,
+*   srcWidth: 100,
+*   srcHeight: 100,
+*   destLeft: 0,
+*   destTop: 0,
+*   destWidth: 200,
+*   destHeight: 200
+* });
+*/
 async function canvasDrawImage(canvas, url, options) {
-  const ctx = canvas.getContext("2d");
-  if (!ctx) throw new Error("canvas context is null");
-  const img = await image.imageLoad(url);
-  const defaults = {
-    srcLeft: 0,
-    srcTop: 0,
-    srcWidth: img.width,
-    srcHeight: img.height,
-    destLeft: 0,
-    destTop: 0,
-    destWidth: canvas.width,
-    destHeight: canvas.height
-  };
-  const { srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight } = object.objectDefaults(
-    options || {},
-    defaults
-  );
-  ctx.drawImage(
-    img,
-    // source
-    srcLeft,
-    srcTop,
-    srcWidth,
-    srcHeight,
-    // dest
-    destLeft,
-    destTop,
-    destWidth,
-    destHeight
-  );
+	const ctx = canvas.getContext("2d");
+	if (!ctx) throw new Error("canvas context is null");
+	const img = await require_image.imageLoad(url);
+	const defaults = {
+		srcLeft: 0,
+		srcTop: 0,
+		srcWidth: img.width,
+		srcHeight: img.height,
+		destLeft: 0,
+		destTop: 0,
+		destWidth: canvas.width,
+		destHeight: canvas.height
+	};
+	const { srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight } = (0, _cloudcome_utils_core_object.objectDefaults)(options || {}, defaults);
+	ctx.drawImage(img, srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight);
 }
+//#endregion
 exports.canvasDrawImage = canvasDrawImage;
 exports.canvasToBase64 = canvasToBase64;
 exports.canvasToBlob = canvasToBlob;
-//# sourceMappingURL=canvas.cjs.map
+
+//# sourceMappingURL=canvas.cjs.map

package/dist/canvas.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.cjs","sources":["../src/canvas.ts"],"sourcesContent":["import { objectDefaults } from '@cloudcome/utils-core/object';\nimport { imageLoad } from './image';\n\n/**\n * 将 Canvas 转换为 Base64 编码的字符串\n * @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素\n * @param {string} [type] - 图片格式，默认为 'image/png'\n * @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'\n * @returns {string} Base64 编码的图片数据\n * @example\n * const base64 = canvasToBase64(canvas, 'image/jpeg', 0.8);\n */\nexport function canvasToBase64(canvas: HTMLCanvasElement, type?: string, quality?: number) {\n  return canvas.toDataURL(type, quality);\n}\n\n/**\n * 将 Canvas 转换为 Blob 对象\n * @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素\n * @param {string} [type] - 图片格式，默认为 'image/png'\n * @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'\n * @returns {Promise<Blob>} 返回一个包含 Blob 对象的 Promise\n * @example\n * const blob = await canvasToBlob(canvas, 'image/jpeg', 0.8);\n */\nexport async function canvasToBlob(canvas: HTMLCanvasElement, type?: string, quality?: number) {\n  return new Promise<Blob>((resolve, reject) => {\n    canvas.toBlob(\n      (blob) => {\n        if (blob) {\n          resolve(blob);\n        } else {\n          reject(new Error('canvas 导出二进制对象失败'));\n        }\n      },\n      type,\n      quality,\n    );\n  });\n}\n\n/**\n * Canvas 绘制图片的配置选项\n */\nexport type CanvasDrawImageOptions = {\n  /**\n   * 源图片的左上角 x 坐标\n   * @type {number}\n   * @default 0\n   */\n  srcLeft?: number;\n  /**\n   * 源图片的左上角 y 坐标\n   * @type {number}\n   * @default 0\n   */\n  srcTop?: number;\n  /**\n   * 源图片的宽度\n   * @type {number}\n   * @default 图片的原始宽度\n   */\n  srcWidth?: number;\n  /**\n   * 源图片的高度\n   * @type {number}\n   * @default 图片的原始高度\n   */\n  srcHeight?: number;\n\n  /**\n   * 目标 Canvas 的左上角 x 坐标\n   * @type {number}\n   * @default 0\n   */\n  destLeft?: number;\n  /**\n   * 目标 Canvas 的左上角 y 坐标\n   * @type {number}\n   * @default 0\n   */\n  destTop?: number;\n  /**\n   * 目标 Canvas 的宽度\n   * @type {number}\n   * @default Canvas 的宽度\n   */\n  destWidth?: number;\n  /**\n   * 目标 Canvas 的高度\n   * @type {number}\n   * @default Canvas 的高度\n   */\n  destHeight?: number;\n};\n\n/**\n * 在 Canvas 上绘制图片\n * @param {HTMLCanvasElement} canvas - 目标 Canvas 元素\n * @param {string} url - 图片的 URL\n * @param {CanvasDrawImageOptions} [options] - 绘制图片的配置选项\n * @returns {Promise<void>} 返回一个 Promise，表示绘制完成\n * @example\n * await canvasDrawImage(canvas, 'https://example.com/image.png', {\n *   srcLeft: 10,\n *   srcTop: 10,\n *   srcWidth: 100,\n *   srcHeight: 100,\n *   destLeft: 0,\n *   destTop: 0,\n *   destWidth: 200,\n *   destHeight: 200\n * });\n */\nexport async function canvasDrawImage(canvas: HTMLCanvasElement, url: string, options?: CanvasDrawImageOptions) {\n  const ctx = canvas.getContext('2d');\n  if (!ctx) throw new Error('canvas context is null');\n\n  const img = await imageLoad(url);\n  const defaults: CanvasDrawImageOptions = {\n    srcLeft: 0,\n    srcTop: 0,\n    srcWidth: img.width,\n    srcHeight: img.height,\n    destLeft: 0,\n    destTop: 0,\n    destWidth: canvas.width,\n    destHeight: canvas.height,\n  };\n  const { srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight } = objectDefaults(\n    options || {},\n    defaults,\n  ) as Required<CanvasDrawImageOptions>;\n  ctx.drawImage(\n    img,\n    // source\n    srcLeft,\n    srcTop,\n    srcWidth,\n    srcHeight,\n    // dest\n    destLeft,\n    destTop,\n    destWidth,\n    destHeight,\n  );\n}\n"],"names":["imageLoad","objectDefaults"],"mappings":";;;;AAYgB,SAAA,eAAe,QAA2B,MAAe,SAAkB;AAClF,SAAA,OAAO,UAAU,MAAM,OAAO;AACvC;AAWsB,eAAA,aAAa,QAA2B,MAAe,SAAkB;AAC7F,SAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AACrC,WAAA;AAAA,MACL,CAAC,SAAS;AACR,YAAI,MAAM;AACR,kBAAQ,IAAI;AAAA,QAAA,OACP;AACE,iBAAA,IAAI,MAAM,kBAAkB,CAAC;AAAA,QAAA;AAAA,MAExC;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EAAA,CACD;AACH;AA2EsB,eAAA,gBAAgB,QAA2B,KAAa,SAAkC;AACxG,QAAA,MAAM,OAAO,WAAW,IAAI;AAClC,MAAI,CAAC,IAAW,OAAA,IAAI,MAAM,wBAAwB;AAE5C,QAAA,MAAM,MAAMA,MAAA,UAAU,GAAG;AAC/B,QAAM,WAAmC;AAAA,IACvC,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,UAAU,IAAI;AAAA,IACd,WAAW,IAAI;AAAA,IACf,UAAU;AAAA,IACV,SAAS;AAAA,IACT,WAAW,OAAO;AAAA,IAClB,YAAY,OAAO;AAAA,EACrB;AACM,QAAA,EAAE,SAAS,QAAQ,UAAU,WAAW,UAAU,SAAS,WAAW,WAAA,IAAeC,OAAA;AAAA,IACzF,WAAW,CAAC;AAAA,IACZ;AAAA,EACF;AACI,MAAA;AAAA,IACF;AAAA;AAAA,IAEA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA,IAEA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;;"}
+{"version":3,"file":"canvas.cjs","names":[],"sources":["../src/canvas.ts"],"sourcesContent":["import { objectDefaults } from '@cloudcome/utils-core/object';\nimport { imageLoad } from './image';\n\n/**\n * 将 Canvas 转换为 Base64 编码的字符串\n * @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素\n * @param {string} [type] - 图片格式，默认为 'image/png'\n * @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'\n * @returns {string} Base64 编码的图片数据\n * @example\n * const base64 = canvasToBase64(canvas, 'image/jpeg', 0.8);\n */\nexport function canvasToBase64(canvas: HTMLCanvasElement, type?: string, quality?: number) {\n  return canvas.toDataURL(type, quality);\n}\n\n/**\n * 将 Canvas 转换为 Blob 对象\n * @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素\n * @param {string} [type] - 图片格式，默认为 'image/png'\n * @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'\n * @returns {Promise<Blob>} 返回一个包含 Blob 对象的 Promise\n * @example\n * const blob = await canvasToBlob(canvas, 'image/jpeg', 0.8);\n */\nexport async function canvasToBlob(canvas: HTMLCanvasElement, type?: string, quality?: number) {\n  return new Promise<Blob>((resolve, reject) => {\n    canvas.toBlob(\n      (blob) => {\n        if (blob) {\n          resolve(blob);\n        } else {\n          reject(new Error('canvas 导出二进制对象失败'));\n        }\n      },\n      type,\n      quality,\n    );\n  });\n}\n\n/**\n * Canvas 绘制图片的配置选项\n */\nexport type CanvasDrawImageOptions = {\n  /**\n   * 源图片的左上角 x 坐标\n   * @type {number}\n   * @default 0\n   */\n  srcLeft?: number;\n  /**\n   * 源图片的左上角 y 坐标\n   * @type {number}\n   * @default 0\n   */\n  srcTop?: number;\n  /**\n   * 源图片的宽度\n   * @type {number}\n   * @default 图片的原始宽度\n   */\n  srcWidth?: number;\n  /**\n   * 源图片的高度\n   * @type {number}\n   * @default 图片的原始高度\n   */\n  srcHeight?: number;\n\n  /**\n   * 目标 Canvas 的左上角 x 坐标\n   * @type {number}\n   * @default 0\n   */\n  destLeft?: number;\n  /**\n   * 目标 Canvas 的左上角 y 坐标\n   * @type {number}\n   * @default 0\n   */\n  destTop?: number;\n  /**\n   * 目标 Canvas 的宽度\n   * @type {number}\n   * @default Canvas 的宽度\n   */\n  destWidth?: number;\n  /**\n   * 目标 Canvas 的高度\n   * @type {number}\n   * @default Canvas 的高度\n   */\n  destHeight?: number;\n};\n\n/**\n * 在 Canvas 上绘制图片\n * @param {HTMLCanvasElement} canvas - 目标 Canvas 元素\n * @param {string} url - 图片的 URL\n * @param {CanvasDrawImageOptions} [options] - 绘制图片的配置选项\n * @returns {Promise<void>} 返回一个 Promise，表示绘制完成\n * @example\n * await canvasDrawImage(canvas, 'https://example.com/image.png', {\n *   srcLeft: 10,\n *   srcTop: 10,\n *   srcWidth: 100,\n *   srcHeight: 100,\n *   destLeft: 0,\n *   destTop: 0,\n *   destWidth: 200,\n *   destHeight: 200\n * });\n */\nexport async function canvasDrawImage(canvas: HTMLCanvasElement, url: string, options?: CanvasDrawImageOptions) {\n  const ctx = canvas.getContext('2d');\n  if (!ctx) throw new Error('canvas context is null');\n\n  const img = await imageLoad(url);\n  const defaults: CanvasDrawImageOptions = {\n    srcLeft: 0,\n    srcTop: 0,\n    srcWidth: img.width,\n    srcHeight: img.height,\n    destLeft: 0,\n    destTop: 0,\n    destWidth: canvas.width,\n    destHeight: canvas.height,\n  };\n  const { srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight } = objectDefaults(\n    options || {},\n    defaults,\n  ) as Required<CanvasDrawImageOptions>;\n  ctx.drawImage(\n    img,\n    // source\n    srcLeft,\n    srcTop,\n    srcWidth,\n    srcHeight,\n    // dest\n    destLeft,\n    destTop,\n    destWidth,\n    destHeight,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,eAAe,QAA2B,MAAe,SAAkB;CACzF,OAAO,OAAO,UAAU,MAAM,QAAQ;;;;;;;;;;;AAYxC,eAAsB,aAAa,QAA2B,MAAe,SAAkB;CAC7F,OAAO,IAAI,SAAe,SAAS,WAAW;EAC5C,OAAO,QACJ,SAAS;GACR,IAAI,MACF,QAAQ,KAAK;QAEb,uBAAO,IAAI,MAAM,mBAAmB,CAAC;KAGzC,MACA,QACD;GACD;;;;;;;;;;;;;;;;;;;;AA4EJ,eAAsB,gBAAgB,QAA2B,KAAa,SAAkC;CAC9G,MAAM,MAAM,OAAO,WAAW,KAAK;CACnC,IAAI,CAAC,KAAK,MAAM,IAAI,MAAM,yBAAyB;CAEnD,MAAM,MAAM,MAAM,cAAA,UAAU,IAAI;CAChC,MAAM,WAAmC;EACvC,SAAS;EACT,QAAQ;EACR,UAAU,IAAI;EACd,WAAW,IAAI;EACf,UAAU;EACV,SAAS;EACT,WAAW,OAAO;EAClB,YAAY,OAAO;EACpB;CACD,MAAM,EAAE,SAAS,QAAQ,UAAU,WAAW,UAAU,SAAS,WAAW,gBAAA,GAAA,6BAAA,gBAC1E,WAAW,EAAE,EACb,SACD;CACD,IAAI,UACF,KAEA,SACA,QACA,UACA,WAEA,UACA,SACA,WACA,WACD"}

package/dist/canvas.mjs

@@ -1,58 +1,71 @@
-import { objectDefaults } from "@cloudcome/utils-core/object";
 import { imageLoad } from "./image.mjs";
+import { objectDefaults } from "@cloudcome/utils-core/object";
+//#region src/canvas.ts
+/**
+* 将 Canvas 转换为 Base64 编码的字符串
+* @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素
+* @param {string} [type] - 图片格式，默认为 'image/png'
+* @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'
+* @returns {string} Base64 编码的图片数据
+* @example
+* const base64 = canvasToBase64(canvas, 'image/jpeg', 0.8);
+*/
 function canvasToBase64(canvas, type, quality) {
-  return canvas.toDataURL(type, quality);
+	return canvas.toDataURL(type, quality);
 }
+/**
+* 将 Canvas 转换为 Blob 对象
+* @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素
+* @param {string} [type] - 图片格式，默认为 'image/png'
+* @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'
+* @returns {Promise<Blob>} 返回一个包含 Blob 对象的 Promise
+* @example
+* const blob = await canvasToBlob(canvas, 'image/jpeg', 0.8);
+*/
 async function canvasToBlob(canvas, type, quality) {
-  return new Promise((resolve, reject) => {
-    canvas.toBlob(
-      (blob) => {
-        if (blob) {
-          resolve(blob);
-        } else {
-          reject(new Error("canvas 导出二进制对象失败"));
-        }
-      },
-      type,
-      quality
-    );
-  });
+	return new Promise((resolve, reject) => {
+		canvas.toBlob((blob) => {
+			if (blob) resolve(blob);
+			else reject(/* @__PURE__ */ new Error("canvas 导出二进制对象失败"));
+		}, type, quality);
+	});
 }
+/**
+* 在 Canvas 上绘制图片
+* @param {HTMLCanvasElement} canvas - 目标 Canvas 元素
+* @param {string} url - 图片的 URL
+* @param {CanvasDrawImageOptions} [options] - 绘制图片的配置选项
+* @returns {Promise<void>} 返回一个 Promise，表示绘制完成
+* @example
+* await canvasDrawImage(canvas, 'https://example.com/image.png', {
+*   srcLeft: 10,
+*   srcTop: 10,
+*   srcWidth: 100,
+*   srcHeight: 100,
+*   destLeft: 0,
+*   destTop: 0,
+*   destWidth: 200,
+*   destHeight: 200
+* });
+*/
 async function canvasDrawImage(canvas, url, options) {
-  const ctx = canvas.getContext("2d");
-  if (!ctx) throw new Error("canvas context is null");
-  const img = await imageLoad(url);
-  const defaults = {
-    srcLeft: 0,
-    srcTop: 0,
-    srcWidth: img.width,
-    srcHeight: img.height,
-    destLeft: 0,
-    destTop: 0,
-    destWidth: canvas.width,
-    destHeight: canvas.height
-  };
-  const { srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight } = objectDefaults(
-    options || {},
-    defaults
-  );
-  ctx.drawImage(
-    img,
-    // source
-    srcLeft,
-    srcTop,
-    srcWidth,
-    srcHeight,
-    // dest
-    destLeft,
-    destTop,
-    destWidth,
-    destHeight
-  );
+	const ctx = canvas.getContext("2d");
+	if (!ctx) throw new Error("canvas context is null");
+	const img = await imageLoad(url);
+	const defaults = {
+		srcLeft: 0,
+		srcTop: 0,
+		srcWidth: img.width,
+		srcHeight: img.height,
+		destLeft: 0,
+		destTop: 0,
+		destWidth: canvas.width,
+		destHeight: canvas.height
+	};
+	const { srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight } = objectDefaults(options || {}, defaults);
+	ctx.drawImage(img, srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight);
 }
-export {
-  canvasDrawImage,
-  canvasToBase64,
-  canvasToBlob
-};
-//# sourceMappingURL=canvas.mjs.map
+//#endregion
+export { canvasDrawImage, canvasToBase64, canvasToBlob };
+
+//# sourceMappingURL=canvas.mjs.map

package/dist/canvas.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.mjs","sources":["../src/canvas.ts"],"sourcesContent":["import { objectDefaults } from '@cloudcome/utils-core/object';\nimport { imageLoad } from './image';\n\n/**\n * 将 Canvas 转换为 Base64 编码的字符串\n * @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素\n * @param {string} [type] - 图片格式，默认为 'image/png'\n * @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'\n * @returns {string} Base64 编码的图片数据\n * @example\n * const base64 = canvasToBase64(canvas, 'image/jpeg', 0.8);\n */\nexport function canvasToBase64(canvas: HTMLCanvasElement, type?: string, quality?: number) {\n  return canvas.toDataURL(type, quality);\n}\n\n/**\n * 将 Canvas 转换为 Blob 对象\n * @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素\n * @param {string} [type] - 图片格式，默认为 'image/png'\n * @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'\n * @returns {Promise<Blob>} 返回一个包含 Blob 对象的 Promise\n * @example\n * const blob = await canvasToBlob(canvas, 'image/jpeg', 0.8);\n */\nexport async function canvasToBlob(canvas: HTMLCanvasElement, type?: string, quality?: number) {\n  return new Promise<Blob>((resolve, reject) => {\n    canvas.toBlob(\n      (blob) => {\n        if (blob) {\n          resolve(blob);\n        } else {\n          reject(new Error('canvas 导出二进制对象失败'));\n        }\n      },\n      type,\n      quality,\n    );\n  });\n}\n\n/**\n * Canvas 绘制图片的配置选项\n */\nexport type CanvasDrawImageOptions = {\n  /**\n   * 源图片的左上角 x 坐标\n   * @type {number}\n   * @default 0\n   */\n  srcLeft?: number;\n  /**\n   * 源图片的左上角 y 坐标\n   * @type {number}\n   * @default 0\n   */\n  srcTop?: number;\n  /**\n   * 源图片的宽度\n   * @type {number}\n   * @default 图片的原始宽度\n   */\n  srcWidth?: number;\n  /**\n   * 源图片的高度\n   * @type {number}\n   * @default 图片的原始高度\n   */\n  srcHeight?: number;\n\n  /**\n   * 目标 Canvas 的左上角 x 坐标\n   * @type {number}\n   * @default 0\n   */\n  destLeft?: number;\n  /**\n   * 目标 Canvas 的左上角 y 坐标\n   * @type {number}\n   * @default 0\n   */\n  destTop?: number;\n  /**\n   * 目标 Canvas 的宽度\n   * @type {number}\n   * @default Canvas 的宽度\n   */\n  destWidth?: number;\n  /**\n   * 目标 Canvas 的高度\n   * @type {number}\n   * @default Canvas 的高度\n   */\n  destHeight?: number;\n};\n\n/**\n * 在 Canvas 上绘制图片\n * @param {HTMLCanvasElement} canvas - 目标 Canvas 元素\n * @param {string} url - 图片的 URL\n * @param {CanvasDrawImageOptions} [options] - 绘制图片的配置选项\n * @returns {Promise<void>} 返回一个 Promise，表示绘制完成\n * @example\n * await canvasDrawImage(canvas, 'https://example.com/image.png', {\n *   srcLeft: 10,\n *   srcTop: 10,\n *   srcWidth: 100,\n *   srcHeight: 100,\n *   destLeft: 0,\n *   destTop: 0,\n *   destWidth: 200,\n *   destHeight: 200\n * });\n */\nexport async function canvasDrawImage(canvas: HTMLCanvasElement, url: string, options?: CanvasDrawImageOptions) {\n  const ctx = canvas.getContext('2d');\n  if (!ctx) throw new Error('canvas context is null');\n\n  const img = await imageLoad(url);\n  const defaults: CanvasDrawImageOptions = {\n    srcLeft: 0,\n    srcTop: 0,\n    srcWidth: img.width,\n    srcHeight: img.height,\n    destLeft: 0,\n    destTop: 0,\n    destWidth: canvas.width,\n    destHeight: canvas.height,\n  };\n  const { srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight } = objectDefaults(\n    options || {},\n    defaults,\n  ) as Required<CanvasDrawImageOptions>;\n  ctx.drawImage(\n    img,\n    // source\n    srcLeft,\n    srcTop,\n    srcWidth,\n    srcHeight,\n    // dest\n    destLeft,\n    destTop,\n    destWidth,\n    destHeight,\n  );\n}\n"],"names":[],"mappings":";;AAYgB,SAAA,eAAe,QAA2B,MAAe,SAAkB;AAClF,SAAA,OAAO,UAAU,MAAM,OAAO;AACvC;AAWsB,eAAA,aAAa,QAA2B,MAAe,SAAkB;AAC7F,SAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AACrC,WAAA;AAAA,MACL,CAAC,SAAS;AACR,YAAI,MAAM;AACR,kBAAQ,IAAI;AAAA,QAAA,OACP;AACE,iBAAA,IAAI,MAAM,kBAAkB,CAAC;AAAA,QAAA;AAAA,MAExC;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EAAA,CACD;AACH;AA2EsB,eAAA,gBAAgB,QAA2B,KAAa,SAAkC;AACxG,QAAA,MAAM,OAAO,WAAW,IAAI;AAClC,MAAI,CAAC,IAAW,OAAA,IAAI,MAAM,wBAAwB;AAE5C,QAAA,MAAM,MAAM,UAAU,GAAG;AAC/B,QAAM,WAAmC;AAAA,IACvC,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,UAAU,IAAI;AAAA,IACd,WAAW,IAAI;AAAA,IACf,UAAU;AAAA,IACV,SAAS;AAAA,IACT,WAAW,OAAO;AAAA,IAClB,YAAY,OAAO;AAAA,EACrB;AACM,QAAA,EAAE,SAAS,QAAQ,UAAU,WAAW,UAAU,SAAS,WAAW,WAAA,IAAe;AAAA,IACzF,WAAW,CAAC;AAAA,IACZ;AAAA,EACF;AACI,MAAA;AAAA,IACF;AAAA;AAAA,IAEA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA,IAEA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;"}
+{"version":3,"file":"canvas.mjs","names":[],"sources":["../src/canvas.ts"],"sourcesContent":["import { objectDefaults } from '@cloudcome/utils-core/object';\nimport { imageLoad } from './image';\n\n/**\n * 将 Canvas 转换为 Base64 编码的字符串\n * @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素\n * @param {string} [type] - 图片格式，默认为 'image/png'\n * @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'\n * @returns {string} Base64 编码的图片数据\n * @example\n * const base64 = canvasToBase64(canvas, 'image/jpeg', 0.8);\n */\nexport function canvasToBase64(canvas: HTMLCanvasElement, type?: string, quality?: number) {\n  return canvas.toDataURL(type, quality);\n}\n\n/**\n * 将 Canvas 转换为 Blob 对象\n * @param {HTMLCanvasElement} canvas - 需要转换的 Canvas 元素\n * @param {string} [type] - 图片格式，默认为 'image/png'\n * @param {number} [quality] - 图片质量，范围 0 到 1，仅适用于 'image/jpeg' 或 'image/webp'\n * @returns {Promise<Blob>} 返回一个包含 Blob 对象的 Promise\n * @example\n * const blob = await canvasToBlob(canvas, 'image/jpeg', 0.8);\n */\nexport async function canvasToBlob(canvas: HTMLCanvasElement, type?: string, quality?: number) {\n  return new Promise<Blob>((resolve, reject) => {\n    canvas.toBlob(\n      (blob) => {\n        if (blob) {\n          resolve(blob);\n        } else {\n          reject(new Error('canvas 导出二进制对象失败'));\n        }\n      },\n      type,\n      quality,\n    );\n  });\n}\n\n/**\n * Canvas 绘制图片的配置选项\n */\nexport type CanvasDrawImageOptions = {\n  /**\n   * 源图片的左上角 x 坐标\n   * @type {number}\n   * @default 0\n   */\n  srcLeft?: number;\n  /**\n   * 源图片的左上角 y 坐标\n   * @type {number}\n   * @default 0\n   */\n  srcTop?: number;\n  /**\n   * 源图片的宽度\n   * @type {number}\n   * @default 图片的原始宽度\n   */\n  srcWidth?: number;\n  /**\n   * 源图片的高度\n   * @type {number}\n   * @default 图片的原始高度\n   */\n  srcHeight?: number;\n\n  /**\n   * 目标 Canvas 的左上角 x 坐标\n   * @type {number}\n   * @default 0\n   */\n  destLeft?: number;\n  /**\n   * 目标 Canvas 的左上角 y 坐标\n   * @type {number}\n   * @default 0\n   */\n  destTop?: number;\n  /**\n   * 目标 Canvas 的宽度\n   * @type {number}\n   * @default Canvas 的宽度\n   */\n  destWidth?: number;\n  /**\n   * 目标 Canvas 的高度\n   * @type {number}\n   * @default Canvas 的高度\n   */\n  destHeight?: number;\n};\n\n/**\n * 在 Canvas 上绘制图片\n * @param {HTMLCanvasElement} canvas - 目标 Canvas 元素\n * @param {string} url - 图片的 URL\n * @param {CanvasDrawImageOptions} [options] - 绘制图片的配置选项\n * @returns {Promise<void>} 返回一个 Promise，表示绘制完成\n * @example\n * await canvasDrawImage(canvas, 'https://example.com/image.png', {\n *   srcLeft: 10,\n *   srcTop: 10,\n *   srcWidth: 100,\n *   srcHeight: 100,\n *   destLeft: 0,\n *   destTop: 0,\n *   destWidth: 200,\n *   destHeight: 200\n * });\n */\nexport async function canvasDrawImage(canvas: HTMLCanvasElement, url: string, options?: CanvasDrawImageOptions) {\n  const ctx = canvas.getContext('2d');\n  if (!ctx) throw new Error('canvas context is null');\n\n  const img = await imageLoad(url);\n  const defaults: CanvasDrawImageOptions = {\n    srcLeft: 0,\n    srcTop: 0,\n    srcWidth: img.width,\n    srcHeight: img.height,\n    destLeft: 0,\n    destTop: 0,\n    destWidth: canvas.width,\n    destHeight: canvas.height,\n  };\n  const { srcLeft, srcTop, srcWidth, srcHeight, destLeft, destTop, destWidth, destHeight } = objectDefaults(\n    options || {},\n    defaults,\n  ) as Required<CanvasDrawImageOptions>;\n  ctx.drawImage(\n    img,\n    // source\n    srcLeft,\n    srcTop,\n    srcWidth,\n    srcHeight,\n    // dest\n    destLeft,\n    destTop,\n    destWidth,\n    destHeight,\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,eAAe,QAA2B,MAAe,SAAkB;CACzF,OAAO,OAAO,UAAU,MAAM,QAAQ;;;;;;;;;;;AAYxC,eAAsB,aAAa,QAA2B,MAAe,SAAkB;CAC7F,OAAO,IAAI,SAAe,SAAS,WAAW;EAC5C,OAAO,QACJ,SAAS;GACR,IAAI,MACF,QAAQ,KAAK;QAEb,uBAAO,IAAI,MAAM,mBAAmB,CAAC;KAGzC,MACA,QACD;GACD;;;;;;;;;;;;;;;;;;;;AA4EJ,eAAsB,gBAAgB,QAA2B,KAAa,SAAkC;CAC9G,MAAM,MAAM,OAAO,WAAW,KAAK;CACnC,IAAI,CAAC,KAAK,MAAM,IAAI,MAAM,yBAAyB;CAEnD,MAAM,MAAM,MAAM,UAAU,IAAI;CAChC,MAAM,WAAmC;EACvC,SAAS;EACT,QAAQ;EACR,UAAU,IAAI;EACd,WAAW,IAAI;EACf,UAAU;EACV,SAAS;EACT,WAAW,OAAO;EAClB,YAAY,OAAO;EACpB;CACD,MAAM,EAAE,SAAS,QAAQ,UAAU,WAAW,UAAU,SAAS,WAAW,eAAe,eACzF,WAAW,EAAE,EACb,SACD;CACD,IAAI,UACF,KAEA,SACA,QACA,UACA,WAEA,UACA,SACA,WACA,WACD"}

package/dist/clipboard.cjs

@@ -1,19 +1,38 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/clipboard.ts
+/**
+* 将文本复制到剪贴板
+* 该方法使用传统的 execCommand 方法实现文本复制
+*
+* @param text - 要复制到剪贴板的文本内容
+* @returns void
+*
+* @example
+* // 基本用法
+* await copyText('Hello World');
+*
+* @example
+* // 处理复制结果
+* copyText('Hello World')
+*   .then(() => console.log('复制成功'))
+*   .catch(() => console.error('复制失败'));
+*/
 function copyText(text) {
-  const textArea = document.createElement("textarea");
-  textArea.value = text;
-  textArea.style.position = "fixed";
-  textArea.style.left = "-9999px";
-  textArea.style.top = "-9999px";
-  document.body.appendChild(textArea);
-  textArea.focus();
-  textArea.select();
-  try {
-    document.execCommand("copy");
-  } finally {
-    document.body.removeChild(textArea);
-  }
+	const textArea = document.createElement("textarea");
+	textArea.value = text;
+	textArea.style.position = "fixed";
+	textArea.style.left = "-9999px";
+	textArea.style.top = "-9999px";
+	document.body.appendChild(textArea);
+	textArea.focus();
+	textArea.select();
+	try {
+		document.execCommand("copy");
+	} finally {
+		document.body.removeChild(textArea);
+	}
 }
+//#endregion
 exports.copyText = copyText;
-//# sourceMappingURL=clipboard.cjs.map
+
+//# sourceMappingURL=clipboard.cjs.map

package/dist/clipboard.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.cjs","sources":["../src/clipboard.ts"],"sourcesContent":["/**\n * 将文本复制到剪贴板\n * 该方法使用传统的 execCommand 方法实现文本复制\n *\n * @param text - 要复制到剪贴板的文本内容\n * @returns void\n *\n * @example\n * // 基本用法\n * await copyText('Hello World');\n *\n * @example\n * // 处理复制结果\n * copyText('Hello World')\n *   .then(() => console.log('复制成功'))\n *   .catch(() => console.error('复制失败'));\n */\nexport function copyText(text: string) {\n  const textArea = document.createElement('textarea');\n  textArea.value = text;\n  textArea.style.position = 'fixed';\n  textArea.style.left = '-9999px';\n  textArea.style.top = '-9999px';\n  document.body.appendChild(textArea);\n  textArea.focus();\n  textArea.select();\n  try {\n    document.execCommand('copy');\n  } finally {\n    document.body.removeChild(textArea);\n  }\n}\n"],"names":[],"mappings":";;AAiBO,SAAS,SAAS,MAAc;AAC/B,QAAA,WAAW,SAAS,cAAc,UAAU;AAClD,WAAS,QAAQ;AACjB,WAAS,MAAM,WAAW;AAC1B,WAAS,MAAM,OAAO;AACtB,WAAS,MAAM,MAAM;AACZ,WAAA,KAAK,YAAY,QAAQ;AAClC,WAAS,MAAM;AACf,WAAS,OAAO;AACZ,MAAA;AACF,aAAS,YAAY,MAAM;AAAA,EAAA,UAC3B;AACS,aAAA,KAAK,YAAY,QAAQ;AAAA,EAAA;AAEtC;;"}
+{"version":3,"file":"clipboard.cjs","names":[],"sources":["../src/clipboard.ts"],"sourcesContent":["/**\n * 将文本复制到剪贴板\n * 该方法使用传统的 execCommand 方法实现文本复制\n *\n * @param text - 要复制到剪贴板的文本内容\n * @returns void\n *\n * @example\n * // 基本用法\n * await copyText('Hello World');\n *\n * @example\n * // 处理复制结果\n * copyText('Hello World')\n *   .then(() => console.log('复制成功'))\n *   .catch(() => console.error('复制失败'));\n */\nexport function copyText(text: string) {\n  const textArea = document.createElement('textarea');\n  textArea.value = text;\n  textArea.style.position = 'fixed';\n  textArea.style.left = '-9999px';\n  textArea.style.top = '-9999px';\n  document.body.appendChild(textArea);\n  textArea.focus();\n  textArea.select();\n  try {\n    document.execCommand('copy');\n  } finally {\n    document.body.removeChild(textArea);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,SAAS,MAAc;CACrC,MAAM,WAAW,SAAS,cAAc,WAAW;CACnD,SAAS,QAAQ;CACjB,SAAS,MAAM,WAAW;CAC1B,SAAS,MAAM,OAAO;CACtB,SAAS,MAAM,MAAM;CACrB,SAAS,KAAK,YAAY,SAAS;CACnC,SAAS,OAAO;CAChB,SAAS,QAAQ;CACjB,IAAI;EACF,SAAS,YAAY,OAAO;WACpB;EACR,SAAS,KAAK,YAAY,SAAS"}

package/dist/clipboard.mjs

@@ -1,19 +1,37 @@
+//#region src/clipboard.ts
+/**
+* 将文本复制到剪贴板
+* 该方法使用传统的 execCommand 方法实现文本复制
+*
+* @param text - 要复制到剪贴板的文本内容
+* @returns void
+*
+* @example
+* // 基本用法
+* await copyText('Hello World');
+*
+* @example
+* // 处理复制结果
+* copyText('Hello World')
+*   .then(() => console.log('复制成功'))
+*   .catch(() => console.error('复制失败'));
+*/
 function copyText(text) {
-  const textArea = document.createElement("textarea");
-  textArea.value = text;
-  textArea.style.position = "fixed";
-  textArea.style.left = "-9999px";
-  textArea.style.top = "-9999px";
-  document.body.appendChild(textArea);
-  textArea.focus();
-  textArea.select();
-  try {
-    document.execCommand("copy");
-  } finally {
-    document.body.removeChild(textArea);
-  }
+	const textArea = document.createElement("textarea");
+	textArea.value = text;
+	textArea.style.position = "fixed";
+	textArea.style.left = "-9999px";
+	textArea.style.top = "-9999px";
+	document.body.appendChild(textArea);
+	textArea.focus();
+	textArea.select();
+	try {
+		document.execCommand("copy");
+	} finally {
+		document.body.removeChild(textArea);
+	}
 }
-export {
-  copyText
-};
-//# sourceMappingURL=clipboard.mjs.map
+//#endregion
+export { copyText };
+
+//# sourceMappingURL=clipboard.mjs.map

package/dist/clipboard.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.mjs","sources":["../src/clipboard.ts"],"sourcesContent":["/**\n * 将文本复制到剪贴板\n * 该方法使用传统的 execCommand 方法实现文本复制\n *\n * @param text - 要复制到剪贴板的文本内容\n * @returns void\n *\n * @example\n * // 基本用法\n * await copyText('Hello World');\n *\n * @example\n * // 处理复制结果\n * copyText('Hello World')\n *   .then(() => console.log('复制成功'))\n *   .catch(() => console.error('复制失败'));\n */\nexport function copyText(text: string) {\n  const textArea = document.createElement('textarea');\n  textArea.value = text;\n  textArea.style.position = 'fixed';\n  textArea.style.left = '-9999px';\n  textArea.style.top = '-9999px';\n  document.body.appendChild(textArea);\n  textArea.focus();\n  textArea.select();\n  try {\n    document.execCommand('copy');\n  } finally {\n    document.body.removeChild(textArea);\n  }\n}\n"],"names":[],"mappings":"AAiBO,SAAS,SAAS,MAAc;AAC/B,QAAA,WAAW,SAAS,cAAc,UAAU;AAClD,WAAS,QAAQ;AACjB,WAAS,MAAM,WAAW;AAC1B,WAAS,MAAM,OAAO;AACtB,WAAS,MAAM,MAAM;AACZ,WAAA,KAAK,YAAY,QAAQ;AAClC,WAAS,MAAM;AACf,WAAS,OAAO;AACZ,MAAA;AACF,aAAS,YAAY,MAAM;AAAA,EAAA,UAC3B;AACS,aAAA,KAAK,YAAY,QAAQ;AAAA,EAAA;AAEtC;"}
+{"version":3,"file":"clipboard.mjs","names":[],"sources":["../src/clipboard.ts"],"sourcesContent":["/**\n * 将文本复制到剪贴板\n * 该方法使用传统的 execCommand 方法实现文本复制\n *\n * @param text - 要复制到剪贴板的文本内容\n * @returns void\n *\n * @example\n * // 基本用法\n * await copyText('Hello World');\n *\n * @example\n * // 处理复制结果\n * copyText('Hello World')\n *   .then(() => console.log('复制成功'))\n *   .catch(() => console.error('复制失败'));\n */\nexport function copyText(text: string) {\n  const textArea = document.createElement('textarea');\n  textArea.value = text;\n  textArea.style.position = 'fixed';\n  textArea.style.left = '-9999px';\n  textArea.style.top = '-9999px';\n  document.body.appendChild(textArea);\n  textArea.focus();\n  textArea.select();\n  try {\n    document.execCommand('copy');\n  } finally {\n    document.body.removeChild(textArea);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,SAAgB,SAAS,MAAc;CACrC,MAAM,WAAW,SAAS,cAAc,WAAW;CACnD,SAAS,QAAQ;CACjB,SAAS,MAAM,WAAW;CAC1B,SAAS,MAAM,OAAO;CACtB,SAAS,MAAM,MAAM;CACrB,SAAS,KAAK,YAAY,SAAS;CACnC,SAAS,OAAO;CAChB,SAAS,QAAQ;CACjB,IAAI;EACF,SAAS,YAAY,OAAO;WACpB;EACR,SAAS,KAAK,YAAY,SAAS"}