@vninvestcharts/widget 0.0.0-stage → 0.2.0

package/dist/iframe-host/host-entry.d.mts

@@ -0,0 +1,818 @@
+/**
+ * WP-11: Iframe PostMessage Protocol Types
+ *
+ * Defines the typed message protocol for Host ↔ Iframe communication.
+ * Custom Data Adapters (callbacks) CANNOT be serialized over postMessage.
+ * Iframe mode only supports built-in adapters via JSON-serializable config.
+ */
+/** Base message envelope with correlation ID for request/response matching */
+interface BaseMessage {
+    /** Unique message type identifier */
+    type: string;
+    /** Correlation ID for matching requests to responses */
+    correlationId: string;
+    /** Timestamp when message was sent */
+    timestamp: number;
+    /** Origin of the message (for security validation) */
+    origin: string;
+}
+/** Request message expecting a response */
+interface RequestMessage<T = unknown> extends BaseMessage {
+    type: `request:${string}`;
+    payload: T;
+}
+/** Built-in adapter types supported in Iframe mode */
+type BuiltInAdapterType = "vninvest" | "tvfeed" | "yahoo" | "binance" | "coinbase" | "twelvedata" | "alphavantage" | "finnhub" | "polygon";
+/** Adapter configuration - MUST be JSON-serializable (no functions) */
+interface AdapterConfig {
+    /** Built-in adapter type identifier */
+    type: BuiltInAdapterType;
+    /** Adapter-specific configuration options */
+    options?: Record<string, string | number | boolean | null>;
+    /** Authentication token (if required) */
+    token?: string;
+}
+/** Widget configuration for Iframe initialization */
+interface WidgetConfig {
+    /** Symbol to display (e.g., "VNM", "AAPL") */
+    symbol: string;
+    /** Timeframe (e.g., "1D", "1H", "5m") */
+    timeframe: string;
+    /** Chart theme */
+    theme?: string;
+    /** Adapter configuration (built-in only, no custom callbacks) */
+    adapter?: AdapterConfig;
+    /** Initial visible range (e.g., "6M", "1Y", "ALL") */
+    range?: string;
+    /** Locale */
+    locale?: string;
+    /** Enable drawing tools UI */
+    drawingUiEnabled?: boolean;
+    /** Initial drawing tool */
+    drawingActiveTool?: string;
+    /** Pre-loaded drawings */
+    drawings?: readonly any[];
+    /** Drawing storage key for persistence */
+    drawingStorageKey?: string;
+    /** Show header with symbol search, fullscreen, etc. */
+    showHeader?: boolean;
+    /** Show footer with timeframe selector */
+    showFooter?: boolean;
+    /** Show drawing toolbar */
+    showToolbar?: boolean;
+    /** Measurement tool enabled */
+    measurementEnabled?: boolean;
+    /** Non-trading days visibility */
+    showNonTradingDays?: boolean;
+    /** Timezone */
+    timezone?: string;
+    /**
+     * E1: frame height. `"fill"` (default) = iframe fills the host container
+     * 100%/100% (host owns the frame — TradingView standard, zero resize
+     * messages). A number sets a fixed card height in px and enables the
+     * guarded `event:resized` reporter for bottom-panel expansion.
+     */
+    height?: number | "fill";
+    /** Custom panes configuration */
+    panes?: readonly any[];
+    /** Tenant PAT for SaaS features */
+    tenantPat?: string;
+    /** CS-3: host-pinned offline license key (`vni1.*`) */
+    licenseKey?: string;
+    /** Debug features override */
+    debugFeatures?: Record<string, boolean>;
+    /**
+     * E3: right dock in iframe. `show` maps to the widget `showDock` gate;
+     * `defaultTab` seeds the persisted dock tab; `watchlist` builds a static
+     * in-iframe adapter (JSON-only — custom adapters cannot cross postMessage).
+     */
+    dock?: {
+        show?: boolean;
+        defaultTab?: string;
+        watchlist?: string[];
+    };
+}
+/** Initialize widget with configuration */
+interface InitializeCommand {
+    type: "request:initialize";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: WidgetConfig;
+}
+/** Update widget symbol */
+interface SetSymbolCommand {
+    type: "request:setSymbol";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        symbol: string;
+    };
+}
+/** Update timeframe */
+interface SetTimeframeCommand {
+    type: "request:setTimeframe";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        timeframe: string;
+    };
+}
+/** Update visible range */
+interface SetRangeCommand {
+    type: "request:setRange";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        range: string;
+    };
+}
+/** Update theme */
+interface SetThemeCommand {
+    type: "request:setTheme";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        theme: "light" | "dark";
+    };
+}
+/** Update drawings (full replacement) */
+interface SetDrawingsCommand {
+    type: "request:setDrawings";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        drawings: readonly any[];
+    };
+}
+/** Add a single drawing */
+interface AddDrawingCommand {
+    type: "request:addDrawing";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        drawing: any;
+    };
+}
+/** Remove a drawing by ID */
+interface RemoveDrawingCommand {
+    type: "request:removeDrawing";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        drawingId: string;
+    };
+}
+/** Update drawing properties */
+interface UpdateDrawingCommand {
+    type: "request:updateDrawing";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        drawingId: string;
+        updates: Partial<any>;
+    };
+}
+/** Set active drawing tool */
+interface SetActiveToolCommand {
+    type: "request:setActiveTool";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        tool: string;
+    };
+}
+/** E3: switch the right-dock tab (no-op when the dock is closed or missing the tab) */
+interface SetDockTabCommand {
+    type: "request:setDockTab";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        tab: string;
+    };
+}
+/** E3: replace the dock watchlist (static symbols; streaming arrives in E5) */
+interface SetWatchlistCommand {
+    type: "request:setWatchlist";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        symbols: string[];
+    };
+}
+/** E5: host subscribes to live quotes fan-out */
+interface SubscribeQuotesCommand {
+    type: "request:subscribeQuotes";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        symbols: string[];
+    };
+}
+/** E5: host unsubscribes (omitted symbols = all) */
+interface UnsubscribeQuotesCommand {
+    type: "request:unsubscribeQuotes";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        symbols?: string[];
+    };
+}
+/** Export current drawings */
+interface ExportDrawingsCommand {
+    type: "request:exportDrawings";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: Record<string, never>;
+}
+/** Get current visible range */
+interface GetVisibleRangeCommand {
+    type: "request:getVisibleRange";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: Record<string, never>;
+}
+/** Get current pane snapshots */
+interface GetPaneSnapshotsCommand {
+    type: "request:getPaneSnapshots";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: Record<string, never>;
+}
+/** Capture snapshot as image */
+interface CaptureSnapshotCommand {
+    type: "request:captureSnapshot";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        format?: "png" | "jpeg";
+        quality?: number;
+    };
+}
+/** Toggle fullscreen */
+interface ToggleFullscreenCommand {
+    type: "request:toggleFullscreen";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: Record<string, never>;
+}
+/** Set locale */
+interface SetLocaleCommand {
+    type: "request:setLocale";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        locale: string;
+    };
+}
+/** Set timezone */
+interface SetTimezoneCommand {
+    type: "request:setTimezone";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        timezone: string;
+    };
+}
+/** Destroy widget and cleanup */
+interface DestroyCommand {
+    type: "request:destroy";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: Record<string, never>;
+}
+/** Union of all Host → Iframe commands */
+type HostToIframeCommand = InitializeCommand | SetSymbolCommand | SetTimeframeCommand | SetRangeCommand | SetThemeCommand | SetDrawingsCommand | AddDrawingCommand | RemoveDrawingCommand | UpdateDrawingCommand | SetActiveToolCommand | SetDockTabCommand | SetWatchlistCommand | SubscribeQuotesCommand | UnsubscribeQuotesCommand | ExportDrawingsCommand | GetVisibleRangeCommand | GetPaneSnapshotsCommand | CaptureSnapshotCommand | ToggleFullscreenCommand | SetLocaleCommand | SetTimezoneCommand | DestroyCommand;
+/** Widget initialized and ready */
+interface ReadyEvent {
+    type: "event:ready";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        version: string;
+        capabilities: string[];
+    };
+}
+/** Symbol changed */
+interface SymbolChangedEvent {
+    type: "event:symbolChanged";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        symbol: string;
+        previousSymbol: string | null;
+    };
+}
+/** Timeframe changed */
+interface TimeframeChangedEvent {
+    type: "event:timeframeChanged";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        timeframe: string;
+        previousTimeframe: string | null;
+    };
+}
+/** Visible range changed (pan/zoom) */
+interface VisibleRangeChangedEvent {
+    type: "event:visibleRangeChanged";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        startIndex: number;
+        endIndex: number;
+        startDate: string;
+        endDate: string;
+        barCount: number;
+    };
+}
+/** Drawings changed */
+interface DrawingsChangedEvent {
+    type: "event:drawingsChanged";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        drawings: readonly any[];
+        action: "add" | "remove" | "update" | "replace";
+    };
+}
+/** Drawing tool changed */
+interface ActiveToolChangedEvent {
+    type: "event:activeToolChanged";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        tool: string;
+        previousTool: string | null;
+    };
+}
+/** Theme changed */
+interface ThemeChangedEvent {
+    type: "event:themeChanged";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        theme: "light" | "dark";
+    };
+}
+/** Error occurred */
+interface ErrorEvent {
+    type: "event:error";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        code: string;
+        message: string;
+        recoverable: boolean;
+    };
+}
+/** Snapshot captured */
+interface SnapshotCapturedEvent {
+    type: "event:snapshotCaptured";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        dataUrl: string;
+        format: string;
+        width: number;
+        height: number;
+    };
+}
+/** Fullscreen toggled */
+interface FullscreenToggledEvent {
+    type: "event:fullscreenToggled";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        isFullscreen: boolean;
+    };
+}
+/** SaaS feature gate error (premium feature blocked) */
+interface SaaSErrorEvent {
+    type: "event:saasError";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        feature: string;
+        message: string;
+        requiresUpgrade: boolean;
+    };
+}
+/** Adapter error (data fetch failed) */
+interface AdapterErrorEvent {
+    type: "event:adapterError";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        code: string;
+        message: string;
+        adapterType: string;
+    };
+}
+/** Frame resized (E1: card mode only — fill mode never emits this) */
+interface ResizedEvent {
+    type: "event:resized";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        height: number;
+    };
+}
+/** E5: batched live quotes (latest-wins per symbol, ≥250ms cadence) */
+interface QuotesEvent {
+    type: "event:quotes";
+    correlationId: string;
+    timestamp: number;
+    origin: string;
+    payload: {
+        updates: Array<{
+            symbol: string;
+            price?: number;
+            change?: number;
+            changePercent?: number;
+            sparkline?: number[];
+        }>;
+    };
+}
+/** Union of all Iframe → Host events */
+type IframeToHostEvent = ReadyEvent | SymbolChangedEvent | TimeframeChangedEvent | VisibleRangeChangedEvent | DrawingsChangedEvent | ActiveToolChangedEvent | ThemeChangedEvent | ErrorEvent | SnapshotCapturedEvent | FullscreenToggledEvent | SaaSErrorEvent | AdapterErrorEvent | ResizedEvent | QuotesEvent;
+/** Initialize response */
+interface InitializeResponse {
+    success: true;
+    widgetId: string;
+}
+/** Export drawings response */
+interface ExportDrawingsResponse {
+    success: true;
+    drawings: readonly any[];
+}
+/** Get visible range response */
+interface GetVisibleRangeResponse {
+    success: true;
+    range: {
+        startIndex: number;
+        endIndex: number;
+        startDate: string;
+        endDate: string;
+        barCount: number;
+    } | null;
+}
+/** Get pane snapshots response */
+interface GetPaneSnapshotsResponse {
+    success: true;
+    snapshots: readonly any[];
+}
+/** Capture snapshot response */
+interface CaptureSnapshotResponse {
+    success: true;
+    dataUrl: string;
+}
+/** Generic error response */
+interface ErrorResponse {
+    success: false;
+    error: string;
+}
+/** Generic success response (for commands that don't return data) */
+interface SuccessResponse {
+    success: true;
+}
+/** Union of all response payloads */
+type ResponsePayload = InitializeResponse | ExportDrawingsResponse | GetVisibleRangeResponse | GetPaneSnapshotsResponse | CaptureSnapshotResponse | SuccessResponse | ErrorResponse;
+
+/**
+ * WP-11: Iframe Bridge - Host ↔ Iframe Communication Layer
+ *
+ * Handles postMessage communication with:
+ * - Origin validation against allowlist
+ * - Request/response correlation
+ * - Event emission
+ * - Automatic cleanup
+ */
+
+/** Allowed origins for postMessage security */
+interface AllowedOriginsConfig {
+    /** List of allowed origins (exact match or wildcard patterns) */
+    allowedOrigins: string[];
+    /** Whether to allow any origin (DANGEROUS - only for development) */
+    allowAnyOrigin?: boolean;
+}
+/**
+ * Default allowed origins — override per deployment.
+ * SECURITY: Remove `http://localhost` entries in production.
+ */
+declare const DEFAULT_ALLOWED_ORIGINS: string[];
+/** Message handler type */
+type MessageHandler = (message: IframeToHostEvent) => void;
+/** Request handler type (for Iframe side) */
+type RequestHandler = (command: HostToIframeCommand) => Promise<ResponsePayload>;
+/** Bridge configuration */
+interface BridgeConfig {
+    /** Target window (iframe.contentWindow or window.parent) */
+    targetWindow: Window;
+    /** Target origin for sending messages */
+    targetOrigin: string;
+    /** Allowed origins for receiving messages */
+    allowedOrigins: string[];
+    /** Whether we are the Host (true) or Iframe (false) */
+    isHost: boolean;
+    /** Request timeout in ms */
+    requestTimeout?: number;
+    /** Callback when connection is established */
+    onReady?: () => void;
+    /** Callback on connection error */
+    onError?: (error: Error) => void;
+    /** Whether to allow any origin (DANGEROUS - only for development) */
+    allowAnyOrigin?: boolean;
+    /**
+     * SEC-01: maximum serialized size of an accepted inbound message.
+     * Oversized payloads are rejected before parsing or state mutation.
+     */
+    maxPayloadBytes?: number;
+    /**
+     * SEC-01: inbound message budget. Once more than `maxMessages` are accepted
+     * within `rateWindowMs`, further traffic is dropped until the window rolls.
+     */
+    maxMessages?: number;
+    rateWindowMs?: number;
+}
+/**
+ * Iframe Bridge - bidirectional postMessage communication
+ */
+declare class IframeBridge {
+    private config;
+    private pendingRequests;
+    private messageHandler;
+    private requestHandler;
+    private boundHandleMessage;
+    private isDestroyed;
+    private readyPromise;
+    private readyResolve;
+    /**
+     * Origin pinned from the first origin-allowlisted incoming message
+     * (iframe side). All outbound sends use it instead of the "*" fallback,
+     * so widget data is never broadcast to arbitrary windows once the host
+     * is known. Re-pinned on every validated message (allows host moves).
+     */
+    private pinnedSendOrigin;
+    /** SEC-01: sliding-window counters for the inbound rate limit. */
+    private rateWindowStart;
+    private rateCount;
+    constructor(config: BridgeConfig);
+    /**
+     * Set handler for incoming events (Host side)
+     */
+    setMessageHandler(handler: MessageHandler): void;
+    /**
+     * Set handler for incoming requests (Iframe side)
+     */
+    setRequestHandler(handler: RequestHandler): void;
+    /**
+     * Resolve the target origin for outbound sends. Prefers the pinned
+     * validated origin; falls back to the configured targetOrigin ("*" only
+     * until the first allowlisted message arrives on the iframe side).
+     */
+    private resolveSendOrigin;
+    /**
+     * Send a command to the other side
+     */
+    sendCommand<T extends HostToIframeCommand>(command: T, timeoutMs?: number): Promise<ResponsePayload>;
+    /**
+     * Send an event (fire-and-forget)
+     */
+    sendEvent(event: IframeToHostEvent): void;
+    /**
+     * Send a response to a request
+     */
+    sendResponse(request: RequestMessage, payload: ResponsePayload, success?: boolean, error?: string): void;
+    /**
+     * Wait for the bridge to be ready (Iframe side)
+     */
+    waitForReady(): Promise<void>;
+    /**
+     * Signal that Iframe is ready (Iframe side)
+     */
+    signalReady(version: string, capabilities: string[]): void;
+    /**
+     * Validate message origin against allowlist.
+     *
+     * SEC-01: wildcard patterns are matched as PLAIN STRINGS, never compiled into
+     * a RegExp. The previous implementation replaced every `*` with `.*` and then
+     * ran `new RegExp`, which left every `.` unescaped, so a pattern like
+     * `https:` + wildcard-subdomain + `vninvestcharts.com` also matched origins
+     * such as `https://evilvninvestchartsXcom`. Only a leading subdomain
+     * wildcard is supported and it must sit on a scheme boundary.
+     */
+    private isOriginAllowed;
+    /** SEC-01: counters for rejected traffic — surfaced for tests/monitoring. */
+    readonly stats: {
+        rejectedOrigin: number;
+        rejectedSize: number;
+        rejectedRate: number;
+        accepted: number;
+    };
+    /**
+     * SEC-01: size + rate gate, applied after the origin is trusted so that
+     * hostile origins are not charged against the budget.
+     */
+    private passesTrafficBudget;
+    /**
+     * Handle incoming postMessage
+     */
+    private handleMessage;
+    /**
+     * Destroy the bridge and cleanup
+     */
+    destroy(): void;
+}
+/**
+ * Create Host-side bridge (parent page embedding iframe)
+ */
+declare function createHostBridge(iframe: HTMLIFrameElement, allowedOrigins?: string[], options?: Partial<BridgeConfig>): IframeBridge;
+
+/**
+ * WP-11: Host SDK - Type-safe API for embedding VNInvestCharts in an iframe
+ *
+ * Provides a clean Promise-based API for controlling the widget from the parent page.
+ * Handles connection lifecycle, origin validation, and automatic reconnection.
+ */
+
+/** Host SDK configuration */
+interface HostSDKConfig {
+    /** Iframe element or selector */
+    iframe: HTMLIFrameElement | string;
+    /** Allowed origins for postMessage security */
+    allowedOrigins?: string[];
+    /** Connection timeout in ms */
+    connectionTimeout?: number;
+    /** Request timeout in ms */
+    requestTimeout?: number;
+    /** Callback when widget is ready */
+    onReady?: (info: {
+        version: string;
+        capabilities: string[];
+    }) => void;
+    /** Callback on widget events */
+    onEvent?: (event: IframeToHostEvent) => void;
+    /** Callback on connection error */
+    onError?: (error: Error) => void;
+    /** Callback when connection is lost */
+    onDisconnect?: () => void;
+}
+/** Widget control API returned by HostSDK */
+interface WidgetController {
+    /** Initialize widget with configuration */
+    initialize(config: WidgetConfig): Promise<{
+        widgetId: string;
+    }>;
+    /** Change symbol */
+    setSymbol(symbol: string): Promise<void>;
+    /** Change timeframe */
+    setTimeframe(timeframe: string): Promise<void>;
+    /** Change visible range */
+    setRange(range: string): Promise<void>;
+    /** Change theme */
+    setTheme(theme: "light" | "dark"): Promise<void>;
+    /** Replace all drawings */
+    setDrawings(drawings: readonly any[]): Promise<void>;
+    /** Add a drawing */
+    addDrawing(drawing: any): Promise<void>;
+    /** Remove a drawing by ID */
+    removeDrawing(drawingId: string): Promise<void>;
+    /** Update a drawing */
+    updateDrawing(drawingId: string, updates: Partial<any>): Promise<void>;
+    /** Set active drawing tool */
+    setActiveTool(tool: string): Promise<void>;
+    /** E3: switch the right-dock tab */
+    setDockTab(tab: string): Promise<void>;
+    /** E3: replace the dock watchlist (static symbols) */
+    setWatchlist(symbols: string[]): Promise<void>;
+    /** Export current drawings */
+    exportDrawings(): Promise<readonly any[]>;
+    /** Get current visible range */
+    getVisibleRange(): Promise<{
+        startIndex: number;
+        endIndex: number;
+        startDate: string;
+        endDate: string;
+        barCount: number;
+    } | null>;
+    /** Get current pane snapshots */
+    getPaneSnapshots(): Promise<readonly any[]>;
+    /** Capture snapshot as image */
+    captureSnapshot(format?: "png" | "jpeg", quality?: number): Promise<string>;
+    /** Toggle fullscreen */
+    toggleFullscreen(): Promise<void>;
+    /** Set locale */
+    setLocale(locale: string): Promise<void>;
+    /** Set timezone */
+    setTimezone(timezone: string): Promise<void>;
+    /** Destroy widget and cleanup */
+    destroy(): Promise<void>;
+    /** E5: subscribe to live quote fan-out (batch ≥250ms); returns unsubscribe */
+    subscribeQuotes(symbols: string[], onQuotes: (updates: Array<{
+        symbol: string;
+        price?: number;
+        change?: number;
+        changePercent?: number;
+    }>) => void): Promise<() => Promise<void>>;
+    /** Check if widget is ready */
+    isReady(): boolean;
+    /** Get widget version */
+    getVersion(): string | null;
+}
+/** E4: typed embed error — `{code, recoverable, detail}` for the host matrix. */
+declare class EmbedError extends Error {
+    readonly code: string;
+    readonly recoverable: boolean;
+    readonly detail?: string;
+    constructor(code: string, message: string, recoverable?: boolean, detail?: string);
+}
+/**
+ * Host SDK for controlling VNInvestCharts widget in an iframe
+ */
+declare class VNInvestChartsHostSDK {
+    private config;
+    private iframe;
+    private bridge;
+    private isReady;
+    private version;
+    private capabilities;
+    private readyPromise;
+    private readyResolve;
+    private eventListeners;
+    constructor(config: HostSDKConfig);
+    /**
+     * Connect to the iframe widget
+     */
+    connect(): Promise<void>;
+    /**
+     * Wait for iframe to finish loading
+     */
+    private waitForIframeLoad;
+    /**
+     * Handle ready signal from iframe
+     */
+    private handleReady;
+    /**
+     * Handle incoming events from iframe
+     */
+    private handleEvent;
+    /**
+     * Get the widget controller API
+     */
+    getController(): WidgetController;
+    /**
+     * Subscribe to specific event types
+     */
+    on<K extends IframeToHostEvent["type"]>(eventType: K, listener: (payload: Extract<IframeToHostEvent, {
+        type: K;
+    }>["payload"]) => void): () => void;
+    /**
+     * Disconnect and cleanup
+     */
+    disconnect(): void;
+    /**
+     * Check if connected and ready
+     */
+    get connected(): boolean;
+}
+/**
+ * Convenience function to create and connect Host SDK in one call
+ */
+declare function createVNInvestChartsHost(config: HostSDKConfig): Promise<VNInvestChartsHostSDK>;
+
+export { type AdapterConfig, type AllowedOriginsConfig, type BridgeConfig, DEFAULT_ALLOWED_ORIGINS, EmbedError, type HostSDKConfig, type HostToIframeCommand, IframeBridge, type IframeToHostEvent, type ResponsePayload, VNInvestChartsHostSDK, type WidgetConfig, type WidgetController, createHostBridge, createVNInvestChartsHost };