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

package/dist/2d/math/geometry.d.ts

@@ -0,0 +1,83 @@
+import { Box2 } from '@galacean/effects-math/es/extension/index';
+import { Matrix3, Vector2 } from './core';
+/**
+ * 读取轴对齐包围盒的四个角点。
+ * @param box 轴对齐包围盒
+ * @returns 按顺时针排列的四个新角点
+ */
+export declare function getBoxCorners(box: Box2): Vector2[];
+/** 从 Box2 的视图角点建立归一化 Box2 到视图坐标的二维仿射变换。 */
+export declare function getBoxTransform(points: Vector2[]): Matrix3 | undefined;
+/** 从一个视图 Box2 建立无旋转变换。 */
+export declare function getBoxTransformFromBox(box: Box2): Matrix3 | undefined;
+/** 使用二维变换映射一个 Box2 局部点。 */
+export declare function transformBoxPoint(transform: Matrix3, point: Vector2): Vector2;
+/** 将视图点逆变换到 Box2 局部坐标。 */
+export declare function inverseTransformBoxPoint(transform: Matrix3, point: Vector2): Vector2;
+/** 临时计算 Box2 变换后的四个点。 */
+export declare function getTransformedBoxCorners(transform: Matrix3, box?: Box2): Vector2[];
+/** 计算 Box2 变换后的轴对齐范围。 */
+export declare function getTransformedBox(transform: Matrix3, box?: Box2): Box2;
+/**
+ * 判断一个变换后的 Box2 是否与轴对齐 Box2 相交。
+ *
+ * 使用分离轴判定而不是仅比较轴对齐包围盒，避免旋转元素在实际四边形未接触选区时被误选。
+ * 边界接触也视为相交。
+ * @param transform Box2 到视图坐标的变换
+ * @param target 视图坐标下的轴对齐 Box2
+ * @param box 待变换的 Box2
+ * @returns 两个区域是否相交
+ */
+export declare function transformedBoxIntersectsBox(transform: Matrix3, target: Box2, box?: Box2): boolean;
+/** 通过逆变换判断视图点是否位于 Box2 内。 */
+export declare function transformedBoxContainsPoint(transform: Matrix3, point: Vector2, box?: Box2): boolean;
+/**
+ * 使用点集更新 Box2 的轴对齐范围。
+ * @param box 目标包围盒
+ * @param points 点集
+ * @returns 目标包围盒
+ */
+export declare function setBoxFromPoints(box: Box2, points: Vector2[]): Box2;
+/**
+ * 以指定锚点缩放 Box2。
+ * @param box 目标包围盒
+ * @param scalar 缩放比例
+ * @param anchor 缩放中心，默认使用包围盒中心
+ * @returns 目标包围盒
+ */
+export declare function scaleBox(box: Box2, scalar: number | Vector2, anchor?: Vector2): Box2;
+/**
+ * 计算 Box2 绕指定中心旋转后的轴对齐范围。
+ * @param box 目标包围盒
+ * @param angle 旋转角度（弧度）
+ * @param center 旋转中心，默认使用包围盒中心
+ * @returns 目标包围盒
+ */
+export declare function rotateBox(box: Box2, angle: number, center?: Vector2): Box2;
+/**
+ * 计算二维向量相对原点的极角（弧度）。
+ * @param vector 二维向量
+ * @returns 弧度值
+ */
+export declare function getVector2Angle(vector: Vector2): number;
+/**
+ * 计算由两个二维向量所成夹角（带方向，弧度）
+ * @param vector1 起始向量
+ * @param vector2 目标向量
+ * @returns 带符号夹角弧度值
+ */
+export declare function getAngleByVectors(vector1: Vector2, vector2: Vector2): number;
+/**
+ * 将归一化包围盒按原包围盒范围还原为实际包围盒
+ * @param origin 原始范围包围盒
+ * @param normalize 归一化包围盒
+ * @returns 还原后的实际包围盒
+ */
+export declare function getBoxByNormalizeBox(origin: Box2, normalize: Box2): Box2;
+/**
+ * 将当前包围盒在原始范围内的位置归一化为 0~1 包围盒
+ * @param origin 原始范围包围盒
+ * @param current 当前包围盒
+ * @returns 归一化包围盒
+ */
+export declare function getNormalizeBoxByBoxes(origin: Box2, current: Box2): Box2;

package/dist/2d/math/index.d.ts

@@ -0,0 +1,4 @@
+export * from './core';
+export * from './geometry';
+export * from './ray-caster';
+export * from './utils';

package/dist/2d/math/ray-caster.d.ts

@@ -0,0 +1,56 @@
+import { type Plane } from '@galacean/effects-math/es/extension/index';
+import { type Matrix4, Ray, type Vector2, Vector3 } from './core';
+/**
+ * 射线碰撞相机参数
+ */
+export type RayCasterCamera = {
+    /**
+     * 位置
+     */
+    position: Vector3;
+    /**
+     * 视图投影逆矩阵
+     */
+    inverseViewProjectMatrix: Matrix4;
+};
+/**
+ * 射线碰撞结果
+ */
+export type RayCastResult = {
+    /**
+     * 相交点
+     */
+    point: Vector3;
+    /**
+     * 相交距离
+     */
+    distance: number;
+    /**
+     * 相交构件ID
+     */
+    id?: string;
+};
+/**
+ * 射线投射器，由屏幕坐标与相机参数构建射线并进行平面求交。
+ */
+export declare class RayCaster {
+    ray: Ray;
+    /**
+     * 构造射线投射器。
+     * @param ray 初始射线，默认为新建射线
+     */
+    constructor(ray?: Ray);
+    /**
+     * 由屏幕坐标与相机参数构建投射射线。
+     * @param coords 屏幕坐标（归一化）
+     * @param camera 相机参数
+     * @returns 当前实例（链式调用）
+     */
+    setFromCamera(coords: Vector2, camera: RayCasterCamera): this;
+    /**
+     * 将当前射线与平面求交。
+     * @param plane 目标平面
+     * @returns 相交结果，不相交时返回 undefined
+     */
+    rayCastPlane(plane: Plane): RayCastResult | undefined;
+}

package/dist/2d/math/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 返回数组中绝对值最大元素的索引
+ * @param numbers 数值数组
+ * @returns 绝对值最大元素的索引
+ */
+export declare function getAbsMaxIndex(numbers: number[]): number;

package/dist/2d/modes/default-selection-mode.d.ts

@@ -0,0 +1,19 @@
+import type { Gizmo } from '../gizmo';
+import type { GizmoOwner } from '../gizmo-owner';
+import type { GizmoTool } from '../gizmo-tool';
+import type { EditMode } from './edit-mode';
+/** 提供默认选区切换、移动、缩放和旋转交互的编辑模式。 */
+export declare class DefaultSelectionMode implements EditMode {
+    private readonly owner;
+    readonly id = "default-selection";
+    /** @param owner Gizmo 宿主 */
+    constructor(owner: GizmoOwner);
+    /**
+     * 判断目标工具是否可复用当前模式。
+     * @param tool 目标工具
+     * @returns 是否保持当前模式
+     */
+    canRemainActiveForTool(tool: GizmoTool): boolean;
+    /** @returns 默认选区交互的 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+}

package/dist/2d/modes/edit-mode.d.ts

@@ -0,0 +1,18 @@
+import type { Gizmo } from '../gizmo';
+import type { GizmoTool } from '../gizmo-tool';
+/** 工具内部可持续存在的编辑模式。 */
+export interface EditMode {
+    /** 编辑模式唯一标识。 */
+    readonly id: string;
+    /**
+     * 判断切换工具后是否可保持当前模式。
+     * @param tool 目标工具
+     */
+    canRemainActiveForTool(tool: GizmoTool): boolean;
+    /** 创建当前模式的 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+    /** 进入模式。 */
+    onEnter?(): void;
+    /** 退出模式。 */
+    onExit?(): void;
+}

package/dist/2d/modes/effects-edit-mode.d.ts

@@ -0,0 +1,34 @@
+import type { Gizmo } from '../gizmo';
+import type { GizmoOwner } from '../gizmo-owner';
+import type { GizmoTool } from '../gizmo-tool';
+import type { EditMode } from './edit-mode';
+/** 动效内部编辑模式配置。 */
+export type EffectsEditModeOptions = {
+    /** 是否允许子元素移动、缩放和旋转；默认允许。 */
+    allowTransform?: boolean;
+};
+/** 在单个动效容器内提供子元素选择和变换交互。 */
+export declare class EffectsEditMode implements EditMode {
+    private readonly owner;
+    readonly effectsItemId: string;
+    readonly id = "effects-edit";
+    private readonly allowTransform;
+    /**
+     * @param owner Gizmo 宿主
+     * @param effectsItemId 正在编辑的动效容器实例 ID
+     * @param options 编辑模式配置
+     */
+    constructor(owner: GizmoOwner, effectsItemId: string, options?: EffectsEditModeOptions);
+    /**
+     * 判断目标工具是否可复用当前动效编辑会话。
+     * @param tool 目标工具
+     * @returns 是否保持当前模式
+     */
+    canRemainActiveForTool(tool: GizmoTool): boolean;
+    /** 放开当前动效容器的子树选择边界。 */
+    onEnter(): void;
+    /** 关闭动效子树选择边界，并恢复选中动效容器。 */
+    onExit(): void;
+    /** @returns 动效内部编辑使用的 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+}

package/dist/2d/modes/index.d.ts

@@ -0,0 +1,4 @@
+export type { EditMode } from './edit-mode';
+export { DefaultSelectionMode } from './default-selection-mode';
+export { EffectsEditMode, type EffectsEditModeOptions } from './effects-edit-mode';
+export { TextEditMode } from './text-edit-mode';

package/dist/2d/modes/text-edit-mode.d.ts

@@ -0,0 +1,34 @@
+import type { VFXItem } from '@galacean/effects';
+import type { Gizmo } from '../gizmo';
+import type { GizmoOwner } from '../gizmo-owner';
+import type { GizmoTool } from '../gizmo-tool';
+import type { TextEditActivation } from '../text/text-edit-session';
+import type { EditMode } from './edit-mode';
+/** 管理行内文本编辑会话和对应 Gizmo 图的编辑模式。 */
+export declare class TextEditMode implements EditMode {
+    private readonly owner;
+    private readonly target;
+    private readonly activation;
+    readonly id = "text-edit";
+    private readonly session;
+    /**
+     * @param owner Gizmo 宿主
+     * @param target 入口已校验的待编辑文本元素
+     * @param activation 文本框激活方式
+     */
+    constructor(owner: GizmoOwner, target: VFXItem, activation?: TextEditActivation);
+    /** 当前会话正在编辑的文本元素，随文本选择交互更新。 */
+    get editingItem(): VFXItem | undefined;
+    /**
+     * 判断目标工具是否可复用文本编辑会话。
+     * @param tool 目标工具
+     * @returns 是否保持当前模式
+     */
+    canRemainActiveForTool(tool: GizmoTool): boolean;
+    /** 使用入口确定的目标进入文本编辑，避免旧模式退出时改变选区。 */
+    onEnter(): void;
+    /** 结束文本编辑会话。 */
+    onExit(): void;
+    /** @returns 文本编辑交互的 Gizmo 图。 */
+    createGizmos(): Gizmo[];
+}

package/dist/2d/selection/create-selection-interaction-gizmo.d.ts

@@ -0,0 +1,14 @@
+import type { GizmoOwner } from '../gizmo-owner';
+import { ClickDragMultiplexGizmo } from '../gizmos/click-drag-multiplex-gizmo';
+/** 选择交互的可选行为。 */
+export type SelectionInteractionOptions = {
+    /** 是否允许拖拽已选元素进行移动。 */
+    allowTransform?: boolean;
+};
+/**
+ * 创建用于仲裁点击、拖拽和框选的复合 Gizmo。
+ * @param owner Gizmo 宿主。
+ * @param options 选择交互配置。
+ * @returns 选区交互复合 Gizmo。
+ */
+export declare function createSelectionInteractionGizmo(owner: GizmoOwner, options?: SelectionInteractionOptions): ClickDragMultiplexGizmo;

package/dist/2d/selection/index.d.ts

@@ -0,0 +1,3 @@
+export { createSelectionInteractionGizmo } from './create-selection-interaction-gizmo';
+export * from './selection';
+export * from './snap-manager';

package/dist/2d/selection/selection.d.ts

@@ -0,0 +1,338 @@
+import { EventEmitter, type Engine, type InputEventMouseButton, type VFXItem } from '@galacean/effects';
+import { Vector2 } from '../math';
+/** Hover state shared by input observation and the Tool UI renderer. */
+export type HoveringResults = {
+    /** Externally observable hover target. */
+    itemId?: string;
+    /** Target currently submitted to the Tool UI hover renderer. */
+    overlayItemId?: string;
+};
+/** Selection 事件参数。 */
+export type SelectionEvents = {
+    /** 选中集变更。 */
+    'selectionchange': [
+        {
+            /** 变更前的选中元素 ID。 */
+            oldSelectedIds: string[];
+            /** 变更后的选中元素 ID。 */
+            newSelectedIds: string[];
+        }
+    ];
+    /** 预选态变更。 */
+    'preselectchange': [
+        {
+            /** 当前预选元素 ID。 */
+            preSelectedId: string | undefined;
+        }
+    ];
+    /** 组内交互或动效内部查看焦点变更。 */
+    'focuschange': [];
+};
+/** 一次选区行为派发使用的稳定命中快照。 */
+export type SelectionHitSnapshot = {
+    /** 命中检测坐标。 */
+    point: Vector2;
+    /** 按层级过滤后的可选元素 ID。 */
+    selectableIds: string[];
+    /** 最上层可选元素 ID。 */
+    topmostId?: string;
+    /** 当前选中范围内的命中元素 ID。 */
+    selectedScopeHitIds: string[];
+    /** 跳过已选父组后，可继续下钻一层的元素 ID。 */
+    drillTargetId?: string;
+};
+/** 管理选中状态、预选状态和场景命中查询。 */
+export declare class Selection extends EventEmitter<SelectionEvents> {
+    /** 本次交互开始前的选中快照。 */
+    interactionStartSelectedIds: string[];
+    /** 命中检测需要排除的元素 ID。 */
+    ignoreIds: string[];
+    /** 命中检测需要排除的元素名称。 */
+    ignoreNames: string[];
+    /** 当前选中元素 ID。 */
+    private _selectedIds;
+    /** 当前允许穿透选择的动效容器 ID。 */
+    private _effectsEditItemId;
+    /** 当前组内交互的焦点容器 ID。 */
+    private _focusedGroupId;
+    private readonly engine;
+    private readonly hoveringResults;
+    /**
+     * @param engine Effects 引擎
+     * @param hoveringResults 共享的预选状态
+     */
+    constructor(engine: Engine, hoveringResults?: HoveringResults);
+    /** 选中元素 ID 的副本。 */
+    get selectedIds(): string[];
+    /**
+     * 替换选中元素并发出变更事件。
+     * @param ids 新的选中元素 ID
+     */
+    set selectedIds(ids: string[]);
+    /** 对外可观察的 hover 命中结果。 */
+    get preSelectedId(): string | undefined;
+    /** 当前 Tool UI 要绘制的 hover 目标。 */
+    get hoverOverlayItemId(): string | undefined;
+    /** @returns 当前正在内部编辑的动效容器 ID。 */
+    getEffectsEditItemId(): string | undefined;
+    /** @returns 当前组内交互的焦点容器 ID。 */
+    getFocusedGroupId(): string | undefined;
+    /**
+     * 设置当前组内交互的焦点容器。
+     * @param groupId Group 实例 ID；传空值表示回到场景根层级
+     */
+    setFocusedGroup(groupId?: string | null): void;
+    /**
+     * 放开指定动效容器的子树选择边界。
+     * @param effectsItemId 动效容器 ID
+     */
+    enterEffectsEditScope(effectsItemId: string): void;
+    /** 关闭动效子树选择边界。 */
+    leaveEffectsEditScope(): void;
+    /** @returns 选中元素 ID 的内部只读引用。 */
+    getSelectedIds(): string[];
+    /** @returns 当前选中 ID 对应的有效 VFXItem。 */
+    getSelectedPlayerItems(): VFXItem[];
+    /**
+     * 判断元素是否已选中。
+     * @param id 元素 ID
+     * @returns 是否已选中
+     */
+    isItemSelected(id: string): boolean;
+    /**
+     * 追加尚未选中的元素并发出变更事件。
+     * @param ids 待追加元素 ID
+     */
+    addSelectedItems(ids: string[]): void;
+    /**
+     * 移除选中元素并发出变更事件。
+     * @param ids 待移除元素 ID
+     */
+    removeSelectedItems(ids: string[]): void;
+    /** 清空选中元素并发出变更事件。 */
+    clearSelectedItems(): void;
+    /**
+     * 替换选中元素并发出变更事件。
+     * @param ids 新的选中元素 ID
+     */
+    setSelectedItems(ids: string[]): void;
+    /**
+     * 原子更新选中元素、焦点容器和变更事件。
+     * @param ids 新的选中元素 ID
+     * @returns 选中集是否发生变化
+     */
+    commitSelectedItems(ids: string[]): boolean;
+    /**
+     * 将元素加入选中集合并同步焦点容器，不发出事件。
+     * @param id 元素 ID
+     * @returns 更新后的选中元素 ID
+     */
+    addSelectedItem(id: string): string[];
+    /** 清空选中集，不发出事件。 */
+    clear(): void;
+    /**
+     * 直接替换选中集，不发出事件。
+     * @param ids 新的选中元素 ID
+     */
+    setSelectedIds(ids: string[]): void;
+    /**
+     * 处理双击点选，并允许穿透已选父元素。
+     * @param event 鼠标事件
+     * @returns 命中的元素 id；无命中返回 undefined
+     */
+    pickOnDoubleClick(event: InputEventMouseButton): string | undefined;
+    /**
+     * 处理单击点选，Shift 按键用于切换命中元素的选中状态。
+     * @param event 鼠标事件
+     * @returns 命中的元素 id；无命中返回 undefined
+     */
+    pickOnClick(event: InputEventMouseButton): string | undefined;
+    /**
+     * 获取指定视图坐标下的可交互元素 ID。
+     * @param point 视图坐标
+     * @returns 按命中优先级排列的元素 ID
+     */
+    hitTest(point: Vector2): string[];
+    /**
+     * 解析当前指针在焦点容器内的预选目标。
+     * @param point 指针视图坐标
+     * @returns 预选元素 ID
+     */
+    resolveHoverTarget(point: Vector2): string | undefined;
+    /**
+     * 解析并提交当前指针的预选目标。
+     * @param point 指针视图坐标
+     */
+    commitHoverTarget(point: Vector2): void;
+    /**
+     * 设置当前工具的预选绘制目标。
+     * @param itemId 元素 ID
+     */
+    setHoverOverlayTarget(itemId?: string): void;
+    /** 清空预选命中和绘制目标。 */
+    clearHover(): void;
+    /**
+     * 按当前焦点容器过滤交互命中。
+     * @param selectedIds 原始命中元素 ID
+     * @returns 可选元素 ID
+     */
+    filterSelectedItems(selectedIds: string[]): string[];
+    /**
+     * 添加忽略交互的元素 ID。
+     * @param ids 元素 ID
+     */
+    addIgnoreIds(ids: string[]): void;
+    /**
+     * 删除忽略交互的元素 ID。
+     * @param ids 元素 ID
+     */
+    deleteIgnoreIds(ids: string[]): void;
+    /**
+     * 添加忽略交互的元素名称。
+     * @param names 元素名称
+     */
+    addIgnoreNames(names: string[]): void;
+    /**
+     * 删除忽略交互的元素名称。
+     * @param names 元素名称
+     */
+    deleteIgnoreNames(names: string[]): void;
+    /**
+     * 替换忽略交互的元素名称。
+     * @param names 元素名称
+     */
+    setIgnoreNames(names: string[]): void;
+    /**
+     * 查找指针下最上层的未选元素。
+     * @param point 指针视图坐标
+     * @returns 未选元素 ID
+     */
+    findUnselectedItem(point: Vector2): string | undefined;
+    /**
+     * 创建一次行为派发使用的选区命中快照。
+     * @param point 命中检测坐标
+     * @returns 选区命中快照
+     */
+    createHitSnapshot(point: Vector2): SelectionHitSnapshot;
+    /**
+     * 判断坐标是否位于当前焦点容器的视图范围内。
+     * @param point 视图坐标
+     * @returns 是否位于当前焦点容器内
+     */
+    isPointInFocusedGroup(point: Vector2): boolean;
+    /**
+     * 判断坐标是否落在当前选区的视图包围内。
+     *
+     * 单选保留元素变换后四边形的精确命中；多选使用与变换线框一致的
+     * 整体轴对齐包围盒，使元素之间的选框空白区域也可用于拖动选区。
+     * @param point 视图坐标
+     * @returns 是否命中当前选区
+     */
+    isPointInSelectedViewBox(point: Vector2): boolean;
+    /**
+     * 判断坐标是否位于当前动效编辑容器的视图范围内。
+     * @param point 视图坐标
+     * @returns 是否位于当前动效容器内
+     */
+    isPointInEffectsEditScope(point: Vector2): boolean;
+    /**
+     * 将框选候选按当前动效编辑范围解析为可选元素。
+     *
+     * 默认模式把动效子树归并为容器；动效编辑模式只保留当前容器的内部元素。
+     * @param item 原始播放器元素
+     * @returns 当前模式下的框选候选；不可选时返回 undefined
+     */
+    resolveMarqueeSelectableItem(item: VFXItem): VFXItem | undefined;
+    /**
+     * 提交预选结果并在变化时发出事件。
+     * @param itemId 预选元素 ID
+     */
+    private commitHover;
+    /**
+     * 按场景层级归并原始命中元素。
+     * @param selectedIds 原始命中元素 ID
+     * @param groupFilter 可选的父组过滤条件
+     * @returns 归并后的元素 ID
+     */
+    private filterItemsByHierarchy;
+    /**
+     * 获取不高于当前焦点容器的最外层可选元素。
+     * @param item 原始命中元素
+     * @param groupFilter 可选的父组过滤条件
+     * @returns 当前层级可选元素
+     */
+    private getOutermostSelectableItem;
+    /**
+     * 判断元素名称是否在忽略列表中。
+     * @param id 元素 ID
+     * @returns 是否忽略该元素
+     */
+    private isIgnoredNameById;
+    /** @returns 选中元素及其后代组成的命中范围。 */
+    private getSelectedScopeIdSet;
+    /**
+     * 将动效子元素命中区域归并到动效容器。
+     * @param hitTestResult 原始命中结果
+     */
+    private refreshResultRegions;
+    /**
+     * 按渲染顺序和深度整理命中结果。
+     * @param hitTestResult 原始命中结果
+     * @param playerComposition 播放合成
+     * @returns 排序后的元素 ID
+     */
+    private reorderHitTestResult;
+    /**
+     * 将画板左上角扩展交互区的命中加入结果。
+     * @param mouse 指针视图坐标
+     * @param currentSelectedIds 当前命中元素 ID
+     * @returns 补充画板后的命中元素 ID
+     */
+    private preSelectedFrameOutBound;
+    /**
+     * 根据当前非空选区更新共同的最近父组；清空选区时保留已有焦点。
+     * @param selectedIds 当前选中元素 ID
+     */
+    private updateFocusedGroupFromSelection;
+    /**
+     * 获取元素从近到远的可聚焦父组。
+     * @param item 当前元素
+     * @returns 父组列表
+     */
+    private getGroupAncestors;
+    /**
+     * 判断元素是否可作为组内交互焦点。
+     * @param item 待检查元素
+     * @returns 是否为可聚焦 Group
+     */
+    private isSelectableGroup;
+    /**
+     * 判断原始命中元素能否直接进入选区。
+     * @param item 待检查元素
+     * @returns 是否可直接选择
+     */
+    private isDirectlySelectable;
+    /**
+     * 判断 ancestor 是否为 item 的运行时祖先。
+     * @param ancestor 候选祖先
+     * @param item 当前元素
+     * @returns 是否存在祖先关系
+     */
+    private isRuntimeAncestor;
+    /**
+     * 将选区归一化为不存在祖先关系的节点集合。
+     *
+     * 按输入顺序处理，后加入的交互目标胜出：深入子元素会移除已选祖先，
+     * 选择外层容器会移除已选后代
+     * @param ids 待提交的选中 ID
+     * @returns 保持稳定顺序的层级互斥选区
+     */
+    private normalizeHierarchySelection;
+    /**
+     * 比较两个有序 ID 列表。
+     * @param left 左侧 ID 列表
+     * @param right 右侧 ID 列表
+     * @returns 是否完全相同
+     */
+    private sameIds;
+}