@gct-paas/core 0.1.5-dev.1 → 0.1.5-dev.10

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

@@ -1,6 +1,5 @@
 import { PluginModeEnum } from '../../enums';
-import { IKitInfo } from '../../interface';
-import { App } from 'vue';
+import { IPluginKitModule } from '../../interface';
 /**
  * 用于加载套件包的工具类
  *
@@ -8,25 +7,47 @@ import { App } from 'vue';
  * @class KitPkgUtil
  */
 export declare class KitPkgUtil {
-    protected static readonly KIT_PKG_BASE_PATH = "/kits";
-    protected static cache: Map<string, IKitInfo>;
+    protected static readonly KIT_PKG_BASE_PATH = "/plugin-kit";
     protected static joinPaths(...paths: string[]): string;
     /**
-     * 加载套件包配置
+     * 加载套件包，返回套件包入口实例
      *
      * @static
      * @param {string} kit
-     * @return {*}  {(Promise<IKitInfo | undefined>)}
+     * @param {PluginModeEnum} mode
+     * @return {*}  {(Promise<IPluginKitModule | null>)}
      */
-    static loadKitPkgInfo(kit: string): Promise<IKitInfo | undefined>;
+    static loadKit(kit: string, mode: PluginModeEnum): Promise<IPluginKitModule | null>;
     /**
-     * 加载套件包内的插件
+     * 加载设计模式套件包
      *
      * @static
-     * @param {App} app
-     * @param {(string | string[])} kit
-     * @param {PluginModeEnum} mode
-     * @return {*}  {Promise<void>}
+     * @param {string} kit
+     * @return {*}  {(Promise<IPluginKitModule | null>)}
+     */
+    static loadDesign(kit: string): Promise<IPluginKitModule | null>;
+    /**
+     * 加载移动端绘制模式套件包
+     *
+     * @static
+     * @param {string} kit
+     * @return {*}  {(Promise<IPluginKitModule | null>)}
+     */
+    static loadMobile(kit: string): Promise<IPluginKitModule | null>;
+    /**
+     * 加载平板端绘制模式套件包
+     *
+     * @static
+     * @param {string} kit
+     * @return {*}  {(Promise<IPluginKitModule | null>)}
+     */
+    static loadPad(kit: string): Promise<IPluginKitModule | null>;
+    /**
+     * 加载网页端绘制模式套件包
+     *
+     * @static
+     * @param {string} kit
+     * @return {*}  {(Promise<IPluginKitModule | null>)}
      */
-    static loadKits(app: App, kit: string | string[], mode: PluginModeEnum): Promise<void>;
+    static loadWeb(kit: string): Promise<IPluginKitModule | null>;
 }

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

@@ -1,3 +1,5 @@
+import { PluginModeEnum } from "../../enums/plugin-enum.mjs";
+import "../../enums/index.mjs";
 //#region src/utils/kit-pkg-util/kit-pkg-util.ts
 /**
 * 用于加载套件包的工具类
@@ -6,8 +8,7 @@
 * @class KitPkgUtil
 */
 var KitPkgUtil = class {
-	static KIT_PKG_BASE_PATH = "/kits";
-	static cache = /* @__PURE__ */ new Map();
+	static KIT_PKG_BASE_PATH = "/plugin-kit";
 	static joinPaths(...paths) {
 		return paths.filter((p) => p && p.length > 0).map((p, index) => {
 			let normalized = p;
@@ -17,56 +18,66 @@ var KitPkgUtil = class {
 		}).join("/");
 	}
 	/**
-	* 加载套件包配置
+	* 加载套件包，返回套件包入口实例
 	*
 	* @static
 	* @param {string} kit
-	* @return {*}  {(Promise<IKitInfo | undefined>)}
+	* @param {PluginModeEnum} mode
+	* @return {*}  {(Promise<IPluginKitModule | null>)}
 	*/
-	static async loadKitPkgInfo(kit) {
-		if (this.cache.has(kit)) return this.cache.get(kit);
+	static async loadKit(kit, mode) {
+		const loaderUrl = this.joinPaths(this.KIT_PKG_BASE_PATH, kit, mode, "loader.esm.min.js");
 		try {
-			const url = this.joinPaths(this.KIT_PKG_BASE_PATH, kit.toUpperCase(), "kit-info.json");
-			const response = await fetch(url);
-			if (!response.ok) throw new Error(`Failed to load kit package from ${url}`);
-			const config = await response.json();
-			this.cache.set(kit, config);
-			return config;
+			const module = await import(
+				/* @vite-ignore */
+				loaderUrl
+);
+			if (module) return module;
+			else console.warn(`Kit ${kit} does not export a default function`);
 		} catch (error) {
-			console.error(`Error loading kit package ${kit}:`, error);
+			console.error(`Error loading kit ${kit} from ${loaderUrl}:`, error);
 		}
+		return null;
 	}
 	/**
-	* 加载套件包内的插件
+	* 加载设计模式套件包
 	*
 	* @static
-	* @param {App} app
-	* @param {(string | string[])} kit
-	* @param {PluginModeEnum} mode
-	* @return {*}  {Promise<void>}
+	* @param {string} kit
+	* @return {*}  {(Promise<IPluginKitModule | null>)}
 	*/
-	static async loadKits(app, kit, mode) {
-		const kits = Array.isArray(kit) ? kit : [kit];
-		for (const k of kits) {
-			if (this.cache.has(k)) {
-				console.warn(`Kit package ${k} is already loaded, skipping.`);
-				return;
-			}
-			const config = await this.loadKitPkgInfo(k);
-			if (config) {
-				const loaderUrl = this.joinPaths(this.KIT_PKG_BASE_PATH, config.kit.toUpperCase(), mode, `loader.esm.min.js?version=${config.version || "0.0.0"}`);
-				try {
-					const module = await import(
-						/* @vite-ignore */
-						loaderUrl
-);
-					if (module && module.default) app.use(module.default);
-					else console.warn(`Kit ${config.kit} does not export a default function`);
-				} catch (error) {
-					console.error(`Error loading kit ${config.kit} from ${loaderUrl}:`, error);
-				}
-			}
-		}
+	static loadDesign(kit) {
+		return this.loadKit(kit, PluginModeEnum.DESIGN);
+	}
+	/**
+	* 加载移动端绘制模式套件包
+	*
+	* @static
+	* @param {string} kit
+	* @return {*}  {(Promise<IPluginKitModule | null>)}
+	*/
+	static loadMobile(kit) {
+		return this.loadKit(kit, PluginModeEnum.MOBILE);
+	}
+	/**
+	* 加载平板端绘制模式套件包
+	*
+	* @static
+	* @param {string} kit
+	* @return {*}  {(Promise<IPluginKitModule | null>)}
+	*/
+	static loadPad(kit) {
+		return this.loadKit(kit, PluginModeEnum.PAD);
+	}
+	/**
+	* 加载网页端绘制模式套件包
+	*
+	* @static
+	* @param {string} kit
+	* @return {*}  {(Promise<IPluginKitModule | null>)}
+	*/
+	static loadWeb(kit) {
+		return this.loadKit(kit, PluginModeEnum.WEB);
 	}
 };
 //#endregion

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

@@ -1,6 +1,6 @@
 import { PluginModeEnum, Platform } from '../../enums';
 import { PluginTenant } from '@gct-paas/api/platform';
-export type IModuleMap = Record<string, System.Module>;
+export type IModuleMap = Record<string, IObject>;
 export type LoadPluginResult = [PluginTenant[], IModuleMap];
 /**
  * 插件包处理工具类
@@ -28,7 +28,7 @@ export declare class PluginPgkUtil {
      *
      * @static
      */
-    static readonly module: Map<string, System.Module>;
+    static readonly module: Map<string, IObject>;
     protected static joinPaths(...paths: string[]): string;
     /**
      * 加载插件包配置
@@ -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 {};

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

@@ -0,0 +1,92 @@
+//#region src/utils/script-loader/script-loader.ts
+/**
+* Script 动态加载工具类
+*
+* @class ScriptLoader
+*/
+var ScriptLoader = class {
+	/** 已成功加载的脚本 URL 集合（永久缓存） */
+	_loadedSet = /* @__PURE__ */ new Set();
+	/** 正在加载中的脚本 URL 对应的 Promise（用于请求去重） */
+	_pendingMap = /* @__PURE__ */ new Map();
+	/**
+	* 动态加载单个 JS 脚本文件
+	*
+	* 同一 URL 只会加载一次，首次调用时的 options 生效。
+	*
+	* @param {string} url 脚本文件的完整 URL
+	* @param {IScriptOptions} [options] 脚本加载选项
+	* @returns {Promise<void>} 加载完成后 resolve；加载失败则 reject
+	*/
+	load(url, options) {
+		if (this._loadedSet.has(url)) return Promise.resolve();
+		if (this._pendingMap.has(url)) return this._pendingMap.get(url);
+		if (typeof document !== "undefined") {
+			const escaped = CSS.escape ? CSS.escape(url) : url;
+			if (document.querySelector(`script[src="${escaped}"]`)) {
+				this._loadedSet.add(url);
+				return Promise.resolve();
+			}
+		}
+		const promise = new Promise((resolve, reject) => {
+			if (typeof document === "undefined") {
+				reject(/* @__PURE__ */ new Error(`[ScriptLoader] 当前环境不支持 DOM，无法加载脚本: ${url}`));
+				return;
+			}
+			const script = document.createElement("script");
+			script.src = url;
+			script.type = options?.type ?? "text/javascript";
+			script.async = options?.async ?? true;
+			if (options?.defer !== void 0) script.defer = options.defer;
+			if (options?.crossOrigin !== void 0) script.crossOrigin = options.crossOrigin;
+			/** 加载成功回调 */
+			const onLoad = () => {
+				cleanup();
+				this._loadedSet.add(url);
+				this._pendingMap.delete(url);
+				resolve();
+			};
+			/** 加载失败回调 */
+			const onError = () => {
+				cleanup();
+				this._pendingMap.delete(url);
+				const err = /* @__PURE__ */ new Error(`[ScriptLoader] 脚本文件加载失败: ${url}`);
+				console.error(err.message);
+				reject(err);
+			};
+			/** 移除事件监听，防止内存泄漏 */
+			const cleanup = () => {
+				script.removeEventListener("load", onLoad);
+				script.removeEventListener("error", onError);
+			};
+			script.addEventListener("load", onLoad);
+			script.addEventListener("error", onError);
+			document.head.appendChild(script);
+		});
+		this._pendingMap.set(url, promise);
+		return promise;
+	}
+	/**
+	* 加载 ExcelJS 库
+	*
+	* @return {*}  {Promise<IObject>}
+	*/
+	async loadExcelsJs() {
+		await this.load("/extras/exceljs/4.4.0/exceljs.min.js");
+		return window.ExcelJS;
+	}
+	/**
+	* 并发加载多个 JS 脚本文件
+	*
+	* @param {string[]} urls 脚本文件 URL 列表
+	* @param {IScriptOptions} [options] 脚本加载选项，对所有 URL 生效
+	* @returns {Promise<void>} 所有文件均加载完成后 resolve；任一失败则 reject
+	*/
+	async loadBatch(urls, options) {
+		await Promise.all(urls.map((url) => this.load(url, options)));
+	}
+};
+/** Script 动态加载工具单例 */
+var scriptLoader = new ScriptLoader();
+//#endregion
+export { scriptLoader };

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

@@ -6,6 +6,14 @@
  * @returns
  */
 export declare const calcStyle: (data: IData, ignoringStyle?: string[]) => IObject;
+/**
+ * 计算配置样式 补充px
+ *
+ * @param data
+ * @param ignoringStyle 忽略计算的样式
+ * @returns
+ */
+export declare const calcStylePX: (data: IData, ignoringStyle?: string[]) => IObject;
 /**
  * 计算字体样式
  *

package/es/utils/style/index.mjs

@@ -71,6 +71,72 @@ var calcStyle = (data, ignoringStyle = []) => {
 	return style;
 };
 /**
+* 计算配置样式 补充px
+*
+* @param data
+* @param ignoringStyle 忽略计算的样式
+* @returns
+*/
+var calcStylePX = (data, ignoringStyle = []) => {
+	if (!data) return {};
+	const style = {};
+	if (data.paddingTop && data.paddingTop != "0" && !ignoringStyle.includes("paddingTop")) style["padding-top"] = `${data.paddingTop}px`;
+	if (data.paddingRight && data.paddingRight != "0" && !ignoringStyle.includes("paddingRight")) style["padding-right"] = `${data.paddingRight}px`;
+	if (data.paddingBottom && data.paddingBottom != "0" && !ignoringStyle.includes("paddingBottom")) style["padding-bottom"] = `${data.paddingBottom}px`;
+	if (data.paddingLeft && data.paddingLeft != "0" && !ignoringStyle.includes("paddingLeft")) style["padding-left"] = `${data.paddingLeft}px`;
+	if (data.marginTop && data.marginTop != "0" && !ignoringStyle.includes("marginTop")) style["margin-top"] = `${data.marginTop}px`;
+	if (data.marginRight && data.marginRight != "0" && !ignoringStyle.includes("marginRight")) style["margin-right"] = `${data.marginRight}px`;
+	if (data.marginBottom && data.marginBottom != "0" && !ignoringStyle.includes("marginBottom")) style["margin-bottom"] = `${data.marginBottom}px`;
+	if (data.marginLeft && data.marginLeft != "0" && !ignoringStyle.includes("marginLeft")) style["margin-left"] = `${data.marginLeft}px`;
+	if (data.backgroundColor && !ignoringStyle.includes("backgroundColor")) style["background-color"] = data.backgroundColor;
+	if (data.width != null && data.width != "" && !ignoringStyle.includes("width")) style.width = `${data.width}px`;
+	if (data.height != null && data.height != "" && !ignoringStyle.includes("height")) {
+		style.height = `${data.height}px`;
+		style.overflowX = "hidden";
+		style.overflowY = "auto";
+	}
+	const position = data.position;
+	if (position && !ignoringStyle.includes("zIndex")) {
+		style.position = position;
+		style["z-index"] = 1;
+	}
+	if (data.top && !ignoringStyle.includes("top")) style.top = `${data.top}px`;
+	if (data.right && !ignoringStyle.includes("right")) style.right = `${data.right}px`;
+	if (data.bottom && !ignoringStyle.includes("bottom")) style.bottom = `${data.bottom}px`;
+	if (data.left && !ignoringStyle.includes("left")) style.left = `${data.left}px`;
+	if (data.borderBottomLeftRadius && !ignoringStyle.includes("borderBottomLeftRadius")) style["border-top-left-radius"] = `${data.borderBottomLeftRadius}px`;
+	if (data.borderTopRightRadius && !ignoringStyle.includes("borderTopRightRadius")) style["border-top-right-radius"] = `${data.borderTopRightRadius}px`;
+	if (data.borderBottomLeftRadius && !ignoringStyle.includes("borderBottomLeftRadius")) style["border-bottom-left-radius"] = `${data.borderBottomLeftRadius}px`;
+	if (data.borderBottomRightRadius && !ignoringStyle.includes("borderBottomRightRadius")) style["border-bottom-right-radius"] = `${data.borderBottomRightRadius}px`;
+	{
+		const top = data.borderTop;
+		if (top) {
+			if (top.borderColor && !ignoringStyle.includes("borderTopColor")) style["border-top-color"] = top.borderColor;
+			if (top.borderWidth && !ignoringStyle.includes("borderTopWidth")) style["border-top-width"] = `${top.borderWidth}px`;
+			if (top.borderStyle && !ignoringStyle.includes("borderTopStyle")) style["border-top-style"] = top.borderStyle;
+		}
+		const right = data.borderRight;
+		if (right) {
+			if (right.borderColor && !ignoringStyle.includes("borderRightColor")) style["border-right-color"] = right.borderColor;
+			if (right.borderWidth && !ignoringStyle.includes("borderRightWidth")) style["border-right-width"] = `${right.borderWidth}px`;
+			if (right.borderStyle && !ignoringStyle.includes("borderRightStyle")) style["border-right-style"] = right.borderStyle;
+		}
+		const bottom = data.borderBottom;
+		if (bottom) {
+			if (bottom.borderColor && !ignoringStyle.includes("borderBottomColor")) style["border-bottom-color"] = bottom.borderColor;
+			if (bottom.borderWidth && !ignoringStyle.includes("borderBottomWidth")) style["border-bottom-width"] = `${bottom.borderWidth}px`;
+			if (bottom.borderStyle && !ignoringStyle.includes("borderBottomStyle")) style["border-bottom-style"] = bottom.borderStyle;
+		}
+		const left = data.borderLeft;
+		if (left) {
+			if (left.borderColor && !ignoringStyle.includes("borderLeftColor")) style["border-left-color"] = left.borderColor;
+			if (left.borderWidth && !ignoringStyle.includes("borderLeftWidth")) style["border-left-width"] = `${left.borderWidth}px`;
+			if (left.borderStyle && !ignoringStyle.includes("borderLeftStyle")) style["border-left-style"] = left.borderStyle;
+		}
+	}
+	return style;
+};
+/**
 * 计算字体样式
 *
 * @param data
@@ -94,4 +160,4 @@ var calcFontStyle = (data, ignoringStyle = []) => {
 	return style;
 };
 //#endregion
-export { calcFontStyle, calcStyle };
+export { calcFontStyle, calcStyle, calcStylePX };

package/es/utils/text-measure/text-measure.d.ts

@@ -0,0 +1,141 @@
+/**
+ * 文本测量工具类
+ * 使用 Canvas 测量文本宽度，支持批量测量
+ */
+interface TextMeasureOptions {
+    /** 字体大小，默认 14px */
+    fontSize?: string | number;
+    /** 字体族，默认 'Arial, sans-serif' */
+    fontFamily?: string;
+    /** 字体粗细，默认 'normal' */
+    fontWeight?: string | number;
+    /** 字体样式，默认 'normal' */
+    fontStyle?: string;
+}
+interface TextMeasureResult {
+    /** 文本内容 */
+    text: string;
+    /** 计算得到的宽度 */
+    width: number;
+}
+declare class TextMeasureUtil {
+    private canvas;
+    private ctx;
+    /**
+     * 获取 Canvas 上下文，懒加载创建
+     */
+    private getContext;
+    /**
+     * 设置字体样式
+     */
+    private setFont;
+    /**
+     * 测量单个文本的宽度
+     *
+     * @param text 要测量的文本
+     * @param options 字体选项
+     * @returns 文本宽度（像素）
+     */
+    measureText(text: string, options?: TextMeasureOptions): number;
+    /**
+     * 批量测量多段文本的宽度
+     *
+     * @param texts 要测量的文本数组
+     * @param options 字体选项
+     * @returns 包含每段文本和对应宽度的结果数组
+     */
+    measureTexts(texts: string[], options?: TextMeasureOptions): TextMeasureResult[];
+    /**
+     * 获取文本的最大宽度
+     *
+     * @param texts 要测量的文本数组
+     * @param options 字体选项
+     * @returns 最大宽度（像素）
+     */
+    getMaxWidth(texts: string[], options?: TextMeasureOptions): number;
+    /**
+     * 获取文本的最小宽度
+     *
+     * @param texts 要测量的文本数组
+     * @param options 字体选项
+     * @returns 最小宽度（像素）
+     */
+    getMinWidth(texts: string[], options?: TextMeasureOptions): number;
+    /**
+     * 计算文本的总宽度（用于水平排列的文本）
+     *
+     * @param texts 要测量的文本数组
+     * @param options 字体选项
+     * @param spacing 文本间的间距，默认 0
+     * @returns 总宽度（像素）
+     */
+    getTotalWidth(texts: string[], options?: TextMeasureOptions, spacing?: number): number;
+    /**
+     * 根据最大宽度截断文本，添加省略号
+     *
+     * @param text 原始文本
+     * @param maxWidth 最大宽度
+     * @param options 字体选项
+     * @param ellipsis 省略号，默认 '...'
+     * @param minChars 最少显示字符数，默认 0
+     * @returns 截断后的文本
+     */
+    truncateText(text: string, maxWidth: number, options?: TextMeasureOptions, ellipsis?: string, minChars?: number): string;
+    /**
+     * 销毁资源
+     */
+    destroy(): void;
+}
+/**
+ * 测量单个文本的宽度
+ *
+ * @param text 要测量的文本
+ * @param options 字体选项
+ * @returns 文本宽度（像素）
+ */
+export declare function measureText(text: string, options?: TextMeasureOptions): number;
+/**
+ * 批量测量多段文本的宽度
+ *
+ * @param texts 要测量的文本数组
+ * @param options 字体选项
+ * @returns 包含每段文本和对应宽度的结果数组
+ */
+export declare function measureTexts(texts: string[], options?: TextMeasureOptions): TextMeasureResult[];
+/**
+ * 获取文本的最大宽度
+ *
+ * @param texts 要测量的文本数组
+ * @param options 字体选项
+ * @returns 最大宽度（像素）
+ */
+export declare function getMaxTextWidth(texts: string[], options?: TextMeasureOptions): number;
+/**
+ * 获取文本的最小宽度
+ *
+ * @param texts 要测量的文本数组
+ * @param options 字体选项
+ * @returns 最小宽度（像素）
+ */
+export declare function getMinTextWidth(texts: string[], options?: TextMeasureOptions): number;
+/**
+ * 计算文本的总宽度（用于水平排列的文本）
+ *
+ * @param texts 要测量的文本数组
+ * @param options 字体选项
+ * @param spacing 文本间的间距，默认 0
+ * @returns 总宽度（像素）
+ */
+export declare function getTotalTextWidth(texts: string[], options?: TextMeasureOptions, spacing?: number): number;
+/**
+ * 根据最大宽度截断文本，添加省略号
+ *
+ * @param text 原始文本
+ * @param maxWidth 最大宽度
+ * @param options 字体选项
+ * @param ellipsis 省略号，默认 '...'
+ * @param minChars 最少显示字符数，默认 0
+ * @returns 截断后的文本
+ */
+export declare function truncateText(text: string, maxWidth: number, options?: TextMeasureOptions, ellipsis?: string, minChars?: number): string;
+export { TextMeasureUtil, type TextMeasureOptions, type TextMeasureResult };