@vvfx/sdk 0.1.19-alpha.6 → 0.1.19-alpha.8

package/dist/index.d.cts

@@ -1,678 +1,755 @@
 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 = {
-    /**
-     * @description 元素ID
-     */
-    id: string;
+declare class Line2 {
+    start: Vector2;
+    end: Vector2;
+    constructor(start?: Vector2, end?: Vector2);
     /**
-     * @description 元素名称
+     * 设置二维线段
+     * @param {Vector2} start 线段起点
+     * @param {Vector2} end 线段终点
+     * @returns {Line2} 二维线段
      */
-    name: string;
+    set(start: Vector2, end: Vector2): this;
     /**
-     * @description 父节点ID
+     * 复制二维线段
+     * @param {Line2} line 复制对象
+     * @returns {Line2} 复制结果
      */
-    parentId?: string;
+    copyFrom(line: Line2): this;
     /**
-     * @description 子元素ID列表
+     * 二维线段求方向
+     * @returns {Vector2} 二维线段方向
      */
-    children?: string[];
+    direction(): Vector2;
     /**
-     * @description 元素生命周期
+     * 二维线段求中点
+     * @param {Vector2} [target=new Vector2()] 目标保存对象
+     * @returns {Vector2} 二维线段中点
      */
-    duration?: number;
+    getCenter(target?: Vector2): Vector2;
     /**
-     * @description 元素生命周期延时
+     * 二维线段向量值
+     * @param {Vector2} [target=new Vector2()] 目标保存对象
+     * @returns {Vector2} 二维线段向量值
      */
-    delay?: number;
+    delta(target?: Vector2): Vector2;
     /**
-     * @description 可视状态
+     * 二维线段欧式距离平方(应用于计算)
+     * @returns {number} 计算结果
      */
-    visible?: boolean;
+    distanceSq(): number;
     /**
-     * @description 元素结束行为
+     * 二维线段欧式距离
+     * @returns {number} 计算结果
      */
-    endBehavior?: spec.EndBehavior;
+    distance(): number;
     /**
-     * @description 是否处于锁定状态
+     * 求二维线段比例点
+     * @param {number} t 比例值
+     * @param {Vector2} target 目标保存对象
+     * @returns {Vector2} 比例点结果
      */
-    isLocked?: boolean;
+    at(t: number, target?: Vector2): Vector2;
     /**
-     * @description 关键属性是否可编辑
+     * 求点与线段的最短距离
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} clampToLine 是否限制于线段内
+     * @returns {number} 距离结果
      */
-    isCoreEditable: boolean;
+    closestPointToPointParameter(point: Vector2, clampToLine: boolean): number;
     /**
-     * @description 扩展属性存储（属性名 -> 属性值）
+     * 求点与线段的最近交点
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} clampToLine 是否限制于线段内
+     * @param {Vector2} target 目标保存对象
+     * @returns {Vector2} 最近交点
      */
-    extension?: Record<string, any>;
+    closestPointToPoint(point: Vector2, clampToLine: boolean, target?: Vector2): Vector2;
     /**
-     * @description 允许任意额外属性（用于兼容旧代码）
+     * 二维线段判等
+     * @param {Line2} line 二维线段
+     * @returns {boolean} 判等结果
      */
-    [extraProp: string]: any;
-};
-/**
- * @description Sprite SDKItem 选项
- */
-type SpriteItemOptions = SDKItemOptions & {
+    equals(line: Line2): boolean;
     /**
-     * @description 元素属性
+     * 克隆二维线段
+     * @returns {Line2} 克隆结果
      */
-    property?: Partial<SpriteItemProperty>;
-};
-/**
- * @description Text SDKItem 选项
- */
-type TextItemOptions = SDKItemOptions & {
+    clone(): Line2;
     /**
-     * @description 元素属性
+     * 二维线段求长度
+     * @returns {number} 长度
      */
-    property?: Partial<TextItemProperty>;
-};
-/**
- * @description Video SDKItem 选项
- */
-type VideoItemOptions = SDKItemOptions & {
+    length(): number;
     /**
-     * @description 元素属性
+     * 二维线段判断相交
+     * @param {Line2} other 二维线段
+     * @returns {boolean} 相交判断结果
      */
-    property?: Partial<VideoItemProperty>;
-};
-/**
- * @description Group SDKItem 选项（空节点/组）
- */
-type GroupItemOptions = 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<GroupItemProperty>;
-};
-/**
- * @description Generator SDKItem 选项（资源生成器）
- * @description 支持 image 和 video 两种生成器类型
- * @description 使用 GeneratorItemProperty 包含 generatorType
- */
-type GeneratorItemOptions = SDKItemOptions & {
+    distanceToLine(line: Line2): {
+        d: number;
+        t: number;
+    };
     /**
-     * @description 元素属性（包含 generatorType）
+     * 二维向量与x轴夹角
+     * @returns {number} 弧度值
      */
-    property?: Partial<GeneratorItemProperty>;
-};
-type EffectsItemOptions = SDKItemOptions & {
-    property?: Partial<EffectsItemProperty>;
-};
-/**
- * @description Frame 画板元素 SDKItem 选项
- */
-type FrameItemOptions = SDKItemOptions & {
+    angle(): number;
     /**
-     * @description 元素属性
+     * 二维点绕点旋转
+     * @param {Vec2} center 旋转中心
+     * @param {number} angle 旋转角度
+     * @returns {Vec2} 旋转结果
      */
-    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"
+    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 属性值
-     */
-    getExtension(key: string): any;
-    /**
-     * @description 检查是否存在指定扩展属性
-     * @param key 属性名
-     * @returns 是否存在
+     * 获取二维包围盒大小
+     * @param {Vector2} [target=new Vector2()] 目标向量(用以存放二维包围盒大小)
+     * @returns {Vector2} 二维包围盒大小
      */
-    hasExtension(key: string): boolean;
+    getSize(target?: Vector2): Vector2;
     /**
-     * @description 删除扩展属性
-     * @param key 属性名
-     * @returns 是否删除成功
+     * 通过二维空间点扩展二维包围盒
+     * @param {Vector2} point 二维空间点
+     * @returns {Box2} 扩展包围盒
      */
-    deleteExtension(key: string): boolean;
+    expandByPoint(point: Vector2): this;
     /**
-     * @description 获取所有扩展属性的键名列表
-     * @returns 键名数组
+     * 通过向量扩展二维包围盒
+     * @param {Vector2} vector 二维向量
+     * @returns {Box2} 扩展结果
      */
-    getExtensionKeys(): string[];
+    expandByVector(vector: Vector2): this;
     /**
-     * @description 获取所有扩展属性
-     * @returns 扩展属性对象
+     * 通过大小扩展二维包围盒
+     * @param {number} scalar 扩展大小
+     * @returns {Box2} 扩展结果
      */
-    getAllExtension(): Record<string, any>;
+    expandByScalar(scalar: number): this;
     /**
-     * @description 批量设置扩展属性
-     * @param extensions 扩展属性对象
+     * 判断二维包围盒是否包含二维空间点
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} [isOrthogonal=true] 包围盒正交判断(默认为true)
+     * @returns {boolean} 点包含判断结果
      */
-    setExtensions(extensions: Record<string, any>): void;
+    containsPoint(point: Vector2, isOrthogonal?: boolean): boolean;
     /**
-     * @description 清空所有扩展属性
+     * 判断二维包围盒包含关系(if this contains other)
+     * @param {Box2} box 其它包围盒
+     * @returns {boolean} 二维包围盒包含判断结果
      */
-    clearExtension(): void;
+    containsBox(box: Box2): boolean;
     /**
-     * @description 转换为 CreateInfo（用于元素复制/导出）
-     * @param withParent 是否包含父节点ID
-     * @returns CreateInfo 对象
+     * 获取点以包围盒左上角顶点为原点的相对位置
+     * @param {Vector2} point 指定二维空间点
+     * @param {Vector2} [target=new Vector2()] 目标空间点
+     * @returns {Vector2} 计算结果空间点
      */
-    abstract toCreateInfo(withParent?: boolean): ItemCreateInfo;
+    getParameter(point: Vector2, target?: Vector2): Vector2;
     /**
-     * @description 克隆 SDKItem
-     * @returns 新的 SDKItem 实例
+     * 求点与二维包围盒的最近点
+     * @param {Vector2} point 二维空间点
+     * @param {Vector2} [target=new Vector2()] 结果点
+     * @returns {Vector2} 二维空间点
      */
-    abstract clone(): BaseItem;
+    clampPoint(point: Vector2, target?: Vector2): Vector2;
     /**
-     * @description 获取基础属性的 JSON 对象,转换为普通对象（用于序列化）
-     * @returns 普通对象
+     * 求点到二维包围盒的距离
+     * @param {Vector2} point 二维空间点
+     * @returns {number} 距离
      */
-    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 {
+    distanceToPoint(point: Vector2): number;
     /**
-     * @description 元素类型
+     * 二维包围盒求交集
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 求交结果
      */
-    readonly type = SDKItemType.SPRITE;
+    intersect(box: Box2): this;
     /**
-     * @description 元素属性
+     * 二维包围盒求并集
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 求并结果
      */
-    property: SpriteItemProperty;
-    constructor(options: SpriteItemOptions);
+    union(target: Box2 | Vector2): this;
     /**
-     * @description 图片地址
+     * 二维包围盒位移
+     * @param {Vector2} offset 位移向量
+     * @returns {Box2} 位移结果
      */
-    get image(): string;
-    set image(value: string);
+    translate(offset: Vector2): this;
+    scale(scalar: number | Vector2, anchor?: Vector2): this;
     /**
-     * @description 位置
+     * 二维包围盒判等
+     * @param {Box2} box 二维包围盒
+     * @returns {boolean} 判等结果
      */
-    get position(): [number, number];
-    set position(value: [number, number]);
-    get width(): number;
-    set width(value: number);
-    get height(): number;
-    set height(value: number);
+    equals(box: Box2): boolean;
     /**
-     * @description 旋转（二维旋转角度）
+     * 判断二维包围盒相交关系(if this intersect other)
+     * @param {Box2} box 二维包围盒
+     * @param {boolean} [isOrthogonal=true] 正交判断(当前包围盒)
+     * @returns {boolean} 相交判断结果
      */
-    get rotation(): number;
-    set rotation(value: number);
+    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 = {
     /**
-     * @description 完整旋转（包含 x, y, z）
+     * 导出类型
      */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
+    mediaType: MediaType;
     /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
+     * 额外画布，导出透明视频时使用
      */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
+    extraCanvas?: HTMLCanvasElement | null;
     /**
-     * @description 转换为 CreateInfo
-     * @param withParent 是否包含父节点ID
+     * 是否打印转码过程中的日志，仅在导出 MP4/AlphaMaskVideo 时有效， 默认 false
+     * 供开发调试使用
      */
-    toCreateInfo(withParent?: boolean): SpriteCreateInfo;
+    loggerInTranscoding?: boolean;
     /**
-     * @description 克隆 SDKItem
+     * ffmpeg 转码是否开启多线程，默认 false，确保环境支持 SharedArrayBuffer
      */
-    clone(): SpriteItem;
+    multiThreading?: boolean;
     /**
-     * @description 创建包含扩展属性的 CreateInfo
-     * @param withParent 是否包含父节点ID
-     * @param extraProps 额外的属性
+     * 是否输出 buffer，默认 false
      */
-    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 {
+    isOutputBuffer?: boolean;
+};
+type MP4Config = {
     /**
-     * @description 元素类型
+     * @description MP4 导出时是否需要导出最后一帧 PNG
      */
-    readonly type = SDKItemType.TEXT;
+    isExportLastFrameJPEG?: boolean;
+};
+type GifConfig = {
     /**
-     * @description 元素属性
+     * @description GIF 导出时的帧率
      */
-    property: TextItemProperty;
-    constructor(options: TextItemOptions);
+    fps?: number;
     /**
-     * @description 文本内容
+     * @description GIF 导出时的缩放比例
+     * 默认 '-1:-1'， 表示不缩放
+     * 例如 '100:-1'， 表示宽度 100，高度自动
+     * 例如 '-1:100'， 表示宽度自动，高度 100
      */
-    get text(): string;
-    set text(value: string);
+    scale?: string;
     /**
-     * @description 字体名称
+     * @description GIF 导出时的质量
+     * 默认 'highest'
+     * 可选 'highest', 'high', 'medium', 'low'
      */
-    get fontFamily(): string;
-    set fontFamily(value: string);
+    quality?: keyof typeof GIF_QUALITY_TO_FFMPEG_ARGS;
+};
+type ApngConfig = {
     /**
-     * @description 字号
+     * @description APNG 导出时的帧率
      */
-    get fontSize(): number;
-    set fontSize(value: number);
+    fps?: number;
     /**
-     * @description 字重
+     * @description APNG 导出时的缩放比例
+     * 默认 '-1:-1'， 表示不缩放
+     * 例如 '100:-1'， 表示宽度 100，高度自动
+     * 例如 '-1:100'， 表示宽度自动，高度 100
      */
-    get fontWeight(): spec.TextWeight;
-    set fontWeight(value: spec.TextWeight);
+    scale?: string;
     /**
-     * @description 字体样式
+     * @description APNG 导出时的质量
+     * 默认 'highest'
+     * 可选 'highest', 'high', 'medium', 'low'
      */
-    get fontStyle(): spec.FontStyle;
-    set fontStyle(value: spec.FontStyle);
+    quality?: keyof typeof GIF_QUALITY_TO_FFMPEG_ARGS;
+};
+type ExportMediaItemOptions = {
     /**
-     * @description 文本对齐方式
+     * 尺寸
      */
-    get textAlign(): spec.TextAlignment;
-    set textAlign(value: spec.TextAlignment);
+    size: [number, number];
     /**
-     * @description 文本颜色 [r, g, b, a]
+     * 动效资源
      */
-    get color(): [number, number, number, number];
-    set color(value: [number, number, number, number]);
+    scene: spec.JSONScene;
     /**
-     * @description 文本宽度
+     * 视频时长，目前仅在导出 MP4 / AlphaMaskVideo 时有效，默认取动效资源时长
      */
-    get width(): number;
-    set width(value: number);
+    time?: number;
     /**
-     * @description 行高
+     * 是否生成音轨，默认 false，仅在导出 MP4 时有效
      */
-    get lineHeight(): number;
-    set lineHeight(value: number);
+    audioEnable?: boolean;
     /**
-     * @description 文本高度
+     * 帧率， 默认 30
      */
-    get height(): number;
-    set height(value: number);
+    fps?: number;
     /**
-     * @description 描边颜色
+     * 是否循环，默认 true
      */
-    get outlineColor(): spec.vec4 | undefined;
-    set outlineColor(value: spec.vec4 | undefined);
+    loop?: boolean;
     /**
-     * @description 描边宽度
+     * 视频背景颜色，默认 #000000
      */
-    get outlineWidth(): number | undefined;
-    set outlineWidth(value: number | undefined);
+    backgroundColor?: string;
     /**
-     * @description 描边开关
+     * 导出 MP4 时，设置的导出配置
      */
-    get outlineEnabled(): boolean;
-    set outlineEnabled(value: boolean);
+    mp4Config?: MP4Config;
     /**
-     * @description 位置
+     * 导出 GIF 时，设置的导出配置
      */
-    get position(): [number, number];
-    set position(value: [number, number]);
+    gifConfig?: GifConfig;
     /**
-     * @description 旋转（二维旋转角度）
+     * 导出 APNG 时，设置的导出配置
      */
-    get rotation(): number;
-    set rotation(value: number);
+    apngConfig?: ApngConfig;
+};
+type ExportMediaItemDownloadInfo = {
     /**
-     * @description 转换为 CreateInfo
-     * @param withParent 是否包含父节点ID
+     * @description 导出文件夹名称
      */
-    toCreateInfo(withParent?: boolean): TextCreateInfo;
+    folderName: string;
     /**
-     * @description 克隆 SDKItem
+     * @description 导出视频名称
      */
-    clone(): TextItem;
-}
-/**
- * @description 类型守卫：检查是否是 TextItem
- */
-declare function isTextItem(obj: any): obj is TextItem;
+    name: string;
+};
+type ExportItemParams = ExportMediaItemOptions & ExportMediaItemDownloadInfo;
+type ExportParams = ExportItemParams[];
+type Buffers = FileBuffer[] | undefined;
+type Extras = (FileBuffer | null)[] | null | undefined;
 
 /**
- * @description 视频元素 SDKItem 类
- * @description 支持属性扩展
+ * @description SDKItem 基础选项接口
+ * @description 支持扩展属性，允许添加任意额外属性
  */
-declare class VideoItem extends BaseItem {
+type SDKItemOptions = {
     /**
-     * @description 元素类型
+     * @description 元素ID
      */
-    readonly type = SDKItemType.VIDEO;
+    id: string;
     /**
-     * @description 元素属性
+     * @description 元素名称
      */
-    property: VideoItemProperty;
-    constructor(options: VideoItemOptions);
+    name: string;
     /**
-     * @description 视频地址
+     * @description 父节点ID
      */
-    get video(): string;
-    set video(value: string);
+    parentId?: string;
     /**
-     * @description 位置
+     * @description 子元素ID列表
      */
-    get position(): [number, number];
-    set position(value: [number, number]);
+    children?: string[];
     /**
-     * @description 宽度
+     * @description 元素生命周期
+     */
+    duration?: number;
+    /**
+     * @description 元素生命周期延时
+     */
+    delay?: number;
+    /**
+     * @description 可视状态
+     */
+    visible?: boolean;
+    /**
+     * @description 元素结束行为
      */
-    get width(): number;
-    set width(value: number);
+    endBehavior?: spec.EndBehavior;
     /**
-     * @description 高度
+     * @description 是否处于锁定状态
      */
-    get height(): number;
-    set height(value: number);
+    isLocked?: boolean;
     /**
-     * @description 旋转（二维旋转角度）
+     * @description 关键属性是否可编辑
      */
-    get rotation(): number;
-    set rotation(value: number);
+    isCoreEditable: boolean;
     /**
-     * @description 完整旋转（包含 x, y, z）
+     * @description 扩展属性存储（属性名 -> 属性值）
      */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
+    extension?: Record<string, any>;
     /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
+     * @description 允许任意额外属性（用于兼容旧代码）
      */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
+    [extraProp: string]: any;
+};
+/**
+ * @description Sprite SDKItem 选项
+ */
+type SpriteItemOptions = SDKItemOptions & {
     /**
-     * @description 是否静音
+     * @description 元素属性
      */
-    get muted(): boolean;
-    set muted(state: boolean);
+    property?: Partial<SpriteItemProperty>;
+};
+/**
+ * @description Text SDKItem 选项
+ */
+type TextItemOptions = SDKItemOptions & {
     /**
-     * @description 是否为透明视频
+     * @description 元素属性
      */
-    get transparent(): boolean;
-    set transparent(state: boolean);
+    property?: Partial<TextItemProperty>;
+};
+/**
+ * @description Video SDKItem 选项
+ */
+type VideoItemOptions = SDKItemOptions & {
     /**
-     * @description 播放音量
+     * @description 元素属性
      */
-    get volume(): number;
-    set volume(value: number);
+    property?: Partial<VideoItemProperty>;
+};
+/**
+ * @description Group SDKItem 选项（空节点/组）
+ */
+type GroupItemOptions = SDKItemOptions & {
     /**
-     * @description 播放速率
+     * @description 元素属性
      */
-    get playbackRate(): number;
-    set playbackRate(value: number);
+    property?: Partial<GroupItemProperty>;
+};
+/**
+ * @description Generator SDKItem 选项（资源生成器）
+ * @description 支持 image 和 video 两种生成器类型
+ * @description 使用 GeneratorItemProperty 包含 generatorType
+ */
+type GeneratorItemOptions = SDKItemOptions & {
     /**
-     * @description 转换为 CreateInfo
-     * @param withParent 是否包含父节点ID
+     * @description 元素属性（包含 generatorType）
      */
-    toCreateInfo(withParent?: boolean): VideoCreateInfo;
+    property?: Partial<GeneratorItemProperty>;
+};
+type EffectsItemOptions = SDKItemOptions & {
+    property?: Partial<EffectsItemProperty>;
+};
+/**
+ * @description Frame 画板元素 SDKItem 选项
+ */
+type FrameItemOptions = SDKItemOptions & {
     /**
-     * @description 克隆 SDKItem
+     * @description 元素属性
      */
-    clone(): VideoItem;
-}
+    property?: Partial<FrameItemProperty>;
+};
 /**
- * @description 类型守卫：检查是否是 VideoItem
+ * @description SDKItem 类型（独立于 spec.ItemType）
+ * @description 包含所有 SDK 层级的元素类型，包括虚拟类型如 generator
  */
-declare function isVideoItem(obj: any): obj is VideoItem;
+declare enum SDKItemType {
+    SPRITE = "sprite",
+    TEXT = "text",
+    VIDEO = "video",
+    GROUP = "group",
+    GENERATOR = "generator",
+    EFFECTS = "effects",
+    FRAME = "frame"
+}
 
 /**
- * @description 空节点/组 SDKItem 类
- * @description 支持属性扩展
+ * @description SDKItem 抽象基类
+ * @description 支持属性扩展，允许添加任意自定义属性
  */
-declare class GroupItem extends BaseItem {
+declare abstract class BaseItem {
     /**
-     * @description 元素类型
+     * @description 元素ID
      */
-    readonly type = SDKItemType.GROUP;
+    id: string;
     /**
-     * @description 元素属性
+     * @description 元素名称
      */
-    property: GroupItemProperty;
-    constructor(options: GroupItemOptions);
+    name: string;
     /**
-     * @description 位置
+     * @description 父节点ID
      */
-    get position(): [number, number];
-    set position(value: [number, number]);
+    parentId?: string;
     /**
-     * @description 大小
+     * @description 元素生命周期
      */
-    get scale(): [number, number];
-    set scale(value: [number, number]);
+    duration: number;
     /**
-     * @description 旋转（二维旋转角度）
+     * @description 元素生命周期延时
      */
-    get rotation(): number;
-    set rotation(value: number);
+    delay: number;
     /**
-     * @description 完整旋转（包含 x, y, z）
+     * @description 元素结束行为
      */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
+    endBehavior: spec.EndBehavior;
     /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
+     * @description 是否可见
      */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
+    visible: boolean;
     /**
-     * @description 转换为 CreateInfo
-     * @param withParent 是否包含父节点ID
+     * @description 是否处于锁定状态
      */
-    toCreateInfo(withParent?: boolean): GroupCreateInfo;
+    isLocked: boolean;
     /**
-     * @description 克隆 SDKItem
+     * @description 核心数据是否支持编辑
      */
-    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 {
+    isCoreEditable: boolean;
     /**
-     * @description 元素类型（独立类型，不属于 spec.ItemType）
+     * @description 扩展属性存储（与 property 同级）
      */
-    readonly type = SDKItemType.GENERATOR;
+    extension: Map<string, any>;
     /**
-     * @description 元素属性（包含 generatorType）
+     * @description 元素类型（由子类实现）
+     * @description 支持 spec.ItemType 或扩展的 SDKItemType
      */
-    property: GeneratorItemProperty;
-    constructor(options: GeneratorItemOptions);
+    abstract readonly type: SDKItemType;
     /**
-     * @description 生成器类型
+     * @description 元素属性（由子类实现）
      */
-    get generatorType(): 'image' | 'video';
-    set generatorType(value: 'image' | 'video');
+    abstract readonly property: BaseItemProperty;
+    constructor(options: SDKItemOptions);
     /**
-     * @description 图片地址（生成器返回空）
+     * @description 设置扩展属性
+     * @param key 属性名
+     * @param value 属性值
      */
-    get image(): string;
-    set image(_value: string);
+    setExtension(key: string, value: any): void;
     /**
-     * @description 位置
+     * @description 获取扩展属性
+     * @param key 属性名
+     * @returns 属性值
      */
-    get position(): [number, number];
-    set position(value: [number, number]);
+    getExtension(key: string): any;
     /**
-     * @description 宽度
+     * @description 检查是否存在指定扩展属性
+     * @param key 属性名
+     * @returns 是否存在
      */
-    get width(): number;
-    set width(value: number);
+    hasExtension(key: string): boolean;
     /**
-     * @description 高度
+     * @description 删除扩展属性
+     * @param key 属性名
+     * @returns 是否删除成功
      */
-    get height(): number;
-    set height(value: number);
+    deleteExtension(key: string): boolean;
     /**
-     * @description 旋转（二维旋转角度）
+     * @description 获取所有扩展属性的键名列表
+     * @returns 键名数组
      */
-    get rotation(): number;
-    set rotation(value: number);
+    getExtensionKeys(): string[];
     /**
-     * @description 完整旋转（包含 x, y, z）
+     * @description 获取所有扩展属性
+     * @returns 扩展属性对象
      */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
+    getAllExtension(): Record<string, any>;
     /**
-     * @description 是否正在编辑关键属性
-     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
+     * @description 批量设置扩展属性
+     * @param extensions 扩展属性对象
      */
-    get keyPropertyEditing(): boolean;
-    set keyPropertyEditing(value: boolean);
+    setExtensions(extensions: Record<string, any>): void;
     /**
-     * @description 转换为 GeneratorCreateInfo
-     * @param withParent 是否包含父节点ID
+     * @description 清空所有扩展属性
      */
-    toCreateInfo(withParent?: boolean): GeneratorCreateInfo;
+    clearExtension(): void;
     /**
-     * @description 转换为 VideoCreateInfo（用于转换为视频元素）
-     * @param videoUrl 视频资源地址
+     * @description 转换为 CreateInfo（用于元素复制/导出）
      * @param withParent 是否包含父节点ID
+     * @returns CreateInfo 对象
      */
-    toVideoCreateInfo(videoUrl: string, withParent?: boolean): VideoCreateInfo;
+    abstract toCreateInfo(withParent?: boolean): ItemCreateInfo;
     /**
-     * @description 转换为 SpriteCreateInfo（用于转换为图片元素）
-     * @param imageUrl 图片资源地址
-     * @param withParent 是否包含父节点ID
+     * @description 克隆 SDKItem
+     * @returns 新的 SDKItem 实例
      */
-    toSpriteCreateInfo(imageUrl: string, withParent?: boolean): SpriteCreateInfo;
+    abstract clone(): BaseItem;
     /**
-     * @description 克隆 SDKItem
+     * @description 获取基础属性的 JSON 对象,转换为普通对象（用于序列化）
+     * @returns 普通对象
      */
-    clone(): GeneratorItem;
+    toJSON(): Record<string, any>;
 }
 /**
- * @description 类型守卫：检查是否是 GeneratorItem
+ * @description 类型守卫函数：检查对象是否是 BaseItem
+ * @param obj 要检查的对象
+ * @returns 是否是 BaseItem 实例
  */
-declare function isGeneratorItem(obj: any): obj is GeneratorItem;
+declare function isBaseItem(obj: any): obj is BaseItem;
 
 /**
- * @description 特效产物 元素 SDKItem 类
+ * @description 图片元素 SDKItem 类
+ * @description 支持属性扩展
  */
-declare class EffectsItem extends BaseItem {
+declare class SpriteItem extends BaseItem {
     /**
-     * @description 元素类型（独立类型，不属于 spec.ItemType）
+     * @description 元素类型
      */
-    readonly type = SDKItemType.EFFECTS;
+    readonly type = SDKItemType.SPRITE;
     /**
      * @description 元素属性
      */
-    property: EffectsItemProperty;
-    constructor(options: EffectsItemOptions);
+    property: SpriteItemProperty;
+    constructor(options: SpriteItemOptions);
     /**
-     * @description 特效资源地址
+     * @description 图片地址
      */
-    get effects(): string;
-    set effects(value: string);
+    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);
     /**
@@ -692,604 +769,534 @@ declare class EffectsItem extends BaseItem {
     get keyPropertyEditing(): boolean;
     set keyPropertyEditing(value: boolean);
     /**
-     * @description 转换为 EffectsCreateInfo
+     * @description 转换为 CreateInfo
      * @param withParent 是否包含父节点ID
      */
-    toCreateInfo(withParent?: boolean): EffectsCreateInfo;
+    toCreateInfo(withParent?: boolean): SpriteCreateInfo;
     /**
      * @description 克隆 SDKItem
      */
-    clone(): EffectsItem;
+    clone(): SpriteItem;
+    /**
+     * @description 创建包含扩展属性的 CreateInfo
+     * @param withParent 是否包含父节点ID
+     * @param extraProps 额外的属性
+     */
+    toCreateInfoWithExtensions(withParent?: boolean, extraProps?: Record<string, any>): SpriteCreateInfo;
 }
 /**
- * @description 类型守卫：检查是否是 EffectsItem
+ * @description 类型守卫：检查是否是 SpriteItem
  */
-declare function isEffectsItem(obj: any): obj is EffectsItem;
+declare function isSpriteItem(obj: any): obj is SpriteItem;
 
 /**
- * @description 画板/框架元素 SDKItem 类
- * @description 支持自动布局和自由布局两种模式
- * @description 底层以 composition 形式渲染
+ * @description 文本元素 SDKItem 类
+ * @description 支持属性扩展
  */
-declare class FrameItem extends BaseItem {
+declare class TextItem extends BaseItem {
     /**
      * @description 元素类型
      */
-    readonly type = SDKItemType.FRAME;
+    readonly type = SDKItemType.TEXT;
     /**
      * @description 元素属性
      */
-    property: FrameItemProperty;
-    constructor(options: FrameItemOptions);
+    property: TextItemProperty;
+    constructor(options: TextItemOptions);
     /**
-     * @description 子元素ID列表（只读）
+     * @description 文本内容
      */
-    get children(): readonly string[];
+    get text(): string;
+    set text(value: string);
     /**
-     * @description 布局模式
+     * @description 字体名称
      */
-    get layoutMode(): FrameLayoutMode;
-    set layoutMode(value: FrameLayoutMode);
+    get fontFamily(): string;
+    set fontFamily(value: string);
     /**
-     * @description 位置
+     * @description 字号
      */
-    get position(): [number, number];
-    set position(value: [number, number]);
+    get fontSize(): number;
+    set fontSize(value: number);
     /**
-     * @description 宽度
+     * @description 字重
      */
-    get width(): number;
-    set width(value: number);
+    get fontWeight(): spec.TextWeight;
+    set fontWeight(value: spec.TextWeight);
     /**
-     * @description 高度
+     * @description 字体样式
      */
-    get height(): number;
-    set height(value: number);
+    get fontStyle(): spec.FontStyle;
+    set fontStyle(value: spec.FontStyle);
     /**
-     * @description 缩放
+     * @description 文本对齐方式
      */
-    get scale(): [number, number];
-    set scale(value: [number, number]);
+    get textAlign(): spec.TextAlignment;
+    set textAlign(value: spec.TextAlignment);
     /**
-     * @description 旋转（二维旋转角度）
+     * @description 文本颜色 [r, g, b, a]
      */
-    get rotation(): number;
-    set rotation(value: number);
+    get color(): [number, number, number, number];
+    set color(value: [number, number, number, number]);
     /**
-     * @description 完整旋转（包含 x, y, z）
+     * @description 文本宽度
      */
-    get fullRotation(): [number, number, number];
-    set fullRotation(value: [number, number, number]);
+    get width(): number;
+    set width(value: number);
     /**
-     * @description 添加子元素
-     * @param itemId 子元素ID
-     * @returns 是否添加成功
+     * @description 行高
      */
-    addChild(itemId: string): boolean;
+    get lineHeight(): number;
+    set lineHeight(value: number);
     /**
-     * @description 批量添加子元素
-     * @param itemIds 子元素ID列表
+     * @description 文本高度
      */
-    addChildren(itemIds: string[]): void;
+    get height(): number;
+    set height(value: number);
     /**
-     * @description 移除子元素
-     * @param itemId 子元素ID
-     * @returns 是否移除成功
+     * @description 描边颜色
      */
-    removeChild(itemId: string): boolean;
+    get outlineColor(): spec.vec4 | undefined;
+    set outlineColor(value: spec.vec4 | undefined);
     /**
-     * @description 批量移除子元素
-     * @param itemIds 子元素ID列表
+     * @description 描边宽度
      */
-    removeChildren(itemIds: string[]): void;
+    get outlineWidth(): number | undefined;
+    set outlineWidth(value: number | undefined);
     /**
-     * @description 是否包含指定子元素
-     * @param itemId 子元素ID
+     * @description 描边开关
      */
-    hasChild(itemId: string): boolean;
+    get outlineEnabled(): boolean;
+    set outlineEnabled(value: boolean);
     /**
-     * @description 清空所有子元素
+     * @description 位置
      */
-    clearChildren(): void;
+    get position(): [number, number];
+    set position(value: [number, number]);
     /**
-     * @description 转换为 FrameCreateInfo
+     * @description 旋转（二维旋转角度）
+     */
+    get rotation(): number;
+    set rotation(value: number);
+    /**
+     * @description 转换为 CreateInfo
      * @param withParent 是否包含父节点ID
      */
-    toCreateInfo(withParent?: boolean): FrameCreateInfo;
+    toCreateInfo(withParent?: boolean): TextCreateInfo;
     /**
      * @description 克隆 SDKItem
      */
-    clone(): FrameItem;
+    clone(): TextItem;
 }
 /**
- * @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
+ * @description 类型守卫：检查是否是 TextItem
  */
-type SDKItem$1 = SpriteItem | TextItem | VideoItem | GroupItem | GeneratorItem | EffectsItem | FrameItem;
+declare function isTextItem(obj: any): obj is TextItem;
 
 /**
- * @class 二维线段
+ * @description 视频元素 SDKItem 类
+ * @description 支持属性扩展
  */
-declare class Line2 {
-    start: Vector2;
-    end: Vector2;
-    constructor(start?: Vector2, end?: Vector2);
+declare class VideoItem extends BaseItem {
     /**
-     * 设置二维线段
-     * @param {Vector2} start 线段起点
-     * @param {Vector2} end 线段终点
-     * @returns {Line2} 二维线段
+     * @description 元素类型
      */
-    set(start: Vector2, end: Vector2): this;
+    readonly type = SDKItemType.VIDEO;
     /**
-     * 复制二维线段
-     * @param {Line2} line 复制对象
-     * @returns {Line2} 复制结果
+     * @description 元素属性
      */
-    copyFrom(line: Line2): this;
+    property: VideoItemProperty;
+    constructor(options: VideoItemOptions);
     /**
-     * 二维线段求方向
-     * @returns {Vector2} 二维线段方向
+     * @description 视频地址
      */
-    direction(): Vector2;
+    get video(): string;
+    set video(value: string);
     /**
-     * 二维线段求中点
-     * @param {Vector2} [target=new Vector2()] 目标保存对象
-     * @returns {Vector2} 二维线段中点
+     * @description 位置
      */
-    getCenter(target?: Vector2): Vector2;
+    get position(): [number, number];
+    set position(value: [number, number]);
     /**
-     * 二维线段向量值
-     * @param {Vector2} [target=new Vector2()] 目标保存对象
-     * @returns {Vector2} 二维线段向量值
+     * @description 宽度
      */
-    delta(target?: Vector2): Vector2;
+    get width(): number;
+    set width(value: number);
     /**
-     * 二维线段欧式距离平方(应用于计算)
-     * @returns {number} 计算结果
+     * @description 高度
      */
-    distanceSq(): number;
+    get height(): number;
+    set height(value: number);
     /**
-     * 二维线段欧式距离
-     * @returns {number} 计算结果
+     * @description 旋转（二维旋转角度）
      */
-    distance(): number;
+    get rotation(): number;
+    set rotation(value: number);
     /**
-     * 求二维线段比例点
-     * @param {number} t 比例值
-     * @param {Vector2} target 目标保存对象
-     * @returns {Vector2} 比例点结果
+     * @description 完整旋转（包含 x, y, z）
      */
-    at(t: number, target?: Vector2): Vector2;
+    get fullRotation(): [number, number, number];
+    set fullRotation(value: [number, number, number]);
     /**
-     * 求点与线段的最短距离
-     * @param {Vector2} point 二维空间点
-     * @param {boolean} clampToLine 是否限制于线段内
-     * @returns {number} 距离结果
+     * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
-    closestPointToPointParameter(point: Vector2, clampToLine: boolean): number;
+    get keyPropertyEditing(): boolean;
+    set keyPropertyEditing(value: boolean);
     /**
-     * 求点与线段的最近交点
-     * @param {Vector2} point 二维空间点
-     * @param {boolean} clampToLine 是否限制于线段内
-     * @param {Vector2} target 目标保存对象
-     * @returns {Vector2} 最近交点
+     * @description 是否静音
      */
-    closestPointToPoint(point: Vector2, clampToLine: boolean, target?: Vector2): Vector2;
+    get muted(): boolean;
+    set muted(state: boolean);
     /**
-     * 二维线段判等
-     * @param {Line2} line 二维线段
-     * @returns {boolean} 判等结果
+     * @description 是否为透明视频
      */
-    equals(line: Line2): boolean;
+    get transparent(): boolean;
+    set transparent(state: boolean);
+    /**
+     * @description 播放音量
+     */
+    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
      */
-    setFromVec2ArrayWithOutCorners(vecArray: Vector2[]): this;
+    toCreateInfo(withParent?: boolean): GroupCreateInfo;
     /**
-     * 通过中心与大小设置二维包围盒
-     * @param {Vector2} center 二维中心点
-     * @param {Vector2} size 二维大小
-     * @returns {Box2} 二维包围盒
+     * @description 克隆 SDKItem
      */
-    setFromCenterAndSize(center: Vector2, size: 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 {
     /**
-     * 克隆二维包围盒
-     * @returns {Box2} 克隆结果
+     * @description 元素类型（独立类型，不属于 spec.ItemType）
      */
-    clone(): Box2;
+    readonly type = SDKItemType.GENERATOR;
     /**
-     * 复制二维包围盒
-     * @param {Box2} box 二维包围盒
-     * @returns {Box2} 复制结果
+     * @description 元素属性（包含 generatorType）
      */
-    copyFrom(box: Box2): this;
+    property: GeneratorItemProperty;
+    constructor(options: GeneratorItemOptions);
     /**
-     * 二维包围盒置空
-     * @returns {Box2} 置空结果
+     * @description 生成器类型
      */
-    makeEmpty(): this;
+    get generatorType(): 'image' | 'video';
+    set generatorType(value: 'image' | 'video');
     /**
-     * 二维包围盒判空
-     * @returns {boolean} 判空结果
+     * @description 图片地址（生成器返回空）
      */
-    isEmpty(): boolean;
+    get image(): string;
+    set image(_value: string);
     /**
-     * 获取二维包围盒角点
-     * @returns {Vector2[]} 二维包围盒角点
+     * @description 位置
      */
-    getCorners(): Vector2[];
+    get position(): [number, number];
+    set position(value: [number, number]);
     /**
-     * 获取二维包围盒中心点
-     * @param {Vector2} [target=new Vector2()] 目标点(用以存放二维包围盒中心点)
-     * @returns {Vector2} 二维包围盒中心点
+     * @description 宽度
      */
-    getCenter(target?: Vector2): Vector2;
+    get width(): number;
+    set width(value: number);
     /**
-     * 获取二维包围盒大小
-     * @param {Vector2} [target=new Vector2()] 目标向量(用以存放二维包围盒大小)
-     * @returns {Vector2} 二维包围盒大小
+     * @description 高度
      */
-    getSize(target?: Vector2): Vector2;
+    get height(): number;
+    set height(value: number);
     /**
-     * 通过二维空间点扩展二维包围盒
-     * @param {Vector2} point 二维空间点
-     * @returns {Box2} 扩展包围盒
+     * @description 旋转（二维旋转角度）
      */
-    expandByPoint(point: Vector2): this;
+    get rotation(): number;
+    set rotation(value: number);
     /**
-     * 通过向量扩展二维包围盒
-     * @param {Vector2} vector 二维向量
-     * @returns {Box2} 扩展结果
+     * @description 完整旋转（包含 x, y, z）
      */
-    expandByVector(vector: Vector2): this;
+    get fullRotation(): [number, number, number];
+    set fullRotation(value: [number, number, number]);
     /**
-     * 通过大小扩展二维包围盒
-     * @param {number} scalar 扩展大小
-     * @returns {Box2} 扩展结果
+     * @description 是否正在编辑关键属性
+     * @deprecated 该属性即将废弃，使用 isCoreEditable 代替
      */
-    expandByScalar(scalar: number): this;
+    get keyPropertyEditing(): boolean;
+    set keyPropertyEditing(value: boolean);
     /**
-     * 判断二维包围盒是否包含二维空间点
-     * @param {Vector2} point 二维空间点
-     * @param {boolean} [isOrthogonal=true] 包围盒正交判断(默认为true)
-     * @returns {boolean} 点包含判断结果
+     * @description 转换为 GeneratorCreateInfo
+     * @param withParent 是否包含父节点ID
      */
-    containsPoint(point: Vector2, isOrthogonal?: boolean): boolean;
+    toCreateInfo(withParent?: boolean): GeneratorCreateInfo;
     /**
-     * 判断二维包围盒包含关系(if this contains other)
-     * @param {Box2} box 其它包围盒
-     * @returns {boolean} 二维包围盒包含判断结果
+     * @description 转换为 VideoCreateInfo（用于转换为视频元素）
+     * @param videoUrl 视频资源地址
+     * @param withParent 是否包含父节点ID
      */
-    containsBox(box: Box2): boolean;
+    toVideoCreateInfo(videoUrl: string, withParent?: boolean): VideoCreateInfo;
     /**
-     * 获取点以包围盒左上角顶点为原点的相对位置
-     * @param {Vector2} point 指定二维空间点
-     * @param {Vector2} [target=new Vector2()] 目标空间点
-     * @returns {Vector2} 计算结果空间点
+     * @description 转换为 SpriteCreateInfo（用于转换为图片元素）
+     * @param imageUrl 图片资源地址
+     * @param withParent 是否包含父节点ID
      */
-    getParameter(point: Vector2, target?: Vector2): Vector2;
+    toSpriteCreateInfo(imageUrl: string, withParent?: boolean): SpriteCreateInfo;
     /**
-     * 求点与二维包围盒的最近点
-     * @param {Vector2} point 二维空间点
-     * @param {Vector2} [target=new Vector2()] 结果点
-     * @returns {Vector2} 二维空间点
+     * @description 克隆 SDKItem
      */
-    clampPoint(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 二维空间点
-     * @returns {number} 距离
+     * @description 元素类型（独立类型，不属于 spec.ItemType）
      */
-    distanceToPoint(point: Vector2): number;
+    readonly type = SDKItemType.EFFECTS;
     /**
-     * 二维包围盒求交集
-     * @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;
+    subCompositionId: 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];
@@ -1351,6 +1358,7 @@ type GeneratorItemProperty = BaseItemProperty & {
 };
 type EffectsItemProperty = BaseItemProperty & {
     effects: string;
+    children?: string[];
 };
 /**
  * @description Frame 画板元素布局模式
@@ -1670,13 +1678,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 图层创建信息
@@ -2147,6 +2148,10 @@ type FrameCreateInfo = {
          * @description 布局模式: 'auto' | 'free'
          */
         layoutMode?: FrameLayoutMode;
+        /**
+         * @description 子元素序号
+         */
+        children: string[];
     };
     /**
      * @description 扩展属性
@@ -2332,6 +2337,7 @@ type ExportConfig = {
  */
 type ScreenShotConfig = {
     enabled: boolean;
+    defaultBackgroundColor: [number, number, number, number];
 };
 /**
  * @description 尺寸自适应功能配置
@@ -3094,13 +3100,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 获取场景预览图
@@ -3421,6 +3427,9 @@ 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;
@@ -3433,7 +3442,7 @@ declare class SDK {
      */
     addGeneratorItem(createInfo: GeneratorCreateInfo): string;
     /**
-     * @description 创建动效元素（仅限调试使用）
+     * @description 创建动效元素
      * @param effectsInfo 动效创建信息
      */
     addEffectsItem(effectsInfo: EffectsCreateInfo): Promise<string | undefined>;
@@ -3442,7 +3451,7 @@ declare class SDK {
      * @param createInfo 画板创建信息
      * @returns 画板元素ID
      */
-    addFrameItem(createInfo: FrameCreateInfo): string;
+    addFrameItem(createInfo: FrameCreateInfo): Promise<string>;
     /**
      * @description 设置生成器资源，将生成器转换为对应的元素
      * @param id 生成器元素ID
@@ -3473,4 +3482,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 FrameCreateInfo, FrameItem, type FrameItemOptions, type FrameItemProperty, FrameLayoutMode, type GeneratorCreateInfo, GeneratorItem, type GeneratorItemOptions, type GeneratorItemProperty, type GizmoType, type GroupCreateInfo, GroupItem, type GroupItemOptions, type ItemCreateInfo, ItemOrderAction, type ItemPropertyMap, type Operation, type PageData, type PageProperty, SDK, type SDKEvents, type SDKInputParam, type SDKItem$1 as SDKItem, type SDKItemOptions, SDKItemType, type SDKOptions, type SetItemPropertyParam, type SetSingleItemMultiplePropertiesParam, type SetSingleItemSinglePropertyParam, type SpriteCreateInfo, SpriteItem, type SpriteItemOptions, type SpriteItemProperty, type TextCreateInfo, TextItem, type TextItemOptions, type TextItemProperty, type UpdateOperation, Vector2, type VideoCreateInfo, VideoItem, type VideoItemOptions, type VideoItemProperty, type ViewParam, type ViewProperty, createSDKItem, isBaseItem, isEffectsItem, isFrameItem, isGeneratorItem, isGroupItem, isSpriteItem, isTextItem, isVideoItem };
+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 };