@vvfx/artis 0.0.1-alpha.0

package/dist/artis-sdk/artis-sdk.d.ts

@@ -0,0 +1,1117 @@
+import { Artis, type ArtisOptions } from '../artis';
+import { ItemOrderAction, type ItemService, type ArtisItemType, type HistoryManager, type PageAutoLayoutParam, type ItemCreateInfo, type SpriteCreateInfo, type TextCreateInfo, type VideoCreateInfo, type GeneratorCreateInfo, type EffectsCreateInfo, type FrameCreateInfo, type CardCreateInfo, type ArtisData, type InitArtisData, type SetItemPropertyParam, type SceneCreateInfo, type GeneratorResource, type SpriteGeneratorResource, type VideoGeneratorResource, type CardHTML, type CardItem, type CardTypeConfig } from '../core';
+import { Exporter, type ExportParams, type ExportMediaInitOptions, type ExportMediaItemDownloadInfo, type Buffers, type Extras } from '../helper';
+import { spec } from '../shared';
+import { Box2, Vector2, ItemCreateType, type LoadingItemOptions, type SpriteTextInitParam, type MaskConfig } from '@vvfx/gizmo';
+import { type AlignType, type DistributeType } from '../utils/types';
+/**
+ * ArtisSDK - 兼容门面层（仅 editor 模式）
+ *
+ * 设计目标：
+ * 1. 老用户零成本接入：仅替换 import 路径（`export { ArtisSDK as SDK }`），
+ *    旧方法签名保留并以 @deprecated 委托到新能力。
+ * 2. 新用户可发现新接口：通过父类 {@link Artis} 暴露的命名空间
+ *    （`item` / `command` / `selection` / `view` / `history` / `preferences` / `htmlCard` / `screenshot`）使用。
+ *
+ * 约束：
+ * - 本类只支持 editor 模式；template / 多视图能力后续单独封装专用 Artis 子类。
+ * - 所有「写数据」的旧方法在迁移时统一改走 Command（支持撤销/重做）。
+ *
+ * @deprecated 推荐直接使用 {@link Artis} 及其命名空间接口（item/command/view/selection/...），
+ * 或高频快捷门面 {@link Artis.operations}（类型化 addSprite/deleteItem/... 供直接调用）；
+ * 本类仅用于旧 SDK 平滑迁移。
+ */
+export declare class ArtisSDK extends Artis {
+    /** 视频导出器（懒实例化） */
+    private _exporter?;
+    /** openTextGizmo 的 rAF 轮询句柄（dispose 时需取消，避免回调落到已释放的 GestureHandler） */
+    private _textEditRafId?;
+    /**
+     * @param container 画布容器
+     * @param optionsOrMode 兼容旧签名：可传 ArtisOptions；或传旧 mode 字符串（仅 editor 受支持）
+     *
+     * 旧用法 `new SDK(container, 'template')` 仍可调用，但 template 模式不再受支持，
+     * 会退化为 editor 并打印告警。
+     */
+    constructor(container: HTMLElement, optionsOrMode?: ArtisOptions | string);
+    /**
+     * 兼容旧的第二参（mode 字符串）与新的 ArtisOptions。
+     * @param optionsOrMode 兼容旧签名：可传 ArtisOptions；或传旧 mode 字符串（仅 editor 受支持）
+     * @returns 归一化后的 ArtisOptions；mode 字符串退化为 {}，非 editor 模式退化为 editor 并打印告警
+     */
+    private static _normalizeOptions;
+    /**
+     * 获取当前选中元素的 ID 列表（旧 SDK 选中 id 语义）。
+     *
+     * 注意：基类 Artis 的 `_getActiveItems` 返回的是元素对象集合（ArtisItem[]），
+     * 语义不同；本方法沿用旧 SDK 的「选中 id 列表」契约，供兼容层使用。
+     * @deprecated 请使用 `artis.selection.getSelectedIds()`
+     * @returns 当前选中的元素 ID 列表
+     */
+    getActiveItemIds(): string[];
+    /**
+     * 设置选中元素
+     *
+     * @deprecated 请使用 `artis.command.execute('selection.set', { newSelectedIds: itemIds })`（支持撤销/重做）
+     * @param itemIds 选中的元素 ID 列表
+     */
+    setSelectedItems(itemIds: string[]): void;
+    /**
+     * 设置预选中元素
+     *
+     * @deprecated 预选能力在新架构中已下线，调用无效果
+     * @param _id 元素 ID（已忽略）
+     */
+    setPreSelectedItem(_id: string): void;
+    /**
+     * 获取预选中元素
+     *
+     * @deprecated 预选能力在新架构中已下线，恒返回空字符串
+     * @returns 恒返回空字符串
+     */
+    getPreSelectedItem(): string;
+    /**
+     * 获取指定元素（旧 SDKItem，对应新 ArtisItem）
+     * @deprecated 请使用 `artis.item.getArtisItem(id)`
+     * @param id 元素 ID
+     * @returns 元素对象；元素不存在时返回 undefined
+     */
+    getSDKItem(id: string): ReturnType<ItemService['getArtisItem']>;
+    /**
+     * 获取指定元素（ArtisItem）。
+     * @deprecated 请使用 `artis.item.getArtisItem(id)`
+     * @param id 元素 ID
+     * @returns 元素对象；元素不存在时返回 undefined
+     */
+    getArtisItem(id: string): ReturnType<ItemService['getArtisItem']>;
+    /**
+     * 获取多个元素（旧 SDKItem 列表，对应新 ArtisItem）
+     * @deprecated 请使用 `artis.item.getArtisItem(id)` 逐个获取
+     * @param ids 元素 ID 列表，缺省取全部元素
+     * @returns 命中的元素对象列表（跳过不存在的 ID）
+     */
+    getSDKItems(ids?: string[]): NonNullable<ReturnType<ItemService['getArtisItem']>>[];
+    /**
+     * 获取元素的子元素 ID 列表
+     * @deprecated 请使用 `artis.item.getArtisItem(id)` 后读取其 children
+     * @param id 父元素 ID
+     * @returns 子元素 ID 列表；元素不存在或无 children 时返回空数组
+     */
+    getChildrenIds(id: string): string[];
+    /**
+     * 获取元素的像素包围盒
+     * @deprecated 请使用 `artis.item.getPixelBox(id)`
+     * @param idInfo 元素 ID
+     * @returns 元素像素包围盒；元素不存在时返回 undefined
+     */
+    getItemBoxById(idInfo: string): ReturnType<ItemService['getPixelBox']>;
+    /**
+     * 获取元素的锁定状态
+     * @deprecated 请使用 `artis.item.getArtisItem(id)` 读取其锁定状态
+     * @param id 元素 ID
+     * @returns 是否锁定；元素不存在时返回 false
+     */
+    getItemLockState(id: string): boolean;
+    /**
+     * 删除元素（支持单个或批量）
+     *
+     * @deprecated 请使用 `artis.command.execute('item.delete', { itemId: id })` 逐个删除（支持撤销）
+     * @param idInfo 单个元素 ID 或 ID 列表
+     */
+    deleteItems(idInfo: string | string[]): void;
+    /**
+     * 调整元素层级顺序
+     *
+     * @deprecated 请使用 `artis.command.execute('item.reorder', { itemId, reorderType })`，
+     * 其中 reorderType 为 'bringToFront' | 'sendToBack' | 'moveUp' | 'moveDown'
+     * @param id 元素 ID
+     * @param action 旧的层级操作枚举
+     */
+    updateItemOrder(id: string, action: ItemOrderAction): void;
+    /**
+     * 成组元素
+     *
+     * @deprecated 请使用 `artis.command.execute('item.group', { childrenIds })`
+     * @param groupInfo 旧的成组创建信息（仅读取其 children）
+     */
+    groupItems(groupInfo: {
+        property?: {
+            children?: string[];
+        };
+    }): void;
+    /**
+     * 设置元素名称
+     *
+     * @deprecated 请使用 `artis.command.execute('item.updateProperty', { itemId, propertyKey, newValue })`
+     * @param id 元素 ID
+     * @param name 新名称
+     */
+    setItemName(id: string, name: string): void;
+    /**
+     * 将元素移入画板
+     *
+     * @deprecated 请使用 `artis.command.execute('frame.moveIn', { itemIds, frameId })`
+     * @param itemIds 待移入的元素 ID 列表
+     * @param frameId 目标画板元素 ID
+     */
+    moveItemsToFrame(itemIds: string[], frameId: string): void;
+    /**
+     * 将元素移出画板
+     *
+     * @deprecated 请使用 `artis.command.execute('frame.moveOut', { itemIds })`
+     * @param itemIds 待移出的元素 ID 列表
+     */
+    moveItemsOutOfFrame(itemIds: string[]): void;
+    /**
+     * 设置元素的父子关系（移入指定父级）
+     *
+     * @deprecated 请使用 `artis.command.execute('frame.moveIn', { itemIds: [id], frameId: parentId })`
+     * @param id 待移入的元素 ID
+     * @param parentId 目标父级元素 ID
+     */
+    setItemParent(id: string, parentId: string): void;
+    /**
+     * 解除元素与指定父级的关系（移出画板）
+     *
+     * @deprecated 请使用 `artis.command.execute('frame.moveOut', { itemIds: [id], frameId: parentId })`
+     * @param id 待移出的元素 ID
+     * @param parentId 要解除的父级元素 ID
+     */
+    deleteItemParent(id: string, parentId: string): void;
+    /**
+     * 设置图片元素尺寸
+     *
+     * @deprecated 请使用 `artis.command.execute('item.transform', { itemId, newTransform: { width, height } })`
+     * @param id 元素 ID
+     * @param size 像素尺寸 [width, height]
+     */
+    setSpriteSize(id: string, size: [number, number]): void;
+    /**
+     * 调整画板元素尺寸（可选同时平移）
+     *
+     * @deprecated 请使用 `artis.command.execute('item.transform', { itemId, newTransform: { width, height, position } })`
+     * @param id 画板元素 ID
+     * @param size 像素尺寸 [width, height]
+     * @param translation 可选的位置偏移 [x, y]
+     */
+    resizeFrameItem(id: string, size: [number, number], translation?: [number, number]): void;
+    /**
+     * 设置特效元素的资源
+     *
+     * @deprecated 请使用 `artis.item.updateEffectsSource(id, effects)`
+     * @param id 特效元素 ID
+     * @param effects 特效资源地址
+     */
+    setEffectsResource(id: string, effects: string): void;
+    /**
+     * 设置元素锁定状态
+     *
+     * @deprecated 请使用 `artis.command.execute('item.updateProperty', { itemId: id, propertyKey: 'locked', newValue: state })`
+     * @param id 元素 ID
+     * @param state 是否锁定
+     */
+    setItemLockState(id: string, state: boolean): void;
+    /**
+     * 对画板执行自动布局（切换为 auto 布局模式）
+     *
+     * @deprecated 请使用 `artis.command.execute('frame.layoutMode', { frameId, targetMode: 'auto' })`
+     * @param frameId 画板元素 ID
+     */
+    applyFrameAutoLayout(frameId: string): void;
+    /**
+     * 对整个页面执行自动排布
+     *
+     * @deprecated 请使用 `artis.command.execute('page.autoLayout', { param })`（支持撤销）
+     * @param param 自动排布参数
+     */
+    autoLayoutPage(param?: PageAutoLayoutParam): void;
+    /**
+     * 经 CreateInfo → ItemSchema 转换后创建元素，并 await 异步资源加载（M4 回流）。
+     * 对齐 master「创建即资源就绪」语义——resolve 时图片/视频/特效预合成/画板预合成已就绪。
+     * @param createInfo 旧元素创建信息
+     * @returns 新创建元素的 ID
+     */
+    private _createByInfoAsync;
+    /**
+     * 创建图片元素
+     *
+     * @deprecated 请使用 `artis.command.execute('item.create', { schemas: schema })`（schema 见 SpriteItemSchema）
+     * @param spriteInfo 图片元素创建信息
+     * @returns 新元素 ID
+     */
+    addSpriteItem(spriteInfo: SpriteCreateInfo): Promise<string | undefined>;
+    /**
+     * 创建文本元素
+     *
+     * @deprecated 请使用 `artis.command.execute('item.create', { schemas: schema })`（schema 见 TextItemSchema）
+     * @param textInfo 文本元素创建信息
+     * @returns 新元素 ID
+     */
+    addTextItem(textInfo: TextCreateInfo): Promise<string | undefined>;
+    /**
+     * 创建视频元素
+     *
+     * @deprecated 请使用 `artis.command.execute('item.create', { schemas: schema })`（schema 见 VideoItemSchema）
+     * @param videoInfo 视频元素创建信息
+     * @returns 新元素 ID
+     */
+    addVideoItem(videoInfo: VideoCreateInfo): Promise<string | undefined>;
+    /**
+     * 创建卡片元素
+     *
+     * @deprecated 请使用 `artis.command.execute('item.create', { schemas: schema })`（schema 见 CardItemSchema）
+     * @param createInfo 卡片元素创建信息
+     * @returns 新元素 ID（创建失败返回 undefined）
+     */
+    addCardItem(createInfo: CardCreateInfo): string | undefined;
+    /**
+     * 创建生成器元素
+     *
+     * @deprecated 请使用 `artis.command.execute('item.create', { schemas: schema })`（schema 见 GeneratorItemSchema）
+     * @param createInfo 生成器元素创建信息
+     * @returns 新元素 ID
+     */
+    addGeneratorItem(createInfo: GeneratorCreateInfo): Promise<string | undefined>;
+    /**
+     * 创建特效元素
+     *
+     * @deprecated 请使用 `artis.command.execute('item.create', { schemas: schema })`（schema 见 EffectsItemSchema）
+     * @param effectsInfo 特效元素创建信息
+     * @returns 新元素 ID
+     */
+    addEffectsItem(effectsInfo: EffectsCreateInfo): Promise<string | undefined>;
+    /**
+     * 创建画板元素
+     *
+     * @deprecated 请使用 `artis.command.execute('item.create', { schemas: schema })`（schema 见 FrameItemSchema）
+     * @param createInfo 画板元素创建信息
+     * @returns 新画板元素 ID
+     */
+    addFrameItem(createInfo: FrameCreateInfo): Promise<string | undefined>;
+    /**
+     * 批量创建元素
+     *
+     * 「先子后父」的拓扑排序已下沉到 `item.create` 命令层（ItemCreateCommand 构造期算 buildOrder），
+     * 此处只做 createInfo → schema 转发；返回的 ids 与 createInfos 逐项一一对应。
+     *
+     * @deprecated 请使用 `artis.command.execute('item.create', { schemas })` 批量创建
+     * @param createInfos 元素创建信息列表
+     * @returns 新创建元素的 ID 列表（与 createInfos 逐项对应）
+     */
+    addItemByCreateInfos(createInfos: ItemCreateInfo[], asyncMode?: boolean): Promise<string[]>;
+    /**
+     * 注册单个卡片类型
+     * @deprecated 请使用 `artis.preferences.registerCardType(config)`
+     * @param cardTypeConfig 卡片类型配置
+     * @returns 是否注册成功
+     */
+    registerCardType(cardTypeConfig: CardTypeConfig): boolean;
+    /**
+     * 批量注册卡片类型
+     * @deprecated 请使用 `artis.preferences.registerCardTypes(configs)`
+     * @param configs 卡片类型配置列表
+     * @returns 成功注册的数量
+     */
+    registerCardTypes(configs: CardTypeConfig[]): number;
+    /**
+     * 注销卡片类型
+     * @deprecated 请使用 `artis.preferences.unregisterCardType(type)`
+     * @param type 卡片类型名称
+     * @returns 是否注销成功
+     */
+    unregisterCardType(type: string): boolean;
+    /**
+     * 获取所有已注册的卡片类型
+     * @deprecated 请使用 `artis.preferences.getRegisteredCardTypes()`
+     * @returns 已注册的卡片类型配置列表
+     */
+    getRegisteredCardTypes(): CardTypeConfig[];
+    /**
+     * 判断卡片类型是否已注册
+     * @deprecated 请使用 `artis.preferences.isCardTypeRegistered(type)`
+     * @param type 卡片类型名称
+     * @returns 是否已注册
+     */
+    isCardTypeRegistered(type: string): boolean;
+    /**
+     * 按注册的 cardType 动态解析卡片 HTML。
+     * @deprecated 请使用 `artis.htmlCard.resolveHTML(item)`
+     */
+    resolveCardHTML(item: CardItem): CardHTML | undefined;
+    /**
+     * 解析卡片对应的注册类型配置。
+     * @deprecated 请使用 `artis.htmlCard.resolveTypeConfig(item)`
+     */
+    resolveCardTypeConfig(item: CardItem): CardTypeConfig | undefined;
+    /**
+     * 重新解析并挂载指定卡片的 HTML。
+     * @deprecated 请使用 `artis.htmlCard.refresh(id)`
+     */
+    refreshCardHTML(id: string): boolean;
+    /**
+     * 向卡片内容注册的 patch handler 派发增量更新。
+     * @deprecated 请使用 `artis.htmlCard.patch(id, patch)`
+     */
+    patchCardHTML(id: string, patch: unknown): boolean;
+    /**
+     * 获取 HTML 卡片 iframe window。
+     * @deprecated 请使用 `artis.htmlCard.getWindow(id)`
+     */
+    getHtmlCardWindow(id: string): Window | null | undefined;
+    /**
+     * 向 HTML 卡片 iframe 派发跨文档事件。
+     * @deprecated 请使用 `artis.htmlCard.dispatchEvent(id, type, detail)`
+     */
+    dispatchHtmlCardEvent(id: string, type: string, detail?: unknown): boolean;
+    /**
+     * 获取页面数据。
+     *
+     * 旧 SDK 返回多视图重型结构（含 viewProperties / activeData / property / scene）；
+     * 新架构为单视图，统一投影为 {@link ArtisData}（仅 `items`）。
+     *
+     * 旧用户访问 `.items` 仍可用；`.viewProperties` / `.activeData` 等多视图字段已下线，
+     * 请改用 `artis.selection.getSelectedIds()` 等命名空间接口获取对应数据。
+     *
+     * @deprecated 请使用 `artis.store.toArtisData()` 或对应命名空间接口
+     */
+    get pageData(): ArtisData;
+    /**
+     * 通过页面数据重新加载并启动。
+     *
+     * 仅投影单视图：从入参中提取元素数据（`items`）走新 {@link Artis.run}。
+     * 旧多视图 PageData（`viewProperties` / `scene` 等）能力已下线，相关字段被忽略。
+     *
+     * @deprecated 请使用 `artis.run({ items })`
+     * @param data 兼容旧 PageData；新用法请直接传 `{ items: ItemSchema[] }`
+     */
+    runByPageData(data: InitArtisData | {
+        items?: unknown[];
+    }): Promise<void>;
+    /**
+     * 追加多视图页面数据。
+     *
+     * @deprecated 多视图能力在新架构中已下线，调用无效果。
+     * 单视图加载请使用 `artis.run({ items })`。
+     * @param _data 旧多视图页面数据（已忽略）
+     */
+    loadPageData(_data: unknown): Promise<void>;
+    /**
+     * 通过 JSONScene 重新加载所有视图。
+     *
+     * @deprecated 基于 scene 的整页重载能力在新架构中已下线，调用无效果。
+     * 请改用 `artis.run({ items })` 加载元素数据。
+     * @param _scene 旧 JSONScene 数据（已忽略）
+     */
+    reloadPageDataByScene(_scene: unknown): Promise<void>;
+    /**
+     * 设置视图缩放（绝对值）。
+     *
+     * @deprecated 请使用 `artis.view.setZoom(zoom, center)`
+     * @param zoom 目标缩放值（绝对值）
+     * @param center 缩放中心（视口坐标），不传则以默认锚点缩放
+     * @param _ignoreClamp 旧参数：是否忽略缩放范围约束。新架构由 view 内部统一钳位，此参已废弃
+     */
+    setPageZoom(zoom: number, center?: [number, number], _ignoreClamp?: boolean): void;
+    /**
+     * 设置画布平移（绝对值）。
+     *
+     * @deprecated 请使用 `artis.view.setTranslation([x, y])`
+     * @param targetTranslation 目标平移值（绝对值），兼容旧 Vector2（含 toArray）或 [x, y] 数组
+     */
+    setPageMove(targetTranslation: [number, number] | {
+        toArray(): number[];
+    }): void;
+    /**
+     * 缩放视图（增量）。
+     *
+     * @deprecated 请使用 `artis.command.execute('viewport.zoom', { zoomDelta: shift, center })`
+     * @param shift 缩放增量
+     * @param center 缩放中心（视口坐标）
+     */
+    pageZoom(shift: number, center?: [number, number]): void;
+    /**
+     * 平移视图（增量）。
+     *
+     * @deprecated 请使用 `artis.command.execute('viewport.move', { deltaX: dx, deltaY: dy })`
+     * @param shift 平移增量 [dx, dy]
+     */
+    pageMove(shift: [number, number]): void;
+    /**
+     * 自适应视口：有 box 则 fitToBox，无 box 取全部元素 pixel box 合并后 fit。
+     *
+     * @deprecated 请使用 `artis.view.fitToBox(box, shiftParam)`。
+     * @param shiftParam fit 时的留白/偏移参数
+     * @param box 待 fit 的目标包围盒；缺省时取全部元素的 pixel box 合并
+     */
+    viewportFit(shiftParam?: unknown, box?: Box2): void;
+    /**
+     * 像素坐标系包围盒 → 视口坐标系包围盒（应用 zoom + translation）。
+     *
+     * @deprecated 推荐直接使用 `artis.interactionService.getViewBoxByBox(box)`。
+     * @param box 像素坐标系包围盒
+     * @returns 视口坐标系包围盒
+     */
+    getViewBoxByBox(box: Box2): Box2;
+    /**
+     * 视口坐标 → 像素坐标换算（逆向 zoom + translation）。
+     *
+     * @deprecated 推荐直接使用 `artis.interactionService.getPixelPositionByViewPoint(viewPosition)`。
+     * @param viewPosition 视口坐标
+     * @returns 像素坐标
+     */
+    getPixelPositionByViewPosition(viewPosition: Vector2): Vector2;
+    /**
+     * 设置画布背景。
+     *
+     * @deprecated 请使用 `artis.setBackground(config)`（config 为 {@link ArtisBackgroundConfig}）
+     * @param type 背景类型：'color' | 'image' | 'chess-board' | 'dot-board'
+     * @param value color 时为颜色值；image 时为图片 URL；棋盘/点阵时为可选底色
+     */
+    setSDKBackground(type: 'color' | 'image' | 'chess-board' | 'dot-board', value?: string): void;
+    /**
+     * 设置画布背景（{@link setSDKBackground} 的旧别名）。
+     *
+     * @deprecated 请使用 `artis.setBackground(config)`（config 为 {@link ArtisBackgroundConfig}）
+     * @param type 背景类型：'color' | 'image' | 'chess-board' | 'dot-board'
+     * @param value color 时为颜色值；image 时为图片 URL；棋盘/点阵时为可选底色
+     */
+    setArtisBackground(type: 'color' | 'image' | 'chess-board' | 'dot-board', value?: string): void;
+    /**
+     * 旧 (type, value) 背景入参 → 新 ArtisBackgroundConfig 对象。
+     * @param type 背景类型：'color' | 'image' | 'chess-board' | 'dot-board'
+     * @param value color 时为颜色值；image 时为图片 URL；棋盘/点阵时忽略
+     * @returns 归一化后的 ArtisBackgroundConfig
+     */
+    private static _toBackgroundConfig;
+    /**
+     * 获取页面配置。
+     *
+     * @deprecated 请分别使用 `artis.preferences.page` 与 `artis.view`（zoom / translation）
+     * @returns 页面配置（含安全区预览 / 缩放 / 吸附 / 异步模式 / 平移）
+     */
+    getPageConfig(): {
+        safeAreaPreview: boolean;
+        zoom: number;
+        adsorption: boolean;
+        asyncMode: boolean;
+        translation: [number, number];
+    };
+    /**
+     * 设置页面配置。
+     *
+     * @deprecated 缩放请用 `artis.view.setZoom(zoom)`；其余开关用 `artis.preferences.setPage(...)`
+     * @param pageConfig 页面配置（缩放 / 安全区预览 / 吸附 / 异步模式）
+     */
+    setPageConfig(pageConfig: {
+        safeAreaPreview?: boolean;
+        zoom?: number;
+        adsorption?: boolean;
+        asyncMode?: boolean;
+    }): void;
+    /**
+     * 设置元素属性（支持单属性 / 多属性）。
+     *
+     * 统一走 `item.updateProperty` Command（支持撤销）；多属性场景以 batch 聚合为单条历史。
+     *
+     * @deprecated 请使用 `artis.command.execute('item.updateProperty', { itemId, propertyKey, newValue })`
+     * @param param 单属性 `{ itemId, propertyName, propertyValue }` 或多属性 `{ itemId, property }`
+     */
+    setItemProperty<T extends ArtisItemType>(param: SetItemPropertyParam<T>): Promise<void>;
+    /**
+     * 获取（懒实例化）视频导出器，并桥接导出事件到新事件系统。
+     *
+     * Exporter 的 `progress` / `done` / `complete` 事件，旧 SDK 通过
+     * `exportProgress` / `exportDone` / `exportComplete` 暴露；这些旧事件已下线，
+     * 导出进度请直接 `artis.exporter.on('progress', ...)` 监听。
+     * @returns 视频导出器实例
+     */
+    private _getExporter;
+    /**
+     * 视频导出器实例（懒创建）。
+     *
+     * 推荐用法（新接口）：`artis.exporter.on('progress', ...)`、`artis.exporter.onExport(params)`。
+     */
+    get exporter(): Exporter;
+    /**
+     * 撤销 / 重做入口（兼容旧 `_undoRedo`）。
+     *
+     * `canUndo` / `canRedo` 暴露为属性（旧风格）；`push` / `undo` / `redo` 转发到 `history`。
+     *
+     * @deprecated 请使用 `artis.history`（注意新 HistoryManager 的 canUndo / canRedo 为方法）
+     */
+    get undoRedo(): {
+        push: HistoryManager['push'];
+        undo: HistoryManager['undo'];
+        redo: HistoryManager['redo'];
+        canUndo: boolean;
+        canRedo: boolean;
+    };
+    /**
+     * 导出当前导出器状态。
+     * @deprecated 请使用 `artis.exporter.status`
+     */
+    get exportStatus(): Exporter['status'] | undefined;
+    /**
+     * 执行导出。
+     *
+     * @deprecated 请使用 `artis.exporter.onExport(params)`
+     * @param params 导出参数列表（含 scene / size / 下载信息）。
+     *   旧无参用法依赖多视图 `exportOptions`，新架构已下线，必须显式传入 params。
+     */
+    onExport(params?: ExportParams): void;
+    /**
+     * 取消导出。
+     * @deprecated 请使用 `artis.exporter.onCancel()`
+     */
+    cancelExport(): void;
+    /**
+     * 设置导出参数。
+     * @deprecated 请使用 `artis.exporter.setOptions(options)`
+     * @param exportParam 导出参数（部分字段）
+     */
+    setExportParam(exportParam: Partial<ExportMediaInitOptions>): void;
+    /**
+     * 以媒体格式 buffer 下载。
+     * @deprecated 请使用 `artis.exporter.downloadByMediaBuffers(params, buffers, extras)`
+     * @param params 下载项信息列表
+     * @param buffers 媒体 buffer 集合
+     * @param extras 附加信息（如字幕等）
+     */
+    downloadByMediaBuffersOfExporter(params: ExportMediaItemDownloadInfo[], buffers: Buffers, extras: Extras): void;
+    /**
+     * 由指定元素 ID 组装独立场景并生成截图。
+     *
+     * @deprecated 请使用 `artis.screenshot.generateByItemIds(ids, { time })`。
+     * @param idInfo 元素 ID（单个或多个）
+     * @param time 截图时刻（秒），默认 0
+     * @returns 截图 dataURL；场景无预览尺寸或生成失败时返回 undefined
+     */
+    createScreenShotSceneByIds(idInfo: string | string[], time?: number): Promise<string | undefined>;
+    /**
+     * 生成截图。数字入参兼容旧 SDK view ID，在单视图 Artis 中映射为当前全部元素；
+     * 字符串或字符串数组按指定元素截图。
+     *
+     * @deprecated 请使用 `artis.screenshot.generateByItemIds(ids, options)`
+     * @param idInfo 旧 view ID，或元素 ID（单个或多个）
+     * @param size 截图结果尺寸 [width, height]；数字 view ID 默认 [300, 400]，元素截图默认使用场景预览尺寸
+     * @param tick 截图时刻（秒）；数字 view ID 默认使用主合成时长，元素截图默认 0
+     * @param backgroundColor 背景色 [r, g, b, a]（0-255 / 0-1），不传则透明
+     * @returns 截图 dataURL；生成失败时返回 undefined
+     */
+    generateScreenShot(idInfo: number | string | string[], size?: [number, number], tick?: number, backgroundColor?: spec.vec4): Promise<string | undefined>;
+    /**
+     * 生成画板（Frame）元素的截图（仅渲染其子元素）。
+     *
+     * @deprecated 请使用 `artis.screenshot.generateByItemIds(frameItem.children)`
+     * @param id 画板元素 ID
+     * @returns 截图 dataURL；非画板 / 无子元素时返回 undefined
+     */
+    createScreenShotByFrame(id: string): Promise<string | undefined>;
+    /**
+     * 生成动效（Effects）元素的截图。
+     *
+     * @deprecated 请使用 `artis.screenshot.generateByItemIds(effectsId)`
+     * @param id 动效元素 ID
+     * @returns 截图 dataURL；非动效元素时返回 undefined
+     */
+    createScreenShotByEffects(id: string): Promise<string | undefined>;
+    /**
+     * 批量设置元素扩展属性。
+     * @deprecated 请使用 `artis.item.getArtisItem(id)?.setExtensions(extension)`
+     * @param id 元素 ID
+     * @param extension 扩展属性键值对
+     * @returns 是否设置成功；元素不存在时返回 false
+     */
+    setItemExtension(id: string, extension: Record<string, unknown>): boolean;
+    /**
+     * 批量获取元素扩展属性（不传 keys 则返回全部）。
+     * @deprecated 请使用 `artis.item.getArtisItem(id)?.getAllExtension()`
+     * @param id 元素 ID
+     * @param keys 待获取的扩展属性键名列表，缺省返回全部
+     * @returns 扩展属性键值对；元素不存在时返回 undefined
+     */
+    getItemExtension(id: string, keys?: string[]): Record<string, unknown> | undefined;
+    /**
+     * 删除元素扩展属性（支持批量）。
+     * @deprecated 请使用 `artis.item.getArtisItem(id)?.deleteExtension(key)`
+     * @param id 元素 ID
+     * @param keys 待删除的扩展属性键名列表
+     * @returns 是否删除成功；元素不存在时返回 false
+     */
+    deleteItemExtensions(id: string, keys: string[]): boolean;
+    /**
+     * 检查元素是否有指定扩展属性。
+     * @deprecated 请使用 `artis.item.getArtisItem(id)?.hasExtension(key)`
+     * @param id 元素 ID
+     * @param key 扩展属性键名
+     * @returns 是否存在；元素不存在时返回 false
+     */
+    hasItemExtension(id: string, key: string): boolean;
+    /**
+     * 获取元素所有扩展属性键名列表。
+     * @deprecated 请使用 `artis.item.getArtisItem(id)?.getExtensionKeys()`
+     * @param id 元素 ID
+     * @returns 扩展属性键名列表；元素不存在时返回 undefined
+     */
+    getItemExtensionKeys(id: string): string[] | undefined;
+    /**
+     * @deprecated 多视图能力已下线，调用无效果。新架构为单视图。
+     * @param _index 旧视图索引（已忽略）
+     */
+    switchScene(_index: number): Promise<void>;
+    /**
+     * @deprecated 多视图能力已下线，调用无效果。
+     * @param _viewParams 旧视图参数（已忽略）
+     * @param _scene 旧 scene 标识（已忽略）
+     */
+    addViewParams(_viewParams: unknown, _scene?: unknown): Promise<void>;
+    /**
+     * @deprecated 多视图能力已下线，调用无效果。
+     * @param _ids 旧视图参数 ID 列表（已忽略）
+     */
+    deleteViewParams(_ids: number[]): Promise<void>;
+    /**
+     * @deprecated 多视图能力已下线，恒返回 undefined。
+     * @param _id 旧视图参数 ID（已忽略）
+     * @returns 恒返回 undefined
+     */
+    getViewProperty(_id: number): undefined;
+    /**
+     * @deprecated 多视图能力已下线，恒返回空数组。
+     * @returns 恒返回空数组
+     */
+    getViewScene(): [];
+    /**
+     * @deprecated 多视图能力已下线，恒返回空数组。截图请使用 `artis.screenshot.generateByItemIds(ids)`。
+     * @returns 恒返回空数组
+     */
+    getViewThumbnail(): [];
+    /**
+     * @deprecated 该坐标换算依赖已下线的多视图能力，恒返回 undefined。
+     * @param id 元素 ID
+     * @returns 恒返回 undefined
+     */
+    getViewBox(id: string): Box2 | undefined;
+    /**
+     * @deprecated 多视图 JSON 导出能力已下线，恒返回空数组。
+     * @param _idInfo 旧视图 ID 或 ID 列表（已忽略）
+     * @returns 恒返回空数组
+     */
+    exportJSON(_idInfo?: number | number[]): [];
+    /**
+     * @deprecated 出血安全区预览（多视图）能力已下线，调用无效果。
+     * @param _visible 是否显示出血安全区（已忽略）
+     */
+    setSafeAreaPreviewVisible(_visible: boolean): void;
+    /**
+     * 多元素对齐：以选中元素的整体包围盒为基准，将各元素贴到对应边 / 中线。
+     *
+     * @param type 对齐类型（left / right / horizontal-center / top / bottom / vertical-center）
+     * @param ids 参与对齐的元素 id；缺省时取当前选中元素
+     * @deprecated 请使用 `artis.command.execute('item.align', { alignType: type, itemIds: ids })`（支持撤销/重做）
+     */
+    makeItemAlign(type: AlignType, ids?: string[]): void;
+    /**
+     * 多元素等间距分布：按中心点沿分布方向铺开（固定首尾，至少需要 3 个元素）。
+     *
+     * @param type 分布类型（horizontal-spacing / vertical-spacing）
+     * @param ids 参与分布的元素 id；缺省时取当前选中元素
+     * @deprecated 请使用 `artis.command.execute('item.distribute', { distributeType: type, itemIds: ids })`（支持撤销/重做）
+     */
+    makeItemDistribute(type: DistributeType, ids?: string[]): void;
+    /**
+     * 开启图片裁切 Gizmo：切换到「图片裁切」状态（imageCut）。
+     * @deprecated 请使用 `artis.command.execute('state.imageCut')`。
+     */
+    openPictureCutGizmo(): void;
+    /**
+     * 关闭图片裁切 Gizmo：切回默认的「移动」状态（move）。
+     * @deprecated 请使用 `artis.command.execute('state.move')`。
+     */
+    closePictureCutGizmo(): void;
+    /**
+     * 获取当前裁切信息（归一化裁切框 + 元素视图框），委托 PictureCutGizmo.getCutInfo。
+     * @returns 裁切信息；Gizmo 未就绪 / 未选中单个元素 / 结果无效时返回 undefined
+     */
+    getCutInfo(): {
+        cutBox: Box2;
+        itemBox: Box2;
+    } | undefined;
+    /**
+     * 获取归一化裁切包围盒（min/max ∈ [0,1]，相对元素包围盒），委托 PictureCutGizmo.getCutBox。
+     * @returns 归一化裁切框；Gizmo 未就绪时返回 undefined
+     */
+    getCutBox(): Box2 | undefined;
+    /**
+     * 设置归一化裁切包围盒（入参为归一化坐标），委托 PictureCutGizmo.setCutBox。
+     * @param normalizeBox 归一化裁切框
+     */
+    setCutBox(normalizeBox: Box2): void;
+    /**
+     * 设置裁切 Gizmo 是否锁定缩放比例，委托 PictureCutGizmo.isLockScale。
+     * @param state 是否锁定
+     */
+    setPictureCutGizmoLockScale(state: boolean): void;
+    /**
+     * @deprecated 裁切撤销统一走 `artis.history.undo()`（撤销最近一条 PictureCutCommitCommand）。
+     * @returns 恒返回 true
+     */
+    undoPictureCutGizmo(): boolean;
+    /**
+     * @deprecated 裁切重做统一走 `artis.history.redo()`。
+     * @returns 恒返回 true
+     */
+    redoPictureCutGizmo(): boolean;
+    /** @deprecated 请使用 `artis.history.canUndo()`。 */
+    get canUndoPictureCutGizmo(): boolean;
+    /** @deprecated 请使用 `artis.history.canRedo()`。 */
+    get canRedoPictureCutGizmo(): boolean;
+    /** @deprecated isolated 状态退出时 session 自动清理，调用无效果。 */
+    clearPictureCutGizmoUndoRedo(): void;
+    /**
+     * 开启图片扩边 Gizmo：切换到「图片扩边」状态（imageExpand）。
+     * @deprecated 请使用 `artis.command.execute('state.imageExpand')`。
+     */
+    openPictureExpandGizmo(): void;
+    /**
+     * 关闭图片扩边 Gizmo：切回默认的「移动」状态（move）。
+     * @deprecated 请使用 `artis.command.execute('state.move')`。
+     */
+    closePictureExpandGizmo(): void;
+    /**
+     * 获取当前扩边信息（归一化扩边框 + 元素视图框），委托 PictureExpandGizmo.getExpandInfo。
+     * @returns 扩边信息；Gizmo 未就绪 / 未选中单个元素 / 结果无效时返回 undefined
+     */
+    getExpandInfo(): {
+        expandBox: Box2;
+        itemBox: Box2;
+    } | undefined;
+    /**
+     * 获取归一化扩边包围盒（相对元素包围盒，可超出 [0,1]），委托 PictureExpandGizmo.getExpandBox。
+     * @returns 归一化扩边框；Gizmo 未就绪时返回 undefined
+     */
+    getExpandBox(): Box2 | undefined;
+    /**
+     * 设置归一化扩边包围盒（入参为归一化坐标），委托 PictureExpandGizmo.setExpandBox。
+     * @param normalizeBox 归一化扩边框
+     */
+    setExpandBox(normalizeBox: Box2): void;
+    /**
+     * 设置扩边 Gizmo 是否锁定缩放比例，委托 PictureExpandGizmo.isLockScale。
+     * @param state 是否锁定
+     */
+    setPictureExpandGizmoLockScale(state: boolean): void;
+    /**
+     * @deprecated 扩边撤销统一走 `artis.history.undo()`（撤销最近一条 PictureExpandCommitCommand）。
+     * @returns 恒返回 true
+     */
+    undoPictureExpandGizmo(): boolean;
+    /**
+     * @deprecated 扩边重做统一走 `artis.history.redo()`。
+     * @returns 恒返回 true
+     */
+    redoPictureExpandGizmo(): boolean;
+    /** @deprecated 请使用 `artis.history.canUndo()`。 */
+    get canUndoPictureExpandGizmo(): boolean;
+    /** @deprecated 请使用 `artis.history.canRedo()`。 */
+    get canRedoPictureExpandGizmo(): boolean;
+    /** @deprecated isolated 状态退出时 session 自动清理，调用无效果。 */
+    clearPictureExpandGizmoUndoRedo(): void;
+    /**
+     * 开启蒙版 Gizmo：切换到「图片蒙版」状态（imageMask），并应用初始笔刷大小。
+     * @deprecated 请使用 `artis.command.execute('state.imageMask')` + `artis.gizmoManager.configs.set(maskConfig, { brushSize })`。
+     * @param brushSize 初始笔刷大小
+     */
+    openMaskGizmo(brushSize: number): void;
+    /**
+     * 清空蒙版：移除已绘制的所有蒙版笔迹。
+     * @deprecated 推荐直接使用 `artis.gizmoManager.get('mask')?.clearMask()`。
+     */
+    clearMaskGizmo(): void;
+    /**
+     * 关闭蒙版 Gizmo：切回默认的「移动」状态（move）。
+     * @deprecated 请使用 `artis.command.execute('state.move')`。
+     */
+    closeMaskGizmo(): void;
+    /**
+     * @deprecated 请直接使用 `artis.gizmoManager.get('mask')?.getMask()`。
+     * @returns 蒙版 dataURL；Gizmo 未就绪时返回 undefined
+     */
+    getMask(): string | undefined;
+    /**
+     * 设置蒙版 Gizmo 配置（笔刷大小 / 蒙版颜色 / 蒙版图片等）。
+     *
+     * 其中 maskImage 为运行时蒙版图片（非 MaskConfig 字段），单独写入 gizmo.maskImage。
+     * @deprecated 推荐直接使用 `artis.gizmoManager.get('mask')` 上的 config / maskImage。
+     * @param config 蒙版配置（笔刷大小 / 蒙版颜色 / 蒙版图片等）
+     */
+    setMaskGizmoConfig(config: Partial<MaskConfig> & {
+        maskImage?: HTMLImageElement;
+    }): void;
+    /**
+     * 设置蒙版 Gizmo 模式：'paint' 笔刷涂抹 / 'erase' 笔刷擦除 / 'box-paint' 框选涂抹 / 'box-erase' 框选擦除。
+     * @deprecated 推荐直接使用 `artis.gizmoManager.get('mask')?.setMode(mode)`。
+     * @param mode 蒙版模式：'paint' | 'erase' | 'box-paint' | 'box-erase'
+     */
+    setMaskGizmoMode(mode: 'paint' | 'erase' | 'box-paint' | 'box-erase'): void;
+    /**
+     * @deprecated 蒙版撤销统一走 `artis.history.undo()`（撤销最近一条 MaskCommitCommand）。
+     * @returns 恒返回 true
+     */
+    undoMaskGizmo(): boolean;
+    /**
+     * @deprecated 蒙版重做统一走 `artis.history.redo()`。
+     * @returns 恒返回 true
+     */
+    redoMaskGizmo(): boolean;
+    /** @deprecated 请使用 `artis.history.canUndo()`。 */
+    get canUndoMaskGizmo(): boolean;
+    /** @deprecated 请使用 `artis.history.canRedo()`。 */
+    get canRedoMaskGizmo(): boolean;
+    /** @deprecated isolated 状态退出时 session 自动清理，调用无效果。 */
+    clearMaskGizmoUndoRedo(): void;
+    /**
+     * 开启精改文字 Gizmo：切换到「精准改字」状态（imageTextEdit）。
+     * @deprecated 请使用 `artis.command.execute('state.imageTextEdit')`。
+     * @param initParam 文字片段初始化参数，不传则复用 Gizmo 既有结果
+     */
+    openSpriteTextEditGizmo(initParam?: SpriteTextInitParam[]): void;
+    /**
+     * 关闭精改文字 Gizmo：切回默认的「移动」状态（move）。
+     * @deprecated 请使用 `artis.command.execute('state.move')`。
+     */
+    closeSpriteTextEditGizmo(): void;
+    /** @deprecated 精改文字 Gizmo 能力已下线，调用无效果。 */
+    /**
+     * 选中指定文字片段，委托 SpriteTextEditGizmo.setSelected。
+     * @param id 元素 ID
+     * @param index 文字片段索引
+     */
+    setSpriteTextSelectedIndex(id: string, index: number): void;
+    /**
+     * 设置指定文字片段的文本内容，委托 SpriteTextEditGizmo.setText。
+     * @param id 元素 ID
+     * @param index 文字片段索引
+     * @param text 新文本
+     */
+    setSpriteTextSelectedText(id: string, index: number, text: string): void;
+    /**
+     * 设置指定文字片段的「已修改」状态，委托 SpriteTextEditGizmo.setChangedState。
+     * @param id 元素 ID
+     * @param index 文字片段索引
+     * @param hasChanged 是否已修改
+     */
+    setSpriteTextChangedState(id: string, index: number, hasChanged: boolean): void;
+    /**
+     * 设置指定文字片段的「编辑中」状态，委托 SpriteTextEditGizmo.setEditState。
+     * @param id 元素 ID
+     * @param index 文字片段索引
+     * @param isEditing 是否编辑中
+     */
+    setSpriteTextEditState(id: string, index: number, isEditing: boolean): void;
+    /**
+     * 开启元素创建 Gizmo：切换到「创建元素」状态（itemCreate）。
+     * @param createType 创建类型，默认为画板（frame）
+     * @deprecated 请使用 `artis.command.execute('state.itemCreate', { createType })`。
+     */
+    openItemCreateGizmo(createType?: ItemCreateType): void;
+    /**
+     * 关闭元素创建 Gizmo：切回默认的「移动」状态（move）。
+     * @deprecated 推荐直接使用 `artis.states.activate('move')`。
+     */
+    closeItemCreateGizmo(): void;
+    /**
+     * 开启文本编辑 Gizmo：选中目标文本并进入编辑态（textarea 自动聚焦）。
+     *
+     * 内部：切到 move 态 → 选中 itemId → 进入 GestureHandler TextEditMode。
+     * @deprecated 推荐用 `artis.states.activate('move')` + 选中 + 双击进入编辑。
+     * @param itemId 待编辑的文本元素 ID
+     */
+    openTextGizmo(itemId: string): void;
+    /** @deprecated 关闭文本编辑态。 */
+    closeTextGizmo(): void;
+    /**
+     * @deprecated 请直接使用 `artis.gizmoManager.get('loading')?.add(...)`。
+     * @param id loading 标识 ID
+     * @param options 提示文案与是否清空选中元素等可选项
+     */
+    openLoadingGizmo(id: string, options?: LoadingItemOptions): void;
+    /**
+     * @deprecated 请直接使用 `artis.gizmoManager.get('loading')?.updateItem(...)`。
+     * @param id loading 标识 ID
+     * @param options 待更新的 LoadingTip 属性
+     */
+    updateLoadingGizmo(id: string, options: LoadingItemOptions): void;
+    /**
+     * @deprecated 请直接使用 `artis.gizmoManager.get('loading')?.delete(...)`。
+     * @param id loading 标识 ID
+     */
+    closeLoadingGizmo(id: string): void;
+    /**
+     * @deprecated 变换 Gizmo 锁定缩放能力已下线，调用无效果。
+     * @param _state 是否锁定（已忽略）
+     */
+    setResizeSelectionGizmoLockScale(_state: boolean): void;
+    /**
+     * 获取元素的 CreateInfo（委托 ItemService.getItemCreateInfo）。
+     * @param id 元素 ID
+     * @returns 元素 CreateInfo；元素不存在时返回 undefined
+     */
+    getItemCreateInfo(id: string): ItemCreateInfo | undefined;
+    /**
+     * 批量获取元素 CreateInfo（委托 ItemService.getItemCreateInfos），ids 缺省取全部。
+     * @param ids 元素 ID 列表，缺省取全部
+     * @returns 元素 CreateInfo 列表（跳过不存在的元素）
+     */
+    getItemCreateInfos(ids?: string[]): ItemCreateInfo[];
+    /**
+     * 按 CreateInfo 批量更新元素属性，走 `item.updatePropertyBySchema` Command（可撤销）。
+     * @param createInfo 单个或多个 CreateInfo
+     */
+    setItemPropertyByCreateInfo(createInfo: ItemCreateInfo | ItemCreateInfo[]): Promise<void>;
+    /**
+     * 按 ItemSchema 的纯几何参数（position/width/height/scale/rotation）预算世界 AABB。
+     * 不依赖 player；position 或尺寸缺失时返回空 Box2（isEmpty()===true）。
+     * @param schema 元素 schema（底层 CreateInfo 已迁为 ItemSchema，基础几何参数定义未变）
+     * @returns 世界 AABB；几何不全时返回空 Box2
+     */
+    private static _boxFromItemSchema;
+    /**
+     * 根据单个 CreateInfo 预算元素世界包围盒（AABB），无需创建元素、不依赖 player。
+     *
+     * 底层 CreateInfo 已迁为 ItemSchema 形态，但基础几何参数（position/width/height/scale/rotation）
+     * 定义未变；此处按纯几何预算：以 position 为中心、width×height×scale 为尺寸构建轴对齐框，
+     * 再按 rotation 绕中心旋转后取外接 AABB。缺几何参数的元素（如 Group 未含尺寸、Effects/Text
+     * 未显式指定尺寸）返回 undefined。
+     *
+     * @param createInfo 元素 CreateInfo（基础几何参数与 ItemSchema 一致）
+     * @returns 世界包围盒；几何参数不全时返回 undefined
+     */
+    getBoundingBoxByItemCreateInfo(createInfo: ItemCreateInfo): Box2 | undefined;
+    /**
+     * 根据多个 CreateInfo 预算整体包围盒（并集 AABB），无需创建元素、不依赖 player。
+     * 几何参数不全的元素被跳过；全部元素都缺几何时返回 undefined。
+     * @param createInfos 元素 CreateInfo 列表
+     * @returns 整体世界包围盒；无任何可预算元素时返回 undefined
+     */
+    getBoundingBoxByItemCreateInfos(createInfos: ItemCreateInfo[]): Box2 | undefined;
+    /**
+     * 根据 CreateInfos 生成独立 JSONScene（委托 IOPlugin.createSceneByItemIds）。
+     *
+     * 注意：底层从「已存在于场景中的元素」按 ID 序列化，故传入的 CreateInfo 须对应当前
+     * 场景中真实存在的元素（有 id）。常用于局部导出 / 截图建场景。
+     *
+     * @param createInfos 元素 CreateInfo 列表
+     * @param sceneInfo 场景名称与尺寸
+     * @returns 生成的 JSONScene；无有效元素 ID 时返回 undefined
+     */
+    createSceneByCreateInfos(createInfos: ItemCreateInfo[], sceneInfo?: SceneCreateInfo): spec.JSONScene | undefined;
+    /**
+     * 设置视频/时间轴播放状态：'play' 播放 / 'pause' 暂停。
+     * @deprecated 请直接操作 `artis.player.play()` / `artis.player.pause()`。
+     * @param playState 播放状态：'play' | 'pause'
+     */
+    setPlayState(playState: 'play' | 'pause'): Promise<void>;
+    /**
+     * 按百分比跳转播放进度：progress 为 0-100，对应激活 composition 时长的百分比。
+     *
+     * 跳转后保持当前播放态（playing 时续播、paused 时停在该帧），并保留各单 video/effects
+     * 元素自身的播放态（ignoreMediaPlayState=true，详见 {@link Renderer.goto}）。
+     * @param progress 播放进度百分比 0-100
+     */
+    setPlayProgress(progress: number): Promise<void>;
+    /**
+     * @deprecated 模式切换能力已下线，仅支持 editor 模式，调用无效果。
+     * @param _mode 模式名（已忽略）
+     */
+    setSDKMode(_mode: string): void;
+    /**
+     * @deprecated 静态 config 已废弃，恒返回 undefined。请使用 `artis.preferences`。
+     * @returns 恒为 undefined（静态 config 已废弃）
+     */
+    getSDKConfig(): undefined;
+    /**
+     * @deprecated 静态 config 已废弃，请使用 `artis.preferences.setXxx(...)`。
+     * @param _config 旧静态 config（已忽略）
+     */
+    setSDKConfig(_config: unknown): void;
+    /**
+     * @deprecated 请使用 `artis.preferences.setExport(...)`。
+     * @param config 导出配置（enabled 开关等）
+     */
+    setExportConfig(config: {
+        enabled?: boolean;
+    }): void;
+    /**
+     * 设置文本元素字体，走 `item.setFontFamily` Command（可撤销）。
+     * @param id 文本元素 ID
+     * @param fontFamilyName 字体名称
+     * @param url 字体资源地址
+     */
+    setItemFontFamily(id: string, fontFamilyName: string, url: string): Promise<void>;
+    /**
+     * 读取视频元素当前播放时间（秒）。元素不存在或非视频时返回 0。
+     * @param id 视频元素 ID
+     * @returns 当前播放时间（秒）；读取失败返回 0
+     */
+    getVideoItemPlayTime(id: string): number;
+    /**
+     * 设置视频元素播放时间（秒），底层自动 clamp 到 [0, duration]。静默定位，不动播放态。
+     * @param id 视频元素 ID
+     * @param time 目标时间（秒）
+     */
+    setVideoItemPlayTime(id: string, time: number): void;
+    /**
+     * 读取动效元素当前播放时间（秒）。元素不存在或非动效时返回 0。
+     * @param id 动效元素 ID
+     * @returns 当前播放时间（秒）；读取失败返回 0
+     */
+    getEffectsItemPlayTime(id: string): number;
+    /**
+     * 设置动效元素播放时间（秒）。静默定位，不动其他元素播放态。
+     * @param id 动效元素 ID
+     * @param time 目标时间（秒）
+     */
+    setEffectsItemPlayTime(id: string, time: number): void;
+    /**
+     * 设置生成器资源：将生成器元素原地替换为对应的 sprite / video 元素（复用同 ID）。
+     * 走 `item.setGeneratorResource` Command（可撤销）。
+     *
+     * @param id 生成器元素 ID
+     * @param resourceUrl 资源地址
+     * @returns 转换后的元素 ID（与入参 id 相同）
+     */
+    setGeneratorResource(id: string, resourceUrl: string): Promise<string>;
+    /**
+     * 设置生成器资源（GeneratorResource 对象形式）。
+     * @param resource 生成器资源信息（含 itemId / url）
+     */
+    setGeneratorResourceFromObject(resource: GeneratorResource): void;
+    /**
+     * 设置图片生成器资源。
+     * @param resource 图片生成器资源信息（含 itemId / url）
+     * @returns 转换后的元素 ID（与 resource.itemId 相同）
+     */
+    setSpriteGeneratorResource(resource: SpriteGeneratorResource): Promise<string>;
+    /**
+     * 设置视频生成器资源。
+     * @param resource 视频生成器资源信息（含 itemId / url）
+     * @returns 转换后的元素 ID（与 resource.itemId 相同）
+     */
+    setVideoGeneratorResource(resource: VideoGeneratorResource): Promise<string>;
+    /**
+     * @deprecated 请使用 `artis.command.execute('state.hand' | 'state.move')`。
+     * @param type 交互类型：'hand' 平移 / 'select' 选择
+     */
+    setInteractType(type: 'hand' | 'select'): void;
+    /**
+     * 读取当前交互类型（{@link setInteractType} 的逆映射）：
+     * 当前激活态为 'hand' → 'hand'；'move' → 'select'；其余态 → undefined。
+     * @returns 当前交互类型；非 hand/move 态返回 undefined
+     */
+    getInteractType(): 'hand' | 'select' | undefined;
+    /**
+     * 销毁实例，释放兼容层额外持有的导出器资源。
+     */
+    dispose(): void;
+}