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

package/dist/config.d.ts

@@ -143,6 +143,22 @@ export type CardTypeConfig = {
      * @description 卡片类型对应的运行时 HTML 渲染配置；函数不会进入序列化数据，恢复时由 cardType 动态解析。
      */
     html?: CardTypeHTMLResolver;
+    /**
+     * @description 是否根据 HTML 挂载内容的自然高度自动更新卡片高度
+     */
+    autoHeight?: boolean;
+    /**
+     * @description HTML 内容是否跟随卡片 scale 缩放，关闭后 HTML 按最终显示尺寸重新布局
+     */
+    autoScale?: boolean;
+    /**
+     * @description 是否启用编辑态交互。未配置时默认 true；只有显式 false 时，卡片默认直接交互且不进入编辑态。
+     */
+    editable?: boolean;
+    /**
+     * @description HTML 内容中可在非编辑态直接响应事件的额外 CSS 选择器；会与 SDK 默认交互选择器合并。
+     */
+    htmlInteractionSelectors?: string[];
 };
 /**
  * @description 卡片元素参数配置

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

@@ -1,5 +1,6 @@
 import type { Box2 } from '../math';
 import { type SnapdomOptions } from '@zumer/snapdom';
+import type { CardTypeConfig } from '../config';
 import type { EventEmitter } from '../shared';
 import type { SDKEvents } from '../sdk';
 import { type SDKItem } from '../sdk-item';
@@ -25,16 +26,35 @@ type HTMLOverlayManagerOptions = {
     }) => void;
     viewportFit: (box: Box2) => void;
     setCardItemHeight: (id: string, height: number) => void;
+    getSelectedItemIds: () => string[];
+    getPreSelectedItemId: () => string | undefined;
+    getSelectionEdgeStyle: () => {
+        color: number;
+        alpha: number;
+        width: number;
+    };
+    getPreSelectionEdgeStyle: () => {
+        color: number;
+        alpha: number;
+        width: number;
+    };
+    getCanvasEventTarget?: () => HTMLElement | undefined;
     resolveCardHTML: (item: SDKItem) => CardHTML | undefined;
+    resolveCardTypeConfig: (item: SDKItem) => CardTypeConfig | undefined;
 };
 export declare class HTMLOverlayManager {
     private options;
     private eventCleanups;
+    private htmlRootConfigCleanups;
+    private pendingContentInteractionEvent?;
+    private contentInteractionFrame?;
     private state;
     constructor(options: HTMLOverlayManagerOptions);
     attach(): void;
+    get layerElement(): HTMLElement | undefined;
     dispose(): void;
     scheduleRender(): void;
+    invalidateCardHTML(id: string): void;
     rasterizeCard(id: string, options: CardRasterizeOptions): Promise<string | undefined>;
     private initEvents;
     private initDOMEvents;
@@ -42,26 +62,46 @@ export declare class HTMLOverlayManager {
     private handleContainerMouseDown;
     private handleContainerMouseMove;
     private handleContainerMouseLeave;
+    private handleContainerContextMenu;
+    private isHTMLContextMenuEvent;
     private handleViewportTransform;
     private render;
     private syncOverlayOrder;
+    private getOrCreateSelectionLayer;
     private renderFrameOverlays;
     private getOrCreateFrameOverlay;
     private getOrCreateOverlay;
+    private getOrCreateSelectionOverlay;
+    private syncOverlaySelection;
+    private getSelectionBoxShadow;
+    private getPreSelectionBoxShadow;
     private getHTMLCardIdByEvent;
     private getHoverShellInteractiveIdByEvent;
+    private syncActiveContentInteraction;
+    private scheduleActiveContentInteractionSync;
+    private setActiveContentInteraction;
+    private getContentInteractiveZoneByEvent;
+    private getContentInteractionZones;
+    private getContentInteractiveSelector;
+    private isContentInteractionDisabled;
+    private invalidateContentInteractionZones;
+    private observeContentInteractionZoneResizes;
     private getLayerPoint;
     private getOrCreateContentOverlay;
     private createContentScaleOverlay;
     private syncContentScale;
     private requestAutoHeightFromIframes;
     private syncContentInteraction;
+    private syncContentInteractionZones;
     private syncShellInteraction;
     private enterEditing;
     private exitEditing;
+    private isEditableCard;
     private getEditingFitZoom;
     private isEventInsideOverlay;
     private renderOverlayHTML;
+    private observeContentInteractionZones;
+    private applyHTMLRootConfig;
     private renderOverlayContent;
     private chainCleanups;
     private cleanupOverlayContent;
@@ -78,5 +118,7 @@ export declare class HTMLOverlayManager {
     private applyAutoHeight;
     private getAutoHeightItemHeight;
     private isAutoHeightMessage;
+    private isAutoHeightEnabled;
+    private isAutoScaleEnabled;
 }
 export {};

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { SDKOptions, SDKInputParam, PageData, PageProperty, ViewProperty, ActiveData, ViewParam, BaseItemProperty, SpriteItemProperty, TextItemProperty, VideoItemProperty, GeneratorItemProperty, FrameItemProperty, FrameLayoutMode, SpriteCreateInfo, TextCreateInfo, GroupCreateInfo, VideoCreateInfo, GeneratorCreateInfo, EffectsCreateInfo, FrameCreateInfo, CardCreateInfo, CardItemProperty, CardItemTransformInfo, ItemCreateInfo, } from './types';
-export type { CardTypeConfig, CardConfig } from './config';
+export type { SDKOptions, SDKInputParam, PageData, PageProperty, ViewProperty, ActiveData, ViewParam, BaseItemProperty, SpriteItemProperty, TextItemProperty, VideoItemProperty, GeneratorItemProperty, FrameItemProperty, FrameLayoutMode, SpriteCreateInfo, TextCreateInfo, GroupCreateInfo, VideoCreateInfo, GeneratorCreateInfo, EffectsCreateInfo, FrameCreateInfo, CardCreateInfo, CardItemProperty, CardItemTransformInfo, CardHTML, CardHTMLContent, CardHTMLInlineContent, CardHTMLDOMRendererContent, CardHTMLDocumentContent, CardHTMLDocumentMessage, CardHTMLShellContent, CardHTMLShellRenderer, CardHTMLShellRendererContext, CardHTMLShellRendererResult, CardHTMLDOMRenderer, CardHTMLContentCleanup, CardHTMLRenderCleanup, CardHTMLRootConfig, CardHTMLRootStyle, ItemCreateInfo, } from './types';
+export type { SDKConfig, SDKMode, CardTypeConfig, CardConfig, CardTypeHTMLResolver, } from './config';
 export type { SDKItem } from './sdk-item';
 export { BaseItem, SpriteItem, TextItem, VideoItem, GroupItem, GeneratorItem, EffectsItem, FrameItem, CardItem, isBaseItem, isSpriteItem, isTextItem, isVideoItem, isGroupItem, isGeneratorItem, isEffectsItem, isFrameItem, isCardItem, SDKItemType, } from './sdk-item';
 export type { SDKItemOptions, SpriteItemOptions, TextItemOptions, VideoItemOptions, GroupItemOptions, GeneratorItemOptions, EffectsItemOptions, FrameItemOptions, CardItemOptions, } from './sdk-item';