@vvfx/sdk 0.0.0-alpha.9 → 0.0.0-alpha.91

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { spec, Player } from '@galacean/effects';
-export { spec } from '@galacean/effects';
-import * as _galacean_effects_weapp from '@galacean/effects/weapp';
+import * as _galacean_effects from '@galacean/effects';
+import { spec, math, Player } from '@galacean/effects';
+export { generateGUID, spec } from '@galacean/effects';
+import { Point } from '@pixi/constants';
 
 type ViewItemTypedProperty = {
     [K in keyof PageFormTypeAndPropertyReference]: {
@@ -44,7 +45,349 @@ type SetItemPropertyValueParam = {
             propertyValue: PageFormTypeAndPropertyReference[T][N];
         };
     }[keyof PageFormTypeAndPropertyReference[T]];
-}[keyof PageFormTypeAndPropertyReference];
+}[keyof PageFormTypeAndPropertyReference] | {
+    itemId: string;
+    type: spec.ItemType;
+    propertyName: 'position' | 'size';
+    propertyValue: spec.vec2 | spec.vec3;
+};
+
+/**
+ * @class 二维线段
+ */
+declare class Line2 {
+    start: Vector2;
+    end: Vector2;
+    constructor(start?: Vector2, end?: Vector2);
+    /**
+     * 设置二维线段
+     * @param {Vector2} start 线段起点
+     * @param {Vector2} end 线段终点
+     * @returns {Line2} 二维线段
+     */
+    set(start: Vector2, end: Vector2): this;
+    /**
+     * 复制二维线段
+     * @param {Line2} line 复制对象
+     * @returns {Line2} 复制结果
+     */
+    copyFrom(line: Line2): this;
+    /**
+     * 二维线段求方向
+     * @returns {Vector2} 二维线段方向
+     */
+    direction(): Vector2;
+    /**
+     * 二维线段求中点
+     * @param {Vector2} [target=new Vector2()] 目标保存对象
+     * @returns {Vector2} 二维线段中点
+     */
+    getCenter(target?: Vector2): Vector2;
+    /**
+     * 二维线段向量值
+     * @param {Vector2} [target=new Vector2()] 目标保存对象
+     * @returns {Vector2} 二维线段向量值
+     */
+    delta(target?: Vector2): Vector2;
+    /**
+     * 二维线段欧式距离平方(应用于计算)
+     * @returns {number} 计算结果
+     */
+    distanceSq(): number;
+    /**
+     * 二维线段欧式距离
+     * @returns {number} 计算结果
+     */
+    distance(): number;
+    /**
+     * 求二维线段比例点
+     * @param {number} t 比例值
+     * @param {Vector2} target 目标保存对象
+     * @returns {Vector2} 比例点结果
+     */
+    at(t: number, target?: Vector2): Vector2;
+    /**
+     * 求点与线段的最短距离
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} clampToLine 是否限制于线段内
+     * @returns {number} 距离结果
+     */
+    closestPointToPointParameter(point: Vector2, clampToLine: boolean): number;
+    /**
+     * 求点与线段的最近交点
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} clampToLine 是否限制于线段内
+     * @param {Vector2} target 目标保存对象
+     * @returns {Vector2} 最近交点
+     */
+    closestPointToPoint(point: Vector2, clampToLine: boolean, target?: Vector2): Vector2;
+    /**
+     * 二维线段判等
+     * @param {Line2} line 二维线段
+     * @returns {boolean} 判等结果
+     */
+    equals(line: Line2): boolean;
+    /**
+     * 克隆二维线段
+     * @returns {Line2} 克隆结果
+     */
+    clone(): Line2;
+    /**
+     * 二维线段求长度
+     * @returns {number} 长度
+     */
+    length(): number;
+    /**
+     * 二维线段判断相交
+     * @param {Line2} other 二维线段
+     * @returns {boolean} 相交判断结果
+     */
+    crossWithLine(other: Line2): boolean;
+}
+
+declare class Vector2 extends math.Vector2 {
+    subtract(other: Vector2): this;
+    toViewCoordinate(width: number, height: number): this;
+    clone(): Vector2;
+    distanceTo(other: Vector2): number;
+    scaleByCenter(scalar: Vector2, anchor?: Vector2): this;
+    round(precision?: number): this;
+    /**
+     * 点到直线的最短距离
+     * @returns {{d: number, t: number}} d表示距离，t表示最近点在直线的比例
+     */
+    distanceToLine(line: Line2): {
+        d: number;
+        t: number;
+    };
+    /**
+     * 二维向量与x轴夹角
+     * @returns {number} 弧度值
+     */
+    angle(): number;
+    /**
+     * 二维点绕点旋转
+     * @param {Vec2} center 旋转中心
+     * @param {number} angle 旋转角度
+     * @returns {Vec2} 旋转结果
+     */
+    rotateAround(center: Vector2, angle: number): this;
+}
+
+/**
+ * @class 二维包围盒
+ */
+declare class Box2 {
+    /**
+     * @member {Vector2[]} corners 二维包围盒角点
+     */
+    corners: Vector2[];
+    min: Vector2;
+    max: Vector2;
+    /**
+     * 构造函数，传入值为空时表示空包围盒
+     * @param {Vector2} [min=new Vector2(Infinity, Infinity)] 最小点
+     * @param {Vector2} [max=new Vector2(-Infinity, -Infinity)] 最大点
+     */
+    constructor(min?: Vector2, max?: Vector2);
+    /**
+     * 通过最大最小点设置二维包围盒
+     * @param {Vector2} min 最小点
+     * @param {Vector2} max 最大点
+     * @returns {Box2} 二维包围盒
+     */
+    set(min: Vector2, max: Vector2): this;
+    /**
+     * 通过角点设置二维包围盒
+     * @param {Vector2[]} vecArray 二维空间点数组
+     * @returns {Box2} 二维包围盒
+     */
+    setFromVec2Array(vecArray: Vector2[]): this;
+    /**
+     * 通过屏幕坐标点设置二维包围盒 - 点为屏幕坐标点，x正方向为右，y正方向为向上
+     * @param vecArray 屏幕坐标点
+     */
+    setFromVec2ArrayWithOutCorners(vecArray: Vector2[]): this;
+    /**
+     * 通过中心与大小设置二维包围盒
+     * @param {Vector2} center 二维中心点
+     * @param {Vector2} size 二维大小
+     * @returns {Box2} 二维包围盒
+     */
+    setFromCenterAndSize(center: Vector2, size: Vector2): this;
+    /**
+     * 克隆二维包围盒
+     * @returns {Box2} 克隆结果
+     */
+    clone(): Box2;
+    /**
+     * 复制二维包围盒
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 复制结果
+     */
+    copyFrom(box: Box2): this;
+    /**
+     * 二维包围盒置空
+     * @returns {Box2} 置空结果
+     */
+    makeEmpty(): this;
+    /**
+     * 二维包围盒判空
+     * @returns {boolean} 判空结果
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取二维包围盒角点
+     * @returns {Vector2[]} 二维包围盒角点
+     */
+    getCorners(): Vector2[];
+    /**
+     * 获取二维包围盒中心点
+     * @param {Vector2} [target=new Vector2()] 目标点(用以存放二维包围盒中心点)
+     * @returns {Vector2} 二维包围盒中心点
+     */
+    getCenter(target?: Vector2): Vector2;
+    /**
+     * 获取二维包围盒大小
+     * @param {Vector2} [target=new Vector2()] 目标向量(用以存放二维包围盒大小)
+     * @returns {Vector2} 二维包围盒大小
+     */
+    getSize(target?: Vector2): Vector2;
+    /**
+     * 通过二维空间点扩展二维包围盒
+     * @param {Vector2} point 二维空间点
+     * @returns {Box2} 扩展包围盒
+     */
+    expandByPoint(point: Vector2): this;
+    /**
+     * 通过向量扩展二维包围盒
+     * @param {Vector2} vector 二维向量
+     * @returns {Box2} 扩展结果
+     */
+    expandByVector(vector: Vector2): this;
+    /**
+     * 通过大小扩展二维包围盒
+     * @param {number} scalar 扩展大小
+     * @returns {Box2} 扩展结果
+     */
+    expandByScalar(scalar: number): this;
+    /**
+     * 判断二维包围盒是否包含二维空间点
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} [isOrthogonal=true] 包围盒正交判断(默认为true)
+     * @returns {boolean} 点包含判断结果
+     */
+    containsPoint(point: Vector2, isOrthogonal?: boolean): boolean;
+    /**
+     * 判断二维包围盒包含关系(if this contains other)
+     * @param {Box2} box 其它包围盒
+     * @returns {boolean} 二维包围盒包含判断结果
+     */
+    containsBox(box: Box2): boolean;
+    /**
+     * 获取点以包围盒左上角顶点为原点的相对位置
+     * @param {Vector2} point 指定二维空间点
+     * @param {Vector2} [target=new Vector2()] 目标空间点
+     * @returns {Vector2} 计算结果空间点
+     */
+    getParameter(point: Vector2, target?: Vector2): Vector2;
+    /**
+     * 求点与二维包围盒的最近点
+     * @param {Vector2} point 二维空间点
+     * @param {Vector2} [target=new Vector2()] 结果点
+     * @returns {Vector2} 二维空间点
+     */
+    clampPoint(point: Vector2, target?: Vector2): Vector2;
+    /**
+     * 求点到二维包围盒的距离
+     * @param {Vector2} point 二维空间点
+     * @returns {number} 距离
+     */
+    distanceToPoint(point: Vector2): number;
+    /**
+     * 二维包围盒求交集
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 求交结果
+     */
+    intersect(box: Box2): this;
+    /**
+     * 二维包围盒求并集
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 求并结果
+     */
+    union(target: Box2 | Vector2): this;
+    /**
+     * 二维包围盒位移
+     * @param {Vector2} offset 位移向量
+     * @returns {Box2} 位移结果
+     */
+    translate(offset: Vector2): this;
+    scale(scalar: number | Vector2, anchor?: Vector2): this;
+    /**
+     * 二维包围盒判等
+     * @param {Box2} box 二维包围盒
+     * @returns {boolean} 判等结果
+     */
+    equals(box: Box2): boolean;
+    /**
+     * 判断二维包围盒相交关系(if this intersect other)
+     * @param {Box2} box 二维包围盒
+     * @param {boolean} [isOrthogonal=true] 正交判断(当前包围盒)
+     * @returns {boolean} 相交判断结果
+     */
+    intersectsBox(box: Box2, isOrthogonal?: boolean): boolean;
+    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;
+}
+
+declare const MEDIA_TYPE: {
+    readonly APNG: "APNG";
+    readonly MP4: "MP4";
+    readonly WebM: "WebM";
+    readonly Images: "Images";
+    readonly WebP: "WebP";
+    readonly GIF: "GIF";
+    readonly AlphaMaskVideo: "AlphaMaskVideo";
+};
+/**
+ * GIF 压缩参数
+ * 核心通过参数 flags + palettegen + paletteuse 实现
+ * highest: lanczos + max_colors=256 + dither=bayer
+ * high: bicubic + max_colors=200 + dither=bayer
+ * medium: bilinear + max_colors=64 + dither=bayer
+ * low: neighbor + max_colors=32 + dither=none
+ */
+declare const GIF_QUALITY_TO_FFMPEG_ARGS: {
+    highest: string;
+    high: string;
+    medium: string;
+    low: string;
+};
 
 declare global {
     interface Window {
@@ -54,47 +397,1145 @@ declare global {
         createWebPCore: (config: any) => Promise<Img2WebPCore>;
     }
 }
-type FS = {
-    writeFile: (path: string, data: Uint8Array | string) => void;
-    readFile(path: string, opts: {
-        encoding: 'binary';
-        flags?: string | undefined;
-    }): Uint8Array;
-    readFile(path: string, opts: {
-        encoding: 'utf8';
-        flags?: string | undefined;
-    }): string;
-    readFile(path: string, opts?: {
-        flags?: string | undefined;
-    }): Uint8Array;
-    unlink: (path: string) => void;
-    quit: () => void;
-};
-type Pointer = number;
-type Img2WebPCore = {
-    FS: FS;
-    run: (...args: string[]) => number;
-    cwrap: (ident: string, returnType: string, argTypes: string[]) => ((argc: number, argv: Pointer) => number);
-    _malloc: (size: number) => Pointer;
-    writeAsciiToMemory: (str: string, buffer: number, dontAddNull?: boolean) => void;
-    setValue: (ptr: number, value: any, type: string, noSafe?: boolean) => void;
-};
+type FileBuffer = ArrayBuffer | Uint8Array;
+type MediaType = typeof MEDIA_TYPE[keyof typeof MEDIA_TYPE];
+type FS = {
+    writeFile: (path: string, data: Uint8Array | string) => void;
+    readFile(path: string, opts: {
+        encoding: 'binary';
+        flags?: string | undefined;
+    }): Uint8Array;
+    readFile(path: string, opts: {
+        encoding: 'utf8';
+        flags?: string | undefined;
+    }): string;
+    readFile(path: string, opts?: {
+        flags?: string | undefined;
+    }): Uint8Array;
+    unlink: (path: string) => void;
+    quit: () => void;
+};
+type Pointer = number;
+type Img2WebPCore = {
+    FS: FS;
+    run: (...args: string[]) => number;
+    cwrap: (ident: string, returnType: string, argTypes: string[]) => ((argc: number, argv: Pointer) => number);
+    _malloc: (size: number) => Pointer;
+    writeAsciiToMemory: (str: string, buffer: number, dontAddNull?: boolean) => void;
+    setValue: (ptr: number, value: any, type: string, noSafe?: boolean) => void;
+};
+type ExportMediaInitOptions = {
+    /**
+     * 导出类型
+     */
+    mediaType: MediaType;
+    /**
+     * 额外画布，导出透明视频时使用
+     */
+    extraCanvas?: HTMLCanvasElement | null;
+    /**
+     * 是否打印转码过程中的日志，仅在导出 MP4/AlphaMaskVideo 时有效， 默认 false
+     * 供开发调试使用
+     */
+    loggerInTranscoding?: boolean;
+    /**
+     * ffmpeg 转码是否开启多线程，默认 false，确保环境支持 SharedArrayBuffer
+     */
+    multiThreading?: boolean;
+    /**
+     * 是否输出 buffer，默认 false
+     */
+    isOutputBuffer?: boolean;
+};
+type MP4Config = {
+    /**
+     * @description MP4 导出时是否需要导出最后一帧 PNG
+     */
+    isExportLastFramePNG?: boolean;
+};
+type GifConfig = {
+    /**
+     * @description GIF 导出时的帧率
+     */
+    fps?: number;
+    /**
+     * @description GIF 导出时的缩放比例
+     * 默认 '-1:-1'， 表示不缩放
+     * 例如 '100:-1'， 表示宽度 100，高度自动
+     * 例如 '-1:100'， 表示宽度自动，高度 100
+     */
+    scale?: string;
+    /**
+     * @description GIF 导出时的质量
+     * 默认 'highest'
+     * 可选 'highest', 'high', 'medium', 'low'
+     */
+    quality?: keyof typeof GIF_QUALITY_TO_FFMPEG_ARGS;
+};
+type ApngConfig = {
+    /**
+     * @description APNG 导出时的帧率
+     */
+    fps?: number;
+    /**
+     * @description APNG 导出时的缩放比例
+     * 默认 '-1:-1'， 表示不缩放
+     * 例如 '100:-1'， 表示宽度 100，高度自动
+     * 例如 '-1:100'， 表示宽度自动，高度 100
+     */
+    scale?: string;
+    /**
+     * @description APNG 导出时的质量
+     * 默认 'highest'
+     * 可选 'highest', 'high', 'medium', 'low'
+     */
+    quality?: keyof typeof GIF_QUALITY_TO_FFMPEG_ARGS;
+};
+type ExportMediaItemOptions = {
+    /**
+     * 尺寸
+     */
+    size: [number, number];
+    /**
+     * 动效资源
+     */
+    scene: spec.JSONScene;
+    /**
+     * 视频时长，目前仅在导出 MP4 / AlphaMaskVideo 时有效，默认取动效资源时长
+     */
+    time?: number;
+    /**
+     * 是否生成音轨，默认 false，仅在导出 MP4 时有效
+     */
+    audioEnable?: boolean;
+    /**
+     * 帧率， 默认 30
+     */
+    fps?: number;
+    /**
+     * 是否循环，默认 true
+     */
+    loop?: boolean;
+    /**
+     * 视频背景颜色，默认 #000000
+     */
+    backgroundColor?: string;
+    /**
+     * 导出 MP4 时，设置的导出配置
+     */
+    mp4Config?: MP4Config;
+    /**
+     * 导出 GIF 时，设置的导出配置
+     */
+    gifConfig?: GifConfig;
+    /**
+     * 导出 APNG 时，设置的导出配置
+     */
+    apngConfig?: ApngConfig;
+};
+
+type SDKMode = 'editor' | 'template';
+/**
+ * @description SDK功能配置
+ */
+type SDKConfig = {
+    /**
+     * @description SDK编辑模式 - 模板编辑模式 | 编辑器模式
+     */
+    mode: SDKMode;
+    /**
+     * @description 页面功能配置
+     */
+    pageConfig: PageConfig$1;
+    /**
+     * @description 截图功能配置
+     */
+    screenShotConfig: ScreenShotConfig;
+    /**
+     * @description 导出视频功能配置
+     */
+    exportConfig: ExportConfig;
+    /**
+     * @description 尺寸自适应功能开关
+     */
+    sizeAdaptConfig: SizeAdaptConfig;
+    /**
+     * @description 辅助面板功能配置
+     */
+    gestureHandlerConfig: {
+        enabled: boolean;
+        adsorptionGizmoEnabled: boolean;
+        adsorptionGizmoConfig: AdsorptionGizmoConfig;
+        controlGizmoEnabled: boolean;
+        controlGizmoConfig: ControlGizmoConfig;
+        preferenceGizmoEnabled: boolean;
+        preferenceGizmoConfig: PreferenceGizmoConfig;
+        selectorGizmoEnabled: boolean;
+        selectorGizmoConfig: SelectorGizmoConfig;
+        transformGizmoEnabled: boolean;
+        transformGizmoConfig: TransformGizmoConfig;
+        pictureCutGizmoEnabled: boolean;
+        pictureCutGizmoConfig: PictureCutGizmoConfig;
+        pictureExpandGizmoEnabled: boolean;
+        pictureExpandGizmoConfig: PictureExpandGizmoConfig;
+        textGizmoEnbaled: boolean;
+        textGizmoConfig: TextGizmoConfig;
+        maskGizmoEnabled: boolean;
+        maskGizmoConfig: MaskGizmoConfig;
+        spriteTextEditGizmoEnabled: boolean;
+        spriteTextEditGizmoConfig: SpriteTextEditGizmoConfig;
+    };
+};
+/**
+ * @description 页面功能配置
+ */
+type PageConfig$1 = {
+    /**
+     * @description 同步修改功能开关
+     */
+    asncMode: boolean;
+    /**
+     * @description 静态预览【视图只提供播放预览功能】功能开关
+     */
+    staticPreview: boolean;
+    /**
+     * @description 静态预览视图名称
+     */
+    staticPreviewName: string;
+    /**
+     * @description 需过滤的元素名称
+     */
+    filterItemNames: string[];
+    /**
+     * @description 成组操作元素显隐
+     */
+    groupVisible: boolean;
+    /**
+     * @description 缩放最大值
+     */
+    maxZoom: number;
+    /**
+     * @description 缩放最小值
+     */
+    minZoom: number;
+};
+/**
+ * @description 视频导出功能配置
+ */
+type ExportConfig = {
+    enabled: boolean;
+} & ExportMediaInitOptions;
+/**
+ * @description 截图功能配置
+ */
+type ScreenShotConfig = {
+    enabled: boolean;
+};
+/**
+ * @description 尺寸自适应功能配置
+ */
+type SizeAdaptConfig = {
+    enabled: boolean;
+};
+/**
+ * @description 对齐吸附功能参数
+ */
+type AdsorptionGizmoConfig = {
+    /**
+   * @description 对齐吸附线宽
+   */
+    lineWidth: number;
+    /**
+     * @description 对齐线颜色
+     */
+    lineColor: number;
+    /**
+     * @description 对齐吸附距离
+     */
+    distance: number;
+};
+/**
+ * @description 视图控制功能参数
+ */
+type ControlGizmoConfig = {
+    /**
+     * @description 缩放步长
+     */
+    zoomStep: number;
+};
+/**
+ * @description 视口展示功能参数
+ */
+type PreferenceGizmoConfig = {
+    /**
+   * @description 视口窗包围盒颜色
+   */
+    boxColor: number;
+    /**
+     * @description 视口窗包围盒宽度
+     */
+    boxWidth: number;
+    /**
+     * @description 视口区域外遮罩颜色
+     */
+    markColor: number;
+    /**
+     * @description 视口区域外遮罩透明度
+     */
+    markAlpha: number;
+    /**
+     * @description 出血区预览开关
+     */
+    safeAreaEnabled: boolean;
+    /**
+     * @description 出血区颜色
+     */
+    safeAreaBoxColor: number;
+    /**
+     * @description 出血区透明度
+     */
+    safeAreaBoxAlpha: number;
+};
+/**
+ * @description 选择功能参数
+ */
+type SelectorGizmoConfig = {
+    /**
+     * @description 视频预选中时
+     */
+    videoPreSelectedPlay: boolean;
+    /**
+     * @description 预选框线宽
+     */
+    preSelectedWidth: number;
+    /**
+     * @description 预选框颜色
+     */
+    preSelectedColor: number;
+    /**
+     * @description 框选区域颜色
+     */
+    regionBoxColor: number;
+    /**
+     * @description 框选区域透明度
+     */
+    regionBoxAlpha: number;
+    /**
+     * @description 框选区域包围框颜色
+     */
+    regionWireframeColor: number;
+    /**
+     * @description 框选区域包围框透明度
+     */
+    regionWireframeAlpha: number;
+    /**
+     * @description 框选区域包围框宽度
+     */
+    regionWireframeWidth: number;
+};
+/**
+ * @description 变换功能参数
+ */
+type TransformGizmoConfig = {
+    /**
+     * @description 变换交互框颜色
+     */
+    wireframeColor: number;
+    /**
+     * @description 变换交互框透明度
+     */
+    wireframeAlpha: number;
+    /**
+     * @description 变换交互框宽度
+     */
+    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地址
+     */
+    nullLogoUrl: string;
+    /**
+     * @description 文本Logo地址
+     */
+    textLogoUrl: string;
+    /**
+     * @description 视频Logo地址
+     */
+    videoLogoUrl: string;
+    /**
+     * @description 大小文字颜色
+     */
+    sizeTextColor: number;
+    /**
+     * @description 名称文字颜色
+     */
+    nameTextColor: number;
+    /**
+     * @description 选中信息展示
+     */
+    infoShowEnabled: boolean;
+};
+/**
+ * @description 图片裁切参数
+ */
+type PictureCutGizmoConfig = {
+    /**
+     * @description 蒙版颜色
+     */
+    maskColor: number;
+    /**
+     * @description 蒙版透明度
+     */
+    maskAlpha: number;
+    /**
+     * @description 裁切包围盒线框宽度
+     */
+    cutBoxLineWidth: number;
+    /**
+     * @description 裁切包围盒线框颜色
+     */
+    cutBoxLineColor: number;
+    /**
+     * @description 裁切包围盒线框透明度
+     */
+    cutBoxLineAlpha: number;
+    /**
+     * @description 元素包围盒线框宽度
+     */
+    itemBoxLineWidth: number;
+    /**
+     * @description 元素包围盒线框颜色
+     */
+    itemBoxLineColor: number;
+    /**
+     * @description 元素包围盒线框透明度
+     */
+    itemBoxLineAlpha: number;
+    /**
+     * @description 裁切包围盒角度半径
+     */
+    cutBoxCornerRadius: number;
+    /**
+     * @description 裁切包围盒角点宽度
+     */
+    cutBoxCornerLineWidth: number;
+    /**
+     * @description 裁切包围盒角点颜色
+     */
+    cutBoxCornerLineColor: number;
+    /**
+     * @description 裁切包围盒角点透明度
+     */
+    cutBoxCornerLineAlpha: number;
+    /**
+     * @description 裁切包围盒角点填充色
+     */
+    cutBoxCornerFillColor: number;
+    /**
+     * @description 缩放判断距离
+     */
+    scaleInteractionDistance: number;
+    /**
+     * @description 单向缩放判断距离
+     */
+    directionScaleInteractionDistance: number;
+};
+/**
+ * @description 图片扩边参数
+ */
+type PictureExpandGizmoConfig = {
+    /**
+     * @description 蒙版颜色
+     */
+    maskColor: number;
+    /**
+     * @description 蒙版透明度
+     */
+    maskAlpha: number;
+    /**
+     * @description 扩边包围盒线框宽度
+     */
+    expandBoxLineWidth: number;
+    /**
+     * @description 扩边包围盒线框颜色
+     */
+    expandBoxLineColor: number;
+    /**
+     * @description 扩边包围盒线框透明度
+     */
+    expandBoxLineAlpha: number;
+    /**
+     * @description 扩边包围盒角度半径
+     */
+    expandBoxCornerRadius: number;
+    /**
+     * @description 扩边包围盒角点宽度
+     */
+    expandBoxCornerLineWidth: number;
+    /**
+     * @description 扩边包围盒角点颜色
+     */
+    expandBoxCornerLineColor: number;
+    /**
+     * @description 扩边包围盒角点透明度
+     */
+    expandBoxCornerLineAlpha: number;
+    /**
+     * @description 扩边包围盒角点填充色
+     */
+    expandBoxCornerFillColor: number;
+    /**
+     * @description 缩放判断距离
+     */
+    scaleInteractionDistance: number;
+    /**
+     * @description 单向缩放判断距离
+     */
+    directionScaleInteractionDistance: number;
+};
+/**
+ * @description 文本交互控制器旋转交互模式
+ * 'corner': 角点旋转
+ * 'top-center': 顶部中心旋转
+ */
+type TextGizmoRotateInteractMode = 'corner' | 'top-center';
+/**
+ * @description 文本交互控制器参数
+ */
+type TextGizmoConfig = {
+    /**
+     * @description 旋转交互模式
+     */
+    rotateInteractMode: TextGizmoRotateInteractMode;
+    /**
+     * @description 包围盒线宽
+     */
+    boxLineWidth: number;
+    /**
+     * @description 包围盒线色
+     */
+    boxLineColor: number;
+    /**
+     * @description 旋转交互点边长 - 用于 top-center 交互模式
+     */
+    rotationCornerWidth: number;
+    /**
+     * @description 旋转交互贴图地址
+     */
+    rotationCornerTexture: string;
+    /**
+     * @description 旋转交互点半径
+     */
+    rotationCornerRadius: number;
+    /**
+     * @description top-center 模式旋转交互距离
+     */
+    rotationTopCenterInteractionDistance: number;
+    /**
+     * @description 旋转交互点填充色
+     */
+    rotationCornerFillColor: number;
+    /**
+     * @description 旋转交互点描边宽度
+     */
+    rotationCornerStrokeWidth: number;
+    /**
+     * @description 旋转交互点描边颜色
+     */
+    rotationCornerStrokeColor: number;
+    /**
+     * @description Corner 模式旋转交互距离
+     */
+    rotationCornerInteractionDistance: number;
+    /**
+     * @description 缩放交互点半径
+     */
+    scaleCornerRadius: number;
+    /**
+     * @description 缩放交互点填充色
+     */
+    scaleCornerFillColor: number;
+    /**
+     * @description 缩放交互点描边宽度
+     */
+    scaleCornerStrokeWidth: number;
+    /**
+     * @description 缩放交互点描边颜色
+     */
+    scaleCornerStrokeColor: number;
+    /**
+     * @description 出发缩放交互的距离
+     */
+    scaleInteractionDistance: number;
+};
+/**
+ * @description 蒙版参数
+ */
+type MaskGizmoConfig = {
+    /**
+     * @description 画笔大小
+     */
+    brushSize: number;
+    /**
+     * @description 笔刷颜色
+     */
+    brushColor: number;
+    /**
+     * @description 笔刷透明度
+     */
+    brushAlpha: number;
+    /**
+     * @description 蒙版颜色
+     */
+    maskColor: number;
+    /**
+     * @description 蒙版透明度
+     */
+    maskAlpha: number;
+    /**
+     * @description 元素包围盒线框宽度
+     */
+    boxLineWidth: number;
+    /**
+     * @description 元素包围盒线框颜色
+     */
+    boxLineColor: number;
+    /**
+     * @description 元素包围盒线框透明度
+     */
+    boxLineAlpha: number;
+};
+/**
+ * @description 精准改字编辑参数
+ */
+type SpriteTextEditGizmoConfig = {
+    /**
+     * @description 文案颜色
+     */
+    textColor: number;
+    /**
+     * @description 包围盒线框宽度
+     */
+    boxLineWidth: number;
+    /**
+     * @description 包围盒间隔线长度
+     */
+    dashLineDash: number;
+    /**
+     * @description 包围盒间隔线间隔
+     */
+    dashLineGap: number;
+    /**
+     * @description 预选中文案颜色
+     */
+    preSelectedTextColor: number;
+    /**
+     * @description 标记包围盒颜色
+     */
+    editBoxColor: number;
+    /**
+     * @description 编辑包围盒透明度
+     */
+    editBoxAlpha: number;
+    /**
+     * @description 编辑包围盒线框颜色
+     */
+    editBoxLineColor: number;
+    /**
+     * @description 编辑包围盒线框透明度
+     */
+    editBoxLineAlpha: number;
+    /**
+     * @description 已更改编辑包围盒颜色
+     */
+    hasChangedEditBoxColor: number;
+    /**
+     * @description 已更改编辑包围盒透明度
+     */
+    hasChangedEditBoxAlpha: number;
+    /**
+     * @description 已更改编辑包围盒线框颜色
+     */
+    hasChangedEditBoxLineColor: number;
+    /**
+     * @description 已更改编辑包围盒线框透明度
+     */
+    hasChangedEditBoxLineAlpha: number;
+    /**
+     * @description 编辑包围盒预选颜色
+     */
+    editBoxPreSelectedColor: number;
+    /**
+     * @description 编辑包围盒预选透明度
+     */
+    editBoxPreSelectedAlpha: number;
+    /**
+     * @description 编辑包围盒预选线框颜色
+     */
+    editBoxLinePreSelectedColor: number;
+    /**
+     * @description 编辑包围盒预选线框透明度
+     */
+    editBoxLinePreSelectedAlpha: number;
+    /**
+     * @description 已更改编辑包围盒预选颜色
+     */
+    hasChangedEditBoxPreSelectedColor: number;
+    /**
+     * @description 已更改编辑包围盒预选透明度
+     */
+    hasChangedEditBoxPreSelectedAlpha: number;
+    /**
+   * @description 已更改编辑包围盒线框颜色
+   */
+    hasChangedEditBoxLinePreSelectedColor: number;
+    /**
+     * @description 已更改编辑包围盒线框透明度
+     */
+    hasChangedEditBoxLinePreSelectedAlpha: number;
+    /**
+     * @description 选中状态标记包围盒颜色
+     */
+    editBoxSelectedColor: number;
+    /**
+     * @description 选中状态标记包围盒颜色
+     */
+    editBoxSelectedAlpha: number;
+};
+
+/**
+ * @description 精准改字功能初始化信息
+ */
+type SpriteTextInitParam = {
+    /**
+     * @description 元素ID
+     */
+    id: string;
+    /**
+     * @description 改字信息
+     */
+    info: SpriteTextInitInfo[];
+};
+type SpriteTextInitInfo = {
+    /**
+     * @description 是否被修改过
+     */
+    hasChanged: boolean;
+    /**
+     * @description 文字内容
+     */
+    text: string;
+    /**
+     * @description 包围盒信息
+     */
+    box: [spec.vec2, spec.vec2, spec.vec2, spec.vec2];
+};
+type GizmoType = 'null' | 'selector' | 'transform' | 'control' | 'adsorption' | 'preference' | 'picture-cut' | 'text' | 'mask' | 'loading' | 'picture-expand' | 'sprite-text-edit';
+
+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: ExportMediaItemOptions | undefined, success: boolean, buffer?: FileBuffer];
+    'exportComplete': [success: boolean, taskInfos: ExportMediaItemOptions[], buffers?: FileBuffer[]];
+    '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];
+};
+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">(eventName: E, listener: _galacean_effects.EventEmitterListener<SDKEvents[E]>, options?: _galacean_effects.EventEmitterOptions) => () => void;
+    setSDKMode(mode: SDKMode): void;
+    private getInitParam;
+    /**
+     * 检测导出是否需要重新初始化
+     * @param preExportVideoConfig
+     * @param curExportVideoConfig
+     */
+    private checkExporter;
+    private initExporter;
+    private initSDK;
+    run(param: SDKInputParam): Promise<void>;
+    getPageData(): PageData;
+    getActiveItems(): string[];
+    setPreSelectedItem(id: string): void;
+    getPreSelectedItem(): string;
+    setSelectedItems(itemIds: string[]): void;
+    /**
+     * @description 获取目标元素的所有属性
+     * @param param 元素ID、类型
+     * @returns 元素属性
+     */
+    getItemProperty<T extends keyof PageFormTypeAndPropertyReference>(param: GetItemPropertyParam<T>): GetItemPropertyResult<T> | undefined;
+    /**
+     * @description 获取目标元素的指定属性
+     * @param param 元素ID、类型、属性名
+     * @returns 元素属性值
+     */
+    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>;
+    /**
+     * @description 切换场景
+     * @param index 场景索引
+     */
+    switchScene(index: number): Promise<void>;
+    /**
+     * @description 获取页面的 safeAreaPreview、zoom、adsorption、translation 值
+     * @returns 页面的 safeAreaPreview、zoom、adsorption、translation 值
+     */
+    getPageConfig(): PageConfig;
+    /**
+     * 设置页面的 safeAreaPreview、zoom、adsorption 值
+     * @param pageProperty 设置
+     */
+    setPageConfig(pageConfig: PageConfig): void;
+    /**
+     * @description 设置播放进度
+     * @param progress 播放进度 0-100
+     */
+    setPlayProgress(progress: number): Promise<void>;
+    getViewItems(): ViewItem[];
+    setPlayState(playState: 'play' | 'pause'): Promise<void>;
+    /**
+     * @description 获取场景预览图
+     * @returns 视图预览图
+     */
+    getViewThumbnail(): Promise<{
+        id: number;
+        thumbnail: string | undefined;
+    }>[];
+    /**
+     * @description 获取视图JSON产物
+     * @returns 当前所有视图JSON产物
+     */
+    getViewScene(): {
+        id: number;
+        thumbnail: spec.JSONScene;
+    }[];
+    private destroyCompositions;
+    /**
+     * @description 导出，支持导出媒体或其他，如MP4，未来支持 JSON 等；
+     */
+    onExport(): void;
+    /**
+     * @description 取消导出
+     */
+    cancelExport(): void;
+    loadPageData(data: PageData): Promise<void>;
+    runByPageData(data: PageData): Promise<void>;
+    reloadPageDataByScene(scene: string | spec.JSONScene): Promise<void>;
+    addViewParams(viewParams: ViewParam[]): Promise<void>;
+    deleteViewParams(ids: number[]): Promise<void>;
+    setExportParam(exportParam: Partial<ExportParam>, id?: number): void;
+    /**
+     * @description 设置视图缩放
+     * @param zoom 缩放值
+     * @param center 缩放中心
+     * @param ignoreClamp 是否忽视约束
+     */
+    setPageZoom(zoom: number, center?: Vector2, ignoreClamp?: boolean): void;
+    /**
+     * @description 设置元素移动
+     * @param targetTranslation 目标移动值
+     */
+    setPageMove(targetTranslation: Vector2): void;
+    /**
+     * @description 设置静态预览功能开关
+     * @param enabled 功能开关
+     */
+    setStaticPreviewEnabled(enabled: boolean): void;
+    /**
+     * @description 设置静态预览视图名称
+     * @param name 视图名称
+     */
+    setStaticPreviewName(name: string): void;
+    /**
+     * @description 设置同步修改功能开关
+     * @param enabled 功能开关
+     */
+    setAsyncEnabled(enabled: boolean): void;
+    /**
+     * @description 设置 成组显影 开关
+     */
+    setGroupVisibleEnabled(enabled: boolean): void;
+    /**
+     * @description 新增过滤元素名称
+     * @param itemNames 过滤元素名称
+     */
+    addFilterItemNames(itemNames: string[] | string): void;
+    /**
+     * @description 设置预览辅助层颜色
+     * @param color 色值
+     */
+    setPreferenceBackgroundColor(color: [number, number, number, number]): void;
+    /**
+     * @description 设置出血区颜色
+     * @param color 色值
+     */
+    setSafeAreaColor(color: [number, number, number, number]): void;
+    /**
+     * @description 设置 尺寸自适应拓展 功能开关
+     * @param enabled 功能开关
+     */
+    setSizeAdaptEnabled(enabled: boolean): void;
+    /**
+     * @description 设置 截图 功能开关
+     * @param enabled 功能开关
+     */
+    setScreenShotEnabled(enabled: boolean): void;
+    /**
+     * @description 设置导出功能初始化配置
+     * @param exportConfig
+     */
+    setExportConfig(exportConfig: Partial<ExportConfig>): void;
+    /**
+     * @description 设置预选框参数
+     * @param preSelectedColor 预选框颜色
+     * @param preSelectedWidth 预选框线框宽度
+     */
+    setSelectorGizmoPreSelectConfig(preSelectedColor?: number, preSelectedWidth?: number): void;
+    /**
+     * @description 设置 变换控制器 交互框参数
+     * @param config 参数
+     */
+    setTranformGizmoWireframeConfig(config: {
+        wireframeColor?: number;
+        wireframeAlpha?: number;
+        wireframeWidth?: number;
+    }): void;
+    /**
+     * @description 获取 SDK 配置参数
+     * @returns SDK 配置参数
+     */
+    getSDKConfig(): SDKConfig;
+    /**
+     * @description 设置 SDK 配置参数
+     * @param config SDK 配置参数
+     */
+    setSDKConfig(config: SDKConfig): void;
+    /**
+     * @description 设置SDK背景
+     * @param type 背景类型
+     * @param value 值
+     */
+    setSDKBackground(type: SDKBackgroundType, value?: string): void;
+    /**
+     * @description 创建图层元素
+     * @param spriteInfo 图层元素信息
+     */
+    addSpriteItem(spriteInfo: SpriteCreateInfo, scene?: spec.JSONScene): Promise<string | undefined>;
+    addVideoItem(videoInfo: VideoCreateInfo, scene?: spec.JSONScene): Promise<string | undefined>;
+    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;
+    /**
+     * @description 元素打组
+     * @param children 子元素ID
+     */
+    groupItems(nullInfo: NullCreateInfo, scene?: spec.JSONScene): string | undefined;
+    addTextItem(textInfo: TextCreateInfo, scene?: spec.JSONScene): Promise<string | undefined>;
+    deleteItems(idInfo: string | string[]): void;
+    getItemCreateInfo(idInfo: string | string[]): ItemCreateInfo[];
+    createScreenShotSceneByIds(idInfo: string | string[], time?: number): Promise<string | undefined>;
+    getChildrenIds(id: string): string[];
+    /**
+     * @description 更新元素在图层中的顺序
+     * @param id 元素ID
+     * @param action 排序操作：BringToFront（置于顶层）、SendToBack（置于底层）、BringForward（上移一层）、SendBackward（下移一层）
+     */
+    updateItemOrder(id: string, action: ItemOrderAction): void;
+    /**
+     * @description 导出JSON
+     * @param idInfo 视图序号信息
+     * @returns JSON数组
+     */
+    exportJSON(idInfo?: number | number[]): spec.JSONScene[];
+    getViewBoxById(id: string): Box2;
+    getViewItemById(id: string): ViewItem | undefined;
+    getViewProperty(id: number): ViewProperty | undefined;
+    pageMove(shift: [number, number]): void;
+    pageZoom(shift: number, center?: [number, number]): void;
+    /**
+     * @description 设置视图缩放工具锁定缩放比例开关
+     * @param state 缩放比例开关
+     */
+    setPictureCutGizmoLockScale(state: boolean): void;
+    /**
+     * @description 设置视图扩展工具锁定缩放比例开关
+     * @param state 缩放比例开关
+     */
+    setPictureExpandGizmoLockScale(state: boolean): void;
+    /**
+     * @description 视图缩放函数
+     * @param shiftParam 视图偏移值
+     */
+    viewportFit(shiftParam?: ViewportFitShiftParam, box?: Box2): void;
+    /**
+     * @description 获取元素包围盒
+     * @param idInfo 元素Id
+     * @returns 元素包围盒
+     */
+    getItemBoxById(idInfo: string): Box2;
+    /**
+     * @description 设置元素字体
+     * @param id 元素Id
+     * @param fontFamilyName 字体名称
+     * @param url 字体地址
+     */
+    setItemFontFamily(id: string, fontFamilyName: string, url: string): Promise<void>;
+    createSceneByCreateInfos(createInfos: ItemCreateInfo[], sceneInfo: SceneCreaetInfo): spec.JSONScene;
+    changeItemPropertyByCreateInfo(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;
+}
+
+type SizeAdaptDirection = 'x' | 'y';
 
 type BaseFormProperty = {
-    position: [number, number, number];
+    position: [number, number];
     rotation: [number, number, number];
-    scale: [number, number, number];
+    size: [number, number];
+    visible: boolean;
     keyPropertyEditing: boolean;
 };
 type SpriteFormProperty = BaseFormProperty & {
     image: string;
 };
 type TextFormProperty = BaseFormProperty & {
-    font: string;
-    color: [number, number, number, number];
-    weight: spec.TextWeight;
+    fontFamily: string;
+    textColor: [number, number, number, number];
+    fontWeight: spec.TextWeight;
     text: string;
-    alignment: spec.TextAlignment;
+    textAlign: spec.TextAlignment;
+    fontSize: number;
+    fontStyle: spec.FontStyle;
+    textWidth: number;
+    lineHeight: number;
+    outlineColor?: spec.vec4;
+    outlineWidth?: number;
+    /**
+     * @description 描边开关
+     */
+    outlineEnabled?: boolean;
+};
+type VideoFormProperty = BaseFormProperty & {
+    video: string;
 };
 /**
  * @description 页面表单类型和属性引用
@@ -118,7 +1559,7 @@ type PageFormTypeAndPropertyReference = {
     [spec.ItemType.shape]: BaseFormProperty;
     [spec.ItemType.postProcessVolume]: BaseFormProperty;
     [spec.ItemType.node]: BaseFormProperty;
-    [spec.ItemType.video]: BaseFormProperty;
+    [spec.ItemType.video]: VideoFormProperty;
     [spec.ItemType.audio]: BaseFormProperty;
     [spec.ItemType.richtext]: TextFormProperty;
 };
@@ -127,30 +1568,37 @@ type SpecificPageFormProps<T extends keyof PageFormTypeAndPropertyReference> = {
     property: PageFormTypeAndPropertyReference[T];
     onPropertyValueChange: <N extends keyof PageFormTypeAndPropertyReference[T]>(propertyName: N, propertyValue: PageFormTypeAndPropertyReference[T][N]) => void;
 };
+type SDKOptions = {
+    /** 导出视频时，是否开启转码日志 */
+    loggerInExportVideoTranscoding?: boolean;
+};
+type SDKInputParam = SDKTemplateInputParam | SDKEditorInputParam;
 /**
  * @description SDK入参
  */
-type SDKInputParam = {
+type SDKTemplateInputParam = {
     /**
      * @description JSON地址
      */
     scene: string | spec.JSONScene;
+    /**
+     * @description SDK模式 - 模板编辑模式
+     */
+    mode: 'template';
     /**
      * @description 视图参数
      */
-    viewParams: ViewParam[];
+    viewParams?: ViewParam[];
     /**
      * @description 页面属性
      */
     options: PageOptions;
+};
+type SDKEditorInputParam = {
     /**
-     * @description 是否开启出血区强制变换
-     */
-    keepSafe?: boolean;
-    /**
-     * @description 是否开启静态预览功能 - 第一个合成仅支持播放，不可编辑
+     * @description SDK模式 - 编辑器模式
      */
-    staticPreview?: boolean;
+    mode: 'editor';
 };
 /**
  * @description 页面属性
@@ -173,6 +1621,10 @@ type PageOptions = {
  * @description 页面数据
  */
 type PageData = {
+    /**
+     * @description 基础场景数据
+     */
+    scene: spec.JSONScene;
     /**
      * @description 页面属性
      */
@@ -218,6 +1670,10 @@ type PageConfig = {
      * @description 同步开关
      */
     asyncMode: boolean;
+    /**
+     * @description 画布移动
+     */
+    translation: spec.vec2;
 };
 /**
  * @description 页面属性
@@ -251,11 +1707,15 @@ type ViewParam = {
     /**
      * @description 页面尺寸
      */
-    size: [number, number];
+    size?: [number, number];
     /**
      * @description 出血区参数
      */
-    safeArea: [number, number, number, number];
+    safeArea?: [number, number, number, number];
+    /**
+     * @description 自适应方向 - 默认根据视图宽高决定
+     */
+    adaptionDirection?: SizeAdaptDirection;
     /**
      * @description 自定义出血区 - 用于展示
      */
@@ -269,31 +1729,11 @@ type ViewParam = {
  * @description 导出参数
  */
 type ExportParam = {
-    /**
-     * @description 导出视频时长
-     */
-    time: number;
-    /**
-     * @description 导出大小上限 - 单位kb
-     */
-    fileSizeLimit: number;
-    /**
-     * @description 是否开启音轨
-     */
-    audioEnable: boolean;
-    /**
-     * @description 视频fps - 默认 30
-     */
-    fps?: number;
-    /**
-     * @description 导出视频类型 - 预留参数
-     */
-    type?: string;
     /**
      * @description 视频名称
      */
     name?: string;
-};
+} & Omit<ExportMediaItemOptions, 'scene' | 'size'>;
 /**
  * @description 视图属性
  */
@@ -318,10 +1758,6 @@ type ViewProperty = {
      * @description 视图场景数据
      */
     scene: spec.JSONScene;
-    /**
-     * @description 预览图数据
-     */
-    thumbnail: string;
     /**
      * @description 导出参数
      */
@@ -360,6 +1796,10 @@ type ActiveData = {
      * @description 预选中元素
      */
     preSelectedItem?: string;
+    /**
+     * @description 执行中元素
+     */
+    loadingItems?: string[];
 };
 /**
  * @description 视图元素
@@ -394,113 +1834,255 @@ type ViewItem = {
      */
     endBehavior: spec.EndBehavior;
 } & ViewItemTypedProperty;
-
-declare const ExportStatusMap: {
-    readonly DEFAULT: "default";
-    readonly EXPORTING: "exporting";
-    readonly SUCCESS: "success";
-    readonly ERROR: "error";
+type SDKBackgroundType = 'color' | 'image' | 'chess-board';
+/**
+ * @description 图层创建信息
+ */
+type SpriteCreateInfo = {
+    type: 'sprite';
+    /**
+     * @description 图层名称
+     */
+    name?: string;
+    /**
+     * @description 元素id
+     */
+    id?: string;
+    /**
+     * @description 父节点id
+     */
+    parentId?: string;
+    /**
+     * @description 图片资源地址
+     */
+    url: string;
+    /**
+     * @description 图层元素像素大小
+     */
+    size: spec.vec2;
+    /**
+     * @description 图层元素缩放
+     */
+    scale?: spec.vec2;
+    /**
+     * @description 图层元素旋转
+     */
+    rotation?: number;
+    /**
+     * @description 图层元素二维位置
+     */
+    position: spec.vec2;
 };
-type ExportStatus = typeof ExportStatusMap[keyof typeof ExportStatusMap];
-type SDKEvents = {
-    '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];
-    'exportComplete': [success: boolean];
+/**
+ * @description 空节点创建信息
+ */
+type NullCreateInfo = {
+    type: 'null';
+    /**
+     * @description 元素id
+     */
+    id?: string;
+    /**
+     * @description 父节点id
+     */
+    parentId?: string;
+    /**
+     * @description 元素名称
+     */
+    name?: string;
+    /**
+     * @description 空节点缩放
+     */
+    scale?: spec.vec2;
+    /**
+     * @description 子元素id
+     */
+    children: string[];
+    /**
+     * @description 空节点旋转
+     */
+    rotation?: number;
+    /**
+     * @description 空节点位移
+     */
+    position?: spec.vec2;
 };
-declare class SDK {
-    private _eventEmitter;
-    private _pageData;
-    private _screenShotContainer;
-    private _screenShotPlayer;
-    private _SDKUtils;
-    private _ExportVideo;
-    private _gestureHandler;
-    private _playerContainer;
-    private _exportStatus;
-    private disposables;
-    player: Player;
-    constructor(container: HTMLElement);
-    get pageData(): PageData | undefined;
-    get exportStatus(): ExportStatus;
-    private get exportOptions();
-    dispose(): void;
-    on: <E extends "progress" | "selectedItemChange" | "preSelectedItemChange" | "selectedViewChange" | "pageDataChange" | "zoomChange" | "itemPropertyChange" | "exportProgress" | "exportComplete">(eventName: E, listener: _galacean_effects_weapp.EventEmitterListener<SDKEvents[E]>, options?: _galacean_effects_weapp.EventEmitterOptions) => () => void;
-    private getInitParam;
-    private initSDK;
-    run(param: SDKInputParam): Promise<void>;
-    getPageData(): PageData;
-    getActiveItems(): string[];
-    setPreSelectedItem(id: string): void;
-    getPreSelectedItem(): string;
-    setSelectedItems(itemIds: string[]): void;
+/**
+ * @description 文本创建信息
+ */
+type TextCreateInfo = {
+    type: 'text';
     /**
-     * @description 获取目标元素的所有属性
-     * @param param 元素ID、类型
-     * @returns 元素属性
+     * @description 元素id
      */
-    getItemProperty<T extends keyof PageFormTypeAndPropertyReference>(param: GetItemPropertyParam<T>): GetItemPropertyResult<T> | undefined;
+    id?: string;
     /**
-     * @description 获取目标元素的指定属性
-     * @param param 元素ID、类型、属性名
-     * @returns 元素属性值
+     * @description 父节点id
      */
-    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): Promise<string>;
+    parentId?: string;
     /**
-     * @description 切换场景
-     * @param index 场景索引
+     * @description 元素名称
      */
-    switchScene(index: number): Promise<void>;
+    name?: string;
     /**
-     * @description 获取页面的 safeAreaPreview、zoom、adsorption 值
-     * @returns 页面的 safeAreaPreview、zoom、adsorption 值
+     * @description 单行高度
      */
-    getConfig(): PageConfig;
+    lineHeight: number;
     /**
-     * 设置页面的 safeAreaPreview、zoom、adsorption 值
-     * @param pageProperty 设置
+     * @description 文本高度
      */
-    setConfig(pageConfig: PageConfig): void;
+    textHeight?: number;
     /**
-     * @description 设置播放进度
-     * @param progress 播放进度 0-100
+     * @description 宽度
      */
-    setPlayProgress(progress: number): Promise<void>;
-    getViewItems(): ViewItem[];
-    setPlayState(playState: 'play' | 'pause'): Promise<void>;
+    textWidth: number;
     /**
-     * @description 获取场景预览图
-     * @returns 视图预览图
+     * @description 字体名称
      */
-    getViewThumbnail(): {
-        id: number;
-        thumbnail: string;
-    }[];
-    private onExportProgress;
-    private onExportFinish;
-    private onExportError;
+    fontFamily: string;
     /**
-     * @description 导出视频
+     * @description 文本位置
      */
-    exportAllVideos(): void;
-    cancelExportAllVideos(): void;
-    loadPageData(data: PageData): Promise<void>;
-    runByPageData(data: PageData): Promise<void>;
+    position?: spec.vec2;
+    /**
+     * @description 文本旋转
+     */
+    rotation?: number;
+    /**
+     * @description 文字大小
+     */
+    fontSize: number;
+    /**
+     * @description 字重
+     */
+    fontWeight?: spec.TextWeight;
+    /**
+     * @description 字体格式
+     */
+    fontStyle?: spec.FontStyle;
+    /**
+     * @description 对齐方式
+     */
+    textAlign?: spec.TextAlignment;
+    /**
+     * @description 文本信息
+     */
+    text: string;
+    /**
+     * @description 填充色
+     */
+    textColor: spec.vec4;
+    /**
+     * @description 描边色
+     */
+    outlineColor?: spec.vec4;
+    /**
+     * @description 描边宽度
+     */
+    outlineWidth?: number;
+    /**
+     * @description 描边开关
+     */
+    outlineEnabled?: boolean;
+    /**
+     * @description 字体文件地址
+     */
+    url?: string;
+};
+/**
+ * @description 视频创建信息
+ */
+type VideoCreateInfo = {
+    type: 'video';
+    /**
+     * @description 视频名称
+     */
+    name?: string;
+    /**
+     * @description 元素id
+     */
+    id?: string;
+    /**
+     * @description 父节点id
+     */
+    parentId?: string;
+    /**
+     * @description 视频资源地址
+     */
+    url: string;
+    /**
+     * @description 视频元素像素大小
+     */
+    size: spec.vec2;
+    /**
+     * @description 视频元素缩放
+     */
+    scale?: spec.vec2;
+    /**
+     * @description 视频元素旋转
+     */
+    rotation?: number;
+    /**
+     * @description 视频元素二维位置
+     */
+    position: spec.vec2;
+    /**
+     * @description 是否静音
+     */
+    muted?: boolean;
+    /**
+     * @description 是否为透明视频
+     */
+    transparent?: boolean;
+    /**
+     * @description 播放速率
+     */
+    playbackRate?: number;
+    /**
+     * @description 音量
+     */
+    volume?: number;
+};
+type ItemCreateInfo = NullCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo;
+/**
+ * @description 场景创建信息
+ */
+type SceneCreaetInfo = {
+    /**
+     * @description 场景名称
+     */
+    name: string;
+    /**
+     * @description 场景大小
+     */
+    size: spec.vec2;
+};
+declare enum ItemOrderAction {
+    BringToFront = 0,
+    SendToBack = 1,
+    BringForward = 2,
+    SendBackward = 3
 }
+/**
+ * @description 视图自适应偏移参数
+ */
+type ViewportFitShiftParam = {
+    /**
+     * @description 左偏移
+     */
+    left?: number;
+    /**
+     * @description 右偏移
+     */
+    right?: number;
+    /**
+     * @description 上偏移
+     */
+    top?: number;
+    /**
+     * @description 下偏移
+     */
+    bottom?: number;
+};
 
-export { type ActiveData, type BaseFormProperty, type ExportStatus, ExportStatusMap, type PageData, type PageFormTypedProperty, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SpecificPageFormProps, type SpriteFormProperty, type TextFormProperty, type ViewItem, type ViewParam, type ViewProperty };
+export { type ActiveData, type BaseFormProperty, Box2, type CreateOperation, type DeleteOperation, type GizmoType, type ItemCreateInfo, ItemOrderAction, type NullCreateInfo, type Operation, type PageData, type PageFormTypedProperty, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKOptions, type SetItemPropertyValueParam, type SpecificPageFormProps, type SpriteCreateInfo, type SpriteFormProperty, type TextCreateInfo, type TextFormProperty, type UpdateOperation, Vector2, type VideoCreateInfo, type ViewItem, type ViewItemTypedProperty, type ViewParam, type ViewProperty };