@vvfx/sdk 0.2.2-beta.1 → 0.2.2-beta.12

package/dist/layer-order.d.ts

@@ -0,0 +1,7 @@
+export type SDKCanvasLayers = {
+    container: HTMLElement;
+    playerContainer?: HTMLElement;
+    htmlOverlayLayer?: HTMLElement;
+    gestureCanvas?: HTMLElement;
+};
+export declare function orderSDKCanvasLayers({ container, playerContainer, htmlOverlayLayer, gestureCanvas, }: SDKCanvasLayers): void;

package/dist/{src/sdk-item → sdk-item}/card-item.d.ts

@@ -1,4 +1,4 @@
-import type { CardItemProperty, CardCreateInfo, CardHTML } from '../types';
+import type { CardItemProperty, CardCreateInfo } from '../types';
 import { SDKItemType, type CardItemOptions } from './types';
 import { BaseItem } from './base-item';
 /**
@@ -21,16 +21,12 @@ export declare class CardItem extends BaseItem {
      */
     get cardType(): string;
     set cardType(value: string);
-    /**
-     * @description HTML 覆盖层配置
-     */
-    get html(): CardHTML | undefined;
-    set html(value: CardHTML | undefined);
     /**
      * @description 位置
      */
     get position(): [number, number];
     set position(value: [number, number]);
+    get isAutoScale(): boolean;
     /**
      * @description 宽度
      */

package/dist/{src/sdk.d.ts → sdk.d.ts}

@@ -1,5 +1,5 @@
 import { Player, spec } from './shared';
-import type { SDKInputParam, PageConfig, PageData, SetItemPropertyParam, ViewProperty, ViewParam, ExportParam, SDKBackgroundType, SpriteCreateInfo, GroupCreateInfo, ItemCreateInfo, TextCreateInfo, ViewportFitShiftParam, SceneCreaetInfo, VideoCreateInfo, GeneratorCreateInfo, GeneratorResource, VideoGeneratorResource, SpriteGeneratorResource, EffectsCreateInfo, FrameCreateInfo, CardCreateInfo, CardItemTransformInfo, PageAutoLayoutParam } from './types';
+import type { SDKInputParam, PageConfig, PageData, SetItemPropertyParam, ViewProperty, ViewParam, ExportParam, SDKBackgroundType, SpriteCreateInfo, GroupCreateInfo, ItemCreateInfo, TextCreateInfo, ViewportFitShiftParam, SceneCreaetInfo, VideoCreateInfo, GeneratorCreateInfo, GeneratorResource, VideoGeneratorResource, SpriteGeneratorResource, EffectsCreateInfo, FrameCreateInfo, CardCreateInfo, CardHTML, CardItemTransformInfo, PageAutoLayoutParam } from './types';
 import { SDKItemType } from './sdk-item/types';
 import type { CardTypeConfig } from './config';
 import { ItemOrderAction } from './types';
@@ -10,7 +10,7 @@ import { Box2, Vector2 } from './math';
 import { GizmoOperation, Operation, UndoRedo } from './service/UndoRedo';
 import { GestureHandlerInteractType, GizmoType, ItemCreateType, SpriteTextInitParam } from './gesture-handler/gizmo';
 import { AlignType, DistributeType } from './utils/types';
-import { SDKItem } from './sdk-item';
+import { SDKItem, type CardItem } from './sdk-item';
 import type { LoadingGizmoItemOptions, LoadingGizmoTip } from './gesture-handler/gizmo/loading-gizmo';
 import type { MaskUndoRedoData } from './gesture-handler/gizmo/mask-gizmo';
 import type { PictureCutUndoRedoData } from './gesture-handler/gizmo/picture-cut-gizmo';
@@ -99,6 +99,7 @@ export declare class SDK {
     on: <E extends "progress" | "loadingItemChange" | "selectedItemChange" | "preSelectedItemChange" | "selectedViewChange" | "pageDataChange" | "zoomChange" | "itemPropertyChange" | "exportProgress" | "exportDone" | "exportComplete" | "sdkConfigChange" | "cutBoxChange" | "expandBoxChange" | "textInput" | "undoRedoChange" | "maskGizmoUndoRedoChange" | "pictureCutGizmoUndoRedoChange" | "viewportTransform" | "itemOnDragStart" | "itemOnDrag" | "itemOnDragEnd" | "spriteTextClick" | "videoPlay" | "itemCreate" | "cardItemTransformChange" | "viewLost" | "viewRebuildFinish">(eventName: E, listener: import("@galacean/effects").EventEmitterListener<SDKEvents[E]>, options?: import("@galacean/effects").EventEmitterOptions) => () => void;
     initPlayer(mode: SDKMode): void;
     setSDKMode(mode: SDKMode): void;
+    private syncCanvasLayerOrder;
     private getInitParam;
     private initExporter;
     private initSDK;
@@ -507,6 +508,25 @@ export declare class SDK {
      * @returns 是否已注册
      */
     isCardTypeRegistered(type: string): boolean;
+    /**
+     * @description 按 cardType 从注册表解析卡片的 HTML 渲染配置。
+     * @param item 卡片元素
+     * @returns HTML 渲染配置
+     */
+    resolveCardHTML(item: CardItem): CardHTML | undefined;
+    /**
+     * @description 按 cardType 从注册表解析卡片类型配置。
+     * @param item 卡片元素
+     * @returns 卡片类型配置
+     */
+    resolveCardTypeConfig(item: CardItem): CardTypeConfig | undefined;
+    /**
+     * @description 重新解析并挂载指定卡片的 HTML 内容。
+     * @description 当 inline/document 内容依赖 extension 或外部状态变化时，可调用此方法刷新 DOM。
+     * @param id 卡片元素 ID
+     * @returns 是否成功触发刷新
+     */
+    refreshCardHTML(id: string): boolean;
     /**
      * @description 创建卡片元素
      * @description 底层以透明 SpriteItem 形式渲染，支持 cardType 属性

package/dist/{src/types.d.ts → types.d.ts}

@@ -204,6 +204,17 @@ export type CardHTMLShellContent = {
      */
     render: CardHTMLShellRenderer;
 };
+export type CardHTMLRootStyle = Record<string, string | number | undefined>;
+export type CardHTMLRootConfig = {
+    /**
+     * @description 追加到 HTML 内容根节点的 className。
+     */
+    className?: string;
+    /**
+     * @description 应用到 HTML 内容根节点的内联样式。
+     */
+    style?: CardHTMLRootStyle;
+};
 /**
  * @description Card HTML 覆盖层配置。
  */
@@ -216,23 +227,19 @@ export type CardHTML = {
      * @description HTML 外壳，用于定制承载 content 的容器。
      */
     shell?: CardHTMLShellContent;
+    /**
+     * @description HTML 内容根节点样式配置，用于按内容实例设置 className 或内联 style。
+     */
+    root?: CardHTMLRootConfig;
 };
 /**
  * @description Card 卡片元素属性
  */
 export type CardItemProperty = BaseItemProperty & {
     /**
-     * @description 卡片类型（动态配置，需在 SDK.config.itemConfig.cardConfig.cardTypes 中注册）
+     * @description 卡片类型（动态配置，需通过 SDK.registerCardType/registerCardTypes 注册）
      */
     cardType: string;
-    /**
-     * @description 是否根据 HTML 挂载内容的自然高度自动更新卡片高度
-     */
-    autoHeight?: boolean;
-    /**
-     * @description HTML 覆盖层配置；存在该字段时由 DOM overlay 渲染
-     */
-    html?: CardHTML;
 };
 /**
  * @description Frame 画板元素布局模式
@@ -927,7 +934,7 @@ export type CardItemTransformInfo = {
     size: [number, number];
 };
 /**
- * @description 卡片类型（动态配置，需在 SDK.config.itemConfig.cardConfig.cardTypes 中注册）
+ * @description 卡片类型（动态配置，需通过 SDK.registerCardType/registerCardTypes 注册）
  */
 export type CardType = string;
 /**
@@ -970,10 +977,6 @@ export type CardCreateInfo = {
          * @description 卡片元素像素高度
          */
         height: number;
-        /**
-         * @description 是否根据 HTML 挂载内容的自然高度自动更新卡片高度
-         */
-        autoHeight?: boolean;
         /**
          * @description 卡片元素位置
          */
@@ -986,10 +989,6 @@ export type CardCreateInfo = {
          * @description 卡片元素缩放
          */
         scale?: [number, number];
-        /**
-         * @description HTML 覆盖层配置；存在该字段时由 DOM overlay 渲染
-         */
-        html?: CardHTML;
     };
 };
 /**

package/dist/{src/utils → utils}/page-data-utils.d.ts

@@ -88,6 +88,10 @@ export declare class PageDataUtils {
      *   2. 单个元素多个属性: { itemId, type, property }
      */
     setItemProperty<T extends SDKItemType>(param: SetItemPropertyParam<T>): Promise<void>;
+    /**
+     * @description 设置元素extension字段
+     */
+    setItemExtension(itemId: string, extension: Record<string, any>): void;
     /**
      * @description 场景 1: 设置单个元素的单个属性
      */
@@ -333,6 +337,13 @@ export declare class PageDataUtils {
      * @param targetParentVFXItem 目标父 VFXItem（移入 Frame 时为 compositionItem，移出 Frame 时为 composition.rootItem）
      */
     getItemTransformUnderParent(itemId: string, targetParentVFXItem: VFXItem): MoveItemTransformOptions | undefined;
+    /**
+     * @description 修改画板元素大小
+     * @param id 元素id
+     * @param size 目标大小 [width, height]
+     * @param translation 位置偏移补偿（可选，用于保持拖拽角点固定）
+     */
+    resizeCardItem(id: string, size: spec.vec2, translation?: Vector3): void;
     /**
      * @description 修改画板元素大小
      * @param id 元素id

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vvfx/sdk",
   "description": "TODO",
-  "version": "0.2.2-beta.1",
+  "version": "0.2.2-beta.12",
   "main": "./dist/index.mjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -68,7 +68,7 @@
     "prebuild": "pnpm clean",
     "build": "pnpm build:declaration && pnpm build:module",
     "build:module": "rollup -c --bundleConfigAsCjs",
-    "build:declaration": "tsc -d --emitDeclarationOnly",
+    "build:declaration": "tsc -p tsconfig.build.json",
     "clean": "rimraf dist *.tsbuildinfo",
     "test": "vitest run"
   }