@gct-paas/core 0.1.4-dev.11 → 0.1.4-dev.13

package/es/utils/axios/interceptors.mjs

@@ -1,20 +1,24 @@
-import { AxiosHeaders } from 'axios';
-import { getTimezone, getTenant, isMobile, getToken } from '../tools/tools.mjs';
-
+import { getTenant, getTimezone, getToken, isMobile } from "../tools/tools.mjs";
+import { AxiosHeaders } from "axios";
+//#region src/utils/axios/interceptors.ts
+/**
+* 安装拦截器
+*
+* @export
+* @param {AxiosInstance} axios
+*/
 function interceptors(axios) {
-  axios.interceptors.request.use((config) => {
-    if (!config.headers) {
-      config.headers = new AxiosHeaders();
-    }
-    Object.assign(config.headers, {
-      Token: getToken(),
-      Source: isMobile ? 502 : 501,
-      Lang: _gct.store.lang,
-      "Tenant-Id": getTenant(),
-      Timezone: getTimezone()
-    });
-    return config;
-  });
+	axios.interceptors.request.use((config) => {
+		if (!config.headers) config.headers = new AxiosHeaders();
+		Object.assign(config.headers, {
+			Token: getToken(),
+			Source: isMobile ? 502 : 501,
+			Lang: _gct.store.lang,
+			"Tenant-Id": getTenant(),
+			Timezone: getTimezone()
+		});
+		return config;
+	});
 }
-
+//#endregion
 export { interceptors };

package/es/utils/cache-adapter/cache-adapter.mjs

@@ -1,59 +1,64 @@
-import qs from 'qs';
-
-const gctMemoizeAsync = (...arg) => cacheAdapter.bind(null, ...arg);
+import qs from "qs";
+//#region src/utils/cache-adapter/cache-adapter.ts
+/**异步缓存函数 */
+var gctMemoizeAsync = (...arg) => cacheAdapter.bind(null, ...arg);
+/**
+*异步缓存
+* @param args
+* @param adapter
+* @returns
+*/
 function cacheAdapter(adapter, ...args) {
-  const maxAge = 1e3 * 60 * 5;
-  const requestKey = typeof args === "object" ? qs.stringify(args) : args;
-  let responsePromise = MemoryCache.get(requestKey);
-  if (!responsePromise) {
-    responsePromise = (async () => {
-      try {
-        return await adapter(...args);
-      } catch (reason) {
-        MemoryCache.delete(requestKey);
-        throw reason;
-      }
-    })();
-    MemoryCache.set(requestKey, responsePromise, maxAge);
-    return responsePromise;
-  }
-  return responsePromise;
+	/**默认缓存5分钟 */
+	const maxAge = 1e3 * 60 * 5;
+	const requestKey = typeof args === "object" ? qs.stringify(args) : args;
+	let responsePromise = MemoryCache.get(requestKey);
+	if (!responsePromise) {
+		responsePromise = (async () => {
+			try {
+				return await adapter(...args);
+			} catch (reason) {
+				MemoryCache.delete(requestKey);
+				throw reason;
+			}
+		})();
+		MemoryCache.set(requestKey, responsePromise, maxAge);
+		return responsePromise;
+	}
+	return responsePromise;
 }
-class MemoryCache {
-  static cachedata = {};
-  static set(key, value, maxAge) {
-    this.cachedata[key] = {
-      maxAge: maxAge || 0,
-      value,
-      now: Date.now()
-    };
-  }
-  static get(key) {
-    this.reset();
-    const cachedItem = this.cachedata[key];
-    if (!cachedItem) return null;
-    return cachedItem.value;
-  }
-  static delete(key) {
-    return delete this.cachedata[key];
-  }
-  static clear() {
-    this.cachedata = {};
-  }
-  /**
-   *清空过期的数据
-   */
-  static reset() {
-    for (const key in this.cachedata) {
-      const cachedItem = this.cachedata[key];
-      if (cachedItem) {
-        const isExpired = Date.now() - cachedItem.now > cachedItem.maxAge;
-        if (isExpired) {
-          this.delete(key);
-        }
-      }
-    }
-  }
-}
-
+var MemoryCache = class {
+	static cachedata = {};
+	static set(key, value, maxAge) {
+		this.cachedata[key] = {
+			maxAge: maxAge || 0,
+			value,
+			now: Date.now()
+		};
+	}
+	static get(key) {
+		this.reset();
+		const cachedItem = this.cachedata[key];
+		if (!cachedItem) return null;
+		return cachedItem.value;
+	}
+	static delete(key) {
+		return delete this.cachedata[key];
+	}
+	static clear() {
+		this.cachedata = {};
+	}
+	/**
+	*清空过期的数据
+	*/
+	static reset() {
+		for (const key in this.cachedata) {
+			const cachedItem = this.cachedata[key];
+			if (cachedItem) {
+				if (Date.now() - cachedItem.now > cachedItem.maxAge) this.delete(key);
+			}
+		}
+	}
+};
+//#endregion
 export { gctMemoizeAsync };

package/es/utils/css-loader/css-loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CSS 动态加载工具类
+ *
+ * 从 CDN 动态加载 CSS 文件，具备以下特性：
+ * - 已成功加载的路径永久缓存，避免重复插入 link 标签
+ * - 同一时刻对同一路径的多次调用共享同一个 Promise（请求去重）
+ * - 加载失败不写入缓存，允许下次重试
+ * - 加载前检查 DOM 中是否已存在相同 href 的 link 标签
+ *
+ * @author chitanda
+ * @date 2026-03-16
+ * @class CssLoader
+ */
+declare class CssLoader {
+    /** 已成功加载的 CSS URL 集合（永久缓存） */
+    private _loadedSet;
+    /** 正在加载中的 CSS URL 对应的 Promise（用于请求去重） */
+    private _pendingMap;
+    /**
+     * 动态加载单个 CSS 文件
+     *
+     * @param {string} url CSS 文件的完整 URL
+     * @returns {Promise<void>} 加载完成后 resolve；加载失败则 reject
+     */
+    load(url: string): Promise<void>;
+    /**
+     * 并发加载多个 CSS 文件
+     *
+     * @param {string[]} urls CSS 文件 URL 列表
+     * @returns {Promise<void>} 所有文件均加载完成后 resolve；任一失败则 reject
+     */
+    loadBatch(urls: string[]): Promise<void>;
+}
+/** CSS 动态加载工具单例 */
+export declare const cssLoader: CssLoader;
+export {};

package/es/utils/css-loader/css-loader.mjs

@@ -0,0 +1,82 @@
+//#region src/utils/css-loader/css-loader.ts
+/**
+* CSS 动态加载工具类
+*
+* 从 CDN 动态加载 CSS 文件，具备以下特性：
+* - 已成功加载的路径永久缓存，避免重复插入 link 标签
+* - 同一时刻对同一路径的多次调用共享同一个 Promise（请求去重）
+* - 加载失败不写入缓存，允许下次重试
+* - 加载前检查 DOM 中是否已存在相同 href 的 link 标签
+*
+* @author chitanda
+* @date 2026-03-16
+* @class CssLoader
+*/
+var CssLoader = class {
+	/** 已成功加载的 CSS URL 集合（永久缓存） */
+	_loadedSet = /* @__PURE__ */ new Set();
+	/** 正在加载中的 CSS URL 对应的 Promise（用于请求去重） */
+	_pendingMap = /* @__PURE__ */ new Map();
+	/**
+	* 动态加载单个 CSS 文件
+	*
+	* @param {string} url CSS 文件的完整 URL
+	* @returns {Promise<void>} 加载完成后 resolve；加载失败则 reject
+	*/
+	load(url) {
+		if (this._loadedSet.has(url)) return Promise.resolve();
+		if (this._pendingMap.has(url)) return this._pendingMap.get(url);
+		if (typeof document !== "undefined") {
+			if (document.querySelector(`link[rel="stylesheet"][href="${CSS.escape ? CSS.escape(url) : url}"]`)) {
+				this._loadedSet.add(url);
+				return Promise.resolve();
+			}
+		}
+		const promise = new Promise((resolve, reject) => {
+			if (typeof document === "undefined") {
+				reject(/* @__PURE__ */ new Error(`[CssLoader] 当前环境不支持 DOM，无法加载 CSS: ${url}`));
+				return;
+			}
+			const link = document.createElement("link");
+			link.rel = "stylesheet";
+			link.type = "text/css";
+			link.href = url;
+			/** 加载成功回调 */
+			const onLoad = () => {
+				cleanup();
+				this._loadedSet.add(url);
+				this._pendingMap.delete(url);
+				resolve();
+			};
+			/** 加载失败回调 */
+			const onError = () => {
+				cleanup();
+				this._pendingMap.delete(url);
+				reject(/* @__PURE__ */ new Error(`[CssLoader] CSS 文件加载失败: ${url}`));
+			};
+			/** 移除事件监听，防止内存泄漏 */
+			const cleanup = () => {
+				link.removeEventListener("load", onLoad);
+				link.removeEventListener("error", onError);
+			};
+			link.addEventListener("load", onLoad);
+			link.addEventListener("error", onError);
+			document.head.appendChild(link);
+		});
+		this._pendingMap.set(url, promise);
+		return promise;
+	}
+	/**
+	* 并发加载多个 CSS 文件
+	*
+	* @param {string[]} urls CSS 文件 URL 列表
+	* @returns {Promise<void>} 所有文件均加载完成后 resolve；任一失败则 reject
+	*/
+	async loadBatch(urls) {
+		await Promise.all(urls.map((url) => this.load(url)));
+	}
+};
+/** CSS 动态加载工具单例 */
+var cssLoader = new CssLoader();
+//#endregion
+export { cssLoader };

package/es/utils/design/design.mjs

@@ -1,15 +1,21 @@
-import { intersection } from 'lodash-es';
-import '../../enums/app-designer/index.mjs';
-import '../../enums/page-designer/designer.mjs';
-import '../../enums/breakpointEnum.mjs';
-import { notSingleArr } from '../../enums/designEnum.mjs';
-
+import { notSingleArr } from "../../enums/designEnum.mjs";
+import "../../enums/index.mjs";
+import { intersection } from "lodash-es";
+//#region src/utils/design/design.ts
+/**
+* 是否完全为多选算子
+*
+* @description 只有全部是多选算子时，下拉才可以算是多选
+* @author zhanghanrui
+* @date 2024-09-20 11:09:47
+* @export
+* @param {string[]} arr
+* @return {*}  {boolean}
+*/
 function isMultipleOperator(arr) {
-  const items = intersection(arr, notSingleArr);
-  if (items.length > 0 && items.length === arr.length) {
-    return true;
-  }
-  return false;
+	const items = intersection(arr, notSingleArr);
+	if (items.length > 0 && items.length === arr.length) return true;
+	return false;
 }
-
+//#endregion
 export { isMultipleOperator };

package/es/utils/deviceFingerprint.mjs

@@ -1,73 +1,87 @@
-import FingerprintJS from '@fingerprintjs/fingerprintjs';
-
-const FINGERPRINT_KEY = "FINGERPRINT";
+//#region src/utils/deviceFingerprint.ts
+/** 指纹缓存 key */
+var FINGERPRINT_KEY = "FINGERPRINT";
+/** 判断是否浏览器环境 */
 function isBrowserEnv() {
-  return typeof window !== "undefined" && typeof navigator !== "undefined";
+	return typeof window !== "undefined" && typeof navigator !== "undefined";
 }
+/** 获取客户端平台（浏览器 / 移动系统） */
 function getClientPlatform() {
-  if (!isBrowserEnv()) {
-    return { type: "unknown", name: "unknown" };
-  }
-  const ua = navigator.userAgent;
-  if (/iPad|iPhone|iPod/i.test(ua)) {
-    return { type: "mobile", name: "iOS" };
-  }
-  if (/Android/i.test(ua)) {
-    return { type: "mobile", name: "Android" };
-  }
-  if (/Windows Phone/i.test(ua)) {
-    return { type: "mobile", name: "Windows Phone" };
-  }
-  if (/BlackBerry/i.test(ua)) {
-    return { type: "mobile", name: "BlackBerry" };
-  }
-  if (/Edg/i.test(ua)) {
-    return { type: "web", name: "Edge" };
-  }
-  if (/OPR|Opera/i.test(ua)) {
-    return { type: "web", name: "Opera" };
-  }
-  if (/Firefox/i.test(ua)) {
-    return { type: "web", name: "Firefox" };
-  }
-  if (/Chrome/i.test(ua)) {
-    return { type: "web", name: "Chrome" };
-  }
-  if (/Safari/i.test(ua)) {
-    return { type: "web", name: "Safari" };
-  }
-  return { type: "unknown", name: "unknown" };
+	if (!isBrowserEnv()) return {
+		type: "unknown",
+		name: "unknown"
+	};
+	const ua = navigator.userAgent;
+	if (/iPad|iPhone|iPod/i.test(ua)) return {
+		type: "mobile",
+		name: "iOS"
+	};
+	if (/Android/i.test(ua)) return {
+		type: "mobile",
+		name: "Android"
+	};
+	if (/Windows Phone/i.test(ua)) return {
+		type: "mobile",
+		name: "Windows Phone"
+	};
+	if (/BlackBerry/i.test(ua)) return {
+		type: "mobile",
+		name: "BlackBerry"
+	};
+	if (/Edg/i.test(ua)) return {
+		type: "web",
+		name: "Edge"
+	};
+	if (/OPR|Opera/i.test(ua)) return {
+		type: "web",
+		name: "Opera"
+	};
+	if (/Firefox/i.test(ua)) return {
+		type: "web",
+		name: "Firefox"
+	};
+	if (/Chrome/i.test(ua)) return {
+		type: "web",
+		name: "Chrome"
+	};
+	if (/Safari/i.test(ua)) return {
+		type: "web",
+		name: "Safari"
+	};
+	return {
+		type: "unknown",
+		name: "unknown"
+	};
 }
+/** 获取浏览器指纹对象 */
 async function getFingerprint() {
-  const agent = await FingerprintJS.load();
-  return agent.get();
+	return (await (await import("@fingerprintjs/fingerprintjs")).load()).get();
 }
+/** 获取设备指纹标识（统一入口） */
 async function getDeviceFingerprint() {
-  if (!isBrowserEnv()) {
-    return "unknown/unknown";
-  }
-  const { type, name } = getClientPlatform();
-  const isWeb = type === "web";
-  if (isWeb) {
-    const cached = localStorage.getItem(FINGERPRINT_KEY);
-    if (cached) {
-      return `${name}/${cached}`;
-    }
-  }
-  const fingerprint = await getFingerprint();
-  const visitorId = fingerprint.visitorId;
-  if (isWeb) {
-    localStorage.setItem(FINGERPRINT_KEY, visitorId);
-  }
-  return `${name}/${visitorId}`;
+	if (!isBrowserEnv()) return "unknown/unknown";
+	const { type, name } = getClientPlatform();
+	const isWeb = type === "web";
+	if (isWeb) {
+		const cached = localStorage.getItem(FINGERPRINT_KEY);
+		if (cached) return `${name}/${cached}`;
+	}
+	const visitorId = (await getFingerprint()).visitorId;
+	if (isWeb) localStorage.setItem(FINGERPRINT_KEY, visitorId);
+	return `${name}/${visitorId}`;
 }
+/** mobile 端指纹（语义兼容） */
+function getMobileBrowserFingerprint() {
+	return getDeviceFingerprint();
+}
+/** 页签唯一标识 */
 function getPageIdentification() {
-  let pageTag = sessionStorage.getItem("currentPageTag");
-  if (!pageTag) {
-    pageTag = Date.now().toString();
-    sessionStorage.setItem("currentPageTag", pageTag);
-  }
-  return pageTag;
+	let pageTag = sessionStorage.getItem("currentPageTag");
+	if (!pageTag) {
+		pageTag = Date.now().toString();
+		sessionStorage.setItem("currentPageTag", pageTag);
+	}
+	return pageTag;
 }
-
-export { getClientPlatform, getDeviceFingerprint, getFingerprint, getPageIdentification };
+//#endregion
+export { getDeviceFingerprint, getMobileBrowserFingerprint, getPageIdentification };