import { type IframeHTMLAttributes } from "react";
import { type EmbeddedAppUrlOptions } from "./protocol.js";
export interface EmbeddedAppRef {
    iframe: HTMLIFrameElement | null;
    origin: string | null;
    postMessage<TPayload = unknown>(name: string, payload?: TPayload): boolean;
    request<TResult = unknown, TPayload = unknown>(name: string, payload?: TPayload, options?: {
        timeoutMs?: number;
    }): Promise<TResult>;
    focus(): void;
}
export interface EmbeddedAppMessageInfo<TPayload = unknown> {
    name: string;
    payload: TPayload;
    event: MessageEvent;
    ref: EmbeddedAppRef;
}
export interface EmbeddedAppProps extends Omit<IframeHTMLAttributes<HTMLIFrameElement>, "src" | "onLoad"> {
    url: string;
    /**
     * Origin used when posting messages to the iframe. Defaults to url's origin.
     */
    targetOrigin?: string;
    /**
     * Origins allowed to send messages back. Defaults to targetOrigin.
     */
    allowedOrigins?: string[];
    /**
     * Adds `embedded=1` by default. Pass false to use the URL untouched.
     */
    embed?: boolean | EmbeddedAppUrlOptions;
    onLoad?: (ref: EmbeddedAppRef) => void;
    onReady?: (payload: unknown, event: MessageEvent, ref: EmbeddedAppRef) => void;
    onMessage?: <TPayload = unknown>(name: string, payload: TPayload, event: MessageEvent, ref: EmbeddedAppRef) => void;
    onRequest?: (name: string, payload: unknown, event: MessageEvent, ref: EmbeddedAppRef) => unknown | Promise<unknown>;
}
export declare function isEmbeddedAppMessageSource(event: Pick<MessageEvent, "source">, iframe: Pick<HTMLIFrameElement, "contentWindow"> | null): boolean;
export declare const EmbeddedApp: import("react").ForwardRefExoticComponent<EmbeddedAppProps & import("react").RefAttributes<EmbeddedAppRef>>;
//# sourceMappingURL=react.d.ts.map