@cbjwwwcode/common 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cbjwwwcode/common",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "",
   "keywords": [],
   "license": "ISC",
@@ -32,16 +32,16 @@
     "./umd/": "./dist/umd/"
   },
   "devDependencies": {
-    "@tsdown/css": "^0.23.0",
+    "@tsdown/css": "^0.23.1",
     "@types/crypto-js": "^4.2.2",
-    "@types/node": "^26.6.4",
+    "@types/node": "^26.6.5",
     "@types/nprogress": "^0.2.3",
-    "concurrently": "^10.0.5",
+    "concurrently": "^10.0.6",
     "laravel-vite-plugin": "^3.2.0",
     "rollup-plugin-bundle-stats": "^4.22.3",
     "sass": "^1.105.1",
     "sonda": "^0.14.0",
-    "tsdown": "^0.23.0",
+    "tsdown": "^0.23.1",
     "typescript": "^6.0.3",
     "unplugin-vue": "^7.2.0",
     "vite": "8.3.0",
@@ -53,33 +53,35 @@
   },
   "dependencies": {
     "@alova/adapter-axios": "^2.0.20",
-    "@vtj/core": "^0.20.6",
-    "@vtj/parser": "^0.20.6",
-    "@vtj/renderer": "^0.20.6",
-    "@vtj/utils": "^0.20.6",
+    "@vtj/core": "^0.20.7",
+    "@vtj/parser": "^0.20.7",
+    "@vtj/renderer": "^0.20.7",
+    "@vtj/utils": "^0.20.7",
     "@vueuse/core": "^14.4.0",
     "@vueuse/integrations": "^14.4.0",
     "aieditor": "^2.0.0",
     "alova": "^3.5.5",
     "axios": "^1.20.0",
+    "clsx": "catalog:",
     "crypto-js": "^4.2.0",
     "dayjs": "^1.11.23",
     "dompurify": "^3.4.16",
     "es-toolkit": "^1.52.0",
     "esthetic": "0.6.4-beta.1",
     "highlight.js": "^11.12.0",
-    "hucre": "^1.1.0",
+    "hucre": "^1.2.0",
     "idb-keyval": "^6.3.0",
     "jsbarcode": "^3.12.3",
     "mitt": "^3.0.1",
-    "motion-v": "^2.5.2",
+    "motion-v": "^2.6.0",
     "nprogress": "^0.2.0",
     "path-browserify": "^1.0.1",
+    "tailwind-merge": "catalog:",
     "vee-validate": "^4.15.1",
     "vue": "3.6.0-rc.2",
     "vue-demi": "^0.14.10",
-    "vue-router": "^5.3.1",
+    "vue-router": "^5.4.0",
     "vue3-toastify": "^0.2.9",
-    "zod": "^4.6.5"
+    "zod": "^4.6.6"
   }
 }

package/src/cn.ts

@@ -0,0 +1,10 @@
+import type { ClassValue } from 'clsx';
+
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+
+export { cn };

package/src/common.ts

@@ -199,3 +199,15 @@ export function isHttpUrl<T extends string>(str: T) {
 
 
 
+/**
+ * 判断是否为Vue组件定义
+ */
+export function isVueComponent(val: unknown): val is Component {
+  if (typeof val !== 'object' || val === null) return false
+  // 1. 有 render / setup 函数（SFC编译后组件）
+  const hasRender = 'render' in val && typeof (val as any).render === 'function'
+  const hasSetup = 'setup' in val && typeof (val as any).setup === 'function'
+  // 2. 异步组件是函数，带 __asyncLoader 标记
+  if (typeof val === 'function' && '__asyncLoader' in val) return true
+  return hasRender || hasSetup
+}

package/src/copy.ts

@@ -9,6 +9,21 @@ interface UseCopyOptions {
   onError?: (error: Error) => void
 }
 
+// 降级方案：创建临时textarea
+function fallbackCopy(text: string): Promise<boolean> {
+  return new Promise((resolve) => {
+    const textarea = document.createElement('textarea');
+    textarea.value = text;
+    textarea.style.position = 'fixed';
+    textarea.style.opacity = '0';
+    document.body.appendChild(textarea);
+    textarea.select();
+    const result = document.execCommand('copy');
+    document.body.removeChild(textarea);
+    resolve(result);
+  })
+}
+
 export function useCopy(options: UseCopyOptions = {}) {
   const {
     successMessage = '复制成功',
@@ -20,31 +35,40 @@ export function useCopy(options: UseCopyOptions = {}) {
 
   const { copy, copied, isSupported } = useClipboard()
 
+  const doFallbackCopy = async (content: string, errorMessage: string)=>{
+    try {
+      await fallbackCopy(content)
+      showMessage && toast.success(successMessage)
+      onSuccess?.(content)
+      return true
+    } catch (error) {
+      showMessage && toast.warning(errorMessage)
+      onError?.(error as Error)
+      return false
+    }
+  }
+
   /**
    * 复制文本
    */
   const handleCopy = async (text: string | number): Promise<boolean> => {
-    if (!isSupported.value) {
-      showMessage && toast.warning('当前环境不支持复制')
-      return false
-    }
-
     const content = String(text ?? '')
-
     if (!content) {
       showMessage && toast.warning('复制内容为空')
       return false
     }
 
+    if (!isSupported.value) {
+      return await doFallbackCopy(content, '当前环境不支持复制')
+    }
+
     try {
       await copy(content)
       showMessage && toast.success(successMessage)
       onSuccess?.(content)
       return true
     } catch (error) {
-      showMessage && toast.error(errorMessage)
-      onError?.(error as Error)
-      return false
+      return await doFallbackCopy(content, errorMessage)
     }
   }
 

package/src/download.ts

@@ -0,0 +1,165 @@
+import { openWindow } from './window';
+
+interface DownloadOptions<T = string> {
+  fileName?: string;
+  source: T;
+  target?: string;
+}
+
+const DEFAULT_FILENAME = 'downloaded_file';
+
+ 
+
+export function downloadImageFromCanvas(canvas: HTMLCanvasElement, name: string, type?:string, quality?: number){
+  const url = canvas.toDataURL(type, quality);
+  downloadFileFromUrl({ fileName: name, source: url }); 
+}
+
+
+/**
+ * 通过 URL 下载文件，支持跨域
+ * @throws {Error} - 当下载失败时抛出错误
+ */
+export async function downloadFileFromUrl({
+                                            fileName,
+                                            source,
+                                            target = '_blank',
+                                          }: DownloadOptions): Promise<void> {
+  if (!source || typeof source !== 'string') {
+    throw new Error('Invalid URL.');
+  }
+
+  const isChrome = window.navigator.userAgent.toLowerCase().includes('chrome');
+  const isSafari = window.navigator.userAgent.toLowerCase().includes('safari');
+
+  if (/iP/.test(window.navigator.userAgent)) {
+    console.error('Your browser does not support download!');
+    return;
+  }
+
+  if (isChrome || isSafari) {
+    triggerDownload(source, resolveFileName(source, fileName));
+    return;
+  }
+  if (!source.includes('?')) {
+    source += '?download';
+  }
+
+  openWindow(source, { target });
+}
+
+/**
+ * 通过 Base64 下载文件
+ */
+export function downloadFileFromBase64({ fileName, source }: DownloadOptions) {
+  if (!source || typeof source !== 'string') {
+    throw new Error('Invalid Base64 data.');
+  }
+
+  const resolvedFileName = fileName || DEFAULT_FILENAME;
+  triggerDownload(source, resolvedFileName);
+}
+
+/**
+ * 通过图片 URL 下载图片文件
+ */
+export async function downloadFileFromImageUrl({
+                                                 fileName,
+                                                 source,
+                                               }: DownloadOptions) {
+  const base64 = await urlToBase64(source);
+  downloadFileFromBase64({ fileName, source: base64 });
+}
+
+/**
+ * 通过 Blob 下载文件
+ */
+export function downloadFileFromBlob({
+                                       fileName = DEFAULT_FILENAME,
+                                       source,
+                                     }: DownloadOptions<Blob>): void {
+  if (!(source instanceof Blob)) {
+    throw new TypeError('Invalid Blob data.');
+  }
+
+  const url = URL.createObjectURL(source);
+  triggerDownload(url, fileName);
+}
+
+/**
+ * 下载文件，支持 Blob、字符串和其他 BlobPart 类型
+ */
+export function downloadFileFromBlobPart({
+                                           fileName = DEFAULT_FILENAME,
+                                           source,
+                                         }: DownloadOptions<BlobPart>): void {
+  // 如果 data 不是 Blob，则转换为 Blob
+  const blob =
+    source instanceof Blob
+      ? source
+      : new Blob([source], { type: 'application/octet-stream' });
+
+  // 创建对象 URL 并触发下载
+  const url = URL.createObjectURL(blob);
+  triggerDownload(url, fileName);
+}
+
+/**
+ * img url to base64
+ * @param url
+ */
+export function urlToBase64(url: string, mineType?: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    let canvas = document.createElement('CANVAS') as HTMLCanvasElement | null;
+    const ctx = canvas?.getContext('2d');
+    const img = new Image();
+    img.crossOrigin = '';
+    img.addEventListener('load', () => {
+      if (!canvas || !ctx) {
+        return reject(new Error('Failed to create canvas.'));
+      }
+      canvas.height = img.height;
+      canvas.width = img.width;
+      ctx.drawImage(img, 0, 0);
+      const dataURL = canvas.toDataURL(mineType || 'image/png');
+      canvas = null;
+      resolve(dataURL);
+    });
+    img.src = url;
+  });
+}
+
+/**
+ * 通用下载触发函数
+ * @param href - 文件下载的 URL
+ * @param fileName - 下载文件的名称，如果未提供则自动识别
+ * @param revokeDelay - 清理 URL 的延迟时间 (毫秒)
+ */
+export function triggerDownload(
+  href: string,
+  fileName: string | undefined,
+  revokeDelay: number = 100,
+): void {
+  const defaultFileName = 'downloaded_file';
+  const finalFileName = fileName || defaultFileName;
+
+  const link = document.createElement('a');
+  link.href = href;
+  link.download = finalFileName;
+  link.style.display = 'none';
+
+  if (link.download === undefined) {
+    link.setAttribute('target', '_blank');
+  }
+
+  document.body.append(link);
+  link.click();
+  link.remove();
+
+  // 清理临时 URL 以释放内存
+  setTimeout(() => URL.revokeObjectURL(href), revokeDelay);
+}
+
+function resolveFileName(url: string, fileName?: string): string {
+  return fileName || url.slice(url.lastIndexOf('/') + 1) || DEFAULT_FILENAME;
+}

package/src/index.ts

@@ -21,4 +21,6 @@ export * from './hucre';
 export * from './copy';
 export * from './format';
 export * from './dompurify';
+export * from './download';
+export * from './cn';
 

package/src/window.ts

@@ -58,3 +58,41 @@ registerWindow('process', {
 });
 
 
+interface OpenWindowOptions {
+  noopener?: boolean;
+  noreferrer?: boolean;
+  target?: '_blank' | '_parent' | '_self' | '_top' | string;
+}
+
+/**
+ * 新窗口打开URL。
+ *
+ * @param url - 需要打开的网址。
+ * @param options - 打开窗口的选项。
+ */
+function openWindow(url: string, options: OpenWindowOptions = {}): void {
+  // 解构并设置默认值
+  const { noopener = true, noreferrer = true, target = '_blank' } = options;
+
+  // 基于选项创建特性字符串
+  const features = [noopener && 'noopener=yes', noreferrer && 'noreferrer=yes']
+    .filter(Boolean)
+    .join(',');
+
+  // 打开窗口
+  window.open(url, target, features);
+}
+
+/**
+ * 在新窗口中打开路由。
+ * @param path
+ */
+function openRouteInNewWindow(path: string) {
+  const { hash, origin } = location;
+  const fullPath = path.startsWith('/') ? path : `/${path}`;
+  const url = `${origin}${hash && !fullPath.startsWith('/#') ? '/#' : ''}${fullPath}`;
+  openWindow(url, { target: '_blank' });
+}
+
+export { openRouteInNewWindow, openWindow };
+