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

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,11 +21,6 @@ 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 位置
      */

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';
@@ -507,6 +507,12 @@ export declare class SDK {
      * @returns 是否已注册
      */
     isCardTypeRegistered(type: string): boolean;
+    /**
+     * @description 按 cardType 从注册表解析卡片的 HTML 渲染配置。
+     * @param item 卡片元素
+     * @returns HTML 渲染配置
+     */
+    resolveCardHTML(item: CardItem): CardHTML | undefined;
     /**
      * @description 创建卡片元素
      * @description 底层以透明 SpriteItem 形式渲染，支持 cardType 属性

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

@@ -222,7 +222,7 @@ export type CardHTML = {
  */
 export type CardItemProperty = BaseItemProperty & {
     /**
-     * @description 卡片类型（动态配置，需在 SDK.config.itemConfig.cardConfig.cardTypes 中注册）
+     * @description 卡片类型（动态配置，需通过 SDK.registerCardType/registerCardTypes 注册）
      */
     cardType: string;
     /**
@@ -230,9 +230,9 @@ export type CardItemProperty = BaseItemProperty & {
      */
     autoHeight?: boolean;
     /**
-     * @description HTML 覆盖层配置；存在该字段时由 DOM overlay 渲染
+     * @description HTML 内容是否跟随卡片 scale 缩放，关闭后 HTML 按最终显示尺寸重新布局
      */
-    html?: CardHTML;
+    autoScale?: boolean;
 };
 /**
  * @description Frame 画板元素布局模式
@@ -927,7 +927,7 @@ export type CardItemTransformInfo = {
     size: [number, number];
 };
 /**
- * @description 卡片类型（动态配置，需在 SDK.config.itemConfig.cardConfig.cardTypes 中注册）
+ * @description 卡片类型（动态配置，需通过 SDK.registerCardType/registerCardTypes 注册）
  */
 export type CardType = string;
 /**
@@ -974,6 +974,10 @@ export type CardCreateInfo = {
          * @description 是否根据 HTML 挂载内容的自然高度自动更新卡片高度
          */
         autoHeight?: boolean;
+        /**
+         * @description HTML 内容是否跟随卡片 scale 缩放，关闭后 HTML 按最终显示尺寸重新布局
+         */
+        autoScale?: boolean;
         /**
          * @description 卡片元素位置
          */
@@ -986,10 +990,6 @@ export type CardCreateInfo = {
          * @description 卡片元素缩放
          */
         scale?: [number, number];
-        /**
-         * @description HTML 覆盖层配置；存在该字段时由 DOM overlay 渲染
-         */
-        html?: CardHTML;
     };
 };
 /**

package/dist/wireframe/common/box.d.ts

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

package/dist/wireframe/common/dashed-line.d.ts

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

package/dist/wireframe/common/line.d.ts

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vvfx/sdk",
   "description": "TODO",
-  "version": "0.2.2-beta.1",
+  "version": "0.2.2-beta.3",
   "main": "./dist/index.mjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",