@vvfx/artis 0.0.1-alpha.0

package/dist/core/command/commands/item-reorder-command.d.ts

@@ -0,0 +1,41 @@
+import type { Command } from '../types';
+import type { Store } from '../../store';
+import type { ItemService } from '../../service';
+export declare enum ReorderType {
+    BRING_TO_FRONT = "bringToFront",
+    SEND_TO_BACK = "sendToBack",
+    MOVE_UP = "moveUp",
+    MOVE_DOWN = "moveDown"
+}
+export type ItemReorderCommandArgs = {
+    itemId: string;
+    reorderType: ReorderType;
+    store: Store;
+    itemService: ItemService;
+};
+/**
+ * item.reorder - 修改元素图层顺序 Command
+ *
+ * execute/redo: 执行层级变更
+ * undo: 恢复原始位置
+ */
+export declare class ItemReorderCommand implements Command {
+    readonly id: string;
+    readonly commandId = "item.reorder";
+    private _itemId;
+    private _reorderType;
+    private _store;
+    private _itemService;
+    private _oldIndex;
+    /**
+     * 构造图层顺序调整 Command
+     * @param args 包含目标元素 ID、调整类型、Store 与 ItemService
+     */
+    constructor(args: ItemReorderCommandArgs);
+    /** 按调整类型变更元素在列表中的位置并同步渲染顺序 */
+    execute(): void;
+    /** 撤销：将元素恢复到调整前的位置并同步渲染顺序 */
+    undo(): void;
+    /** 重做：再次执行层级变更 */
+    redo(): void;
+}

package/dist/core/command/commands/item-replace-source-command.d.ts

@@ -0,0 +1,48 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type ItemReplaceSourceCommandArgs = {
+    itemId: string;
+    /** 新资源 URL（图片/视频/特效） */
+    newUrl: string;
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * item.replaceSource - 静默替换在线资源 Command（**不入 History**；pending 元素复用已有 loading）
+ *
+ * 自动按元素类型分发：sprite→image、video→video、effects→effects。调用方只传 {itemId,newUrl}，
+ * 无需关心元素类型，统一一个静默换源入口。
+ *
+ * **不入 History**：isHistorical=false。静默换源属于资源回流 / 在线热替换，非用户编辑动作，
+ * 不该被 undo/redo。undo/redo 实现保留作语义完整，但因不入栈不会被 CommandService 调用。
+ *
+ * 与 `sprite.image` / `video.source` 的区别：后者入 History 且 execute 走 withLoading 进 loading(gizmo 覆盖)；
+ * 本命令静默（不经 withLoading）且不入史，适合在线资源热替换 / 本地文件快速替换。
+ *
+ * execute: 替换为新 URL（auto 状态顺带按新资源原生尺寸收敛）
+ *
+ * 用法：`artis.command.execute('item.replaceSource', { itemId: id, newUrl })`。失败可经 `artis.item.getLoadError(id)` 观测。
+ */
+export declare class ItemReplaceSourceCommand implements Command {
+    readonly id: string;
+    readonly commandId = "item.replaceSource";
+    readonly isHistorical = false;
+    readonly params: Record<string, unknown>;
+    private _itemId;
+    private _newUrl;
+    private _oldUrl;
+    private _itemService;
+    private _store;
+    constructor(args: ItemReplaceSourceCommandArgs);
+    /** 替换为新资源（async，execute 契约为 void，故 fire-and-forget） */
+    execute(): void;
+    /** 回退为旧资源 */
+    undo(): void;
+    /** 重新应用新资源 */
+    redo(): void;
+    serializeReplay(): {
+        args: Record<string, unknown>;
+        replayable: false;
+    };
+}

package/dist/core/command/commands/item-set-font-family-command.d.ts

@@ -0,0 +1,46 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+export type ItemSetFontFamilyCommandArgs = {
+    itemId: string;
+    fontFamily: string;
+    fontUrl?: string;
+    itemService: ItemService;
+};
+/**
+ * item.setFontFamily - 修改文本元素字体 Command
+ *
+ * 对齐旧版 `setItemFontFamily(id, fontFamilyName, url)`：同时设置 fontFamily 与 fontUrl。
+ * fontFamily 通过 ItemService.updateTextContent 同步到 Player TextComponent；
+ * fontUrl 仅写入 ArtisItem.property（资源加载由上层保证）。
+ *
+ * execute/redo: 应用新字体并快照旧值
+ * undo: 还原旧 fontFamily / fontUrl
+ */
+export declare class ItemSetFontFamilyCommand implements Command {
+    readonly id: string;
+    readonly commandId = "item.setFontFamily";
+    private _itemId;
+    private _fontFamily;
+    private _fontUrl;
+    private _itemService;
+    private _oldFontFamily;
+    private _oldFontUrl;
+    private _captured;
+    /**
+     * 构造修改字体 Command
+     * @param args 包含目标文本元素 ID、新 fontFamily、可选 fontUrl 与 ItemService
+     */
+    constructor(args: ItemSetFontFamilyCommandArgs);
+    /** 应用新字体并首次快照旧值 */
+    execute(): void;
+    /** 撤销：还原为快照的旧 fontFamily / fontUrl */
+    undo(): void;
+    /** 重做：再次应用新 fontFamily / fontUrl */
+    redo(): void;
+    /**
+     * 将指定字体应用到目标元素并写入 fontUrl
+     * @param fontFamily 新的 fontFamily，为 undefined 则跳过同步
+     * @param fontUrl 新的 fontUrl，写入 ArtisItem.property
+     */
+    private _apply;
+}

package/dist/core/command/commands/item-set-generator-resource-command.d.ts

@@ -0,0 +1,40 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+export type ItemSetGeneratorResourceCommandArgs = {
+    itemId: string;
+    resourceUrl: string;
+    itemService: ItemService;
+};
+/**
+ * item.setGeneratorResource - 设置生成器资源 Command
+ *
+ * 对齐旧版 `setGeneratorResource`：generator 元素拿到资源后原地替换为
+ * sprite / video 元素（复用同一种子 ID）。
+ *
+ * execute/redo: 快照原 generator 的 Schema，再转换为目标类型元素，同步重捕真实 id
+ * undo: 删除转换后的元素，用快照重建原 generator，同步重捕真实 id
+ *
+ * id 契约（B + ii）：转换后元素 id 由 createItemCore 决定（Artis=schemaId 固定，
+ * SceneArtis=instanceId 会变），execute/undo/redo 均同步重捕 _itemId 维系链。
+ */
+export declare class ItemSetGeneratorResourceCommand implements Command {
+    readonly id: string;
+    readonly commandId = "item.setGeneratorResource";
+    private _itemId;
+    private _resourceUrl;
+    private _itemService;
+    private _generatorSnapshot;
+    /**
+     * 构造设置生成器资源 Command
+     * @param args 包含目标 generator 元素 ID、资源 URL 与 ItemService
+     */
+    constructor(args: ItemSetGeneratorResourceCommandArgs);
+    /** 快照原 generator Schema 并替换为 sprite/video 元素，同步重捕真实 id */
+    execute(): void;
+    /** 撤销：删除转换后的元素并用快照重建原 generator，同步重捕真实 id */
+    undo(): void;
+    /** 重做：再次应用资源转换，同步重捕真实 id */
+    redo(): void;
+    /** 转换后的元素真实 ID（execute 后同步可用，供 ArtisSDK 同步返回） */
+    get currentItemId(): string | undefined;
+}

package/dist/core/command/commands/item-transform-command.d.ts

@@ -0,0 +1,51 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type TransformData = Partial<{
+    position: [number, number];
+    rotation: number;
+    scale: [number, number];
+    width: number;
+    height: number;
+}>;
+export type ItemTransformCommandArgs = {
+    itemId: string;
+    newTransform: TransformData;
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * item.transform - 移动/缩放/旋转 Command
+ *
+ * execute: 应用新 transform
+ * undo: 恢复到旧 transform
+ * redo: 重新应用新 transform
+ * merge: 支持交互态合并（同一元素连续 transform 变更）
+ */
+export declare class ItemTransformCommand implements Command {
+    readonly id: string;
+    readonly commandId = "item.transform";
+    private _itemId;
+    private _newTransform;
+    private _oldTransform;
+    private _itemService;
+    private _store;
+    /**
+     * 构造 transform 变更 Command
+     * @param args 包含目标元素 ID、新 transform 数据、ItemService 与 Store
+     */
+    constructor(args: ItemTransformCommandArgs);
+    /** 应用新 transform 并快照旧 transform */
+    execute(): void;
+    /** 撤销：恢复到快照的旧 transform */
+    undo(): void;
+    /** 重做：重新应用新 transform */
+    redo(): void;
+    /**
+     * 交互态合并：同一元素的连续 transform 变更合并为一个 Command
+     * 保留最初的 oldTransform，更新 newTransform 为最新值。
+     * @param other 紧随其后的 Command 实例
+     * @returns 合并成功返回 true，否则返回 false
+     */
+    merge(other: Command): boolean;
+}

package/dist/core/command/commands/item-ungroup-command.d.ts

@@ -0,0 +1,34 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type ItemUngroupCommandArgs = {
+    groupId: string;
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * item.ungroup - 取消打组 Command
+ *
+ * execute: 删除 Group 元素（保留 children 信息用于 undo）
+ * undo: 恢复 Group 元素
+ * redo: 再次删除 Group
+ */
+export declare class ItemUngroupCommand implements Command {
+    readonly id: string;
+    readonly commandId = "item.ungroup";
+    private _groupId;
+    private _itemService;
+    private _store;
+    private _childrenIds;
+    /**
+     * 构造取消打组 Command
+     * @param args 包含目标 Group 元素 ID、ItemService 与 Store
+     */
+    constructor(args: ItemUngroupCommandArgs);
+    /** 删除 Group 元素并记录原 children 用于撤销 */
+    execute(): void;
+    /** 撤销：恢复 Group 元素（携带原 children），同步重捕真实 id */
+    undo(): void;
+    /** 重做：再次删除 Group 元素 */
+    redo(): void;
+}

package/dist/core/command/commands/item-update-property-by-create-info-command.d.ts

@@ -0,0 +1,41 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { ItemSchema } from '../../types';
+export type ItemUpdatePropertyBySchemaCommandArgs = {
+    schema: ItemSchema | ItemSchema[];
+    itemService: ItemService;
+};
+/**
+ * item.updatePropertyBySchema - 按 ItemSchema 批量更新元素属性 Command
+ *
+ * 根据 schema.id 找到已存在元素，用 schema.property 中提供的字段更新属性。
+ * 多个元素聚合为一条可撤销命令。
+ *
+ * execute/redo: 先快照受影响元素的当前 Schema，再应用新属性
+ * undo: 用快照的旧 Schema 还原
+ */
+export declare class ItemUpdatePropertyBySchemaCommand implements Command {
+    readonly id: string;
+    readonly commandId = "item.updatePropertyBySchema";
+    private _schemas;
+    private _itemService;
+    private _oldSchemas;
+    /**
+     * 构造按 Schema 更新属性 Command
+     * @param args 包含单个或多个 ItemSchema 与 ItemService
+     */
+    constructor(args: ItemUpdatePropertyBySchemaCommandArgs);
+    /** 快照受影响元素的当前 Schema 并应用新属性 */
+    execute(): void;
+    /** 撤销：用快照的旧 Schema 还原属性 */
+    undo(): void;
+    /** 重做：再次应用新 Schema */
+    redo(): void;
+    /** 同步 Command 契约下观察异步应用失败，并回流统一错误事件。 */
+    private _applySchemas;
+    /**
+     * 快照本次将被修改的所有元素的当前 Schema（仅保留存在的元素）。
+     * @returns 受影响元素的当前 Schema 列表
+     */
+    private _snapshotCurrent;
+}

package/dist/core/command/commands/item-update-property-command.d.ts

@@ -0,0 +1,82 @@
+import type { Command } from '../types';
+import type { Store } from '../../store';
+import type { ItemService } from '../../service';
+/**
+ * 属性更新支持的 propertyKey 类型
+ *
+ * Transform 类属性（通过 ItemService.updateItemTransform 同步 Player）:
+ * - position, rotation, scale, width, height
+ *
+ * Text 类属性（通过 ItemService.updateTextContent 同步 Player TextComponent）:
+ * - text, fontSize, fontFamily
+ *
+ * Sprite 类属性（通过 ItemService.updateSpriteImage 同步 Player SpriteComponent）:
+ * - image
+ *
+ * 通用属性（仅修改 ArtisItem.property，不需要同步 Player）:
+ * - 其他自定义属性
+ */
+export type ItemUpdatePropertyCommandArgs = {
+    itemId: string;
+    propertyKey: string;
+    newValue: unknown;
+    store: Store;
+    itemService: ItemService;
+};
+/**
+ * item.updateProperty - 修改元素属性 Command
+ *
+ * execute/redo: 设置新属性值，并同步到 Player 对应元素
+ * undo: 恢复旧属性值，并同步到 Player 对应元素
+ * merge: 同一元素同一属性的连续修改可合并
+ *
+ * 参考旧版 pageDataUtils 中 Operator 的 updatePlayerProperty 逻辑：
+ * 不同类型的属性通过不同的 ItemService 方法同步到 Player 层。
+ */
+export declare class ItemUpdatePropertyCommand implements Command {
+    readonly id: string;
+    readonly commandId = "item.updateProperty";
+    /**
+     * 生命周期事件 payload（由 execute 填充，供 CommandService.onCommandLifecycle
+     * 中央监听在 undo/redo 时从实例读取；工厂此时已退场）。
+     */
+    eventPayload?: Record<string, unknown>;
+    private _itemId;
+    private _propertyKey;
+    private _newValue;
+    private _oldValue;
+    private _store;
+    private _itemService;
+    /**
+     * 构造属性更新 Command
+     * @param args 包含目标元素 ID、属性 key、新值、Store 与 ItemService
+     */
+    constructor(args: ItemUpdatePropertyCommandArgs);
+    /** 设置新属性值并同步到 Player（拦截非法 layoutMode 修改） */
+    execute(): void;
+    /** 撤销：恢复旧属性值并同步到 Player */
+    undo(): void;
+    /** 重做：重新应用新属性值并同步到 Player */
+    redo(): void;
+    /**
+     * 同一元素同一属性的连续修改可合并。
+     * @param other 紧随其后的 Command 实例
+     * @returns 合并成功返回 true，否则返回 false
+     */
+    merge(other: Command): boolean;
+    /**
+     * 获取目标属性的当前值。
+     * @returns 当前属性值，元素不存在时返回 undefined
+     */
+    private getPropertyValue;
+    /**
+     * 应用属性值并同步到 Player
+     * 参考旧版 Operator 的分发逻辑：
+     * - Transform 属性 → ItemService.updateItemTransform（同步 VFXItem.transform）
+     * - Text 属性 → ItemService.updateTextContent（同步 TextComponent）
+     * - image 属性 → ItemService.updateSpriteImage（同步 SpriteComponent）
+     * - 其他属性 → 仅写入 ArtisItem.property
+     * @param value 待应用的新属性值
+     */
+    private applyValue;
+}

package/dist/core/command/commands/mask-commit-command.d.ts

@@ -0,0 +1,53 @@
+import type { Command } from '../types';
+/**
+ * Mask 笔画线段数据
+ */
+export type MaskLine = {
+    points: [number, number][];
+    brushSize: number;
+    isEraser: boolean;
+    /**
+     * 形状类型：'stroke' 折线（默认），'rect' 矩形框选（points=[起点, 终点] 归一化）。
+     * 透传该字段以保证 undo/redo 时 rect 笔画不退化为 2 点折线。
+     */
+    shape?: 'stroke' | 'rect';
+};
+export type MaskCommitCommandArgs = {
+    /** 当前交互产生的新笔画 */
+    newLines: MaskLine[];
+    /** 交互前的所有笔画 */
+    oldLines: MaskLine[];
+    /** 交互后的贴图快照（base64 或像素数据） */
+    newTextureSnapshot: string;
+    /** 交互前的贴图快照 */
+    oldTextureSnapshot: string;
+    /** 应用 mask 状态的回调 */
+    applyMask: (lines: MaskLine[], textureSnapshot: string) => void;
+};
+/**
+ * mask.commit - 提交 Mask 区域 Command
+ *
+ * execute: 应用新的 mask 笔画 + 贴图
+ * undo: 恢复到交互前的笔画 + 贴图
+ * redo: 重新应用新的笔画 + 贴图
+ */
+export declare class MaskCommitCommand implements Command {
+    readonly id: string;
+    readonly commandId = "mask.commit";
+    private _newLines;
+    private _oldLines;
+    private _newTextureSnapshot;
+    private _oldTextureSnapshot;
+    private _applyMask;
+    /**
+     * 构造 Mask 提交 Command
+     * @param args 包含新旧笔画、新旧贴图快照与 applyMask 回调
+     */
+    constructor(args: MaskCommitCommandArgs);
+    /** 应用新的 mask 笔画与贴图 */
+    execute(): void;
+    /** 撤销：恢复到交互前的笔画与贴图 */
+    undo(): void;
+    /** 重做：重新应用新的笔画与贴图 */
+    redo(): void;
+}

package/dist/core/command/commands/page-auto-layout-command.d.ts

@@ -0,0 +1,53 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+import type { PageAutoLayoutParam } from '../../types';
+export type PageAutoLayoutCommandArgs = {
+    param: PageAutoLayoutParam;
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * page.autoLayout - 页面自动排布 Command
+ *
+ * execute: 记录所有受影响元素的旧 position，再执行自动排布
+ * undo: 把受影响元素的 position 恢复到排布前
+ * redo: 重新执行自动排布
+ *
+ * 说明：自动排布仅改变元素 position（不改尺寸/旋转），因此只需记录并恢复 position 即可。
+ * 视口 fitToBox 不属于数据变更，不纳入撤销范围。
+ */
+export declare class PageAutoLayoutCommand implements Command {
+    readonly id: string;
+    readonly commandId = "page.autoLayout";
+    private _param;
+    private _itemService;
+    private _store;
+    private _oldPositions;
+    /**
+     * 构造页面自动排布命令，缓存参数与上下文
+     * @param args 命令参数（含排布配置、ItemService、Store）
+     */
+    constructor(args: PageAutoLayoutCommandArgs);
+    /**
+     * 首次执行时记录顶层元素旧 position，再执行自动排布
+     */
+    execute(): void;
+    /**
+     * 将受影响元素的 position 恢复到排布前；无快照时不操作
+     */
+    undo(): void;
+    /**
+     * 重新执行自动排布
+     */
+    redo(): void;
+    /**
+     * 收集所有顶层元素（无 parentId）的当前 position 作为撤销快照。
+     *
+     * 与 ItemService.autoLayoutPage 的参与范围保持一致：
+     * - 指定 ids 时仅记录这些元素
+     * - 否则记录全部顶层元素
+     * @returns 顶层元素 id 到其 position 的快照映射
+     */
+    private _collectTopLevelPositions;
+}

package/dist/core/command/commands/picture-cut-commit-command.d.ts

@@ -0,0 +1,43 @@
+import type { Command } from '../types';
+/**
+ * 归一化包围盒（0~1 范围）
+ */
+export type NormalizedBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type PictureCutCommitCommandArgs = {
+    /** 新的裁切包围盒 */
+    newBox: NormalizedBox;
+    /** 交互前的裁切包围盒 */
+    oldBox: NormalizedBox;
+    /** 应用裁切区域的回调 */
+    applyBox: (box: NormalizedBox) => void;
+};
+/**
+ * pictureCut.commit - 提交裁切区域 Command
+ *
+ * execute: 应用新的裁切包围盒
+ * undo: 恢复到交互前的裁切包围盒
+ * redo: 重新应用新的裁切包围盒
+ */
+export declare class PictureCutCommitCommand implements Command {
+    readonly id: string;
+    readonly commandId = "pictureCut.commit";
+    private _newBox;
+    private _oldBox;
+    private _applyBox;
+    /**
+     * 构造裁切提交命令，缓存新旧包围盒与应用回调
+     * @param args 命令参数（含新旧裁切包围盒与 applyBox 回调）
+     */
+    constructor(args: PictureCutCommitCommandArgs);
+    /** 应用新的裁切包围盒 */
+    execute(): void;
+    /** 恢复到交互前的裁切包围盒 */
+    undo(): void;
+    /** 重新应用新的裁切包围盒 */
+    redo(): void;
+}

package/dist/core/command/commands/picture-expand-commit-command.d.ts

@@ -0,0 +1,35 @@
+import type { Command } from '../types';
+import type { NormalizedBox } from './picture-cut-commit-command';
+export type PictureExpandCommitCommandArgs = {
+    /** 新的扩图包围盒 */
+    newBox: NormalizedBox;
+    /** 交互前的扩图包围盒 */
+    oldBox: NormalizedBox;
+    /** 应用扩图区域的回调 */
+    applyBox: (box: NormalizedBox) => void;
+};
+/**
+ * pictureExpand.commit - 提交扩图区域 Command
+ *
+ * execute: 应用新的扩图包围盒
+ * undo: 恢复到交互前的扩图包围盒
+ * redo: 重新应用新的扩图包围盒
+ */
+export declare class PictureExpandCommitCommand implements Command {
+    readonly id: string;
+    readonly commandId = "pictureExpand.commit";
+    private _newBox;
+    private _oldBox;
+    private _applyBox;
+    /**
+     * 构造扩图提交命令，缓存新旧包围盒与应用回调
+     * @param args 命令参数（含新旧扩图包围盒与 applyBox 回调）
+     */
+    constructor(args: PictureExpandCommitCommandArgs);
+    /** 应用新的扩图包围盒 */
+    execute(): void;
+    /** 恢复到交互前的扩图包围盒 */
+    undo(): void;
+    /** 重新应用新的扩图包围盒 */
+    redo(): void;
+}

package/dist/core/command/commands/scene-switch-command.d.ts

@@ -0,0 +1,35 @@
+import type { Command } from '../types';
+export type SceneSwitchCommandArgs = {
+    /** 目标场景索引 */
+    targetIndex: number;
+    /** 切换前场景索引 */
+    previousIndex: number;
+    /** 执行场景切换的回调（由外部使用者提供） */
+    applySwitchScene: (index: number) => Promise<void>;
+};
+/**
+ * SceneSwitchCommand - 场景切换命令
+ *
+ * 将场景切换纳入共享历史栈，支持 undo/redo：
+ * - execute/redo：切换到目标场景
+ * - undo：切回上一个场景
+ *
+ * 注意：applySwitchScene 是异步的，但 Command 接口为同步，
+ * 通过 void 触发异步操作（fire-and-forget）。
+ */
+export declare class SceneSwitchCommand implements Command {
+    readonly id: string;
+    readonly commandId = "scene.switch";
+    private _args;
+    /**
+     * 构造场景切换命令，缓存切换参数与回调
+     * @param args 命令参数（含目标/原场景索引与 applySwitchScene 回调）
+     */
+    constructor(args: SceneSwitchCommandArgs);
+    /** 异步切换到目标场景（fire-and-forget） */
+    execute(): void;
+    /** 异步切回上一个场景（fire-and-forget） */
+    undo(): void;
+    /** 重新切换到目标场景 */
+    redo(): void;
+}

package/dist/core/command/commands/selection-set-command.d.ts

@@ -0,0 +1,38 @@
+import type { Command } from '../types';
+export type SelectionSetCommandArgs = {
+    newSelectedIds: string[];
+    oldSelectedIds: string[];
+    applySelection: (ids: string[]) => void;
+};
+/**
+ * selection.set - 设置/清空选中元素 Command
+ *
+ * execute: 设置新的选中元素
+ * undo: 恢复上一次选中状态
+ * redo: 重新设置选中元素
+ * merge: 连续选中操作合并（保留最初 old，更新 new）
+ */
+export declare class SelectionSetCommand implements Command {
+    readonly id: string;
+    readonly commandId = "selection.set";
+    private _newSelectedIds;
+    private _oldSelectedIds;
+    private _applySelection;
+    /**
+     * 构造选中设置命令，缓存新旧选中 id 与应用回调
+     * @param args 命令参数（含新旧选中 id 列表与 applySelection 回调）
+     */
+    constructor(args: SelectionSetCommandArgs);
+    /** 设置新的选中元素 */
+    execute(): void;
+    /** 恢复上一次选中状态 */
+    undo(): void;
+    /** 重新设置选中元素 */
+    redo(): void;
+    /**
+     * 与同类型后续选中命令合并：保留最初 old，更新 new
+     * @param other 紧随其后的命令
+     * @returns 合并成功返回 true，否则 false
+     */
+    merge(other: Command): boolean;
+}