@vvfx/sdk 0.1.17-alpha.1 → 0.1.17-alpha.2

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 允许任意额外属性（用于兼容旧代码）
      */
@@ -154,10 +158,11 @@ declare abstract class BaseItem {
      * @description 是否处于锁定状态
      */
     isLocked: boolean;
+    isCoreEditable: boolean;
     /**
      * @description 扩展属性存储（与 property 同级）
      */
-    private _extensions;
+    private _extension;
     /**
      * @description 元素类型（由子类实现）
      * @description 支持 spec.ItemType 或扩展的 SDKItemType
@@ -201,7 +206,7 @@ declare abstract class BaseItem {
      * @description 获取所有扩展属性
      * @returns 扩展属性对象
      */
-    getExtensions(): Record<string, any>;
+    getAllExtension(): Record<string, any>;
     /**
      * @description 批量设置扩展属性
      * @param extensions 扩展属性对象
@@ -210,7 +215,7 @@ declare abstract class BaseItem {
     /**
      * @description 清空所有扩展属性
      */
-    clearExtensions(): void;
+    clearExtension(): void;
     /**
      * @description 转换为 CreateInfo（用于元素复制/导出）
      * @param withParent 是否包含父节点ID
@@ -259,11 +264,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 +280,7 @@ declare class SpriteItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -352,8 +357,8 @@ declare class TextItem extends BaseItem {
     /**
      * @description 文本宽度
      */
-    get textWidth(): number;
-    set textWidth(value: number);
+    get width(): number;
+    set width(value: number);
     /**
      * @description 行高
      */
@@ -362,8 +367,8 @@ declare class TextItem extends BaseItem {
     /**
      * @description 文本高度
      */
-    get textHeight(): number;
-    set textHeight(value: number);
+    get height(): number;
+    set height(value: number);
     /**
      * @description 描边颜色
      */
@@ -429,10 +434,15 @@ declare class VideoItem 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 旋转（二维旋转角度）
      */
@@ -445,6 +455,7 @@ declare class VideoItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -502,11 +513,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 +530,7 @@ declare class GroupItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -574,10 +581,15 @@ declare class GeneratorItem 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 旋转（二维旋转角度）
      */
@@ -590,6 +602,7 @@ declare class GeneratorItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -644,10 +657,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 +678,7 @@ declare class EffectsItem extends BaseItem {
     set fullRotation(value: [number, number, number]);
     /**
      * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
@@ -691,55 +710,6 @@ declare function createSDKItem(type: spec.ItemType, options: SDKItemOptions): Ba
  */
 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;
-};
-
 /**
  * @class 二维线段
  */
@@ -1027,31 +997,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,1987 +1182,2027 @@ 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[];
-    /**
-     * @description 成组操作元素显隐
-     */
-    groupVisible: boolean;
-    /**
-     * @description 缩放最大值
-     */
-    maxZoom: number;
+type GeneratorItemProperty = BaseItemProperty & {
     /**
-     * @description 缩放最小值
+     * @description 生成器类型
      */
-    minZoom: number;
+    generatorType: 'image' | 'video';
+};
+type EffectsItemProperty = BaseItemProperty & {
+    effects: 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]: BaseItemProperty;
 };
 /**
- * @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 = {
-    /**
-   * @description 视口窗包围盒颜色
-   */
-    boxColor: number;
+type SDKTemplateInputParam = {
     /**
-     * @description 视口窗包围盒宽度
+     * @description JSON地址
      */
-    boxWidth: number;
+    scene: string | spec.JSONScene;
     /**
-     * @description 视口区域外遮罩颜色
+     * @description SDK模式 - 模板编辑模式
      */
-    markColor: number;
-    /**
-     * @description 视口区域外遮罩透明度
-     */
-    markAlpha: number;
+    mode: 'template';
     /**
-     * @description 出血区预览开关
+     * @description 视图参数
      */
-    safeAreaEnabled: boolean;
+    viewParams?: ViewParam[];
     /**
-     * @description 出血区颜色
+     * @description 页面属性
      */
-    safeAreaBoxColor: number;
+    options: PageOptions;
+};
+type SDKEditorInputParam = {
     /**
-     * @description 出血区透明度
+     * @description SDK模式 - 编辑器模式
      */
-    safeAreaBoxAlpha: number;
+    mode: 'editor';
 };
 /**
- * @description 选择功能参数
+ * @description 页面属性
  */
-type SelectorGizmoConfig = {
+type PageOptions = {
     /**
-     * @description 视频预选中时
+     * @description 同步模式开关
      */
-    videoPreSelectedPlay: boolean;
+    asyncMode: boolean;
     /**
-     * @description 预选框线宽
+     * @description 安全区展示开关
      */
-    preSelectedWidth: number;
+    safeAreaPreview: boolean;
     /**
-     * @description 预选框颜色
+     * @description 吸附开关
      */
-    preSelectedColor: number;
+    adsorption: boolean;
+};
+/**
+ * @description 页面数据
+ */
+type PageData = {
     /**
-     * @description 框选区域颜色
+     * @description 基础场景数据
      */
-    regionBoxColor: number;
+    scene: spec.JSONScene;
     /**
-     * @description 框选区域透明度
+     * @description 页面属性
      */
-    regionBoxAlpha: number;
+    property: PageProperty;
     /**
-     * @description 框选区域包围框颜色
+     * @description 视图属性
      */
-    regionWireframeColor: number;
+    viewProperties: ViewProperty[];
     /**
-     * @description 框选区域包围框透明度
+     * @description 活跃数据
      */
-    regionWireframeAlpha: number;
+    activeData: ActiveData;
     /**
-     * @description 框选区域包围框宽度
+     * @description 元素数据
      */
-    regionWireframeWidth: number;
+    items: SDKItem[];
+    /**
+     * @description 视图当前时间
+     */
+    time: number;
+    /**
+     * @description 是否处于播放态
+     */
+    playing: boolean;
 };
 /**
- * @description 变换功能参数
+ * @description 页面配置
  */
-type TransformGizmoConfig = {
+type PageConfig$1 = {
     /**
-     * @description 变换交互框颜色
+     * @description 出血区域展示开关
      */
-    wireframeColor: number;
+    safeAreaPreview: boolean;
     /**
-     * @description 变换交互框透明度
+     * @description 缩放值
      */
-    wireframeAlpha: number;
+    zoom: number;
     /**
-     * @description 变换交互框宽度
+     * @description 吸附开关
      */
-    wireframeWidth: number;
+    adsorption: boolean;
     /**
-     * @description 变换交互框角点填充色
+     * @description 同步开关
      */
-    cornerFillColor: number;
+    asyncMode: boolean;
     /**
-     * @description 变换交互框角点线框色
+     * @description 画布移动
      */
-    cornerLineColor: number;
+    translation: spec.vec2;
+};
+/**
+ * @description 页面属性
+ */
+type PageProperty = {
     /**
-     * @description 变换交互框角点线框宽度
+     * @description 出血区域展示开关
      */
-    cornerLineWidth: number;
+    safeAreaPreview: boolean;
     /**
-     * @description 变换交互框角点线框透明度
+     * @description 缩放值
      */
-    cornerLineAlpha: number;
+    zoom: number;
     /**
-     * @description 交互框缩放圆半径
+     * @description 偏移值
      */
-    scaleCircleSize: number;
+    translation: [number, number];
     /**
-     * @description 交互框旋转圆半径
+     * @description 吸附开关
      */
-    rotationCircleSize: number;
+    adsorption: boolean;
     /**
-     * @description 图片Logo地址
+     * @description 同步开关
      */
-    pictureLogoUrl: string;
+    asyncMode: boolean;
+};
+/**
+ * @description 视图创建参数
+ */
+type ViewParam = {
     /**
-     * @description 空节点Logo地址
+     * @description 页面尺寸
      */
-    groupLogoUrl: string;
+    size?: [number, number];
     /**
-     * @description 文本Logo地址
+     * @description 出血区参数
      */
-    textLogoUrl: string;
+    safeArea?: [number, number, number, number];
     /**
-     * @description 视频Logo地址
+     * @description 自适应方向 - 默认根据视图宽高决定
      */
-    videoLogoUrl: string;
+    adaptionDirection?: SizeAdaptDirection;
     /**
-     * @description 大小文字颜色
+     * @description 自定义出血区 - 用于展示
      */
-    sizeTextColor: number;
+    previewSafeAreas?: PreviewSafeAreaParam[];
     /**
-     * @description 名称文字颜色
+     * @description 导出参数
      */
-    nameTextColor: number;
+    export: ExportParam;
+};
+/**
+ * @description 导出参数
+ */
+type ExportParam = {
     /**
-     * @description 选中信息展示
+     * @description 视频名称
      */
-    infoShowEnabled: boolean;
-};
+    name?: string;
+} & Omit<ExportMediaItemOptions, 'scene' | 'size'>;
 /**
- * @description 图片裁切参数
+ * @description 视图属性
  */
-type PictureCutGizmoConfig = {
+type ViewProperty = {
     /**
-     * @description 蒙版颜色
+     * @description 视图ID
      */
-    maskColor: number;
+    id: number;
     /**
-     * @description 蒙版透明度
+     * @description 视图宽高
      */
-    maskAlpha: number;
+    size: [number, number];
     /**
-     * @description 裁切包围盒线框宽度
+     * @description 出血区数据
      */
-    cutBoxLineWidth: number;
+    safeArea: [number, number, number, number];
     /**
-     * @description 裁切包围盒线框颜色
+     * @description 自定义出血区数据
      */
-    cutBoxLineColor: number;
+    previewSafeAreas: PreviewSafeAreaParam[];
     /**
-     * @description 裁切包围盒线框透明度
+     * @description 视图场景数据
      */
-    cutBoxLineAlpha: number;
+    scene: spec.JSONScene;
     /**
-     * @description 元素包围盒线框宽度
+     * @description 导出参数
      */
-    itemBoxLineWidth: number;
+    export: ExportParam;
     /**
-     * @description 元素包围盒线框颜色
+     * @description 忽略交互 - 仅供展示
      */
-    itemBoxLineColor: number;
+    ignoreInteraction: boolean;
+};
+/**
+ * @description 自定义出血区数据
+ */
+type PreviewSafeAreaParam = {
     /**
-     * @description 元素包围盒线框透明度
+     * @description 出血区包围盒 [left top width height]
      */
-    itemBoxLineAlpha: number;
+    box: [number, number, number, number];
     /**
-     * @description 裁切包围盒角度半径
+     * @description 出血区色块颜色 默认为 [255, 255, 255, 0.3]
      */
-    cutBoxCornerRadius: number;
+    color?: [number, number, number, number];
     /**
-     * @description 裁切包围盒角点宽度
+     * @description 出血区图像
      */
-    cutBoxCornerLineWidth: number;
+    url?: string;
     /**
-     * @description 裁切包围盒角点颜色
+     * @description 出血区是否可见
      */
-    cutBoxCornerLineColor: number;
+    visible?: boolean;
+};
+/**
+ * @description 页面活跃数据
+ */
+type ActiveData = {
     /**
-     * @description 裁切包围盒角点透明度
+     * @description 视图ID
      */
-    cutBoxCornerLineAlpha: number;
+    view?: number;
     /**
-     * @description 裁切包围盒角点填充色
+     * @description 选中元素
      */
-    cutBoxCornerFillColor: number;
+    selectedItems: string[];
     /**
-     * @description 缩放判断距离
+     * @description 预选中元素
      */
-    scaleInteractionDistance: number;
+    preSelectedItem?: string;
     /**
-     * @description 单向缩放判断距离
+     * @description 执行中元素
      */
-    directionScaleInteractionDistance: 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 图层名称
      */
-    gridCount: number;
+    name?: string;
     /**
-     * @description 网格线颜色
+     * @description 元素id
      */
-    gridLineColor: number;
+    id?: string;
     /**
-     * @description 网格线宽度
+     * @description 父节点id
      */
-    gridLineWidth: number;
+    parentId?: string;
     /**
-     * @description 网格线透明度
+     * @description 扩展属性
      */
-    gridLineAlpha: number;
+    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 = {
-    /**
-     * @description 蒙版颜色
-     */
-    maskColor: number;
+type GroupCreateInfo = {
+    type: SDKItemType.GROUP;
     /**
-     * @description 蒙版透明度
+     * @description 元素id
      */
-    maskAlpha: number;
+    id?: string;
     /**
-     * @description 扩边包围盒线框宽度
+     * @description 父节点id
      */
-    expandBoxLineWidth: number;
+    parentId?: string;
     /**
-     * @description 扩边包围盒线框颜色
+     * @description 元素名称
      */
-    expandBoxLineColor: number;
+    name?: string;
     /**
-     * @description 扩边包围盒线框透明度
+     * @description 扩展属性
      */
-    expandBoxLineAlpha: number;
+    extension?: Record<string, any>;
     /**
-     * @description 扩边包围盒角度半径
+     * @description 元素属性
      */
-    expandBoxCornerRadius: 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
      */
-    expandBoxCornerLineWidth: number;
+    id?: string;
     /**
-     * @description 扩边包围盒角点颜色
+     * @description 父节点id
      */
-    expandBoxCornerLineColor: number;
+    parentId?: string;
     /**
-     * @description 扩边包围盒角点透明度
+     * @description 元素名称
      */
-    expandBoxCornerLineAlpha: number;
+    name?: string;
     /**
-     * @description 扩边包围盒角点填充色
+     * @description 扩展属性
      */
-    expandBoxCornerFillColor: number;
+    extension?: Record<string, any>;
     /**
-     * @description 缩放判断距离
+     * @description 元素属性
      */
-    scaleInteractionDistance: 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 视频名称
      */
-    directionScaleInteractionDistance: number;
+    name?: string;
     /**
-     * @description 网格线数量
+     * @description 元素id
      */
-    gridCount: number;
+    id?: string;
     /**
-     * @description 网格线颜色
+     * @description 父节点id
      */
-    gridLineColor: number;
+    parentId?: string;
     /**
-     * @description 网格线宽度
+     * @description 扩展属性
      */
-    gridLineWidth: number;
+    extension?: Record<string, any>;
     /**
-     * @description 网格线透明度
+     * @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 = {
+type GeneratorCreateInfo = {
     /**
-     * @description 旋转交互模式
+     * @description 元素类型 - 生成器
      */
-    rotateInteractMode: TextGizmoRotateInteractMode;
+    type: SDKItemType.GENERATOR;
     /**
-     * @description 包围盒线宽
+     * @description 元素名称
      */
-    boxLineWidth: number;
+    name?: string;
     /**
-     * @description 包围盒线色
+     * @description 元素id
      */
-    boxLineColor: number;
-    /**
-     * @description 旋转交互点边长 - 用于 top-center 交互模式
-     */
-    rotationCornerWidth: number;
-    /**
-     * @description 旋转交互贴图地址
-     */
-    rotationCornerTexture: string;
+    id?: string;
     /**
-     * @description 旋转交互点半径
+     * @description 父元素id
      */
-    rotationCornerRadius: number;
+    parentId?: string;
     /**
-     * @description top-center 模式旋转交互距离
+     * @description 扩展属性
      */
-    rotationTopCenterInteractionDistance: number;
+    extension?: Record<string, any>;
     /**
-     * @description 旋转交互点填充色
+     * @description 元素属性
      */
-    rotationCornerFillColor: 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 资源地址
      */
-    rotationCornerStrokeWidth: number;
+    url: string;
     /**
-     * @description 旋转交互点描边颜色
+     * @description 资源尺寸
      */
-    rotationCornerStrokeColor: number;
+    size?: spec.vec2;
     /**
-     * @description Corner 模式旋转交互距离
+     * @description 目标生成器元素 ID（必填）
      */
-    rotationCornerInteractionDistance: number;
+    itemId: string;
     /**
-     * @description 缩放交互点半径
+     * @description 扩展属性
      */
-    scaleCornerRadius: number;
+    extension?: Record<string, any>;
+};
+/**
+ * @description 视频生成器资源信息
+ */
+type VideoGeneratorResource = {
     /**
-     * @description 缩放交互点填充色
+     * @description 资源地址
      */
-    scaleCornerFillColor: number;
+    url: string;
     /**
-     * @description 缩放交互点描边宽度
+     * @description 资源尺寸
      */
-    scaleCornerStrokeWidth: number;
+    size?: spec.vec2;
     /**
-     * @description 缩放交互点描边颜色
+     * @description 是否静音（仅用于视频）
      */
-    scaleCornerStrokeColor: number;
+    muted?: boolean;
     /**
-     * @description 触发缩放交互的距离
+     * @description 是否为透明视频（仅用于视频）
      */
-    scaleInteractionDistance: number;
+    transparent?: boolean;
     /**
-     * @description 触发边缩放交互的距离
+     * @description 播放速率（仅用于视频）
      */
-    widthScaleInteractionDistance: number;
-};
-/**
- * @description 蒙版参数
- */
-type MaskGizmoConfig = {
+    playbackRate?: number;
     /**
-     * @description 画笔大小
+     * @description 音量（仅用于视频）
      */
-    brushSize: number;
+    volume?: number;
     /**
-     * @description 笔刷颜色
+     * @description 目标生成器元素 ID（必填）
      */
-    brushColor: number;
+    itemId: string;
     /**
-     * @description 笔刷透明度
+     * @description 扩展属性
      */
-    brushAlpha: number;
+    extension?: Record<string, any>;
+};
+type GeneratorResource = SpriteGeneratorResource | VideoGeneratorResource;
+type EffectsCreateInfo = {
     /**
-     * @description 蒙版颜色
+     * @description 元素类型 - 特效
      */
-    maskColor: number;
+    type: SDKItemType.EFFECTS;
     /**
-     * @description 蒙版透明度
+     * @description 元素名称
      */
-    maskAlpha: number;
+    name?: string;
     /**
-     * @description 元素包围盒线框宽度
+     * @description 元素id
      */
-    boxLineWidth: number;
+    id?: string;
     /**
-     * @description 元素包围盒线框颜色
+     * @description 父元素id
      */
-    boxLineColor: 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 扩展属性
      */
-    boxLineAlpha: number;
+    extension?: Record<string, any>;
 };
+type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo;
 /**
- * @description 精准改字编辑参数
+ * @description 场景创建信息
  */
-type SpriteTextEditGizmoConfig = {
-    /**
-     * @description 文案颜色
-     */
-    textColor: number;
+type SceneCreaetInfo = {
     /**
-     * @description 包围盒线框宽度
+     * @description 场景名称
      */
-    boxLineWidth: number;
+    name: string;
     /**
-     * @description 包围盒间隔线长度
+     * @description 场景大小
      */
-    dashLineDash: number;
+    size: spec.vec2;
+};
+declare enum ItemOrderAction {
+    BringToFront = 0,
+    SendToBack = 1,
+    BringForward = 2,
+    SendBackward = 3
+}
+/**
+ * @description 视图自适应偏移参数
+ */
+type ViewportFitShiftParam = {
     /**
-     * @description 包围盒间隔线间隔
+     * @description 左偏移
      */
-    dashLineGap: number;
+    left?: number;
     /**
-     * @description 预选中文案颜色
+     * @description 右偏移
      */
-    preSelectedTextColor: number;
+    right?: number;
     /**
-     * @description 标记包围盒颜色
+     * @description 上偏移
      */
-    editBoxColor: number;
+    top?: number;
     /**
-     * @description 编辑包围盒透明度
+     * @description 下偏移
      */
-    editBoxAlpha: 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编辑模式 - 模板编辑模式 | 编辑器模式
      */
-    editBoxLineColor: number;
+    mode: SDKMode;
     /**
-     * @description 编辑包围盒线框透明度
+     * @description 页面功能配置
      */
-    editBoxLineAlpha: number;
+    pageConfig: PageConfig;
     /**
-     * @description 已更改编辑包围盒颜色
+     * @description 异步加载功能配置
      */
-    hasChangedEditBoxColor: number;
+    asyncLoadConfig: AsyncLoadConfig;
     /**
-     * @description 已更改编辑包围盒透明度
+     * @description 截图功能配置
      */
-    hasChangedEditBoxAlpha: number;
+    screenShotConfig: ScreenShotConfig;
     /**
-     * @description 已更改编辑包围盒线框颜色
+     * @description 导出视频功能配置
      */
-    hasChangedEditBoxLineColor: number;
+    exportConfig: ExportConfig;
     /**
-     * @description 已更改编辑包围盒线框透明度
+     * @description 尺寸自适应功能开关
      */
-    hasChangedEditBoxLineAlpha: number;
+    sizeAdaptConfig: SizeAdaptConfig;
     /**
-     * @description 编辑包围盒预选颜色
+     * @description 辅助面板功能配置
      */
-    editBoxPreSelectedColor: number;
+    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;
+    };
+};
+/**
+ * @description 页面功能配置
+ */
+type PageConfig = {
     /**
-     * @description 编辑包围盒预选透明度
+     * @description 同步修改功能开关
      */
-    editBoxPreSelectedAlpha: number;
+    asncMode: boolean;
     /**
-     * @description 编辑包围盒预选线框颜色
+     * @description 静态预览【视图只提供播放预览功能】功能开关
      */
-    editBoxLinePreSelectedColor: number;
+    staticPreview: boolean;
     /**
-     * @description 编辑包围盒预选线框透明度
+     * @description 静态预览视图名称
      */
-    editBoxLinePreSelectedAlpha: number;
+    staticPreviewName: string;
     /**
-     * @description 已更改编辑包围盒预选颜色
+     * @description 需过滤的元素名称
      */
-    hasChangedEditBoxPreSelectedColor: number;
+    filterItemNames: string[];
     /**
-     * @description 已更改编辑包围盒预选透明度
+     * @description 成组操作元素显隐
      */
-    hasChangedEditBoxPreSelectedAlpha: number;
+    groupVisible: boolean;
     /**
-   * @description 已更改编辑包围盒线框颜色
+     * @description 缩放最大值
+     */
+    maxZoom: number;
+    /**
+     * @description 缩放最小值
+     */
+    minZoom: number;
+};
+/**
+ * @description 异步加载配置
+ */
+type AsyncLoadConfig = {
+    enabled: boolean;
+    loadingTextureUrl: string;
+};
+/**
+ * @description 视频导出功能配置
+ */
+type ExportConfig = {
+    enabled: boolean;
+} & ExportMediaInitOptions;
+/**
+ * @description 截图功能配置
+ */
+type ScreenShotConfig = {
+    enabled: boolean;
+};
+/**
+ * @description 尺寸自适应功能配置
+ */
+type SizeAdaptConfig = {
+    enabled: boolean;
+};
+/**
+ * @description 对齐吸附功能参数
+ */
+type AdsorptionGizmoConfig = {
+    /**
+   * @description 对齐吸附线宽
    */
-    hasChangedEditBoxLinePreSelectedColor: number;
+    lineWidth: number;
     /**
-     * @description 已更改编辑包围盒线框透明度
+     * @description 对齐线颜色
      */
-    hasChangedEditBoxLinePreSelectedAlpha: number;
+    lineColor: number;
     /**
-     * @description 选中状态标记包围盒颜色
+     * @description 对齐吸附距离
      */
-    editBoxSelectedColor: number;
+    distance: number;
+};
+/**
+ * @description 视图控制功能参数
+ */
+type ControlGizmoConfig = {
     /**
-     * @description 选中状态标记包围盒颜色
+     * @description 缩放步长
      */
-    editBoxSelectedAlpha: number;
+    zoomStep: number;
 };
-type VideoPlayGizmoConfig = {
+/**
+ * @description 视口展示功能参数
+ */
+type PreferenceGizmoConfig = {
     /**
-     * @description 自动展示
+   * @description 视口窗包围盒颜色
+   */
+    boxColor: number;
+    /**
+     * @description 视口窗包围盒宽度
      */
-    autoShow: boolean;
+    boxWidth: number;
     /**
-     * @description 图标地址
+     * @description 视口区域外遮罩颜色
      */
-    logoUrl: string;
+    markColor: number;
     /**
-     * @description 距离右下角偏移值
+     * @description 视口区域外遮罩透明度
      */
-    logoShift: [number, number];
+    markAlpha: number;
     /**
-     * @description 宽
+     * @description 出血区预览开关
      */
-    width: number;
+    safeAreaEnabled: boolean;
     /**
-     * @description 高
+     * @description 出血区颜色
      */
-    height: number;
-};
-type ItemCreateGizmoConfig = {
-    frameColor: number;
+    safeAreaBoxColor: number;
+    /**
+     * @description 出血区透明度
+     */
+    safeAreaBoxAlpha: number;
 };
-
 /**
- * @description 精准改字功能初始化信息
+ * @description 选择功能参数
  */
-type SpriteTextInitParam = {
+type SelectorGizmoConfig = {
     /**
-     * @description 元素ID
+     * @description 视频预选中时
      */
-    id: string;
+    videoPreSelectedPlay: boolean;
     /**
-     * @description 改字信息
+     * @description 预选框线宽
      */
-    info: SpriteTextInitInfo[];
+    preSelectedWidth: number;
+    /**
+     * @description 预选框颜色
+     */
+    preSelectedColor: number;
+    /**
+     * @description 框选区域颜色
+     */
+    regionBoxColor: number;
+    /**
+     * @description 框选区域透明度
+     */
+    regionBoxAlpha: number;
+    /**
+     * @description 框选区域包围框颜色
+     */
+    regionWireframeColor: number;
+    /**
+     * @description 框选区域包围框透明度
+     */
+    regionWireframeAlpha: number;
+    /**
+     * @description 框选区域包围框宽度
+     */
+    regionWireframeWidth: number;
 };
-type SpriteTextInitInfo = {
+/**
+ * @description 变换功能参数
+ */
+type TransformGizmoConfig = {
     /**
-     * @description 是否被修改过
+     * @description 变换交互框颜色
      */
-    hasChanged: boolean;
+    wireframeColor: number;
     /**
-     * @description 文字内容
+     * @description 变换交互框透明度
      */
-    text: string;
+    wireframeAlpha: number;
     /**
-     * @description 包围盒信息
+     * @description 变换交互框宽度
      */
-    box: [spec.vec2, spec.vec2, spec.vec2, spec.vec2];
+    wireframeWidth: number;
+    /**
+     * @description 变换交互框角点填充色
+     */
+    cornerFillColor: number;
+    /**
+     * @description 变换交互框角点线框色
+     */
+    cornerLineColor: number;
+    /**
+     * @description 变换交互框角点线框宽度
+     */
+    cornerLineWidth: number;
+    /**
+     * @description 变换交互框角点线框透明度
+     */
+    cornerLineAlpha: number;
+    /**
+     * @description 交互框缩放圆半径
+     */
+    scaleCircleSize: number;
+    /**
+     * @description 交互框旋转圆半径
+     */
+    rotationCircleSize: number;
+    /**
+     * @description 图片Logo地址
+     */
+    pictureLogoUrl: string;
+    /**
+     * @description 空节点Logo地址
+     */
+    groupLogoUrl: string;
+    /**
+     * @description 文本Logo地址
+     */
+    textLogoUrl: string;
+    /**
+     * @description 视频Logo地址
+     */
+    videoLogoUrl: string;
+    /**
+     * @description 大小文字颜色
+     */
+    sizeTextColor: number;
+    /**
+     * @description 名称文字颜色
+     */
+    nameTextColor: number;
+    /**
+     * @description 选中信息展示
+     */
+    infoShowEnabled: boolean;
 };
-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;
+/**
+ * @description 图片裁切参数
+ */
+type PictureCutGizmoConfig = {
     /**
-     * @description 获取目标元素的所有属性
-     * @param param 元素ID、类型
-     * @returns 元素属性
+     * @description 蒙版颜色
      */
-    getItemProperty<T extends keyof PageFormTypeAndPropertyReference>(param: GetItemPropertyParam<T>): GetItemPropertyResult<T> | undefined;
+    maskColor: 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>;
+    maskAlpha: number;
     /**
-     * @description 切换场景
-     * @param index 场景索引
+     * @description 裁切包围盒线框宽度
      */
-    switchScene(index: number): Promise<void>;
+    cutBoxLineWidth: number;
     /**
-     * @description 获取页面的 safeAreaPreview、zoom、adsorption、translation 值
-     * @returns 页面的 safeAreaPreview、zoom、adsorption、translation 值
+     * @description 裁切包围盒线框颜色
      */
-    getPageConfig(): PageConfig;
+    cutBoxLineColor: number;
     /**
-     * 设置页面的 safeAreaPreview、zoom、adsorption 值
-     * @param pageProperty 设置
+     * @description 裁切包围盒线框透明度
      */
-    setPageConfig(pageConfig: PageConfig): void;
+    cutBoxLineAlpha: number;
     /**
-     * @description 设置播放进度
-     * @param progress 播放进度 0-100
+     * @description 元素包围盒线框宽度
      */
-    setPlayProgress(progress: number): Promise<void>;
-    /**
-     * @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>;
+    itemBoxLineWidth: number;
     /**
-     * @description 获取场景预览图
-     * @returns 视图预览图
+     * @description 元素包围盒线框颜色
      */
-    getViewThumbnail(): Promise<{
-        id: number;
-        thumbnail: string | undefined;
-    }>[];
+    itemBoxLineColor: number;
     /**
-     * @description 获取视图JSON产物
-     * @returns 当前所有视图JSON产物
+     * @description 元素包围盒线框透明度
      */
-    getViewScene(): {
-        id: number;
-        thumbnail: spec.JSONScene;
-    }[];
-    private destroyCompositions;
+    itemBoxLineAlpha: number;
     /**
-     * @description 以媒体格式 buffer 下载
+     * @description 裁切包围盒角度半径
      */
-    downloadByMediaBuffersOfExporter(params: ExportMediaItemDownloadInfo[], buffers: Buffers, extras: Extras): void;
+    cutBoxCornerRadius: number;
     /**
-     * @description 导出
-     * 支持导出媒体或其他，如MP4，未来支持 JSON 等；
+     * @description 裁切包围盒角点宽度
      */
-    onExport(): void;
+    cutBoxCornerLineWidth: number;
     /**
-     * @description 取消导出
+     * @description 裁切包围盒角点颜色
      */
-    cancelExport(): void;
-    loadPageData(data: PageData): Promise<void>;
-    runByPageData(data: PageData): Promise<void>;
-    reloadPageDataByScene(scene: string | spec.JSONScene): Promise<void>;
+    cutBoxCornerLineColor: 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;
+    cutBoxCornerLineAlpha: number;
     /**
-     * @description 设置视图缩放
-     * @param zoom 缩放值
-     * @param center 缩放中心
-     * @param ignoreClamp 是否忽视约束
+     * @description 裁切包围盒角点填充色
      */
-    setPageZoom(zoom: number, center?: Vector2, ignoreClamp?: boolean): void;
+    cutBoxCornerFillColor: number;
     /**
-     * @description 设置元素移动
-     * @param targetTranslation 目标移动值
+     * @description 缩放判断距离
      */
-    setPageMove(targetTranslation: Vector2): void;
+    scaleInteractionDistance: number;
     /**
-     * @description 设置静态预览功能开关
-     * @param enabled 功能开关
+     * @description 单向缩放判断距离
      */
-    setStaticPreviewEnabled(enabled: boolean): void;
+    directionScaleInteractionDistance: number;
     /**
-     * @description 设置静态预览视图名称
-     * @param name 视图名称
+     * @description 网格线数量
      */
-    setStaticPreviewName(name: string): void;
+    gridCount: number;
     /**
-     * @description 设置同步修改功能开关
-     * @param enabled 功能开关
+     * @description 网格线颜色
      */
-    setAsyncEnabled(enabled: boolean): void;
+    gridLineColor: number;
     /**
-     * @description 设置 成组显影 开关
+     * @description 网格线宽度
      */
-    setGroupVisibleEnabled(enabled: boolean): void;
+    gridLineWidth: number;
     /**
-     * @description 新增过滤元素名称
-     * @param itemNames 过滤元素名称
+     * @description 网格线透明度
      */
-    addFilterItemNames(itemNames: string[] | string): void;
+    gridLineAlpha: number;
+};
+/**
+ * @description 图片扩边参数
+ */
+type PictureExpandGizmoConfig = {
     /**
-     * @description 设置预览辅助层颜色
-     * @param color 色值
+     * @description 蒙版颜色
      */
-    setPreferenceBackgroundColor(color: [number, number, number, number]): void;
+    maskColor: number;
     /**
-     * @description 设置出血区颜色
-     * @param color 色值
+     * @description 蒙版透明度
      */
-    setSafeAreaColor(color: [number, number, number, number]): void;
+    maskAlpha: number;
     /**
-     * @description 设置 尺寸自适应拓展 功能开关
-     * @param enabled 功能开关
+     * @description 扩边包围盒线框宽度
      */
-    setSizeAdaptEnabled(enabled: boolean): void;
+    expandBoxLineWidth: number;
     /**
-     * @description 设置 截图 功能开关
-     * @param enabled 功能开关
+     * @description 扩边包围盒线框颜色
      */
-    setScreenShotEnabled(enabled: boolean): void;
+    expandBoxLineColor: number;
     /**
-     * @description 设置导出功能初始化配置
-     * @param exportConfig
+     * @description 扩边包围盒线框透明度
      */
-    setExportConfig(exportConfig: Partial<ExportConfig>): void;
+    expandBoxLineAlpha: number;
     /**
-     * @description 设置预选框参数
-     * @param preSelectedColor 预选框颜色
-     * @param preSelectedWidth 预选框线框宽度
+     * @description 扩边包围盒角度半径
      */
-    setSelectorGizmoPreSelectConfig(preSelectedColor?: number, preSelectedWidth?: number): void;
+    expandBoxCornerRadius: number;
     /**
-     * @description 设置 变换控制器 交互框参数
-     * @param config 参数
+     * @description 扩边包围盒角点宽度
      */
-    setTranformGizmoWireframeConfig(config: {
-        wireframeColor?: number;
-        wireframeAlpha?: number;
-        wireframeWidth?: number;
-    }): void;
+    expandBoxCornerLineWidth: number;
     /**
-     * @description 获取 SDK 配置参数
-     * @returns SDK 配置参数
+     * @description 扩边包围盒角点颜色
      */
-    getSDKConfig(): SDKConfig;
+    expandBoxCornerLineColor: number;
     /**
-     * @description 设置 SDK 配置参数
-     * @param config SDK 配置参数
+     * @description 扩边包围盒角点透明度
      */
-    setSDKConfig(config: SDKConfig): void;
+    expandBoxCornerLineAlpha: number;
     /**
-     * @description 设置SDK背景
-     * @param type 背景类型
-     * @param value 值
+     * @description 扩边包围盒角点填充色
      */
-    setSDKBackground(type: SDKBackgroundType, value?: string): void;
+    expandBoxCornerFillColor: 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;
+    scaleInteractionDistance: number;
     /**
-     * @description 元素打组
-     * @param children 子元素ID
+     * @description 单向缩放判断距离
      */
-    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[];
+    directionScaleInteractionDistance: number;
     /**
-     * @description 更新元素在图层中的顺序
-     * @param id 元素ID
-     * @param action 排序操作：BringToFront（置于顶层）、SendToBack（置于底层）、BringForward（上移一层）、SendBackward（下移一层）
+     * @description 网格线数量
      */
-    updateItemOrder(id: string, action: ItemOrderAction): void;
+    gridCount: number;
     /**
-     * @description 导出JSON
-     * @param idInfo 视图序号信息
-     * @returns JSON数组
+     * @description 网格线颜色
      */
-    exportJSON(idInfo?: number | number[]): spec.JSONScene[];
-    getViewBoxById(id: string): Box2;
+    gridLineColor: number;
     /**
-     * @description 批量设置元素扩展属性
-     * @param id 元素ID
-     * @param extensions 扩展属性对象（支持同时设置多个）
-     * @returns 是否设置成功
+     * @description 网格线宽度
      */
-    setItemExtensions(id: string, extensions: Record<string, any>): boolean;
+    gridLineWidth: number;
     /**
-     * @description 批量获取元素扩展属性
-     * @param id 元素ID
-     * @param keys 扩展属性名称列表（不传则返回所有扩展属性）
-     * @returns 扩展属性对象
+     * @description 网格线透明度
      */
-    getItemExtensions(id: string, keys?: string[]): Record<string, any> | undefined;
+    gridLineAlpha: number;
+};
+/**
+ * @description 文本交互控制器旋转交互模式
+ * 'corner': 角点旋转
+ * 'top-center': 顶部中心旋转
+ */
+type TextGizmoRotateInteractMode = 'corner' | 'top-center';
+/**
+ * @description 文本交互控制器参数
+ */
+type TextGizmoConfig = {
     /**
-     * @description 获取单个元素扩展属性
-     * @param id 元素ID
-     * @param key 扩展属性名称
-     * @returns 扩展属性值
+     * @description 旋转交互模式
      */
-    getItemExtension(id: string, key: string): any;
+    rotateInteractMode: TextGizmoRotateInteractMode;
     /**
-     * @description 删除元素扩展属性（支持批量删除）
-     * @param id 元素ID
-     * @param keys 扩展属性名称列表
-     * @returns 是否删除成功
+     * @description 包围盒线宽
      */
-    deleteItemExtensions(id: string, keys: string[]): boolean;
+    boxLineWidth: number;
     /**
-     * @description 检查元素是否有指定扩展属性
-     * @param id 元素ID
-     * @param key 扩展属性名称
-     * @returns 是否存在
+     * @description 包围盒线色
      */
-    hasItemExtension(id: string, key: string): boolean;
+    boxLineColor: number;
     /**
-     * @description 获取元素所有扩展属性的键名列表
-     * @param id 元素ID
-     * @returns 键名数组
+     * @description 旋转交互点边长 - 用于 top-center 交互模式
      */
-    getItemExtensionKeys(id: string): string[] | undefined;
-    getViewProperty(id: number): ViewProperty | undefined;
-    pageMove(shift: [number, number]): void;
-    pageZoom(shift: number, center?: [number, number]): void;
+    rotationCornerWidth: number;
     /**
-     * @description 设置视图缩放工具锁定缩放比例开关
-     * @param state 缩放比例开关
+     * @description 旋转交互贴图地址
      */
-    setPictureCutGizmoLockScale(state: boolean): void;
+    rotationCornerTexture: string;
     /**
-     * @description 设置视图扩展工具锁定缩放比例开关
-     * @param state 缩放比例开关
+     * @description 旋转交互点半径
      */
-    setPictureExpandGizmoLockScale(state: boolean): void;
+    rotationCornerRadius: number;
     /**
-     * @description 视图缩放函数
-     * @param shiftParam 视图偏移值
+     * @description top-center 模式旋转交互距离
      */
-    viewportFit(shiftParam?: ViewportFitShiftParam, box?: Box2): void;
+    rotationTopCenterInteractionDistance: number;
     /**
-     * @description 获取元素包围盒
-     * @param idInfo 元素Id
-     * @returns 元素包围盒
+     * @description 旋转交互点填充色
      */
-    getItemBoxById(idInfo: string): Box2;
+    rotationCornerFillColor: 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;
+    rotationCornerStrokeWidth: number;
     /**
-     * @description 创建生成器元素
-     * @param createInfo 生成器创建信息
-     * @returns 生成器元素ID
+     * @description 旋转交互点描边颜色
      */
-    addGeneratorItem(createInfo: GeneratorCreateInfo): string;
+    rotationCornerStrokeColor: number;
     /**
-     * @description 创建动效元素（仅限调试使用）
-     * @param effectsInfo 动效创建信息
+     * @description Corner 模式旋转交互距离
      */
-    addEffectsItem(effectsInfo: EffectsCreateInfo): Promise<string | undefined>;
+    rotationCornerInteractionDistance: number;
     /**
-     * @description 设置生成器资源，将生成器转换为对应的元素
-     * @param id 生成器元素ID
-     * @param resourceUrl 资源地址
-     * @returns 新的元素ID
+     * @description 缩放交互点半径
      */
-    setGeneratorResource(id: string, resourceUrl: string): Promise<string>;
+    scaleCornerRadius: number;
     /**
-     * @description 设置生成器资源（使用 GeneratorResource 对象）
-     * @param resource 生成器资源信息
+     * @description 缩放交互点填充色
      */
-    setGeneratorResourceFromObject(resource: GeneratorResource): void;
+    scaleCornerFillColor: number;
     /**
-     * @description 设置视频生成器资源
-     * @param resource 视频生成器资源信息
+     * @description 缩放交互点描边宽度
      */
-    setVideoGeneratorResource(resource: VideoGeneratorResource): Promise<string>;
+    scaleCornerStrokeWidth: 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;
-    setItemName(id: string, name: string): void;
-    setSafeAreaPreviewVisible(id: number, type: 'url' | 'color', visible: boolean): 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;
+    scaleCornerStrokeColor: number;
     /**
-     * @description 描边开关
+     * @description 触发缩放交互的距离
      */
-    outlineEnabled?: boolean;
-    fontUrl?: string;
-};
-type VideoItemProperty = BaseItemProperty & {
-    video: string;
+    scaleInteractionDistance: number;
     /**
-   * @description 是否静音
-   */
-    muted?: boolean;
-    /**
-     * @description 是否为透明视频
-     */
-    transparent?: boolean;
-    /**
-     * @description 播放速率
-     */
-    playbackRate?: number;
-    /**
-     * @description 音量
-     */
-    volume?: number;
-};
-/**
- * @description Generator 表单属性
- */
-type GeneratorItemProperty = BaseItemProperty & {
-    /**
-     * @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;
+    widthScaleInteractionDistance: number;
 };
-type SDKInputParam = SDKTemplateInputParam | SDKEditorInputParam;
 /**
- * @description SDK入参
+ * @description 蒙版参数
  */
-type SDKTemplateInputParam = {
+type MaskGizmoConfig = {
     /**
-     * @description JSON地址
+     * @description 画笔大小
      */
-    scene: string | spec.JSONScene;
+    brushSize: number;
     /**
-     * @description SDK模式 - 模板编辑模式
+     * @description 笔刷颜色
      */
-    mode: 'template';
+    brushColor: number;
     /**
-     * @description 视图参数
+     * @description 笔刷透明度
      */
-    viewParams?: ViewParam[];
+    brushAlpha: number;
     /**
-     * @description 页面属性
+     * @description 蒙版颜色
      */
-    options: PageOptions;
-};
-type SDKEditorInputParam = {
+    maskColor: number;
     /**
-     * @description SDK模式 - 编辑器模式
+     * @description 蒙版透明度
      */
-    mode: 'editor';
-};
-/**
- * @description 页面属性
- */
-type PageOptions = {
+    maskAlpha: number;
     /**
-     * @description 同步模式开关
+     * @description 元素包围盒线框宽度
      */
-    asyncMode: boolean;
+    boxLineWidth: number;
     /**
-     * @description 安全区展示开关
+     * @description 元素包围盒线框颜色
      */
-    safeAreaPreview: boolean;
+    boxLineColor: number;
     /**
-     * @description 吸附开关
+     * @description 元素包围盒线框透明度
      */
-    adsorption: boolean;
+    boxLineAlpha: number;
 };
 /**
- * @description 页面数据
+ * @description 精准改字编辑参数
  */
-type PageData = {
-    /**
-     * @description 基础场景数据
-     */
-    scene: spec.JSONScene;
-    /**
-     * @description 页面属性
-     */
-    property: PageProperty;
+type SpriteTextEditGizmoConfig = {
     /**
-     * @description 视图属性
+     * @description 文案颜色
      */
-    viewProperties: ViewProperty[];
+    textColor: number;
     /**
-     * @description 活跃数据
+     * @description 包围盒线框宽度
      */
-    activeData: ActiveData;
+    boxLineWidth: number;
     /**
-     * @description 元素数据
+     * @description 包围盒间隔线长度
      */
-    items: SDKItem[];
+    dashLineDash: number;
     /**
-     * @description 视图当前时间
+     * @description 包围盒间隔线间隔
      */
-    time: number;
+    dashLineGap: number;
     /**
-     * @description 是否处于播放态
+     * @description 预选中文案颜色
      */
-    playing: boolean;
-};
-/**
- * @description 页面配置
- */
-type PageConfig = {
+    preSelectedTextColor: number;
     /**
-     * @description 出血区域展示开关
+     * @description 标记包围盒颜色
      */
-    safeAreaPreview: boolean;
+    editBoxColor: number;
     /**
-     * @description 缩放值
+     * @description 编辑包围盒透明度
      */
-    zoom: number;
+    editBoxAlpha: number;
     /**
-     * @description 吸附开关
+     * @description 编辑包围盒线框颜色
      */
-    adsorption: boolean;
+    editBoxLineColor: number;
     /**
-     * @description 同步开关
+     * @description 编辑包围盒线框透明度
      */
-    asyncMode: boolean;
+    editBoxLineAlpha: number;
     /**
-     * @description 画布移动
+     * @description 已更改编辑包围盒颜色
      */
-    translation: spec.vec2;
-};
-/**
- * @description 页面属性
- */
-type PageProperty = {
+    hasChangedEditBoxColor: number;
     /**
-     * @description 出血区域展示开关
+     * @description 已更改编辑包围盒透明度
      */
-    safeAreaPreview: boolean;
+    hasChangedEditBoxAlpha: number;
     /**
-     * @description 缩放值
+     * @description 已更改编辑包围盒线框颜色
      */
-    zoom: number;
+    hasChangedEditBoxLineColor: number;
     /**
-     * @description 偏移值
+     * @description 已更改编辑包围盒线框透明度
      */
-    translation: [number, number];
+    hasChangedEditBoxLineAlpha: number;
     /**
-     * @description 吸附开关
+     * @description 编辑包围盒预选颜色
      */
-    adsorption: boolean;
+    editBoxPreSelectedColor: number;
     /**
-     * @description 同步开关
+     * @description 编辑包围盒预选透明度
      */
-    asyncMode: boolean;
-};
-/**
- * @description 视图创建参数
- */
-type ViewParam = {
+    editBoxPreSelectedAlpha: number;
     /**
-     * @description 页面尺寸
+     * @description 编辑包围盒预选线框颜色
      */
-    size?: [number, number];
+    editBoxLinePreSelectedColor: number;
     /**
-     * @description 出血区参数
+     * @description 编辑包围盒预选线框透明度
      */
-    safeArea?: [number, number, number, number];
+    editBoxLinePreSelectedAlpha: number;
     /**
-     * @description 自适应方向 - 默认根据视图宽高决定
+     * @description 已更改编辑包围盒预选颜色
      */
-    adaptionDirection?: SizeAdaptDirection;
+    hasChangedEditBoxPreSelectedColor: number;
     /**
-     * @description 自定义出血区 - 用于展示
+     * @description 已更改编辑包围盒预选透明度
      */
-    previewSafeAreas?: PreviewSafeAreaParam[];
+    hasChangedEditBoxPreSelectedAlpha: number;
     /**
-     * @description 导出参数
-     */
-    export: ExportParam;
-};
-/**
- * @description 导出参数
- */
-type ExportParam = {
+   * @description 已更改编辑包围盒线框颜色
+   */
+    hasChangedEditBoxLinePreSelectedColor: number;
     /**
-     * @description 视频名称
+     * @description 已更改编辑包围盒线框透明度
      */
-    name?: string;
-} & Omit<ExportMediaItemOptions, 'scene' | 'size'>;
-/**
- * @description 视图属性
- */
-type ViewProperty = {
+    hasChangedEditBoxLinePreSelectedAlpha: number;
     /**
-     * @description 视图ID
+     * @description 选中状态标记包围盒颜色
      */
-    id: number;
+    editBoxSelectedColor: number;
     /**
-     * @description 视图宽高
+     * @description 选中状态标记包围盒颜色
      */
-    size: [number, number];
+    editBoxSelectedAlpha: number;
+};
+type VideoPlayGizmoConfig = {
     /**
-     * @description 出血区数据
+     * @description 自动展示
      */
-    safeArea: [number, number, number, number];
+    autoShow: boolean;
     /**
-     * @description 自定义出血区数据
+     * @description 图标地址
      */
-    previewSafeAreas: PreviewSafeAreaParam[];
+    logoUrl: string;
     /**
-     * @description 视图场景数据
+     * @description 距离右下角偏移值
      */
-    scene: spec.JSONScene;
+    logoShift: [number, number];
     /**
-     * @description 导出参数
+     * @description 宽
      */
-    export: ExportParam;
+    width: number;
     /**
-     * @description 忽略交互 - 仅供展示
+     * @description 高
      */
-    ignoreInteraction: boolean;
+    height: number;
+};
+type ItemCreateGizmoConfig = {
+    frameColor: number;
 };
+
 /**
- * @description 自定义出血区数据
+ * @description 精准改字功能初始化信息
  */
-type PreviewSafeAreaParam = {
+type SpriteTextInitParam = {
     /**
-     * @description 出血区包围盒 [left top width height]
+     * @description 元素ID
      */
-    box: [number, number, number, number];
+    id: string;
     /**
-     * @description 出血区色块颜色 默认为 [255, 255, 255, 0.3]
+     * @description 改字信息
      */
-    color?: [number, number, number, number];
+    info: SpriteTextInitInfo[];
+};
+type SpriteTextInitInfo = {
     /**
-     * @description 出血区图像
-     */
-    url?: string;
-    /**
-     * @description 出血区是否可见
-     */
-    visible?: boolean;
-};
-/**
- * @description 页面活跃数据
- */
-type ActiveData = {
-    /**
-     * @description 视图ID
-     */
-    view?: number;
-    /**
-     * @description 选中元素
+     * @description 是否被修改过
      */
-    selectedItems: string[];
+    hasChanged: boolean;
     /**
-     * @description 预选中元素
+     * @description 文字内容
      */
-    preSelectedItem?: string;
+    text: string;
     /**
-     * @description 执行中元素
+     * @description 包围盒信息
      */
-    loadingItems?: string[];
+    box: [spec.vec2, spec.vec2, spec.vec2, spec.vec2];
 };
-/**
- * @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;
+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;
+    }];
+    '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 }
      */
-    name?: string;
+    setItemProperty<T extends SDKItemType>(param: SetItemPropertyParam<T>): Promise<void>;
+    generateScreenShot(id: number, size?: [number, number], tick?: number, backgroundColor?: spec.vec4): Promise<string | undefined>;
     /**
-     * @description 元素id
+     * @description 切换场景
+     * @param index 场景索引
      */
-    id?: string;
+    switchScene(index: number): Promise<void>;
     /**
-     * @description 父节点id
+     * @description 获取页面的 safeAreaPreview、zoom、adsorption、translation 值
+     * @returns 页面的 safeAreaPreview、zoom、adsorption、translation 值
      */
-    parentId?: string;
+    getPageConfig(): PageConfig$1;
     /**
-     * @description 扩展属性
+     * 设置页面的 safeAreaPreview、zoom、adsorption 值
+     * @param pageProperty 设置
      */
-    extensions?: Record<string, any>;
+    setPageConfig(pageConfig: PageConfig$1): void;
     /**
-     * @description 元素属性
+     * @description 设置播放进度
+     * @param progress 播放进度 0-100
      */
-    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 空节点创建信息
- */
-type GroupCreateInfo = {
-    type: SDKItemType.GROUP;
+    setPlayProgress(progress: number): Promise<void>;
     /**
-     * @description 元素id
-     */
-    id?: string;
+     * @description 获取元素
+     * @param id 元素ID
+     * @returns 元素
+     * */
+    getSDKItem(id: string): SDKItem$1 | undefined;
     /**
-     * @description 父节点id
+     * @description 获取元素数组
+     * @param id 元素ID数组
+     * @returns 元素数组
+     * */
+    getSDKItems(ids?: string[]): SDKItem$1[];
+    setPlayState(playState: 'play' | 'pause'): Promise<void>;
+    /**
+     * @description 获取场景预览图
+     * @returns 视图预览图
      */
-    parentId?: string;
+    getViewThumbnail(): Promise<{
+        id: number;
+        thumbnail: string | undefined;
+    }>[];
     /**
-     * @description 元素名称
+     * @description 获取视图JSON产物
+     * @returns 当前所有视图JSON产物
      */
-    name?: string;
+    getViewScene(): {
+        id: number;
+        thumbnail: spec.JSONScene;
+    }[];
+    private destroyCompositions;
     /**
-     * @description 扩展属性
+     * @description 以媒体格式 buffer 下载
      */
-    extensions?: Record<string, any>;
+    downloadByMediaBuffersOfExporter(params: ExportMediaItemDownloadInfo[], buffers: Buffers, extras: Extras): void;
     /**
-     * @description 元素属性
+     * @description 导出
+     * 支持导出媒体或其他，如MP4，未来支持 JSON 等；
      */
-    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;
+    onExport(): void;
     /**
-     * @description 元素id
+     * @description 取消导出
      */
-    id?: string;
+    cancelExport(): void;
+    loadPageData(data: PageData): Promise<void>;
+    runByPageData(data: PageData): Promise<void>;
+    reloadPageDataByScene(scene: string | spec.JSONScene): Promise<void>;
     /**
-     * @description 父节点id
+     * @description 新增视图数据
+     * @param viewParams 视图参数
+     * @param scene 场景数据 - 无输入时为默认场景数据
      */
-    parentId?: string;
+    addViewParams(viewParams: ViewParam[], scene?: spec.JSONScene): Promise<void>;
+    deleteViewParams(ids: number[]): Promise<void>;
+    setExportParam(exportParam: Partial<ExportParam>, id?: number): void;
     /**
-     * @description 元素名称
+     * @description 设置视图缩放
+     * @param zoom 缩放值
+     * @param center 缩放中心
+     * @param ignoreClamp 是否忽视约束
      */
-    name?: string;
+    setPageZoom(zoom: number, center?: Vector2, ignoreClamp?: boolean): void;
     /**
-     * @description 扩展属性
+     * @description 设置元素移动
+     * @param targetTranslation 目标移动值
      */
-    extensions?: Record<string, any>;
+    setPageMove(targetTranslation: Vector2): void;
     /**
-     * @description 元素属性
+     * @description 设置静态预览功能开关
+     * @param enabled 功能开关
      */
-    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;
+    setStaticPreviewEnabled(enabled: boolean): void;
     /**
-     * @description 视频名称
+     * @description 设置静态预览视图名称
+     * @param name 视图名称
      */
-    name?: string;
+    setStaticPreviewName(name: string): void;
     /**
-     * @description 元素id
+     * @description 设置同步修改功能开关
+     * @param enabled 功能开关
      */
-    id?: string;
+    setAsyncEnabled(enabled: boolean): void;
     /**
-     * @description 父节点id
+     * @description 设置 成组显影 开关
      */
-    parentId?: string;
+    setGroupVisibleEnabled(enabled: boolean): void;
     /**
-     * @description 扩展属性
+     * @description 新增过滤元素名称
+     * @param itemNames 过滤元素名称
      */
-    extensions?: Record<string, any>;
+    addFilterItemNames(itemNames: string[] | string): void;
     /**
-     * @description 元素属性
+     * @description 设置预览辅助层颜色
+     * @param color 色值
      */
-    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 生成器类型
- */
-type GeneratorType = 'image' | 'video';
-/**
- * @description 生成器创建信息
- */
-type GeneratorCreateInfo = {
+    setPreferenceBackgroundColor(color: [number, number, number, number]): void;
     /**
-     * @description 元素类型 - 生成器
+     * @description 设置出血区颜色
+     * @param color 色值
      */
-    type: SDKItemType.GENERATOR;
+    setSafeAreaColor(color: [number, number, number, number]): void;
     /**
-     * @description 元素名称
+     * @description 设置 尺寸自适应拓展 功能开关
+     * @param enabled 功能开关
      */
-    name?: string;
+    setSizeAdaptEnabled(enabled: boolean): void;
     /**
-     * @description 元素id
+     * @description 设置 截图 功能开关
+     * @param enabled 功能开关
      */
-    id?: string;
+    setScreenShotEnabled(enabled: boolean): void;
     /**
-     * @description 父元素id
+     * @description 设置导出功能初始化配置
+     * @param exportConfig
      */
-    parentId?: string;
+    setExportConfig(exportConfig: Partial<ExportConfig>): void;
     /**
-     * @description 扩展属性
+     * @description 设置预选框参数
+     * @param preSelectedColor 预选框颜色
+     * @param preSelectedWidth 预选框线框宽度
      */
-    extensions?: Record<string, any>;
+    setSelectorGizmoPreSelectConfig(preSelectedColor?: number, preSelectedWidth?: number): void;
     /**
-     * @description 元素属性
+     * @description 设置 变换控制器 交互框参数
+     * @param config 参数
      */
-    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 = {
+    setTranformGizmoWireframeConfig(config: {
+        wireframeColor?: number;
+        wireframeAlpha?: number;
+        wireframeWidth?: number;
+    }): void;
     /**
-     * @description 资源地址
+     * @description 获取 SDK 配置参数
+     * @returns SDK 配置参数
      */
-    url: string;
+    getSDKConfig(): SDKConfig;
     /**
-     * @description 资源尺寸
+     * @description 设置 SDK 配置参数
+     * @param config SDK 配置参数
      */
-    size?: spec.vec2;
+    setSDKConfig(config: SDKConfig): void;
     /**
-     * @description 目标生成器元素 ID（必填）
+     * @description 设置SDK背景
+     * @param type 背景类型
+     * @param value 值
      */
-    itemId: string;
+    setSDKBackground(type: SDKBackgroundType, value?: string): void;
     /**
-     * @description 扩展属性
+     * @description 创建图层元素
+     * @param spriteInfo 图层元素信息
      */
-    extensions?: Record<string, any>;
-};
-/**
- * @description 视频生成器资源信息
- */
-type VideoGeneratorResource = {
+    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' 表示擦除
      */
-    url: string;
+    setMaskGizmoMode(mode: 'paint' | 'erase'): void;
+    openLoadingGizmo(id: string, loadingBox?: Box2, clearResult?: boolean): void;
+    closeLoadingGizmo(id: string): void;
     /**
-     * @description 资源尺寸
+     * @description 元素打组
+     * @param children 子元素ID
      */
-    size?: spec.vec2;
+    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（下移一层）
      */
-    muted?: boolean;
+    updateItemOrder(id: string, action: ItemOrderAction): void;
     /**
-     * @description 是否为透明视频（仅用于视频）
+     * @description 导出JSON
+     * @param idInfo 视图序号信息
+     * @returns JSON数组
      */
-    transparent?: boolean;
+    exportJSON(idInfo?: number | number[]): spec.JSONScene[];
+    getViewBoxById(id: string): Box2;
     /**
-     * @description 播放速率（仅用于视频）
+     * @description 批量设置元素扩展属性
+     * @param id 元素ID
+     * @param extensions 扩展属性对象（支持同时设置多个）
+     * @returns 是否设置成功
      */
-    playbackRate?: number;
+    setItemExtensions(id: string, extensions: Record<string, any>): boolean;
     /**
-     * @description 音量（仅用于视频）
+     * @description 批量获取元素扩展属性
+     * @param id 元素ID
+     * @param keys 扩展属性名称列表（不传则返回所有扩展属性）
+     * @returns 扩展属性对象
      */
-    volume?: number;
+    getItemExtensions(id: string, keys?: string[]): Record<string, any> | undefined;
     /**
-     * @description 目标生成器元素 ID（必填）
+     * @description 获取单个元素扩展属性
+     * @param id 元素ID
+     * @param key 扩展属性名称
+     * @returns 扩展属性值
      */
-    itemId: string;
+    getItemExtension(id: string, key: string): any;
     /**
-     * @description 扩展属性
+     * @description 删除元素扩展属性（支持批量删除）
+     * @param id 元素ID
+     * @param keys 扩展属性名称列表
+     * @returns 是否删除成功
      */
-    extensions?: Record<string, any>;
-};
-type GeneratorResource = SpriteGeneratorResource | VideoGeneratorResource;
-type EffectsCreateInfo = {
+    deleteItemExtensions(id: string, keys: string[]): boolean;
     /**
-     * @description 元素类型 - 特效
+     * @description 检查元素是否有指定扩展属性
+     * @param id 元素ID
+     * @param key 扩展属性名称
+     * @returns 是否存在
      */
-    type: SDKItemType.EFFECTS;
+    hasItemExtension(id: string, key: string): boolean;
     /**
-     * @description 元素名称
+     * @description 获取元素所有扩展属性的键名列表
+     * @param id 元素ID
+     * @returns 键名数组
      */
-    name?: 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 缩放比例开关
      */
-    id?: string;
+    setPictureCutGizmoLockScale(state: boolean): 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;
-    };
+    setPictureExpandGizmoLockScale(state: boolean): void;
     /**
-     * @description 扩展属性
+     * @description 视图缩放函数
+     * @param shiftParam 视图偏移值
      */
-    extensions?: Record<string, any>;
-};
-type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo;
-/**
- * @description 场景创建信息
- */
-type SceneCreaetInfo = {
+    viewportFit(shiftParam?: ViewportFitShiftParam, box?: Box2): void;
     /**
-     * @description 场景名称
+     * @description 获取元素包围盒
+     * @param idInfo 元素Id
+     * @returns 元素包围盒
      */
-    name: string;
+    getItemBoxById(idInfo: string): Box2;
     /**
-     * @description 场景大小
+     * @description 设置元素字体
+     * @param id 元素Id
+     * @param fontFamilyName 字体名称
+     * @param url 字体地址
      */
-    size: spec.vec2;
-};
-declare enum ItemOrderAction {
-    BringToFront = 0,
-    SendToBack = 1,
-    BringForward = 2,
-    SendBackward = 3
-}
-/**
- * @description 视图自适应偏移参数
- */
-type ViewportFitShiftParam = {
+    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
      */
-    left?: number;
+    addGeneratorItem(createInfo: GeneratorCreateInfo): string;
     /**
-     * @description 右偏移
+     * @description 创建动效元素（仅限调试使用）
+     * @param effectsInfo 动效创建信息
      */
-    right?: number;
+    addEffectsItem(effectsInfo: EffectsCreateInfo): Promise<string | undefined>;
     /**
-     * @description 上偏移
+     * @description 设置生成器资源，将生成器转换为对应的元素
+     * @param id 生成器元素ID
+     * @param resourceUrl 资源地址
+     * @returns 新的元素ID
      */
-    top?: number;
+    setGeneratorResource(id: string, resourceUrl: string): Promise<string>;
     /**
-     * @description 下偏移
+     * @description 设置生成器资源（使用 GeneratorResource 对象）
+     * @param resource 生成器资源信息
      */
-    bottom?: number;
-};
+    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 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, isGeneratorItem, isGroupItem, isSpriteItem, isTextItem, isVideoItem };