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

package/dist/2d/gesture-handler.d.ts

@@ -0,0 +1,253 @@
+import { type Engine } from '@galacean/effects';
+import { Control, type ControlEvent } from '@galacean/effects-plugin-gui';
+import type { GizmoOwner, SelectionTransformKind } from './gizmo-owner';
+import { GizmoManager, type GizmoErrorPhase } from './gizmo-manager';
+import { type GestureCursorResult } from './cursor';
+import type { ConfigManager } from './configs/config-manager';
+import { Vector2 } from './math';
+import { FrameManager } from './frame/frame-manager';
+import { Selection } from './selection/selection';
+import { SnapManager } from './selection/snap-manager';
+import { LoadingManager } from './gizmos/loading-manager';
+import { ViewportNavigationController } from './viewport';
+import { GizmoTool } from './gizmo-tool';
+import { type EditMode } from './modes';
+import type { GizmoOwnerEvents } from './gizmo-action';
+/** Gizmo 错误上报接口。 */
+export interface GizmoErrorMonitor {
+    /**
+     * 上报指定阶段的 Gizmo 错误。
+     * @param error 原始错误。
+     * @param phase 错误发生阶段。
+     * @param ctx 错误上下文。
+     */
+    report(error: unknown, phase: GizmoErrorPhase, ctx: {
+        /** 发生错误的 Gizmo 类型。 */
+        gizmoType?: string;
+    }): void;
+}
+/** 接收运行时输入，并协调 Gizmo、选区和视口导航。 */
+export declare class GestureHandler extends Control implements GizmoOwner {
+    /** 抓手与滚轮共享的视口导航控制器。 */
+    private viewportNavigation;
+    /** 当前对外可观察的 hover 命中结果。 */
+    private hoveringResults;
+    /** Runtime Control 输入入口；持有输入状态并完成 Move/Drag 分流。 */
+    private gizmoViewport;
+    /** 所有 Gizmo 共享的画板模型。 */
+    private frameManager;
+    /** 交互上下文共享的吸附器；跨图重建保持同一实例。 */
+    private snapManager;
+    /** 加载状态管理器。 */
+    private loadingManager;
+    /** Gizmo 生命周期管理器。 */
+    private gizmoManager;
+    /** 当前激活的工具。 */
+    private activeGizmoTool;
+    /** 当前编辑模式。 */
+    private editMode;
+    /** 选中状态与命中查询器。 */
+    private selection;
+    /** 当前 hover 的元素；用于在目标切换、离开或销毁时结束媒体预览。 */
+    private hoveredMediaItemId;
+    /** 错误上报器（按需注入，未注入时不生效）。 */
+    private errorMonitor;
+    /** 是否屏蔽所有交互。 */
+    private _ignoreInteraction;
+    /** 当前指针序列捕获的 Gizmo。 */
+    private capturedGizmo;
+    /** 独立于指针捕获者的选区变换状态。 */
+    private selectionTransformKind;
+    /** 等待指针序列结束后销毁的退场 Gizmo。 */
+    private gizmosToDispose;
+    /**
+     * 悬停目标变化时同步视频与动效预览。
+     * @param preSelectedId 新悬停元素 ID。
+     */
+    private onPreselectChange;
+    /**
+     * 创建手势处理器并装配基础交互状态。
+     * @param engine Effects 引擎。
+     */
+    constructor(engine: Engine);
+    /** 订阅原生控件或 Gizmo 业务事件。 */
+    on<E extends keyof (ControlEvent & GizmoOwnerEvents)>(eventName: E, listener: (...args: (ControlEvent & GizmoOwnerEvents)[E]) => void): () => void;
+    /** 取消原生控件或 Gizmo 业务事件订阅。 */
+    off<E extends keyof (ControlEvent & GizmoOwnerEvents)>(eventName: E, listener: (...args: (ControlEvent & GizmoOwnerEvents)[E]) => void): void;
+    /** 发出 Gizmo 业务事件。 */
+    emit<E extends keyof GizmoOwnerEvents>(eventName: E, ...args: GizmoOwnerEvents[E]): void;
+    /** 是否屏蔽交互。 */
+    get ignoreInteraction(): boolean;
+    /**
+     * 设置是否屏蔽所有 Gizmo 与选区交互。
+     * @param state 是否屏蔽交互。
+     */
+    set ignoreInteraction(state: boolean);
+    /** @returns 当前选区与命中查询对象。 */
+    getSelection(): Selection;
+    /** @returns 当前画板管理器。 */
+    getFrameManager(): FrameManager;
+    /** @returns 共享吸附管理器。 */
+    getSnapManager(): SnapManager;
+    /** @returns 加载状态管理器。 */
+    getLoadingManager(): LoadingManager;
+    /** @returns 共享视口导航控制器。 */
+    getViewportNavigation(): ViewportNavigationController;
+    /** @returns 当前选区变换状态。 */
+    getSelectionTransformKind(): SelectionTransformKind;
+    /**
+     * 设置选区变换状态。
+     * @param kind 选区变换状态。
+     */
+    setSelectionTransformKind(kind: SelectionTransformKind): void;
+    /** @returns 当前激活的编辑模式。 */
+    getActiveEditMode(): EditMode;
+    /**
+     * 切换编辑模式并重建 Gizmo 图。
+     * @param mode 新编辑模式。
+     */
+    setActiveEditMode(mode: EditMode): void;
+    /** 恢复新的默认编辑模式。 */
+    resetEditMode(): void;
+    /** 初始化当前工具与编辑模式对应的 Gizmo 图。 */
+    init(): void;
+    /** @returns 当前鼠标的 Control 本地坐标。 */
+    getMousePosition(): Vector2;
+    /**
+     * 更新交互层的 CSS 光标。
+     * @param result Gizmo 光标结果。
+     */
+    setCursor(result: GestureCursorResult): void;
+    /** @returns 当前 Gizmo 生命周期管理器。 */
+    getGizmoManager(): GizmoManager;
+    /** @returns Effects 引擎。 */
+    getEngine(): Engine;
+    /** @returns Gizmo 配置管理器。 */
+    getConfigManager(): ConfigManager;
+    /** @returns 当前是否为抓手工具。 */
+    isHandToolMode(): boolean;
+    /** @returns 当前是否有鼠标按键按下。 */
+    isMouseButtonPressed(): boolean;
+    /** 重建公共 Gizmo 与当前工具或编辑模式的 Gizmo 图。 */
+    rebuildGizmos(): void;
+    /**
+     * 切换活动工具并协调编辑模式。
+     * @param gizmoTool 新活动工具。
+     */
+    setActiveTool(gizmoTool: GizmoTool): void;
+    /**
+     * 注入错误上报器（由宿主调用，未注入时不影响现有行为）。
+     * @param reporter 错误上报器实例
+     */
+    setErrorMonitor(reporter?: GizmoErrorMonitor): void;
+    /** 释放资源：解绑订阅、清交互状态，并销毁当前 Gizmo 图。 */
+    onDestroy(): void;
+    /** 每帧更新入口：先刷新 Frame 投影，再同步当前 Gizmo 图。 */
+    update(deltaTime: number): void;
+    /** 创建填满交互根控件的输入与绘制子控件。 */
+    private createViewport;
+    /**
+     * 按退出、重建、进入的顺序提交编辑模式。
+     * @param nextMode 新编辑模式。
+     */
+    private commitEditMode;
+    /**
+     * 解析指定工具可继续使用的编辑模式。
+     * @param tool 目标工具。
+     * @returns 可用编辑模式。
+     */
+    private resolveEditModeForTool;
+    /** @returns 新建的默认编辑模式。 */
+    private createDefaultEditMode;
+    /**
+     * 按输入阶段派发 Runtime Control 事件。
+     * @param phase 输入阶段。
+     * @param input 已归一化的输入事件。
+     */
+    private dispatchInput;
+    /** @returns 所有工具共享的视口 Gizmo。 */
+    private createCommonBeforeToolSwitch;
+    /** @returns 抓手 Gizmo 当前是否正在平移或等待平移。 */
+    private isPanning;
+    /**
+     * 处理鼠标阶段并维护指针捕获。
+     * @param phase 输入阶段。
+     * @param event 鼠标事件。
+     */
+    private handleMouseInput;
+    /**
+     * 向本轮捕获者或活动候选派发鼠标事件。
+     * @param localOwner 本轮捕获者。
+     * @param phase 输入阶段。
+     * @param event 鼠标事件。
+     * @returns 接受事件的 Gizmo。
+     */
+    private dispatchMouseEvent;
+    /**
+     * 判断当前鼠标轮次是否可以进入行为派发。
+     * @param phase 输入阶段。
+     * @param savedOwner 本轮开始时的捕获者。
+     * @returns 是否允许派发。
+     */
+    private canDispatchMouseEvent;
+    /** 释放持久指针捕获。 */
+    private clearCapturedGizmo;
+    /** 在最新鼠标位置重新派发移动或拖拽事件。 */
+    private redispatchMouseAtCurrentPosition;
+    /** 在捕获者不属于退场图时释放待销毁 Gizmo。 */
+    private disposeQueuedGizmos;
+    /**
+     * 准备单个派发候选并隔离错误。
+     * @param gizmo 候选 Gizmo。
+     * @param phase 输入阶段。
+     */
+    private prepareForDispatch;
+    /**
+     * 调用 Gizmo 对应的鼠标阶段并隔离错误。
+     * @param gizmo 目标 Gizmo。
+     * @param phase 输入阶段。
+     * @param event 鼠标事件。
+     * @returns Gizmo 是否接受事件。
+     */
+    private invoke;
+    /**
+     * 按活动 Gizmo 快照派发键盘事件。
+     * @param event 键盘事件。
+     * @param phase 键盘输入阶段。
+     */
+    private handleKeyboardEvent;
+    /**
+     * 将输入阶段映射为错误上报阶段。
+     * @param phase 输入阶段。
+     * @returns 错误上报阶段。
+     */
+    private errorPhaseFor;
+    /**
+     * 按悬停框、活动 Gizmo、吸附提示的顺序绘制交互层。
+     * @param gizmoControl 绘制控制器。
+     */
+    private drawGizmos;
+    /**
+     * 绘制当前悬停元素的底层轮廓。
+     * @param gizmoControl 绘制控制器。
+     */
+    private drawHoverOverlay;
+    /**
+     * 绘制单个 Gizmo 并隔离错误。
+     * @param gizmo 目标 Gizmo。
+     * @param gizmoControl 绘制控制器。
+     */
+    private drawGizmo;
+    /**
+     * 绘制当前吸附提示。
+     * @param control 绘制控制器。
+     */
+    private drawSnappingVisualizations;
+    /**
+     * 上报 Gizmo 错误并重置共享交互状态。
+     * @param error 原始错误。
+     * @param phase 错误发生阶段。
+     * @param gizmoType 发生错误的 Gizmo 类型。
+     */
+    private handleGizmoError;
+}

package/dist/2d/gizmo-action.d.ts

@@ -0,0 +1,159 @@
+import type { Gizmo } from './gizmo';
+import type { FrameCreateData, ItemCreateType, TextCreateData } from './gizmos/item-create-gizmo';
+import type { AutoLayoutChangeInfo } from './frame/frame-assisted-layout';
+import type { TransformType } from './gizmos/resize-selection-gizmo/transform-types';
+import type { InputEventKey } from '@galacean/effects';
+/** Gizmo 操作的生命周期阶段。 */
+export type GizmoActionPhase = 'actionstart' | 'actionupdate' | 'actioncommit';
+/** 画板元素创建信息。 */
+export type GizmoFrameItemCreateInfo = {
+    /** 创建类型。 */
+    type: ItemCreateType.FRAME;
+    /** 新元素 ID。 */
+    id: string;
+    /** 元素创建位置。 */
+    position: [number, number];
+    /** 画板创建参数。 */
+    info: FrameCreateData;
+};
+/** 文本元素创建信息。 */
+export type GizmoTextItemCreateInfo = {
+    /** 创建类型。 */
+    type: ItemCreateType.TEXT;
+    /** 新元素 ID。 */
+    id: string;
+    /** 元素创建位置。 */
+    position: [number, number];
+    /** 文本创建参数。 */
+    info?: TextCreateData;
+};
+/** 无附加参数的元素创建信息。 */
+export type GizmoSimpleItemCreateInfo = {
+    /** 创建类型。 */
+    type: ItemCreateType.IMAGE_GENERATOR | ItemCreateType.VIDEO_GENERATOR | ItemCreateType.NONE;
+    /** 新元素 ID。 */
+    id: string;
+    /** 元素创建位置。 */
+    position: [number, number];
+    /** 简单元素不携带附加参数。 */
+    info?: undefined;
+};
+/** 按创建类型区分的元素创建信息。 */
+export type GizmoItemCreateInfo = GizmoFrameItemCreateInfo | GizmoTextItemCreateInfo | GizmoSimpleItemCreateInfo;
+/** 所有 Gizmo 业务操作共享的基础事件。 */
+export interface GizmoActionEvent {
+    /** 触发事件的 Gizmo。 */
+    source: Gizmo;
+}
+/** 选区变换事件。 */
+export interface GizmoTransformActionEvent extends GizmoActionEvent {
+    /** 变换类型。 */
+    transformType: TransformType;
+    /** 本次直接变换的顶层元素 ID。 */
+    itemIds?: string[];
+    /** 自动布局产生的附加变更。 */
+    autoLayoutChange?: AutoLayoutChangeInfo;
+}
+/** 选区变更事件。 */
+export interface GizmoSelectionActionEvent extends GizmoActionEvent {
+    /** 变更后的选中元素 ID。 */
+    selectedIds: string[];
+    /** 变更前的选中元素 ID。 */
+    oldSelectedIds?: string[];
+}
+/** 元素创建事件。 */
+export interface GizmoItemCreateActionEvent extends GizmoActionEvent {
+    /** 元素创建信息。 */
+    createInfo: GizmoItemCreateInfo;
+    /** 是否取消本次创建。 */
+    canceled?: boolean;
+}
+/** 元素移入画板事件。 */
+export interface GizmoMoveInEvent extends GizmoActionEvent {
+    /** 事件类型。 */
+    type: 'moveIn';
+    /** 待移入的元素 ID。 */
+    itemIds: string[];
+    /** 目标画板 ID。 */
+    targetFrameId: string;
+}
+/** 元素移出画板事件。 */
+export interface GizmoMoveOutEvent extends GizmoActionEvent {
+    /** 事件类型。 */
+    type: 'moveOut';
+    /** 待移出的元素 ID。 */
+    itemIds: string[];
+    /** 原画板 ID。 */
+    originalFrameId: string;
+}
+/** 子元素脱离组合事件。 */
+export interface GizmoDetachGroupChildrenEvent extends GizmoActionEvent {
+    /** 事件类型。 */
+    type: 'detachGroupChildren';
+    /** 原组合 ID。 */
+    groupId: string;
+    /** 待脱离的子元素 ID。 */
+    itemIds: string[];
+    /** 原画板 ID。 */
+    originalFrameId: string;
+}
+/** 元素层级位置变更事件。 */
+export type GizmoPlacementChangeEvent = GizmoMoveInEvent | GizmoMoveOutEvent | GizmoDetachGroupChildrenEvent;
+/** 请求刷新画板子元素的事件。 */
+export interface GizmoFrameRefreshChildrenEvent extends GizmoActionEvent {
+    /** 目标画板 ID。 */
+    frameId: string;
+}
+/** 文本输入事件。 */
+export interface GizmoTextInputEvent extends GizmoActionEvent {
+    /** 文本元素 ID。 */
+    itemId: string;
+    /** 输入后的文本。 */
+    text: string;
+    /** 文本字体。 */
+    fontFamily: string;
+}
+/** 视频播放位置变更事件。 */
+export interface GizmoVideoPlayEvent extends GizmoActionEvent {
+    /** 视频元素 ID。 */
+    id: string;
+    /** 播放时间。 */
+    time: number;
+}
+/** 精准文字点击事件。 */
+export interface GizmoSpriteTextClickEvent extends GizmoActionEvent {
+    /** 命中的文字信息。 */
+    info?: {
+        /** 文字元素 ID。 */
+        id: string;
+        /** 命中的字符索引。 */
+        index: number;
+        /** 命中的文本内容。 */
+        text: string;
+    };
+}
+/** 可进入操作生命周期的 Gizmo 事件。 */
+export type GizmoActionLifecycleEvent = GizmoActionEvent | GizmoTransformActionEvent | GizmoSelectionActionEvent | GizmoItemCreateActionEvent;
+/** GizmoOwner 发出的事件及其参数。 */
+export type GizmoOwnerEvents = {
+    /** 键盘按下事件。 */
+    keyDown: [InputEventKey];
+    /** 键盘抬起事件。 */
+    keyUp: [InputEventKey];
+    /** 操作开始事件。 */
+    actionstart: [GizmoActionLifecycleEvent];
+    /** 操作更新事件。 */
+    actionupdate: [GizmoActionLifecycleEvent];
+    /** 操作提交事件。 */
+    actioncommit: [GizmoActionLifecycleEvent];
+    /** 元素层级位置变更事件。 */
+    placementchange: [GizmoPlacementChangeEvent];
+    /** 画板子元素刷新事件。 */
+    framerefreshchildren: [GizmoFrameRefreshChildrenEvent];
+    /** 文本输入事件。 */
+    textinput: [GizmoTextInputEvent];
+    /** 视频播放事件。 */
+    videoplay: [GizmoVideoPlayEvent];
+    /** 精准文字点击事件。 */
+    spritetextclick: [GizmoSpriteTextClickEvent];
+};

package/dist/2d/gizmo-manager.d.ts

@@ -0,0 +1,105 @@
+import type { Gizmo } from './gizmo';
+import type { HandGizmo } from './gizmos/hand-gizmo';
+import type { IconGizmo } from './gizmos/icon-gizmo';
+import type { ItemCreateGizmo } from './gizmos/item-create-gizmo';
+import type { LoadingGizmo } from './gizmos/loading-gizmo';
+import type { MaskGizmo } from './gizmos/mask-gizmo';
+import type { ImageCutGizmo } from './gizmos/image-cut-gizmo';
+import type { ImageExpandGizmo } from './gizmos/image-expand-gizmo';
+import type { ViewportOverlayGizmo } from './gizmos/viewport-overlay-gizmo';
+import type { SpriteTextEditGizmo } from './gizmos/sprite-text-edit-gizmo';
+import type { TextGizmo } from './gizmos/text-gizmo';
+import type { ResizeSelectionGizmo } from './gizmos/resize-selection-gizmo';
+import type { ChangeSelectionGizmo } from './gizmos/change-selection-gizmo';
+import type { MoveSelectionGizmo } from './gizmos/move-selection-gizmo';
+import type { BoxSelectionGizmo } from './gizmos/box-selection-gizmo';
+import type { ClickDragMultiplexGizmo } from './gizmos/click-drag-multiplex-gizmo';
+import { ConfigManager } from './configs/config-manager';
+import type { LeaveTextEditGizmo } from './gizmos/leave-text-edit-gizmo';
+import type { EnterEditModeGizmo } from './gizmos/enter-edit-mode-gizmo';
+import type { LeaveEffectsEditGizmo } from './gizmos/leave-effects-edit-gizmo';
+import type { CornerRotationGizmo } from './gizmos/corner-rotation-gizmo';
+/** 当前交互图中可按类型查询的内置 Gizmo 映射。 */
+export type GizmoTypeMap = {
+    /** 选区切换 Gizmo。 */
+    'change-selection': ChangeSelectionGizmo;
+    /** 选区移动 Gizmo。 */
+    'move-selection': MoveSelectionGizmo;
+    /** 框选 Gizmo。 */
+    'box-selection': BoxSelectionGizmo;
+    /** 点击与拖拽仲裁 Gizmo。 */
+    'click-drag-multiplex': ClickDragMultiplexGizmo;
+    /** 角点旋转 Gizmo。 */
+    'corner-rotation': CornerRotationGizmo;
+    /** 视口平移 Gizmo。 */
+    hand: HandGizmo;
+    /** 媒体图标 Gizmo。 */
+    icon: IconGizmo;
+    /** 元素创建 Gizmo。 */
+    'item-create': ItemCreateGizmo;
+    /** 加载状态 Gizmo。 */
+    loading: LoadingGizmo;
+    /** 蒙版编辑 Gizmo。 */
+    mask: MaskGizmo;
+    /** 图片裁切 Gizmo。 */
+    'image-cut': ImageCutGizmo;
+    /** 图片扩边 Gizmo。 */
+    'image-expand': ImageExpandGizmo;
+    /** 视口覆盖层 Gizmo。 */
+    'viewport-overlay': ViewportOverlayGizmo;
+    /** 精准文字编辑 Gizmo。 */
+    'sprite-text-edit': SpriteTextEditGizmo;
+    /** 文本编辑 Gizmo。 */
+    text: TextGizmo;
+    /** 选区缩放 Gizmo。 */
+    'resize-selection': ResizeSelectionGizmo;
+    /** 文本编辑退出 Gizmo。 */
+    'leave-text-edit': LeaveTextEditGizmo;
+    /** 子编辑模式进入 Gizmo。 */
+    'enter-edit-mode': EnterEditModeGizmo;
+    /** 动效编辑退出 Gizmo。 */
+    'leave-effects-edit': LeaveEffectsEditGizmo;
+};
+/** Gizmo 错误上报阶段。 */
+export type GizmoErrorPhase = 'gizmo-init' | 'gizmo-actionstart' | 'gizmo-actionupdate' | 'gizmo-actioncommit' | 'gizmo-key' | 'gizmo-draw';
+/**
+ * Gizmo 错误处理函数。
+ * @param error 原始错误
+ * @param phase 错误阶段
+ * @param gizmoType 相关 Gizmo 类型
+ */
+export type GizmoDispatchErrorHandler = (error: unknown, phase: GizmoErrorPhase, gizmoType?: string) => void;
+/** 管理当前交互图中的 Gizmo 实例和配置。 */
+export declare class GizmoManager {
+    /** Gizmo 配置管理器。 */
+    readonly configs: ConfigManager;
+    private _activeGizmos;
+    /** 当前交互图的顶层 Gizmo。 */
+    get activeGizmos(): Gizmo[];
+    /**
+     * 替换当前交互图的顶层 Gizmo。
+     * @param gizmos 新的有序 Gizmo 列表
+     */
+    set activeGizmos(gizmos: Gizmo[]);
+    /**
+     * 按类型获取首个活动 Gizmo。
+     * @param type Gizmo 类型
+     * @returns 匹配的 Gizmo；不存在时返回 undefined
+     */
+    get<K extends keyof GizmoTypeMap>(type: K): GizmoTypeMap[K] | undefined;
+    get(type: string): Gizmo | undefined;
+    /** 按宿主声明顺序执行当前图所有实例的每帧更新。 */
+    onUpdate(): void;
+    /** 销毁当前交互图。 */
+    dispose(): void;
+    /**
+     * 查找指定类型的全部活动 Gizmo。
+     * @param type Gizmo 类型
+     * @returns 匹配的 Gizmo 列表
+     */
+    private findGizmosByType;
+    /** 获取去重后的全部受管 Gizmo。 */
+    private getAllManagedGizmos;
+    /** 获取点击与拖拽仲裁器托管的全部候选。 */
+    private getMultiplexCandidates;
+}

package/dist/2d/gizmo-owner.d.ts

@@ -0,0 +1,65 @@
+import type { Vector2 } from './math';
+import type { FrameManager } from './frame/frame-manager';
+import type { Selection } from './selection/selection';
+import type { GizmoManager } from './gizmo-manager';
+import type { ConfigManager } from './configs/config-manager';
+import type { SnapManager } from './selection/snap-manager';
+import type { Engine } from '@galacean/effects';
+import type { ViewportNavigationController } from './viewport';
+import type { GizmoOwnerEvents } from './gizmo-action';
+import type { LoadingManager } from './gizmos/loading-manager';
+import type { GestureCursorResult } from './cursor';
+import type { EditMode } from './modes';
+/** 独立于指针捕获者的选区变换状态。 */
+export type SelectionTransformKind = 'idle' | 'move' | 'resize';
+/** Gizmo 访问宿主输入、选区、视口和共享服务的接口。 */
+export interface GizmoOwner {
+    /**
+     * 发出 Gizmo 业务事件。
+     * @param eventName 事件名称
+     * @param args 事件参数
+     */
+    emit<E extends keyof GizmoOwnerEvents & string>(eventName: E, ...args: GizmoOwnerEvents[E]): void;
+    /** 获取选区状态和命中查询器。 */
+    getSelection(): Selection;
+    /** 获取画板数据和投影视图。 */
+    getFrameManager(): FrameManager;
+    /** 获取选区吸附管理器。 */
+    getSnapManager(): SnapManager;
+    /** 获取加载状态管理器。 */
+    getLoadingManager(): LoadingManager;
+    /** 获取视口导航控制器。 */
+    getViewportNavigation(): ViewportNavigationController;
+    /** 获取当前选区变换类型。 */
+    getSelectionTransformKind(): SelectionTransformKind;
+    /**
+     * 设置当前选区变换类型。
+     * @param kind 变换类型
+     */
+    setSelectionTransformKind(kind: SelectionTransformKind): void;
+    /** 获取缓存的鼠标视图坐标。 */
+    getMousePosition(): Vector2;
+    /**
+     * 设置当前 Gizmo 光标。
+     * @param result 光标样式
+     */
+    setCursor(result: GestureCursorResult): void;
+    /** 判断当前工具是否为视口平移工具。 */
+    isHandToolMode(): boolean;
+    /** 判断当前是否有鼠标按钮按下。 */
+    isMouseButtonPressed(): boolean;
+    /** 获取当前激活的编辑模式。 */
+    getActiveEditMode(): EditMode;
+    /** 切换当前编辑模式。 */
+    setActiveEditMode(mode: EditMode): void;
+    /** 恢复默认编辑模式。 */
+    resetEditMode(): void;
+    /** 重建当前工具和编辑模式的 Gizmo 图。 */
+    rebuildGizmos(): void;
+    /** 获取 Gizmo 管理器。 */
+    getGizmoManager(): GizmoManager;
+    /** 获取 Effects 引擎。 */
+    getEngine(): Engine;
+    /** 获取 Gizmo 配置管理器。 */
+    getConfigManager(): ConfigManager;
+}

package/dist/2d/gizmo-tool.d.ts

@@ -0,0 +1,15 @@
+import type { Gizmo } from './gizmo';
+import type { GizmoOwner } from './gizmo-owner';
+/** 创建有序 Gizmo 交互图的工具基类。 */
+export declare class GizmoTool {
+    protected owner: GizmoOwner;
+    /**
+     * @param owner Gizmo 宿主
+     */
+    constructor(owner: GizmoOwner);
+    /**
+     * 创建工具使用的 Gizmo 图。
+     * @returns 有序 Gizmo 列表
+     */
+    createGizmos(): Gizmo[];
+}

package/dist/2d/gizmo-tools/hand-gizmo-tool.d.ts

@@ -0,0 +1,4 @@
+import { GizmoTool } from '../gizmo-tool';
+/** 画布平移工具。 */
+export declare class HandGizmoTool extends GizmoTool {
+}

package/dist/2d/gizmo-tools/image-cut-gizmo-tool.d.ts

@@ -0,0 +1,7 @@
+import type { Gizmo } from '../gizmo';
+import { GizmoTool } from '../gizmo-tool';
+/** 图片裁切工具。 */
+export declare class ImageCutGizmoTool extends GizmoTool {
+    /** @returns 图片裁切 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+}

package/dist/2d/gizmo-tools/image-expand-gizmo-tool.d.ts

@@ -0,0 +1,7 @@
+import type { Gizmo } from '../gizmo';
+import { GizmoTool } from '../gizmo-tool';
+/** 图片扩边工具。 */
+export declare class ImageExpandGizmoTool extends GizmoTool {
+    /** @returns 图片扩边 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+}

package/dist/2d/gizmo-tools/index.d.ts

@@ -0,0 +1,7 @@
+export * from './move-gizmo-tool';
+export * from './hand-gizmo-tool';
+export * from './image-cut-gizmo-tool';
+export * from './image-expand-gizmo-tool';
+export * from './sprite-text-edit-gizmo-tool';
+export * from './mask-gizmo-tool';
+export * from './item-create-gizmo-tool';

package/dist/2d/gizmo-tools/item-create-gizmo-tool.d.ts

@@ -0,0 +1,10 @@
+import type { Gizmo } from '../gizmo';
+import { GizmoTool } from '../gizmo-tool';
+import { ItemCreateType } from '../gizmos/item-create-gizmo';
+/** 元素创建工具。 */
+export declare class ItemCreateGizmoTool extends GizmoTool {
+    /** 当前元素创建类型。 */
+    createType: ItemCreateType;
+    /** @returns 指定创建类型的 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+}

package/dist/2d/gizmo-tools/mask-gizmo-tool.d.ts

@@ -0,0 +1,7 @@
+import type { Gizmo } from '../gizmo';
+import { GizmoTool } from '../gizmo-tool';
+/** 蒙版编辑工具。 */
+export declare class MaskGizmoTool extends GizmoTool {
+    /** @returns 蒙版 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+}

package/dist/2d/gizmo-tools/move-gizmo-tool.d.ts

@@ -0,0 +1,6 @@
+import { GizmoTool } from '../gizmo-tool';
+/** 使用当前编辑模式处理选区交互的默认工具。 */
+export declare class MoveGizmoTool extends GizmoTool {
+    /** @returns 当前编辑模式的 Gizmo 图。 */
+    createGizmos(): import("@galacean/effects-plugin-editor-gizmo").Gizmo[];
+}

package/dist/2d/gizmo-tools/sprite-text-edit-gizmo-tool.d.ts

@@ -0,0 +1,7 @@
+import type { Gizmo } from '../gizmo';
+import { GizmoTool } from '../gizmo-tool';
+/** Sprite 精准文字编辑工具。 */
+export declare class SpriteTextEditGizmoTool extends GizmoTool {
+    /** @returns 精准文字编辑 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+}