@vvfx/artis 0.0.1-alpha.0

package/dist/core/command/commands/sprite-image-command.d.ts

@@ -0,0 +1,36 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type SpriteImageCommandArgs = {
+    itemId: string;
+    newImageUrl: string;
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * sprite.image - 修改 Sprite 元素贴图 Command
+ *
+ * execute: 将元素贴图替换为新 URL
+ * undo: 恢复旧贴图
+ * redo: 重新应用新贴图
+ */
+export declare class SpriteImageCommand implements Command {
+    readonly id: string;
+    readonly commandId = "sprite.image";
+    private _itemId;
+    private _newImageUrl;
+    private _oldImageUrl;
+    private _itemService;
+    private _store;
+    /**
+     * 构造贴图修改命令，并从 store 中快照旧贴图 URL
+     * @param args 命令参数（含元素 id、新贴图 URL、ItemService、Store）
+     */
+    constructor(args: SpriteImageCommandArgs);
+    /** 将元素贴图替换为新 URL */
+    execute(): void;
+    /** 恢复旧贴图 */
+    undo(): void;
+    /** 重新应用新贴图 */
+    redo(): void;
+}

package/dist/core/command/commands/sprite-text-edit-commit-command.d.ts

@@ -0,0 +1,43 @@
+import type { Command } from '../types';
+export type SpriteTextInfo = {
+    text: string;
+    fontSize: number;
+    fontFamily: string;
+    color: [number, number, number, number];
+    /** 其他可能变化的属性 */
+    [key: string]: unknown;
+};
+export type SpriteTextEditCommitCommandArgs = {
+    /** 目标元素 ID（须为 player instanceId；Artis 侧 toVfxItemId 翻译后传入，SceneArtis 直传） */
+    itemId: string;
+    newTextInfo: SpriteTextInfo;
+    oldTextInfo: SpriteTextInfo;
+    /** 应用 SpriteText 信息的回调；itemId 语义同上，为 instanceId */
+    applyTextInfo: (itemId: string, info: SpriteTextInfo) => void;
+};
+/**
+ * spriteTextEdit.commit - SpriteText 编辑提交 Command
+ *
+ * execute: 应用编辑后的 SpriteText 信息
+ * undo: 恢复到编辑前的 SpriteText 信息
+ * redo: 重新应用编辑后的信息
+ */
+export declare class SpriteTextEditCommitCommand implements Command {
+    readonly id: string;
+    readonly commandId = "spriteTextEdit.commit";
+    private _itemId;
+    private _newTextInfo;
+    private _oldTextInfo;
+    private _applyTextInfo;
+    /**
+     * 构造 SpriteText 编辑提交命令，缓存新旧文本信息与回调
+     * @param args 命令参数（含元素 id、新旧 SpriteText 信息与 applyTextInfo 回调）
+     */
+    constructor(args: SpriteTextEditCommitCommandArgs);
+    /** 应用编辑后的 SpriteText 信息 */
+    execute(): void;
+    /** 恢复到编辑前的 SpriteText 信息 */
+    undo(): void;
+    /** 重新应用编辑后的信息 */
+    redo(): void;
+}

package/dist/core/command/commands/state-hand-command.d.ts

@@ -0,0 +1,14 @@
+import type { StateNavigator } from '../../state';
+import { StateSwitchCommandBase } from './state-switch-command-base';
+export type StateHandCommandArgs = {
+    states: StateNavigator;
+};
+/**
+ * state.hand - 切到「手型」平移视图态 Command（不入 History）
+ *
+ * 业务方：`artis.command.execute('state.hand')`。
+ */
+export declare class StateHandCommand extends StateSwitchCommandBase {
+    readonly commandId = "state.hand";
+    constructor(args: StateHandCommandArgs);
+}

package/dist/core/command/commands/state-image-cut-command.d.ts

@@ -0,0 +1,14 @@
+import type { StateNavigator } from '../../state';
+import { StateSwitchCommandBase } from './state-switch-command-base';
+export type StateImageCutCommandArgs = {
+    states: StateNavigator;
+};
+/**
+ * state.imageCut - 切到「图片裁剪」态 Command（不入 History）
+ *
+ * 业务方：`artis.command.execute('state.imageCut')`。
+ */
+export declare class StateImageCutCommand extends StateSwitchCommandBase {
+    readonly commandId = "state.imageCut";
+    constructor(args: StateImageCutCommandArgs);
+}

package/dist/core/command/commands/state-image-expand-command.d.ts

@@ -0,0 +1,14 @@
+import type { StateNavigator } from '../../state';
+import { StateSwitchCommandBase } from './state-switch-command-base';
+export type StateImageExpandCommandArgs = {
+    states: StateNavigator;
+};
+/**
+ * state.imageExpand - 切到「图片扩边」态 Command（不入 History）
+ *
+ * 业务方：`artis.command.execute('state.imageExpand')`。
+ */
+export declare class StateImageExpandCommand extends StateSwitchCommandBase {
+    readonly commandId = "state.imageExpand";
+    constructor(args: StateImageExpandCommandArgs);
+}

package/dist/core/command/commands/state-image-mask-command.d.ts

@@ -0,0 +1,15 @@
+import type { StateNavigator } from '../../state';
+import { StateSwitchCommandBase } from './state-switch-command-base';
+export type StateImageMaskCommandArgs = {
+    states: StateNavigator;
+};
+/**
+ * state.imageMask - 切到「图片蒙版」态 Command（不入 History）
+ *
+ * 业务方：`artis.command.execute('state.imageMask')`。
+ * 笔刷大小等蒙版偏好仍走 `artis.gizmoManager.configs.set(maskConfig, { brushSize })`。
+ */
+export declare class StateImageMaskCommand extends StateSwitchCommandBase {
+    readonly commandId = "state.imageMask";
+    constructor(args: StateImageMaskCommandArgs);
+}

package/dist/core/command/commands/state-image-text-edit-command.d.ts

@@ -0,0 +1,14 @@
+import type { StateNavigator } from '../../state';
+import { StateSwitchCommandBase } from './state-switch-command-base';
+export type StateImageTextEditCommandArgs = {
+    states: StateNavigator;
+};
+/**
+ * state.imageTextEdit - 切到「图文编辑」态 Command（不入 History）
+ *
+ * 业务方：`artis.command.execute('state.imageTextEdit')`。
+ */
+export declare class StateImageTextEditCommand extends StateSwitchCommandBase {
+    readonly commandId = "state.imageTextEdit";
+    constructor(args: StateImageTextEditCommandArgs);
+}

package/dist/core/command/commands/state-item-create-command.d.ts

@@ -0,0 +1,34 @@
+import type { StateNavigator } from '../../state';
+import { ItemCreateType } from '@vvfx/gizmo';
+import { StateSwitchCommandBase } from './state-switch-command-base';
+export type StateItemCreateCommandArgs = {
+    /** 进入的交互创建类型（TEXT/FRAME/VIDEO_GENERATOR/IMAGE_GENERATOR）。缺省 FRAME。 */
+    createType?: ItemCreateType;
+    states: StateNavigator;
+    getCreateType: () => ItemCreateType;
+    setCreateType: (value: ItemCreateType) => void;
+};
+/**
+ * state.itemCreate - 进入「元素交互创建」态 Command（不入 History）
+ *
+ * 继承 {@link StateSwitchCommandBase}（切到 itemCreate 态、undo 回前态），额外在 execute/undo 增补：
+ * 设 item-create gizmo 的 `createType`（TEXT/FRAME/VIDEO_GENERATOR/IMAGE_GENERATOR）。
+ *
+ * 设计：交互态创建本质是"交互态收集 schema → 调 item.create"，本命令只负责"进入态 + 配 createType"；
+ * 用户在画布上的创建动作由 ItemCreateGizmo 收集后经 BaseArtis._handleGizmoEvent 调 item.create 收尾。
+ *
+ * 命名归 state.* 体系（本质是切态进 itemCreate，而非建元素）。绑定旧 `openItemCreateGizmo` 兼容入口。
+ *
+ * 业务方：`artis.command.execute('state.itemCreate', { createType: ItemCreateType.TEXT })`。
+ */
+export declare class StateItemCreateCommand extends StateSwitchCommandBase {
+    readonly commandId = "state.itemCreate";
+    private readonly _createType;
+    private readonly _prevCreateType;
+    private readonly _setCreateType;
+    constructor(args: StateItemCreateCommandArgs);
+    /** 进入 itemCreate 态并设 gizmo createType */
+    execute(): void;
+    /** 退出：切回前态 + 还原 gizmo createType */
+    undo(): void;
+}

package/dist/core/command/commands/state-move-command.d.ts

@@ -0,0 +1,14 @@
+import type { StateNavigator } from '../../state';
+import { StateSwitchCommandBase } from './state-switch-command-base';
+export type StateMoveCommandArgs = {
+    states: StateNavigator;
+};
+/**
+ * state.move - 切回默认「移动」态 Command（不入 History）
+ *
+ * 业务方：`artis.command.execute('state.move')`。退出其他工具态回到移动选区态。
+ */
+export declare class StateMoveCommand extends StateSwitchCommandBase {
+    readonly commandId = "state.move";
+    constructor(args: StateMoveCommandArgs);
+}

package/dist/core/command/commands/state-switch-command-base.d.ts

@@ -0,0 +1,41 @@
+import type { Command } from '../types';
+import type { StateNavigator, StateId } from '../../state';
+/**
+ * 切换交互态 Command 基类。
+ *
+ * 把"切换 gizmo 态"收口为 command 体系，Command 仅依赖 StateNavigator，
+ * 业务方走 `artis.command.execute('state.xxx')`。子类只需固定 `commandId` + `stateId`，execute/undo/redo 复用本基类。
+ *
+ * - execute: 切到目标 stateId；undo: 切回构造期快照的前态（保证 undo 能退出该态）
+ * - **isHistorical=false：不入 History**（交互态切换是 UI 转场/工具切换，非数据编辑，不该被 undo/redo 干扰）
+ * - 前态快照取 `states.activeState.id`，undo 时还原；若前态与目标态相同则 activate 内部幂等
+ *
+ * 复杂态（所进态还需额外配置，如 itemCreate 要设 gizmo.createType）覆写 execute/undo 增补配置即可。
+ */
+export declare abstract class StateSwitchCommandBase implements Command {
+    abstract readonly commandId: string;
+    readonly id: string;
+    readonly isHistorical = false;
+    /** 可变（Command.params 接口允许，子类可在 super 后累加 createType 等额外字段） */
+    params: Record<string, unknown>;
+    protected readonly _stateId: StateId;
+    protected readonly _states: StateNavigator;
+    protected readonly _source?: any;
+    /** 构造期快照的前态 id，供 undo 还原 */
+    protected readonly _prevStateId: StateId;
+    constructor(args: {
+        commandId: string;
+        stateId: StateId;
+        states: StateNavigator;
+        source?: any;
+    });
+    /** 切到目标态 */
+    execute(): void;
+    /** 切回前态 */
+    undo(): void;
+    redo(): void;
+    serializeReplay(): {
+        args: Record<string, unknown>;
+        replayable: false;
+    };
+}

package/dist/core/command/commands/text-move-command.d.ts

@@ -0,0 +1,47 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type TextMoveCommandArgs = {
+    itemId: string;
+    deltaPosition: [number, number];
+    itemService: ItemService;
+    store: Store;
+    /** 交互前的旧 position。若不传，则在首次 execute 时从 store 中捕获 */
+    oldPosition?: [number, number];
+};
+/**
+ * text.move - 移动文本元素 Command（单元素）
+ *
+ * execute: 按 delta 移动文本元素
+ * undo: 恢复到移动前的 position
+ * redo: 重新应用移动
+ * merge: 连续移动合并（累加 delta）
+ */
+export declare class TextMoveCommand implements Command {
+    readonly id: string;
+    readonly commandId = "text.move";
+    private _itemId;
+    private _deltaPosition;
+    private _oldPosition;
+    private _itemService;
+    private _store;
+    /**
+     * 构造文本移动命令，缓存目标元素与位移量
+     * @param args 命令参数（含元素 id、位移量、ItemService、Store 及可选旧 position）
+     */
+    constructor(args: TextMoveCommandArgs);
+    /**
+     * 按位移量移动目标元素；元素不存在或已捕获旧值时跳过记录
+     */
+    execute(): void;
+    /** 恢复到移动前的 position */
+    undo(): void;
+    /** 重新应用移动 */
+    redo(): void;
+    /**
+     * 与同元素后续移动命令合并：累加 delta
+     * @param other 紧随其后的命令
+     * @returns 同元素合并成功返回 true，否则 false
+     */
+    merge(other: Command): boolean;
+}

package/dist/core/command/commands/text-rotate-command.d.ts

@@ -0,0 +1,52 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type TextRotateCommandArgs = {
+    itemId: string;
+    newRotation: number;
+    newPosition: [number, number];
+    itemService: ItemService;
+    store: Store;
+    /** 交互前的旧 rotation。若不传，则在首次 execute 时从 store 中捕获 */
+    oldRotation?: number;
+    /** 交互前的旧 position。若不传，则在首次 execute 时从 store 中捕获 */
+    oldPosition?: [number, number];
+};
+/**
+ * text.rotate - 旋转文本元素 Command（单元素）
+ *
+ * execute: 应用新的 rotation + position
+ * undo: 恢复到旋转前的值
+ * redo: 重新应用旋转后的值
+ * merge: 连续旋转合并（保留最初 old，更新 new）
+ */
+export declare class TextRotateCommand implements Command {
+    readonly id: string;
+    readonly commandId = "text.rotate";
+    private _itemId;
+    private _newRotation;
+    private _newPosition;
+    private _oldRotation;
+    private _oldPosition;
+    private _itemService;
+    private _store;
+    /**
+     * 构造文本旋转命令，缓存目标元素与新旧 rotation/position
+     * @param args 命令参数（含元素 id、新 rotation/position、ItemService、Store 及可选旧值）
+     */
+    constructor(args: TextRotateCommandArgs);
+    /**
+     * 应用新的 rotation + position；元素不存在时跳过
+     */
+    execute(): void;
+    /** 恢复到旋转前的 rotation + position */
+    undo(): void;
+    /** 重新应用旋转后的值 */
+    redo(): void;
+    /**
+     * 与同元素后续旋转命令合并：保留最初 old，更新 new
+     * @param other 紧随其后的命令
+     * @returns 同元素合并成功返回 true，否则 false
+     */
+    merge(other: Command): boolean;
+}

package/dist/core/command/commands/text-scale-command.d.ts

@@ -0,0 +1,56 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type TextScaleSnapshot = {
+    position: [number, number];
+    scale: [number, number];
+    width: number;
+    height: number;
+    fontSize: number;
+    lineHeight: number;
+};
+export type TextScaleCommandArgs = {
+    itemId: string;
+    newSnapshot: TextScaleSnapshot;
+    itemService: ItemService;
+    store: Store;
+    /** 交互前的旧快照。若不传，则在首次 execute 时从 store 中捕获 */
+    oldSnapshot?: TextScaleSnapshot;
+};
+/**
+ * text.scale - 缩放文本元素 Command（单元素）
+ *
+ * execute: 应用新的 scale/size/position
+ * undo: 恢复到缩放前的值
+ * redo: 重新应用缩放后的值
+ * merge: 连续缩放合并（保留最初 old，更新 new）
+ */
+export declare class TextScaleCommand implements Command {
+    readonly id: string;
+    readonly commandId = "text.scale";
+    private _itemId;
+    private _newSnapshot;
+    private _oldSnapshot;
+    private _itemService;
+    private _store;
+    /**
+     * 初始化文本缩放命令，记录目标元素与新旧快照
+     * @param args 命令参数（itemId、新快照、itemService、store、可选旧快照）
+     */
+    constructor(args: TextScaleCommandArgs);
+    private _applySnapshot;
+    /**
+     * 应用新快照到目标文本元素，首次执行时若未提供旧快照则从 store 捕获
+     */
+    execute(): void;
+    /** 撤销缩放，恢复到旧快照（无旧快照时跳过） */
+    undo(): void;
+    /** 重做缩放，重新应用新快照 */
+    redo(): void;
+    /**
+     * 合并连续的同元素缩放命令，保留最初旧快照、更新新快照为目标值
+     * @param other 后续命令
+     * @returns 是否合并成功
+     */
+    merge(other: Command): boolean;
+}

package/dist/core/command/commands/text-update-content-command.d.ts

@@ -0,0 +1,51 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type TextContentData = Partial<{
+    text: string;
+    fontSize: number;
+    fontFamily: string;
+    lineHeight: number;
+    color: [number, number, number, number];
+    fontWeight: number;
+    fontStyle: number;
+    textAlign: number;
+    outlineColor: [number, number, number, number];
+    outlineWidth: number;
+    outlineEnabled: boolean;
+}>;
+export type TextUpdateContentCommandArgs = {
+    itemId: string;
+    newContent: TextContentData;
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * text.updateContent - 修改文本内容/样式 Command
+ *
+ * execute: 应用新文本内容/样式
+ * undo: 恢复旧文本内容/样式
+ * redo: 重新应用新文本内容/样式
+ */
+export declare class TextUpdateContentCommand implements Command {
+    readonly id: string;
+    readonly commandId = "text.updateContent";
+    private _itemId;
+    private _newContent;
+    private _oldContent;
+    private _itemService;
+    private _store;
+    /**
+     * 初始化文本内容/样式修改命令
+     * @param args 命令参数（itemId、新内容、itemService、store）
+     */
+    constructor(args: TextUpdateContentCommandArgs);
+    /**
+     * 应用新文本内容/样式，首次执行时按新内容字段从 store 捕获旧值
+     */
+    execute(): void;
+    /** 撤销修改，恢复旧文本内容/样式（无旧值时跳过） */
+    undo(): void;
+    /** 重做修改，重新应用新文本内容/样式 */
+    redo(): void;
+}

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

@@ -0,0 +1,56 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type TransformMoveCommandArgs = {
+    itemIds: string[];
+    deltaPosition: [number, number];
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * transform.move - 移动元素 Command（支持多选）
+ *
+ * execute: 按 delta 移动所有目标元素
+ * undo: 恢复到移动前的 position
+ * redo: 重新应用移动
+ * merge: 同一批元素连续移动合并（累加 delta）
+ */
+export declare class TransformMoveCommand implements Command {
+    readonly id: string;
+    readonly commandId = "transform.move";
+    private _itemIds;
+    private _deltaPosition;
+    private _oldPositions;
+    private _itemService;
+    private _store;
+    /**
+     * 初始化移动命令，记录目标元素与位移量
+     * @param args 命令参数（itemIds、deltaPosition、itemService、store）
+     */
+    constructor(args: TransformMoveCommandArgs);
+    /** 返回受影响的元素 ID 列表 */
+    get itemIds(): string[];
+    /** 返回各元素移动前的原始位置快照 */
+    get oldPositions(): Map<string, [number, number]>;
+    /** 按 delta 移动所有目标元素，首次执行时记录各元素原始位置 */
+    execute(): void;
+    /** 撤销移动，将各元素恢复到原始位置 */
+    undo(): void;
+    /** 重做移动，基于原始位置叠加 delta 得到新位置 */
+    redo(): void;
+    /**
+     * 合并连续的同批元素移动命令，累加位移量
+     * @param other 后续命令
+     * @returns 是否合并成功
+     */
+    merge(other: Command): boolean;
+    /**
+     * 序列化为可重放入参：输出累加合并后的纯数据（itemIds + deltaPosition）。
+     * 复现页据此直接 new TransformMoveCommand({...}) 重建，无需工厂/服务引用。
+     * 命令已合并过 delta，故输出的 delta 是最终累加值（修复交互态 merge 后只存末次 delta 的问题）。
+     */
+    serializeReplay(): {
+        args: Record<string, unknown>;
+        replayable: boolean;
+    };
+}

package/dist/core/command/commands/transform-move-with-frame-change-command.d.ts

@@ -0,0 +1,80 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+export type FrameChangeSnapshot = {
+    /** 元素旧位置 */
+    positions: Map<string, [number, number]>;
+    /** 元素旧 parentId（undefined 表示根节点） */
+    parentIds: Map<string, string | undefined>;
+    /** 受影响 Frame 的旧 children */
+    frameChildren: Map<string, string[]>;
+};
+export type TransformMoveWithFrameChangeCommandArgs = {
+    itemIds: string[];
+    /** 新的元素位置 */
+    newPositions: Map<string, [number, number]>;
+    /** 新的 parentId（undefined 表示移出到根节点） */
+    newParentIds: Map<string, string | undefined>;
+    /** 受影响 Frame 的新 children */
+    newFrameChildren: Map<string, string[]>;
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * transform.moveWithFrameChange - 元素移动 + 移入/移出 Frame Command
+ *
+ * execute: 移动元素并变更 parentId + Frame.children
+ * undo: 恢复元素位置 + parentId + Frame.children
+ * redo: 重新应用
+ * merge: 同一批元素连续变化合并（保留最初 old，更新 new）
+ */
+export declare class TransformMoveWithFrameChangeCommand implements Command {
+    readonly id: string;
+    readonly commandId = "transform.moveWithFrameChange";
+    private _itemIds;
+    private _newPositions;
+    private _newParentIds;
+    private _newFrameChildren;
+    private _oldSnapshot;
+    private _itemService;
+    private _store;
+    /**
+     * 初始化移动+Frame 变更命令，记录目标元素与新旧位置/父子关系/Frame.children
+     * @param args 命令参数（itemIds、新位置、新 parentId、新 Frame.children、itemService、store）
+     */
+    constructor(args: TransformMoveWithFrameChangeCommandArgs);
+    /** 返回受影响的元素 ID 列表 */
+    get itemIds(): string[];
+    /** 返回首次执行时捕获的旧快照（位置/parentId/Frame.children） */
+    get oldSnapshot(): FrameChangeSnapshot | undefined;
+    /** 应用新位置与父子关系变更，首次执行时捕获旧快照 */
+    execute(): void;
+    /** 撤销变更，将位置/parentId/Frame.children 恢复到旧快照（无旧快照时跳过） */
+    undo(): void;
+    /** 重做变更，重新应用新位置/parentId/Frame.children */
+    redo(): void;
+    /**
+     * 应用一组变更（execute / undo / redo 共用）
+     *
+     * 分两阶段：
+     * 1. 父变化的元素：按目标 parentId 分组，委托 ItemService.moveItemsToFrame / moveItemsOutOfFrame
+     *    完成「Player setParent + transform 补偿 + parentId + Frame.children」一体化更新
+     * 2. 父未变的元素：直接 updateItemTransform 设置新位置
+     * 3. 用目标快照覆盖 Frame.children（确保最终一致，兼容外部传入的精确 children 序列）
+     * @param positions 目标位置
+     * @param parentIds 目标 parentId（undefined 表示根节点）
+     * @param frameChildren 目标 Frame.children
+     */
+    private _applyChanges;
+    /**
+     * 合并连续的同批元素变更命令，保留最初旧快照、更新新值为目标值
+     * @param other 后续命令
+     * @returns 是否合并成功
+     */
+    merge(other: Command): boolean;
+    /**
+     * 从 store 捕获元素当前位置/parentId 与所有相关 Frame 的 children，作为撤销依据
+     * @returns 旧状态快照（位置、parentId、Frame.children）
+     */
+    private _captureOldSnapshot;
+}

package/dist/core/command/commands/transform-move-with-layout-command.d.ts

@@ -0,0 +1,56 @@
+import type { Command } from '../types';
+import type { ItemService } from '../../service';
+import type { Store } from '../../store';
+import type { LayoutInfo } from '../../types';
+export type TransformMoveWithLayoutCommandArgs = {
+    itemIds: string[];
+    /** 所在 Frame 的 ID */
+    frameId: string;
+    /** 新的元素位置 */
+    newPositions: Map<string, [number, number]>;
+    /** 新的 Frame layoutInfos */
+    newFrameLayoutInfos: Record<string, LayoutInfo>;
+    itemService: ItemService;
+    store: Store;
+};
+/**
+ * transform.moveWithLayout - 元素移动 + Frame 内排布顺序变化 Command
+ *
+ * execute: 移动元素并更新 Frame 的 layoutInfos
+ * undo: 恢复元素位置 + Frame layoutInfos
+ * redo: 重新应用
+ * merge: 同一批元素 + 同一 Frame 连续变化合并
+ */
+export declare class TransformMoveWithLayoutCommand implements Command {
+    readonly id: string;
+    readonly commandId = "transform.moveWithLayout";
+    private _itemIds;
+    private _frameId;
+    private _newPositions;
+    private _newFrameLayoutInfos;
+    private _oldPositions;
+    private _oldFrameLayoutInfos;
+    private _itemService;
+    private _store;
+    /**
+     * 初始化移动+排布变更命令，记录目标元素、Frame 与新位置/新 layoutInfos
+     * @param args 命令参数（itemIds、frameId、新位置、新 layoutInfos、itemService、store）
+     */
+    constructor(args: TransformMoveWithLayoutCommandArgs);
+    /** 返回受影响的元素 ID 列表 */
+    get itemIds(): string[];
+    /** 返回各元素移动前的原始位置快照 */
+    get oldPositions(): Map<string, [number, number]>;
+    /** 应用新位置并更新 Frame 的 layoutInfos，首次执行时捕获旧值 */
+    execute(): void;
+    /** 撤销变更，恢复元素位置与 Frame 的旧 layoutInfos */
+    undo(): void;
+    /** 重做变更，重新应用新位置与新 layoutInfos */
+    redo(): void;
+    /**
+     * 合并连续的同批元素、同 Frame 变更命令，保留最初旧值、更新新值为目标值
+     * @param other 后续命令
+     * @returns 是否合并成功
+     */
+    merge(other: Command): boolean;
+}