@vvfx/artis 0.0.1-alpha.1 → 0.0.1-alpha.2

package/dist/artis/operations/operations.d.ts

@@ -472,6 +472,11 @@ export declare class Operations {
     openTextGizmo(itemId: string): void;
     /** 关闭文本编辑态。 */
     closeTextGizmo(): void;
+    /**
+     * 选中当前 TextGizmo 正在编辑的全部文字，并聚焦文本输入框。
+     * @returns TextGizmo 已就绪且存在正在编辑的文本时返回 true
+     */
+    selectAllText(): boolean;
     /**
      * 应用笔刷大小后开启蒙版 Gizmo；非法尺寸回退为 1。
      * @param brushSize 初始笔刷像素大小
@@ -504,14 +509,14 @@ export declare class Operations {
      */
     closeLoadingGizmo(id: string): void;
     /** 开启图片裁切 Gizmo。 */
-    openPictureCutGizmo(): void;
+    openImageCutGizmo(): void;
     /**
      * 设置图片裁切 Gizmo 是否锁定裁切框比例。
      * @param lock 是否锁定比例
      */
-    setPictureCutGizmoLockScale(lock: boolean): void;
+    setImageCutGizmoLockScale(lock: boolean): void;
     /**
-     * 获取当前裁切信息（归一化裁切框 + 元素视图框），委托 PictureCutGizmo.getCutInfo。
+     * 获取当前裁切信息（归一化裁切框 + 元素视图框），委托 ImageCutGizmo.getCutInfo。
      * @returns 裁切信息；Gizmo 未就绪 / 未选中单个元素 / 结果无效时返回 undefined
      */
     getCutInfo(): {
@@ -519,24 +524,24 @@ export declare class Operations {
         itemBox: Box2;
     } | undefined;
     /**
-     * 获取归一化裁切包围盒（min/max ∈ [0,1]，相对元素包围盒），委托 PictureCutGizmo.getCutBox。
+     * 获取归一化裁切包围盒（min/max ∈ [0,1]，相对元素包围盒），委托 ImageCutGizmo.getCutBox。
      * @returns 归一化裁切框；Gizmo 未就绪时返回 undefined
      */
     getCutBox(): Box2 | undefined;
     /**
-     * 设置归一化裁切包围盒（入参为归一化坐标），委托 PictureCutGizmo.setCutBox。
+     * 设置归一化裁切包围盒（入参为归一化坐标），委托 ImageCutGizmo.setCutBox。
      * @param normalizeBox 归一化裁切框
      */
     setCutBox(normalizeBox: Box2): void;
     /** 关闭图片裁切 Gizmo。 */
-    closePictureCutGizmo(): void;
+    closeImageCutGizmo(): void;
     /**
      * 设置图片扩边 Gizmo 是否锁定扩边框比例。
      * @param lock 是否锁定比例
      */
-    setPictureExpandGizmoLockScale(lock: boolean): void;
+    setImageExpandGizmoLockScale(lock: boolean): void;
     /**
-     * 获取当前扩边信息（归一化扩边框 + 元素视图框），委托 PictureExpandGizmo.getExpandInfo。
+     * 获取当前扩边信息（归一化扩边框 + 元素视图框），委托 ImageExpandGizmo.getExpandInfo。
      * @returns 扩边信息；Gizmo 未就绪 / 未选中单个元素 / 结果无效时返回 undefined
      */
     getExpandInfo(): {
@@ -544,12 +549,12 @@ export declare class Operations {
         itemBox: Box2;
     } | undefined;
     /**
-     * 获取归一化扩边包围盒（相对元素包围盒，可超出 [0,1]），委托 PictureExpandGizmo.getExpandBox。
+     * 获取归一化扩边包围盒（相对元素包围盒，可超出 [0,1]），委托 ImageExpandGizmo.getExpandBox。
      * @returns 归一化扩边框；Gizmo 未就绪时返回 undefined
      */
     getExpandBox(): Box2 | undefined;
     /**
-     * 设置归一化扩边包围盒（入参为归一化坐标），委托 PictureExpandGizmo.setExpandBox。
+     * 设置归一化扩边包围盒（入参为归一化坐标），委托 ImageExpandGizmo.setExpandBox。
      * @param normalizeBox 归一化扩边框
      */
     setExpandBox(normalizeBox: Box2): void;

package/dist/artis/types.d.ts

@@ -9,11 +9,11 @@ export type ArtisStateEvents = {
     /** 任意编辑状态切换；source 为触发切换的业务入参。 */
     'state.change': [previousState: BaseState | undefined, currentState: BaseState, source: any];
     /** 图片裁切框变化。 */
-    'picture-cut.change': [info: {
+    'image-cut.change': [info: {
         box: Box2;
     }];
     /** 图片扩图框变化。 */
-    'picture-expand.change': [info: {
+    'image-expand.change': [info: {
         box: Box2;
     }];
 };

package/dist/core/command/commands/{picture-cut-commit-command.d.ts → image-cut-commit-command.d.ts}

@@ -8,7 +8,7 @@ export type NormalizedBox = {
     width: number;
     height: number;
 };
-export type PictureCutCommitCommandArgs = {
+export type ImageCutCommitCommandArgs = {
     /** 新的裁切包围盒 */
     newBox: NormalizedBox;
     /** 交互前的裁切包围盒 */
@@ -20,9 +20,9 @@ export type PictureCutCommitCommandArgs = {
     applyBox: (box: NormalizedBox) => void;
 };
 /** 提交图片裁切区域变化的可撤销命令。 */
-export declare class PictureCutCommitCommand implements Command {
+export declare class ImageCutCommitCommand implements Command {
     readonly id: string;
-    readonly commandId = "pictureCut.commit";
+    readonly commandId = "imageCut.commit";
     private _newBox;
     private _oldBox;
     private _applyBox;
@@ -30,7 +30,7 @@ export declare class PictureCutCommitCommand implements Command {
      * 构造裁切提交命令，缓存新旧包围盒与应用回调
      * @param args 命令参数（含新旧裁切包围盒与 applyBox 回调）
      */
-    constructor(args: PictureCutCommitCommandArgs);
+    constructor(args: ImageCutCommitCommandArgs);
     /** 应用新的裁切包围盒 */
     execute(): void;
     /** 恢复到交互前的裁切包围盒 */

package/dist/core/command/commands/{picture-expand-commit-command.d.ts → image-expand-commit-command.d.ts}

@@ -1,6 +1,6 @@
 import type { Command } from '../types';
-import type { NormalizedBox } from './picture-cut-commit-command';
-export type PictureExpandCommitCommandArgs = {
+import type { NormalizedBox } from './image-cut-commit-command';
+export type ImageExpandCommitCommandArgs = {
     /** 新的扩图包围盒 */
     newBox: NormalizedBox;
     /** 交互前的扩图包围盒 */
@@ -12,9 +12,9 @@ export type PictureExpandCommitCommandArgs = {
     applyBox: (box: NormalizedBox) => void;
 };
 /** 提交图片扩边区域变化的可撤销命令。 */
-export declare class PictureExpandCommitCommand implements Command {
+export declare class ImageExpandCommitCommand implements Command {
     readonly id: string;
-    readonly commandId = "pictureExpand.commit";
+    readonly commandId = "imageExpand.commit";
     private _newBox;
     private _oldBox;
     private _applyBox;
@@ -22,7 +22,7 @@ export declare class PictureExpandCommitCommand implements Command {
      * 构造扩图提交命令，缓存新旧包围盒与应用回调
      * @param args 命令参数（含新旧扩图包围盒与 applyBox 回调）
      */
-    constructor(args: PictureExpandCommitCommandArgs);
+    constructor(args: ImageExpandCommitCommandArgs);
     /** 应用新的扩图包围盒 */
     execute(): void;
     /** 恢复到交互前的扩图包围盒 */

package/dist/core/command/commands/index.d.ts

@@ -56,10 +56,10 @@ export { FrameLayoutModeCommand } from './frame-layout-mode-command';
 export type { FrameLayoutModeCommandArgs } from './frame-layout-mode-command';
 export { MaskCommitCommand } from './mask-commit-command';
 export type { MaskCommitCommandArgs, MaskLine } from './mask-commit-command';
-export { PictureCutCommitCommand } from './picture-cut-commit-command';
-export type { PictureCutCommitCommandArgs, NormalizedBox } from './picture-cut-commit-command';
-export { PictureExpandCommitCommand } from './picture-expand-commit-command';
-export type { PictureExpandCommitCommandArgs } from './picture-expand-commit-command';
+export { ImageCutCommitCommand } from './image-cut-commit-command';
+export type { ImageCutCommitCommandArgs, NormalizedBox } from './image-cut-commit-command';
+export { ImageExpandCommitCommand } from './image-expand-commit-command';
+export type { ImageExpandCommitCommandArgs } from './image-expand-commit-command';
 export { SpriteImageCommand } from './sprite-image-command';
 export type { SpriteImageCommandArgs } from './sprite-image-command';
 export { VideoSourceCommand } from './video-source-command';

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

@@ -14,9 +14,12 @@ export declare class ItemReplaceSourceCommand implements Command {
     readonly commandId = "item.replaceSource";
     readonly isHistorical = false;
     readonly params: Record<string, unknown>;
+    eventPayload?: Record<string, unknown>;
+    completion: Promise<void>;
     private _itemId;
     private _newUrl;
     private _oldUrl;
+    private _propertyKey;
     private _itemService;
     private _store;
     /**
@@ -30,6 +33,8 @@ export declare class ItemReplaceSourceCommand implements Command {
     undo(): void;
     /** 重新应用新资源 */
     redo(): void;
+    /** 仅在资源实际替换成功时保留属性变化载荷。 */
+    private _replaceSource;
     /** 将在线换源标记为不可重放，避免复现流程依赖外部资源时序。 */
     serializeReplay(): {
         args: Record<string, unknown>;

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

@@ -10,6 +10,7 @@ export type ItemSetFontFamilyCommandArgs = {
 export declare class ItemSetFontFamilyCommand implements Command {
     readonly id: string;
     readonly commandId = "item.setFontFamily";
+    readonly eventPayload: Record<string, unknown>;
     completion: Promise<void>;
     private _itemId;
     private _fontFamily;

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

@@ -18,6 +18,7 @@ export type ItemTransformCommandArgs = {
 export declare class ItemTransformCommand implements Command {
     readonly id: string;
     readonly commandId = "item.transform";
+    eventPayload: Record<string, unknown>;
     private _itemId;
     private _newTransform;
     private _oldTransform;

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

@@ -9,6 +9,7 @@ export type ItemUpdatePropertyBySchemaCommandArgs = {
 export declare class ItemUpdatePropertyBySchemaCommand implements Command {
     readonly id: string;
     readonly commandId = "item.updatePropertyBySchema";
+    readonly eventPayload: Record<string, unknown>;
     completion: Promise<void>;
     private _schemas;
     private _itemService;

package/dist/core/gizmo/gizmo-command-binder.d.ts

@@ -4,10 +4,10 @@ import type { ItemService } from '../service';
 import type { Store } from '../store';
 import type { BaseArtisEvents } from '../types/artis-events';
 type GizmoBridgeEvents = BaseArtisEvents & {
-    'picture-cut.change': [info: {
+    'image-cut.change': [info: {
         box: Box2;
     }];
-    'picture-expand.change': [info: {
+    'image-expand.change': [info: {
         box: Box2;
     }];
 };
@@ -35,7 +35,7 @@ export type CommandBindingContext = {
     /** 实时创建 Text 被取消时退出对应编辑态。 */
     finishCreatedTextEditing: () => void;
 };
-export type GizmoBridgeEvent = 'item.create' | 'item.dragstart' | 'item.drag' | 'item.dragend' | 'item.propertychange' | 'loading.change' | 'spritetext.click' | 'text.input' | 'video.play' | 'picture-cut.change' | 'picture-expand.change';
+export type GizmoBridgeEvent = 'item.create' | 'item.dragstart' | 'item.drag' | 'item.dragend' | 'item.propertychange' | 'loading.change' | 'spritetext.click' | 'text.input' | 'video.play' | 'image-cut.change' | 'image-expand.change';
 export type GizmoBridgeEventArgs<K extends GizmoBridgeEvent> = GizmoBridgeEvents[K];
 /** Command behavior for one Gizmo type on the unified GestureHandler action stream. */
 export type CommandActionBinding = {

package/dist/core/gizmo/gizmo-registry.d.ts

@@ -7,8 +7,8 @@ export declare enum BuiltinGizmoId {
     LOADING = "loading",
     VIEWPORT_OVERLAY = "viewport-overlay",
     READONLY_SELECTION = "readonly-selection",
-    PICTURE_CUT = "picture-cut",
-    PICTURE_EXPAND = "picture-expand",
+    IMAGE_CUT = "image-cut",
+    IMAGE_EXPAND = "image-expand",
     SPRITE_TEXT_EDIT = "sprite-text-edit",
     MASK = "mask",
     ITEM_CREATE = "item-create"