@vvfx/sdk 0.1.19-alpha.37 → 0.1.19-alpha.38

package/dist/index.d.cts

@@ -1,4891 +0,0 @@
-import * as _galacean_effects from '@galacean/effects';
-import { math, spec, Player, EventEmitter, Composition, VFXItem, Constructor, Component } from '@galacean/effects';
-export { generateGUID, spec } from '@galacean/effects';
-import { Point } from '@pixi/constants';
-
-/**
- * @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;
-}
-
-declare class Quaternion extends math.Quaternion {
-}
-
-declare class Vector3 extends math.Vector3 {
-    clone(): Vector3;
-    /**
-     * 由空间变换矩阵保存三维分量
-     * @param {Matrix4} m 四维矩阵
-     * @param {number} index 下标
-     * @returns {Vec3} 指定三维分量
-     */
-    setFromMatrixColumn(m: Matrix4, index: number): this;
-    applyEuler(euler: Euler, _out?: Vector3): this;
-    /**
-     * 三维点根据四元数绕点的旋转
-     * @param {Quaternion} q 四元数
-     * @param {Vec3} [center=new Vec3()] 旋转中心
-     * @returns {Vec3} 旋转结果
-     */
-    applyQuaternion(q: Quaternion, center?: Vector3): this;
-    /**
-     * 由空间变换矩阵保存三维偏移值
-     * @param {Matrix4} m 四维矩阵
-     * @returns {Vec3} 偏移值
-     */
-    setFromMatrixPosition(m: Matrix4): this;
-    applyMatrix(matrix: Matrix4, center?: Vector3): this;
-}
-
-declare class Matrix4 extends math.Matrix4 {
-    /**
-     * 通过数组创建矩阵
-     * @param array - 数组
-     * @param [offset=0] - 起始偏移值
-     * @returns 矩阵
-     */
-    static fromArray(array: math.Matrix4DataType, offset?: number): Matrix4;
-    clone(): Matrix4;
-    compose(translation: Vector3, rotation: Quaternion, scale: Vector3, anchor?: math.Vector3): this;
-    /**
-     * 导出四维矩阵[三维空间变换矩阵]旋转部分
-     * @param {Matrix4} m 四维矩阵
-     * @returns {Matrix4} 导出结果
-     */
-    extractRotation(m: Matrix4): this;
-    /**
-     * 由欧拉角设置四维矩阵
-     * @param {Euler} euler 欧拉角
-     * @returns {Matrix4} 四维矩阵
-     */
-    makeRotationFromEuler(euler: Euler): this;
-    setPosition(position: Vector3): this;
-}
-
-declare class Euler extends math.Euler {
-    constructor(x?: number, y?: number, z?: number, order?: math.EulerOrder);
-    getInvertMatrixByEuler(): Matrix4;
-    /**
-     * 欧拉角保存于三维向量(应用于计算)
-     * @param {Vector3} [optionalResult] 目标保存对象
-     * @returns {Vector3} 保存结果
-     */
-    toDegreeVector3(optionalResult?: Vector3): Vector3;
-    /**
-     * 由角度三维向量构建欧拉角
-     * @param {Vector3} v 角度三维向量
-     * @param {EulerOrder} [order] 欧拉角顺序，默认为ZYX
-     * @returns {Euler} 欧拉角
-     */
-    setFromDegreeVector3(degree: Vector3, order?: math.EulerOrder): this;
-}
-
-declare class Plane {
-    distance: number;
-    normal: Vector3;
-    constructor(distance?: number, normal?: Vector3);
-    static set(distance: number, normal: Vector3): Plane;
-    set(distance: number, normal: Vector3): this;
-    static copy(target: Plane): Plane;
-    copy(target: Plane): this;
-    static setFromNormalAndCoplanarPoint(point: Vector3, normal: Vector3): Plane;
-    setFromNormalAndCoplanarPoint(point: Vector3, normal: Vector3): this;
-    clone(): Plane;
-    distanceToPoint(point: Vector3): number;
-}
-
-declare class Ray extends math.Ray {
-    origin: Vector3;
-    direction: Vector3;
-    constructor(origin?: Vector3, direction?: Vector3);
-    clone(): Ray;
-    rayCastPlane(plane: Plane, _target: Vector3): number;
-    at(t: number): Vector3;
-    /**
-     * 射线到平面的距离
-     * 当两个向量都是单位向量的时候，从a投影到b的距离等于从b投影到a的距离
-     * @param plane 平面
-     * @returns 射线到平面的距离
-     */
-    distanceToPlane(plane: Plane): number;
-}
-
-type SizeAdaptDirection = 'x' | 'y';
-
-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 {
-        /**
-         * @description 创建 WebP Core 实例
-         */
-        createWebPCore: (config: any) => Promise<Img2WebPCore>;
-    }
-}
-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
-     */
-    isExportLastFrameJPEG?: 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 ExportMediaItemDownloadInfo = {
-    /**
-     * @description 导出文件夹名称
-     */
-    folderName: string;
-    /**
-     * @description 导出视频名称
-     */
-    name: string;
-};
-type ExportItemParams = ExportMediaItemOptions & ExportMediaItemDownloadInfo;
-type ExportParams = ExportItemParams[];
-type Buffers = FileBuffer[] | undefined;
-type Extras = (FileBuffer | null)[] | null | undefined;
-
-/**
- * @description SDKItem 基础选项接口
- * @description 支持扩展属性，允许添加任意额外属性
- */
-type SDKItemOptions = {
-    /**
-     * @description 元素ID
-     */
-    id: string;
-    /**
-     * @description 元素名称
-     */
-    name: string;
-    /**
-     * @description 父节点ID
-     */
-    parentId?: string;
-    /**
-     * @description 子元素ID列表
-     */
-    children?: string[];
-    /**
-     * @description 元素生命周期
-     */
-    duration?: number;
-    /**
-     * @description 元素生命周期延时
-     */
-    delay?: number;
-    /**
-     * @description 可视状态
-     */
-    visible?: boolean;
-    /**
-     * @description 元素结束行为
-     */
-    endBehavior?: spec.EndBehavior;
-    /**
-     * @description 是否处于锁定状态
-     */
-    isLocked?: boolean;
-    /**
-     * @description 关键属性是否可编辑
-     */
-    isCoreEditable: boolean;
-    /**
-     * @description 扩展属性存储（属性名 -> 属性值）
-     */
-    extension?: Record<string, any>;
-    /**
-     * @description 允许任意额外属性（用于兼容旧代码）
-     */
-    [extraProp: string]: any;
-};
-/**
- * @description Sprite SDKItem 选项
- */
-type SpriteItemOptions = SDKItemOptions & {
-    /**
-     * @description 元素属性
-     */
-    property?: Partial<SpriteItemProperty>;
-};
-/**
- * @description Text SDKItem 选项
- */
-type TextItemOptions = SDKItemOptions & {
-    /**
-     * @description 元素属性
-     */
-    property?: Partial<TextItemProperty>;
-};
-/**
- * @description Video SDKItem 选项
- */
-type VideoItemOptions = SDKItemOptions & {
-    /**
-     * @description 元素属性
-     */
-    property?: Partial<VideoItemProperty>;
-};
-/**
- * @description Group SDKItem 选项（空节点/组）
- */
-type GroupItemOptions = SDKItemOptions & {
-    /**
-     * @description 元素属性
-     */
-    property?: Partial<GroupItemProperty>;
-};
-/**
- * @description Generator SDKItem 选项（资源生成器）
- * @description 支持 image 和 video 两种生成器类型
- * @description 使用 GeneratorItemProperty 包含 generatorType
- */
-type GeneratorItemOptions = SDKItemOptions & {
-    /**
-     * @description 元素属性（包含 generatorType）
-     */
-    property?: Partial<GeneratorItemProperty>;
-};
-type EffectsItemOptions = SDKItemOptions & {
-    property?: Partial<EffectsItemProperty>;
-};
-/**
- * @description Frame 画板元素 SDKItem 选项
- */
-type FrameItemOptions = SDKItemOptions & {
-    /**
-     * @description 元素属性
-     */
-    property?: Partial<FrameItemProperty>;
-};
-/**
- * @description SDKItem 类型（独立于 spec.ItemType）
- * @description 包含所有 SDK 层级的元素类型，包括虚拟类型如 generator
- */
-declare enum SDKItemType {
-    SPRITE = "sprite",
-    TEXT = "text",
-    VIDEO = "video",
-    GROUP = "group",
-    GENERATOR = "generator",
-    EFFECTS = "effects",
-    FRAME = "frame"
-}
-
-/**
- * @description SDKItem 抽象基类
- * @description 支持属性扩展，允许添加任意自定义属性
- */
-declare abstract class BaseItem {
-    /**
-     * @description 元素ID
-     */
-    id: string;
-    /**
-     * @description 元素名称
-     */
-    name: string;
-    /**
-     * @description 父节点ID
-     */
-    parentId?: string;
-    /**
-     * @description 元素生命周期
-     */
-    duration: number;
-    /**
-     * @description 元素生命周期延时
-     */
-    delay: number;
-    /**
-     * @description 元素结束行为
-     */
-    endBehavior: spec.EndBehavior;
-    /**
-     * @description 是否可见
-     */
-    visible: boolean;
-    /**
-     * @description 是否处于锁定状态
-     */
-    isLocked: boolean;
-    /**
-     * @description 核心数据是否支持编辑
-     */
-    isCoreEditable: boolean;
-    /**
-     * @description 扩展属性存储（与 property 同级）
-     */
-    extension: Map<string, any>;
-    /**
-     * @description 元素类型（由子类实现）
-     * @description 支持 spec.ItemType 或扩展的 SDKItemType
-     */
-    abstract readonly type: SDKItemType;
-    /**
-     * @description 元素属性（由子类实现）
-     */
-    abstract readonly property: BaseItemProperty;
-    constructor(options: SDKItemOptions);
-    get pixelWidth(): number;
-    get pixelHeight(): number;
-    /**
-     * @description 设置扩展属性
-     * @param key 属性名
-     * @param value 属性值
-     */
-    setExtension(key: string, value: any): void;
-    /**
-     * @description 获取扩展属性
-     * @param key 属性名
-     * @returns 属性值
-     */
-    getExtension(key: string): any;
-    /**
-     * @description 检查是否存在指定扩展属性
-     * @param key 属性名
-     * @returns 是否存在
-     */
-    hasExtension(key: string): boolean;
-    /**
-     * @description 删除扩展属性
-     * @param key 属性名
-     * @returns 是否删除成功
-     */
-    deleteExtension(key: string): boolean;
-    /**
-     * @description 获取所有扩展属性的键名列表
-     * @returns 键名数组
-     */
-    getExtensionKeys(): string[];
-    /**
-     * @description 获取所有扩展属性
-     * @returns 扩展属性对象
-     */
-    getAllExtension(): Record<string, any>;
-    /**
-     * @description 批量设置扩展属性
-     * @param extensions 扩展属性对象
-     */
-    setExtensions(extensions: Record<string, any>): void;
-    /**
-     * @description 清空所有扩展属性
-     */
-    clearExtension(): void;
-    /**
-     * @description 转换为 CreateInfo（用于元素复制/导出）
-     * @param withParent 是否包含父节点ID
-     * @returns CreateInfo 对象
-     */
-    abstract toCreateInfo(withParent?: boolean): ItemCreateInfo;
-    /**
-     * @description 克隆 SDKItem
-     * @returns 新的 SDKItem 实例
-     */
-    abstract clone(): BaseItem;
-    /**
-     * @description 获取基础属性的 JSON 对象,转换为普通对象（用于序列化）
-     * @returns 普通对象
-     */
-    toJSON(): Record<string, any>;
-}
-/**
- * @description 类型守卫函数：检查对象是否是 BaseItem
- * @param obj 要检查的对象
- * @returns 是否是 BaseItem 实例
- */
-declare function isBaseItem(obj: any): obj is BaseItem;
-
-/**
- * @description 图片元素 SDKItem 类
- * @description 支持属性扩展
- */
-declare class SpriteItem extends BaseItem {
-    /**
-     * @description 元素类型
-     */
-    readonly type = SDKItemType.SPRITE;
-    /**
-     * @description 元素属性
-     */
-    property: SpriteItemProperty;
-    constructor(options: SpriteItemOptions);
-    /**
-     * @description 图片地址
-     */
-    get image(): string;
-    set image(value: string);
-    /**
-     * @description 位置
-     */
-    get position(): [number, number];
-    set position(value: [number, number]);
-    get width(): number;
-    set width(value: number);
-    get height(): number;
-    set height(value: number);
-    /**
-     * @description 旋转（二维旋转角度）
-     */
-    get rotation(): number;
-    set rotation(value: number);
-    /**
-     * @description 完整旋转（包含 x, y, z）
-     */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
-    /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
-     */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
-    /**
-     * @description 转换为 CreateInfo
-     * @param withParent 是否包含父节点ID
-     */
-    toCreateInfo(withParent?: boolean): SpriteCreateInfo;
-    /**
-     * @description 克隆 SDKItem
-     */
-    clone(): SpriteItem;
-    /**
-     * @description 创建包含扩展属性的 CreateInfo
-     * @param withParent 是否包含父节点ID
-     * @param extraProps 额外的属性
-     */
-    toCreateInfoWithExtensions(withParent?: boolean, extraProps?: Record<string, any>): SpriteCreateInfo;
-}
-/**
- * @description 类型守卫：检查是否是 SpriteItem
- */
-declare function isSpriteItem(obj: any): obj is SpriteItem;
-
-/**
- * @description 文本元素 SDKItem 类
- * @description 支持属性扩展
- */
-declare class TextItem extends BaseItem {
-    /**
-     * @description 元素类型
-     */
-    readonly type = SDKItemType.TEXT;
-    /**
-     * @description 元素属性
-     */
-    property: TextItemProperty;
-    constructor(options: TextItemOptions);
-    /**
-     * @description 文本内容
-     */
-    get text(): string;
-    set text(value: string);
-    /**
-     * @description 字体名称
-     */
-    get fontFamily(): string;
-    set fontFamily(value: string);
-    /**
-     * @description 字号
-     */
-    get fontSize(): number;
-    set fontSize(value: number);
-    /**
-     * @description 字重
-     */
-    get fontWeight(): spec.TextWeight;
-    set fontWeight(value: spec.TextWeight);
-    /**
-     * @description 字体样式
-     */
-    get fontStyle(): spec.FontStyle;
-    set fontStyle(value: spec.FontStyle);
-    /**
-     * @description 文本对齐方式
-     */
-    get textAlign(): spec.TextAlignment;
-    set textAlign(value: spec.TextAlignment);
-    /**
-     * @description 文本颜色 [r, g, b, a]
-     */
-    get color(): [number, number, number, number];
-    set color(value: [number, number, number, number]);
-    /**
-     * @description 文本宽度
-     */
-    get width(): number;
-    set width(value: number);
-    /**
-     * @description 行高
-     */
-    get lineHeight(): number;
-    set lineHeight(value: number);
-    /**
-     * @description 文本高度
-     */
-    get height(): number;
-    set height(value: number);
-    /**
-     * @description 描边颜色
-     */
-    get outlineColor(): spec.vec4 | undefined;
-    set outlineColor(value: spec.vec4 | undefined);
-    /**
-     * @description 描边宽度
-     */
-    get outlineWidth(): number | undefined;
-    set outlineWidth(value: number | undefined);
-    /**
-     * @description 描边开关
-     */
-    get outlineEnabled(): boolean;
-    set outlineEnabled(value: boolean);
-    /**
-     * @description 位置
-     */
-    get position(): [number, number];
-    set position(value: [number, number]);
-    /**
-     * @description 旋转（二维旋转角度）
-     */
-    get rotation(): number;
-    set rotation(value: number);
-    /**
-     * @description 转换为 CreateInfo
-     * @param withParent 是否包含父节点ID
-     */
-    toCreateInfo(withParent?: boolean): TextCreateInfo;
-    /**
-     * @description 克隆 SDKItem
-     */
-    clone(): TextItem;
-}
-/**
- * @description 类型守卫：检查是否是 TextItem
- */
-declare function isTextItem(obj: any): obj is TextItem;
-
-/**
- * @description 视频元素 SDKItem 类
- * @description 支持属性扩展
- */
-declare class VideoItem extends BaseItem {
-    /**
-     * @description 元素类型
-     */
-    readonly type = SDKItemType.VIDEO;
-    /**
-     * @description 元素属性
-     */
-    property: VideoItemProperty;
-    constructor(options: VideoItemOptions);
-    /**
-     * @description 视频地址
-     */
-    get video(): string;
-    set video(value: string);
-    /**
-     * @description 位置
-     */
-    get position(): [number, number];
-    set position(value: [number, number]);
-    /**
-     * @description 宽度
-     */
-    get width(): number;
-    set width(value: number);
-    /**
-     * @description 高度
-     */
-    get height(): number;
-    set height(value: number);
-    /**
-     * @description 旋转（二维旋转角度）
-     */
-    get rotation(): number;
-    set rotation(value: number);
-    /**
-     * @description 完整旋转（包含 x, y, z）
-     */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
-    /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
-     */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
-    /**
-     * @description 是否静音
-     */
-    get muted(): boolean;
-    set muted(state: boolean);
-    /**
-     * @description 是否为透明视频
-     */
-    get transparent(): boolean;
-    set transparent(state: boolean);
-    /**
-     * @description 播放音量
-     */
-    get volume(): number;
-    set volume(value: number);
-    /**
-     * @description 播放速率
-     */
-    get playbackRate(): number;
-    set playbackRate(value: number);
-    /**
-     * @description 转换为 CreateInfo
-     * @param withParent 是否包含父节点ID
-     */
-    toCreateInfo(withParent?: boolean): VideoCreateInfo;
-    /**
-     * @description 克隆 SDKItem
-     */
-    clone(): VideoItem;
-}
-/**
- * @description 类型守卫：检查是否是 VideoItem
- */
-declare function isVideoItem(obj: any): obj is VideoItem;
-
-/**
- * @description 空节点/组 SDKItem 类
- * @description 支持属性扩展
- */
-declare class GroupItem extends BaseItem {
-    /**
-     * @description 元素类型
-     */
-    readonly type = SDKItemType.GROUP;
-    /**
-     * @description 元素属性
-     */
-    property: GroupItemProperty;
-    constructor(options: GroupItemOptions);
-    /**
-     * @description 位置
-     */
-    get position(): [number, number];
-    set position(value: [number, number]);
-    /**
-     * @description 大小
-     */
-    get scale(): [number, number];
-    set scale(value: [number, number]);
-    /**
-     * @description 旋转（二维旋转角度）
-     */
-    get rotation(): number;
-    set rotation(value: number);
-    /**
-     * @description 完整旋转（包含 x, y, z）
-     */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
-    /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
-     */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
-    /**
-     * @description 转换为 CreateInfo
-     * @param withParent 是否包含父节点ID
-     */
-    toCreateInfo(withParent?: boolean): GroupCreateInfo;
-    /**
-     * @description 克隆 SDKItem
-     */
-    clone(): GroupItem;
-}
-/**
- * @description 类型守卫：检查是否是 GroupItem
- */
-declare function isGroupItem(obj: any): obj is GroupItem;
-
-/**
- * @description 资源生成器元素 SDKItem 类
- * @description 支持 image 和 video 两种生成器类型
- * @description 在 Player 中以透明 SpriteItem 形式渲染
- * @description 支持属性扩展，可转换为 SpriteItem 或 VideoItem
- */
-declare class GeneratorItem extends BaseItem {
-    /**
-     * @description 元素类型（独立类型，不属于 spec.ItemType）
-     */
-    readonly type = SDKItemType.GENERATOR;
-    /**
-     * @description 元素属性（包含 generatorType）
-     */
-    property: GeneratorItemProperty;
-    constructor(options: GeneratorItemOptions);
-    /**
-     * @description 生成器类型
-     */
-    get generatorType(): 'image' | 'video';
-    set generatorType(value: 'image' | 'video');
-    /**
-     * @description 图片地址（生成器返回空）
-     */
-    get image(): string;
-    set image(_value: string);
-    /**
-     * @description 位置
-     */
-    get position(): [number, number];
-    set position(value: [number, number]);
-    /**
-     * @description 宽度
-     */
-    get width(): number;
-    set width(value: number);
-    /**
-     * @description 高度
-     */
-    get height(): number;
-    set height(value: number);
-    /**
-     * @description 旋转（二维旋转角度）
-     */
-    get rotation(): number;
-    set rotation(value: number);
-    /**
-     * @description 完整旋转（包含 x, y, z）
-     */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
-    /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
-     */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
-    /**
-     * @description 转换为 GeneratorCreateInfo
-     * @param withParent 是否包含父节点ID
-     */
-    toCreateInfo(withParent?: boolean): GeneratorCreateInfo;
-    /**
-     * @description 转换为 VideoCreateInfo（用于转换为视频元素）
-     * @param videoUrl 视频资源地址
-     * @param withParent 是否包含父节点ID
-     */
-    toVideoCreateInfo(videoUrl: string, withParent?: boolean): VideoCreateInfo;
-    /**
-     * @description 转换为 SpriteCreateInfo（用于转换为图片元素）
-     * @param imageUrl 图片资源地址
-     * @param withParent 是否包含父节点ID
-     */
-    toSpriteCreateInfo(imageUrl: string, withParent?: boolean): SpriteCreateInfo;
-    /**
-     * @description 克隆 SDKItem
-     */
-    clone(): GeneratorItem;
-}
-/**
- * @description 类型守卫：检查是否是 GeneratorItem
- */
-declare function isGeneratorItem(obj: any): obj is GeneratorItem;
-
-/**
- * @description 特效产物 元素 SDKItem 类
- */
-declare class EffectsItem extends BaseItem {
-    /**
-     * @description 元素类型（独立类型，不属于 spec.ItemType）
-     */
-    readonly type = SDKItemType.EFFECTS;
-    /**
-     * @description 预合成元素ID
-     */
-    subCompositionItemId: string;
-    /**
-     * @description 元素属性
-     */
-    property: EffectsItemProperty;
-    constructor(options: EffectsItemOptions);
-    /**
-     * @description 特效资源地址
-     */
-    get effects(): string;
-    set effects(value: string);
-    /**
-     * @description 位置
-     */
-    get position(): [number, number];
-    set position(value: [number, number]);
-    /**
-     * @description 宽度
-     */
-    get width(): number;
-    set width(value: number);
-    /**
-     * @description 高度
-     */
-    get height(): number;
-    set height(value: number);
-    /**
-     * @description 旋转（二维旋转角度）
-     */
-    get rotation(): number;
-    set rotation(value: number);
-    /**
-     * @description 完整旋转（包含 x, y, z）
-     */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
-    /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
-     */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
-    /**
-     * @description 转换为 EffectsCreateInfo
-     * @param withParent 是否包含父节点ID
-     */
-    toCreateInfo(withParent?: boolean): EffectsCreateInfo;
-    /**
-     * @description 克隆 SDKItem
-     */
-    clone(): EffectsItem;
-}
-/**
- * @description 类型守卫：检查是否是 EffectsItem
- */
-declare function isEffectsItem(obj: any): obj is EffectsItem;
-
-/**
- * @description 画板/框架元素 SDKItem 类
- * @description 支持自动布局和自由布局两种模式
- * @description 底层以 composition 形式渲染
- */
-declare class FrameItem extends BaseItem {
-    /**
-     * @description 元素类型
-     */
-    readonly type = SDKItemType.FRAME;
-    /**
-     * @description 预合成元素ID
-     */
-    subCompositionItemId: string;
-    /**
-     * @description 元素属性
-     */
-    property: FrameItemProperty;
-    constructor(options: FrameItemOptions);
-    /**
-     * @description 子元素ID列表（只读）
-     */
-    get children(): readonly string[];
-    /**
-     * @description 布局模式
-     */
-    get layoutMode(): FrameLayoutMode;
-    set layoutMode(value: FrameLayoutMode);
-    /**
-     * @description 布局信息
-     */
-    get layoutInfos(): Record<string, LayoutInfo> | undefined;
-    set layoutInfos(info: Record<string, LayoutInfo> | undefined);
-    /**
-     * @description 位置
-     */
-    get position(): [number, number];
-    set position(value: [number, number]);
-    /**
-     * @description 宽度
-     */
-    get width(): number;
-    set width(value: number);
-    /**
-     * @description 高度
-     */
-    get height(): number;
-    set height(value: number);
-    /**
-     * @description 缩放
-     */
-    get scale(): [number, number];
-    set scale(value: [number, number]);
-    /**
-     * @description 旋转（二维旋转角度）
-     */
-    get rotation(): number;
-    set rotation(value: number);
-    /**
-     * @description 完整旋转（包含 x, y, z）
-     */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
-    /**
-     * @description 添加子元素
-     * @param itemId 子元素ID
-     * @returns 是否添加成功
-     */
-    addChild(itemId: string): boolean;
-    /**
-     * @description 批量添加子元素
-     * @param itemIds 子元素ID列表
-     */
-    addChildren(itemIds: string[]): void;
-    /**
-     * @description 移除子元素
-     * @param itemId 子元素ID
-     * @returns 是否移除成功
-     */
-    removeChild(itemId: string): boolean;
-    /**
-     * @description 批量移除子元素
-     * @param itemIds 子元素ID列表
-     */
-    removeChildren(itemIds: string[]): void;
-    /**
-     * @description 是否包含指定子元素
-     * @param itemId 子元素ID
-     */
-    hasChild(itemId: string): boolean;
-    /**
-     * @description 清空所有子元素
-     */
-    clearChildren(): void;
-    /**
-     * @description 转换为 FrameCreateInfo
-     * @param withParent 是否包含父节点ID
-     */
-    toCreateInfo(withParent?: boolean): FrameCreateInfo;
-    /**
-     * @description 克隆 SDKItem
-     */
-    clone(): FrameItem;
-}
-/**
- * @description 类型守卫：检查是否是 FrameItem
- */
-declare function isFrameItem(obj: any): obj is FrameItem;
-
-/**
- * @description 根据 item type 创建对应的 SDKItem 实例
- * @param type 元素类型
- * @param options SDKItem 选项
- * @returns SDKItem 实例
- */
-declare function createSDKItem(type: spec.ItemType, options: SDKItemOptions): BaseItem;
-/**
- * @description SDKItem 类型联合
- * @description 用于替换原来的 SDKItem type
- */
-type SDKItem = SpriteItem | TextItem | VideoItem | GroupItem | GeneratorItem | EffectsItem | FrameItem;
-
-declare function arrAdd<T>(arr: T[], item: T): void;
-declare function isObj(item: any): item is object;
-declare function deepEquals<T>(a: T, b: T): boolean;
-declare function deepClone<T>(target: T): T;
-declare function getColorByNormalizeColor(color: [number, number, number, number]): [number, number, number, number];
-declare function getNormalizeColorByColor(color: [number, number, number, number]): [number, number, number, number];
-declare function getTransformRatioByViewAndCamera(viewSize: Vector2, cameraPosition: Vector3, cameraFov: number, cameraNear: number, cameraFar: number, isReverse: boolean): {
-    xRatio: number;
-    yRatio: number;
-};
-declare function assertExist<T>(item: T | undefined | null, msg?: string): asserts item is T;
-declare function asserts(condition: any, msg?: string): asserts condition;
-/**
- * @example
- * Input: logger('log', ['VVFX', 'SDK'], 'xx is required');
- * Output: [VVFX SDK] xx is required
- */
-type Level = 'error' | 'info' | 'debug' | 'warn' | 'log';
-declare function logger(level: Level, prefixs: string[], ...args: any[]): void;
-declare function loadScriptAsync(src: string, attrs?: Record<string, string>): Promise<unknown>;
-declare function downloadBlob(buffer: BlobPart | BlobPart[], filename: string, mimeType?: string): void;
-declare function getUniqueName(name: string, names: string[]): string;
-/**
- * 深度比较两个值是否相等
- */
-declare function isEqual(a: unknown, b: unknown): boolean;
-
-/**
- * @description 交互状态视图信息
- */
-type ViewInteractionParam = {
-    /**
-     * @description 视口宽度 - 红框区域像素大小
-     */
-    width: number;
-    /**
-     * @description 视口高度 - 红框区域像素大小
-     */
-    height: number;
-    /**
-     * @description 视口缩放比例
-     */
-    scale: number;
-    /**
-     * @description 视口位移信息
-     */
-    translation: Vector2;
-    /**
-     * @description 标尺宽度
-     */
-    rulerWidth: number;
-};
-/**
- * @description 交互状态相机信息
- */
-type CameraInteractionParam = {
-    /**
-     * @description 位置
-     */
-    position: Vector3;
-    /**
-     * @description 旋转角度
-     */
-    rotation: Vector3;
-    /**
-     * @description 视野初始中心
-     */
-    focusPosition: Vector3;
-    /**
-     * @description 视野初始角度
-     */
-    focusRotation: Vector3;
-    /**
-     * @description 投影矩阵
-     */
-    viewProjectionMatrix: Matrix4;
-    /**
-     * @description 逆投影矩阵
-     */
-    inverseViewProjectionMatrix: Matrix4;
-};
-declare const SafeConstraint: {
-    topAdsorption: string;
-    leftAdsorption: string;
-    rightAdsorption: string;
-    bottomAdsorption: string;
-    centerAdsorption: string;
-    bottomCenterAdsorption: string;
-};
-type ItemJSONInfo = {
-    item: spec.VFXItemData;
-    components: spec.ComponentData[];
-    tracks: any[];
-    playableAssets: any[];
-};
-type AlignType = 'left' | 'right' | 'horizontal-center' | 'top' | 'bottom' | 'vertical-center';
-type DistributeType = 'vertical-spacing' | 'horizontal-spacing';
-/**
- * @description 背景类型预设配置
- */
-type BackgroundPreset = {
-    /**
-     * @description 背景颜色
-     */
-    color?: string;
-    /**
-     * @description 背景图片/渐变
-     */
-    image?: string;
-    /**
-     * @description 背景重复方式
-     */
-    repeat?: string;
-    /**
-     * @description 背景位置
-     */
-    position?: string;
-    /**
-     * @description 背景大小
-     */
-    size?: string;
-};
-/**
- * @description 背景网格配置
- */
-type BackgroundGridConfig = {
-    /**
-     * @description 基础网格大小（像素）
-     */
-    baseSize: number;
-    /**
-     * @description 缩放循环阈值（默认 2，即 2x 时重置）
-     */
-    zoomCycle: number;
-    /**
-     * @description 最小网格大小限制
-     */
-    minSize: number;
-};
-
-/**
- * @description 背景管理器
- * 负责管理画布背景的配置、渲染和跟随变换
- */
-declare class BackgroundManager {
-    /**
-     * @description 默认网格配置
-     */
-    static readonly DEFAULT_GRID_CONFIG: BackgroundGridConfig;
-    /**
-     * @description 背景预设配置
-     */
-    static readonly PRESETS: Record<string, BackgroundPreset>;
-    private container;
-    private config;
-    /**
-     * @description 当前背景位置（用于跟随移动）
-     */
-    private offsetX;
-    private offsetY;
-    constructor(config?: Partial<BackgroundGridConfig>);
-    /**
-     * @description 绑定容器元素
-     * @param element 画布容器元素
-     */
-    attach(element: HTMLElement): void;
-    /**
-     * @description 解绑容器元素
-     */
-    detach(): void;
-    /**
-     * @description 应用背景预设
-     * @param presetName 预设名称
-     * @param color 可选的背景色覆盖
-     */
-    applyPreset(presetName: string, color?: string): boolean;
-    /**
-     * @description 设置纯色背景
-     * @param color 颜色值
-     */
-    setColorBackground(color: string): void;
-    /**
-     * @description 设置图片背景
-     * @param url 图片 URL
-     */
-    setImageBackground(url: string): void;
-    /**
-     * @description 更新背景变换（跟随画布移动和缩放）
-     * @param shift 画布移动的偏移量
-     * @param zoom 当前缩放比例
-     */
-    updateTransform(shift: {
-        x: number;
-        y: number;
-    }, zoom: number): void;
-    /**
-     * @description 重置背景位置和大小
-     */
-    reset(): void;
-    /**
-     * @description 清除背景样式
-     */
-    private clearBackground;
-    /**
-     * @description 计算循环缩放比例
-     * zoom 在 [1, 2) 时，bgZoom = zoom
-     * zoom 在 [2, 4) 时，bgZoom = zoom / 2
-     * zoom 在 [0.5, 1) 时，bgZoom = zoom / 0.5
-     */
-    private calculateZoomCycle;
-}
-
-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;
-/**
- * 通用撤销重做操作类型
- */
-type GizmoOperation<T> = {
-    type: 'update';
-    newData: T;
-    oldData: T;
-};
-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 SDK编辑模式 - 模板编辑模式 | 编辑器模式
-     */
-    mode: SDKMode;
-    /**
-     * @description 页面功能配置
-     */
-    pageConfig: PageConfig$1;
-    /**
-     * @description 异步加载功能配置
-     */
-    asyncLoadConfig: AsyncLoadConfig;
-    /**
-     * @description 截图功能配置
-     */
-    screenShotConfig: ScreenShotConfig;
-    /**
-     * @description 导出视频功能配置
-     */
-    exportConfig: ExportConfig;
-    /**
-     * @description 尺寸自适应功能开关
-     */
-    sizeAdaptConfig: SizeAdaptConfig;
-    /**
-     * @description 辅助面板功能配置
-     */
-    gestureHandlerConfig: {
-        enabled: boolean;
-        loadingGizmoConfig: LoadingGizmoConfig;
-        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;
-        iconGizmoEnabled: boolean;
-        iconGizmoConfig: IconGizmoConfig;
-        itemCreateGizmoEnabled: boolean;
-        itemCreateGizmoConfig: ItemCreateGizmoConfig;
-        /**
-         * @description 自动布局指示器配置
-         */
-        autoLayoutIndicatorConfig: AutoLayoutIndicatorConfig;
-    };
-    /**
-     * @description 元素配置
-     */
-    itemConfig: {
-        /**
-         * @description 画板元素参数配置
-         */
-        frameConfig: FrameConfig;
-        /**
-         * @description 生成器元素参数配置
-         */
-        generatorConfig: GeneratorConfig;
-    };
-};
-/**
- * @description 画板元素参数配置
- */
-type FrameConfig = {
-    /**
-     * @description 自动布局边距
-     */
-    layoutPadding: number;
-    /**
-     * @description 自动布局元素间隔
-     */
-    layoutGap: number;
-    /**
-     * @description 默认画板[无子元素时]宽度
-     */
-    defaultWidth: number;
-    /**
-     * @description 默认画板[无子元素时]高度
-     */
-    defaultHeight: number;
-    /**
-     * @description 自动布局背景颜色
-     */
-    autoLayoutBackgroundColor: [number, number, number, number];
-    /**
-     * @description 自由布局背景颜色
-     */
-    freeLayoutBackgroundColor: [number, number, number, number];
-};
-/**
- * @description 生成器元素参数配置
- */
-type GeneratorConfig = {
-    /**
-     * @description 生成器背景颜色
-     */
-    backgroundColor: [number, number, number, number];
-};
-/**
- * @description 自动布局指示器配置
- */
-type AutoLayoutIndicatorConfig = {
-    /**
-     * @description 指示线宽度
-     */
-    lineWidth: number;
-    /**
-     * @description 指示线颜色
-     */
-    lineColor: number;
-};
-/**
- * @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 全局自适应排布模式
-     */
-    autoLayoutDefaultMode: GlobalLayoutMode;
-    /**
-     * @description 全局自适应排布间隔
-     */
-    autoLayoutDefaultGap: number;
-};
-/**
- * @description 异步加载配置
- */
-type AsyncLoadConfig = {
-    enabled: boolean;
-    loadingTextureUrl: string;
-};
-/**
- * @description 视频导出功能配置
- */
-type ExportConfig = {
-    enabled: boolean;
-} & ExportMediaInitOptions;
-/**
- * @description 截图功能配置
- */
-type ScreenShotConfig = {
-    enabled: boolean;
-    defaultBackgroundColor: [number, number, number, number];
-};
-/**
- * @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地址
-     */
-    groupLogoUrl: string;
-    /**
-     * @description 文本Logo地址
-     */
-    textLogoUrl: string;
-    /**
-     * @description 视频Logo地址
-     */
-    videoLogoUrl: string;
-    /**
-     * @description 画板Logo地址
-     */
-    frameLogoUrl: string;
-    /**
-     * @description 特效Logo地址
-     */
-    effectsLogoUrl: 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 网格线数量
-     */
-    gridCount: number;
-    /**
-     * @description 网格线颜色
-     */
-    gridLineColor: number;
-    /**
-     * @description 网格线宽度
-     */
-    gridLineWidth: number;
-    /**
-     * @description 网格线透明度
-     */
-    gridLineAlpha: 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 网格线数量
-     */
-    gridCount: number;
-    /**
-     * @description 网格线颜色
-     */
-    gridLineColor: number;
-    /**
-     * @description 网格线宽度
-     */
-    gridLineWidth: number;
-    /**
-     * @description 网格线透明度
-     */
-    gridLineAlpha: 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 触发边缩放交互的距离
-     */
-    widthScaleInteractionDistance: number;
-    /**
-     * @description 画板线框颜色
-     */
-    wireframeColor: number;
-    /**
-     * @description 画板线框透明度
-     */
-    wireframeAlpha: number;
-    /**
-     * @description 画板线框线宽
-     */
-    wireframeWidth: number;
-};
-/**
- * @description 蒙版参数
- */
-type MaskGizmoConfig = {
-    /**
-     * @description 画笔大小
-     */
-    brushSize: number;
-    /**
-     * @description 笔刷颜色
-     */
-    brushColor: number;
-    /**
-     * @description 笔刷透明度
-     */
-    brushAlpha: number;
-    /**
-     * @description 蒙版颜色
-     */
-    maskColor: number;
-    /**
-     * @description 蒙版背景色
-     */
-    maskBackgroundColor: number;
-    /**
-     * @description 蒙版透明度
-     */
-    maskAlpha: number;
-    /**
-     * @description 蒙版图片
-     */
-    maskImage?: HTMLImageElement;
-    /**
-     * @description 元素包围盒线框宽度
-     */
-    boxLineWidth: number;
-    /**
-     * @description 元素包围盒线框颜色
-     */
-    boxLineColor: number;
-    /**
-     * @description 元素包围盒线框透明度
-     */
-    boxLineAlpha: number;
-};
-/**
- * @description Loading 参数
- */
-type LoadingGizmoConfig = {
-    /**
-     * @description 加载中 effect fragment
-     */
-    loadingFragment?: string;
-};
-/**
- * @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;
-};
-type IconGizmoConfig = {
-    /**
-     * @description 自动展示
-     */
-    autoShow: boolean;
-    /**
-     * @description 图标地址
-     */
-    videoPlayUrl: string;
-    /**
-     * @description 距离右下角偏移值
-     */
-    videoPlayShift: [number, number];
-    /**
-     * @description 宽
-     */
-    videoPlayWidth: number;
-    /**
-     * @description 高
-     */
-    videoPlayHeight: number;
-    imageGeneratorUrl: string;
-    videoGeneratorUrl: string;
-    generatorWidth: number;
-    generatorHeight: number;
-};
-type ItemCreateGizmoConfig = {
-    /**
-     * @description 边框颜色
-     */
-    frameBorderColor: number;
-    /**
-     * @description 边框宽度
-     */
-    frameBorderWidth: number;
-    /**
-     * @description 边框透明度
-     */
-    frameBorderAlpha: number;
-    /**
-     * @description 填充颜色
-     */
-    frameFillColor: number;
-    /**
-     * @description 填充透明度
-     */
-    frameFillAlpha: number;
-    /**
-     * @description 选中子元素包围盒透明度
-     */
-    frameChildBoxAlpha: number;
-    /**
-     * @description 选中子元素包围盒颜色
-     */
-    frameChildBoxColor: number;
-};
-
-/**
- * @description 图片蒙版工具结果
- */
-type MaskResult = {
-    /**
-     * @description 状态
-    */
-    status: 'init' | 'done';
-    /**
-     * @description 包围盒
-     */
-    box?: Box2;
-    /**
-     * @description 鼠标位置
-     */
-    point?: Vector2;
-    /**
-     * @description 蒙版线条列表
-     */
-    lines: {
-        brushSize: number;
-        points: Vector2[];
-        type?: 'paint' | 'erase';
-    }[];
-};
-/**
- * @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 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' | 'icon' | '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 LoadingGizmoTip = {
-    text: string;
-    fontSize?: number;
-    fontFamily?: string;
-    color?: number;
-};
-type LoadingGizmoItemOptions = {
-    /** Loading 提示文案 */
-    tip?: LoadingGizmoTip;
-    /** 指定 Loading 区域 */
-    loadingBox?: Box2;
-    /** 清理选中 */
-    clearSelected?: boolean;
-};
-
-/**
- * 蒙版工具的撤销重做数据类型
- */
-type MaskUndoRedoData = {
-    lines: MaskResult['lines'];
-};
-
-/**
- * 图片裁切工具的撤销重做数据类型
- */
-type PictureCutUndoRedoData = {
-    normalizeCutBox: Box2;
-};
-
-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;
-        propertyKeys: 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];
-    'maskGizmoUndoRedoChange': [GizmoOperation<MaskUndoRedoData>];
-    'pictureCutGizmoUndoRedoChange': [GizmoOperation<PictureCutUndoRedoData>];
-    'viewportTransform': [{
-        zoom: number;
-        translation: [number, number];
-    }];
-    'itemOnDragStart': [type: GizmoType];
-    'itemOnDrag': [type: GizmoType];
-    'itemOnDragEnd': [type: GizmoType];
-    'spriteTextClick': [{
-        id: string;
-        index: number;
-        text: string;
-    } | undefined];
-    'videoPlay': [{
-        id: string;
-        time: number;
-    }];
-    'itemCreate': [{
-        type: ItemCreateType;
-        position: spec.vec2;
-        id: string;
-    }];
-    'viewLost': [];
-    'viewRebuildFinish': [];
-};
-declare class SDK {
-    static config: SDKConfig;
-    private _eventEmitter;
-    private _pageData;
-    private _screenShot;
-    private _exporter?;
-    private _pageDataUtils;
-    private _sizeAdapt;
-    private _gestureHandler;
-    private disposables;
-    private _isSwitchScene;
-    private _undoRedo;
-    private _backgroundManager;
-    player: Player;
-    _container: HTMLElement;
-    private _playerContainer;
-    constructor(container: HTMLElement, mode?: SDKMode);
-    get backgroundManager(): BackgroundManager;
-    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" | "maskGizmoUndoRedoChange" | "pictureCutGizmoUndoRedoChange" | "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 设置元素属性（支持单个元素的单/多属性设置）
-     * @param param 设置参数，支持两种场景：
-     *   1. 单个元素单个属性: { itemId, type, propertyName, propertyValue }
-     *   2. 单个元素多个属性: { itemId, type, property }
-     */
-    setItemProperty<T extends SDKItemType>(param: SetItemPropertyParam<T>): 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>;
-    /**
-     * @description 获取元素
-     * @param id 元素ID
-     * @returns 元素
-     * */
-    getSDKItem(id: string): SDKItem | undefined;
-    /**
-     * @description 获取元素数组
-     * @param id 元素ID数组
-     * @returns 元素数组
-     * */
-    getSDKItems(ids?: string[]): SDKItem[];
-    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 以媒体格式 buffer 下载
-     */
-    downloadByMediaBuffersOfExporter(params: ExportMediaItemDownloadInfo[], buffers: Buffers, extras: Extras): void;
-    /**
-     * @description 导出
-     * 支持导出媒体或其他，如MP4，未来支持 JSON 等；
-     */
-    onExport(): void;
-    /**
-     * @description 取消导出
-     */
-    cancelExport(): void;
-    loadPageData(data: PageData): Promise<void>;
-    runByPageData(data: PageData): Promise<void>;
-    reloadPageDataByScene(scene: string | spec.JSONScene): Promise<void>;
-    /**
-     * @description 新增视图数据
-     * @param viewParams 视图参数
-     * @param scene 场景数据 - 无输入时为默认场景数据
-     */
-    addViewParams(viewParams: ViewParam[], scene?: spec.JSONScene): Promise<void>;
-    deleteViewParams(ids: number[]): Promise<void>;
-    setExportParam(exportParam: Partial<ExportParam>, id?: number): void;
-    /**
-     * @description 设置视图缩放
-     * @param zoom 缩放值
-     * @param center 缩放中心
-     * @param ignoreClamp 是否忽视约束
-     */
-    setPageZoom(zoom: number, center?: Vector2, ignoreClamp?: boolean): void;
-    /**
-     * @description 设置元素移动
-     * @param targetTranslation 目标移动值
-     */
-    setPageMove(targetTranslation: Vector2): void;
-    /**
-     * @description 设置静态预览功能开关
-     * @param enabled 功能开关
-     */
-    setStaticPreviewEnabled(enabled: boolean): void;
-    /**
-     * @description 设置静态预览视图名称
-     * @param name 视图名称
-     */
-    setStaticPreviewName(name: string): void;
-    /**
-     * @description 设置同步修改功能开关
-     * @param enabled 功能开关
-     */
-    setAsyncEnabled(enabled: boolean): void;
-    /**
-     * @description 设置 成组显影 开关
-     */
-    setGroupVisibleEnabled(enabled: boolean): void;
-    /**
-     * @description 新增过滤元素名称
-     * @param itemNames 过滤元素名称
-     */
-    addFilterItemNames(itemNames: string[] | string): void;
-    /**
-     * @description 设置预览辅助层颜色
-     * @param color 色值
-     */
-    setPreferenceBackgroundColor(color: [number, number, number, number]): void;
-    /**
-     * @description 设置出血区颜色
-     * @param color 色值
-     */
-    setSafeAreaColor(color: [number, number, number, number]): void;
-    /**
-     * @description 设置 尺寸自适应拓展 功能开关
-     * @param enabled 功能开关
-     */
-    setSizeAdaptEnabled(enabled: boolean): void;
-    /**
-     * @description 设置 截图 功能开关
-     * @param enabled 功能开关
-     */
-    setScreenShotEnabled(enabled: boolean): void;
-    /**
-     * @description 设置导出功能初始化配置
-     * @param exportConfig
-     */
-    setExportConfig(exportConfig: Partial<ExportConfig>): void;
-    /**
-     * @description 设置预选框参数
-     * @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>;
-    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 设置蒙版工具模式
-     * @param mode 模式类型：'paint' 表示涂抹，'erase' 表示擦除
-     */
-    setMaskGizmoMode(mode: 'paint' | 'erase'): void;
-    /**
-     * 撤销蒙版操作
-     * @returns 是否成功撤销
-     */
-    undoMaskGizmo(): boolean;
-    /**
-     * 重做蒙版操作
-     * @returns 是否成功重做
-     */
-    redoMaskGizmo(): boolean;
-    /**
-     * 检查蒙版是否可以撤销
-     */
-    get canUndoMaskGizmo(): boolean;
-    /**
-     * 检查蒙版是否可以重做
-     */
-    get canRedoMaskGizmo(): boolean;
-    /**
-     * 清空蒙版 undoRedo 历史
-     */
-    clearMaskGizmoUndoRedo(): void;
-    /**
-     * 撤销图片裁切操作
-     * @returns 是否成功撤销
-     */
-    undoPictureCutGizmo(): boolean;
-    /**
-     * 重做图片裁切操作
-     * @returns 是否成功重做
-     */
-    redoPictureCutGizmo(): boolean;
-    /**
-     * 检查图片裁切是否可以撤销
-     */
-    get canUndoPictureCutGizmo(): boolean;
-    /**
-     * 检查图片裁切是否可以重做
-     */
-    get canRedoPictureCutGizmo(): boolean;
-    /**
-     * 清空图片裁切 undoRedo 历史
-     */
-    clearPictureCutGizmoUndoRedo(): void;
-    openLoadingGizmo(id: string, options?: LoadingGizmoItemOptions): void;
-    updateLoadingGizmo(id: string, options: {
-        tip?: LoadingGizmoTip;
-    }): void;
-    closeLoadingGizmo(id: string): void;
-    /**
-     * @description 元素打组
-     * @param children 子元素ID
-     */
-    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>;
-    createScreenShotByFrame(id: string): Promise<string | undefined>;
-    createScreenShotByEffects(id: string): 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;
-    /**
-     * @description 批量设置元素扩展属性
-     * @param id 元素ID
-     * @param extensions 扩展属性对象（支持同时设置多个）
-     * @returns 是否设置成功
-     */
-    setItemExtension(id: string, extension: Record<string, any>): boolean;
-    /**
-     * @description 批量获取元素扩展属性
-     * @param id 元素ID
-     * @param keys 扩展属性名称列表（不传则返回所有扩展属性）
-     * @returns 扩展属性对象
-     */
-    getItemExtension(id: string, keys?: string[]): Record<string, any> | undefined;
-    /**
-     * @description 删除元素扩展属性（支持批量删除）
-     * @param id 元素ID
-     * @param keys 扩展属性名称列表
-     * @returns 是否删除成功
-     */
-    deleteItemExtensions(id: string, keys: string[]): boolean;
-    /**
-     * @description 检查元素是否有指定扩展属性
-     * @param id 元素ID
-     * @param key 扩展属性名称
-     * @returns 是否存在
-     */
-    hasItemExtension(id: string, key: string): boolean;
-    /**
-     * @description 获取元素所有扩展属性的键名列表
-     * @param id 元素ID
-     * @returns 键名数组
-     */
-    getItemExtensionKeys(id: string): string[] | 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;
-    setSpriteSize(id: string, size: spec.vec2): void;
-    setItemPropertyByCreateInfo(createInfo: ItemCreateInfo | ItemCreateInfo[]): Promise<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;
-    getEffectsItemPlayTime(id: string): number | undefined;
-    setEffectsItemPlayTime(id: string, time: number): void;
-    setEffectsResource(id: string, effects: string): void;
-    getPixelPositionByViewPosition(viewPosition: Vector2): Vector2;
-    hitTest(x: number, y: number): string[] | undefined;
-    setInteractType(type: GestureHandlerInteractType): void;
-    getInteractType(): GestureHandlerInteractType;
-    makeItemAlign(type: AlignType, ids?: string[]): void;
-    makeItemDistribute(type: DistributeType, ids?: string[]): void;
-    /**
-     * @description 创建生成器元素
-     * @param createInfo 生成器创建信息
-     * @returns 生成器元素ID
-     */
-    addGeneratorItem(createInfo: GeneratorCreateInfo): string;
-    /**
-     * @description 创建动效元素
-     * @param effectsInfo 动效创建信息
-     */
-    addEffectsItem(effectsInfo: EffectsCreateInfo): Promise<string | undefined>;
-    /**
-     * @description 创建画板元素
-     * @param createInfo 画板创建信息
-     * @returns 画板元素ID
-     */
-    addFrameItem(createInfo: FrameCreateInfo): Promise<string>;
-    /**
-     * @description 将元素移动到 Frame 中
-     * @param itemIds 要移动的元素ID列表
-     * @param frameId 目标 Frame ID
-     */
-    moveItemsToFrame(itemIds: string[], frameId: string): void;
-    /**
-     * @description 将元素从 Frame 中移出到主场景
-     * @param itemIds 要移动的元素ID列表
-     * @param frameId 源 Frame ID（可选，如果不传则从元素的 parentId 推断）
-     */
-    moveItemsOutOfFrame(itemIds: string[]): void;
-    /**
-     * @description 设置生成器资源，将生成器转换为对应的元素
-     * @param id 生成器元素ID
-     * @param resourceUrl 资源地址
-     * @returns 新的元素ID
-     */
-    setGeneratorResource(id: string, resourceUrl: string): Promise<string>;
-    /**
-     * @description 设置生成器资源（使用 GeneratorResource 对象）
-     * @param resource 生成器资源信息
-     */
-    setGeneratorResourceFromObject(resource: GeneratorResource): void;
-    /**
-     * @description 设置视频生成器资源
-     * @param resource 视频生成器资源信息
-     */
-    setVideoGeneratorResource(resource: VideoGeneratorResource): Promise<string>;
-    /**
-     * @description 设置图层生成器资源
-     * @param resource 图层生成器资源信息
-     */
-    setSpriteGeneratorResource(resource: SpriteGeneratorResource): Promise<string>;
-    setItemLockState(id: string, state: boolean): void;
-    getItemLockState(id: string): boolean;
-    openItemCreateGizmo(type: ItemCreateType): void;
-    closeItemCreateGizmo(): void;
-    openTextGizmo(textItemId?: string, mode?: 'select' | 'focus'): void;
-    closeTextGizmo(): void;
-    setItemName(id: string, name: string): void;
-    setSafeAreaPreviewVisible(id: number, type: 'url' | 'color', visible: boolean): void;
-    /**
-     * @description 修改画板元素大小
-     * @param id 元素id
-     * @param size 目标大小 [width, height]
-     * @param translation 位置偏移补偿（可选，用于保持拖拽角点固定）
-     */
-    resizeFrameItem(id: string, size: [number, number], translation?: [number, number]): void;
-    /**
-     * @description 对 FrameItem 执行自动布局（当 layoutMode 为 AUTO 时使用）
-     * @param frameId Frame 元素 ID
-     */
-    applyFrameAutoLayout(frameId: string): void;
-    autoLayoutPage(param?: PageAutoLayoutParam): Promise<void>;
-}
-
-/**
- * @description 创建 Frame 元素的内部合成场景
- * @param frameId Frame 元素ID（用于标识）
- * @param size 场景尺寸 [width, height]
- * @param name 场景名称
- * @returns Frame 内部的合成场景
- */
-declare function createFrameCompositionScene(frameId: string, size: spec.vec2, name: string): spec.JSONScene;
-/**
- * @description 创建基础场景信息
- * @param viewSize 画布大小
- * @returns 场景信息
- */
-declare function getBasicScene(viewSize?: number[], name?: string): spec.JSONScene;
-declare function createSpriteItemJSON(spriteId: string, position: Vector3, rotation: Vector3, size: Vector2, scale: Vector3, name: string, texture?: string): ItemJSONInfo;
-/**
- * @description 创建视频生成器 Item JSON
- * @description 以 SpriteItem 形式渲染，但设置透明颜色
- * @description 在 content 中存储 isVideoGenerator 标记
- */
-declare function createVideoGeneratorItemJSON(id: string, position: Vector3, rotation: Vector3, size: Vector2, scale: Vector3, name: string): ItemJSONInfo;
-declare function createNullItemJSON(nullId: string, name: string, position: Vector3, scale?: Vector2, rotation?: Vector3, worldSize?: Vector2): ItemJSONInfo;
-declare function createTextItemJSON(textId: string, name: string, position: Vector3, rotation: Vector3, size: Vector2, fontInfo: spec.TextContentOptions): ItemJSONInfo;
-declare function createVideoItemJSON(videoId: string, position: Vector3, rotation: Vector3, size: Vector2, scale: Vector3, name: string, isMuted?: boolean, transparent?: boolean, volume?: number, playbackRate?: number, texture?: string, video?: string): ItemJSONInfo;
-/**
- * @description 创建预合成元素
- * @param effectsId 预合成元素ID
- * @param position 位置信息
- * @param rotation 旋转信息
- * @param scale 缩放信息
- * @param name 名称
- */
-declare function createCompositionItemJSON(effectsId: string, position: Vector3, rotation: Vector3, scale: Vector3, name: string): {
-    item: spec.VFXItemData;
-    components: never[];
-    tracks: {
-        id: string;
-        dataType: spec.DataType;
-        children: never[];
-        clips: {
-            start: number;
-            duration: number;
-            endBehavior: spec.EndBehavior;
-            asset: {
-                id: string;
-            };
-        }[];
-    }[];
-    playableAssets: {
-        id: string;
-        dataType: spec.DataType;
-    }[];
-};
-/**
- * @description 添加元素信息到JSON
- * @param scene 场景信息
- * @param itemInfo 元素信息
- */
-declare function addItemInfoToScene(scene: spec.JSONScene, itemInfo: ItemJSONInfo): void;
-/**
- * @description 设置元素父节点信息
- * @param scene 场景信息
- * @param itemId 元素Id
- * @param parentId 父节点Id
- */
-declare function setItemJSONParentId(scene: spec.JSONScene, itemId: string, parentId: string): void;
-/**
- * @description 清理元素父节点信息
- * @param scene 场景信息
- * @param itemId 元素Id
- */
-declare function clearItemParentInfo(scene: spec.JSONScene, itemId: string): void;
-/**
- * @description 删除元素信息
- * @param scene 场景信息
- * @param itemId 元素Id
- */
-declare function deleteItemInfoFromScene(scene: spec.JSONScene, itemId: string): spec.JSONScene | undefined;
-/**
- * @description 从场景中移除并获取元素的完整 ItemJSONInfo
- * @param scene 场景信息
- * @param itemId 元素ID
- * @returns ItemJSONInfo 或 undefined（如果元素不存在）
- */
-declare function removeItemInfoFromScene(scene: spec.JSONScene, itemId: string): ItemJSONInfo | undefined;
-declare function getTextureUrlById(scene: spec.JSONScene, itemId: string): string | undefined;
-declare function addCompositionItemByComposition(main: spec.JSONScene, inputChild: spec.JSONScene, compositionItemId: string, parentId?: string): spec.JSONScene;
-/**
- * @description 删除预合成数据
- * @param scene 场景数据
- * @param itemId 预合成ID
- * @returns 场景数据
- */
-declare function deleteCompositionItemFromScene(scene: spec.JSONScene, itemIds: string[]): spec.JSONScene;
-/**
- * @description 删除合成信息
- * @param scene 场景数据
- * @param compositionId 合成ID
- */
-declare function deleteCompositionFromScene(scene: spec.JSONScene, compositionId: string): void;
-/**
- * @description 重置元素ID - 加载时会新建guid，需要保持一致
- * @param scene 场景数据
- * @param idMap id名称列表
- */
-declare function resetSubCompositionItemId(scene: spec.JSONScene, idMap: Map<string, string>): void;
-/**
- * @description 设置场景中元素名称
- * @param scene 场景数据
- * @param itemId 元素ID
- * @param name 名称
- */
-declare function setJSONItemName(scene: spec.JSONScene, itemId: string, name: string): void;
-/**
- * @description 元素变换选项
- */
-type MoveItemTransformOptions = {
-    position?: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    size?: {
-        x: number;
-        y: number;
-    };
-    scale?: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    rotation?: {
-        x: number;
-        y: number;
-        z: number;
-    };
-};
-/**
- * @description 将元素从一个合成移动到另一个合成
- * @param scene 场景数据
- * @param itemId 元素ID
- * @param targetCompositionId 目标合成ID，为null时表示移动到主合成
- * @param options 可选的位置、大小、缩放、旋转信息
- * @returns 是否移动成功
- */
-declare function moveItemBetweenCompositions(scene: spec.JSONScene, itemId: string, targetCompositionId: string | null, options?: MoveItemTransformOptions): boolean;
-declare function getCompositionIdByRefCompositionItemId(scene: spec.JSONScene, compositionItemId: string): any;
-/**
- * @description 获取预合成元素所指向的合成数据
- * @param scene 场景数据
- * @param compositionItemId 预合成元素ID
- * @returns 对应的合成数据 (CompositionData)，如果未找到则返回 undefined
- */
-declare function getCompositionDataByRefCompositionItemId(scene: spec.JSONScene, compositionItemId: string): spec.CompositionData | undefined;
-/**
- * @description 提取子合成元素及其所有关联资源为独立的 JSONScene
- * @param scene 主场景数据
- * @param compositionItemId 预合成元素ID（子合成元素ID）
- * @returns 独立的子合成场景 JSONScene，如果未找到则返回 undefined
- */
-declare function extractSubCompositionToScene(scene: spec.JSONScene, compositionItemId: string): spec.JSONScene | undefined;
-declare function fixStandardJSON(scene: spec.JSONScene): void;
-
-declare class PageDataUtils {
-    private sdk;
-    player: Player;
-    container: HTMLElement;
-    emitter: EventEmitter<SDKEvents>;
-    interactionUtils: InteractionUtils;
-    constructor(player: Player, container: HTMLElement, emitter: EventEmitter<SDKEvents>, sdk: SDK);
-    init(): void;
-    getPageData(): PageData | undefined;
-    getCurrentComposition(): Composition | undefined;
-    isItemSelected(id: string): boolean;
-    getItemEditEnable(id: string): boolean;
-    getItemShow(id: string): boolean;
-    addSelectedItems(ids: string[]): void;
-    removeSelectedItems(ids: string[]): void;
-    clearSelectedItems(emitChange?: boolean): void;
-    getSelectedItems(): SDKItem[];
-    addPreSelectedItem(id: string): void;
-    clearPreSelectedItem(): void;
-    getPreSelectedItem(): SDKItem | undefined;
-    addLoadingItems(ids: string[]): void;
-    removeLoadingItems(ids: string[]): void;
-    clearLoadingItems(): void;
-    getLoadingItems(): SDKItem[];
-    getSDKItem(id: string): SDKItem | undefined;
-    getPlayerSizeByParent(parentSize: [number, number], sceneSize: [number, number]): readonly [number, number];
-    loadScene(id: number): Promise<void>;
-    refreshPageTime(number: number): void;
-    pageZoom(shift: number, center?: Vector2, ignoreClamp?: boolean): void;
-    setPageZoom(targetZoom: number, center?: Vector2, ignoreClamp?: boolean): void;
-    refreshInteractionParam(): void;
-    pageMove(shift: Vector2): void;
-    setPageMove(targetTranslation: Vector2): void;
-    /**
-     * @description 设置当前相机视图矩阵
-     * @param matrix 视图矩阵
-     */
-    setCurrenCameraViewportMatrix(matrix: Matrix4): void;
-    rotateItem(id: string, shift: Vector3, ignoreEvent?: boolean): void;
-    moveItem(id: string, shift: Vector3, ignoreEvent?: boolean): void;
-    scaleItem(id: string, shift: Vector3, ignoreEvent?: boolean): void;
-    scaleTextItemWidth(id: string, scalar: number): void;
-    scaleTextItem(id: string, scalar: number): void;
-    getItemTransformById(id: string): {
-        matrix: Matrix4;
-        parentMatrix: Matrix4;
-    };
-    addSDKItemsByItems(result: SDKItem[], playerItems: VFXItem[], id?: string): void;
-    getFilterItemIds(): (string | undefined)[];
-    createSDKItemByPlayerItem(playerItem: VFXItem, parentId?: string): SDKItem;
-    /**
-     * @description 根据 spec.ItemType 创建 SDKItem（内部辅助方法）
-     * @param itemType spec.ItemType
-     * @param baseOptions 基础选项
-     * @param property 属性
-     * @returns SDKItem 实例
-     */
-    private createSDKItemBySpecType;
-    getViewBoxById(id: string): Box2;
-    getItemViewAnchor(id: string): Vector2 | undefined;
-    getChildrenPlayerItems(item?: VFXItem): VFXItem[];
-    getChildrenSceneItemIds(id: string, scene: spec.JSONScene): string[];
-    getViewBoxByPlayerItem(item: VFXItem, childrenItem: VFXItem[]): Box2;
-    getViewportLeftTopPosition(): Vector2;
-    getViewportByViewPoint(point: Vector2): Vector2;
-    /**
-     * @description 设置元素属性（支持单个元素的单/多属性设置）
-     * @param param 设置参数，支持两种场景：
-     *   1. 单个元素单个属性: { itemId, type, propertyName, propertyValue }
-     *   2. 单个元素多个属性: { itemId, type, property }
-     */
-    setItemProperty<T extends SDKItemType>(param: SetItemPropertyParam<T>): Promise<void>;
-    /**
-     * @description 场景 1: 设置单个元素的单个属性
-     */
-    private setSingleItemSingleProperty;
-    /**
-     * @description 场景 2: 设置单个元素的多个属性
-     */
-    private setSingleItemMultipleProperties;
-    /**
-     * @description 更新 PlayerItem 的属性
-     * @param itemId 元素ID
-     * @param propertyName 属性名
-     * @param propertyValue 属性值
-     */
-    private updatePlayerItemProperty;
-    /**
-     * @description 更新 PlayerItem 的基础属性
-     */
-    private updatePlayerItemBaseProperty;
-    /**
-     * @description 更新 PlayerItem 的 Property 属性
-     */
-    private updatePlayerItemPropertyAttribute;
-    /**
-     * @description 更新 JSON Scene 中 Item 的属性
-     * @param itemId 元素ID
-     * @param propertyName 属性名
-     * @param propertyValue 属性值
-     */
-    private updateJSONItemProperty;
-    /**
-     * @description 更新 Scene 中 Item 的基础属性
-     */
-    private updateSceneItemBaseProperty;
-    /**
-     * @description 更新 Scene 中 Item 的 Property 属性
-     */
-    updateSceneItemPropertyAttribute(scene: spec.JSONScene, itemId: string, propertyName: string, propertyValue: any): void;
-    setSpriteSize(id: string, size: [number, number]): void;
-    transformSceneItem(id: string, property: 'position' | 'rotation' | 'scale', shift: [number, number, number]): void;
-    refreshSDKItem(id: string): void;
-    /**
-     * @description 更新已有 SDKItem 的属性（而不是替换整个对象）
-     * @param sdkItem 需要更新的 SDKItem
-     * @param playerItem 对应的 Player VFXItem
-     */
-    updateSDKItemFromPlayerItem(sdkItem: SDKItem, playerItem: VFXItem): void;
-    getPlayerItemById(id?: string): VFXItem | undefined;
-    getPixelSizeByWorldSize(worldSize: spec.vec3, item: VFXItem): spec.vec2;
-    getWorldSizeByPixelSize(pixelSize: spec.vec2): spec.vec2;
-    /**
-     * @private
-     * @description 获取当前激活的场景
-     */
-    private getActiveTargetScene;
-    /**
-     * @description 获取场景主合成的 previewSize
-     * @param scene 可选，未传时取当前激活视图场景
-     * @returns 主合成的 previewSize；场景/主合成/previewSize 任一不存在时返回 undefined
-     */
-    getSceneSize(scene?: spec.JSONScene): Vector2 | undefined;
-    /**
-     * @private
-     * @description 刷新场景和页面数据
-     */
-    private refreshSceneAndPageData;
-    addSpriteItem(spriteInfo: AsyncSpriteCreateInfo, asyncMode: true, targetScene?: spec.JSONScene): Promise<string>;
-    addSpriteItem(spriteInfo: SpriteCreateInfo, asyncMode: false, targetScene?: spec.JSONScene): Promise<string>;
-    addGroupItem(groupInfo: GroupCreateInfo, targetScene?: spec.JSONScene): string | undefined;
-    addTextItem(textInfo: TextCreateInfo, targetScene?: spec.JSONScene): Promise<string | undefined>;
-    addVideoItem(videoInfo: AsyncVideoCreateInfo, asyncMode: true, targetScene?: spec.JSONScene): Promise<string>;
-    addVideoItem(videoInfo: VideoCreateInfo, asyncMode: false, targetScene?: spec.JSONScene): Promise<string>;
-    /**
-     * @description 添加生成器元素
-     * @param createInfo 生成器创建信息
-     * @param targetScene 目标场景
-     * @returns 元素ID
-     */
-    addGeneratorItem(createInfo: GeneratorCreateInfo, targetScene?: spec.JSONScene): string;
-    /**
-     * @description 设置生成器资源，将生成器转换为对应的元素（SpriteItem 或 VideoItem）
-     * @param id 生成器元素ID
-     * @param resourceUrl 资源地址
-     * @returns 新的元素ID
-     */
-    setGeneratorResource(id: string, resourceUrl: string): Promise<string>;
-    /**
-     * @description 将视频生成器转换为视频元素
-     * @param id 视频生成器元素ID
-     * @param videoUrl 视频资源地址
-     * @returns 新的视频元素ID
-     * @deprecated 使用 setGeneratorResource 替代
-     */
-    convertVideoGeneratorToVideo(id: string, videoUrl: string): Promise<string>;
-    /**
-     * @description 删除元素
-     * @param id 元素id
-     */
-    deleteItem(id: string): void;
-    /**
-     * @description 统一的元素认父函数，根据父节点类型自动选择处理逻辑
-     * @param itemId 子元素ID
-     * @param parentId 父元素ID
-     * @param targetScene 目标场景（可选，默认当前场景）
-     * @returns 是否认父成功
-     */
-    setItemParentUnified(itemId: string, parentId: string, targetScene?: spec.JSONScene): boolean;
-    /**
-     * @description 将元素设置到空节点/组下
-     * @param itemId 子元素ID
-     * @param parentId 父节点ID（必须是空节点/组）
-     * @param targetScene 目标场景
-     * @private
-     */
-    private setItemParentToGroup;
-    /**
-     */
-    setItemParent(id: string, parentId: string, targetScene?: spec.JSONScene): void;
-    deleteItemParent(id: string, parentId: string, targetScene?: spec.JSONScene): void;
-    /**
-     * @description 将元素移动到 Frame 中
-     * @param itemIds 要移动的元素ID列表
-     * @param frameId 目标 Frame ID
-     */
-    moveItemsToFrame(itemIds: string[], frameId: string): void;
-    /**
-     * @description 移动单个元素到 Frame（仅 JSON 层，Player 层在 reLoad 后重建）
-     * @private
-     */
-    private moveSingleJSONItemToFrame;
-    /**
-     * @description 移动单个元素到 Frame（保持 parentId）
-     * @param itemId 元素ID
-     * @param frameItem 目标 Frame
-     * @param options 变换选项
-     * @param mainScene 主场景
-     * @param parentId 要保持的父节点ID
-     * @private
-     */
-    private moveSingleJSONItemToFrameWithParent;
-    /**
-     * @description 收集元素及其所有子元素（递归处理嵌套组）
-     * @param itemIds 初始元素ID列表
-     * @returns 包含所有子元素的ID列表
-     * @private
-     */
-    private collectItemsWithChildren;
-    private moveSinglePlayerItemToFrame;
-    /**
-     * @description 将元素从 Frame 中移出到主场景
-     * @param itemIds 要移动的元素ID列表
-     * @param frameId 源 Frame ID（可选，如果不传则从第一个元素的 parentId 推断）
-     */
-    moveItemsOutOfFrame(itemIds: string[]): void;
-    /**
-     * @description 移动单个元素从 Frame 到主场景（仅 JSON 层）
-     * @private
-     */
-    private moveSingleJSONItemOutOfFrame;
-    private moveSinglePlayerItemOutOfFrame;
-    setItemName(id: string, name: string, targetScene?: spec.JSONScene): void;
-    get undoRedo(): UndoRedo;
-    saveUndoRedoOldData(): void;
-    pushUndoRedoData(): void;
-    getItemCreateInfo(id: string, withParent?: boolean): GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo | FrameCreateInfo | undefined;
-    getChildrenIds(id: string): string[];
-    createScreenShotSceneByIds(idInfo: string | string[]): any;
-    createSceneByCreateInfos(createInfos: ItemCreateInfo[], sceneSize?: spec.vec2, name?: string, scenePosition?: spec.vec2): spec.JSONScene;
-    /**
-     * @description 更新元素在图片中的顺序（仅在同级元素之间）
-     * @param id 元素ID
-     * @param action 排序操作类型
-     */
-    updateItemOrder(id: string, action: ItemOrderAction): void;
-    private isPluginItem;
-    private refreshItemRenderOrder;
-    /**
-     * @description 根据 composition.items 的顺序重新排列 pageData.items
-     * @param composition 当前场景
-     */
-    private syncPageDataItemsOrder;
-    getViewProperty(id?: number): ViewProperty | undefined;
-    viewportFit(shiftParam?: ViewportFitShiftParam, box?: Box2): void;
-    getItemBoxById(idInfo: string): Box2;
-    getItemBoxById(idInfo: string[]): Box2[];
-    setItemFontFamily(id: string, fontFamilyName: string, url: string): Promise<void>;
-    changeItemPropertyByCreateInfo(itemCreateInfo: ItemCreateInfo | ItemCreateInfo[]): Promise<void>;
-    getViewBoxByBox(box: Box2): Box2;
-    playVideoItem(id?: string): void;
-    pauseVideoItem(id?: string): void;
-    playEffectsItem(id?: string): void;
-    pauseEffectsItem(id?: string): void;
-    setEffectsResource(id: string, effects: string): void;
-    /**
-     * @description 根据元素创建信息获取包围盒
-     * @param createInfo 元素创建信息
-     * @returns 包围盒
-     */
-    getBoundingBoxByCreateInfo(createInfo: ItemCreateInfo): Box2;
-    /**
-     * @description 根据元素创建信息组获取包围盒
-     * @param createInfos 元素创建信息组
-     * @returns 包围盒
-     */
-    getBoundingBoxByCreateInfos(createInfos: ItemCreateInfo[]): Box2;
-    getVideoItemPlayTime(id: string): number;
-    setVideoItemPlayTime(id: string, time: number): void;
-    getEffectsItemPlayTime(id: string): number | undefined;
-    setEffectsItemPlayTime(id: string, time: number): void;
-    getPixelPositionByViewPosition(viewPosition: Vector2): Vector2;
-    getItemParentScale(id: string): Vector3;
-    getJSONItem(id: string): spec.VFXItemData | undefined;
-    getJSONComponent(id: string): spec.ComponentData | undefined;
-    getTextOriginSize(id: string): {
-        size: spec.vec2;
-        isPublishScene: boolean;
-    };
-    asyncAddItemByCreateInfos(createInfos: ItemCreateInfo[]): Promise<string[]>;
-    addItemByCreateInfos(createInfos: ItemCreateInfo[]): Promise<string[]>;
-    addEffectsItem(createInfo: EffectsCreateInfo, targetScene?: spec.JSONScene): Promise<string | undefined>;
-    /**
-     * @description 添加画板元素
-     * @param createInfo 画板创建信息
-     * @param targetScene 目标场景
-     * @returns 元素ID
-     */
-    addFrameItem(createInfo: FrameCreateInfo, targetScene?: spec.JSONScene): Promise<string>;
-    makeItemAlign(type: AlignType, ids?: string[]): void;
-    makeItemDistribute(type: DistributeType, ids?: string[]): void;
-    setItemLockState(id: string, state: boolean): void;
-    getItemLockState(id: string): boolean;
-    /**
-     * @description 计算元素在新父节点下保持世界绝对 transform 不变时所需的局部 transform
-     * @param itemId 要移动的元素 ID
-     * @param targetParentVFXItem 目标父 VFXItem（移入 Frame 时为 compositionItem，移出 Frame 时为 composition.rootItem）
-     */
-    getItemTransformUnderParent(itemId: string, targetParentVFXItem: VFXItem): MoveItemTransformOptions | undefined;
-    /**
-     * @description 修改画板元素大小
-     * @param id 元素id
-     * @param size 目标大小 [width, height]
-     * @param translation 位置偏移补偿（可选，用于保持拖拽角点固定）
-     */
-    resizeFrameItem(id: string, size: spec.vec2, translation?: Vector3): void;
-    /**
-     * @description 对 FrameItem 执行自动布局（Shelf 算法）
-     * @param frameId Frame 元素 ID
-     */
-    applyFrameAutoLayout(frameId: string): void;
-    /**
-     * @description 将 layout-utils 的 AutoLayoutResult 结果记录到 layoutInfos
-     * @param frameId Frame 元素 ID
-     * @param layoutResult autoLayout 函数返回的结果
-     */
-    private recordLayoutInfosFromAutoLayoutResult;
-    /**
-     * @description 刷新画板子元素
-     * @param id 画板元素id
-     */
-    refreshFrameChildren(id: string): void;
-    autoLayoutPage(param?: PageAutoLayoutParam): Promise<void>;
-    /**
-     * @description 计算选中元素排布的锚点偏移：保持原始包围盒左上角位置不变
-     * @param layoutElements 参与排布的元素列表
-     * @param layoutBoundingBox 排布算法输出的包围盒
-     */
-    private getPartialLayoutAnchor;
-    /**
-     * @description 计算全量排布的锚点偏移：以视口中心为锚点
-     * @param layoutBoundingBox 排布算法输出的包围盒
-     */
-    private getGlobalLayoutAnchor;
-}
-
-declare class InteractionUtils {
-    /**
-     * @description 交互平面
-     */
-    plane: Plane;
-    /**
-     * @description 交互射线
-     */
-    ray: Ray;
-    /**
-     * @description 交互状态视图信息
-     */
-    viewportParam: ViewInteractionParam;
-    /**
-     * @description 交互状态相机信息
-     */
-    cameraParam: CameraInteractionParam;
-    pageDataUtils: PageDataUtils;
-    constructor(utils: PageDataUtils);
-    refreshViewParam(): void;
-    refreshCameraParam(): void;
-    refrehCameraParamByCameraInfo(camera: any): void;
-    initInteractionPlane(position?: Vector3, rotation?: Euler): void;
-    /**
-     * @description 根据视图空间大小获取空间大小
-     * @param viewSize 视图空间大小
-     * @param isWorld 是否依赖于世界坐标系 - 世界坐标系下，以当前相机锁定平面为基准进行运算；本地坐标系下，以元素坐标系进行运算[用于决定交互平面]
-     * @param targetItem 目标元素
-     */
-    getWorldSizeByViewSize(viewSize: Vector2, isWorld?: boolean, itemId?: string): Vector3;
-    /**
-     * @description 获取 template 模式下视图与场景的缩放比 (viewportWidth / sceneWidth)
-     *              场景未就绪时回退到 1，并打印一次 warning
-     */
-    getTemplateViewScale(): number;
-    getViewSizeByPixelSize(pixelSize: Vector2): Vector2;
-    /**
-     * @description 对空间坐标进行投影
-     * @param point 空间坐标
-     * @param isGestureHandlerView 是否投影到辅助视图下 - 辅助试图与实际视图大小可能会有区别
-     */
-    projectPoint(point: Vector3): Vector2;
-    /**
-     * @description 通过屏幕坐标获取世界坐标
-     * @param point 屏幕坐标
-     * @returns 世界坐标
-     */
-    getWorldPositionByViewPoint(point: Vector2): Vector3 | undefined;
-    getNDCPositionByScreenPosition(point: Vector2): Vector2;
-    getNDCSizeByPixelSize(pixelSize: Vector2): Vector2;
-    getViewPositionWWithOutTransform(point: Vector2): Vector2;
-    getViewPositionByPixelPoint(point: Vector2): Vector2;
-    getPixelPositionByViewPoint(point: Vector2): Vector2;
-    getPixelSizeByWorldSize(worldSize: Vector3): Vector2;
-    getPixelSizeByNDCSize(ndcSize: Vector2): Vector2;
-    getPixelSizeByViewSize(viewSize: Vector2): Vector2;
-}
-
-/**
- * @description 自动布局指示器数据
- */
-type AutoLayoutIndicator = {
-    frameId: string;
-    insertIndex: number;
-    insertDirection: 'before' | 'after';
-    targetSiblingId?: string;
-    line: Line2;
-    targetRow?: number;
-    targetColumn?: number;
-} | null;
-/**
- * @description 布局位置信息
- */
-type LayoutPosition = {
-    row: number;
-    column: number;
-};
-/**
- * @description 插入位置信息
- */
-type InsertPosition = {
-    index: number;
-    direction: 'before' | 'after';
-    siblingId?: string;
-    row: number;
-    column: number;
-    rowChange?: {
-        fromRow: number;
-        toRow: number;
-        rowBounds?: {
-            minY: number;
-            maxY: number;
-            minX: number;
-            maxX: number;
-        };
-        isRowChange: boolean;
-    };
-};
-/**
- * @description 兄弟元素布局信息
- */
-type SiblingWithInfo = {
-    item: SDKItem;
-    box: Box2;
-    row: number;
-    column: number;
-    centerX: number;
-};
-/**
- * @description 布局元素信息
- */
-type LayoutItem = {
-    id: string;
-    box: Box2;
-    row?: number;
-    column?: number;
-};
-/**
- * @description 布局结果项
- */
-type LayoutResultItem = {
-    id: string;
-    position: [number, number];
-    row: number;
-    column: number;
-};
-/**
- * @description 自动排布配置
- */
-type AutoLayoutOptions = {
-    padding?: number;
-    gap?: number;
-    config?: AutoLayoutConfig;
-};
-/**
- * @description 自动排布结果
- */
-type AutoLayoutResult = {
-    items: LayoutResultItem[];
-    size: [number, number];
-};
-/**
- * @description 全局自适应排布元素
- */
-type LayoutElement = {
-    id: string;
-    box: Box2;
-};
-/**
- * @description 全局自适应排布结果
- */
-type GlobalAutoLayoutResult = {
-    items: {
-        id: string;
-        position: [number, number];
-    }[];
-    boundingBox: Box2;
-};
-/**
- * @description 全局自适应排布配置
- */
-type GlobalAutoLayoutOptions = {
-    /**
-     * @description 元素间隔（默认10）
-     */
-    gap?: number;
-    /**
-     * @description 目标宽高比（默认1:1正方形）
-     */
-    targetAspectRatio?: number;
-    /**
-     * @description 排布模式
-     * - 'adaptive': 基于元素包围盒自适应排布（MaxRects算法，更紧凑）
-     * - 'ordered': 基于元素顺序的行列排布（保持输入顺序，流式行排布，行优先）
-     */
-    mode?: GlobalLayoutMode;
-};
-/**
- * @description 全局自适应排布模式
- */
-type GlobalLayoutMode = 'adaptive' | 'ordered';
-/**
- * @description 自动排布函数
- * 根据元素信息中的行列数参数进行排布：
- * - 如果元素有 row/column，则按指定行列排布
- * - 如果元素没有 row/column，则使用 Shelf 算法自动生成行列数，再排布
- *
- * @param canvasBox 画布范围（Box2），min为左上角，max为右下角
- * @param items 元素信息列表（包含 ID、Box2、可选的 row/column）
- * @param options 可选配置（padding, gap）
- * @returns 各元素的位置信息和整体尺寸
- */
-declare function autoLayout(items: LayoutItem[], options?: AutoLayoutOptions): AutoLayoutResult;
-/**
- * @description 计算元素到目标位置的位移
- * @param currentPosition 当前位置 [x, y]
- * @param targetPosition 目标位置 [x, y]
- * @returns 位移向量 [dx, dy]
- */
-declare function calculateDisplacement(currentPosition: [number, number], targetPosition: [number, number]): [number, number];
-/**
- * @description 为 autoLayout 结果计算位移信息
- * @param items 元素列表（包含当前位置）
- * @param layoutResult autoLayout 的返回结果
- * @returns 每个元素的位移信息
- */
-declare function calculateLayoutDisplacements(items: {
-    id: string;
-    currentPosition: [number, number];
-}[], layoutResult: AutoLayoutResult): {
-    id: string;
-    displacement: [number, number];
-    targetPosition: [number, number];
-}[];
-/**
- * @description 计算自动布局指示线位置
- * @param position 插入位置信息
- * @param getViewBoxById 获取元素包围盒的函数
- * @returns 主指示线
- */
-declare function calculateAutoLayoutIndicatorLine(position: InsertPosition, getViewBoxById: (id: string) => Box2): Line2;
-/**
- * @description 基于鼠标位置计算布局位置（row 和 column）
- * @param mousePoint 鼠标位置
- * @param allItems 所有子元素
- * @param getViewBoxById 获取元素包围盒的函数
- * @param getLayoutInfo 获取元素布局信息的函数
- * @param excludeItemId 需要排除的元素ID（被拖拽的元素）
- * @returns 布局位置信息 { row: number, column: number }
- */
-declare function calculateAutoLayoutPositionByMouse(mousePoint: Vector2, allItems: SDKItem[], getViewBoxById: (id: string) => Box2, getLayoutInfo: (item: SDKItem) => LayoutInfo | undefined, excludeItemId: string): LayoutPosition | null;
-/**
- * @description 基于鼠标位置计算插入位置（用于显示指示器）
- * @param mousePoint 鼠标位置
- * @param allItems 所有子元素
- * @param excludeItemId 需要排除的元素ID（被拖拽的元素）
- * @param parent 父画板
- * @param originalRow 原始行号
- * @param getSelectedItemsBox 获取选中项包围盒的函数
- * @returns 插入位置信息和计算出的行列位置
- */
-declare function calculateInsertPositionFromLayout(mousePoint: Vector2, allItems: SDKItem[], excludeItemId: string, parent: FrameItem, originalRow: number, getViewBoxById: (id: string) => Box2, getSelectedItemsBox: () => Box2): InsertPosition;
-/**
- * @description 更新元素的 layoutInfo
- * @param item 要更新的元素
- * @param parent 父画板
- * @param layoutPosition 新的布局位置
- */
-declare function updateItemLayoutInfo(item: SDKItem, parent: FrameItem, layoutPosition: LayoutPosition): void;
-/**
- * @description 全局自适应排布
- * 支持两种模式：
- * 1. 'adaptive'（默认）: 基于元素包围盒自适应排布（MaxRects算法，更紧凑）
- * 2. 'ordered': 基于元素顺序的流式行排布（保持输入顺序，每行尽可能多放元素）
- *
- * @param elements 元素列表（包含ID和包围盒）
- * @param options 配置选项
- * @returns 各元素位置和整体包围盒
- */
-declare function globalAutoLayout(elements: LayoutElement[], options?: GlobalAutoLayoutOptions): GlobalAutoLayoutResult;
-/**
- * @description 调整其他元素的行列信息
- * 当被拖拽元素移动到新位置时，需要调整其他受影响的元素：
- * 1. 同行内移动：原位置到新位置之间的元素需要相应调整列号
- * 2. 跨行移动：原行中后面的元素前移，目标行中后面的元素后移
- * @param parent 父画板
- * @param draggedItemId 被拖拽的元素ID
- * @param fromRow 原始行号
- * @param fromColumn 原始列号
- * @param toRow 目标行号
- * @param toColumn 目标列号
- */
-declare function adjustOtherElementsLayoutInfo(parent: FrameItem, draggedItemId: string, fromRow: number, fromColumn: number, toRow: number, toColumn: number, getSDKItem: (id: string) => SDKItem | undefined): void;
-
-declare class DefaultVFXItems {
-    static createEmpty(composition: Composition, parent?: null, name?: string): VFXItem;
-    static createSprite(composition: Composition, parent?: null, name?: string): VFXItem;
-    static createText(composition: Composition, parent?: null, name?: string): VFXItem;
-    static createVideo(composition: Composition, parent?: null, name?: string): VFXItem;
-    static createEffects(composition: Composition, effects: string | spec.JSONScene, parent?: null, urlname?: string): Promise<VFXItem>;
-}
-declare class VFXItemFactory {
-    static createVFXItem(composition: Composition, parent?: null, name?: string, ...types: Constructor<Component>[]): VFXItem;
-}
-
-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 描边开关
-     */
-    outlineEnabled?: boolean;
-    /**
-     * @description 文本字间距
-     */
-    letterSpacing?: number;
-    fontUrl?: string;
-};
-type VideoItemProperty = BaseItemProperty & {
-    video: string;
-    /**
-   * @description 是否静音
-   */
-    muted?: boolean;
-    /**
-     * @description 是否为透明视频
-     */
-    transparent?: boolean;
-    /**
-     * @description 播放速率
-     */
-    playbackRate?: number;
-    /**
-     * @description 音量
-     */
-    volume?: number;
-};
-/**
- * @description Generator 表单属性
- */
-type GeneratorItemProperty = BaseItemProperty & {
-    /**
-     * @description 生成器类型
-     */
-    generatorType: 'image' | 'video';
-};
-type EffectsItemProperty = BaseItemProperty & {
-    effects: string;
-    children?: string[];
-};
-/**
- * @description Frame 画板元素布局模式
- */
-declare enum FrameLayoutMode {
-    AUTO = "auto",
-    FREE = "free"
-}
-/**
- * @description 自动布局配置
- */
-type AutoLayoutConfig = {
-    /**
-     * @description 单行最大宽度（像素），超过后自动换行。未设置时不限制
-     */
-    maxRowWidth?: number;
-    /**
-     * @description 最大行数限制。未设置时不限制
-     */
-    maxRowCount?: number;
-};
-/**
- * @description 元素在自动布局中的位置信息
- */
-type LayoutInfo = {
-    /**
-     * @description 所在行号（可为小数）
-     * 整数部分：主行号（0, 1, 2...）
-     * 小数部分：分行后的子行号（如 1.5 表示第1行的第5个子行）
-     * 仅支持两层（即小数部分为 0-9）
-     */
-    row: number;
-    /**
-     * @description 所在列号（必须为整数）
-     */
-    column: number;
-    /**
-     * @description 元素在布局中的位置（相对于画板左上角，可选）
-     */
-    position?: [number, number];
-};
-/**
- * @description Frame 画板元素属性
- */
-type FrameItemProperty = BaseItemProperty & {
-    /**
-     * @description 布局模式: auto - 自动布局, free - 自由布局
-     */
-    layoutMode: FrameLayoutMode;
-    /**
-     * @description 子元素ID数组
-     */
-    children: string[];
-    /**
-     * @description 自动布局配置
-     */
-    autoLayoutConfig?: AutoLayoutConfig;
-    /**
-     * @description 子元素布局位置信息（用于自动布局）
-     * key: 子元素ID, value: 元素的位置信息
-     */
-    layoutInfos?: Record<string, LayoutInfo>;
-};
-/**
- * @description BaseItem 基础属性键名
- */
-type BaseItemPropertyKey = 'name' | 'duration' | 'delay' | 'endBehavior' | 'visible' | 'isLocked' | 'parentId';
-/**
- * @description BaseItem 基础属性值类型映射
- */
-type BaseItemPropertyValueMap = {
-    name: string;
-    duration: number;
-    delay: number;
-    endBehavior: spec.EndBehavior;
-    visible: boolean;
-    isLocked: boolean;
-    parentId?: string;
-};
-/**
- * @description Item 类型与 Property 类型的映射
- */
-type ItemPropertyMap = {
-    [SDKItemType.SPRITE]: SpriteItemProperty;
-    [SDKItemType.TEXT]: TextItemProperty;
-    [SDKItemType.VIDEO]: VideoItemProperty;
-    [SDKItemType.GROUP]: GroupItemProperty;
-    [SDKItemType.GENERATOR]: GeneratorItemProperty;
-    [SDKItemType.EFFECTS]: EffectsItemProperty;
-    [SDKItemType.FRAME]: FrameItemProperty;
-};
-/**
- * @description 场景1：单个元素单个属性设置
- * 支持设置 BaseItem 基础属性或具体 Item 类型的 property 属性
- */
-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 场景2：单个元素多个属性设置
- * 同时设置多个 BaseItem 属性或 property 属性
- */
-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 设置元素属性的统一参数类型
- * 支持两种场景：单元素单属性、单元素多属性
- */
-type SetItemPropertyParam<T extends SDKItemType = SDKItemType> = SetSingleItemSinglePropertyParam<T> | SetSingleItemMultiplePropertiesParam<T>;
-type SDKOptions = {
-    /** 导出视频时，是否开启转码日志 */
-    loggerInExportVideoTranscoding?: boolean;
-};
-type SDKInputParam = SDKTemplateInputParam | SDKEditorInputParam;
-/**
- * @description SDK入参
- */
-type SDKTemplateInputParam = {
-    /**
-     * @description JSON地址
-     */
-    scene: string | spec.JSONScene;
-    /**
-     * @description SDK模式 - 模板编辑模式
-     */
-    mode: 'template';
-    /**
-     * @description 视图参数
-     */
-    viewParams?: ViewParam[];
-    /**
-     * @description 页面属性
-     */
-    options: PageOptions;
-};
-type SDKEditorInputParam = {
-    /**
-     * @description SDK模式 - 编辑器模式
-     */
-    mode: 'editor';
-};
-/**
- * @description 页面属性
- */
-type PageOptions = {
-    /**
-     * @description 同步模式开关
-     */
-    asyncMode: boolean;
-    /**
-     * @description 安全区展示开关
-     */
-    safeAreaPreview: boolean;
-    /**
-     * @description 吸附开关
-     */
-    adsorption: boolean;
-};
-/**
- * @description 页面数据
- */
-type PageData = {
-    /**
-     * @description 基础场景数据
-     */
-    scene: spec.JSONScene;
-    /**
-     * @description 页面属性
-     */
-    property: PageProperty;
-    /**
-     * @description 视图属性
-     */
-    viewProperties: ViewProperty[];
-    /**
-     * @description 活跃数据
-     */
-    activeData: ActiveData;
-    /**
-     * @description 元素数据
-     */
-    items: SDKItem[];
-    /**
-     * @description 视图当前时间
-     */
-    time: number;
-    /**
-     * @description 是否处于播放态
-     */
-    playing: boolean;
-};
-/**
- * @description 页面自动布局参数
- */
-type PageAutoLayoutParam = {
-    /**
-     * @description 自动布局模式
-     */
-    mode?: GlobalLayoutMode;
-    /**
-     * @description 选中元素【无输入值时，页面内所有元素排布】
-     * 如果是选中元素自动排布，则保证包围盒左上角点位置相同
-     */
-    ids?: string[];
-    /**
-     * @description 排布后是否聚焦元素，默认开启
-     */
-    focus?: boolean;
-    /**
-     * @description 自动布局间隔
-     */
-    gap?: number;
-};
-/**
- * @description 页面配置
- */
-type PageConfig = {
-    /**
-     * @description 出血区域展示开关
-     */
-    safeAreaPreview: boolean;
-    /**
-     * @description 缩放值
-     */
-    zoom: number;
-    /**
-     * @description 吸附开关
-     */
-    adsorption: boolean;
-    /**
-     * @description 同步开关
-     */
-    asyncMode: boolean;
-    /**
-     * @description 画布移动
-     */
-    translation: spec.vec2;
-};
-/**
- * @description 页面属性
- */
-type PageProperty = {
-    /**
-     * @description 出血区域展示开关
-     */
-    safeAreaPreview: boolean;
-    /**
-     * @description 缩放值
-     */
-    zoom: number;
-    /**
-     * @description 偏移值
-     */
-    translation: [number, number];
-    /**
-     * @description 吸附开关
-     */
-    adsorption: boolean;
-    /**
-     * @description 同步开关
-     */
-    asyncMode: boolean;
-};
-/**
- * @description 视图创建参数
- */
-type ViewParam = {
-    /**
-     * @description 页面尺寸
-     */
-    size?: [number, number];
-    /**
-     * @description 出血区参数
-     */
-    safeArea?: [number, number, number, number];
-    /**
-     * @description 自适应方向 - 默认根据视图宽高决定
-     */
-    adaptionDirection?: SizeAdaptDirection;
-    /**
-     * @description 自定义出血区 - 用于展示
-     */
-    previewSafeAreas?: PreviewSafeAreaParam[];
-    /**
-     * @description 导出参数
-     */
-    export: ExportParam;
-};
-/**
- * @description 导出参数
- */
-type ExportParam = {
-    /**
-     * @description 视频名称
-     */
-    name?: string;
-} & Omit<ExportMediaItemOptions, 'scene' | 'size'>;
-/**
- * @description 视图属性
- */
-type ViewProperty = {
-    /**
-     * @description 视图ID
-     */
-    id: number;
-    /**
-     * @description 视图宽高
-     */
-    size: [number, number];
-    /**
-     * @description 出血区数据
-     */
-    safeArea: [number, number, number, number];
-    /**
-     * @description 自定义出血区数据
-     */
-    previewSafeAreas: PreviewSafeAreaParam[];
-    /**
-     * @description 视图场景数据
-     */
-    scene: spec.JSONScene;
-    /**
-     * @description 导出参数
-     */
-    export: ExportParam;
-    /**
-     * @description 忽略交互 - 仅供展示
-     */
-    ignoreInteraction: boolean;
-};
-/**
- * @description 自定义出血区数据
- */
-type PreviewSafeAreaParam = {
-    /**
-     * @description 出血区包围盒 [left top width height]
-     */
-    box: [number, number, number, number];
-    /**
-     * @description 出血区色块颜色 默认为 [255, 255, 255, 0.3]
-     */
-    color?: [number, number, number, number];
-    /**
-     * @description 出血区图像
-     */
-    url?: string;
-    /**
-     * @description 出血区是否可见
-     */
-    visible?: boolean;
-};
-/**
- * @description 页面活跃数据
- */
-type ActiveData = {
-    /**
-     * @description 视图ID
-     */
-    view?: number;
-    /**
-     * @description 选中元素
-     */
-    selectedItems: string[];
-    /**
-     * @description 预选中元素
-     */
-    preSelectedItem?: string;
-    /**
-     * @description 执行中元素
-     */
-    loadingItems?: string[];
-};
-type SDKBackgroundType = 'color' | 'image' | 'chess-board' | 'dot-board';
-/**
- * @description 图层创建信息
- */
-type SpriteCreateInfo = {
-    type: SDKItemType.SPRITE;
-    /**
-     * @description 图层名称
-     */
-    name?: string;
-    /**
-     * @description 元素id
-     */
-    id?: string;
-    /**
-     * @description 父节点id
-     */
-    parentId?: string;
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-    /**
-     * @description 元素属性
-     */
-    property: {
-        /**
-         * @description 图片资源地址 | 数据
-         */
-        image?: string;
-        /**
-         * @description 图层像素宽度
-         */
-        width: number;
-        /**
-         * @description 图层像素高度
-         */
-        height: number;
-        /**
-         * @description 元素位置
-         */
-        position: [number, number];
-        /**
-         * @description 元素旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 元素缩放
-         */
-        scale?: [number, number];
-    };
-};
-/**
- * @description 组 元素创建信息
- */
-type GroupCreateInfo = {
-    type: SDKItemType.GROUP;
-    /**
-     * @description 元素id
-     */
-    id?: string;
-    /**
-     * @description 父节点id
-     */
-    parentId?: string;
-    /**
-     * @description 元素名称
-     */
-    name?: string;
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-    /**
-     * @description 元素属性
-     */
-    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 元素id
-     */
-    id?: string;
-    /**
-     * @description 父节点id
-     */
-    parentId?: string;
-    /**
-     * @description 元素名称
-     */
-    name?: string;
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-    /**
-     * @description 元素属性
-     */
-    property: {
-        /**
-         * @description 文本宽度
-         */
-        width: number;
-        /**
-         * @description 文本高度
-         */
-        height?: number;
-        /**
-         * @description 元素位置
-         */
-        position: [number, number];
-        /**
-         * @description 元素旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 元素缩放
-         */
-        scale?: [number, number];
-        /**
-         * @description 单行高度
-         */
-        lineHeight: number;
-        /**
-         * @description 字体名称
-         */
-        fontFamily: string;
-        /**
-         * @description 文字大小
-         */
-        fontSize: number;
-        /**
-         * @description 字重
-         */
-        fontWeight?: spec.TextWeight;
-        /**
-         * @description 字体格式
-         */
-        fontStyle?: spec.FontStyle;
-        /**
-         * @description 对齐方式
-         */
-        textAlign?: spec.TextAlignment;
-        /**
-         * @description 文本信息
-         */
-        text: string;
-        /**
-         * @description 填充色
-         */
-        color: spec.vec4;
-        /**
-         * @description 描边色
-         */
-        outlineColor?: spec.vec4;
-        /**
-         * @description 描边宽度
-         */
-        outlineWidth?: number;
-        /**
-         * @description 描边开关
-         */
-        outlineEnabled?: boolean;
-        /**
-         * @description 字体文件地址
-         */
-        fontUrl?: string;
-        /**
-         * @description 文本字间距
-         */
-        letterSpacing?: number;
-    };
-};
-/**
- * @description 视频创建信息
- */
-type VideoCreateInfo = {
-    type: SDKItemType.VIDEO;
-    /**
-     * @description 视频名称
-     */
-    name?: string;
-    /**
-     * @description 元素id
-     */
-    id?: string;
-    /**
-     * @description 父节点id
-     */
-    parentId?: string;
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-    /**
-     * @description 元素属性
-     */
-    property: {
-        /**
-         * @description 视频资源地址 | 数据
-         */
-        video?: string;
-        /**
-         * @description 视频元素像素宽度
-         */
-        width: number;
-        /**
-         * @description 视频元素像素高度
-         */
-        height: number;
-        /**
-         * @description 视频元素位置
-         */
-        position: [number, number];
-        /**
-         * @description 视频元素旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 视频元素缩放
-         */
-        scale?: [number, number];
-        /**
-         * @description 是否静音
-         */
-        muted?: boolean;
-        /**
-         * @description 是否为透明视频
-         */
-        transparent?: boolean;
-        /**
-         * @description 播放速率
-         */
-        playbackRate?: number;
-        /**
-         * @description 音量
-         */
-        volume?: number;
-    };
-};
-/**
- * @description 生成器类型
- */
-type GeneratorType = 'image' | 'video';
-/**
- * @description 生成器创建信息
- */
-type GeneratorCreateInfo = {
-    /**
-     * @description 元素类型 - 生成器
-     */
-    type: SDKItemType.GENERATOR;
-    /**
-     * @description 元素名称
-     */
-    name?: string;
-    /**
-     * @description 元素id
-     */
-    id?: string;
-    /**
-     * @description 父元素id
-     */
-    parentId?: string;
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-    /**
-     * @description 元素属性
-     */
-    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 资源地址
-     */
-    url: string;
-    /**
-     * @description 资源尺寸
-     */
-    size?: spec.vec2;
-    /**
-     * @description 目标生成器元素 ID（必填）
-     */
-    itemId: string;
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-};
-/**
- * @description 视频生成器资源信息
- */
-type VideoGeneratorResource = {
-    /**
-     * @description 资源地址
-     */
-    url: string;
-    /**
-     * @description 资源尺寸
-     */
-    size?: spec.vec2;
-    /**
-     * @description 是否静音（仅用于视频）
-     */
-    muted?: boolean;
-    /**
-     * @description 是否为透明视频（仅用于视频）
-     */
-    transparent?: boolean;
-    /**
-     * @description 播放速率（仅用于视频）
-     */
-    playbackRate?: number;
-    /**
-     * @description 音量（仅用于视频）
-     */
-    volume?: number;
-    /**
-     * @description 目标生成器元素 ID（必填）
-     */
-    itemId: string;
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-};
-type GeneratorResource = SpriteGeneratorResource | VideoGeneratorResource;
-type EffectsCreateInfo = {
-    /**
-     * @description 元素类型 - 特效
-     */
-    type: SDKItemType.EFFECTS;
-    /**
-     * @description 元素名称
-     */
-    name?: string;
-    /**
-     * @description 元素id
-     */
-    id?: string;
-    /**
-     * @description 父元素id
-     */
-    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;
-    };
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-};
-type AsyncSpriteCreateInfo = SpriteCreateInfo & {
-    textureId: string;
-};
-type AsyncVideoCreateInfo = VideoCreateInfo & {
-    textureId: string;
-};
-/**
- * @description Frame 画板元素创建信息
- */
-type FrameCreateInfo = {
-    /**
-     * @description 元素类型 - 画板
-     */
-    type: SDKItemType.FRAME;
-    /**
-     * @description 元素名称
-     */
-    name?: string;
-    /**
-     * @description 元素id
-     */
-    id?: string;
-    /**
-     * @description 父元素id
-     */
-    parentId?: string;
-    /**
-     * @description 元素属性
-     */
-    property: {
-        /**
-         * @description 画板像素宽度
-         */
-        width: number;
-        /**
-         * @description 画板像素高度
-         */
-        height: number;
-        /**
-         * @description 画板位置
-         */
-        position: [number, number];
-        /**
-         * @description 画板旋转 z | [x, y, z]
-         */
-        rotation?: number | [number, number, number];
-        /**
-         * @description 画板缩放
-         */
-        scale?: [number, number];
-        /**
-         * @description 布局模式: 'auto' | 'free'
-         */
-        layoutMode?: FrameLayoutMode;
-        /**
-         * @description 子元素序号
-         */
-        children: string[];
-        /**
-         * @description 自动布局配置
-         */
-        autoLayoutConfig?: AutoLayoutConfig;
-        /**
-         * @description 子元素布局位置信息（用于自动布局）
-         * key: 子元素ID, value: 元素的位置信息
-         */
-        layoutInfos?: Record<string, LayoutInfo>;
-    };
-    /**
-     * @description 扩展属性
-     */
-    extension?: Record<string, any>;
-};
-type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo | FrameCreateInfo;
-/**
- * @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 AlignType, type AutoLayoutIndicator, type AutoLayoutOptions, type AutoLayoutResult, type BackgroundGridConfig, BackgroundManager, type BackgroundPreset, BaseItem, type BaseItemProperty, type BaseItemPropertyKey, type BaseItemPropertyValueMap, Box2, type CameraInteractionParam, type CreateOperation, DefaultVFXItems, type DeleteOperation, type DistributeType, type EffectsCreateInfo, EffectsItem, type EffectsItemOptions, type FrameCreateInfo, FrameItem, type FrameItemOptions, type FrameItemProperty, FrameLayoutMode, type GeneratorCreateInfo, GeneratorItem, type GeneratorItemOptions, type GeneratorItemProperty, type GizmoType, type GlobalAutoLayoutOptions, type GlobalAutoLayoutResult, type GlobalLayoutMode, type GroupCreateInfo, GroupItem, type GroupItemOptions, type InsertPosition, InteractionUtils, type ItemCreateInfo, type ItemJSONInfo, ItemOrderAction, type ItemPropertyMap, type LayoutElement, type LayoutItem, type LayoutPosition, type LayoutResultItem, type MoveItemTransformOptions, type Operation, type PageData, PageDataUtils, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKItem, type SDKItemOptions, SDKItemType, type SDKOptions, SafeConstraint, type SetItemPropertyParam, type SetSingleItemMultiplePropertiesParam, type SetSingleItemSinglePropertyParam, type SiblingWithInfo, type SpriteCreateInfo, SpriteItem, type SpriteItemOptions, type SpriteItemProperty, type TextCreateInfo, TextItem, type TextItemOptions, type TextItemProperty, type UpdateOperation, VFXItemFactory, Vector2, type VideoCreateInfo, VideoItem, type VideoItemOptions, type VideoItemProperty, type ViewInteractionParam, type ViewParam, type ViewProperty, addCompositionItemByComposition, addItemInfoToScene, adjustOtherElementsLayoutInfo, arrAdd, assertExist, asserts, autoLayout, calculateAutoLayoutIndicatorLine, calculateAutoLayoutPositionByMouse, calculateDisplacement, calculateInsertPositionFromLayout, calculateLayoutDisplacements, clearItemParentInfo, createCompositionItemJSON, createFrameCompositionScene, createNullItemJSON, createSDKItem, createSpriteItemJSON, createTextItemJSON, createVideoGeneratorItemJSON, createVideoItemJSON, deepClone, deepEquals, deleteCompositionFromScene, deleteCompositionItemFromScene, deleteItemInfoFromScene, downloadBlob, extractSubCompositionToScene, fixStandardJSON, getBasicScene, getColorByNormalizeColor, getCompositionDataByRefCompositionItemId, getCompositionIdByRefCompositionItemId, getNormalizeColorByColor, getTextureUrlById, getTransformRatioByViewAndCamera, getUniqueName, globalAutoLayout, isBaseItem, isEffectsItem, isEqual, isFrameItem, isGeneratorItem, isGroupItem, isObj, isSpriteItem, isTextItem, isVideoItem, loadScriptAsync, logger, moveItemBetweenCompositions, removeItemInfoFromScene, resetSubCompositionItemId, setItemJSONParentId, setJSONItemName, updateItemLayoutInfo };