@vvfx/sdk 0.2.2-beta.3 → 0.2.2-beta.5

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/sdk.d.ts

@@ -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;
@@ -513,6 +514,19 @@ export declare class SDK {
      * @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/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,6 +227,10 @@ export type CardHTML = {
      * @description HTML 外壳，用于定制承载 content 的容器。
      */
     shell?: CardHTMLShellContent;
+    /**
+     * @description HTML 内容根节点样式配置，用于按内容实例设置 className 或内联 style。
+     */
+    root?: CardHTMLRootConfig;
 };
 /**
  * @description Card 卡片元素属性
@@ -225,14 +240,6 @@ export type CardItemProperty = BaseItemProperty & {
      * @description 卡片类型（动态配置，需通过 SDK.registerCardType/registerCardTypes 注册）
      */
     cardType: string;
-    /**
-     * @description 是否根据 HTML 挂载内容的自然高度自动更新卡片高度
-     */
-    autoHeight?: boolean;
-    /**
-     * @description HTML 内容是否跟随卡片 scale 缩放，关闭后 HTML 按最终显示尺寸重新布局
-     */
-    autoScale?: boolean;
 };
 /**
  * @description Frame 画板元素布局模式
@@ -970,14 +977,6 @@ export type CardCreateInfo = {
          * @description 卡片元素像素高度
          */
         height: number;
-        /**
-         * @description 是否根据 HTML 挂载内容的自然高度自动更新卡片高度
-         */
-        autoHeight?: boolean;
-        /**
-         * @description HTML 内容是否跟随卡片 scale 缩放，关闭后 HTML 按最终显示尺寸重新布局
-         */
-        autoScale?: boolean;
         /**
          * @description 卡片元素位置
          */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vvfx/sdk",
   "description": "TODO",
-  "version": "0.2.2-beta.3",
+  "version": "0.2.2-beta.5",
   "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"
   }

package/dist/html-overlay/auto-height-runtime.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/html-overlay/manager.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/html-overlay/overlay-transform.test.d.ts

@@ -1 +0,0 @@
-export {};