@vvfx/sdk 0.1.18 → 0.1.19-alpha.1

package/dist/index.d.ts

@@ -44,10 +44,14 @@ type SDKItemOptions = {
      * @description 是否处于锁定状态
      */
     isLocked?: boolean;
+    /**
+     * @description 关键属性是否可编辑
+     */
+    isCoreEditable: boolean;
     /**
      * @description 扩展属性存储（属性名 -> 属性值）
      */
-    extensions?: Record<string, any>;
+    extension?: Record<string, any>;
     /**
      * @description 允许任意额外属性（用于兼容旧代码）
      */
@@ -103,6 +107,15 @@ type GeneratorItemOptions = SDKItemOptions & {
 type EffectsItemOptions = SDKItemOptions & {
     property?: Partial<EffectsItemProperty>;
 };
+/**
+ * @description Frame 画板元素 SDKItem 选项
+ */
+type FrameItemOptions = SDKItemOptions & {
+    /**
+     * @description 元素属性
+     */
+    property?: Partial<FrameItemProperty>;
+};
 /**
  * @description SDKItem 类型（独立于 spec.ItemType）
  * @description 包含所有 SDK 层级的元素类型，包括虚拟类型如 generator
@@ -154,10 +167,11 @@ declare abstract class BaseItem {
      * @description 是否处于锁定状态
      */
     isLocked: boolean;
+    isCoreEditable: boolean;
     /**
      * @description 扩展属性存储（与 property 同级）
      */
-    private _extensions;
+    private _extension;
     /**
      * @description 元素类型（由子类实现）
      * @description 支持 spec.ItemType 或扩展的 SDKItemType
@@ -201,7 +215,7 @@ declare abstract class BaseItem {
      * @description 获取所有扩展属性
      * @returns 扩展属性对象
      */
-    getExtensions(): Record<string, any>;
+    getAllExtension(): Record<string, any>;
     /**
      * @description 批量设置扩展属性
      * @param extensions 扩展属性对象
@@ -210,7 +224,7 @@ declare abstract class BaseItem {
     /**
      * @description 清空所有扩展属性
      */
-    clearExtensions(): void;
+    clearExtension(): void;
     /**
      * @description 转换为 CreateInfo（用于元素复制/导出）
      * @param withParent 是否包含父节点ID
@@ -259,11 +273,10 @@ declare class SpriteItem extends BaseItem {
      */
     get position(): [number, number];
     set position(value: [number, number]);
-    /**
-     * @description 大小
-     */
-    get size(): [number, number];
-    set size(value: [number, number]);
+    get width(): number;
+    set width(value: number);
+    get height(): number;
+    set height(value: number);
     /**
      * @description 旋转（二维旋转角度）
      */
@@ -276,6 +289,7 @@ declare class SpriteItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -352,8 +366,8 @@ declare class TextItem extends BaseItem {
     /**
      * @description 文本宽度
      */
-    get textWidth(): number;
-    set textWidth(value: number);
+    get width(): number;
+    set width(value: number);
     /**
      * @description 行高
      */
@@ -362,8 +376,8 @@ declare class TextItem extends BaseItem {
     /**
      * @description 文本高度
      */
-    get textHeight(): number;
-    set textHeight(value: number);
+    get height(): number;
+    set height(value: number);
     /**
      * @description 描边颜色
      */
@@ -429,10 +443,15 @@ declare class VideoItem extends BaseItem {
     get position(): [number, number];
     set position(value: [number, number]);
     /**
-     * @description 大小
+     * @description 宽度
      */
-    get size(): [number, number];
-    set size(value: [number, number]);
+    get width(): number;
+    set width(value: number);
+    /**
+     * @description 高度
+     */
+    get height(): number;
+    set height(value: number);
     /**
      * @description 旋转（二维旋转角度）
      */
@@ -445,6 +464,7 @@ declare class VideoItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -502,11 +522,6 @@ declare class GroupItem extends BaseItem {
      */
     get position(): [number, number];
     set position(value: [number, number]);
-    /**
-     * @description 大小
-     */
-    get size(): [number, number];
-    set size(value: [number, number]);
     /**
      * @description 大小
      */
@@ -524,6 +539,7 @@ declare class GroupItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -574,10 +590,15 @@ declare class GeneratorItem extends BaseItem {
     get position(): [number, number];
     set position(value: [number, number]);
     /**
-     * @description 大小
+     * @description 宽度
+     */
+    get width(): number;
+    set width(value: number);
+    /**
+     * @description 高度
      */
-    get size(): [number, number];
-    set size(value: [number, number]);
+    get height(): number;
+    set height(value: number);
     /**
      * @description 旋转（二维旋转角度）
      */
@@ -590,6 +611,7 @@ declare class GeneratorItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -644,10 +666,15 @@ declare class EffectsItem extends BaseItem {
     get position(): [number, number];
     set position(value: [number, number]);
     /**
-     * @description 大小
+     * @description 宽度
+     */
+    get width(): number;
+    set width(value: number);
+    /**
+     * @description 高度
      */
-    get size(): [number, number];
-    set size(value: [number, number]);
+    get height(): number;
+    set height(value: number);
     /**
      * @description 旋转（二维旋转角度）
      */
@@ -660,6 +687,7 @@ declare class EffectsItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -678,6 +706,106 @@ declare class EffectsItem extends BaseItem {
  */
 declare function isEffectsItem(obj: any): obj is EffectsItem;
 
+/**
+ * @description 画板/框架元素 SDKItem 类
+ * @description 支持自动布局和自由布局两种模式
+ * @description 底层以 composition 形式渲染
+ */
+declare class FrameItem extends BaseItem {
+    /**
+     * @description 元素类型
+     */
+    readonly type = SDKItemType.FRAME;
+    /**
+     * @description 元素属性
+     */
+    property: FrameItemProperty;
+    constructor(options: FrameItemOptions);
+    /**
+     * @description 子元素ID列表（只读）
+     */
+    get children(): readonly string[];
+    /**
+     * @description 布局模式
+     */
+    get layoutMode(): FrameLayoutMode;
+    set layoutMode(value: FrameLayoutMode);
+    /**
+     * @description 位置
+     */
+    get position(): [number, number];
+    set position(value: [number, number]);
+    /**
+     * @description 宽度
+     */
+    get width(): number;
+    set width(value: number);
+    /**
+     * @description 高度
+     */
+    get height(): number;
+    set height(value: number);
+    /**
+     * @description 缩放
+     */
+    get scale(): [number, number];
+    set scale(value: [number, number]);
+    /**
+     * @description 旋转（二维旋转角度）
+     */
+    get rotation(): number;
+    set rotation(value: number);
+    /**
+     * @description 完整旋转（包含 x, y, z）
+     */
+    get fullRotation(): [number, number, number];
+    set fullRotation(value: [number, number, number]);
+    /**
+     * @description 添加子元素
+     * @param itemId 子元素ID
+     * @returns 是否添加成功
+     */
+    addChild(itemId: string): boolean;
+    /**
+     * @description 批量添加子元素
+     * @param itemIds 子元素ID列表
+     */
+    addChildren(itemIds: string[]): void;
+    /**
+     * @description 移除子元素
+     * @param itemId 子元素ID
+     * @returns 是否移除成功
+     */
+    removeChild(itemId: string): boolean;
+    /**
+     * @description 批量移除子元素
+     * @param itemIds 子元素ID列表
+     */
+    removeChildren(itemIds: string[]): void;
+    /**
+     * @description 是否包含指定子元素
+     * @param itemId 子元素ID
+     */
+    hasChild(itemId: string): boolean;
+    /**
+     * @description 清空所有子元素
+     */
+    clearChildren(): void;
+    /**
+     * @description 转换为 FrameCreateInfo
+     * @param withParent 是否包含父节点ID
+     */
+    toCreateInfo(withParent?: boolean): FrameCreateInfo;
+    /**
+     * @description 克隆 SDKItem
+     */
+    clone(): FrameItem;
+}
+/**
+ * @description 类型守卫：检查是否是 FrameItem
+ */
+declare function isFrameItem(obj: any): obj is FrameItem;
+
 /**
  * @description 根据 item type 创建对应的 SDKItem 实例
  * @param type 元素类型
@@ -689,56 +817,7 @@ declare function createSDKItem(type: spec.ItemType, options: SDKItemOptions): Ba
  * @description SDKItem 类型联合
  * @description 用于替换原来的 SDKItem type
  */
-type SDKItem$1 = SpriteItem | TextItem | VideoItem | GroupItem | GeneratorItem | EffectsItem;
-
-type ViewItemTypedProperty = {
-    [K in keyof PageFormTypeAndPropertyReference]: {
-        /**
-         * @description 元素类型
-         */
-        type: K;
-        /**
-         * @description 元素属性
-         */
-        property: PageFormTypeAndPropertyReference[K];
-    };
-}[keyof PageFormTypeAndPropertyReference];
-type PageFormTypedProperty = {
-    [K in keyof PageFormTypeAndPropertyReference]: {
-        type: K;
-        property: PageFormTypeAndPropertyReference[K];
-        onPropertyValueChange: <N extends keyof PageFormTypeAndPropertyReference[K]>(propertyName: N, propertyValue: PageFormTypeAndPropertyReference[K][N]) => void;
-    };
-}[keyof PageFormTypeAndPropertyReference];
-type GetItemPropertyValueParam<T extends keyof PageFormTypeAndPropertyReference, N extends keyof PageFormTypeAndPropertyReference[T]> = {
-    itemId: string;
-    type: T;
-    propertyName: N;
-};
-type GetItemPropertyValueResult<T extends keyof PageFormTypeAndPropertyReference, N extends keyof PageFormTypeAndPropertyReference[T]> = PageFormTypeAndPropertyReference[T][N];
-type GetItemPropertyParam<T extends keyof PageFormTypeAndPropertyReference> = {
-    itemId: string;
-    type: T;
-};
-type GetItemPropertyResult<T extends keyof PageFormTypeAndPropertyReference> = {
-    type: T;
-    property: PageFormTypeAndPropertyReference[T];
-};
-type SetItemPropertyValueParam = {
-    [T in keyof PageFormTypeAndPropertyReference]: {
-        [N in keyof PageFormTypeAndPropertyReference[T]]: {
-            itemId: string;
-            type: T;
-            propertyName: N;
-            propertyValue: PageFormTypeAndPropertyReference[T][N];
-        };
-    }[keyof PageFormTypeAndPropertyReference[T]];
-}[keyof PageFormTypeAndPropertyReference] | {
-    itemId: string;
-    type: SDKItemType | spec.ItemType;
-    propertyName: 'position' | 'size';
-    propertyValue: spec.vec2 | spec.vec3;
-};
+type SDKItem$1 = SpriteItem | TextItem | VideoItem | GroupItem | GeneratorItem | EffectsItem | FrameItem;
 
 /**
  * @class 二维线段
@@ -1027,31 +1106,7 @@ declare class Box2 {
     rotate(angle: number, center?: Vector2): this;
 }
 
-type CreateOperation = {
-    type: 'create';
-    newData: ItemCreateInfo[];
-};
-type DeleteOperation = {
-    type: 'delete';
-    oldData: ItemCreateInfo[];
-};
-type UpdateOperation = {
-    type: 'update';
-    newData: ItemCreateInfo[];
-    oldData: ItemCreateInfo[];
-};
-type Operation = CreateOperation | UpdateOperation | DeleteOperation;
-declare class UndoRedo {
-    private index;
-    private operations;
-    get canUndo(): boolean;
-    get canRedo(): boolean;
-    oldData?: ItemCreateInfo[];
-    push(operation: Operation): void;
-    undo(): Operation | undefined;
-    redo(): Operation | undefined;
-    clear(): void;
-}
+type SizeAdaptDirection = 'x' | 'y';
 
 declare const MEDIA_TYPE: {
     readonly APNG: "APNG";
@@ -1236,1983 +1291,2120 @@ type ExportParams = ExportItemParams[];
 type Buffers = FileBuffer[] | undefined;
 type Extras = (FileBuffer | null)[] | null | undefined;
 
-type SDKMode = 'editor' | 'template';
-/**
- * @description SDK功能配置
- */
-type SDKConfig = {
-    /**
-     * @description SDK编辑模式 - 模板编辑模式 | 编辑器模式
-     */
-    mode: SDKMode;
-    /**
-     * @description 页面功能配置
-     */
-    pageConfig: PageConfig$1;
+type BaseItemProperty = {
+    position: [number, number];
+    rotation: [number, number, number];
+    scale: [number, number];
+    width: number;
+    height: number;
+};
+type SpriteItemProperty = BaseItemProperty & {
+    image: string;
+};
+type GroupItemProperty = BaseItemProperty & {
+    children: string[];
+};
+type TextItemProperty = BaseItemProperty & {
+    fontFamily: string;
+    color: [number, number, number, number];
+    fontWeight: spec.TextWeight;
+    text: string;
+    textAlign: spec.TextAlignment;
+    fontSize: number;
+    fontStyle: spec.FontStyle;
+    lineHeight: number;
+    outlineColor?: spec.vec4;
+    outlineWidth?: number;
     /**
-     * @description 异步加载功能配置
+     * @description 描边开关
      */
-    asyncLoadConfig: AsyncLoadConfig;
+    outlineEnabled?: boolean;
+    fontUrl?: string;
+};
+type VideoItemProperty = BaseItemProperty & {
+    video: string;
     /**
-     * @description 截图功能配置
-     */
-    screenShotConfig: ScreenShotConfig;
+   * @description 是否静音
+   */
+    muted?: boolean;
     /**
-     * @description 导出视频功能配置
+     * @description 是否为透明视频
      */
-    exportConfig: ExportConfig;
+    transparent?: boolean;
     /**
-     * @description 尺寸自适应功能开关
+     * @description 播放速率
      */
-    sizeAdaptConfig: SizeAdaptConfig;
+    playbackRate?: number;
     /**
-     * @description 辅助面板功能配置
+     * @description 音量
      */
-    gestureHandlerConfig: {
-        enabled: boolean;
-        adsorptionGizmoEnabled: boolean;
-        adsorptionGizmoConfig: AdsorptionGizmoConfig;
-        controlGizmoEnabled: boolean;
-        controlGizmoConfig: ControlGizmoConfig;
-        preferenceGizmoEnabled: boolean;
-        preferenceGizmoConfig: PreferenceGizmoConfig;
-        selectorGizmoEnabled: boolean;
-        selectorGizmoConfig: SelectorGizmoConfig;
-        transformGizmoEnabled: boolean;
-        transformGizmoConfig: TransformGizmoConfig;
-        pictureCutGizmoEnabled: boolean;
-        pictureCutGizmoConfig: PictureCutGizmoConfig;
-        pictureExpandGizmoEnabled: boolean;
-        pictureExpandGizmoConfig: PictureExpandGizmoConfig;
-        textGizmoEnbaled: boolean;
-        textGizmoConfig: TextGizmoConfig;
-        maskGizmoEnabled: boolean;
-        maskGizmoConfig: MaskGizmoConfig;
-        spriteTextEditGizmoEnabled: boolean;
-        spriteTextEditGizmoConfig: SpriteTextEditGizmoConfig;
-        videoPlayGizmoEnabled: boolean;
-        videoPlayGizmoConfig: VideoPlayGizmoConfig;
-        itemCreateGizmoEnabled: boolean;
-        itemCreateGizmoConfig: ItemCreateGizmoConfig;
-    };
+    volume?: number;
 };
 /**
- * @description 页面功能配置
+ * @description Generator 表单属性
  */
-type PageConfig$1 = {
-    /**
-     * @description 同步修改功能开关
-     */
-    asncMode: boolean;
-    /**
-     * @description 静态预览【视图只提供播放预览功能】功能开关
-     */
-    staticPreview: boolean;
-    /**
-     * @description 静态预览视图名称
-     */
-    staticPreviewName: string;
-    /**
-     * @description 需过滤的元素名称
-     */
-    filterItemNames: string[];
+type GeneratorItemProperty = BaseItemProperty & {
     /**
-     * @description 成组操作元素显隐
+     * @description 生成器类型
      */
-    groupVisible: boolean;
+    generatorType: 'image' | 'video';
+};
+type EffectsItemProperty = BaseItemProperty & {
+    effects: string;
+};
+/**
+ * @description Frame 画板元素布局模式
+ */
+declare enum FrameLayoutMode {
+    AUTO = "auto",
+    FREE = "free"
+}
+/**
+ * @description Frame 画板元素属性
+ */
+type FrameItemProperty = BaseItemProperty & {
     /**
-     * @description 缩放最大值
+     * @description 布局模式: auto - 自动布局, free - 自由布局
      */
-    maxZoom: number;
+    layoutMode: FrameLayoutMode;
     /**
-     * @description 缩放最小值
+     * @description 子元素ID数组
      */
-    minZoom: number;
+    children: string[];
 };
 /**
- * @description 异步加载配置
+ * @description BaseItem 基础属性键名
  */
-type AsyncLoadConfig = {
-    enabled: boolean;
-    loadingTextureUrl: string;
-};
+type BaseItemPropertyKey = 'name' | 'duration' | 'delay' | 'endBehavior' | 'visible' | 'isLocked' | 'parentId';
 /**
- * @description 视频导出功能配置
+ * @description BaseItem 基础属性值类型映射
  */
-type ExportConfig = {
-    enabled: boolean;
-} & ExportMediaInitOptions;
+type BaseItemPropertyValueMap = {
+    name: string;
+    duration: number;
+    delay: number;
+    endBehavior: spec.EndBehavior;
+    visible: boolean;
+    isLocked: boolean;
+    parentId?: string;
+};
 /**
- * @description 截图功能配置
+ * @description Item 类型与 Property 类型的映射
  */
-type ScreenShotConfig = {
-    enabled: boolean;
+type ItemPropertyMap = {
+    [SDKItemType.SPRITE]: SpriteItemProperty;
+    [SDKItemType.TEXT]: TextItemProperty;
+    [SDKItemType.VIDEO]: VideoItemProperty;
+    [SDKItemType.GROUP]: GroupItemProperty;
+    [SDKItemType.GENERATOR]: GeneratorItemProperty;
+    [SDKItemType.EFFECTS]: EffectsItemProperty;
+    [SDKItemType.FRAME]: FrameItemProperty;
 };
 /**
- * @description 尺寸自适应功能配置
+ * @description 场景1：单个元素单个属性设置
+ * 支持设置 BaseItem 基础属性或具体 Item 类型的 property 属性
  */
-type SizeAdaptConfig = {
-    enabled: boolean;
+type SetSingleItemSinglePropertyParam<T extends SDKItemType = SDKItemType> = {
+    itemId: string;
+    type: T;
+    propertyName: BaseItemPropertyKey;
+    propertyValue: BaseItemPropertyValueMap[BaseItemPropertyKey];
+} | {
+    itemId: string;
+    type: T;
+    propertyName: keyof ItemPropertyMap[T];
+    propertyValue: ItemPropertyMap[T][keyof ItemPropertyMap[T]];
 };
 /**
- * @description 对齐吸附功能参数
+ * @description 场景2：单个元素多个属性设置
+ * 同时设置多个 BaseItem 属性或 property 属性
  */
-type AdsorptionGizmoConfig = {
-    /**
-   * @description 对齐吸附线宽
-   */
-    lineWidth: number;
-    /**
-     * @description 对齐线颜色
-     */
-    lineColor: number;
-    /**
-     * @description 对齐吸附距离
-     */
-    distance: number;
+type SetSingleItemMultiplePropertiesParam<T extends SDKItemType = SDKItemType> = {
+    itemId: string;
+    type: T;
+    property: Partial<Record<BaseItemPropertyKey, BaseItemPropertyValueMap[BaseItemPropertyKey]>> & Partial<Record<keyof ItemPropertyMap[T], ItemPropertyMap[T][keyof ItemPropertyMap[T]]>>;
 };
 /**
- * @description 视图控制功能参数
+ * @description 设置元素属性的统一参数类型
+ * 支持两种场景：单元素单属性、单元素多属性
  */
-type ControlGizmoConfig = {
-    /**
-     * @description 缩放步长
-     */
-    zoomStep: number;
+type SetItemPropertyParam<T extends SDKItemType = SDKItemType> = SetSingleItemSinglePropertyParam<T> | SetSingleItemMultiplePropertiesParam<T>;
+type SDKOptions = {
+    /** 导出视频时，是否开启转码日志 */
+    loggerInExportVideoTranscoding?: boolean;
 };
+type SDKInputParam = SDKTemplateInputParam | SDKEditorInputParam;
 /**
- * @description 视口展示功能参数
+ * @description SDK入参
  */
-type PreferenceGizmoConfig = {
+type SDKTemplateInputParam = {
     /**
-   * @description 视口窗包围盒颜色
-   */
-    boxColor: number;
+     * @description JSON地址
+     */
+    scene: string | spec.JSONScene;
     /**
-     * @description 视口窗包围盒宽度
+     * @description SDK模式 - 模板编辑模式
      */
-    boxWidth: number;
+    mode: 'template';
     /**
-     * @description 视口区域外遮罩颜色
+     * @description 视图参数
      */
-    markColor: number;
+    viewParams?: ViewParam[];
     /**
-     * @description 视口区域外遮罩透明度
+     * @description 页面属性
      */
-    markAlpha: number;
+    options: PageOptions;
+};
+type SDKEditorInputParam = {
     /**
-     * @description 出血区预览开关
+     * @description SDK模式 - 编辑器模式
      */
-    safeAreaEnabled: boolean;
+    mode: 'editor';
+};
+/**
+ * @description 页面属性
+ */
+type PageOptions = {
     /**
-     * @description 出血区颜色
+     * @description 同步模式开关
      */
-    safeAreaBoxColor: number;
+    asyncMode: boolean;
     /**
-     * @description 出血区透明度
+     * @description 安全区展示开关
      */
-    safeAreaBoxAlpha: number;
+    safeAreaPreview: boolean;
+    /**
+     * @description 吸附开关
+     */
+    adsorption: boolean;
 };
 /**
- * @description 选择功能参数
+ * @description 页面数据
  */
-type SelectorGizmoConfig = {
-    /**
-     * @description 视频预选中时
-     */
-    videoPreSelectedPlay: boolean;
+type PageData = {
     /**
-     * @description 预选框线宽
+     * @description 基础场景数据
      */
-    preSelectedWidth: number;
+    scene: spec.JSONScene;
     /**
-     * @description 预选框颜色
+     * @description 页面属性
      */
-    preSelectedColor: number;
+    property: PageProperty;
     /**
-     * @description 框选区域颜色
+     * @description 视图属性
      */
-    regionBoxColor: number;
+    viewProperties: ViewProperty[];
     /**
-     * @description 框选区域透明度
+     * @description 活跃数据
      */
-    regionBoxAlpha: number;
+    activeData: ActiveData;
     /**
-     * @description 框选区域包围框颜色
+     * @description 元素数据
      */
-    regionWireframeColor: number;
+    items: SDKItem[];
     /**
-     * @description 框选区域包围框透明度
+     * @description 视图当前时间
      */
-    regionWireframeAlpha: number;
+    time: number;
     /**
-     * @description 框选区域包围框宽度
+     * @description 是否处于播放态
      */
-    regionWireframeWidth: number;
+    playing: boolean;
 };
 /**
- * @description 变换功能参数
+ * @description 页面配置
  */
-type TransformGizmoConfig = {
-    /**
-     * @description 变换交互框颜色
-     */
-    wireframeColor: number;
+type PageConfig$1 = {
     /**
-     * @description 变换交互框透明度
+     * @description 出血区域展示开关
      */
-    wireframeAlpha: number;
+    safeAreaPreview: boolean;
     /**
-     * @description 变换交互框宽度
+     * @description 缩放值
      */
-    wireframeWidth: number;
+    zoom: number;
     /**
-     * @description 变换交互框角点填充色
+     * @description 吸附开关
      */
-    cornerFillColor: number;
+    adsorption: boolean;
     /**
-     * @description 变换交互框角点线框色
+     * @description 同步开关
      */
-    cornerLineColor: number;
+    asyncMode: boolean;
     /**
-     * @description 变换交互框角点线框宽度
+     * @description 画布移动
      */
-    cornerLineWidth: number;
+    translation: spec.vec2;
+};
+/**
+ * @description 页面属性
+ */
+type PageProperty = {
     /**
-     * @description 变换交互框角点线框透明度
+     * @description 出血区域展示开关
      */
-    cornerLineAlpha: number;
+    safeAreaPreview: boolean;
     /**
-     * @description 交互框缩放圆半径
+     * @description 缩放值
      */
-    scaleCircleSize: number;
+    zoom: number;
     /**
-     * @description 交互框旋转圆半径
+     * @description 偏移值
      */
-    rotationCircleSize: number;
+    translation: [number, number];
     /**
-     * @description 图片Logo地址
+     * @description 吸附开关
      */
-    pictureLogoUrl: string;
+    adsorption: boolean;
     /**
-     * @description 空节点Logo地址
+     * @description 同步开关
      */
-    groupLogoUrl: string;
+    asyncMode: boolean;
+};
+/**
+ * @description 视图创建参数
+ */
+type ViewParam = {
     /**
-     * @description 文本Logo地址
+     * @description 页面尺寸
      */
-    textLogoUrl: string;
+    size?: [number, number];
     /**
-     * @description 视频Logo地址
+     * @description 出血区参数
      */
-    videoLogoUrl: string;
+    safeArea?: [number, number, number, number];
     /**
-     * @description 大小文字颜色
+     * @description 自适应方向 - 默认根据视图宽高决定
      */
-    sizeTextColor: number;
+    adaptionDirection?: SizeAdaptDirection;
     /**
-     * @description 名称文字颜色
+     * @description 自定义出血区 - 用于展示
      */
-    nameTextColor: number;
+    previewSafeAreas?: PreviewSafeAreaParam[];
     /**
-     * @description 选中信息展示
+     * @description 导出参数
      */
-    infoShowEnabled: boolean;
+    export: ExportParam;
 };
 /**
- * @description 图片裁切参数
+ * @description 导出参数
  */
-type PictureCutGizmoConfig = {
+type ExportParam = {
     /**
-     * @description 蒙版颜色
+     * @description 视频名称
      */
-    maskColor: number;
+    name?: string;
+} & Omit<ExportMediaItemOptions, 'scene' | 'size'>;
+/**
+ * @description 视图属性
+ */
+type ViewProperty = {
     /**
-     * @description 蒙版透明度
+     * @description 视图ID
      */
-    maskAlpha: number;
+    id: number;
     /**
-     * @description 裁切包围盒线框宽度
+     * @description 视图宽高
      */
-    cutBoxLineWidth: number;
+    size: [number, number];
     /**
-     * @description 裁切包围盒线框颜色
+     * @description 出血区数据
      */
-    cutBoxLineColor: number;
+    safeArea: [number, number, number, number];
     /**
-     * @description 裁切包围盒线框透明度
+     * @description 自定义出血区数据
      */
-    cutBoxLineAlpha: number;
+    previewSafeAreas: PreviewSafeAreaParam[];
     /**
-     * @description 元素包围盒线框宽度
+     * @description 视图场景数据
      */
-    itemBoxLineWidth: number;
+    scene: spec.JSONScene;
     /**
-     * @description 元素包围盒线框颜色
+     * @description 导出参数
      */
-    itemBoxLineColor: number;
+    export: ExportParam;
     /**
-     * @description 元素包围盒线框透明度
+     * @description 忽略交互 - 仅供展示
      */
-    itemBoxLineAlpha: number;
+    ignoreInteraction: boolean;
+};
+/**
+ * @description 自定义出血区数据
+ */
+type PreviewSafeAreaParam = {
     /**
-     * @description 裁切包围盒角度半径
+     * @description 出血区包围盒 [left top width height]
      */
-    cutBoxCornerRadius: number;
+    box: [number, number, number, number];
     /**
-     * @description 裁切包围盒角点宽度
+     * @description 出血区色块颜色 默认为 [255, 255, 255, 0.3]
      */
-    cutBoxCornerLineWidth: number;
+    color?: [number, number, number, number];
     /**
-     * @description 裁切包围盒角点颜色
+     * @description 出血区图像
      */
-    cutBoxCornerLineColor: number;
+    url?: string;
     /**
-     * @description 裁切包围盒角点透明度
+     * @description 出血区是否可见
      */
-    cutBoxCornerLineAlpha: number;
+    visible?: boolean;
+};
+/**
+ * @description 页面活跃数据
+ */
+type ActiveData = {
     /**
-     * @description 裁切包围盒角点填充色
+     * @description 视图ID
      */
-    cutBoxCornerFillColor: number;
+    view?: number;
     /**
-     * @description 缩放判断距离
+     * @description 选中元素
      */
-    scaleInteractionDistance: number;
+    selectedItems: string[];
     /**
-     * @description 单向缩放判断距离
+     * @description 预选中元素
      */
-    directionScaleInteractionDistance: number;
+    preSelectedItem?: string;
     /**
-     * @description 网格线数量
+     * @description 执行中元素
      */
-    gridCount: number;
+    loadingItems?: string[];
+};
+/**
+ * @description 视图元素
+ * @description 注意：SDKItem 现在已从类实现中导入，见 view-item/index.ts
+ * @description SDKItem 现在是类实例而非普通对象，支持属性扩展
+ * @description 保持类型兼容性：新 SDKItem 类拥有与旧类型相同的属性
+ */
+type SDKItem = SDKItem$1;
+type SDKBackgroundType = 'color' | 'image' | 'chess-board' | 'dot-board';
+/**
+ * @description 图层创建信息
+ */
+type SpriteCreateInfo = {
+    type: SDKItemType.SPRITE;
     /**
-     * @description 网格线颜色
+     * @description 图层名称
      */
-    gridLineColor: number;
+    name?: string;
     /**
-     * @description 网格线宽度
+     * @description 元素id
      */
-    gridLineWidth: number;
+    id?: string;
     /**
-     * @description 网格线透明度
+     * @description 父节点id
      */
-    gridLineAlpha: number;
+    parentId?: string;
+    /**
+     * @description 扩展属性
+     */
+    extension?: Record<string, any>;
+    /**
+     * @description 元素属性
+     */
+    property: {
+        /**
+         * @description 图片资源地址 | 数据
+         */
+        image: string;
+        /**
+         * @description 图层像素宽度
+         */
+        width: number;
+        /**
+         * @description 图层像素高度
+         */
+        height: number;
+        /**
+         * @description 元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 元素缩放
+         */
+        scale?: [number, number];
+    };
 };
 /**
- * @description 图片扩边参数
+ * @description 空节点创建信息
  */
-type PictureExpandGizmoConfig = {
+type GroupCreateInfo = {
+    type: SDKItemType.GROUP;
     /**
-     * @description 蒙版颜色
+     * @description 元素id
      */
-    maskColor: number;
+    id?: string;
     /**
-     * @description 蒙版透明度
+     * @description 父节点id
      */
-    maskAlpha: number;
+    parentId?: string;
     /**
-     * @description 扩边包围盒线框宽度
+     * @description 元素名称
      */
-    expandBoxLineWidth: number;
+    name?: string;
     /**
-     * @description 扩边包围盒线框颜色
+     * @description 扩展属性
      */
-    expandBoxLineColor: number;
+    extension?: Record<string, any>;
     /**
-     * @description 扩边包围盒线框透明度
+     * @description 元素属性
      */
-    expandBoxLineAlpha: number;
+    property: {
+        /**
+         * @description 元素位置
+         */
+        position?: [number, number];
+        /**
+         * @description 元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 元素缩放
+         */
+        scale?: [number, number];
+        /**
+         * @description 子元素id
+         */
+        children: string[];
+    };
+};
+/**
+ * @description 文本创建信息
+ */
+type TextCreateInfo = {
+    type: SDKItemType.TEXT;
     /**
-     * @description 扩边包围盒角度半径
+     * @description 元素id
      */
-    expandBoxCornerRadius: number;
+    id?: string;
     /**
-     * @description 扩边包围盒角点宽度
+     * @description 父节点id
      */
-    expandBoxCornerLineWidth: number;
+    parentId?: string;
     /**
-     * @description 扩边包围盒角点颜色
+     * @description 元素名称
      */
-    expandBoxCornerLineColor: number;
+    name?: string;
     /**
-     * @description 扩边包围盒角点透明度
+     * @description 扩展属性
      */
-    expandBoxCornerLineAlpha: number;
+    extension?: Record<string, any>;
     /**
-     * @description 扩边包围盒角点填充色
+     * @description 元素属性
      */
-    expandBoxCornerFillColor: number;
+    property: {
+        /**
+         * @description 文本宽度
+         */
+        width: number;
+        /**
+         * @description 文本高度
+         */
+        height?: number;
+        /**
+         * @description 元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 元素缩放
+         */
+        scale?: [number, number];
+        /**
+         * @description 单行高度
+         */
+        lineHeight: number;
+        /**
+         * @description 字体名称
+         */
+        fontFamily: string;
+        /**
+         * @description 文字大小
+         */
+        fontSize: number;
+        /**
+         * @description 字重
+         */
+        fontWeight?: spec.TextWeight;
+        /**
+         * @description 字体格式
+         */
+        fontStyle?: spec.FontStyle;
+        /**
+         * @description 对齐方式
+         */
+        textAlign?: spec.TextAlignment;
+        /**
+         * @description 文本信息
+         */
+        text: string;
+        /**
+         * @description 填充色
+         */
+        color: spec.vec4;
+        /**
+         * @description 描边色
+         */
+        outlineColor?: spec.vec4;
+        /**
+         * @description 描边宽度
+         */
+        outlineWidth?: number;
+        /**
+         * @description 描边开关
+         */
+        outlineEnabled?: boolean;
+        /**
+         * @description 字体文件地址
+         */
+        fontUrl?: string;
+    };
+};
+/**
+ * @description 视频创建信息
+ */
+type VideoCreateInfo = {
+    type: SDKItemType.VIDEO;
     /**
-     * @description 缩放判断距离
+     * @description 视频名称
      */
-    scaleInteractionDistance: number;
+    name?: string;
     /**
-     * @description 单向缩放判断距离
+     * @description 元素id
      */
-    directionScaleInteractionDistance: number;
+    id?: string;
     /**
-     * @description 网格线数量
+     * @description 父节点id
      */
-    gridCount: number;
+    parentId?: string;
     /**
-     * @description 网格线颜色
+     * @description 扩展属性
      */
-    gridLineColor: number;
+    extension?: Record<string, any>;
     /**
-     * @description 网格线宽度
+     * @description 元素属性
      */
-    gridLineWidth: number;
-    /**
-     * @description 网格线透明度
-     */
-    gridLineAlpha: number;
+    property: {
+        /**
+         * @description 视频资源地址 | 数据
+         */
+        video: string;
+        /**
+         * @description 视频元素像素宽度
+         */
+        width: number;
+        /**
+         * @description 视频元素像素高度
+         */
+        height: number;
+        /**
+         * @description 视频元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 视频元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 视频元素缩放
+         */
+        scale?: [number, number];
+        /**
+         * @description 是否静音
+         */
+        muted?: boolean;
+        /**
+         * @description 是否为透明视频
+         */
+        transparent?: boolean;
+        /**
+         * @description 播放速率
+         */
+        playbackRate?: number;
+        /**
+         * @description 音量
+         */
+        volume?: number;
+    };
 };
 /**
- * @description 文本交互控制器旋转交互模式
- * 'corner': 角点旋转
- * 'top-center': 顶部中心旋转
+ * @description 生成器类型
  */
-type TextGizmoRotateInteractMode = 'corner' | 'top-center';
+type GeneratorType = 'image' | 'video';
 /**
- * @description 文本交互控制器参数
+ * @description 生成器创建信息
  */
-type TextGizmoConfig = {
-    /**
-     * @description 旋转交互模式
-     */
-    rotateInteractMode: TextGizmoRotateInteractMode;
-    /**
-     * @description 包围盒线宽
-     */
-    boxLineWidth: number;
-    /**
-     * @description 包围盒线色
-     */
-    boxLineColor: number;
-    /**
-     * @description 旋转交互点边长 - 用于 top-center 交互模式
-     */
-    rotationCornerWidth: number;
-    /**
-     * @description 旋转交互贴图地址
-     */
-    rotationCornerTexture: string;
-    /**
-     * @description 旋转交互点半径
-     */
-    rotationCornerRadius: number;
-    /**
-     * @description top-center 模式旋转交互距离
-     */
-    rotationTopCenterInteractionDistance: number;
+type GeneratorCreateInfo = {
     /**
-     * @description 旋转交互点填充色
+     * @description 元素类型 - 生成器
      */
-    rotationCornerFillColor: number;
+    type: SDKItemType.GENERATOR;
     /**
-     * @description 旋转交互点描边宽度
+     * @description 元素名称
      */
-    rotationCornerStrokeWidth: number;
+    name?: string;
     /**
-     * @description 旋转交互点描边颜色
+     * @description 元素id
      */
-    rotationCornerStrokeColor: number;
+    id?: string;
     /**
-     * @description Corner 模式旋转交互距离
+     * @description 父元素id
      */
-    rotationCornerInteractionDistance: number;
+    parentId?: string;
     /**
-     * @description 缩放交互点半径
+     * @description 扩展属性
      */
-    scaleCornerRadius: number;
+    extension?: Record<string, any>;
     /**
-     * @description 缩放交互点填充色
+     * @description 元素属性
      */
-    scaleCornerFillColor: number;
+    property: {
+        /**
+         * @description 生成器类型
+         */
+        generatorType: GeneratorType;
+        /**
+         * @description 生成器元素像素宽度
+         */
+        width: number;
+        /**
+         * @description 生成器元素像素高度
+         */
+        height: number;
+        /**
+         * @description 生成器元素位置
+         */
+        position: [number, number];
+        /**
+         * @description 生成器元素旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 生成器元素缩放
+         */
+        scale?: [number, number];
+    };
+};
+/**
+ * @description 图片生成器资源信息
+ */
+type SpriteGeneratorResource = {
     /**
-     * @description 缩放交互点描边宽度
+     * @description 资源地址
      */
-    scaleCornerStrokeWidth: number;
+    url: string;
     /**
-     * @description 缩放交互点描边颜色
+     * @description 资源尺寸
      */
-    scaleCornerStrokeColor: number;
+    size?: spec.vec2;
     /**
-     * @description 触发缩放交互的距离
+     * @description 目标生成器元素 ID（必填）
      */
-    scaleInteractionDistance: number;
+    itemId: string;
     /**
-     * @description 触发边缩放交互的距离
+     * @description 扩展属性
      */
-    widthScaleInteractionDistance: number;
+    extension?: Record<string, any>;
 };
 /**
- * @description 蒙版参数
+ * @description 视频生成器资源信息
  */
-type MaskGizmoConfig = {
+type VideoGeneratorResource = {
     /**
-     * @description 画笔大小
+     * @description 资源地址
      */
-    brushSize: number;
+    url: string;
     /**
-     * @description 笔刷颜色
+     * @description 资源尺寸
      */
-    brushColor: number;
+    size?: spec.vec2;
     /**
-     * @description 笔刷透明度
+     * @description 是否静音（仅用于视频）
      */
-    brushAlpha: number;
+    muted?: boolean;
     /**
-     * @description 蒙版颜色
+     * @description 是否为透明视频（仅用于视频）
      */
-    maskColor: number;
+    transparent?: boolean;
     /**
-     * @description 蒙版透明度
+     * @description 播放速率（仅用于视频）
      */
-    maskAlpha: number;
+    playbackRate?: number;
     /**
-     * @description 元素包围盒线框宽度
+     * @description 音量（仅用于视频）
      */
-    boxLineWidth: number;
+    volume?: number;
     /**
-     * @description 元素包围盒线框颜色
+     * @description 目标生成器元素 ID（必填）
      */
-    boxLineColor: number;
+    itemId: string;
     /**
-     * @description 元素包围盒线框透明度
+     * @description 扩展属性
      */
-    boxLineAlpha: number;
+    extension?: Record<string, any>;
 };
-/**
- * @description 精准改字编辑参数
- */
-type SpriteTextEditGizmoConfig = {
+type GeneratorResource = SpriteGeneratorResource | VideoGeneratorResource;
+type EffectsCreateInfo = {
     /**
-     * @description 文案颜色
+     * @description 元素类型 - 特效
      */
-    textColor: number;
+    type: SDKItemType.EFFECTS;
     /**
-     * @description 包围盒线框宽度
+     * @description 元素名称
      */
-    boxLineWidth: number;
+    name?: string;
     /**
-     * @description 包围盒间隔线长度
+     * @description 元素id
      */
-    dashLineDash: number;
+    id?: string;
     /**
-     * @description 包围盒间隔线间隔
+     * @description 父元素id
      */
-    dashLineGap: number;
+    parentId?: string;
+    property: {
+        /**
+         * @description 动效像素宽度
+         */
+        width?: number;
+        /**
+         * @description 动效像素高度
+         */
+        height?: number;
+        /**
+         * @description 生成器位置
+         */
+        position: spec.vec2;
+        /**
+         * @description 旋转角度
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 缩放
+         */
+        scale?: spec.vec2;
+        /**
+         * @description 动效资源地址
+         */
+        effects: string | spec.JSONScene;
+    };
     /**
-     * @description 预选中文案颜色
+     * @description 扩展属性
      */
-    preSelectedTextColor: number;
+    extension?: Record<string, any>;
+};
+/**
+ * @description Frame 画板元素创建信息
+ */
+type FrameCreateInfo = {
     /**
-     * @description 标记包围盒颜色
+     * @description 元素类型 - 画板
      */
-    editBoxColor: number;
+    type: SDKItemType.FRAME;
     /**
-     * @description 编辑包围盒透明度
+     * @description 元素名称
      */
-    editBoxAlpha: number;
+    name?: string;
     /**
-     * @description 编辑包围盒线框颜色
+     * @description 元素id
      */
-    editBoxLineColor: number;
+    id?: string;
     /**
-     * @description 编辑包围盒线框透明度
+     * @description 父元素id
      */
-    editBoxLineAlpha: number;
+    parentId?: string;
     /**
-     * @description 已更改编辑包围盒颜色
+     * @description 元素属性
      */
-    hasChangedEditBoxColor: number;
+    property: {
+        /**
+         * @description 画板像素宽度
+         */
+        width: number;
+        /**
+         * @description 画板像素高度
+         */
+        height: number;
+        /**
+         * @description 画板位置
+         */
+        position: [number, number];
+        /**
+         * @description 画板旋转 z | [x, y, z]
+         */
+        rotation?: number | [number, number, number];
+        /**
+         * @description 画板缩放
+         */
+        scale?: [number, number];
+        /**
+         * @description 布局模式: 'auto' | 'free'
+         */
+        layoutMode?: FrameLayoutMode;
+    };
     /**
-     * @description 已更改编辑包围盒透明度
+     * @description 扩展属性
      */
-    hasChangedEditBoxAlpha: number;
+    extension?: Record<string, any>;
+};
+type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo | FrameCreateInfo;
+/**
+ * @description 场景创建信息
+ */
+type SceneCreaetInfo = {
     /**
-     * @description 已更改编辑包围盒线框颜色
+     * @description 场景名称
      */
-    hasChangedEditBoxLineColor: number;
+    name: string;
     /**
-     * @description 已更改编辑包围盒线框透明度
+     * @description 场景大小
      */
-    hasChangedEditBoxLineAlpha: number;
+    size: spec.vec2;
+};
+declare enum ItemOrderAction {
+    BringToFront = 0,
+    SendToBack = 1,
+    BringForward = 2,
+    SendBackward = 3
+}
+/**
+ * @description 视图自适应偏移参数
+ */
+type ViewportFitShiftParam = {
     /**
-     * @description 编辑包围盒预选颜色
+     * @description 左偏移
      */
-    editBoxPreSelectedColor: number;
+    left?: number;
     /**
-     * @description 编辑包围盒预选透明度
+     * @description 右偏移
      */
-    editBoxPreSelectedAlpha: number;
+    right?: number;
     /**
-     * @description 编辑包围盒预选线框颜色
+     * @description 上偏移
      */
-    editBoxLinePreSelectedColor: number;
+    top?: number;
     /**
-     * @description 编辑包围盒预选线框透明度
+     * @description 下偏移
      */
-    editBoxLinePreSelectedAlpha: number;
+    bottom?: number;
+};
+
+type CreateOperation = {
+    type: 'create';
+    newData: ItemCreateInfo[];
+};
+type DeleteOperation = {
+    type: 'delete';
+    oldData: ItemCreateInfo[];
+};
+type UpdateOperation = {
+    type: 'update';
+    newData: ItemCreateInfo[];
+    oldData: ItemCreateInfo[];
+};
+type Operation = CreateOperation | UpdateOperation | DeleteOperation;
+declare class UndoRedo {
+    private index;
+    private operations;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    oldData?: ItemCreateInfo[];
+    push(operation: Operation): void;
+    undo(): Operation | undefined;
+    redo(): Operation | undefined;
+    clear(): void;
+}
+
+type SDKMode = 'editor' | 'template';
+/**
+ * @description SDK功能配置
+ */
+type SDKConfig = {
     /**
-     * @description 已更改编辑包围盒预选颜色
+     * @description SDK编辑模式 - 模板编辑模式 | 编辑器模式
      */
-    hasChangedEditBoxPreSelectedColor: number;
+    mode: SDKMode;
     /**
-     * @description 已更改编辑包围盒预选透明度
+     * @description 页面功能配置
      */
-    hasChangedEditBoxPreSelectedAlpha: number;
+    pageConfig: PageConfig;
     /**
-   * @description 已更改编辑包围盒线框颜色
-   */
-    hasChangedEditBoxLinePreSelectedColor: number;
+     * @description 异步加载功能配置
+     */
+    asyncLoadConfig: AsyncLoadConfig;
     /**
-     * @description 已更改编辑包围盒线框透明度
+     * @description 截图功能配置
      */
-    hasChangedEditBoxLinePreSelectedAlpha: number;
+    screenShotConfig: ScreenShotConfig;
     /**
-     * @description 选中状态标记包围盒颜色
+     * @description 导出视频功能配置
      */
-    editBoxSelectedColor: number;
+    exportConfig: ExportConfig;
     /**
-     * @description 选中状态标记包围盒颜色
+     * @description 尺寸自适应功能开关
      */
-    editBoxSelectedAlpha: number;
+    sizeAdaptConfig: SizeAdaptConfig;
+    /**
+     * @description 辅助面板功能配置
+     */
+    gestureHandlerConfig: {
+        enabled: boolean;
+        adsorptionGizmoEnabled: boolean;
+        adsorptionGizmoConfig: AdsorptionGizmoConfig;
+        controlGizmoEnabled: boolean;
+        controlGizmoConfig: ControlGizmoConfig;
+        preferenceGizmoEnabled: boolean;
+        preferenceGizmoConfig: PreferenceGizmoConfig;
+        selectorGizmoEnabled: boolean;
+        selectorGizmoConfig: SelectorGizmoConfig;
+        transformGizmoEnabled: boolean;
+        transformGizmoConfig: TransformGizmoConfig;
+        pictureCutGizmoEnabled: boolean;
+        pictureCutGizmoConfig: PictureCutGizmoConfig;
+        pictureExpandGizmoEnabled: boolean;
+        pictureExpandGizmoConfig: PictureExpandGizmoConfig;
+        textGizmoEnbaled: boolean;
+        textGizmoConfig: TextGizmoConfig;
+        maskGizmoEnabled: boolean;
+        maskGizmoConfig: MaskGizmoConfig;
+        spriteTextEditGizmoEnabled: boolean;
+        spriteTextEditGizmoConfig: SpriteTextEditGizmoConfig;
+        videoPlayGizmoEnabled: boolean;
+        videoPlayGizmoConfig: VideoPlayGizmoConfig;
+        itemCreateGizmoEnabled: boolean;
+        itemCreateGizmoConfig: ItemCreateGizmoConfig;
+    };
 };
-type VideoPlayGizmoConfig = {
+/**
+ * @description 页面功能配置
+ */
+type PageConfig = {
     /**
-     * @description 自动展示
+     * @description 同步修改功能开关
      */
-    autoShow: boolean;
+    asncMode: boolean;
     /**
-     * @description 图标地址
+     * @description 静态预览【视图只提供播放预览功能】功能开关
      */
-    logoUrl: string;
+    staticPreview: boolean;
     /**
-     * @description 距离右下角偏移值
+     * @description 静态预览视图名称
      */
-    logoShift: [number, number];
+    staticPreviewName: string;
     /**
-     * @description 宽
+     * @description 需过滤的元素名称
      */
-    width: number;
+    filterItemNames: string[];
     /**
-     * @description 高
+     * @description 成组操作元素显隐
      */
-    height: number;
+    groupVisible: boolean;
+    /**
+     * @description 缩放最大值
+     */
+    maxZoom: number;
+    /**
+     * @description 缩放最小值
+     */
+    minZoom: number;
 };
-type ItemCreateGizmoConfig = {
-    frameColor: number;
+/**
+ * @description 异步加载配置
+ */
+type AsyncLoadConfig = {
+    enabled: boolean;
+    loadingTextureUrl: string;
 };
-
 /**
- * @description 精准改字功能初始化信息
+ * @description 视频导出功能配置
  */
-type SpriteTextInitParam = {
+type ExportConfig = {
+    enabled: boolean;
+} & ExportMediaInitOptions;
+/**
+ * @description 截图功能配置
+ */
+type ScreenShotConfig = {
+    enabled: boolean;
+};
+/**
+ * @description 尺寸自适应功能配置
+ */
+type SizeAdaptConfig = {
+    enabled: boolean;
+};
+/**
+ * @description 对齐吸附功能参数
+ */
+type AdsorptionGizmoConfig = {
     /**
-     * @description 元素ID
+   * @description 对齐吸附线宽
+   */
+    lineWidth: number;
+    /**
+     * @description 对齐线颜色
      */
-    id: string;
+    lineColor: number;
     /**
-     * @description 改字信息
+     * @description 对齐吸附距离
      */
-    info: SpriteTextInitInfo[];
+    distance: number;
 };
-type SpriteTextInitInfo = {
+/**
+ * @description 视图控制功能参数
+ */
+type ControlGizmoConfig = {
     /**
-     * @description 是否被修改过
+     * @description 缩放步长
      */
-    hasChanged: boolean;
+    zoomStep: number;
+};
+/**
+ * @description 视口展示功能参数
+ */
+type PreferenceGizmoConfig = {
     /**
-     * @description 文字内容
+   * @description 视口窗包围盒颜色
+   */
+    boxColor: number;
+    /**
+     * @description 视口窗包围盒宽度
      */
-    text: string;
+    boxWidth: number;
     /**
-     * @description 包围盒信息
+     * @description 视口区域外遮罩颜色
      */
-    box: [spec.vec2, spec.vec2, spec.vec2, spec.vec2];
-};
-type ItemCreateType = 'none' | 'text' | 'video-generator' | 'sprite-generator' | 'frame';
-type GizmoType = 'null' | 'selector' | 'transform' | 'control' | 'adsorption' | 'preference' | 'picture-cut' | 'text' | 'mask' | 'loading' | 'picture-expand' | 'sprite-text-edit' | 'video-play' | 'item-create';
-type GestureHandlerInteractType = 'select' | 'hand';
-
-declare module '@pixi/graphics' {
-    interface Graphics {
-        fillBox(box: Box2): void;
-        drawBox(box: Box2): void;
-        drawLine(line: Line2 | Point[]): void;
-        drawDashLine(toX: number, toY: number, dash: number, gap: number): void;
-    }
-}
-
-type AlignType = 'left' | 'right' | 'horizontal-center' | 'top' | 'bottom' | 'vertical-center';
-type DistributeType = 'vertical-spacing' | 'horizontal-spacing';
-
-type SDKEvents = {
-    'loadingItemChange': [id: string[]];
-    'selectedItemChange': [id: string[]];
-    'preSelectedItemChange': [id: string | undefined];
-    'selectedViewChange': [id: number];
-    'pageDataChange': [pageData: PageData];
-    'zoomChange': [zoom: number];
-    'progress': [{
-        duration: number;
-        time: number;
-        end: boolean;
-        paused: boolean;
-    }];
-    'itemPropertyChange': [{
-        id: string;
-        property: string;
-    }];
-    'exportProgress': [progress?: number];
-    'exportDone': [item: ExportItemParams | undefined, success: boolean, buffer?: FileBuffer];
-    'exportComplete': [success: boolean, taskInfos: ExportParams, buffers: Buffers, extras: Extras];
-    'sdkConfigChange': [preSDKConfig: SDKConfig, curSDKConfig: SDKConfig];
-    'cutBoxChange': [box: Box2];
-    'expandBoxChange': [box: Box2];
-    'textInput': [{
-        itemId: string;
-        text: string;
-        fontFamily: string;
-    }];
-    'undoRedoChange': [Operation];
-    'viewportTransform': [{
-        zoom: number;
-        translation: [number, number];
-    }];
-    'itemOnDragStart': [type: GizmoType];
-    'itemOnDrag': [type: GizmoType];
-    'itemOnDragEnd': [type: GizmoType];
-    'spriteTextClick': [{
-        id: string;
-        index: number;
-        text: string;
-    } | undefined];
-    'videoPlay': [{
-        id: string;
-        time: number;
-    }];
-    'itemCreate': [{
-        type: ItemCreateType;
-        position: spec.vec2;
-    }];
-    'viewLost': [];
-    'viewRebuildFinish': [];
-};
-declare class SDK {
-    static config: SDKConfig;
-    private _eventEmitter;
-    private _pageData;
-    private _screenShot;
-    private _exporter?;
-    private _pageDataUtils;
-    private _sizeAdapt;
-    private _gestureHandler;
-    private disposables;
-    private _isSwitchScene;
-    private _undoRedo;
-    player: Player;
-    _container: HTMLElement;
-    private _playerContainer;
-    constructor(container: HTMLElement, mode?: SDKMode);
-    get container(): HTMLElement;
-    get pageData(): PageData | undefined;
-    private get initExporterEnabled();
-    get exportStatus(): string | undefined;
-    get undoRedo(): UndoRedo;
-    private get exportOptions();
-    dispose(): void;
-    on: <E extends "progress" | "loadingItemChange" | "selectedItemChange" | "preSelectedItemChange" | "selectedViewChange" | "pageDataChange" | "zoomChange" | "itemPropertyChange" | "exportProgress" | "exportDone" | "exportComplete" | "sdkConfigChange" | "cutBoxChange" | "expandBoxChange" | "textInput" | "undoRedoChange" | "viewportTransform" | "itemOnDragStart" | "itemOnDrag" | "itemOnDragEnd" | "spriteTextClick" | "videoPlay" | "itemCreate" | "viewLost" | "viewRebuildFinish">(eventName: E, listener: _galacean_effects.EventEmitterListener<SDKEvents[E]>, options?: _galacean_effects.EventEmitterOptions) => () => void;
-    initPlayer(mode: SDKMode): void;
-    setSDKMode(mode: SDKMode): void;
-    private getInitParam;
-    private initExporter;
-    private initSDK;
-    run(param: SDKInputParam): Promise<void>;
-    getActiveItems(): string[];
-    setPreSelectedItem(id: string): void;
-    getPreSelectedItem(): string;
-    setSelectedItems(itemIds: string[]): void;
+    markColor: number;
     /**
-     * @description 获取目标元素的所有属性
-     * @param param 元素ID、类型
-     * @returns 元素属性
+     * @description 视口区域外遮罩透明度
      */
-    getItemProperty<T extends keyof PageFormTypeAndPropertyReference>(param: GetItemPropertyParam<T>): GetItemPropertyResult<T> | undefined;
+    markAlpha: number;
     /**
-     * @description 获取目标元素的指定属性
-     * @param param 元素ID、类型、属性名
-     * @returns 元素属性值
+     * @description 出血区预览开关
      */
-    getItemPropertyValue<T extends keyof PageFormTypeAndPropertyReference, N extends keyof PageFormTypeAndPropertyReference[T]>(param: GetItemPropertyValueParam<T, N>): GetItemPropertyValueResult<T, N> | undefined;
-    setItemPropertyValue(param: SetItemPropertyValueParam): Promise<void>;
-    generateScreenShot(id: number, size?: [number, number], tick?: number, backgroundColor?: spec.vec4): Promise<string | undefined>;
+    safeAreaEnabled: boolean;
     /**
-     * @description 切换场景
-     * @param index 场景索引
+     * @description 出血区颜色
      */
-    switchScene(index: number): Promise<void>;
+    safeAreaBoxColor: number;
     /**
-     * @description 获取页面的 safeAreaPreview、zoom、adsorption、translation 值
-     * @returns 页面的 safeAreaPreview、zoom、adsorption、translation 值
+     * @description 出血区透明度
      */
-    getPageConfig(): PageConfig;
+    safeAreaBoxAlpha: number;
+};
+/**
+ * @description 选择功能参数
+ */
+type SelectorGizmoConfig = {
     /**
-     * 设置页面的 safeAreaPreview、zoom、adsorption 值
-     * @param pageProperty 设置
+     * @description 视频预选中时
      */
-    setPageConfig(pageConfig: PageConfig): void;
+    videoPreSelectedPlay: boolean;
     /**
-     * @description 设置播放进度
-     * @param progress 播放进度 0-100
+     * @description 预选框线宽
      */
-    setPlayProgress(progress: number): Promise<void>;
+    preSelectedWidth: number;
     /**
-     * @description 获取元素
-     * @param id 元素ID
-     * @returns 元素
-     * */
-    getSDKItem(id: string): SDKItem$1 | undefined;
+     * @description 预选框颜色
+     */
+    preSelectedColor: number;
     /**
-     * @description 获取元素数组
-     * @param id 元素ID数组
-     * @returns 元素数组
-     * */
-    getSDKItems(ids?: string[]): SDKItem$1[];
-    setPlayState(playState: 'play' | 'pause'): Promise<void>;
+     * @description 框选区域颜色
+     */
+    regionBoxColor: number;
     /**
-     * @description 获取场景预览图
-     * @returns 视图预览图
+     * @description 框选区域透明度
      */
-    getViewThumbnail(): Promise<{
-        id: number;
-        thumbnail: string | undefined;
-    }>[];
+    regionBoxAlpha: number;
     /**
-     * @description 获取视图JSON产物
-     * @returns 当前所有视图JSON产物
+     * @description 框选区域包围框颜色
      */
-    getViewScene(): {
-        id: number;
-        thumbnail: spec.JSONScene;
-    }[];
-    private destroyCompositions;
+    regionWireframeColor: number;
     /**
-     * @description 以媒体格式 buffer 下载
+     * @description 框选区域包围框透明度
      */
-    downloadByMediaBuffersOfExporter(params: ExportMediaItemDownloadInfo[], buffers: Buffers, extras: Extras): void;
+    regionWireframeAlpha: number;
     /**
-     * @description 导出
-     * 支持导出媒体或其他，如MP4，未来支持 JSON 等；
+     * @description 框选区域包围框宽度
      */
-    onExport(): void;
+    regionWireframeWidth: number;
+};
+/**
+ * @description 变换功能参数
+ */
+type TransformGizmoConfig = {
     /**
-     * @description 取消导出
+     * @description 变换交互框颜色
      */
-    cancelExport(): void;
-    loadPageData(data: PageData): Promise<void>;
-    runByPageData(data: PageData): Promise<void>;
-    reloadPageDataByScene(scene: string | spec.JSONScene): Promise<void>;
+    wireframeColor: number;
     /**
-     * @description 新增视图数据
-     * @param viewParams 视图参数
-     * @param scene 场景数据 - 无输入时为默认场景数据
+     * @description 变换交互框透明度
      */
-    addViewParams(viewParams: ViewParam[], scene?: spec.JSONScene): Promise<void>;
-    deleteViewParams(ids: number[]): Promise<void>;
-    setExportParam(exportParam: Partial<ExportParam>, id?: number): void;
+    wireframeAlpha: number;
     /**
-     * @description 设置视图缩放
-     * @param zoom 缩放值
-     * @param center 缩放中心
-     * @param ignoreClamp 是否忽视约束
+     * @description 变换交互框宽度
      */
-    setPageZoom(zoom: number, center?: Vector2, ignoreClamp?: boolean): void;
+    wireframeWidth: number;
     /**
-     * @description 设置元素移动
-     * @param targetTranslation 目标移动值
+     * @description 变换交互框角点填充色
      */
-    setPageMove(targetTranslation: Vector2): void;
+    cornerFillColor: number;
     /**
-     * @description 设置静态预览功能开关
-     * @param enabled 功能开关
+     * @description 变换交互框角点线框色
      */
-    setStaticPreviewEnabled(enabled: boolean): void;
+    cornerLineColor: number;
     /**
-     * @description 设置静态预览视图名称
-     * @param name 视图名称
+     * @description 变换交互框角点线框宽度
      */
-    setStaticPreviewName(name: string): void;
+    cornerLineWidth: number;
     /**
-     * @description 设置同步修改功能开关
-     * @param enabled 功能开关
+     * @description 变换交互框角点线框透明度
      */
-    setAsyncEnabled(enabled: boolean): void;
+    cornerLineAlpha: number;
     /**
-     * @description 设置 成组显影 开关
+     * @description 交互框缩放圆半径
      */
-    setGroupVisibleEnabled(enabled: boolean): void;
+    scaleCircleSize: number;
     /**
-     * @description 新增过滤元素名称
-     * @param itemNames 过滤元素名称
+     * @description 交互框旋转圆半径
      */
-    addFilterItemNames(itemNames: string[] | string): void;
+    rotationCircleSize: number;
     /**
-     * @description 设置预览辅助层颜色
-     * @param color 色值
+     * @description 图片Logo地址
      */
-    setPreferenceBackgroundColor(color: [number, number, number, number]): void;
+    pictureLogoUrl: string;
     /**
-     * @description 设置出血区颜色
-     * @param color 色值
+     * @description 空节点Logo地址
      */
-    setSafeAreaColor(color: [number, number, number, number]): void;
+    groupLogoUrl: string;
     /**
-     * @description 设置 尺寸自适应拓展 功能开关
-     * @param enabled 功能开关
+     * @description 文本Logo地址
      */
-    setSizeAdaptEnabled(enabled: boolean): void;
+    textLogoUrl: string;
     /**
-     * @description 设置 截图 功能开关
-     * @param enabled 功能开关
+     * @description 视频Logo地址
      */
-    setScreenShotEnabled(enabled: boolean): void;
+    videoLogoUrl: string;
     /**
-     * @description 设置导出功能初始化配置
-     * @param exportConfig
+     * @description 大小文字颜色
      */
-    setExportConfig(exportConfig: Partial<ExportConfig>): void;
+    sizeTextColor: number;
     /**
-     * @description 设置预选框参数
-     * @param preSelectedColor 预选框颜色
-     * @param preSelectedWidth 预选框线框宽度
+     * @description 名称文字颜色
      */
-    setSelectorGizmoPreSelectConfig(preSelectedColor?: number, preSelectedWidth?: number): void;
+    nameTextColor: number;
     /**
-     * @description 设置 变换控制器 交互框参数
-     * @param config 参数
+     * @description 选中信息展示
      */
-    setTranformGizmoWireframeConfig(config: {
-        wireframeColor?: number;
-        wireframeAlpha?: number;
-        wireframeWidth?: number;
-    }): void;
+    infoShowEnabled: boolean;
+};
+/**
+ * @description 图片裁切参数
+ */
+type PictureCutGizmoConfig = {
     /**
-     * @description 获取 SDK 配置参数
-     * @returns SDK 配置参数
+     * @description 蒙版颜色
      */
-    getSDKConfig(): SDKConfig;
+    maskColor: number;
     /**
-     * @description 设置 SDK 配置参数
-     * @param config SDK 配置参数
+     * @description 蒙版透明度
      */
-    setSDKConfig(config: SDKConfig): void;
+    maskAlpha: number;
     /**
-     * @description 设置SDK背景
-     * @param type 背景类型
-     * @param value 值
+     * @description 裁切包围盒线框宽度
      */
-    setSDKBackground(type: SDKBackgroundType, value?: string): void;
+    cutBoxLineWidth: number;
     /**
-     * @description 创建图层元素
-     * @param spriteInfo 图层元素信息
+     * @description 裁切包围盒线框颜色
      */
-    addSpriteItem(spriteInfo: SpriteCreateInfo, scene?: spec.JSONScene): Promise<string>;
-    addVideoItem(videoInfo: VideoCreateInfo, scene?: spec.JSONScene): Promise<string>;
-    openPictureCutGizmo(): void;
-    closePictureCutGizmo(): void;
-    getCutInfo(): {
-        cutBox: Box2;
-        itemBox: Box2;
-    } | undefined;
-    setCutBox(min: Vector2, max: Vector2): Box2 | undefined;
-    openPictureExpandGizmo(): void;
-    closePictureExpandGizmo(): void;
-    getExpandInfo(): {
-        expandBox: Box2;
-        itemBox: Box2;
-    } | undefined;
-    setExpandBox(min: Vector2, max: Vector2): Box2 | undefined;
-    openMaskGizmo(brushSize: number): void;
-    clearMaskGizmo(): void;
-    closeMaskGizmo(): void;
-    getMask(): string | null | undefined;
-    setMaskGizmoConfig(config: Partial<MaskGizmoConfig>): void;
-    openLoadingGizmo(id: string, loadingBox?: Box2, clearResult?: boolean): void;
-    closeLoadingGizmo(id: string): void;
+    cutBoxLineColor: number;
     /**
-     * @description 元素打组
-     * @param children 子元素ID
+     * @description 裁切包围盒线框透明度
      */
-    groupItems(groupInfo: GroupCreateInfo, scene?: spec.JSONScene): string | undefined;
-    addTextItem(textInfo: TextCreateInfo, scene?: spec.JSONScene): Promise<string | undefined>;
-    addItemByCreateInfos(createInfos: ItemCreateInfo[], asyncMode?: boolean): Promise<string[]>;
-    deleteItems(idInfo: string | string[]): void;
-    getItemCreateInfo(id: string): ItemCreateInfo | undefined;
-    getItemCreateInfos(ids?: string[]): ItemCreateInfo[];
-    createScreenShotSceneByIds(idInfo: string | string[], time?: number): Promise<string | undefined>;
-    getChildrenIds(id: string): string[];
+    cutBoxLineAlpha: number;
     /**
-     * @description 更新元素在图层中的顺序
-     * @param id 元素ID
-     * @param action 排序操作：BringToFront（置于顶层）、SendToBack（置于底层）、BringForward（上移一层）、SendBackward（下移一层）
+     * @description 元素包围盒线框宽度
      */
-    updateItemOrder(id: string, action: ItemOrderAction): void;
+    itemBoxLineWidth: number;
     /**
-     * @description 导出JSON
-     * @param idInfo 视图序号信息
-     * @returns JSON数组
+     * @description 元素包围盒线框颜色
      */
-    exportJSON(idInfo?: number | number[]): spec.JSONScene[];
-    getViewBoxById(id: string): Box2;
+    itemBoxLineColor: number;
     /**
-     * @description 批量设置元素扩展属性
-     * @param id 元素ID
-     * @param extensions 扩展属性对象（支持同时设置多个）
-     * @returns 是否设置成功
+     * @description 元素包围盒线框透明度
      */
-    setItemExtensions(id: string, extensions: Record<string, any>): boolean;
+    itemBoxLineAlpha: number;
     /**
-     * @description 批量获取元素扩展属性
-     * @param id 元素ID
-     * @param keys 扩展属性名称列表（不传则返回所有扩展属性）
-     * @returns 扩展属性对象
+     * @description 裁切包围盒角度半径
      */
-    getItemExtensions(id: string, keys?: string[]): Record<string, any> | undefined;
+    cutBoxCornerRadius: number;
     /**
-     * @description 获取单个元素扩展属性
-     * @param id 元素ID
-     * @param key 扩展属性名称
-     * @returns 扩展属性值
+     * @description 裁切包围盒角点宽度
      */
-    getItemExtension(id: string, key: string): any;
+    cutBoxCornerLineWidth: number;
     /**
-     * @description 删除元素扩展属性（支持批量删除）
-     * @param id 元素ID
-     * @param keys 扩展属性名称列表
-     * @returns 是否删除成功
+     * @description 裁切包围盒角点颜色
      */
-    deleteItemExtensions(id: string, keys: string[]): boolean;
+    cutBoxCornerLineColor: number;
     /**
-     * @description 检查元素是否有指定扩展属性
-     * @param id 元素ID
-     * @param key 扩展属性名称
-     * @returns 是否存在
+     * @description 裁切包围盒角点透明度
      */
-    hasItemExtension(id: string, key: string): boolean;
+    cutBoxCornerLineAlpha: number;
     /**
-     * @description 获取元素所有扩展属性的键名列表
-     * @param id 元素ID
-     * @returns 键名数组
+     * @description 裁切包围盒角点填充色
      */
-    getItemExtensionKeys(id: string): string[] | undefined;
-    getViewProperty(id: number): ViewProperty | undefined;
-    pageMove(shift: [number, number]): void;
-    pageZoom(shift: number, center?: [number, number]): void;
+    cutBoxCornerFillColor: number;
     /**
-     * @description 设置视图缩放工具锁定缩放比例开关
-     * @param state 缩放比例开关
+     * @description 缩放判断距离
      */
-    setPictureCutGizmoLockScale(state: boolean): void;
+    scaleInteractionDistance: number;
     /**
-     * @description 设置视图扩展工具锁定缩放比例开关
-     * @param state 缩放比例开关
+     * @description 单向缩放判断距离
      */
-    setPictureExpandGizmoLockScale(state: boolean): void;
+    directionScaleInteractionDistance: number;
     /**
-     * @description 视图缩放函数
-     * @param shiftParam 视图偏移值
+     * @description 网格线数量
      */
-    viewportFit(shiftParam?: ViewportFitShiftParam, box?: Box2): void;
+    gridCount: number;
     /**
-     * @description 获取元素包围盒
-     * @param idInfo 元素Id
-     * @returns 元素包围盒
+     * @description 网格线颜色
      */
-    getItemBoxById(idInfo: string): Box2;
+    gridLineColor: number;
     /**
-     * @description 设置元素字体
-     * @param id 元素Id
-     * @param fontFamilyName 字体名称
-     * @param url 字体地址
+     * @description 网格线宽度
      */
-    setItemFontFamily(id: string, fontFamilyName: string, url: string): Promise<void>;
-    createSceneByCreateInfos(createInfos: ItemCreateInfo[], sceneInfo: SceneCreaetInfo): spec.JSONScene;
-    setSpriteSize(id: string, size: spec.vec2): void;
-    setItemPropertyByCreateInfo(createInfo: ItemCreateInfo | ItemCreateInfo[]): void;
-    setTransformGizmoLockScale(state: boolean): void;
-    getViewBoxByBox(box: Box2): Box2;
-    openSpriteTextEditGizmo(initParam: SpriteTextInitParam[]): void;
-    closeSpriteTextEditGizmo(): void;
-    setSpriteTextSelectedIndex(id: string, index: number): void;
-    setSpriteTextSelectedText(id: string, index: number, text: string): void;
-    getBoundingBoxByItemCreateInfo(createInfo: ItemCreateInfo): Box2;
-    getBoundingBoxByItemCreateInfos(createInfos: ItemCreateInfo[]): Box2;
-    setSpriteTextChangedState(id: string, index: number, hasChanged: boolean): void;
-    setSpriteTextEditState(id: string, index: number, isEditing: boolean): void;
-    getVideoItemPlayTime(id: string): number;
-    setVideoItemPlayTime(id: string, time: number): void;
-    getPixelPositionByViewPosition(viewPosition: Vector2): Vector2;
-    hitTest(x: number, y: number): string[] | undefined;
-    setInteractType(type: GestureHandlerInteractType): void;
-    makeItemAlign(type: AlignType, ids?: string[]): void;
-    makeItemDistribute(type: DistributeType, ids?: string[]): void;
+    gridLineWidth: number;
     /**
-     * @description 创建生成器元素
-     * @param createInfo 生成器创建信息
-     * @returns 生成器元素ID
+     * @description 网格线透明度
      */
-    addGeneratorItem(createInfo: GeneratorCreateInfo): string;
+    gridLineAlpha: number;
+};
+/**
+ * @description 图片扩边参数
+ */
+type PictureExpandGizmoConfig = {
     /**
-     * @description 创建动效元素（仅限调试使用）
-     * @param effectsInfo 动效创建信息
+     * @description 蒙版颜色
      */
-    addEffectsItem(effectsInfo: EffectsCreateInfo): Promise<string | undefined>;
+    maskColor: number;
     /**
-     * @description 设置生成器资源，将生成器转换为对应的元素
-     * @param id 生成器元素ID
-     * @param resourceUrl 资源地址
-     * @returns 新的元素ID
+     * @description 蒙版透明度
      */
-    setGeneratorResource(id: string, resourceUrl: string): Promise<string>;
+    maskAlpha: number;
     /**
-     * @description 设置生成器资源（使用 GeneratorResource 对象）
-     * @param resource 生成器资源信息
+     * @description 扩边包围盒线框宽度
      */
-    setGeneratorResourceFromObject(resource: GeneratorResource): void;
+    expandBoxLineWidth: number;
     /**
-     * @description 设置视频生成器资源
-     * @param resource 视频生成器资源信息
+     * @description 扩边包围盒线框颜色
      */
-    setVideoGeneratorResource(resource: VideoGeneratorResource): Promise<string>;
+    expandBoxLineColor: number;
     /**
-     * @description 设置图层生成器资源
-     * @param resource 图层生成器资源信息
+     * @description 扩边包围盒线框透明度
      */
-    setSpriteGeneratorResource(resource: SpriteGeneratorResource): Promise<string>;
-    setItemLockState(id: string, state: boolean): void;
-    getItemLockState(id: string): void;
-    openItemCreateGizmo(type: ItemCreateType): void;
-    closeItemCreateGizmo(): void;
-}
-
-type SizeAdaptDirection = 'x' | 'y';
-
-type BaseItemProperty = {
-    position: [number, number];
-    rotation: [number, number, number];
-    size: [number, number];
-    scale: [number, number];
-    visible?: boolean;
-    keyPropertyEditing: boolean;
-};
-type SpriteItemProperty = BaseItemProperty & {
-    image: string;
-};
-type GroupItemProperty = BaseItemProperty & {
-    children: string[];
-};
-type TextItemProperty = BaseItemProperty & {
-    fontFamily: string;
-    color: [number, number, number, number];
-    fontWeight: spec.TextWeight;
-    text: string;
-    textAlign: spec.TextAlignment;
-    fontSize: number;
-    fontStyle: spec.FontStyle;
-    textWidth: number;
-    lineHeight: number;
-    textHeight: number;
-    outlineColor?: spec.vec4;
-    outlineWidth?: number;
+    expandBoxLineAlpha: number;
     /**
-     * @description 描边开关
+     * @description 扩边包围盒角度半径
      */
-    outlineEnabled?: boolean;
-    fontUrl?: string;
-};
-type VideoItemProperty = BaseItemProperty & {
-    video: string;
-    /**
-   * @description 是否静音
-   */
-    muted?: boolean;
+    expandBoxCornerRadius: number;
     /**
-     * @description 是否为透明视频
+     * @description 扩边包围盒角点宽度
      */
-    transparent?: boolean;
+    expandBoxCornerLineWidth: number;
     /**
-     * @description 播放速率
+     * @description 扩边包围盒角点颜色
      */
-    playbackRate?: number;
+    expandBoxCornerLineColor: number;
     /**
-     * @description 音量
+     * @description 扩边包围盒角点透明度
      */
-    volume?: number;
-};
-/**
- * @description Generator 表单属性
- */
-type GeneratorItemProperty = BaseItemProperty & {
+    expandBoxCornerLineAlpha: number;
     /**
-     * @description 生成器类型
+     * @description 扩边包围盒角点填充色
      */
-    generatorType: 'image' | 'video';
-};
-type EffectsItemProperty = BaseItemProperty & {
-    effects: string;
-};
-/**
- * @description 页面表单类型和属性引用
- */
-type PageFormTypeAndPropertyReference = {
-    [spec.ItemType.base]: BaseItemProperty;
-    [spec.ItemType.sprite]: SpriteItemProperty;
-    [spec.ItemType.null]: BaseItemProperty;
-    [SDKItemType.SPRITE]: SpriteItemProperty;
-    [SDKItemType.TEXT]: TextItemProperty;
-    [SDKItemType.VIDEO]: VideoItemProperty;
-    [SDKItemType.GROUP]: GroupItemProperty;
-    [SDKItemType.GENERATOR]: GeneratorItemProperty;
-    [SDKItemType.EFFECTS]: EffectsItemProperty;
-    [SDKItemType.FRAME]: BaseItemProperty;
-    [spec.ItemType.interact]: BaseItemProperty;
-    [spec.ItemType.plugin]: BaseItemProperty;
-    [spec.ItemType.camera]: BaseItemProperty;
-    [spec.ItemType.composition]: BaseItemProperty;
-    [spec.ItemType.spine]: BaseItemProperty;
-    [spec.ItemType.mesh]: BaseItemProperty;
-    [spec.ItemType.tree]: BaseItemProperty;
-    [spec.ItemType.text]: TextItemProperty;
-    [spec.ItemType.light]: BaseItemProperty;
-    [spec.ItemType.skybox]: BaseItemProperty;
-    [spec.ItemType.effect]: BaseItemProperty;
-    [spec.ItemType.shape]: BaseItemProperty;
-    [spec.ItemType.postProcessVolume]: BaseItemProperty;
-    [spec.ItemType.node]: BaseItemProperty;
-    [spec.ItemType.video]: VideoItemProperty;
-    [spec.ItemType.audio]: BaseItemProperty;
-    [spec.ItemType.richtext]: TextItemProperty;
-};
-type SpecificPageFormProps<T extends keyof PageFormTypeAndPropertyReference> = {
-    type: T;
-    property: PageFormTypeAndPropertyReference[T];
-    onPropertyValueChange: <N extends keyof PageFormTypeAndPropertyReference[T]>(propertyName: N, propertyValue: PageFormTypeAndPropertyReference[T][N]) => void;
-};
-type SDKOptions = {
-    /** 导出视频时，是否开启转码日志 */
-    loggerInExportVideoTranscoding?: boolean;
-};
-type SDKInputParam = SDKTemplateInputParam | SDKEditorInputParam;
-/**
- * @description SDK入参
- */
-type SDKTemplateInputParam = {
+    expandBoxCornerFillColor: number;
     /**
-     * @description JSON地址
+     * @description 缩放判断距离
      */
-    scene: string | spec.JSONScene;
+    scaleInteractionDistance: number;
     /**
-     * @description SDK模式 - 模板编辑模式
+     * @description 单向缩放判断距离
      */
-    mode: 'template';
+    directionScaleInteractionDistance: number;
     /**
-     * @description 视图参数
+     * @description 网格线数量
      */
-    viewParams?: ViewParam[];
+    gridCount: number;
     /**
-     * @description 页面属性
+     * @description 网格线颜色
      */
-    options: PageOptions;
-};
-type SDKEditorInputParam = {
+    gridLineColor: number;
     /**
-     * @description SDK模式 - 编辑器模式
+     * @description 网格线宽度
      */
-    mode: 'editor';
+    gridLineWidth: number;
+    /**
+     * @description 网格线透明度
+     */
+    gridLineAlpha: number;
 };
 /**
- * @description 页面属性
+ * @description 文本交互控制器旋转交互模式
+ * 'corner': 角点旋转
+ * 'top-center': 顶部中心旋转
  */
-type PageOptions = {
+type TextGizmoRotateInteractMode = 'corner' | 'top-center';
+/**
+ * @description 文本交互控制器参数
+ */
+type TextGizmoConfig = {
     /**
-     * @description 同步模式开关
+     * @description 旋转交互模式
      */
-    asyncMode: boolean;
+    rotateInteractMode: TextGizmoRotateInteractMode;
     /**
-     * @description 安全区展示开关
+     * @description 包围盒线宽
      */
-    safeAreaPreview: boolean;
+    boxLineWidth: number;
     /**
-     * @description 吸附开关
+     * @description 包围盒线色
      */
-    adsorption: boolean;
-};
-/**
- * @description 页面数据
- */
-type PageData = {
+    boxLineColor: number;
     /**
-     * @description 基础场景数据
+     * @description 旋转交互点边长 - 用于 top-center 交互模式
      */
-    scene: spec.JSONScene;
+    rotationCornerWidth: number;
     /**
-     * @description 页面属性
+     * @description 旋转交互贴图地址
      */
-    property: PageProperty;
+    rotationCornerTexture: string;
     /**
-     * @description 视图属性
+     * @description 旋转交互点半径
      */
-    viewProperties: ViewProperty[];
+    rotationCornerRadius: number;
     /**
-     * @description 活跃数据
+     * @description top-center 模式旋转交互距离
      */
-    activeData: ActiveData;
+    rotationTopCenterInteractionDistance: number;
     /**
-     * @description 元素数据
+     * @description 旋转交互点填充色
      */
-    items: SDKItem[];
+    rotationCornerFillColor: number;
     /**
-     * @description 视图当前时间
+     * @description 旋转交互点描边宽度
      */
-    time: number;
+    rotationCornerStrokeWidth: number;
     /**
-     * @description 是否处于播放态
+     * @description 旋转交互点描边颜色
      */
-    playing: boolean;
-};
-/**
- * @description 页面配置
- */
-type PageConfig = {
+    rotationCornerStrokeColor: number;
     /**
-     * @description 出血区域展示开关
+     * @description Corner 模式旋转交互距离
      */
-    safeAreaPreview: boolean;
+    rotationCornerInteractionDistance: number;
     /**
-     * @description 缩放值
+     * @description 缩放交互点半径
      */
-    zoom: number;
+    scaleCornerRadius: number;
     /**
-     * @description 吸附开关
+     * @description 缩放交互点填充色
      */
-    adsorption: boolean;
+    scaleCornerFillColor: number;
     /**
-     * @description 同步开关
+     * @description 缩放交互点描边宽度
      */
-    asyncMode: boolean;
+    scaleCornerStrokeWidth: number;
     /**
-     * @description 画布移动
+     * @description 缩放交互点描边颜色
      */
-    translation: spec.vec2;
-};
-/**
- * @description 页面属性
- */
-type PageProperty = {
+    scaleCornerStrokeColor: number;
     /**
-     * @description 出血区域展示开关
+     * @description 触发缩放交互的距离
      */
-    safeAreaPreview: boolean;
+    scaleInteractionDistance: number;
     /**
-     * @description 缩放值
+     * @description 触发边缩放交互的距离
      */
-    zoom: number;
+    widthScaleInteractionDistance: number;
+};
+/**
+ * @description 蒙版参数
+ */
+type MaskGizmoConfig = {
     /**
-     * @description 偏移值
+     * @description 画笔大小
      */
-    translation: [number, number];
+    brushSize: number;
     /**
-     * @description 吸附开关
+     * @description 笔刷颜色
      */
-    adsorption: boolean;
+    brushColor: number;
     /**
-     * @description 同步开关
+     * @description 笔刷透明度
      */
-    asyncMode: boolean;
-};
-/**
- * @description 视图创建参数
- */
-type ViewParam = {
+    brushAlpha: number;
     /**
-     * @description 页面尺寸
+     * @description 蒙版颜色
      */
-    size?: [number, number];
+    maskColor: number;
     /**
-     * @description 出血区参数
+     * @description 蒙版透明度
      */
-    safeArea?: [number, number, number, number];
+    maskAlpha: number;
     /**
-     * @description 自适应方向 - 默认根据视图宽高决定
+     * @description 元素包围盒线框宽度
      */
-    adaptionDirection?: SizeAdaptDirection;
+    boxLineWidth: number;
     /**
-     * @description 自定义出血区 - 用于展示
+     * @description 元素包围盒线框颜色
      */
-    previewSafeAreas?: PreviewSafeAreaParam[];
+    boxLineColor: number;
     /**
-     * @description 导出参数
+     * @description 元素包围盒线框透明度
      */
-    export: ExportParam;
+    boxLineAlpha: number;
 };
 /**
- * @description 导出参数
+ * @description 精准改字编辑参数
  */
-type ExportParam = {
+type SpriteTextEditGizmoConfig = {
     /**
-     * @description 视频名称
+     * @description 文案颜色
      */
-    name?: string;
-} & Omit<ExportMediaItemOptions, 'scene' | 'size'>;
-/**
- * @description 视图属性
- */
-type ViewProperty = {
+    textColor: number;
     /**
-     * @description 视图ID
+     * @description 包围盒线框宽度
      */
-    id: number;
+    boxLineWidth: number;
     /**
-     * @description 视图宽高
+     * @description 包围盒间隔线长度
      */
-    size: [number, number];
+    dashLineDash: number;
     /**
-     * @description 出血区数据
+     * @description 包围盒间隔线间隔
      */
-    safeArea: [number, number, number, number];
+    dashLineGap: number;
     /**
-     * @description 自定义出血区数据
+     * @description 预选中文案颜色
      */
-    previewSafeAreas: PreviewSafeAreaParam[];
+    preSelectedTextColor: number;
     /**
-     * @description 视图场景数据
+     * @description 标记包围盒颜色
      */
-    scene: spec.JSONScene;
+    editBoxColor: number;
     /**
-     * @description 导出参数
+     * @description 编辑包围盒透明度
      */
-    export: ExportParam;
+    editBoxAlpha: number;
     /**
-     * @description 忽略交互 - 仅供展示
+     * @description 编辑包围盒线框颜色
      */
-    ignoreInteraction: boolean;
-};
-/**
- * @description 自定义出血区数据
- */
-type PreviewSafeAreaParam = {
+    editBoxLineColor: number;
     /**
-     * @description 出血区包围盒 [left top width height]
+     * @description 编辑包围盒线框透明度
      */
-    box: [number, number, number, number];
+    editBoxLineAlpha: number;
     /**
-     * @description 出血区色块颜色 默认为 [255, 255, 255, 0.3]
+     * @description 已更改编辑包围盒颜色
      */
-    color?: [number, number, number, number];
+    hasChangedEditBoxColor: number;
     /**
-     * @description 出血区图像
+     * @description 已更改编辑包围盒透明度
      */
-    url?: string;
+    hasChangedEditBoxAlpha: number;
     /**
-     * @description 出血区是否可见
+     * @description 已更改编辑包围盒线框颜色
      */
-    visible?: boolean;
-};
-/**
- * @description 页面活跃数据
- */
-type ActiveData = {
+    hasChangedEditBoxLineColor: number;
     /**
-     * @description 视图ID
+     * @description 已更改编辑包围盒线框透明度
      */
-    view?: number;
+    hasChangedEditBoxLineAlpha: number;
     /**
-     * @description 选中元素
+     * @description 编辑包围盒预选颜色
      */
-    selectedItems: string[];
+    editBoxPreSelectedColor: number;
     /**
-     * @description 预选中元素
+     * @description 编辑包围盒预选透明度
      */
-    preSelectedItem?: string;
+    editBoxPreSelectedAlpha: number;
     /**
-     * @description 执行中元素
+     * @description 编辑包围盒预选线框颜色
      */
-    loadingItems?: string[];
-};
-/**
- * @description 视图元素
- * @description 注意：SDKItem 现在已从类实现中导入，见 view-item/index.ts
- * @description SDKItem 现在是类实例而非普通对象，支持属性扩展
- * @description 保持类型兼容性：新 SDKItem 类拥有与旧类型相同的属性
- */
-type SDKItem = SDKItem$1;
-type SDKBackgroundType = 'color' | 'image' | 'chess-board' | 'dot-board';
-/**
- * @description 图层创建信息
- */
-type SpriteCreateInfo = {
-    type: SDKItemType.SPRITE;
+    editBoxLinePreSelectedColor: number;
     /**
-     * @description 图层名称
+     * @description 编辑包围盒预选线框透明度
      */
-    name?: string;
+    editBoxLinePreSelectedAlpha: number;
     /**
-     * @description 元素id
+     * @description 已更改编辑包围盒预选颜色
      */
-    id?: string;
+    hasChangedEditBoxPreSelectedColor: number;
     /**
-     * @description 父节点id
+     * @description 已更改编辑包围盒预选透明度
      */
-    parentId?: string;
+    hasChangedEditBoxPreSelectedAlpha: number;
     /**
-     * @description 扩展属性
+   * @description 已更改编辑包围盒线框颜色
+   */
+    hasChangedEditBoxLinePreSelectedColor: number;
+    /**
+     * @description 已更改编辑包围盒线框透明度
      */
-    extensions?: Record<string, any>;
+    hasChangedEditBoxLinePreSelectedAlpha: number;
     /**
-     * @description 元素属性
+     * @description 选中状态标记包围盒颜色
      */
-    property: {
-        /**
-         * @description 图片资源地址 | 数据
-         */
-        image: string;
-        /**
-         * @description 图层像素宽度
-         */
-        width: number;
-        /**
-         * @description 图层像素高度
-         */
-        height: number;
-        /**
-         * @description 元素位置
-         */
-        position: [number, number];
-        /**
-         * @description 元素旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 元素缩放
-         */
-        scale?: [number, number];
-    };
+    editBoxSelectedColor: number;
+    /**
+     * @description 选中状态标记包围盒颜色
+     */
+    editBoxSelectedAlpha: number;
 };
-/**
- * @description 空节点创建信息
- */
-type GroupCreateInfo = {
-    type: SDKItemType.GROUP;
+type VideoPlayGizmoConfig = {
     /**
-     * @description 元素id
+     * @description 自动展示
      */
-    id?: string;
+    autoShow: boolean;
     /**
-     * @description 父节点id
+     * @description 图标地址
      */
-    parentId?: string;
+    logoUrl: string;
     /**
-     * @description 元素名称
+     * @description 距离右下角偏移值
      */
-    name?: string;
+    logoShift: [number, number];
     /**
-     * @description 扩展属性
+     * @description 宽
      */
-    extensions?: Record<string, any>;
+    width: number;
     /**
-     * @description 元素属性
+     * @description 高
      */
-    property: {
-        /**
-         * @description 元素位置
-         */
-        position?: [number, number];
-        /**
-         * @description 元素旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 元素缩放
-         */
-        scale?: [number, number];
-        /**
-         * @description 子元素id
-         */
-        children: string[];
-    };
+    height: number;
 };
-/**
- * @description 文本创建信息
- */
-type TextCreateInfo = {
-    type: SDKItemType.TEXT;
+type ItemCreateGizmoConfig = {
     /**
-     * @description 元素id
+     * @description 边框颜色
      */
-    id?: string;
+    frameBorderColor: number;
     /**
-     * @description 父节点id
+     * @description 边框宽度
      */
-    parentId?: string;
+    frameBorderWidth: number;
     /**
-     * @description 元素名称
+     * @description 边框透明度
      */
-    name?: string;
+    frameBorderAlpha: number;
     /**
-     * @description 扩展属性
+     * @description 填充颜色
      */
-    extensions?: Record<string, any>;
+    frameFillColor: number;
     /**
-     * @description 元素属性
+     * @description 填充透明度
      */
-    property: {
-        /**
-         * @description 文本宽度
-         */
-        width: number;
-        /**
-         * @description 文本高度
-         */
-        height?: number;
-        /**
-         * @description 元素位置
-         */
-        position: [number, number];
-        /**
-         * @description 元素旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 元素缩放
-         */
-        scale?: [number, number];
-        /**
-         * @description 单行高度
-         */
-        lineHeight: number;
-        /**
-         * @description 字体名称
-         */
-        fontFamily: string;
-        /**
-         * @description 文字大小
-         */
-        fontSize: number;
-        /**
-         * @description 字重
-         */
-        fontWeight?: spec.TextWeight;
-        /**
-         * @description 字体格式
-         */
-        fontStyle?: spec.FontStyle;
-        /**
-         * @description 对齐方式
-         */
-        textAlign?: spec.TextAlignment;
-        /**
-         * @description 文本信息
-         */
-        text: string;
-        /**
-         * @description 填充色
-         */
-        color: spec.vec4;
-        /**
-         * @description 描边色
-         */
-        outlineColor?: spec.vec4;
-        /**
-         * @description 描边宽度
-         */
-        outlineWidth?: number;
-        /**
-         * @description 描边开关
-         */
-        outlineEnabled?: boolean;
-        /**
-         * @description 字体文件地址
-         */
-        fontUrl?: string;
-    };
+    frameFillAlpha: number;
 };
+
 /**
- * @description 视频创建信息
+ * @description 精准改字功能初始化信息
  */
-type VideoCreateInfo = {
-    type: SDKItemType.VIDEO;
+type SpriteTextInitParam = {
     /**
-     * @description 视频名称
+     * @description 元素ID
      */
-    name?: string;
+    id: string;
     /**
-     * @description 元素id
+     * @description 改字信息
      */
-    id?: string;
+    info: SpriteTextInitInfo[];
+};
+type SpriteTextInitInfo = {
     /**
-     * @description 父节点id
+     * @description 是否被修改过
      */
-    parentId?: string;
+    hasChanged: boolean;
     /**
-     * @description 扩展属性
+     * @description 文字内容
      */
-    extensions?: Record<string, any>;
+    text: string;
     /**
-     * @description 元素属性
+     * @description 包围盒信息
      */
-    property: {
-        /**
-         * @description 视频资源地址 | 数据
-         */
-        video: string;
-        /**
-         * @description 视频元素像素宽度
-         */
-        width: number;
-        /**
-         * @description 视频元素像素高度
-         */
-        height: number;
-        /**
-         * @description 视频元素位置
-         */
-        position: [number, number];
-        /**
-         * @description 视频元素旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 视频元素缩放
-         */
-        scale?: [number, number];
-        /**
-         * @description 是否静音
-         */
-        muted?: boolean;
-        /**
-         * @description 是否为透明视频
-         */
-        transparent?: boolean;
-        /**
-         * @description 播放速率
-         */
-        playbackRate?: number;
-        /**
-         * @description 音量
-         */
-        volume?: number;
-    };
+    box: [spec.vec2, spec.vec2, spec.vec2, spec.vec2];
 };
-/**
- * @description 生成器类型
- */
-type GeneratorType = 'image' | 'video';
-/**
- * @description 生成器创建信息
- */
-type GeneratorCreateInfo = {
+type ItemCreateType = 'none' | 'text' | 'video-generator' | 'sprite-generator' | 'frame';
+type GizmoType = 'null' | 'selector' | 'transform' | 'control' | 'adsorption' | 'preference' | 'picture-cut' | 'text' | 'mask' | 'loading' | 'picture-expand' | 'sprite-text-edit' | 'video-play' | 'item-create';
+type GestureHandlerInteractType = 'select' | 'hand';
+
+type AlignType = 'left' | 'right' | 'horizontal-center' | 'top' | 'bottom' | 'vertical-center';
+type DistributeType = 'vertical-spacing' | 'horizontal-spacing';
+
+declare module '@pixi/graphics' {
+    interface Graphics {
+        fillBox(box: Box2): void;
+        drawBox(box: Box2): void;
+        drawLine(line: Line2 | Point[]): void;
+        drawDashLine(toX: number, toY: number, dash: number, gap: number): void;
+    }
+}
+
+type SDKEvents = {
+    'loadingItemChange': [id: string[]];
+    'selectedItemChange': [id: string[]];
+    'preSelectedItemChange': [id: string | undefined];
+    'selectedViewChange': [id: number];
+    'pageDataChange': [pageData: PageData];
+    'zoomChange': [zoom: number];
+    'progress': [{
+        duration: number;
+        time: number;
+        end: boolean;
+        paused: boolean;
+    }];
+    'itemPropertyChange': [{
+        id: string;
+        property: string;
+    }];
+    'exportProgress': [progress?: number];
+    'exportDone': [item: ExportItemParams | undefined, success: boolean, buffer?: FileBuffer];
+    'exportComplete': [success: boolean, taskInfos: ExportParams, buffers: Buffers, extras: Extras];
+    'sdkConfigChange': [preSDKConfig: SDKConfig, curSDKConfig: SDKConfig];
+    'cutBoxChange': [box: Box2];
+    'expandBoxChange': [box: Box2];
+    'textInput': [{
+        itemId: string;
+        text: string;
+        fontFamily: string;
+    }];
+    'undoRedoChange': [Operation];
+    'viewportTransform': [{
+        zoom: number;
+        translation: [number, number];
+    }];
+    'itemOnDragStart': [type: GizmoType];
+    'itemOnDrag': [type: GizmoType];
+    'itemOnDragEnd': [type: GizmoType];
+    'spriteTextClick': [{
+        id: string;
+        index: number;
+        text: string;
+    } | undefined];
+    'videoPlay': [{
+        id: string;
+        time: number;
+    }];
+    'itemCreate': [{
+        type: ItemCreateType;
+        position: spec.vec2;
+        id: string;
+    }];
+    'viewLost': [];
+    'viewRebuildFinish': [];
+};
+declare class SDK {
+    static config: SDKConfig;
+    private _eventEmitter;
+    private _pageData;
+    private _screenShot;
+    private _exporter?;
+    private _pageDataUtils;
+    private _sizeAdapt;
+    private _gestureHandler;
+    private disposables;
+    private _isSwitchScene;
+    private _undoRedo;
+    player: Player;
+    _container: HTMLElement;
+    private _playerContainer;
+    constructor(container: HTMLElement, mode?: SDKMode);
+    get container(): HTMLElement;
+    get pageData(): PageData | undefined;
+    private get initExporterEnabled();
+    get exportStatus(): string | undefined;
+    get undoRedo(): UndoRedo;
+    private get exportOptions();
+    dispose(): void;
+    on: <E extends "progress" | "loadingItemChange" | "selectedItemChange" | "preSelectedItemChange" | "selectedViewChange" | "pageDataChange" | "zoomChange" | "itemPropertyChange" | "exportProgress" | "exportDone" | "exportComplete" | "sdkConfigChange" | "cutBoxChange" | "expandBoxChange" | "textInput" | "undoRedoChange" | "viewportTransform" | "itemOnDragStart" | "itemOnDrag" | "itemOnDragEnd" | "spriteTextClick" | "videoPlay" | "itemCreate" | "viewLost" | "viewRebuildFinish">(eventName: E, listener: _galacean_effects.EventEmitterListener<SDKEvents[E]>, options?: _galacean_effects.EventEmitterOptions) => () => void;
+    initPlayer(mode: SDKMode): void;
+    setSDKMode(mode: SDKMode): void;
+    private getInitParam;
+    private initExporter;
+    private initSDK;
+    run(param: SDKInputParam): Promise<void>;
+    getActiveItems(): string[];
+    setPreSelectedItem(id: string): void;
+    getPreSelectedItem(): string;
+    setSelectedItems(itemIds: string[]): void;
     /**
-     * @description 元素类型 - 生成器
+     * @description 设置元素属性（支持单个元素的单/多属性设置）
+     * @param param 设置参数，支持两种场景：
+     *   1. 单个元素单个属性: { itemId, type, propertyName, propertyValue }
+     *   2. 单个元素多个属性: { itemId, type, property }
      */
-    type: SDKItemType.GENERATOR;
+    setItemProperty<T extends SDKItemType>(param: SetItemPropertyParam<T>): Promise<void>;
+    generateScreenShot(id: number, size?: [number, number], tick?: number, backgroundColor?: spec.vec4): Promise<string | undefined>;
     /**
-     * @description 元素名称
+     * @description 切换场景
+     * @param index 场景索引
      */
-    name?: string;
+    switchScene(index: number): Promise<void>;
     /**
-     * @description 元素id
+     * @description 获取页面的 safeAreaPreview、zoom、adsorption、translation 值
+     * @returns 页面的 safeAreaPreview、zoom、adsorption、translation 值
      */
-    id?: string;
+    getPageConfig(): PageConfig$1;
     /**
-     * @description 父元素id
+     * 设置页面的 safeAreaPreview、zoom、adsorption 值
+     * @param pageProperty 设置
      */
-    parentId?: string;
+    setPageConfig(pageConfig: PageConfig$1): void;
     /**
-     * @description 扩展属性
+     * @description 设置播放进度
+     * @param progress 播放进度 0-100
      */
-    extensions?: Record<string, any>;
+    setPlayProgress(progress: number): Promise<void>;
     /**
-     * @description 元素属性
+     * @description 获取元素
+     * @param id 元素ID
+     * @returns 元素
+     * */
+    getSDKItem(id: string): SDKItem$1 | undefined;
+    /**
+     * @description 获取元素数组
+     * @param id 元素ID数组
+     * @returns 元素数组
+     * */
+    getSDKItems(ids?: string[]): SDKItem$1[];
+    setPlayState(playState: 'play' | 'pause'): Promise<void>;
+    /**
+     * @description 获取场景预览图
+     * @returns 视图预览图
      */
-    property: {
-        /**
-         * @description 生成器类型
-         */
-        generatorType: GeneratorType;
-        /**
-         * @description 生成器元素像素宽度
-         */
-        width: number;
-        /**
-         * @description 生成器元素像素高度
-         */
-        height: number;
-        /**
-         * @description 生成器元素位置
-         */
-        position: [number, number];
-        /**
-         * @description 生成器元素旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 生成器元素缩放
-         */
-        scale?: [number, number];
-    };
-};
-/**
- * @description 图片生成器资源信息
- */
-type SpriteGeneratorResource = {
+    getViewThumbnail(): Promise<{
+        id: number;
+        thumbnail: string | undefined;
+    }>[];
+    /**
+     * @description 获取视图JSON产物
+     * @returns 当前所有视图JSON产物
+     */
+    getViewScene(): {
+        id: number;
+        thumbnail: spec.JSONScene;
+    }[];
+    private destroyCompositions;
+    /**
+     * @description 以媒体格式 buffer 下载
+     */
+    downloadByMediaBuffersOfExporter(params: ExportMediaItemDownloadInfo[], buffers: Buffers, extras: Extras): void;
+    /**
+     * @description 导出
+     * 支持导出媒体或其他，如MP4，未来支持 JSON 等；
+     */
+    onExport(): void;
+    /**
+     * @description 取消导出
+     */
+    cancelExport(): void;
+    loadPageData(data: PageData): Promise<void>;
+    runByPageData(data: PageData): Promise<void>;
+    reloadPageDataByScene(scene: string | spec.JSONScene): Promise<void>;
+    /**
+     * @description 新增视图数据
+     * @param viewParams 视图参数
+     * @param scene 场景数据 - 无输入时为默认场景数据
+     */
+    addViewParams(viewParams: ViewParam[], scene?: spec.JSONScene): Promise<void>;
+    deleteViewParams(ids: number[]): Promise<void>;
+    setExportParam(exportParam: Partial<ExportParam>, id?: number): void;
+    /**
+     * @description 设置视图缩放
+     * @param zoom 缩放值
+     * @param center 缩放中心
+     * @param ignoreClamp 是否忽视约束
+     */
+    setPageZoom(zoom: number, center?: Vector2, ignoreClamp?: boolean): void;
+    /**
+     * @description 设置元素移动
+     * @param targetTranslation 目标移动值
+     */
+    setPageMove(targetTranslation: Vector2): void;
+    /**
+     * @description 设置静态预览功能开关
+     * @param enabled 功能开关
+     */
+    setStaticPreviewEnabled(enabled: boolean): void;
+    /**
+     * @description 设置静态预览视图名称
+     * @param name 视图名称
+     */
+    setStaticPreviewName(name: string): void;
+    /**
+     * @description 设置同步修改功能开关
+     * @param enabled 功能开关
+     */
+    setAsyncEnabled(enabled: boolean): void;
+    /**
+     * @description 设置 成组显影 开关
+     */
+    setGroupVisibleEnabled(enabled: boolean): void;
+    /**
+     * @description 新增过滤元素名称
+     * @param itemNames 过滤元素名称
+     */
+    addFilterItemNames(itemNames: string[] | string): void;
+    /**
+     * @description 设置预览辅助层颜色
+     * @param color 色值
+     */
+    setPreferenceBackgroundColor(color: [number, number, number, number]): void;
+    /**
+     * @description 设置出血区颜色
+     * @param color 色值
+     */
+    setSafeAreaColor(color: [number, number, number, number]): void;
+    /**
+     * @description 设置 尺寸自适应拓展 功能开关
+     * @param enabled 功能开关
+     */
+    setSizeAdaptEnabled(enabled: boolean): void;
+    /**
+     * @description 设置 截图 功能开关
+     * @param enabled 功能开关
+     */
+    setScreenShotEnabled(enabled: boolean): void;
+    /**
+     * @description 设置导出功能初始化配置
+     * @param exportConfig
+     */
+    setExportConfig(exportConfig: Partial<ExportConfig>): void;
     /**
-     * @description 资源地址
+     * @description 设置预选框参数
+     * @param preSelectedColor 预选框颜色
+     * @param preSelectedWidth 预选框线框宽度
      */
-    url: string;
+    setSelectorGizmoPreSelectConfig(preSelectedColor?: number, preSelectedWidth?: number): void;
     /**
-     * @description 资源尺寸
+     * @description 设置 变换控制器 交互框参数
+     * @param config 参数
      */
-    size?: spec.vec2;
+    setTranformGizmoWireframeConfig(config: {
+        wireframeColor?: number;
+        wireframeAlpha?: number;
+        wireframeWidth?: number;
+    }): void;
     /**
-     * @description 目标生成器元素 ID（必填）
+     * @description 获取 SDK 配置参数
+     * @returns SDK 配置参数
      */
-    itemId: string;
+    getSDKConfig(): SDKConfig;
     /**
-     * @description 扩展属性
+     * @description 设置 SDK 配置参数
+     * @param config SDK 配置参数
      */
-    extensions?: Record<string, any>;
-};
-/**
- * @description 视频生成器资源信息
- */
-type VideoGeneratorResource = {
+    setSDKConfig(config: SDKConfig): void;
     /**
-     * @description 资源地址
+     * @description 设置SDK背景
+     * @param type 背景类型
+     * @param value 值
      */
-    url: string;
+    setSDKBackground(type: SDKBackgroundType, value?: string): void;
     /**
-     * @description 资源尺寸
+     * @description 创建图层元素
+     * @param spriteInfo 图层元素信息
      */
-    size?: spec.vec2;
+    addSpriteItem(spriteInfo: SpriteCreateInfo, scene?: spec.JSONScene): Promise<string>;
+    addVideoItem(videoInfo: VideoCreateInfo, scene?: spec.JSONScene): Promise<string>;
+    openPictureCutGizmo(): void;
+    closePictureCutGizmo(): void;
+    getCutInfo(): {
+        cutBox: Box2;
+        itemBox: Box2;
+    } | undefined;
+    setCutBox(min: Vector2, max: Vector2): Box2 | undefined;
+    openPictureExpandGizmo(): void;
+    closePictureExpandGizmo(): void;
+    getExpandInfo(): {
+        expandBox: Box2;
+        itemBox: Box2;
+    } | undefined;
+    setExpandBox(min: Vector2, max: Vector2): Box2 | undefined;
+    openMaskGizmo(brushSize: number): void;
+    clearMaskGizmo(): void;
+    closeMaskGizmo(): void;
+    getMask(): string | null | undefined;
+    setMaskGizmoConfig(config: Partial<MaskGizmoConfig>): void;
     /**
-     * @description 是否静音（仅用于视频）
+     * @description 设置蒙版工具模式
+     * @param mode 模式类型：'paint' 表示涂抹，'erase' 表示擦除
      */
-    muted?: boolean;
+    setMaskGizmoMode(mode: 'paint' | 'erase'): void;
+    openLoadingGizmo(id: string, loadingBox?: Box2, clearResult?: boolean): void;
+    closeLoadingGizmo(id: string): void;
     /**
-     * @description 是否为透明视频（仅用于视频）
+     * @description 元素打组
+     * @param children 子元素ID
      */
-    transparent?: boolean;
+    groupItems(groupInfo: GroupCreateInfo, scene?: spec.JSONScene): string | undefined;
+    setItemParent(id: string, parentId: string): void;
+    deleteItemParent(id: string, parentId: string): void;
+    addTextItem(textInfo: TextCreateInfo, scene?: spec.JSONScene): Promise<string | undefined>;
+    addItemByCreateInfos(createInfos: ItemCreateInfo[], asyncMode?: boolean): Promise<string[]>;
+    deleteItems(idInfo: string | string[]): void;
+    getItemCreateInfo(id: string): ItemCreateInfo | undefined;
+    getItemCreateInfos(ids?: string[]): ItemCreateInfo[];
+    createScreenShotSceneByIds(idInfo: string | string[], time?: number): Promise<string | undefined>;
+    getChildrenIds(id: string): string[];
     /**
-     * @description 播放速率（仅用于视频）
+     * @description 更新元素在图层中的顺序
+     * @param id 元素ID
+     * @param action 排序操作：BringToFront（置于顶层）、SendToBack（置于底层）、BringForward（上移一层）、SendBackward（下移一层）
      */
-    playbackRate?: number;
+    updateItemOrder(id: string, action: ItemOrderAction): void;
     /**
-     * @description 音量（仅用于视频）
+     * @description 导出JSON
+     * @param idInfo 视图序号信息
+     * @returns JSON数组
      */
-    volume?: number;
+    exportJSON(idInfo?: number | number[]): spec.JSONScene[];
+    getViewBoxById(id: string): Box2;
     /**
-     * @description 目标生成器元素 ID（必填）
+     * @description 批量设置元素扩展属性
+     * @param id 元素ID
+     * @param extensions 扩展属性对象（支持同时设置多个）
+     * @returns 是否设置成功
      */
-    itemId: string;
+    setItemExtension(id: string, extension: Record<string, any>): boolean;
     /**
-     * @description 扩展属性
+     * @description 批量获取元素扩展属性
+     * @param id 元素ID
+     * @param keys 扩展属性名称列表（不传则返回所有扩展属性）
+     * @returns 扩展属性对象
      */
-    extensions?: Record<string, any>;
-};
-type GeneratorResource = SpriteGeneratorResource | VideoGeneratorResource;
-type EffectsCreateInfo = {
+    getItemExtension(id: string, keys?: string[]): Record<string, any> | undefined;
     /**
-     * @description 元素类型 - 特效
+     * @description 删除元素扩展属性（支持批量删除）
+     * @param id 元素ID
+     * @param keys 扩展属性名称列表
+     * @returns 是否删除成功
      */
-    type: SDKItemType.EFFECTS;
+    deleteItemExtensions(id: string, keys: string[]): boolean;
     /**
-     * @description 元素名称
+     * @description 检查元素是否有指定扩展属性
+     * @param id 元素ID
+     * @param key 扩展属性名称
+     * @returns 是否存在
      */
-    name?: string;
+    hasItemExtension(id: string, key: string): boolean;
     /**
-     * @description 元素id
+     * @description 获取元素所有扩展属性的键名列表
+     * @param id 元素ID
+     * @returns 键名数组
      */
-    id?: string;
+    getItemExtensionKeys(id: string): string[] | undefined;
+    getViewProperty(id: number): ViewProperty | undefined;
+    pageMove(shift: [number, number]): void;
+    pageZoom(shift: number, center?: [number, number]): void;
     /**
-     * @description 父元素id
+     * @description 设置视图缩放工具锁定缩放比例开关
+     * @param state 缩放比例开关
      */
-    parentId?: string;
-    property: {
-        /**
-         * @description 动效像素宽度
-         */
-        width?: number;
-        /**
-         * @description 动效像素高度
-         */
-        height?: number;
-        /**
-         * @description 生成器位置
-         */
-        position: spec.vec2;
-        /**
-         * @description 旋转角度
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 缩放
-         */
-        scale?: spec.vec2;
-        /**
-         * @description 动效资源地址
-         */
-        effects: string | spec.JSONScene;
-    };
+    setPictureCutGizmoLockScale(state: boolean): void;
     /**
-     * @description 扩展属性
+     * @description 设置视图扩展工具锁定缩放比例开关
+     * @param state 缩放比例开关
      */
-    extensions?: Record<string, any>;
-};
-type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo;
-/**
- * @description 场景创建信息
- */
-type SceneCreaetInfo = {
+    setPictureExpandGizmoLockScale(state: boolean): void;
     /**
-     * @description 场景名称
+     * @description 视图缩放函数
+     * @param shiftParam 视图偏移值
      */
-    name: string;
+    viewportFit(shiftParam?: ViewportFitShiftParam, box?: Box2): void;
     /**
-     * @description 场景大小
+     * @description 获取元素包围盒
+     * @param idInfo 元素Id
+     * @returns 元素包围盒
      */
-    size: spec.vec2;
-};
-declare enum ItemOrderAction {
-    BringToFront = 0,
-    SendToBack = 1,
-    BringForward = 2,
-    SendBackward = 3
-}
-/**
- * @description 视图自适应偏移参数
- */
-type ViewportFitShiftParam = {
+    getItemBoxById(idInfo: string): Box2;
     /**
-     * @description 左偏移
+     * @description 设置元素字体
+     * @param id 元素Id
+     * @param fontFamilyName 字体名称
+     * @param url 字体地址
      */
-    left?: number;
+    setItemFontFamily(id: string, fontFamilyName: string, url: string): Promise<void>;
+    createSceneByCreateInfos(createInfos: ItemCreateInfo[], sceneInfo: SceneCreaetInfo): spec.JSONScene;
+    setSpriteSize(id: string, size: spec.vec2): void;
+    setItemPropertyByCreateInfo(createInfo: ItemCreateInfo | ItemCreateInfo[]): void;
+    setTransformGizmoLockScale(state: boolean): void;
+    getViewBoxByBox(box: Box2): Box2;
+    openSpriteTextEditGizmo(initParam: SpriteTextInitParam[]): void;
+    closeSpriteTextEditGizmo(): void;
+    setSpriteTextSelectedIndex(id: string, index: number): void;
+    setSpriteTextSelectedText(id: string, index: number, text: string): void;
+    getBoundingBoxByItemCreateInfo(createInfo: ItemCreateInfo): Box2;
+    getBoundingBoxByItemCreateInfos(createInfos: ItemCreateInfo[]): Box2;
+    setSpriteTextChangedState(id: string, index: number, hasChanged: boolean): void;
+    setSpriteTextEditState(id: string, index: number, isEditing: boolean): void;
+    getVideoItemPlayTime(id: string): number;
+    setVideoItemPlayTime(id: string, time: number): void;
+    getPixelPositionByViewPosition(viewPosition: Vector2): Vector2;
+    hitTest(x: number, y: number): string[] | undefined;
+    setInteractType(type: GestureHandlerInteractType): void;
+    makeItemAlign(type: AlignType, ids?: string[]): void;
+    makeItemDistribute(type: DistributeType, ids?: string[]): void;
     /**
-     * @description 右偏移
+     * @description 创建生成器元素
+     * @param createInfo 生成器创建信息
+     * @returns 生成器元素ID
      */
-    right?: number;
+    addGeneratorItem(createInfo: GeneratorCreateInfo): string;
     /**
-     * @description 上偏移
+     * @description 创建动效元素（仅限调试使用）
+     * @param effectsInfo 动效创建信息
      */
-    top?: number;
+    addEffectsItem(effectsInfo: EffectsCreateInfo): Promise<string | undefined>;
     /**
-     * @description 下偏移
+     * @description 创建画板元素
+     * @param createInfo 画板创建信息
+     * @returns 画板元素ID
      */
-    bottom?: number;
-};
+    addFrameItem(createInfo: FrameCreateInfo): string;
+    /**
+     * @description 设置生成器资源，将生成器转换为对应的元素
+     * @param id 生成器元素ID
+     * @param resourceUrl 资源地址
+     * @returns 新的元素ID
+     */
+    setGeneratorResource(id: string, resourceUrl: string): Promise<string>;
+    /**
+     * @description 设置生成器资源（使用 GeneratorResource 对象）
+     * @param resource 生成器资源信息
+     */
+    setGeneratorResourceFromObject(resource: GeneratorResource): void;
+    /**
+     * @description 设置视频生成器资源
+     * @param resource 视频生成器资源信息
+     */
+    setVideoGeneratorResource(resource: VideoGeneratorResource): Promise<string>;
+    /**
+     * @description 设置图层生成器资源
+     * @param resource 图层生成器资源信息
+     */
+    setSpriteGeneratorResource(resource: SpriteGeneratorResource): Promise<string>;
+    setItemLockState(id: string, state: boolean): void;
+    getItemLockState(id: string): void;
+    openItemCreateGizmo(type: ItemCreateType): void;
+    closeItemCreateGizmo(): void;
+    setItemName(id: string, name: string): void;
+    setSafeAreaPreviewVisible(id: number, type: 'url' | 'color', visible: boolean): void;
+}
 
-export { type ActiveData, BaseItem, type BaseItemProperty, Box2, type CreateOperation, type DeleteOperation, type EffectsCreateInfo, EffectsItem, type EffectsItemOptions, type GeneratorCreateInfo, GeneratorItem, type GeneratorItemOptions, type GeneratorItemProperty, type GizmoType, type GroupCreateInfo, GroupItem, type GroupItemOptions, type ItemCreateInfo, ItemOrderAction, type Operation, type PageData, type PageFormTypedProperty, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKItem$1 as SDKItem, type SDKItemOptions, SDKItemType, type SDKOptions, type SetItemPropertyValueParam, type SpecificPageFormProps, type SpriteCreateInfo, SpriteItem, type SpriteItemOptions, type SpriteItemProperty, type TextCreateInfo, TextItem, type TextItemOptions, type TextItemProperty, type UpdateOperation, Vector2, type VideoCreateInfo, VideoItem, type VideoItemOptions, type VideoItemProperty, type ViewItemTypedProperty, type ViewParam, type ViewProperty, createSDKItem, isBaseItem, isEffectsItem, isGeneratorItem, isGroupItem, isSpriteItem, isTextItem, isVideoItem };
+export { type ActiveData, BaseItem, type BaseItemProperty, type BaseItemPropertyKey, type BaseItemPropertyValueMap, Box2, type CreateOperation, type DeleteOperation, type EffectsCreateInfo, EffectsItem, type EffectsItemOptions, type FrameCreateInfo, FrameItem, type FrameItemOptions, type FrameItemProperty, FrameLayoutMode, type GeneratorCreateInfo, GeneratorItem, type GeneratorItemOptions, type GeneratorItemProperty, type GizmoType, type GroupCreateInfo, GroupItem, type GroupItemOptions, type ItemCreateInfo, ItemOrderAction, type ItemPropertyMap, type Operation, type PageData, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKItem$1 as SDKItem, type SDKItemOptions, SDKItemType, type SDKOptions, type SetItemPropertyParam, type SetSingleItemMultiplePropertiesParam, type SetSingleItemSinglePropertyParam, type SpriteCreateInfo, SpriteItem, type SpriteItemOptions, type SpriteItemProperty, type TextCreateInfo, TextItem, type TextItemOptions, type TextItemProperty, type UpdateOperation, Vector2, type VideoCreateInfo, VideoItem, type VideoItemOptions, type VideoItemProperty, type ViewParam, type ViewProperty, createSDKItem, isBaseItem, isEffectsItem, isFrameItem, isGeneratorItem, isGroupItem, isSpriteItem, isTextItem, isVideoItem };