@cloudcome/utils-browser 1.1.0 → 1.1.1

package/test/image.test.ts

@@ -0,0 +1,75 @@
+import { describe, expect, it, vi } from 'vitest';
+import { imageLoad } from '../src/image';
+
+describe('图片工具函数', () => {
+  beforeEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('应该能够成功加载图片', async () => {
+    const mockImage = new Image();
+    vi.spyOn(window, 'Image').mockReturnValue(mockImage);
+    vi.spyOn(document.body, 'appendChild');
+    vi.spyOn(document.body, 'removeChild');
+
+    const url = 'https://example.com/image.png';
+    const promise = imageLoad(url);
+
+    mockImage.onload?.({} as Event);
+    const result = await promise;
+
+    expect(result).toBe(mockImage);
+    expect(mockImage.src).toBe(url);
+    expect(mockImage.crossOrigin).toBe('anonymous');
+    expect(document.body.appendChild).toHaveBeenCalledWith(mockImage);
+    expect(document.body.removeChild).toHaveBeenCalledWith(mockImage);
+  });
+
+  it('图片加载失败时应抛出错误', async () => {
+    const mockImage = new Image();
+    vi.spyOn(window, 'Image').mockReturnValue(mockImage);
+
+    const url = 'https://example.com/invalid.png';
+    const promise = imageLoad(url);
+
+    mockImage.onerror?.({} as Event);
+
+    await expect(promise).rejects.toThrow('图片加载失败');
+  });
+
+  it('如果图片已经加载完成应立即返回', async () => {
+    const mockImage = new Image();
+    vi.spyOn(window, 'Image').mockReturnValue(mockImage);
+    Object.defineProperty(mockImage, 'complete', { value: true });
+    Object.defineProperty(mockImage, 'width', { value: 100 });
+
+    const url = 'https://example.com/image.png';
+    const result = await imageLoad(url);
+
+    expect(result).toBe(mockImage);
+  });
+
+  it('应该为图片元素设置正确的样式', async () => {
+    const mockImage = new Image();
+    vi.spyOn(window, 'Image').mockReturnValue(mockImage);
+
+    const url = 'https://example.com/image.png';
+    const promise = imageLoad(url);
+
+    mockImage.onload?.({} as Event);
+    await promise;
+
+    expect(mockImage.style.visibility).toBe('hidden');
+    expect(mockImage.style.position).toBe('absolute');
+    expect(mockImage.style.top).toBe('-99999%');
+    expect(mockImage.style.left).toBe('-99999%');
+    expect(mockImage.style.maxWidth).toBe('');
+    expect(mockImage.style.maxHeight).toBe('');
+    expect(mockImage.style.border).toBe('0px');
+    expect(mockImage.style.width).toBe('auto');
+    expect(mockImage.style.height).toBe('auto');
+    expect(mockImage.style.margin).toBe('0px');
+    expect(mockImage.style.padding).toBe('0px');
+    expect(mockImage.style.transform).toBe('');
+  });
+});

package/test/index.test.ts

@@ -0,0 +1,6 @@
+import { VERSION } from '@/index';
+import { expect, it } from 'vitest';
+
+it('version', () => {
+  expect(VERSION).toEqual(PKG_VERSION);
+});

package/test/timer.test.ts

@@ -0,0 +1,109 @@
+import { frameInterval } from '@/timer';
+import { type Mock, afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+describe('帧间隔计时器', () => {
+  let mockRAF: number;
+  let mockCAF: Mock;
+  let callbacks: FrameRequestCallback[] = [];
+
+  beforeEach(() => {
+    mockRAF = 0;
+    callbacks = [];
+    mockCAF = vi.fn();
+
+    vi.stubGlobal('requestAnimationFrame', (cb: FrameRequestCallback) => {
+      callbacks.push(cb);
+      return ++mockRAF;
+    });
+
+    vi.stubGlobal('cancelAnimationFrame', mockCAF);
+  });
+
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
+  it('启动时应在每一帧调用回调函数', () => {
+    const callback = vi.fn();
+    const timer = frameInterval(callback);
+
+    timer.start();
+    callbacks[0]?.(0);
+    const arg = callback.mock.calls[0][0];
+    expect(Object.keys(arg)).toEqual(
+      expect.arrayContaining([
+        'times',
+        'startAt',
+        'stopAt',
+        'pauseAt',
+        'resumeAt',
+        'currentAt',
+        'elapsedTime',
+        'runningTime',
+        'intervalTime',
+      ]),
+    );
+  });
+
+  it('应该支持 leading 选项', () => {
+    const callback = vi.fn();
+    const timer = frameInterval(callback, { leading: true });
+
+    timer.start();
+    expect(callback).toHaveBeenCalled();
+  });
+
+  it('停止时应支持 trailing 选项', () => {
+    const callback = vi.fn();
+    const timer = frameInterval(callback, { trailing: true });
+
+    timer.start();
+    callbacks[0]?.(0);
+
+    timer.stop();
+    expect(callback).toHaveBeenCalledTimes(2);
+    expect(mockCAF).toHaveBeenCalledWith(mockRAF);
+  });
+
+  it('暂停时应支持 trailing 选项', () => {
+    const callback = vi.fn();
+    const timer = frameInterval(callback, { trailing: true });
+
+    timer.start();
+    callbacks[0]?.(0);
+
+    timer.pause();
+    expect(callback).toHaveBeenCalledTimes(2);
+    expect(mockCAF).toHaveBeenCalledWith(mockRAF);
+  });
+
+  it('使用 immediate 标志时应立即恢复', () => {
+    const callback = vi.fn();
+    const timer = frameInterval(callback);
+
+    timer.start();
+    callbacks[0]?.(0);
+    timer.pause();
+
+    timer.resume(true);
+    callbacks[1]?.(16);
+
+    expect(callback).toHaveBeenCalledTimes(3);
+    expect(callback.mock.calls[1][0].times).toBe(2);
+  });
+
+  it('不使用 immediate 标志时应下一帧恢复', () => {
+    const callback = vi.fn();
+    const timer = frameInterval(callback);
+
+    timer.start();
+    callbacks[0]?.(0);
+    timer.pause();
+
+    timer.resume();
+    callbacks[1]?.(16);
+
+    expect(callback).toHaveBeenCalledTimes(1);
+    expect(callback.mock.calls[0][0].times).toBe(1);
+  });
+});

package/test/video.test.ts

@@ -0,0 +1,36 @@
+import { describe, expect, it, vi } from 'vitest';
+import { videoLoad } from '../src/video';
+
+describe('视频工具函数', () => {
+  beforeEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('应该能够成功加载视频', async () => {
+    const mockVideo = document.createElement('video');
+    vi.spyOn(document, 'createElement').mockReturnValue(mockVideo);
+
+    const url = 'https://example.com/video.mp4';
+    const promise = videoLoad(url);
+
+    mockVideo.onloadedmetadata?.({} as Event);
+    const result = await promise;
+
+    expect(result).toBe(mockVideo);
+    expect(mockVideo.src).toBe(url);
+    expect(mockVideo.crossOrigin).toBe('anonymous');
+    expect(mockVideo.currentTime).toBe(1);
+  });
+
+  it('视频加载失败时应抛出错误', async () => {
+    const mockVideo = document.createElement('video');
+    vi.spyOn(document, 'createElement').mockReturnValue(mockVideo);
+
+    const url = 'https://example.com/invalid.mp4';
+    const promise = videoLoad(url);
+
+    mockVideo.onerror?.({} as Event);
+
+    await expect(promise).rejects.toThrow('视频加载失败');
+  });
+});

package/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "jsx": "preserve",
+    "jsxImportSource": "vue",
+    "target": "ES2024",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+
+    "strict": true,
+    "noEmit": true,
+    "allowJs": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "verbatimModuleSyntax": true,
+    "allowImportingTsExtensions": false,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+
+    "lib": ["ES2024", "DOM"],
+    "types": ["node", "vite/client", "vitest/globals"],
+    "plugins": [],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+
+  "include": ["**/*.ts", "**/.*.ts", "**/*.mts", "**/*.tsx", "**/*.vue"],
+  "exclude": []
+}

package/vite.config.mts

@@ -0,0 +1,100 @@
+/**
+ * @file vite.config.mts
+ * @ref https://vitejs.dev/
+ */
+
+import dts from 'vite-plugin-dts';
+import { externalizeDeps } from 'vite-plugin-externalize-deps';
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+import pkg from './package.json';
+
+export default defineConfig((env) => {
+  const isProd = env.mode === 'production';
+  const isTest = env.mode === 'test';
+
+  return {
+    base: '/',
+    server: {
+      port: 15170,
+    },
+    preview: {
+      port: 15171,
+    },
+    define: {
+      PKG_NAME: JSON.stringify(isTest ? 'pkg-name-for-test' : pkg.name),
+      PKG_VERSION: JSON.stringify(isTest ? 'pkg-version-for-test' : pkg.version),
+      PKG_DESCRIPTION: JSON.stringify(isTest ? 'pkg-description-for-test' : pkg.description),
+      IS_TEST: JSON.stringify(isTest),
+    },
+    build: {
+      minify: false,
+      sourcemap: true,
+      copyPublicDir: false,
+      reportCompressedSize: false,
+      lib: {
+        entry:
+          // expose-start
+          {
+            index: 'src/index.ts',
+            base64: './src/base64.ts',
+            cache: './src/cache.ts',
+            canvas: './src/canvas.ts',
+            clipboard: './src/clipboard.ts',
+            cookie: './src/cookie.ts',
+            dom: './src/dom.ts',
+            download: './src/download.ts',
+            image: './src/image.ts',
+            timer: './src/timer.ts',
+            video: './src/video.ts',
+          },
+        // expose-end
+      },
+      rollupOptions: {
+        output: [
+          {
+            format: 'esm',
+            entryFileNames: '[name].mjs',
+            chunkFileNames: '[name].mjs',
+          },
+          {
+            format: 'cjs',
+            entryFileNames: '[name].cjs',
+            chunkFileNames: '[name].cjs',
+          },
+        ],
+      },
+    },
+    test: {
+      globals: true,
+      environment: 'jsdom',
+      environmentOptions: {
+        jsdom: {
+          // 加载外部资源
+          resources: 'usable',
+        },
+      },
+      coverage: {
+        all: true,
+        include: ['src/**/*.ts'],
+        reporter: ['lcov', 'text'],
+      },
+    },
+    // esbuild: {
+    //   drop: isProd ? ['console', 'debugger'] : [],
+    // },
+    plugins: [
+      tsconfigPaths(),
+      externalizeDeps({
+        deps: true,
+        devDeps: true,
+        peerDeps: true,
+        optionalDeps: true,
+        nodeBuiltins: true,
+      }),
+      dts({
+        include: 'src',
+      }),
+    ],
+  };
+});

package/dist/base64.cjs

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-function encodeBase64(input) {
-  const encoder = new TextEncoder();
-  const unit8Array = encoder.encode(input);
-  return btoa(String.fromCharCode(...unit8Array));
-}
-function decodeBase64(input) {
-  const decoder = new TextDecoder();
-  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));
-  return decoder.decode(unit8Array);
-}
-exports.decodeBase64 = decodeBase64;
-exports.encodeBase64 = encodeBase64;
-//# sourceMappingURL=base64.cjs.map

package/dist/base64.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"base64.cjs","sources":["../src/base64.ts"],"sourcesContent":["// @ref https://blog.csdn.net/m0_72642319/article/details/139743196\n\n/**\n * 【浏览器环境】将字符串编码为 Base64 格式\n * @param input 要编码的字符串\n * @returns 编码后的 Base64 字符串\n * @remarks\n * 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现\n */\nexport function encodeBase64(input: string) {\n  const encoder = new TextEncoder();\n  const unit8Array = encoder.encode(input);\n  return btoa(String.fromCharCode(...unit8Array));\n}\n\n/**\n * 【浏览器环境】 将 Base64 字符串解码为原始字符串\n * @param input 要解码的 Base64 字符串\n * @returns 解码后的原始字符串\n */\nexport function decodeBase64(input: string) {\n  const decoder = new TextDecoder();\n  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));\n  return decoder.decode(unit8Array);\n}\n"],"names":[],"mappings":";;AASO,SAAS,aAAa,OAAe;AACpC,QAAA,UAAU,IAAI,YAAY;AAC1B,QAAA,aAAa,QAAQ,OAAO,KAAK;AACvC,SAAO,KAAK,OAAO,aAAa,GAAG,UAAU,CAAC;AAChD;AAOO,SAAS,aAAa,OAAe;AACpC,QAAA,UAAU,IAAI,YAAY;AAC1B,QAAA,aAAa,WAAW,KAAK,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC/D,SAAA,QAAQ,OAAO,UAAU;AAClC;;;"}

package/dist/base64.d.ts

@@ -1,14 +0,0 @@
-/**
- * 【浏览器环境】将字符串编码为 Base64 格式
- * @param input 要编码的字符串
- * @returns 编码后的 Base64 字符串
- * @remarks
- * 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现
- */
-export declare function encodeBase64(input: string): string;
-/**
- * 【浏览器环境】 将 Base64 字符串解码为原始字符串
- * @param input 要解码的 Base64 字符串
- * @returns 解码后的原始字符串
- */
-export declare function decodeBase64(input: string): string;

package/dist/base64.mjs

@@ -1,15 +0,0 @@
-function encodeBase64(input) {
-  const encoder = new TextEncoder();
-  const unit8Array = encoder.encode(input);
-  return btoa(String.fromCharCode(...unit8Array));
-}
-function decodeBase64(input) {
-  const decoder = new TextDecoder();
-  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));
-  return decoder.decode(unit8Array);
-}
-export {
-  decodeBase64,
-  encodeBase64
-};
-//# sourceMappingURL=base64.mjs.map

package/dist/base64.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"base64.mjs","sources":["../src/base64.ts"],"sourcesContent":["// @ref https://blog.csdn.net/m0_72642319/article/details/139743196\n\n/**\n * 【浏览器环境】将字符串编码为 Base64 格式\n * @param input 要编码的字符串\n * @returns 编码后的 Base64 字符串\n * @remarks\n * 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现\n */\nexport function encodeBase64(input: string) {\n  const encoder = new TextEncoder();\n  const unit8Array = encoder.encode(input);\n  return btoa(String.fromCharCode(...unit8Array));\n}\n\n/**\n * 【浏览器环境】 将 Base64 字符串解码为原始字符串\n * @param input 要解码的 Base64 字符串\n * @returns 解码后的原始字符串\n */\nexport function decodeBase64(input: string) {\n  const decoder = new TextDecoder();\n  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));\n  return decoder.decode(unit8Array);\n}\n"],"names":[],"mappings":"AASO,SAAS,aAAa,OAAe;AACpC,QAAA,UAAU,IAAI,YAAY;AAC1B,QAAA,aAAa,QAAQ,OAAO,KAAK;AACvC,SAAO,KAAK,OAAO,aAAa,GAAG,UAAU,CAAC;AAChD;AAOO,SAAS,aAAa,OAAe;AACpC,QAAA,UAAU,IAAI,YAAY;AAC1B,QAAA,aAAa,WAAW,KAAK,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC/D,SAAA,QAAQ,OAAO,UAAU;AAClC;"}

package/dist/cache.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.cjs","sources":["../src/cache.ts"],"sourcesContent":["import { AbstractCache, type TCacheOptions, type TCached } 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): TCached<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?: TCacheOptions) {\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":["AbstractCache"],"mappings":";;;AAOO,MAAM,qBAAwBA,MAAAA,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,IAA+B;AAC3B,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,SAAyB;AAC1C,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,SAAQ,mCAAS,WAAU;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;;;;"}

package/dist/cache.d.ts

@@ -1,49 +0,0 @@
-import { AbstractCache, TCacheOptions, TCached } from '@cloudcome/utils-core/cache';
-/**
- * 使用浏览器存储（localStorage 或 sessionStorage）实现的缓存类
- * @template T - 缓存数据的类型
- */
-export declare class StorageCache<T> extends AbstractCache<T> {
-    readonly storage: Storage;
-    readonly namespace: string;
-    /**
-     * 创建一个新的 StorageCache 实例
-     * @param storage - 使用的存储实现（localStorage 或 sessionStorage）
-     * @param namespace - 可选，用于为缓存键添加前缀的命名空间
-     */
-    constructor(storage: Storage, namespace?: string);
-    /**
-     * 通过ID获取缓存数据
-     * @param id - 要获取的缓存键
-     * @returns 如果找到且未过期则返回缓存数据，否则返回null
-     */
-    get(id: string): TCached<T> | null;
-    /**
-     * 将数据存储到缓存中
-     * @param id - 存储数据使用的缓存键
-     * @param data - 要缓存的数据
-     * @param options - 可选的缓存配置
-     * @returns 成功返回true，存储失败返回false
-     */
-    set(id: string, data: T, options?: TCacheOptions): void;
-    /**
-     * 通过ID删除缓存数据
-     * @param id - 要删除的缓存键
-     */
-    del(id: string): void;
-    clear(): void;
-}
-/**
- * 创建一个使用 localStorage 的缓存实例
- * @template T - 缓存数据的类型
- * @param namespace - 可选，用于为缓存键添加前缀的命名空间
- * @returns 使用 localStorage 的新 StorageCache 实例
- */
-export declare function createLocalCache<T>(namespace?: string): AbstractCache<T>;
-/**
- * 创建一个使用 sessionStorage 的缓存实例
- * @template T - 缓存数据的类型
- * @param namespace - 可选，用于为缓存键添加前缀的命名空间
- * @returns 使用 sessionStorage 的新 StorageCache 实例
- */
-export declare function createSessionCache<T>(namespace?: string): AbstractCache<T>;

package/dist/cache.mjs

@@ -1,87 +0,0 @@
-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 == null ? void 0 : 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) {
-    }
-  }
-}
-function createLocalCache(namespace) {
-  return new StorageCache(localStorage, namespace);
-}
-function createSessionCache(namespace) {
-  return new StorageCache(sessionStorage, namespace);
-}
-export {
-  StorageCache,
-  createLocalCache,
-  createSessionCache
-};
-//# sourceMappingURL=cache.mjs.map

package/dist/cache.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.mjs","sources":["../src/cache.ts"],"sourcesContent":["import { AbstractCache, type TCacheOptions, type TCached } 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): TCached<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?: TCacheOptions) {\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,IAA+B;AAC3B,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,SAAyB;AAC1C,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,SAAQ,mCAAS,WAAU;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;"}

package/dist/canvas.cjs

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const object = require("@cloudcome/utils-core/object");
-const image = require("./image.cjs");
-function canvasToBase64(canvas, type, quality) {
-  return canvas.toDataURL(type, quality);
-}
-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
-    );
-  });
-}
-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
-  );
-}
-exports.canvasDrawImage = canvasDrawImage;
-exports.canvasToBase64 = canvasToBase64;
-exports.canvasToBlob = canvasToBlob;
-//# sourceMappingURL=canvas.cjs.map

package/dist/canvas.cjs.map

@@ -1 +0,0 @@
-{"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;;;;"}