@vvfx/sdk 0.1.19-alpha.0 → 0.1.19-alpha.10

package/dist/index.d.cts

@@ -1,194 +1,678 @@
 import * as _galacean_effects from '@galacean/effects';
-import { spec, math, Player } from '@galacean/effects';
+import { math, spec, Player } from '@galacean/effects';
 export { generateGUID, spec } from '@galacean/effects';
 import { Point } from '@pixi/constants';
 
 /**
- * @description SDKItem 基础选项接口
- * @description 支持扩展属性，允许添加任意额外属性
+ * @class 二维线段
  */
-type SDKItemOptions = {
+declare class Line2 {
+    start: Vector2;
+    end: Vector2;
+    constructor(start?: Vector2, end?: Vector2);
     /**
-     * @description 元素ID
+     * 设置二维线段
+     * @param {Vector2} start 线段起点
+     * @param {Vector2} end 线段终点
+     * @returns {Line2} 二维线段
      */
-    id: string;
+    set(start: Vector2, end: Vector2): this;
     /**
-     * @description 元素名称
+     * 复制二维线段
+     * @param {Line2} line 复制对象
+     * @returns {Line2} 复制结果
      */
-    name: string;
+    copyFrom(line: Line2): this;
     /**
-     * @description 父节点ID
+     * 二维线段求方向
+     * @returns {Vector2} 二维线段方向
      */
-    parentId?: string;
+    direction(): Vector2;
     /**
-     * @description 子元素ID列表
+     * 二维线段求中点
+     * @param {Vector2} [target=new Vector2()] 目标保存对象
+     * @returns {Vector2} 二维线段中点
      */
-    children?: string[];
+    getCenter(target?: Vector2): Vector2;
     /**
-     * @description 元素生命周期
+     * 二维线段向量值
+     * @param {Vector2} [target=new Vector2()] 目标保存对象
+     * @returns {Vector2} 二维线段向量值
      */
-    duration?: number;
+    delta(target?: Vector2): Vector2;
     /**
-     * @description 元素生命周期延时
+     * 二维线段欧式距离平方(应用于计算)
+     * @returns {number} 计算结果
      */
-    delay?: number;
+    distanceSq(): number;
     /**
-     * @description 可视状态
+     * 二维线段欧式距离
+     * @returns {number} 计算结果
      */
-    visible?: boolean;
+    distance(): number;
     /**
-     * @description 元素结束行为
+     * 求二维线段比例点
+     * @param {number} t 比例值
+     * @param {Vector2} target 目标保存对象
+     * @returns {Vector2} 比例点结果
      */
-    endBehavior?: spec.EndBehavior;
+    at(t: number, target?: Vector2): Vector2;
     /**
-     * @description 是否处于锁定状态
+     * 求点与线段的最短距离
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} clampToLine 是否限制于线段内
+     * @returns {number} 距离结果
      */
-    isLocked?: boolean;
+    closestPointToPointParameter(point: Vector2, clampToLine: boolean): number;
     /**
-     * @description 关键属性是否可编辑
+     * 求点与线段的最近交点
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} clampToLine 是否限制于线段内
+     * @param {Vector2} target 目标保存对象
+     * @returns {Vector2} 最近交点
      */
-    isCoreEditable: boolean;
+    closestPointToPoint(point: Vector2, clampToLine: boolean, target?: Vector2): Vector2;
     /**
-     * @description 扩展属性存储（属性名 -> 属性值）
+     * 二维线段判等
+     * @param {Line2} line 二维线段
+     * @returns {boolean} 判等结果
      */
-    extension?: Record<string, any>;
+    equals(line: Line2): boolean;
     /**
-     * @description 允许任意额外属性（用于兼容旧代码）
+     * 克隆二维线段
+     * @returns {Line2} 克隆结果
      */
-    [extraProp: string]: any;
-};
-/**
- * @description Sprite SDKItem 选项
- */
-type SpriteItemOptions = SDKItemOptions & {
+    clone(): Line2;
     /**
-     * @description 元素属性
+     * 二维线段求长度
+     * @returns {number} 长度
      */
-    property?: Partial<SpriteItemProperty>;
-};
-/**
- * @description Text SDKItem 选项
- */
-type TextItemOptions = SDKItemOptions & {
+    length(): number;
     /**
-     * @description 元素属性
+     * 二维线段判断相交
+     * @param {Line2} other 二维线段
+     * @returns {boolean} 相交判断结果
      */
-    property?: Partial<TextItemProperty>;
-};
-/**
- * @description Video SDKItem 选项
- */
-type VideoItemOptions = SDKItemOptions & {
+    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;
     /**
-     * @description 元素属性
+     * 点到直线的最短距离
+     * @returns {{d: number, t: number}} d表示距离，t表示最近点在直线的比例
      */
-    property?: Partial<VideoItemProperty>;
-};
-/**
- * @description Group SDKItem 选项（空节点/组）
- */
-type GroupItemOptions = SDKItemOptions & {
+    distanceToLine(line: Line2): {
+        d: number;
+        t: number;
+    };
     /**
-     * @description 元素属性
+     * 二维向量与x轴夹角
+     * @returns {number} 弧度值
      */
-    property?: Partial<GroupItemProperty>;
-};
-/**
- * @description Generator SDKItem 选项（资源生成器）
- * @description 支持 image 和 video 两种生成器类型
- * @description 使用 GeneratorItemProperty 包含 generatorType
- */
-type GeneratorItemOptions = SDKItemOptions & {
+    angle(): number;
     /**
-     * @description 元素属性（包含 generatorType）
+     * 二维点绕点旋转
+     * @param {Vec2} center 旋转中心
+     * @param {number} angle 旋转角度
+     * @returns {Vec2} 旋转结果
      */
-    property?: Partial<GeneratorItemProperty>;
-};
-type EffectsItemOptions = SDKItemOptions & {
-    property?: Partial<EffectsItemProperty>;
-};
-/**
- * @description SDKItem 类型（独立于 spec.ItemType）
- * @description 包含所有 SDK 层级的元素类型，包括虚拟类型如 generator
- */
-declare enum SDKItemType {
-    SPRITE = "sprite",
-    TEXT = "text",
-    VIDEO = "video",
-    GROUP = "group",
-    GENERATOR = "generator",
-    EFFECTS = "effects",
-    FRAME = "frame"
+    rotateAround(center: Vector2, angle: number): this;
 }
 
 /**
- * @description SDKItem 抽象基类
- * @description 支持属性扩展，允许添加任意自定义属性
+ * @class 二维包围盒
  */
-declare abstract class BaseItem {
+declare class Box2 {
     /**
-     * @description 元素ID
+     * @member {Vector2[]} corners 二维包围盒角点
      */
-    id: string;
+    corners: Vector2[];
+    min: Vector2;
+    max: Vector2;
     /**
-     * @description 元素名称
+     * 构造函数，传入值为空时表示空包围盒
+     * @param {Vector2} [min=new Vector2(Infinity, Infinity)] 最小点
+     * @param {Vector2} [max=new Vector2(-Infinity, -Infinity)] 最大点
      */
-    name: string;
+    constructor(min?: Vector2, max?: Vector2);
     /**
-     * @description 父节点ID
+     * 通过最大最小点设置二维包围盒
+     * @param {Vector2} min 最小点
+     * @param {Vector2} max 最大点
+     * @returns {Box2} 二维包围盒
      */
-    parentId?: string;
+    set(min: Vector2, max: Vector2): this;
     /**
-     * @description 元素生命周期
+     * 通过角点设置二维包围盒
+     * @param {Vector2[]} vecArray 二维空间点数组
+     * @returns {Box2} 二维包围盒
      */
-    duration: number;
+    setFromVec2Array(vecArray: Vector2[]): this;
     /**
-     * @description 元素生命周期延时
+     * 通过屏幕坐标点设置二维包围盒 - 点为屏幕坐标点，x正方向为右，y正方向为向上
+     * @param vecArray 屏幕坐标点
      */
-    delay: number;
+    setFromVec2ArrayWithOutCorners(vecArray: Vector2[]): this;
     /**
-     * @description 元素结束行为
+     * 通过中心与大小设置二维包围盒
+     * @param {Vector2} center 二维中心点
+     * @param {Vector2} size 二维大小
+     * @returns {Box2} 二维包围盒
      */
-    endBehavior: spec.EndBehavior;
+    setFromCenterAndSize(center: Vector2, size: Vector2): this;
     /**
-     * @description 是否可见
+     * 克隆二维包围盒
+     * @returns {Box2} 克隆结果
      */
-    visible: boolean;
+    clone(): Box2;
     /**
-     * @description 是否处于锁定状态
+     * 复制二维包围盒
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 复制结果
      */
-    isLocked: boolean;
-    isCoreEditable: boolean;
+    copyFrom(box: Box2): this;
     /**
-     * @description 扩展属性存储（与 property 同级）
+     * 二维包围盒置空
+     * @returns {Box2} 置空结果
      */
-    private _extension;
+    makeEmpty(): this;
     /**
-     * @description 元素类型（由子类实现）
-     * @description 支持 spec.ItemType 或扩展的 SDKItemType
+     * 二维包围盒判空
+     * @returns {boolean} 判空结果
      */
-    abstract readonly type: SDKItemType;
+    isEmpty(): boolean;
     /**
-     * @description 元素属性（由子类实现）
+     * 获取二维包围盒角点
+     * @returns {Vector2[]} 二维包围盒角点
      */
-    abstract readonly property: BaseItemProperty;
-    constructor(options: SDKItemOptions);
+    getCorners(): Vector2[];
     /**
-     * @description 设置扩展属性
-     * @param key 属性名
-     * @param value 属性值
+     * 获取二维包围盒中心点
+     * @param {Vector2} [target=new Vector2()] 目标点(用以存放二维包围盒中心点)
+     * @returns {Vector2} 二维包围盒中心点
      */
-    setExtension(key: string, value: any): void;
+    getCenter(target?: Vector2): Vector2;
     /**
-     * @description 获取扩展属性
-     * @param key 属性名
-     * @returns 属性值
+     * 获取二维包围盒大小
+     * @param {Vector2} [target=new Vector2()] 目标向量(用以存放二维包围盒大小)
+     * @returns {Vector2} 二维包围盒大小
      */
-    getExtension(key: string): any;
+    getSize(target?: Vector2): Vector2;
     /**
-     * @description 检查是否存在指定扩展属性
-     * @param key 属性名
-     * @returns 是否存在
+     * 通过二维空间点扩展二维包围盒
+     * @param {Vector2} point 二维空间点
+     * @returns {Box2} 扩展包围盒
+     */
+    expandByPoint(point: Vector2): this;
+    /**
+     * 通过向量扩展二维包围盒
+     * @param {Vector2} vector 二维向量
+     * @returns {Box2} 扩展结果
+     */
+    expandByVector(vector: Vector2): this;
+    /**
+     * 通过大小扩展二维包围盒
+     * @param {number} scalar 扩展大小
+     * @returns {Box2} 扩展结果
+     */
+    expandByScalar(scalar: number): this;
+    /**
+     * 判断二维包围盒是否包含二维空间点
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} [isOrthogonal=true] 包围盒正交判断(默认为true)
+     * @returns {boolean} 点包含判断结果
+     */
+    containsPoint(point: Vector2, isOrthogonal?: boolean): boolean;
+    /**
+     * 判断二维包围盒包含关系(if this contains other)
+     * @param {Box2} box 其它包围盒
+     * @returns {boolean} 二维包围盒包含判断结果
+     */
+    containsBox(box: Box2): boolean;
+    /**
+     * 获取点以包围盒左上角顶点为原点的相对位置
+     * @param {Vector2} point 指定二维空间点
+     * @param {Vector2} [target=new Vector2()] 目标空间点
+     * @returns {Vector2} 计算结果空间点
+     */
+    getParameter(point: Vector2, target?: Vector2): Vector2;
+    /**
+     * 求点与二维包围盒的最近点
+     * @param {Vector2} point 二维空间点
+     * @param {Vector2} [target=new Vector2()] 结果点
+     * @returns {Vector2} 二维空间点
+     */
+    clampPoint(point: Vector2, target?: Vector2): Vector2;
+    /**
+     * 求点到二维包围盒的距离
+     * @param {Vector2} point 二维空间点
+     * @returns {number} 距离
+     */
+    distanceToPoint(point: Vector2): number;
+    /**
+     * 二维包围盒求交集
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 求交结果
+     */
+    intersect(box: Box2): this;
+    /**
+     * 二维包围盒求并集
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 求并结果
+     */
+    union(target: Box2 | Vector2): this;
+    /**
+     * 二维包围盒位移
+     * @param {Vector2} offset 位移向量
+     * @returns {Box2} 位移结果
+     */
+    translate(offset: Vector2): this;
+    scale(scalar: number | Vector2, anchor?: Vector2): this;
+    /**
+     * 二维包围盒判等
+     * @param {Box2} box 二维包围盒
+     * @returns {boolean} 判等结果
+     */
+    equals(box: Box2): boolean;
+    /**
+     * 判断二维包围盒相交关系(if this intersect other)
+     * @param {Box2} box 二维包围盒
+     * @param {boolean} [isOrthogonal=true] 正交判断(当前包围盒)
+     * @returns {boolean} 相交判断结果
+     */
+    intersectsBox(box: Box2, isOrthogonal?: boolean): boolean;
+    rotate(angle: number, center?: Vector2): this;
+}
+
+type 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);
+    /**
+     * @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;
     /**
@@ -377,280 +861,57 @@ declare class TextItem extends BaseItem {
     /**
      * @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]);
+    get outlineWidth(): number | undefined;
+    set outlineWidth(value: number | undefined);
     /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
+     * @description 描边开关
      */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
+    get outlineEnabled(): boolean;
+    set outlineEnabled(value: boolean);
     /**
-     * @description 转换为 GeneratorCreateInfo
-     * @param withParent 是否包含父节点ID
+     * @description 位置
      */
-    toCreateInfo(withParent?: boolean): GeneratorCreateInfo;
+    get position(): [number, number];
+    set position(value: [number, number]);
     /**
-     * @description 转换为 VideoCreateInfo（用于转换为视频元素）
-     * @param videoUrl 视频资源地址
-     * @param withParent 是否包含父节点ID
+     * @description 旋转（二维旋转角度）
      */
-    toVideoCreateInfo(videoUrl: string, withParent?: boolean): VideoCreateInfo;
+    get rotation(): number;
+    set rotation(value: number);
     /**
-     * @description 转换为 SpriteCreateInfo（用于转换为图片元素）
-     * @param imageUrl 图片资源地址
+     * @description 转换为 CreateInfo
      * @param withParent 是否包含父节点ID
      */
-    toSpriteCreateInfo(imageUrl: string, withParent?: boolean): SpriteCreateInfo;
+    toCreateInfo(withParent?: boolean): TextCreateInfo;
     /**
      * @description 克隆 SDKItem
      */
-    clone(): GeneratorItem;
+    clone(): TextItem;
 }
 /**
- * @description 类型守卫：检查是否是 GeneratorItem
+ * @description 类型守卫：检查是否是 TextItem
  */
-declare function isGeneratorItem(obj: any): obj is GeneratorItem;
+declare function isTextItem(obj: any): obj is TextItem;
 
 /**
- * @description 特效产物 元素 SDKItem 类
+ * @description 视频元素 SDKItem 类
+ * @description 支持属性扩展
  */
-declare class EffectsItem extends BaseItem {
+declare class VideoItem extends BaseItem {
     /**
-     * @description 元素类型（独立类型，不属于 spec.ItemType）
+     * @description 元素类型
      */
-    readonly type = SDKItemType.EFFECTS;
+    readonly type = SDKItemType.VIDEO;
     /**
      * @description 元素属性
      */
-    property: EffectsItemProperty;
-    constructor(options: EffectsItemOptions);
+    property: VideoItemProperty;
+    constructor(options: VideoItemOptions);
     /**
-     * @description 特效资源地址
+     * @description 视频地址
      */
-    get effects(): string;
-    set effects(value: string);
+    get video(): string;
+    set video(value: string);
     /**
      * @description 位置
      */
@@ -683,504 +944,363 @@ declare class EffectsItem extends BaseItem {
     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 根据 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$1 = SpriteItem | TextItem | VideoItem | GroupItem | GeneratorItem | EffectsItem;
-
-/**
- * @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} 距离结果
+     * @description 是否静音
      */
-    closestPointToPointParameter(point: Vector2, clampToLine: boolean): number;
+    get muted(): boolean;
+    set muted(state: boolean);
     /**
-     * 求点与线段的最近交点
-     * @param {Vector2} point 二维空间点
-     * @param {boolean} clampToLine 是否限制于线段内
-     * @param {Vector2} target 目标保存对象
-     * @returns {Vector2} 最近交点
+     * @description 是否为透明视频
      */
-    closestPointToPoint(point: Vector2, clampToLine: boolean, target?: Vector2): Vector2;
+    get transparent(): boolean;
+    set transparent(state: boolean);
     /**
-     * 二维线段判等
-     * @param {Line2} line 二维线段
-     * @returns {boolean} 判等结果
+     * @description 播放音量
      */
-    equals(line: Line2): boolean;
+    get volume(): number;
+    set volume(value: number);
     /**
-     * 克隆二维线段
-     * @returns {Line2} 克隆结果
+     * @description 播放速率
      */
-    clone(): Line2;
+    get playbackRate(): number;
+    set playbackRate(value: number);
     /**
-     * 二维线段求长度
-     * @returns {number} 长度
+     * @description 转换为 CreateInfo
+     * @param withParent 是否包含父节点ID
      */
-    length(): number;
+    toCreateInfo(withParent?: boolean): VideoCreateInfo;
     /**
-     * 二维线段判断相交
-     * @param {Line2} other 二维线段
-     * @returns {boolean} 相交判断结果
+     * @description 克隆 SDKItem
      */
-    crossWithLine(other: Line2): boolean;
+    clone(): VideoItem;
 }
+/**
+ * @description 类型守卫：检查是否是 VideoItem
+ */
+declare function isVideoItem(obj: any): obj is VideoItem;
 
-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;
+/**
+ * @description 空节点/组 SDKItem 类
+ * @description 支持属性扩展
+ */
+declare class GroupItem extends BaseItem {
     /**
-     * 点到直线的最短距离
-     * @returns {{d: number, t: number}} d表示距离，t表示最近点在直线的比例
+     * @description 元素类型
      */
-    distanceToLine(line: Line2): {
-        d: number;
-        t: number;
-    };
+    readonly type = SDKItemType.GROUP;
     /**
-     * 二维向量与x轴夹角
-     * @returns {number} 弧度值
+     * @description 元素属性
      */
-    angle(): number;
+    property: GroupItemProperty;
+    constructor(options: GroupItemOptions);
     /**
-     * 二维点绕点旋转
-     * @param {Vec2} center 旋转中心
-     * @param {number} angle 旋转角度
-     * @returns {Vec2} 旋转结果
+     * @description 位置
      */
-    rotateAround(center: Vector2, angle: number): this;
-}
-
-/**
- * @class 二维包围盒
- */
-declare class Box2 {
+    get position(): [number, number];
+    set position(value: [number, number]);
     /**
-     * @member {Vector2[]} corners 二维包围盒角点
+     * @description 大小
      */
-    corners: Vector2[];
-    min: Vector2;
-    max: Vector2;
+    get scale(): [number, number];
+    set scale(value: [number, number]);
     /**
-     * 构造函数，传入值为空时表示空包围盒
-     * @param {Vector2} [min=new Vector2(Infinity, Infinity)] 最小点
-     * @param {Vector2} [max=new Vector2(-Infinity, -Infinity)] 最大点
+     * @description 旋转（二维旋转角度）
      */
-    constructor(min?: Vector2, max?: Vector2);
+    get rotation(): number;
+    set rotation(value: number);
     /**
-     * 通过最大最小点设置二维包围盒
-     * @param {Vector2} min 最小点
-     * @param {Vector2} max 最大点
-     * @returns {Box2} 二维包围盒
+     * @description 完整旋转（包含 x, y, z）
      */
-    set(min: Vector2, max: Vector2): this;
+    get fullRotation(): [number, number, number];
+    set fullRotation(value: [number, number, number]);
     /**
-     * 通过角点设置二维包围盒
-     * @param {Vector2[]} vecArray 二维空间点数组
-     * @returns {Box2} 二维包围盒
+     * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
-    setFromVec2Array(vecArray: Vector2[]): this;
+    get keyPropertyEditing(): boolean;
+    set keyPropertyEditing(value: boolean);
     /**
-     * 通过屏幕坐标点设置二维包围盒 - 点为屏幕坐标点，x正方向为右，y正方向为向上
-     * @param vecArray 屏幕坐标点
+     * @description 转换为 CreateInfo
+     * @param withParent 是否包含父节点ID
+     */
+    toCreateInfo(withParent?: boolean): GroupCreateInfo;
+    /**
+     * @description 克隆 SDKItem
      */
-    setFromVec2ArrayWithOutCorners(vecArray: Vector2[]): this;
+    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 {
     /**
-     * 通过中心与大小设置二维包围盒
-     * @param {Vector2} center 二维中心点
-     * @param {Vector2} size 二维大小
-     * @returns {Box2} 二维包围盒
+     * @description 元素类型（独立类型，不属于 spec.ItemType）
      */
-    setFromCenterAndSize(center: Vector2, size: Vector2): this;
+    readonly type = SDKItemType.GENERATOR;
     /**
-     * 克隆二维包围盒
-     * @returns {Box2} 克隆结果
+     * @description 元素属性（包含 generatorType）
      */
-    clone(): Box2;
+    property: GeneratorItemProperty;
+    constructor(options: GeneratorItemOptions);
     /**
-     * 复制二维包围盒
-     * @param {Box2} box 二维包围盒
-     * @returns {Box2} 复制结果
+     * @description 生成器类型
      */
-    copyFrom(box: Box2): this;
+    get generatorType(): 'image' | 'video';
+    set generatorType(value: 'image' | 'video');
     /**
-     * 二维包围盒置空
-     * @returns {Box2} 置空结果
+     * @description 图片地址（生成器返回空）
      */
-    makeEmpty(): this;
+    get image(): string;
+    set image(_value: string);
     /**
-     * 二维包围盒判空
-     * @returns {boolean} 判空结果
+     * @description 位置
      */
-    isEmpty(): boolean;
+    get position(): [number, number];
+    set position(value: [number, number]);
     /**
-     * 获取二维包围盒角点
-     * @returns {Vector2[]} 二维包围盒角点
+     * @description 宽度
      */
-    getCorners(): Vector2[];
+    get width(): number;
+    set width(value: number);
     /**
-     * 获取二维包围盒中心点
-     * @param {Vector2} [target=new Vector2()] 目标点(用以存放二维包围盒中心点)
-     * @returns {Vector2} 二维包围盒中心点
+     * @description 高度
      */
-    getCenter(target?: Vector2): Vector2;
+    get height(): number;
+    set height(value: number);
     /**
-     * 获取二维包围盒大小
-     * @param {Vector2} [target=new Vector2()] 目标向量(用以存放二维包围盒大小)
-     * @returns {Vector2} 二维包围盒大小
+     * @description 旋转（二维旋转角度）
      */
-    getSize(target?: Vector2): Vector2;
+    get rotation(): number;
+    set rotation(value: number);
     /**
-     * 通过二维空间点扩展二维包围盒
-     * @param {Vector2} point 二维空间点
-     * @returns {Box2} 扩展包围盒
+     * @description 完整旋转（包含 x, y, z）
      */
-    expandByPoint(point: Vector2): this;
+    get fullRotation(): [number, number, number];
+    set fullRotation(value: [number, number, number]);
     /**
-     * 通过向量扩展二维包围盒
-     * @param {Vector2} vector 二维向量
-     * @returns {Box2} 扩展结果
+     * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
-    expandByVector(vector: Vector2): this;
+    get keyPropertyEditing(): boolean;
+    set keyPropertyEditing(value: boolean);
     /**
-     * 通过大小扩展二维包围盒
-     * @param {number} scalar 扩展大小
-     * @returns {Box2} 扩展结果
+     * @description 转换为 GeneratorCreateInfo
+     * @param withParent 是否包含父节点ID
      */
-    expandByScalar(scalar: number): this;
+    toCreateInfo(withParent?: boolean): GeneratorCreateInfo;
     /**
-     * 判断二维包围盒是否包含二维空间点
-     * @param {Vector2} point 二维空间点
-     * @param {boolean} [isOrthogonal=true] 包围盒正交判断(默认为true)
-     * @returns {boolean} 点包含判断结果
+     * @description 转换为 VideoCreateInfo（用于转换为视频元素）
+     * @param videoUrl 视频资源地址
+     * @param withParent 是否包含父节点ID
      */
-    containsPoint(point: Vector2, isOrthogonal?: boolean): boolean;
+    toVideoCreateInfo(videoUrl: string, withParent?: boolean): VideoCreateInfo;
     /**
-     * 判断二维包围盒包含关系(if this contains other)
-     * @param {Box2} box 其它包围盒
-     * @returns {boolean} 二维包围盒包含判断结果
+     * @description 转换为 SpriteCreateInfo（用于转换为图片元素）
+     * @param imageUrl 图片资源地址
+     * @param withParent 是否包含父节点ID
      */
-    containsBox(box: Box2): boolean;
+    toSpriteCreateInfo(imageUrl: string, withParent?: boolean): SpriteCreateInfo;
     /**
-     * 获取点以包围盒左上角顶点为原点的相对位置
-     * @param {Vector2} point 指定二维空间点
-     * @param {Vector2} [target=new Vector2()] 目标空间点
-     * @returns {Vector2} 计算结果空间点
+     * @description 克隆 SDKItem
      */
-    getParameter(point: Vector2, target?: Vector2): Vector2;
+    clone(): GeneratorItem;
+}
+/**
+ * @description 类型守卫：检查是否是 GeneratorItem
+ */
+declare function isGeneratorItem(obj: any): obj is GeneratorItem;
+
+/**
+ * @description 特效产物 元素 SDKItem 类
+ */
+declare class EffectsItem extends BaseItem {
     /**
-     * 求点与二维包围盒的最近点
-     * @param {Vector2} point 二维空间点
-     * @param {Vector2} [target=new Vector2()] 结果点
-     * @returns {Vector2} 二维空间点
+     * @description 元素类型（独立类型，不属于 spec.ItemType）
      */
-    clampPoint(point: Vector2, target?: Vector2): Vector2;
+    readonly type = SDKItemType.EFFECTS;
     /**
-     * 求点到二维包围盒的距离
-     * @param {Vector2} point 二维空间点
-     * @returns {number} 距离
+     * @description 预合成元素ID
      */
-    distanceToPoint(point: Vector2): number;
+    subCompositionItemId: string;
     /**
-     * 二维包围盒求交集
-     * @param {Box2} box 二维包围盒
-     * @returns {Box2} 求交结果
+     * @description 元素属性
      */
-    intersect(box: Box2): this;
+    property: EffectsItemProperty;
+    constructor(options: EffectsItemOptions);
     /**
-     * 二维包围盒求并集
-     * @param {Box2} box 二维包围盒
-     * @returns {Box2} 求并结果
+     * @description 特效资源地址
      */
-    union(target: Box2 | Vector2): this;
+    get effects(): string;
+    set effects(value: string);
     /**
-     * 二维包围盒位移
-     * @param {Vector2} offset 位移向量
-     * @returns {Box2} 位移结果
+     * @description 位置
      */
-    translate(offset: Vector2): this;
-    scale(scalar: number | Vector2, anchor?: Vector2): this;
+    get position(): [number, number];
+    set position(value: [number, number]);
     /**
-     * 二维包围盒判等
-     * @param {Box2} box 二维包围盒
-     * @returns {boolean} 判等结果
+     * @description 宽度
      */
-    equals(box: Box2): boolean;
+    get width(): number;
+    set width(value: number);
     /**
-     * 判断二维包围盒相交关系(if this intersect other)
-     * @param {Box2} box 二维包围盒
-     * @param {boolean} [isOrthogonal=true] 正交判断(当前包围盒)
-     * @returns {boolean} 相交判断结果
+     * @description 高度
      */
-    intersectsBox(box: Box2, isOrthogonal?: boolean): boolean;
-    rotate(angle: number, center?: Vector2): this;
-}
-
-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 = {
+    get height(): number;
+    set height(value: number);
     /**
-     * 导出类型
+     * @description 旋转（二维旋转角度）
      */
-    mediaType: MediaType;
+    get rotation(): number;
+    set rotation(value: number);
     /**
-     * 额外画布，导出透明视频时使用
+     * @description 完整旋转（包含 x, y, z）
      */
-    extraCanvas?: HTMLCanvasElement | null;
+    get fullRotation(): [number, number, number];
+    set fullRotation(value: [number, number, number]);
     /**
-     * 是否打印转码过程中的日志，仅在导出 MP4/AlphaMaskVideo 时有效， 默认 false
-     * 供开发调试使用
+     * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
-    loggerInTranscoding?: boolean;
+    get keyPropertyEditing(): boolean;
+    set keyPropertyEditing(value: boolean);
     /**
-     * ffmpeg 转码是否开启多线程，默认 false，确保环境支持 SharedArrayBuffer
+     * @description 转换为 EffectsCreateInfo
+     * @param withParent 是否包含父节点ID
      */
-    multiThreading?: boolean;
+    toCreateInfo(withParent?: boolean): EffectsCreateInfo;
     /**
-     * 是否输出 buffer，默认 false
+     * @description 克隆 SDKItem
      */
-    isOutputBuffer?: boolean;
-};
-type MP4Config = {
+    clone(): EffectsItem;
+}
+/**
+ * @description 类型守卫：检查是否是 EffectsItem
+ */
+declare function isEffectsItem(obj: any): obj is EffectsItem;
+
+/**
+ * @description 画板/框架元素 SDKItem 类
+ * @description 支持自动布局和自由布局两种模式
+ * @description 底层以 composition 形式渲染
+ */
+declare class FrameItem extends BaseItem {
     /**
-     * @description MP4 导出时是否需要导出最后一帧 PNG
+     * @description 元素类型
      */
-    isExportLastFrameJPEG?: boolean;
-};
-type GifConfig = {
+    readonly type = SDKItemType.FRAME;
     /**
-     * @description GIF 导出时的帧率
+     * @description 预合成元素ID
      */
-    fps?: number;
+    subCompositionItemId: string;
     /**
-     * @description GIF 导出时的缩放比例
-     * 默认 '-1:-1'， 表示不缩放
-     * 例如 '100:-1'， 表示宽度 100，高度自动
-     * 例如 '-1:100'， 表示宽度自动，高度 100
+     * @description 元素属性
      */
-    scale?: string;
+    property: FrameItemProperty;
+    constructor(options: FrameItemOptions);
     /**
-     * @description GIF 导出时的质量
-     * 默认 'highest'
-     * 可选 'highest', 'high', 'medium', 'low'
+     * @description 子元素ID列表（只读）
      */
-    quality?: keyof typeof GIF_QUALITY_TO_FFMPEG_ARGS;
-};
-type ApngConfig = {
+    get children(): readonly string[];
     /**
-     * @description APNG 导出时的帧率
+     * @description 布局模式
      */
-    fps?: number;
+    get layoutMode(): FrameLayoutMode;
+    set layoutMode(value: FrameLayoutMode);
     /**
-     * @description APNG 导出时的缩放比例
-     * 默认 '-1:-1'， 表示不缩放
-     * 例如 '100:-1'， 表示宽度 100，高度自动
-     * 例如 '-1:100'， 表示宽度自动，高度 100
+     * @description 位置
      */
-    scale?: string;
+    get position(): [number, number];
+    set position(value: [number, number]);
     /**
-     * @description APNG 导出时的质量
-     * 默认 'highest'
-     * 可选 'highest', 'high', 'medium', 'low'
+     * @description 宽度
      */
-    quality?: keyof typeof GIF_QUALITY_TO_FFMPEG_ARGS;
-};
-type ExportMediaItemOptions = {
+    get width(): number;
+    set width(value: number);
     /**
-     * 尺寸
+     * @description 高度
      */
-    size: [number, number];
+    get height(): number;
+    set height(value: number);
     /**
-     * 动效资源
+     * @description 缩放
      */
-    scene: spec.JSONScene;
+    get scale(): [number, number];
+    set scale(value: [number, number]);
     /**
-     * 视频时长，目前仅在导出 MP4 / AlphaMaskVideo 时有效，默认取动效资源时长
+     * @description 旋转（二维旋转角度）
      */
-    time?: number;
+    get rotation(): number;
+    set rotation(value: number);
     /**
-     * 是否生成音轨，默认 false，仅在导出 MP4 时有效
+     * @description 完整旋转（包含 x, y, z）
      */
-    audioEnable?: boolean;
+    get fullRotation(): [number, number, number];
+    set fullRotation(value: [number, number, number]);
     /**
-     * 帧率， 默认 30
+     * @description 添加子元素
+     * @param itemId 子元素ID
+     * @returns 是否添加成功
      */
-    fps?: number;
+    addChild(itemId: string): boolean;
     /**
-     * 是否循环，默认 true
+     * @description 批量添加子元素
+     * @param itemIds 子元素ID列表
      */
-    loop?: boolean;
+    addChildren(itemIds: string[]): void;
     /**
-     * 视频背景颜色，默认 #000000
+     * @description 移除子元素
+     * @param itemId 子元素ID
+     * @returns 是否移除成功
      */
-    backgroundColor?: string;
+    removeChild(itemId: string): boolean;
     /**
-     * 导出 MP4 时，设置的导出配置
+     * @description 批量移除子元素
+     * @param itemIds 子元素ID列表
      */
-    mp4Config?: MP4Config;
+    removeChildren(itemIds: string[]): void;
     /**
-     * 导出 GIF 时，设置的导出配置
+     * @description 是否包含指定子元素
+     * @param itemId 子元素ID
      */
-    gifConfig?: GifConfig;
+    hasChild(itemId: string): boolean;
     /**
-     * 导出 APNG 时，设置的导出配置
+     * @description 清空所有子元素
      */
-    apngConfig?: ApngConfig;
-};
-type ExportMediaItemDownloadInfo = {
+    clearChildren(): void;
     /**
-     * @description 导出文件夹名称
+     * @description 转换为 FrameCreateInfo
+     * @param withParent 是否包含父节点ID
      */
-    folderName: string;
+    toCreateInfo(withParent?: boolean): FrameCreateInfo;
     /**
-     * @description 导出视频名称
+     * @description 克隆 SDKItem
      */
-    name: string;
-};
-type ExportItemParams = ExportMediaItemOptions & ExportMediaItemDownloadInfo;
-type ExportParams = ExportItemParams[];
-type Buffers = FileBuffer[] | undefined;
-type Extras = (FileBuffer | null)[] | null | undefined;
+    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;
 
 type BaseItemProperty = {
     position: [number, number];
@@ -1210,6 +1330,10 @@ type TextItemProperty = BaseItemProperty & {
      * @description 描边开关
      */
     outlineEnabled?: boolean;
+    /**
+     * @description 文本字间距
+     */
+    letterSpacing?: number;
     fontUrl?: string;
 };
 type VideoItemProperty = BaseItemProperty & {
@@ -1242,6 +1366,27 @@ type GeneratorItemProperty = BaseItemProperty & {
 };
 type EffectsItemProperty = BaseItemProperty & {
     effects: string;
+    children?: string[];
+};
+/**
+ * @description Frame 画板元素布局模式
+ */
+declare enum FrameLayoutMode {
+    AUTO = "auto",
+    FREE = "free"
+}
+/**
+ * @description Frame 画板元素属性
+ */
+type FrameItemProperty = BaseItemProperty & {
+    /**
+     * @description 布局模式: auto - 自动布局, free - 自由布局
+     */
+    layoutMode: FrameLayoutMode;
+    /**
+     * @description 子元素ID数组
+     */
+    children: string[];
 };
 /**
  * @description BaseItem 基础属性键名
@@ -1269,7 +1414,7 @@ type ItemPropertyMap = {
     [SDKItemType.GROUP]: GroupItemProperty;
     [SDKItemType.GENERATOR]: GeneratorItemProperty;
     [SDKItemType.EFFECTS]: EffectsItemProperty;
-    [SDKItemType.FRAME]: BaseItemProperty;
+    [SDKItemType.FRAME]: FrameItemProperty;
 };
 /**
  * @description 场景1：单个元素单个属性设置
@@ -1541,13 +1686,6 @@ type ActiveData = {
      */
     loadingItems?: string[];
 };
-/**
- * @description 视图元素
- * @description 注意：SDKItem 现在已从类实现中导入，见 view-item/index.ts
- * @description SDKItem 现在是类实例而非普通对象，支持属性扩展
- * @description 保持类型兼容性：新 SDKItem 类拥有与旧类型相同的属性
- */
-type SDKItem = SDKItem$1;
 type SDKBackgroundType = 'color' | 'image' | 'chess-board' | 'dot-board';
 /**
  * @description 图层创建信息
@@ -1577,7 +1715,7 @@ type SpriteCreateInfo = {
         /**
          * @description 图片资源地址 | 数据
          */
-        image: string;
+        image?: string;
         /**
          * @description 图层像素宽度
          */
@@ -1736,6 +1874,10 @@ type TextCreateInfo = {
          * @description 字体文件地址
          */
         fontUrl?: string;
+        /**
+         * @description 文本字间距
+         */
+        letterSpacing?: number;
     };
 };
 /**
@@ -1766,7 +1908,7 @@ type VideoCreateInfo = {
         /**
          * @description 视频资源地址 | 数据
          */
-        video: string;
+        video?: string;
         /**
          * @description 视频元素像素宽度
          */
@@ -1963,14 +2105,72 @@ type EffectsCreateInfo = {
         /**
          * @description 动效资源地址
          */
-        effects: string | spec.JSONScene;
+        effects: string;
+    };
+    /**
+     * @description 扩展属性
+     */
+    extension?: Record<string, any>;
+};
+/**
+ * @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 扩展属性
      */
     extension?: Record<string, any>;
 };
-type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo;
+type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo | FrameCreateInfo;
 /**
  * @description 场景创建信息
  */
@@ -2026,6 +2226,14 @@ type UpdateOperation = {
     oldData: ItemCreateInfo[];
 };
 type Operation = CreateOperation | UpdateOperation | DeleteOperation;
+/**
+ * 通用撤销重做操作类型
+ */
+type GizmoOperation<T> = {
+    type: 'update';
+    newData: T;
+    oldData: T;
+};
 declare class UndoRedo {
     private index;
     private operations;
@@ -2149,6 +2357,7 @@ type ExportConfig = {
  */
 type ScreenShotConfig = {
     enabled: boolean;
+    defaultBackgroundColor: [number, number, number, number];
 };
 /**
  * @description 尺寸自适应功能配置
@@ -2308,6 +2517,14 @@ type TransformGizmoConfig = {
      * @description 视频Logo地址
      */
     videoLogoUrl: string;
+    /**
+     * @description 画板Logo地址
+     */
+    frameLogoUrl: string;
+    /**
+     * @description 特效Logo地址
+     */
+    effectsLogoUrl: string;
     /**
      * @description 大小文字颜色
      */
@@ -2574,6 +2791,10 @@ type MaskGizmoConfig = {
      * @description 蒙版透明度
      */
     maskAlpha: number;
+    /**
+     * @description 蒙版图片
+     */
+    maskImage?: HTMLImageElement;
     /**
      * @description 元素包围盒线框宽度
      */
@@ -2707,9 +2928,61 @@ type VideoPlayGizmoConfig = {
     height: number;
 };
 type ItemCreateGizmoConfig = {
-    frameColor: number;
+    /**
+     * @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 精准改字功能初始化信息
  */
@@ -2753,6 +3026,35 @@ declare module '@pixi/graphics' {
     }
 }
 
+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[]];
@@ -2768,7 +3070,7 @@ type SDKEvents = {
     }];
     'itemPropertyChange': [{
         id: string;
-        property: string;
+        propertyKeys: string[];
     }];
     'exportProgress': [progress?: number];
     'exportDone': [item: ExportItemParams | undefined, success: boolean, buffer?: FileBuffer];
@@ -2782,6 +3084,8 @@ type SDKEvents = {
         fontFamily: string;
     }];
     'undoRedoChange': [Operation];
+    'maskGizmoUndoRedoChange': [GizmoOperation<MaskUndoRedoData>];
+    'pictureCutGizmoUndoRedoChange': [GizmoOperation<PictureCutUndoRedoData>];
     'viewportTransform': [{
         zoom: number;
         translation: [number, number];
@@ -2801,6 +3105,7 @@ type SDKEvents = {
     'itemCreate': [{
         type: ItemCreateType;
         position: spec.vec2;
+        id: string;
     }];
     'viewLost': [];
     'viewRebuildFinish': [];
@@ -2828,7 +3133,7 @@ declare class SDK {
     get undoRedo(): UndoRedo;
     private get exportOptions();
     dispose(): void;
-    on: <E extends "progress" | "loadingItemChange" | "selectedItemChange" | "preSelectedItemChange" | "selectedViewChange" | "pageDataChange" | "zoomChange" | "itemPropertyChange" | "exportProgress" | "exportDone" | "exportComplete" | "sdkConfigChange" | "cutBoxChange" | "expandBoxChange" | "textInput" | "undoRedoChange" | "viewportTransform" | "itemOnDragStart" | "itemOnDrag" | "itemOnDragEnd" | "spriteTextClick" | "videoPlay" | "itemCreate" | "viewLost" | "viewRebuildFinish">(eventName: E, listener: _galacean_effects.EventEmitterListener<SDKEvents[E]>, options?: _galacean_effects.EventEmitterOptions) => () => void;
+    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;
@@ -2872,13 +3177,13 @@ declare class SDK {
      * @param id 元素ID
      * @returns 元素
      * */
-    getSDKItem(id: string): SDKItem$1 | undefined;
+    getSDKItem(id: string): SDKItem | undefined;
     /**
      * @description 获取元素数组
      * @param id 元素ID数组
      * @returns 元素数组
      * */
-    getSDKItems(ids?: string[]): SDKItem$1[];
+    getSDKItems(ids?: string[]): SDKItem[];
     setPlayState(playState: 'play' | 'pause'): Promise<void>;
     /**
      * @description 获取场景预览图
@@ -3043,7 +3348,54 @@ declare class SDK {
      * @param mode 模式类型：'paint' 表示涂抹，'erase' 表示擦除
      */
     setMaskGizmoMode(mode: 'paint' | 'erase'): void;
-    openLoadingGizmo(id: string, loadingBox?: Box2, clearResult?: boolean): 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 元素打组
@@ -3058,6 +3410,7 @@ declare class SDK {
     getItemCreateInfo(id: string): ItemCreateInfo | undefined;
     getItemCreateInfos(ids?: string[]): ItemCreateInfo[];
     createScreenShotSceneByIds(idInfo: string | string[], time?: number): Promise<string | undefined>;
+    createScreenShotByFrame(id: string): Promise<string | undefined>;
     getChildrenIds(id: string): string[];
     /**
      * @description 更新元素在图层中的顺序
@@ -3078,21 +3431,14 @@ declare class SDK {
      * @param extensions 扩展属性对象（支持同时设置多个）
      * @returns 是否设置成功
      */
-    setItemExtensions(id: string, extensions: Record<string, any>): boolean;
+    setItemExtension(id: string, extension: Record<string, any>): boolean;
     /**
      * @description 批量获取元素扩展属性
      * @param id 元素ID
      * @param keys 扩展属性名称列表（不传则返回所有扩展属性）
      * @returns 扩展属性对象
      */
-    getItemExtensions(id: string, keys?: string[]): Record<string, any> | undefined;
-    /**
-     * @description 获取单个元素扩展属性
-     * @param id 元素ID
-     * @param key 扩展属性名称
-     * @returns 扩展属性值
-     */
-    getItemExtension(id: string, key: string): any;
+    getItemExtension(id: string, keys?: string[]): Record<string, any> | undefined;
     /**
      * @description 删除元素扩展属性（支持批量删除）
      * @param id 元素ID
@@ -3159,9 +3505,13 @@ declare class SDK {
     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;
     /**
@@ -3171,10 +3521,28 @@ declare class SDK {
      */
     addGeneratorItem(createInfo: GeneratorCreateInfo): string;
     /**
-     * @description 创建动效元素（仅限调试使用）
+     * @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[], frameId?: string): void;
     /**
      * @description 设置生成器资源，将生成器转换为对应的元素
      * @param id 生成器元素ID
@@ -3205,4 +3573,4 @@ declare class SDK {
     setSafeAreaPreviewVisible(id: number, type: 'url' | 'color', visible: boolean): void;
 }
 
-export { type ActiveData, BaseItem, type BaseItemProperty, type BaseItemPropertyKey, type BaseItemPropertyValueMap, Box2, type CreateOperation, type DeleteOperation, type EffectsCreateInfo, EffectsItem, type EffectsItemOptions, type GeneratorCreateInfo, GeneratorItem, type GeneratorItemOptions, type GeneratorItemProperty, type GizmoType, type GroupCreateInfo, GroupItem, type GroupItemOptions, type ItemCreateInfo, ItemOrderAction, type ItemPropertyMap, type Operation, type PageData, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKItem$1 as SDKItem, type SDKItemOptions, SDKItemType, type SDKOptions, type SetItemPropertyParam, type SetSingleItemMultiplePropertiesParam, type SetSingleItemSinglePropertyParam, type SpriteCreateInfo, SpriteItem, type SpriteItemOptions, type SpriteItemProperty, type TextCreateInfo, TextItem, type TextItemOptions, type TextItemProperty, type UpdateOperation, Vector2, type VideoCreateInfo, VideoItem, type VideoItemOptions, type VideoItemProperty, type ViewParam, type ViewProperty, createSDKItem, isBaseItem, isEffectsItem, isGeneratorItem, isGroupItem, isSpriteItem, isTextItem, isVideoItem };
+export { type ActiveData, BaseItem, type BaseItemProperty, type BaseItemPropertyKey, type BaseItemPropertyValueMap, Box2, type CreateOperation, type DeleteOperation, type EffectsCreateInfo, EffectsItem, type EffectsItemOptions, type FrameCreateInfo, FrameItem, type FrameItemOptions, type FrameItemProperty, FrameLayoutMode, type GeneratorCreateInfo, GeneratorItem, type GeneratorItemOptions, type GeneratorItemProperty, type GizmoType, type GroupCreateInfo, GroupItem, type GroupItemOptions, type ItemCreateInfo, ItemOrderAction, type ItemPropertyMap, type Operation, type PageData, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKItem, type SDKItemOptions, SDKItemType, type SDKOptions, type SetItemPropertyParam, type SetSingleItemMultiplePropertiesParam, type SetSingleItemSinglePropertyParam, type SpriteCreateInfo, SpriteItem, type SpriteItemOptions, type SpriteItemProperty, type TextCreateInfo, TextItem, type TextItemOptions, type TextItemProperty, type UpdateOperation, Vector2, type VideoCreateInfo, VideoItem, type VideoItemOptions, type VideoItemProperty, type ViewParam, type ViewProperty, createSDKItem, isBaseItem, isEffectsItem, isFrameItem, isGeneratorItem, isGroupItem, isSpriteItem, isTextItem, isVideoItem };