@gct-paas/core 0.1.5-test.2 → 0.1.6-dev.0

package/es/interface/open-util/i-overlay-controller/i-overlay-controller.d.ts

@@ -1,6 +1,11 @@
+import { ComputePositionConfig } from '@floating-ui/dom';
 import { IOverlayContainer } from '../i-overlay-container/i-overlay-container';
 import { IModalOptions } from '../i-modal-options/i-modal-options';
 import { IModalData } from '../i-modal-data/i-modal-data';
+import { IPopoverOptions } from '../../i-popover-options/i-popover-options';
+import { IOverlayPopoverContainer } from '../i-overlay-popover-container/i-overlay-popover-container';
+import { IAppFullScreenContainerOptions } from '../i-app-full-screen-container-options/i-app-full-screen-container-options';
+export type FloatingUIConfig = Partial<ComputePositionConfig>;
 /**
  * 全局呈现容器控制器
  *
@@ -33,4 +38,51 @@ export interface IOverlayController {
      * @return {*}  {IOverlayContainer}
      */
     createModal(component: unknown, props?: IParams, opts?: IModalOptions): IOverlayContainer;
+    /**
+     * 飘窗打开组件
+     *
+     * @author zhanghanrui
+     * @date 2024-04-08 09:04:23
+     * @template T
+     * @param {HTMLElement} element 飘窗目标元素
+     * @param {unknown} component
+     * @param {IParams} [props]
+     * @param {IPopoverOptions<FloatingUIConfig>} [opts]
+     * @return {*}  {Promise<T>}
+     */
+    popover<T = void>(element: HTMLElement, component: unknown, props?: IParams, opts?: IPopoverOptions<FloatingUIConfig>): Promise<T>;
+    /**
+     * 创建全局飘窗容器
+     *
+     * @author zhanghanrui
+     * @date 2024-04-08 09:04:58
+     * @param {unknown} component
+     * @param {IParams} [props]
+     * @param {IPopoverOptions<FloatingUIConfig>} [opts]
+     * @return {*}  {IOverlayPopoverContainer}
+     */
+    createPopover(component: unknown, props?: IParams, opts?: IPopoverOptions<FloatingUIConfig>): IOverlayPopoverContainer;
+    /**
+     * 全屏容器打开组件
+     *
+     * @author zhanghanrui
+     * @date 2024-07-04 15:07:29
+     * @template T
+     * @param {unknown} component
+     * @param {IParams} [props]
+     * @param {IAppFullScreenContainerOptions} [opts]
+     * @return {*}  {Promise<T>}
+     */
+    fullScreen<T = void>(component: unknown, props?: IParams, opts?: IAppFullScreenContainerOptions): Promise<T>;
+    /**
+     * 创建全局全屏容器
+     *
+     * @author zhanghanrui
+     * @date 2024-07-04 15:07:02
+     * @param {unknown} component
+     * @param {IParams} [props]
+     * @param {IAppFullScreenContainerOptions} [opts]
+     * @return {*}  {IOverlayContainer}
+     */
+    createFullScreen(component: unknown, props?: IParams, opts?: IAppFullScreenContainerOptions): IOverlayContainer;
 }

package/es/interface/open-util/i-overlay-popover-container/i-overlay-popover-container.d.ts

@@ -0,0 +1,21 @@
+import { IOverlayContainer } from '../i-overlay-container/i-overlay-container';
+/**
+ * 飘窗容器
+ *
+ * @author chitanda
+ * @date 2022-11-09 14:11:39
+ * @export
+ * @interface IOverlayPopoverContainer
+ * @extends {IOverlayContainer}
+ */
+export interface IOverlayPopoverContainer extends IOverlayContainer {
+    /**
+     * 展示飘窗容器
+     *
+     * @author chitanda
+     * @date 2022-11-09 14:11:47
+     * @param {HTMLElement} el
+     * @return {*}  {Promise<void>}
+     */
+    present(el?: HTMLElement): Promise<void>;
+}

package/es/interface/open-util/index.d.ts

@@ -1,7 +1,9 @@
+export type { IAppFullScreenContainerOptions } from './i-app-full-screen-container-options/i-app-full-screen-container-options';
 export type { IMessageParams, IMessageUtil, } from './i-message-util/i-message-util';
 export type { IModal } from './i-modal/i-modal';
 export type { IModalData } from './i-modal-data/i-modal-data';
 export type { IModalOptions } from './i-modal-options/i-modal-options';
 export type { IOpenWindowOptions } from './i-open-window-options/i-open-window-options';
 export type { IOverlayContainer } from './i-overlay-container/i-overlay-container';
-export type { IOverlayController } from './i-overlay-controller/i-overlay-controller';
+export type { FloatingUIConfig, IOverlayController, } from './i-overlay-controller/i-overlay-controller';
+export type { IOverlayPopoverContainer } from './i-overlay-popover-container/i-overlay-popover-container';

package/es/locale/index.d.ts

@@ -2,12 +2,29 @@ import { I18n } from 'vue-i18n';
 import { App } from 'vue';
 import { I18nConfigResponse } from '@gct-paas/api/platform';
 type localeItem = Pick<I18nConfigResponse, 'id' | 'configured' | 'defaultLanguage' | 'language' | 'languageTag' | 'state'>;
+type ILocaleMessages = Record<string, string>;
+type ILocaleDeclarations = Record<string, ILocaleMessages>;
 export declare class LocaleUtil {
     localeList: localeItem[];
     i18n: I18n;
     get locale(): string;
     get enableLocaleList(): localeItem[];
     changeLang(lang: string): Promise<void>;
+    /**
+     * 动态增量新增多语言声明。
+     * 传入语言标识与文案键值映射后，会与现有语言包进行增量合并。
+     *
+     * @param {ILocaleDeclarations} declarations
+     */
+    addLocaleDeclarations(declarations: ILocaleDeclarations): void;
+    /**
+     * 动态增量新增单语言声明。
+     * 仅对指定语言进行文案合并，适用于按需加载场景。
+     *
+     * @param {string} locale 语言标识
+     * @param {ILocaleMessages} messages 文案键值映射
+     */
+    addLocaleMessages(locale: string, messages: ILocaleMessages): void;
     /**只加载应用专用i18n JSON */
     initAppJson(): Promise<void>;
     init(): Promise<void>;
@@ -24,6 +41,12 @@ export declare class LocaleUtil {
         env: 'dev' | 'test' | 'prod';
         branch?: string;
     }): string;
+    /**
+     * 设置 HTML 根元素的 lang 属性，供浏览器、辅助技术识别当前语言
+     *
+     * @param locale 语言标识，如 zh-CN、en
+     */
+    private setHtmlPageLang;
 }
 export declare function setupI18n(app: App): void;
 export {};

package/es/locale/index.mjs

@@ -24,8 +24,31 @@ var LocaleUtil = class {
 	}
 	async changeLang(lang) {
 		globalRefStorage.value.lang = lang;
+		this.i18n.global.locale.value = lang;
+		this.setHtmlPageLang(lang);
 		await this.loadI18nJson();
 	}
+	/**
+	* 动态增量新增多语言声明。
+	* 传入语言标识与文案键值映射后，会与现有语言包进行增量合并。
+	*
+	* @param {ILocaleDeclarations} declarations
+	*/
+	addLocaleDeclarations(declarations) {
+		Object.entries(declarations).forEach(([locale, messages]) => {
+			this.i18n.global.mergeLocaleMessage(locale, messages);
+		});
+	}
+	/**
+	* 动态增量新增单语言声明。
+	* 仅对指定语言进行文案合并，适用于按需加载场景。
+	*
+	* @param {string} locale 语言标识
+	* @param {ILocaleMessages} messages 文案键值映射
+	*/
+	addLocaleMessages(locale, messages) {
+		this.addLocaleDeclarations({ [locale]: messages });
+	}
 	/**只加载应用专用i18n JSON */
 	async initAppJson() {
 		const app_platformUrl = this.getMessageUrl({
@@ -65,6 +88,8 @@ var LocaleUtil = class {
 		}).filter((i) => i.configured === 1 && i.state === 1);
 		const defaultItem = this.localeList.find((item) => !!item.defaultLanguage);
 		globalRefStorage.value.lang = (globalRefStorage.value.lang ?? defaultItem?.languageTag) || "zh-CN";
+		this.i18n.global.locale.value = globalRefStorage.value.lang;
+		this.setHtmlPageLang(globalRefStorage.value.lang);
 	}
 	async loadMessages(url, locale = this.locale) {
 		if (!url) return;
@@ -85,6 +110,14 @@ var LocaleUtil = class {
 		}
 		return `/minio/locale-js/${payload.locale}__platform__.json`;
 	}
+	/**
+	* 设置 HTML 根元素的 lang 属性，供浏览器、辅助技术识别当前语言
+	*
+	* @param locale 语言标识，如 zh-CN、en
+	*/
+	setHtmlPageLang(locale) {
+		document.querySelector("html")?.setAttribute("lang", locale);
+	}
 };
 function setupI18n(app) {
 	app.use(_gct.i18n);

package/es/locale/sys/model.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    modelNameError: string;
+    notModelNameError: string;
+};
+export default _default;

package/es/locale/sys.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    notNull: string;
+    regError: string;
+};
+export default _default;

package/es/modules/mqtt/enums/mqtt-status.enum.d.ts

@@ -1,3 +1,4 @@
+export declare const DEFAULT_MQTT_INSTANCE_ID = "DEFAULT_MQTT_INSTANCE_ID";
 /**
  * MQTT 连接状态枚举
  *

package/es/modules/mqtt/enums/mqtt-status.enum.mjs

@@ -1,4 +1,5 @@
 //#region src/modules/mqtt/enums/mqtt-status.enum.ts
+var DEFAULT_MQTT_INSTANCE_ID = "DEFAULT_MQTT_INSTANCE_ID";
 /**
 * MQTT 连接状态枚举
 *
@@ -21,4 +22,4 @@ var MqttConnectionStatus = /* @__PURE__ */ function(MqttConnectionStatus) {
 	return MqttConnectionStatus;
 }({});
 //#endregion
-export { MqttConnectionStatus };
+export { DEFAULT_MQTT_INSTANCE_ID, MqttConnectionStatus };

package/es/modules/mqtt/mqtt-manager.d.ts

@@ -63,7 +63,7 @@ export declare class MqttManager implements IMqttManager {
      * @param instanceId 实例唯一标识
      * @returns 客户端实例，若不存在则返回 undefined
      */
-    get(instanceId: string): IMqttClient | undefined;
+    get(instanceId?: string): IMqttClient | undefined;
     /**
      * 判断指定实例是否已存在
      *

package/es/modules/mqtt/mqtt-manager.mjs

@@ -1,3 +1,4 @@
+import { DEFAULT_MQTT_INSTANCE_ID } from "./enums/mqtt-status.enum.mjs";
 import { MqttClient } from "./mqtt-client.mjs";
 import { createUUID } from "qx-util";
 //#region src/modules/mqtt/mqtt-manager.ts
@@ -77,7 +78,7 @@ var MqttManager = class {
 	* @param instanceId 实例唯一标识
 	* @returns 客户端实例，若不存在则返回 undefined
 	*/
-	get(instanceId) {
+	get(instanceId = DEFAULT_MQTT_INSTANCE_ID) {
 		return this._clients.get(instanceId);
 	}
 	/**

package/es/modules/platform-config/store.mjs

@@ -46,7 +46,6 @@ var usePlatformConfigStore = defineStore("platform-config", () => {
 		if (map[PlatformSettingEnum.THEME]) theme.setThemeSetting(map[PlatformSettingEnum.THEME]);
 		if (map[PlatformSettingEnum.WATERMARK]) watermark.setWatermarkSetting(map[PlatformSettingEnum.WATERMARK]);
 		if (map[PlatformSettingEnum.DEPLOY]) deploy.setDeploySetting(map[PlatformSettingEnum.DEPLOY]);
-		console.debug("平台配置初始化完成", map);
 	}
 	/**应用前台设置初始化 */
 	async function renderInit() {

package/es/modules/user-stores/store/user.store.d.ts

@@ -44,6 +44,7 @@ export declare const useUserStore: import('pinia').StoreDefinition<"user", UserS
                 duty?: string | undefined;
                 enabled?: number | undefined;
                 id?: string | undefined;
+                latestLogin?: number | undefined;
                 managerId?: string | undefined;
                 managerName?: string | undefined;
                 name?: string | undefined;
@@ -115,6 +116,7 @@ export declare const useUserStore: import('pinia').StoreDefinition<"user", UserS
             duty?: string | undefined;
             enabled?: number | undefined;
             id?: string | undefined;
+            latestLogin?: number | undefined;
             managerId?: string | undefined;
             managerName?: string | undefined;
             name?: string | undefined;
@@ -183,6 +185,7 @@ export declare const useUserStore: import('pinia').StoreDefinition<"user", UserS
                 duty?: string | undefined;
                 enabled?: number | undefined;
                 id?: string | undefined;
+                latestLogin?: number | undefined;
                 managerId?: string | undefined;
                 managerName?: string | undefined;
                 name?: string | undefined;
@@ -257,6 +260,7 @@ export declare const useUserStore: import('pinia').StoreDefinition<"user", UserS
                 duty?: string | undefined;
                 enabled?: number | undefined;
                 id?: string | undefined;
+                latestLogin?: number | undefined;
                 managerId?: string | undefined;
                 managerName?: string | undefined;
                 name?: string | undefined;

package/es/router/index.mjs

@@ -18,7 +18,7 @@ var RouterUtil = class {
 	async add(route) {
 		if (Array.isArray(route)) route.forEach((r) => this.router.addRoute(r));
 		else this.router.addRoute(route);
-		if (!this.router.hasRoute(this.router.currentRoute.value.name)) await this.router.replace(this.router.currentRoute.value.fullPath);
+		if (!this.router.currentRoute.value.name) await this.router.replace(this.router.currentRoute.value.fullPath);
 	}
 	/**刷新当前路由 */
 	async redo() {

package/es/setup-app.mjs

@@ -20,7 +20,9 @@ async function setupApp(_app) {
 	const token = getToken();
 	if (token) try {
 		await useUserStore().getUserInfoAction(token);
-	} catch {}
+	} catch (error) {
+		console.error("获取用户信息失败", error);
+	}
 }
 //#endregion
 export { setupApp };

package/es/utils/data-prems/const.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 分类的模块类型
+ */
+export declare enum CategoryModuleEnum {
+    /** 在线表单 */
+    ONLINE_FORM = "online_form_module",
+    /** eDHR */
+    EDHR = "edhr_module",
+    /** 单据项目 */
+    CHECK_LIST = "check_list_module",
+    /** 检验模板 */
+    INSPECTION = "inspection_module",
+    /** 放行模板 */
+    RELEASE = "release_module"
+}
+export type GetInterfaceParams = {
+    moduleType: CategoryModuleEnum;
+} & IObject;
+export declare const getInterfaceApi: {
+    /** 获取分类列表 */
+    getCategoryList: ({ moduleType }: {
+        moduleType: CategoryModuleEnum;
+    }) => Promise<object>;
+    /** 获取模板列表 */
+    getTmplsList: (params: GetInterfaceParams, config?: IObject) => Promise<object>;
+};

package/es/utils/data-prems/const.mjs

@@ -0,0 +1,79 @@
+//#region src/utils/data-prems/const.ts
+/**
+* 分类的模块类型
+*/
+var CategoryModuleEnum = /* @__PURE__ */ function(CategoryModuleEnum) {
+	/** 在线表单 */
+	CategoryModuleEnum["ONLINE_FORM"] = "online_form_module";
+	/** eDHR */
+	CategoryModuleEnum["EDHR"] = "edhr_module";
+	/** 单据项目 */
+	CategoryModuleEnum["CHECK_LIST"] = "check_list_module";
+	/** 检验模板 */
+	CategoryModuleEnum["INSPECTION"] = "inspection_module";
+	/** 放行模板 */
+	CategoryModuleEnum["RELEASE"] = "release_module";
+	return CategoryModuleEnum;
+}({});
+var moduleConfig = {
+	[CategoryModuleEnum.ONLINE_FORM]: {
+		modelKey: "em_form_category",
+		bsKeyList: {
+			list: "biz_tree",
+			tmpls: "biz_get_form_tmpls"
+		}
+	},
+	[CategoryModuleEnum.EDHR]: {
+		modelKey: "em_edhr_category",
+		bsKeyList: {
+			list: "biz_tree",
+			tmpls: "biz_get_edhr_tmpls",
+			querylist: "biz_list_edhr_tmpls"
+		}
+	},
+	[CategoryModuleEnum.INSPECTION]: {
+		modelKey: "em_inspection_category",
+		bsKeyList: {
+			list: "biz_tree",
+			tmpls: "biz_get_edhr_tmpls",
+			querylist: "biz_list_edhr_tmpls"
+		}
+	},
+	[CategoryModuleEnum.RELEASE]: {
+		modelKey: "em_product_release_category",
+		bsKeyList: {
+			list: "biz_tree",
+			tmpls: "biz_get_edhr_tmpls",
+			querylist: "biz_list_edhr_tmpls"
+		}
+	}
+};
+var getInterfaceApi = {
+	getCategoryList: ({ moduleType }) => {
+		if (moduleType === CategoryModuleEnum.CHECK_LIST) return _api.apaas.formRelate.getCategory({ moduleType });
+		const { modelKey, bsKeyList } = moduleConfig[moduleType] || {};
+		return _api.apaas.modelComprehensive.postBizServiceModelCategoryModelKeyBsKey({
+			modelCategory: "entity",
+			modelKey,
+			bsKey: bsKeyList.list
+		}, {}, {});
+	},
+	getTmplsList: (params, config) => {
+		if (params.moduleType === CategoryModuleEnum.CHECK_LIST) throw new Error("该模块不支持模板列表接口");
+		const { isQuery, ...otherParams } = params || {};
+		const { moduleType } = otherParams || {};
+		const { modelKey, bsKeyList } = moduleConfig[moduleType] || {};
+		const operatingState = Object.hasOwnProperty.call(otherParams, "operatingState") ? otherParams.operatingState : true;
+		const bsKey = isQuery ? bsKeyList?.querylist || bsKeyList?.tmpls : bsKeyList?.tmpls;
+		return _api.apaas.modelComprehensive.getBizServiceModelCategoryModelKeyBsKey({
+			modelCategory: "entity",
+			modelKey,
+			bsKey: bsKey || ""
+		}, {
+			...otherParams,
+			operatingState
+		}, config);
+	}
+};
+//#endregion
+export { CategoryModuleEnum, getInterfaceApi };

package/es/utils/i18n/index.mjs

@@ -10,6 +10,9 @@
 * @returns {*}  {string}
 */
 var t = (...args) => {
+	if (!args || args.length === 0) return "";
+	const key = args[0];
+	if (!key || typeof key !== "string" || key.trim() === "") return "";
 	return _gct.i18n.global.t(...args);
 };
 //#endregion

package/es/utils/index.d.ts

@@ -29,5 +29,8 @@ export * from './file/download';
 export * from './file/base64Conver';
 export * from './file/parser';
 export * from './design/design';
+export * from './text-measure/text-measure';
+export { scriptLoader, type IScriptOptions, } from './script-loader/script-loader';
 export { permission } from './permission';
 export { getVueComponentByCode } from './vue-component-code';
+export * from './data-prems/const';

package/es/utils/index.mjs

@@ -11,6 +11,7 @@ import "./model-loader/model-loader.mjs";
 import "./namespace/namespace.mjs";
 import "./openUtil/modal/modal.mjs";
 import "./openUtil/overlay-container/overlay-container.mjs";
+import "./openUtil/overlay-popover-container/overlay-popover-container.mjs";
 import "./openUtil/index.mjs";
 import "./kit-pkg-util/kit-pkg-util.mjs";
 import "./plugin-pkg-util/plugin-pkg-util.mjs";
@@ -31,5 +32,8 @@ import "./file/base64Conver.mjs";
 import "./file/download.mjs";
 import "./file/parser.mjs";
 import "./design/design.mjs";
+import "./text-measure/text-measure.mjs";
+import "./script-loader/script-loader.mjs";
 import "./permission.mjs";
 import "./vue-component-code.mjs";
+import "./data-prems/const.mjs";

package/es/utils/kit-pkg-util/kit-pkg-util.mjs

@@ -26,6 +26,10 @@ var KitPkgUtil = class {
 	* @return {*}  {(Promise<IPluginKitModule | null>)}
 	*/
 	static async loadKit(kit, mode) {
+		if (!kit) {
+			console.error("Kit name is required to load a kit package");
+			return null;
+		}
 		const loaderUrl = this.joinPaths(this.KIT_PKG_BASE_PATH, kit, mode, "loader.esm.min.js");
 		try {
 			const module = await import(

package/es/utils/openUtil/index.d.ts

@@ -1,2 +1,3 @@
 export { Modal } from './modal/modal';
 export { OverlayContainer } from './overlay-container/overlay-container';
+export { OverlayPopoverContainer } from './overlay-popover-container/overlay-popover-container';

package/es/utils/openUtil/index.mjs

@@ -1,2 +1,3 @@
 import "./modal/modal.mjs";
 import "./overlay-container/overlay-container.mjs";
+import "./overlay-popover-container/overlay-popover-container.mjs";

package/es/utils/openUtil/overlay-popover-container/overlay-popover-container.d.ts

@@ -0,0 +1,15 @@
+import { IOverlayPopoverContainer, IPopoverOptions } from '../../../interface';
+import { OverlayContainer } from '../overlay-container/overlay-container';
+/**
+ * 飘窗组件呈现容器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-08 09:04:42
+ * @export
+ * @class OverlayPopoverContainer
+ * @extends {OverlayContainer<IPopoverOptions>}
+ * @implements {IOverlayPopoverContainer}
+ */
+export declare class OverlayPopoverContainer extends OverlayContainer<IPopoverOptions> implements IOverlayPopoverContainer {
+    present(): Promise<void>;
+}

package/es/utils/openUtil/overlay-popover-container/overlay-popover-container.mjs

@@ -0,0 +1,19 @@
+import { OverlayContainer } from "../overlay-container/overlay-container.mjs";
+//#region src/utils/openUtil/overlay-popover-container/overlay-popover-container.ts
+/**
+* 飘窗组件呈现容器
+*
+* @author zhanghanrui
+* @date 2024-04-08 09:04:42
+* @export
+* @class OverlayPopoverContainer
+* @extends {OverlayContainer<IPopoverOptions>}
+* @implements {IOverlayPopoverContainer}
+*/
+var OverlayPopoverContainer = class extends OverlayContainer {
+	present(target) {
+		return this.modal.present(target);
+	}
+};
+//#endregion
+export { OverlayPopoverContainer };

package/es/utils/plugin-pkg-util/plugin-pkg-util.d.ts

@@ -47,7 +47,7 @@ export declare class PluginPgkUtil {
      * @protected
      * @static
      * @param {IStyleIMportMap[]} plugins
-     * @returns {*}  {Promise<System.Module[]>}
+     * @returns {*}  {Promise<IObject[]>}
      */
     protected static loadPlugins(mode: PluginModeEnum, configs?: PluginTenant['plugins']): Promise<IModuleMap>;
     /**

package/es/utils/plugin-pkg-util/plugin-pkg-util.mjs

@@ -60,7 +60,7 @@ var PluginPgkUtil = class {
 	* @protected
 	* @static
 	* @param {IStyleIMportMap[]} plugins
-	* @returns {*}  {Promise<System.Module[]>}
+	* @returns {*}  {Promise<IObject[]>}
 	*/
 	static async loadPlugins(mode, configs = []) {
 		const moduleMap = {};

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

@@ -0,0 +1,62 @@
+/**
+ * Script 动态加载工具类
+ *
+ * 从 CDN 动态加载 JS 脚本文件，具备以下特性：
+ * - 已成功加载的路径永久缓存，避免重复插入 script 标签
+ * - 同一时刻对同一路径的多次调用共享同一个 Promise（请求去重）
+ * - 加载失败不写入缓存，允许下次重试
+ * - 加载前检查 DOM 中是否已存在相同 src 的 script 标签
+ * - 支持配置 async、defer、crossOrigin、type 等脚本属性
+ *
+ * @author chitanda
+ * @date 2026-04-17
+ */
+/** Script 加载选项 */
+export interface IScriptOptions {
+    /** 是否异步加载，默认 true */
+    async?: boolean;
+    /** 是否延迟加载 */
+    defer?: boolean;
+    /** 跨域属性 */
+    crossOrigin?: 'anonymous' | 'use-credentials';
+    /** 脚本 MIME 类型，默认 'text/javascript' */
+    type?: string;
+}
+/**
+ * Script 动态加载工具类
+ *
+ * @class ScriptLoader
+ */
+declare class ScriptLoader {
+    /** 已成功加载的脚本 URL 集合（永久缓存） */
+    private _loadedSet;
+    /** 正在加载中的脚本 URL 对应的 Promise（用于请求去重） */
+    private _pendingMap;
+    /**
+     * 动态加载单个 JS 脚本文件
+     *
+     * 同一 URL 只会加载一次，首次调用时的 options 生效。
+     *
+     * @param {string} url 脚本文件的完整 URL
+     * @param {IScriptOptions} [options] 脚本加载选项
+     * @returns {Promise<void>} 加载完成后 resolve；加载失败则 reject
+     */
+    load(url: string, options?: IScriptOptions): Promise<void>;
+    /**
+     * 加载 ExcelJS 库
+     *
+     * @return {*}  {Promise<IObject>}
+     */
+    loadExcelsJs(): Promise<IObject>;
+    /**
+     * 并发加载多个 JS 脚本文件
+     *
+     * @param {string[]} urls 脚本文件 URL 列表
+     * @param {IScriptOptions} [options] 脚本加载选项，对所有 URL 生效
+     * @returns {Promise<void>} 所有文件均加载完成后 resolve；任一失败则 reject
+     */
+    loadBatch(urls: string[], options?: IScriptOptions): Promise<void>;
+}
+/** Script 动态加载工具单例 */
+export declare const scriptLoader: ScriptLoader;
+export {};