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

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

@@ -1,6 +1,9 @@
 import { ExportMediaInitOptions } from './exporter';
 import { GlobalLayoutMode } from './utils';
+import type { CardHTML } from './types';
+import type { CardItem } from './sdk-item/card-item';
 export type SDKMode = 'editor' | 'template';
+export type CardTypeHTMLResolver = (item: CardItem) => CardHTML | undefined;
 /**
  * @description SDK功能配置
  */
@@ -136,6 +139,10 @@ export type CardTypeConfig = {
      * @description TransformGizmo 左上角展示的 icon URL
      */
     iconUrl: string;
+    /**
+     * @description 卡片类型对应的运行时 HTML 渲染配置；函数不会进入序列化数据，恢复时由 cardType 动态解析。
+     */
+    html?: CardTypeHTMLResolver;
 };
 /**
  * @description 卡片元素参数配置
@@ -146,7 +153,7 @@ export type CardConfig = {
      */
     backgroundColor: [number, number, number, number];
     /**
-     * @description 注册的卡片类型列表，支持动态配置
+     * @description 注册的卡片类型列表，支持通过 registerCardType/registerCardTypes 动态配置
      * 每个条目包含 type 标识、显示名称和图标 URL
      */
     cardTypes: CardTypeConfig[];

package/dist/{src/html-overlay → html-overlay}/auto-height-runtime.d.ts

@@ -4,10 +4,15 @@ export type CardHTMLAutoHeightMessage = {
     id: string;
     height: number;
 };
+export type CardHTMLAutoHeightRequest = {
+    source: 'vvfx-card-html-auto-height-request';
+    id: string;
+};
 export type CardHTMLAutoHeightOptions = {
     autoHeightId?: string;
     onAutoHeight?: (height: number) => void;
 };
 export declare function createAutoHeightMessageListener(iframe: HTMLIFrameElement, options?: CardHTMLAutoHeightOptions): CardHTMLRenderCleanup;
 export declare function isCardHTMLAutoHeightMessage(data: unknown, id: string): data is CardHTMLAutoHeightMessage;
+export declare function requestCardHTMLAutoHeight(iframe: HTMLIFrameElement, id: string): void;
 export declare function withCardHTMLAutoHeightBridge(html: string, id?: string): string;

package/dist/{src/html-overlay → html-overlay}/manager.d.ts

@@ -3,6 +3,7 @@ import { type SnapdomOptions } from '@zumer/snapdom';
 import type { EventEmitter } from '../shared';
 import type { SDKEvents } from '../sdk';
 import { type SDKItem } from '../sdk-item';
+import type { CardHTML } from '../types';
 type CardRasterizeOptions = {
     width: number;
     height: number;
@@ -24,6 +25,7 @@ type HTMLOverlayManagerOptions = {
     }) => void;
     viewportFit: (box: Box2) => void;
     setCardItemHeight: (id: string, height: number) => void;
+    resolveCardHTML: (item: SDKItem) => CardHTML | undefined;
 };
 export declare class HTMLOverlayManager {
     private options;
@@ -52,6 +54,7 @@ export declare class HTMLOverlayManager {
     private getOrCreateContentOverlay;
     private createContentScaleOverlay;
     private syncContentScale;
+    private requestAutoHeightFromIframes;
     private syncContentInteraction;
     private syncShellInteraction;
     private enterEditing;
@@ -64,6 +67,7 @@ export declare class HTMLOverlayManager {
     private cleanupOverlayContent;
     private removeOverlay;
     private syncAutoHeight;
+    private ensureAutoHeightMode;
     private createAutoHeightObserver;
     private scheduleAutoHeightMeasure;
     private measureAutoHeight;
@@ -72,6 +76,7 @@ export declare class HTMLOverlayManager {
     private getChildrenNaturalHeight;
     private cleanupAutoHeight;
     private applyAutoHeight;
+    private getAutoHeightItemHeight;
     private isAutoHeightMessage;
 }
 export {};

package/dist/{src/html-overlay → html-overlay}/overlay-transform.d.ts

@@ -4,9 +4,11 @@ export type CardOverlayBoxStyle = {
     top: string;
     width: string;
     height: string;
+    contentWidth: number;
+    contentHeight: number;
     transform: string;
 };
-export declare function getCardOverlayBoxStyle(box: Box2, width: number, height: number, offsetX?: number, offsetY?: number): CardOverlayBoxStyle;
+export declare function getCardOverlayBoxStyle(box: Box2, width: number, height: number, offsetX?: number, offsetY?: number, autoScale?: boolean): CardOverlayBoxStyle;
 export declare function isPointInCardOverlayBox(box: Box2, point: {
     x: number;
     y: number;