@galacean/effects-plugin-editor-gizmo 2.10.4 → 2.11.0-alpha.1

package/dist/2d/gizmos/image-cut-gizmo.d.ts

@@ -0,0 +1,140 @@
+import { Box2 } from '@galacean/effects-math/es/extension/index';
+import { Vector2 } from '../math';
+import type { ImageCutConfig } from '../configs/types';
+import type { VFXItem } from '@galacean/effects';
+import { type InputEventKey, type InputEventMouseButton, type InputEventMouseMotion } from '@galacean/effects';
+import type { Control } from '@galacean/effects-plugin-gui';
+import { Gizmo } from '../gizmo';
+import { GizmoType } from '../gizmo-type';
+import { type GestureCursorResult } from '../cursor';
+import { ImageInteractionType, type ImageDirectionScaleParam, type ImageMoveParam, type ImageNoneParam } from './image-interaction';
+/**
+ * 图片裁切工具结果
+ */
+export type ImageCutResult = {
+    /** 归一化裁切盒，不依赖渲染帧投影。 */
+    normalizeCutBox: Box2;
+};
+/**
+ * 图片裁切缩放交互参数
+ */
+export type ImageCutScaleParam = {
+    /** 交互类型 */
+    type: ImageInteractionType.SCALE;
+    /** 归一化裁切框 */
+    box: Box2;
+    /** 锚点（对角点） */
+    anchor: Vector2;
+    /** 归一化起始鼠标位置 */
+    startMouse: Vector2;
+    /** 归一化起始角点 */
+    startCorner: Vector2;
+    /** 锁定的宽高比 */
+    lockedAspect?: number;
+};
+/**
+ * 图片裁切交互参数
+ */
+export type ImageCutInteractionParam = ImageNoneParam | ImageCutScaleParam | ImageDirectionScaleParam | ImageMoveParam;
+/**
+ * 裁剪工具交互类型
+ */
+export type ImageCutInteractionType = ImageInteractionType;
+/** 在图片元素范围内移动或缩放归一化裁剪框。 */
+export declare class ImageCutGizmo extends Gizmo {
+    result: ImageCutResult;
+    interactionParam: ImageCutInteractionParam;
+    readonly type = GizmoType.IMAGE_CUT;
+    /** 光标结果。 */
+    cursorResult: GestureCursorResult;
+    /** 仅供当前渲染帧使用的几何快照；输入不读取它。 */
+    private renderGeometry?;
+    private _isLockScale;
+    private mouseGrabbed;
+    /** 当前图片裁剪配置。 */
+    get config(): Readonly<ImageCutConfig>;
+    /** 当前选中的元素（直读 selection.getSelectedPlayerItems：id→VFXItem 已解析）。 */
+    get selectedItems(): VFXItem[];
+    /** 是否锁定宽高比缩放。 */
+    get isLockScale(): boolean;
+    /**
+     * 设置是否锁定宽高比缩放。
+     * @param state 是否锁定宽高比。
+     */
+    set isLockScale(state: boolean);
+    /**
+     * 更新裁剪框交互或悬停状态。
+     * @param event 鼠标移动事件。
+     */
+    onMouseMove(event: InputEventMouseMotion): void;
+    /**
+     * 继续当前裁剪框拖拽。
+     * @param event 鼠标拖拽事件。
+     */
+    onMouseDrag(event: InputEventMouseMotion): void;
+    /** 鼠标离开交互层：清交互类型（拖拽中不清）。 */
+    onMouseLeave(): void;
+    /**
+     * 命中裁剪框交互区域时开始操作。
+     * @param event 鼠标按下事件。
+     */
+    onMouseDown(event: InputEventMouseButton): void;
+    /**
+     * 结束裁剪框操作并提交结果。
+     * @param event 鼠标抬起事件。
+     */
+    onMouseUp(event: InputEventMouseButton): void;
+    /**
+     * 键盘松开：清除当前交互的锁定宽高比（下次拖拽重新算）。
+     * @param _keyCode 键盘事件
+     */
+    onKeyUp(_keyCode: InputEventKey): void;
+    /** 为本帧绘制创建裁剪投影。 */
+    onUpdate(): void;
+    /**
+     * 绘制裁剪蒙版、网格、边框与角点。
+     * @param control 绘制控制器。
+     */
+    draw(control: Control): void;
+    /**
+     * 刷新指针结果。
+     * @param activeType 交互类型
+     * @param angle 指针方向
+     */
+    refreshCursorResult(activeType: ImageCutInteractionType, angle?: number): void;
+    /**
+     * 获取当前裁切信息（裁切框 + 元素包围盒）。
+     * @returns 裁切信息对象，不可交互时返回 undefined
+     */
+    getCutInfo(): {
+        cutBox: Box2;
+        itemBox: Box2;
+    } | undefined;
+    /**
+     * 获取归一化裁切包围盒（min/max 取值 [0, 1]，相对元素包围盒）。
+     */
+    getCutBox(): Box2 | undefined;
+    /**
+     * 设置归一化裁切包围盒（入参为归一化坐标，钳制到 [0, 1]）。
+     * @param normalizeBox 归一化裁切包围盒
+     * @returns 设置成功时返回更新后的裁切框，不可交互时返回 undefined
+     */
+    setCutBox(normalizeBox: Box2): Box2 | undefined;
+    /** @returns 是否仅选中了一个可裁剪元素。 */
+    private isApplicableSelection;
+    /**
+     * drag：按交互类型处理裁切框移动/缩放/单向缩放。
+     * 支持 shift 锁定宽高比，结果以归一化裁切盒写入 result。
+     * @param event 鼠标事件（drag）
+     */
+    private updateGrab;
+    /** @returns 当前图片与裁剪框的视口投影。 */
+    private getSelectionGeometry;
+    /**
+     * 根据鼠标位置判定裁切框的交互类型（角点缩放/边线单向缩放/整体移动），
+     * 同时刷新光标方向。
+     * @param point 视图坐标鼠标位置
+     * @param inputPosition Control 本地坐标鼠标位置
+     */
+    private refreshInteractionType;
+}

package/dist/2d/gizmos/image-expand-gizmo.d.ts

@@ -0,0 +1,135 @@
+import { Box2 } from '@galacean/effects-math/es/extension/index';
+import { Vector2 } from '../math';
+import type { ImageExpandConfig } from '../configs/types';
+import type { VFXItem } from '@galacean/effects';
+import { type InputEventKey, type InputEventMouseButton, type InputEventMouseMotion } from '@galacean/effects';
+import type { Control } from '@galacean/effects-plugin-gui';
+import { Gizmo } from '../gizmo';
+import { GizmoType } from '../gizmo-type';
+import { type GestureCursorResult } from '../cursor';
+import { ImageInteractionType, type ImageDirectionScaleParam, type ImageMoveParam, type ImageNoneParam } from './image-interaction';
+/**
+ * 图片扩边缩放交互参数
+ */
+export type ImageExpandScaleParam = {
+    /** 交互类型 */
+    type: ImageInteractionType.SCALE;
+    /** 归一化扩边框 */
+    box: Box2;
+    /** 起始角点索引 */
+    index: number;
+    /** 归一化起始鼠标位置 */
+    startMouse: Vector2;
+    /** 锁定的宽高比 */
+    lockedAspect?: number;
+};
+/**
+ * 图片扩边交互参数
+ */
+export type ImageExpandInteractionParam = ImageNoneParam | ImageExpandScaleParam | ImageDirectionScaleParam | ImageMoveParam;
+/** 图片扩边交互类型。 */
+export type ImageExpandInteractionType = ImageInteractionType;
+/**
+ * 图片扩边工具结果
+ */
+export type ImageExpandResult = {
+    /** 当前归一化扩边框。 */
+    normalizeExpandBox: Box2;
+};
+/** 在图片范围外移动或缩放归一化扩边框。 */
+export declare class ImageExpandGizmo extends Gizmo {
+    result: ImageExpandResult;
+    interactionParam: ImageExpandInteractionParam;
+    readonly type = GizmoType.IMAGE_EXPAND;
+    /** 光标结果。 */
+    cursorResult: GestureCursorResult;
+    private renderGeometry?;
+    private _isLockScale;
+    private mouseGrabbed;
+    /** 当前图片扩边配置。 */
+    get config(): Readonly<ImageExpandConfig>;
+    /** 当前选中的元素（直读 selection.getSelectedPlayerItems：id→VFXItem 已解析）。 */
+    get selectedItems(): VFXItem[];
+    /** 是否锁定宽高比缩放。 */
+    get isLockScale(): boolean;
+    /**
+     * 设置是否锁定宽高比缩放。
+     * @param state 是否锁定宽高比。
+     */
+    set isLockScale(state: boolean);
+    /**
+     * 更新扩边框交互或悬停状态。
+     * @param event 鼠标移动事件。
+     */
+    onMouseMove(event: InputEventMouseMotion): void;
+    /**
+     * 继续当前扩边框拖拽。
+     * @param event 鼠标拖拽事件。
+     */
+    onMouseDrag(event: InputEventMouseMotion): void;
+    /** 鼠标离开交互层：清交互类型（拖拽中不清）。 */
+    onMouseLeave(): void;
+    /**
+     * 命中扩边框交互区域时开始操作。
+     * @param event 鼠标按下事件。
+     */
+    onMouseDown(event: InputEventMouseButton): void;
+    /**
+     * 结束扩边框操作并提交结果。
+     * @param event 鼠标抬起事件。
+     */
+    onMouseUp(event: InputEventMouseButton): void;
+    /**
+     * 键盘松开：清除当前交互的锁定宽高比（下次拖拽重新算）。
+     * @param _keyCode 键盘事件
+     */
+    onKeyUp(_keyCode: InputEventKey): void;
+    /** 为本帧绘制创建扩边投影。 */
+    onUpdate(): void;
+    /**
+     * 绘制扩边蒙版、网格、边框与角点。
+     * @param control 绘制控制器。
+     */
+    draw(control: Control): void;
+    /**
+     * 刷新指针结果。
+     * @param activeType 交互类型。
+     * @param angle 指针方向角度。
+     */
+    refreshCursorResult(activeType: ImageExpandInteractionType, angle?: number): void;
+    /**
+     * 获取当前扩边信息（扩边框 + 元素包围盒）。
+     * @returns 扩边信息对象，不可交互时返回 undefined
+     */
+    getExpandInfo(): {
+        expandBox: Box2;
+        itemBox: Box2;
+    } | undefined;
+    /**
+     * 获取归一化扩边包围盒（相对元素包围盒，可超出 [0, 1]）。
+     */
+    getExpandBox(): Box2 | undefined;
+    /**
+     * 设置归一化扩边包围盒（入参为归一化坐标，钳制为至少覆盖元素范围）。
+     * @param normalizeBox 归一化扩边包围盒
+     * @returns 更新后的扩边包围盒；未激活或无效状态返回 undefined
+     */
+    setExpandBox(normalizeBox: Box2): Box2 | undefined;
+    /** @returns 是否仅选中了一个可扩边元素。 */
+    private isApplicableSelection;
+    /**
+     * drag：按交互类型处理扩边框移动/缩放/单向缩放。
+     * 支持 shift 锁定宽高比，结果以归一化扩边盒写入 result。
+     * @param event 鼠标事件（drag）
+     */
+    private updateGrab;
+    /** @returns 当前图片与扩边框的视口投影。 */
+    private getSelectionGeometry;
+    /**
+     * 根据鼠标位置判定扩边框的交互类型（角点缩放/边线单向缩放/整体移动），
+     * 同时刷新光标方向。
+     * @param point 视图坐标鼠标位置
+     * @param inputPosition Control 本地坐标鼠标位置
+     */
+    private refreshInteractionType;
+}

package/dist/2d/gizmos/image-interaction.d.ts

@@ -0,0 +1,40 @@
+import type { Box2 } from '@galacean/effects-math/es/extension/index';
+import type { Vector2 } from '../math';
+/** 图片裁切和扩边的交互类型。 */
+export declare enum ImageInteractionType {
+    /** 无交互。 */
+    NONE = "none",
+    /** 角点双轴缩放。 */
+    SCALE = "scale",
+    /** 边中点单轴缩放。 */
+    DIRECTION_SCALE = "direction-scale",
+    /** 移动交互框。 */
+    MOVE = "move"
+}
+/** 无图片交互参数。 */
+export type ImageNoneParam = {
+    /** 交互类型。 */
+    type: ImageInteractionType.NONE;
+};
+/** 图片单轴缩放参数。 */
+export type ImageDirectionScaleParam = {
+    /** 交互类型。 */
+    type: ImageInteractionType.DIRECTION_SCALE;
+    /** 交互开始时的归一化 Box2。 */
+    box: Box2;
+    /** 被拖拽边的索引。 */
+    index: number;
+    /** 交互开始时的归一化鼠标位置。 */
+    startMouse: Vector2;
+    /** 锁定的宽高比。 */
+    lockedAspect?: number;
+};
+/** 图片交互框移动参数。 */
+export type ImageMoveParam = {
+    /** 交互类型。 */
+    type: ImageInteractionType.MOVE;
+    /** 交互开始时的归一化 Box2。 */
+    box: Box2;
+    /** 交互开始时的归一化鼠标位置。 */
+    startMouse: Vector2;
+};

package/dist/2d/gizmos/item-create-gizmo.d.ts

@@ -0,0 +1,146 @@
+import { type InputEventMouseButton, type InputEventMouseMotion } from '@galacean/effects';
+import type { Control } from '@galacean/effects-plugin-gui';
+import { Gizmo } from '../gizmo';
+import { type GestureCursorResult } from '../cursor';
+import type { ItemCreateConfig } from '../configs/types';
+/** 元素创建类型。 */
+export declare enum ItemCreateType {
+    /** 不创建元素。 */
+    NONE = "none",
+    /** 创建文本元素。 */
+    TEXT = "text",
+    /** 创建视频生成器。 */
+    VIDEO_GENERATOR = "video-generator",
+    /** 创建图片生成器。 */
+    IMAGE_GENERATOR = "image-generator",
+    /** 创建画板。 */
+    FRAME = "frame"
+}
+/** 画板创建交互生成的几何与子元素数据。 */
+export type FrameCreateData = {
+    /** 画板像素位置（中心点） */
+    position: [number, number];
+    /** 画板像素尺寸 [width, height] */
+    size: [number, number];
+    /** 框选命中的子元素 ID 列表 */
+    children: string[];
+};
+/** 固定宽度文字创建数据；垂直尺寸仍由文字默认样式决定。 */
+export type TextCreateData = {
+    /** 文字像素位置（中心点） */
+    position: [number, number];
+    /** 水平拖拽得到的固定像素宽度 */
+    width: number;
+};
+/** 通过点击或拖拽创建文本、生成器和画板元素。 */
+export declare class ItemCreateGizmo extends Gizmo {
+    readonly type = "item-create";
+    _createType: ItemCreateType;
+    /** 光标结果（GestureCursorResult） */
+    cursorResult: GestureCursorResult;
+    private dragStartPoint;
+    private dragStartViewPoint;
+    private pressStartedAt;
+    private mouseGrabbed;
+    private frameBox;
+    private frameChildren;
+    private interactiveChildrenBoxes;
+    private isFixedWidthText;
+    private textDragDirection;
+    private textBox;
+    private createItemId;
+    private dragCreationStarted;
+    /** 当前元素创建配置。 */
+    get config(): Readonly<ItemCreateConfig>;
+    /** 当前创建类型 */
+    get createType(): ItemCreateType;
+    /**
+     * 设置创建类型，变化时刷新光标。
+     * @param type 元素创建类型
+     */
+    set createType(type: ItemCreateType);
+    /**
+     * 更新已开始的元素创建交互。
+     * @param event 鼠标移动事件。
+     */
+    onMouseMove(event: InputEventMouseMotion): void;
+    /**
+     * 继续画板或固定宽度文本的拖拽创建。
+     * @param event 鼠标拖拽事件。
+     */
+    onMouseDrag(event: InputEventMouseMotion): void;
+    /**
+     * 初始化元素创建交互与预生成 ID。
+     * @param event 鼠标按下事件。
+     */
+    onMouseDown(event: InputEventMouseButton): void;
+    /**
+     * 提交或取消当前元素创建交互。
+     * @param event 鼠标抬起事件。
+     */
+    onMouseUp(event: InputEventMouseButton): void;
+    /** 按当前创建类型刷新鼠标光标样式。 */
+    refreshCursorResult(): void;
+    /** 刷新可被框选加入画板的子元素包围盒映射：过滤动效元素、画板元素及其子元素。 */
+    refreshInteractiveChildrenBoxes(): void;
+    /**
+     * 绘制画板或文本的创建区域，以及画板待收纳元素轮廓。
+     * @param control 绘制控制器。
+     */
+    draw(control: Control): void;
+    /** 释放元素创建交互状态。 */
+    dispose(): void;
+    /**
+     * 按当前创建类型更新拖拽预览。
+     * @param event 鼠标拖拽事件。
+     * @returns 是否处理了拖拽。
+     */
+    private updateGrab;
+    /**
+     * 更新画板拖拽区域及其待收纳子元素。
+     * @param event 鼠标拖拽事件。
+     */
+    private updateFrameDrag;
+    /**
+     * 超过水平距离阈值后更新固定宽度文本；预览另外等待时间阈值。
+     * @param event 鼠标拖拽事件。
+     * @param committing 是否正在松开提交，此时不等待预览时间阈值。
+     */
+    private updateTextDrag;
+    /**
+     * 发送拖拽创建的开始或更新事件。
+     * @param createInfo 当前元素创建信息。
+     */
+    private emitDragCreate;
+    /** @returns 当前画板拖拽预览对应的创建信息。 */
+    private getFrameDragCreateInfo;
+    /** @returns 当前文本拖拽预览对应的创建信息。 */
+    private getTextDragCreateInfo;
+    /** @returns 当前有效的拖拽创建信息。 */
+    private getCurrentDragCreateInfo;
+    /**
+     * @returns 拖拽创建中文本的实际视图包围盒；元素尚未就绪时退回手势预览盒。
+     */
+    private getTextPreviewBox;
+    /**
+     * 计算当前指针对应的视口位置。
+     * @param event 鼠标拖拽事件。
+     * @returns 当前视口位置。
+     */
+    private getCurrentViewPoint;
+    /**
+     * 根据两个端点创建轴对齐包围盒。
+     * @param start 起点。
+     * @param end 终点。
+     * @returns 轴对齐包围盒。
+     */
+    private createBox;
+    /**
+     * 将视口位置转换为像素坐标。
+     * @param point 视口位置。
+     * @returns 像素坐标。
+     */
+    private viewPositionToPixel;
+    /** 重置一次创建交互的全部临时状态。 */
+    private resetInteractionState;
+}

package/dist/2d/gizmos/leave-effects-edit-gizmo.d.ts

@@ -0,0 +1,11 @@
+import { type InputEventMouseButton } from '@galacean/effects';
+import { Gizmo } from '../gizmo';
+/** 点击当前动效范围外的画布空白区域时退出动效编辑。 */
+export declare class LeaveEffectsEditGizmo extends Gizmo {
+    readonly type = "leave-effects-edit";
+    /**
+     * 在动效范围外的空白区域按下主键时退出编辑模式。
+     * @param event 鼠标按下事件
+     */
+    onMouseDown(event: InputEventMouseButton): void;
+}

package/dist/2d/gizmos/leave-text-edit-gizmo.d.ts

@@ -0,0 +1,11 @@
+import { Gizmo } from '../gizmo';
+import { type InputEventMouseButton } from '@galacean/effects';
+/** 在画布主键按下时退出行内文本编辑。 */
+export declare class LeaveTextEditGizmo extends Gizmo {
+    readonly type = "leave-text-edit";
+    /**
+     * 处理主键按下并退出编辑模式。
+     * @param event 鼠标按下事件
+     */
+    onMouseDown(event: InputEventMouseButton): void;
+}

package/dist/2d/gizmos/loading-gizmo.d.ts

@@ -0,0 +1,110 @@
+import type { VFXItem } from '@galacean/effects';
+import type { Control } from '@galacean/effects-plugin-gui';
+import { Box2 } from '@galacean/effects-math/es/extension/index';
+import { Gizmo } from '../gizmo';
+import type { GizmoOwner } from '../gizmo-owner';
+import type { LoadingItemOptions, LoadingManager } from './loading-manager';
+/** 为目标元素叠加加载动画与提示文案。 */
+export declare class LoadingGizmo extends Gizmo {
+    readonly type = "loading";
+    private configOff?;
+    private managerOff?;
+    private readonly manager;
+    private readonly loadingBoxSize;
+    private _idMap;
+    /**
+     * 创建加载覆盖层。
+     * @param owner Gizmo 宿主。
+     * @param manager 加载状态管理器。
+     */
+    constructor(owner: GizmoOwner, manager: LoadingManager);
+    /** 当前 Gizmo 实例持有的可销毁渲染投影。 */
+    get idMap(): Map<string, {
+        /** 归一化加载区域。 */
+        loadingBox: Box2;
+        /** 加载动画渲染对象。 */
+        loadingVFXItem: VFXItem;
+        /** 加载提示配置。 */
+        tip: LoadingItemOptions;
+    }>;
+    /** 当前 loading 元素 id 列表（由稳定 manager 派生）。 */
+    get loadingIds(): string[];
+    /** 当前加载覆盖层配置。 */
+    private get config();
+    /**
+     * 订阅 loading 集合变化：add/delete 后回调当前全量 id 列表。
+     * @param cb 收到当前全量 loading id 列表的回调
+     * @returns 退订函数，调用后取消对应监听
+     */
+    onLoadingChange(cb: (ids: string[]) => void): () => void;
+    /**
+     * 为指定元素添加 loading 覆盖层；同一元素不可重复添加。
+     * @param id 目标元素 ID
+     * @param options loading 配置（文案、位置、自定义区域、是否清空选中）
+     */
+    add(id: string, options?: LoadingItemOptions): void;
+    /**
+     * 移除指定元素的 loading 覆盖层并释放对应 VFXItem。
+     * @param id 目标元素 ID
+     */
+    delete(id: string): void;
+    /**
+     * 更新指定 loading 元素的提示文案。
+     * @param id 目标元素 ID
+     * @param options 待合并更新的 LoadingTip 属性
+     */
+    updateItem(id: string, options: LoadingItemOptions): void;
+    /** 根据目标元素的实时包围盒刷新加载动画。 */
+    onUpdate(): void;
+    /**
+     * 绘制所有加载提示文案。
+     * @param control 绘制控制器。
+     */
+    draw(control: Control): void;
+    /** 释放当前实例的渲染投影；稳定 LoadingManager 不随 Gizmo 重建清空。 */
+    dispose(): void;
+    /**
+     * 在片元着色器变化时重建加载动画对象。
+     * @param change 加载配置变更。
+     */
+    private onConfigChange;
+    /**
+     * 绘制单条加载提示，并将文本限制在加载区域内。
+     * @param control 绘制控制器。
+     * @param loadingBox 加载区域。
+     * @param itemBox 目标元素包围盒。
+     * @param tip 加载提示配置。
+     */
+    private drawLoadingTip;
+    /** 将可销毁的渲染投影同步到当前加载状态。 */
+    private syncManager;
+    /**
+     * 为加载状态创建渲染投影。
+     * @param id 目标元素 ID。
+     * @param state 加载状态。
+     */
+    private createProjection;
+    /** @returns 当前相机信息。 */
+    private getCameraInfo;
+    /** @returns 当前视口的缩放、平移与尺寸。 */
+    private getViewportParams;
+    /**
+     * 将视图坐标下的包围盒按当前视口缩放与平移变换为实际渲染包围盒。
+     * @param box 视图坐标下的包围盒
+     * @returns 经视口缩放与平移后的实际渲染包围盒
+     */
+    private getViewBoxByPixelBox;
+    /**
+     * 创建承载加载动画的 VFXItem。
+     * @returns 已绑定几何与材质的加载动画对象。
+     */
+    private createLoadingVFXItem;
+    /** 释放 loading 渲染对象，并同步恢复 Selection 的命中过滤。 */
+    private disposeLoadingVFXItem;
+    /**
+     * 按目标元素的实时包围盒更新加载动画变换。
+     * @param id 目标元素 ID。
+     * @param loadingItem 对应的加载渲染投影。
+     */
+    private updateLoadingVFXItemTransform;
+}

package/dist/2d/gizmos/loading-manager.d.ts

@@ -0,0 +1,74 @@
+import { EventEmitter } from '@galacean/effects';
+import { type Box2 } from '@galacean/effects-math/es/extension/index';
+import { Vector2 } from '../math';
+/** 单个元素的加载提示配置。 */
+export type LoadingItemOptions = {
+    /** 加载提示文本。 */
+    text?: string;
+    /** 相对目标元素实时包围盒左上角的视图像素偏移；未设置时文案在 loading 区域内居中。 */
+    position?: Vector2;
+    /** 打开 loading 时是否移除目标元素的选中状态。 */
+    clearSelected?: boolean;
+    /** 自定义加载区域。 */
+    loadingBox?: Box2;
+};
+/** 单个元素的当前加载状态。 */
+export interface LoadingItemState {
+    /** 加载提示配置。 */
+    tip: LoadingItemOptions;
+    /** 自定义加载区域。 */
+    loadingBox?: Box2;
+}
+/** 加载状态集合的一次变更。 */
+export type LoadingManagerChange = {
+    /** 变更后的全部加载元素 ID。 */
+    ids: string[];
+    /** 新增加载元素 ID。 */
+    addedIds: string[];
+    /** 已删除加载元素 ID。 */
+    removedIds: string[];
+    /** 已更新加载元素 ID。 */
+    updatedIds: string[];
+};
+/** 加载状态管理器事件参数。 */
+type LoadingManagerEvents = {
+    /** 加载集合变更事件。 */
+    change: [LoadingManagerChange];
+    /** 请求移除选中元素事件。 */
+    removeselecteditems: [string[]];
+};
+/** 管理元素加载状态并向 LoadingGizmo 提供稳定数据。 */
+export declare class LoadingManager extends EventEmitter<LoadingManagerEvents> {
+    private readonly items;
+    /** 当前加载元素 ID。 */
+    get ids(): string[];
+    /**
+     * 获取元素加载状态。
+     * @param id 元素 ID
+     * @returns 加载状态；不存在时返回 undefined
+     */
+    get(id: string): LoadingItemState | undefined;
+    /**
+     * 添加元素加载状态。
+     * @param id 元素 ID
+     * @param options 加载提示配置
+     */
+    add(id: string, options?: LoadingItemOptions): void;
+    /**
+     * 删除元素加载状态。
+     * @param id 元素 ID
+     */
+    delete(id: string): void;
+    /**
+     * 更新元素加载提示。
+     * @param id 元素 ID
+     * @param options 增量加载提示配置
+     */
+    update(id: string, options: LoadingItemOptions): void;
+    /**
+     * 发出包含完整 ID 列表的加载状态变更。
+     * @param change 增量变更
+     */
+    private emitChange;
+}
+export {};