@cbjwwwcode/common 0.1.0 → 0.1.1

package/dist/es/cn.d.mts

@@ -0,0 +1,5 @@
+import { ClassValue } from "clsx";
+//#region src/cn.d.ts
+declare function cn(...inputs: ClassValue[]): string;
+//#endregion
+export { cn };

package/dist/es/cn.mjs

@@ -0,0 +1,8 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+//#region src/cn.ts
+function cn(...inputs) {
+	return twMerge(clsx(inputs));
+}
+//#endregion
+export { cn };

package/dist/es/common.d.mts

@@ -17,4 +17,5 @@ export declare function makeUuid(): string;
 export declare function createFunction<T extends object = any>(code: string, scope: T): any;
 export declare function makeVueId(prefix?: string, suffix?: string): string;
 export declare function isHttpUrl<T extends string>(str: T): boolean;
+export declare function isVueComponent(val: unknown): val is Component;
 //#endregion

package/dist/es/common.mjs

@@ -108,5 +108,15 @@ function isHttpUrl(str) {
 		return false;
 	}
 }
+/**
+* 判断是否为Vue组件定义
+*/
+function isVueComponent(val) {
+	if (typeof val !== "object" || val === null) return false;
+	const hasRender = "render" in val && typeof val.render === "function";
+	const hasSetup = "setup" in val && typeof val.setup === "function";
+	if (typeof val === "function" && "__asyncLoader" in val) return true;
+	return hasRender || hasSetup;
+}
 //#endregion
-export { createFunction, determineTextColor, hasProperty, isComponentRegistered, isHttpUrl, isStringNumber, keepProps, makeRawComponent, makeUuid, makeVueId, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, randomId, transformPx };
+export { createFunction, determineTextColor, hasProperty, isComponentRegistered, isHttpUrl, isStringNumber, isVueComponent, keepProps, makeRawComponent, makeUuid, makeVueId, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, randomId, transformPx };

package/dist/es/copy.d.mts

@@ -11,4 +11,5 @@ export declare function useCopy(options?: UseCopyOptions): {
   copied: Readonly<import("vue").ShallowRef<boolean>>;
   isSupported: import("vue").ComputedRef<boolean>;
 };
-//#endregion
+//#endregion
+export {};

package/dist/es/copy.mjs

@@ -1,31 +1,51 @@
 import { toast } from "./toastify.mjs";
 import { useClipboard } from "@vueuse/core";
 //#region src/copy.ts
+function fallbackCopy(text) {
+	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);
+	});
+}
 function useCopy(options = {}) {
 	const { successMessage = "复制成功", errorMessage = "复制失败", showMessage = true, onSuccess, onError } = options;
 	const { copy, copied, isSupported } = useClipboard();
+	const doFallbackCopy = async (content, errorMessage) => {
+		try {
+			await fallbackCopy(content);
+			showMessage && toast.success(successMessage);
+			onSuccess?.(content);
+			return true;
+		} catch (error) {
+			showMessage && toast.warning(errorMessage);
+			onError?.(error);
+			return false;
+		}
+	};
 	/**
 	* 复制文本
 	*/
 	const handleCopy = async (text) => {
-		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);
-			return false;
+			return await doFallbackCopy(content, errorMessage);
 		}
 	};
 	return {

package/dist/es/download.d.mts

@@ -0,0 +1,16 @@
+//#region src/download.d.ts
+interface DownloadOptions<T = string> {
+  fileName?: string;
+  source: T;
+  target?: string;
+}
+export declare function downloadImageFromCanvas(canvas: HTMLCanvasElement, name: string, type?: string, quality?: number): void;
+export declare function downloadFileFromUrl({ fileName, source, target }: DownloadOptions): Promise<void>;
+export declare function downloadFileFromBase64({ fileName, source }: DownloadOptions): void;
+export declare function downloadFileFromImageUrl({ fileName, source }: DownloadOptions): Promise<void>;
+export declare function downloadFileFromBlob({ fileName, source }: DownloadOptions<Blob>): void;
+export declare function downloadFileFromBlobPart({ fileName, source }: DownloadOptions<BlobPart>): void;
+export declare function urlToBase64(url: string, mineType?: string): Promise<string>;
+export declare function triggerDownload(href: string, fileName: string | undefined, revokeDelay?: number): void;
+//#endregion
+export {};

package/dist/es/download.mjs

@@ -0,0 +1,103 @@
+import { openWindow } from "./window.mjs";
+//#region src/download.ts
+const DEFAULT_FILENAME = "downloaded_file";
+function downloadImageFromCanvas(canvas, name, type, quality) {
+	downloadFileFromUrl({
+		fileName: name,
+		source: canvas.toDataURL(type, quality)
+	});
+}
+/**
+* 通过 URL 下载文件，支持跨域
+* @throws {Error} - 当下载失败时抛出错误
+*/
+async function downloadFileFromUrl({ fileName, source, target = "_blank" }) {
+	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 下载文件
+*/
+function downloadFileFromBase64({ fileName, source }) {
+	if (!source || typeof source !== "string") throw new Error("Invalid Base64 data.");
+	triggerDownload(source, fileName || DEFAULT_FILENAME);
+}
+/**
+* 通过图片 URL 下载图片文件
+*/
+async function downloadFileFromImageUrl({ fileName, source }) {
+	downloadFileFromBase64({
+		fileName,
+		source: await urlToBase64(source)
+	});
+}
+/**
+* 通过 Blob 下载文件
+*/
+function downloadFileFromBlob({ fileName = DEFAULT_FILENAME, source }) {
+	if (!(source instanceof Blob)) throw new TypeError("Invalid Blob data.");
+	triggerDownload(URL.createObjectURL(source), fileName);
+}
+/**
+* 下载文件，支持 Blob、字符串和其他 BlobPart 类型
+*/
+function downloadFileFromBlobPart({ fileName = DEFAULT_FILENAME, source }) {
+	const blob = source instanceof Blob ? source : new Blob([source], { type: "application/octet-stream" });
+	triggerDownload(URL.createObjectURL(blob), fileName);
+}
+/**
+* img url to base64
+* @param url
+*/
+function urlToBase64(url, mineType) {
+	return new Promise((resolve, reject) => {
+		let canvas = document.createElement("CANVAS");
+		const ctx = canvas?.getContext("2d");
+		const img = new Image();
+		img.crossOrigin = "";
+		img.addEventListener("load", () => {
+			if (!canvas || !ctx) return reject(/* @__PURE__ */ 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 的延迟时间 (毫秒)
+*/
+function triggerDownload(href, fileName, revokeDelay = 100) {
+	const finalFileName = fileName || "downloaded_file";
+	const link = document.createElement("a");
+	link.href = href;
+	link.download = finalFileName;
+	link.style.display = "none";
+	if (link.download === void 0) link.setAttribute("target", "_blank");
+	document.body.append(link);
+	link.click();
+	link.remove();
+	setTimeout(() => URL.revokeObjectURL(href), revokeDelay);
+}
+function resolveFileName(url, fileName) {
+	return fileName || url.slice(url.lastIndexOf("/") + 1) || DEFAULT_FILENAME;
+}
+//#endregion
+export { downloadFileFromBase64, downloadFileFromBlob, downloadFileFromBlobPart, downloadFileFromImageUrl, downloadFileFromUrl, downloadImageFromCanvas, triggerDownload, urlToBase64 };

package/dist/es/index.d.mts

@@ -1,5 +1,5 @@
 import { $http, AlovaAxiosRequestConfig, ApiConfig, createClientTokenAuthentication, setupRequest, useCaptcha, useRequest, useUploader } from "./api.mjs";
-import { createFunction, determineTextColor, hasProperty, isComponentRegistered, isHttpUrl, isStringNumber, keepProps, makeRawComponent, makeUuid, makeVueId, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, randomId, transformPx } from "./common.mjs";
+import { createFunction, determineTextColor, hasProperty, isComponentRegistered, isHttpUrl, isStringNumber, isVueComponent, keepProps, makeRawComponent, makeUuid, makeVueId, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, randomId, transformPx } from "./common.mjs";
 import { CryptoJS, md5 } from "./crypto.mjs";
 import { dayjs, setDayjsLocale } from "./dayjs.mjs";
 import { Toolkit, isNotNil, isPromise } from "./es-toolkit.mjs";
@@ -11,15 +11,17 @@ import { VeeValidate } from "./vee-validate.mjs";
 import { Vue } from "./vue.mjs";
 import { VueRouter } from "./vue-router.mjs";
 import { VueUse, createGlobalState, createReusableTemplate, onClickOutside, useClipboard, useScriptTag, useStorage, useStyleTag, useToggle } from "./vueuse.mjs";
-import { $mitt, axios, isModuleObject, registerWindow } from "./window.mjs";
+import { $mitt, axios, isModuleObject, openRouteInNewWindow, openWindow, registerWindow } from "./window.mjs";
 import { zod } from "./zod.mjs";
 import { JsonNodeProps, setupJsonNode, useJsonNode } from "./vtj/node.mjs";
 import { BlockSchema, ContextMode, initProvider, useGlobalProvider, vtjSymbol } from "./vtj/provider.mjs";
 import { VtjCore, VtjRenderer, VtjUtils } from "./vtj/index.mjs";
-import hljs from "./lowlight/hljs.mjs";
+import core_default from "./lowlight/hljs.mjs";
 import { Lowlight, VueLowlight, highlightLanguages, lowlight } from "./lowlight/index.mjs";
 import { Hucre } from "./hucre.mjs";
 import { useCopy } from "./copy.mjs";
 import { FormatRule as Rules, esthetic, formatCode } from "./format.mjs";
 import { DOMConfig as Config, DOMPurify, toSafeHtml } from "./dompurify.mjs";
-export { $http, $mitt, AlovaAxiosRequestConfig, ApiConfig, type BlockSchema, ContextMode, CryptoJS, type Config as DOMConfig, DOMPurify, type Rules as FormatRule, Hucre, IDBKeyValReturn, IDBOptions, JsonNodeProps, Lowlight, type NProgress, type NProgressOptions, type Toast, ToastApi, type ToastOptions, Toolkit, type UseStore, VeeValidate, VtjCore, VtjRenderer, VtjUtils, Vue, VueLowlight, VueRouter, VueUse, axios, createClientTokenAuthentication, createFunction, createGlobalState, createNaiveStore, createReusableTemplate, dayjs, determineTextColor, esthetic, formatCode, hasProperty, highlightLanguages, hljs, idb, initProvider, isComponentRegistered, isHttpUrl, isModuleObject, isNotNil, isPromise, isStringNumber, keepProps, loadJsStore, loadRemoteModule, loaderScript, lowlight, makeRawComponent, makeUuid, makeVueId, md5, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, onClickOutside, randomId, registerWindow, setDayjsLocale, setupJsonNode, setupRequest, setupToast, toSafeHtml, toast, transformPx, useCaptcha, useClipboard, useCopy, useGlobalProvider, useIdb, useJsonNode, useProgress, useRequest, useScriptTag, useStorage, useStyleLink, useStyleTag, useToggle, useUploader, vtjSymbol, zod };
+import { downloadFileFromBase64, downloadFileFromBlob, downloadFileFromBlobPart, downloadFileFromImageUrl, downloadFileFromUrl, downloadImageFromCanvas, triggerDownload, urlToBase64 } from "./download.mjs";
+import { cn } from "./cn.mjs";
+export { $http, $mitt, AlovaAxiosRequestConfig, ApiConfig, type BlockSchema, ContextMode, CryptoJS, type Config as DOMConfig, DOMPurify, type Rules as FormatRule, Hucre, IDBKeyValReturn, IDBOptions, JsonNodeProps, Lowlight, type NProgress, type NProgressOptions, type Toast, ToastApi, type ToastOptions, Toolkit, type UseStore, VeeValidate, VtjCore, VtjRenderer, VtjUtils, Vue, VueLowlight, VueRouter, VueUse, axios, cn, createClientTokenAuthentication, createFunction, createGlobalState, createNaiveStore, createReusableTemplate, dayjs, determineTextColor, downloadFileFromBase64, downloadFileFromBlob, downloadFileFromBlobPart, downloadFileFromImageUrl, downloadFileFromUrl, downloadImageFromCanvas, esthetic, formatCode, hasProperty, highlightLanguages, core_default as hljs, idb, initProvider, isComponentRegistered, isHttpUrl, isModuleObject, isNotNil, isPromise, isStringNumber, isVueComponent, keepProps, loadJsStore, loadRemoteModule, loaderScript, lowlight, makeRawComponent, makeUuid, makeVueId, md5, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, onClickOutside, openRouteInNewWindow, openWindow, randomId, registerWindow, setDayjsLocale, setupJsonNode, setupRequest, setupToast, toSafeHtml, toast, transformPx, triggerDownload, urlToBase64, useCaptcha, useClipboard, useCopy, useGlobalProvider, useIdb, useJsonNode, useProgress, useRequest, useScriptTag, useStorage, useStyleLink, useStyleTag, useToggle, useUploader, vtjSymbol, zod };

package/dist/es/index.mjs

@@ -1,5 +1,5 @@
 import { $http, createClientTokenAuthentication, setupRequest, useCaptcha, useRequest, useUploader } from "./api.mjs";
-import { createFunction, determineTextColor, hasProperty, isComponentRegistered, isHttpUrl, isStringNumber, keepProps, makeRawComponent, makeUuid, makeVueId, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, randomId, transformPx } from "./common.mjs";
+import { createFunction, determineTextColor, hasProperty, isComponentRegistered, isHttpUrl, isStringNumber, isVueComponent, keepProps, makeRawComponent, makeUuid, makeVueId, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, randomId, transformPx } from "./common.mjs";
 import { CryptoJS, md5 } from "./crypto.mjs";
 import { Vue } from "./vue.mjs";
 import { VueRouter } from "./vue-router.mjs";
@@ -7,7 +7,7 @@ import { VueUse, createGlobalState, createReusableTemplate, onClickOutside, useC
 import { zod } from "./zod.mjs";
 import hljs_default from "./lowlight/hljs.mjs";
 import { VueLowlight, highlightLanguages, lowlight } from "./lowlight/index.mjs";
-import { $mitt, axios, isModuleObject, registerWindow } from "./window.mjs";
+import { $mitt, axios, isModuleObject, openRouteInNewWindow, openWindow, registerWindow } from "./window.mjs";
 import { dayjs, setDayjsLocale } from "./dayjs.mjs";
 import { Toolkit, isNotNil, isPromise } from "./es-toolkit.mjs";
 import { createNaiveStore, idb, loadJsStore, useIdb } from "./idb-keyval.mjs";
@@ -22,4 +22,6 @@ import { Hucre } from "./hucre.mjs";
 import { useCopy } from "./copy.mjs";
 import { esthetic, formatCode } from "./format.mjs";
 import { DOMPurify, toSafeHtml } from "./dompurify.mjs";
-export { $http, $mitt, ContextMode, CryptoJS, DOMPurify, Hucre, ToastApi, Toolkit, VeeValidate, VtjCore, VtjRenderer, VtjUtils, Vue, VueLowlight, VueRouter, VueUse, axios, createClientTokenAuthentication, createFunction, createGlobalState, createNaiveStore, createReusableTemplate, dayjs, determineTextColor, esthetic, formatCode, hasProperty, highlightLanguages, hljs_default as hljs, idb, initProvider, isComponentRegistered, isHttpUrl, isModuleObject, isNotNil, isPromise, isStringNumber, keepProps, loadJsStore, loadRemoteModule, loaderScript, lowlight, makeRawComponent, makeUuid, makeVueId, md5, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, onClickOutside, randomId, registerWindow, setDayjsLocale, setupJsonNode, setupRequest, setupToast, toSafeHtml, toast, transformPx, useCaptcha, useClipboard, useCopy, useGlobalProvider, useIdb, useJsonNode, useProgress, useRequest, useScriptTag, useStorage, useStyleLink, useStyleTag, useToggle, useUploader, vtjSymbol, zod };
+import { downloadFileFromBase64, downloadFileFromBlob, downloadFileFromBlobPart, downloadFileFromImageUrl, downloadFileFromUrl, downloadImageFromCanvas, triggerDownload, urlToBase64 } from "./download.mjs";
+import { cn } from "./cn.mjs";
+export { $http, $mitt, ContextMode, CryptoJS, DOMPurify, Hucre, ToastApi, Toolkit, VeeValidate, VtjCore, VtjRenderer, VtjUtils, Vue, VueLowlight, VueRouter, VueUse, axios, cn, createClientTokenAuthentication, createFunction, createGlobalState, createNaiveStore, createReusableTemplate, dayjs, determineTextColor, downloadFileFromBase64, downloadFileFromBlob, downloadFileFromBlobPart, downloadFileFromImageUrl, downloadFileFromUrl, downloadImageFromCanvas, esthetic, formatCode, hasProperty, highlightLanguages, hljs_default as hljs, idb, initProvider, isComponentRegistered, isHttpUrl, isModuleObject, isNotNil, isPromise, isStringNumber, isVueComponent, keepProps, loadJsStore, loadRemoteModule, loaderScript, lowlight, makeRawComponent, makeUuid, makeVueId, md5, mergeOmitBy, mergePropsOmitBy, mergeUrlWithParams, onClickOutside, openRouteInNewWindow, openWindow, randomId, registerWindow, setDayjsLocale, setupJsonNode, setupRequest, setupToast, toSafeHtml, toast, transformPx, triggerDownload, urlToBase64, useCaptcha, useClipboard, useCopy, useGlobalProvider, useIdb, useJsonNode, useProgress, useRequest, useScriptTag, useStorage, useStyleLink, useStyleTag, useToggle, useUploader, vtjSymbol, zod };

package/dist/es/lowlight/hljs.d.mts

@@ -1,2 +1,2 @@
-import hljs$1 from "highlight.js/lib/core";
-export { hljs$1 as default };
+import core_default from "highlight.js/lib/core";
+export { core_default as default };

package/dist/es/lowlight/index.d.mts

@@ -1,5 +1,5 @@
 import { createLowlight } from "./lowlights.mjs";
-import hljs from "./hljs.mjs";
+import core_default from "./hljs.mjs";
 import "highlight.js/styles/atom-one-dark.min.css";
 //#region src/lowlight/index.d.ts
 export declare const highlightLanguages: string[];
@@ -156,4 +156,4 @@ export declare const VueLowlight: {
 };
 export type Lowlight = typeof lowlight;
 //#endregion
-export { hljs };
+export { core_default as hljs };

package/dist/es/vtj/node.d.mts

@@ -30,4 +30,5 @@ export declare const setupJsonNode: (props: JsonNodeProps) => {
 };
 declare type JsonNodeType = ReturnType<typeof setupJsonNode>;
 export declare const useJsonNode: () => JsonNodeType;
-//#endregion
+//#endregion
+export {};

package/dist/es/window.d.mts

@@ -3,5 +3,12 @@ import axios$1 from "axios";
 export declare const $mitt: import("mitt").Emitter<Record<import("mitt").EventType, unknown>>;
 export declare function isModuleObject(value: unknown): value is Record<string, any>;
 export declare function registerWindow<T extends any>(key: string, value: T): void;
+interface OpenWindowOptions {
+  noopener?: boolean;
+  noreferrer?: boolean;
+  target?: '_blank' | '_parent' | '_self' | '_top' | string;
+}
+declare function openWindow(url: string, options?: OpenWindowOptions): void;
+declare function openRouteInNewWindow(path: string): void;
 //#endregion
-export { axios$1 as axios };
+export { axios$1 as axios, openRouteInNewWindow, openWindow };

package/dist/es/window.mjs

@@ -35,5 +35,25 @@ registerWindow("CryptoJS", CryptoJS);
 registerWindow("VueLowlight", VueLowlight);
 registerWindow("hljs", hljs_default);
 registerWindow("process", { env: { NODE_ENV: "production" } });
+/**
+* 新窗口打开URL。
+*
+* @param url - 需要打开的网址。
+* @param options - 打开窗口的选项。
+*/
+function openWindow(url, options = {}) {
+	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) {
+	const { hash, origin } = location;
+	const fullPath = path.startsWith("/") ? path : `/${path}`;
+	openWindow(`${origin}${hash && !fullPath.startsWith("/#") ? "/#" : ""}${fullPath}`, { target: "_blank" });
+}
 //#endregion
-export { $mitt, axios$1 as axios, isModuleObject, registerWindow };
+export { $mitt, axios$1 as axios, isModuleObject, openRouteInNewWindow, openWindow, registerWindow };