import { Appearance, PaymentMethodFormCardBrandChangeEvent, PaymentMethodFormDefaultValues, PaymentMethodFormField, PaymentMethodFormValidityChangeEvent } from './types';
/**
 * The additional fields beyond the standard card number, expiration
 * date, CVV, and billing address fields that are required to be filled
 * out in the embedded credit-card form.
 */
export type CreditCardAdditionalFields = {
    cardholderName: boolean;
};
/**
 * How much billing address the embedded credit-card or bank-account form
 * collects.
 *
 * - `country` — country / region, plus postal / ZIP when that selection
 *   collects one (CA, PR, GB, US). Default.
 * - `full` — full street address (Smarty autocomplete on line 1).
 */
export type BillingAddressRequirement = "country" | "full";
/**
 * Build the iframe `src` URL for the embedded credit-card form.
 */
export declare function getCreditCardFormSrc(renderToken: string, additionalFields?: CreditCardAdditionalFields, billingAddressRequirement?: BillingAddressRequirement): string;
/**
 * Build the iframe `src` URL for the embedded bank-account form.
 *
 * Pass `intent: "setup"` so the iframe is tagged as a setup flow.
 */
export declare function getBankAccountFormSrc(renderToken: string, billingAddressRequirement?: BillingAddressRequirement, intent?: "payment" | "setup"): string;
/**
 * Default iframe pixel height for the credit-card form, taking the
 * configured `additionalFields` and `billingAddressRequirement` into
 * account.
 */
export declare function getCreditCardFormInitialHeight(additionalFields?: CreditCardAdditionalFields, billingAddressRequirement?: BillingAddressRequirement): string;
/**
 * Default iframe pixel height for the bank-account form, taking
 * `billingAddressRequirement` into account.
 */
export declare function getBankAccountFormInitialHeight(billingAddressRequirement?: BillingAddressRequirement): string;
/**
 * Options accepted by {@link attachPaymentMethodFormListeners}.
 *
 * Used by both the credit-card and bank-account forms, which share the
 * same message protocol.
 */
export type PaymentMethodFormListenerOptions = {
    /**
     * Custom appearance to apply when the iframe first becomes ready and
     * whenever the appearance changes. Can be updated later via the
     * returned controller's `update({ appearance })` method. Omitted
     * `fonts` / `--font-family` on first paint default to Inter.
     * `fonts: []` skips the webfont and uses a system stack when
     * `--font-family` is also omitted.
     */
    appearance?: Appearance;
    /**
     * Name and billing address to seed into the iframe. Can be updated
     * later via `update({ defaultValues })`. Provided keys overwrite
     * matching fields, including ones the customer already edited.
     */
    defaultValues?: PaymentMethodFormDefaultValues;
    /**
     * Called whenever the iframe asks the host page to resize it. Update
     * the iframe's `height` style here.
     */
    onHeightChange?: (height: string) => void;
    /**
     * Called once the iframe has applied the requested appearance and is
     * ready to be revealed. A common implementation is to set the
     * iframe's opacity from `0` to `1` to fade it in.
     */
    onAppearanceReady?: () => void;
    /**
     * Called when the iframe posts `IFRAME_READY` (embed JS is running).
     */
    onIframeReady?: () => void;
    /**
     * Called when card/bank form validity changes. `isValid` is true
     * when all required fields are present and valid. Does not include
     * PCI data. Use this to enable or disable a host checkout button.
     */
    onValidityChange?: (event: PaymentMethodFormValidityChangeEvent) => void;
    /**
     * Called when the detected card brand changes. `brand` is the matched
     * network, or `null` when the field is empty or the digits do not
     * match a known brand. Does not include PCI data. Credit-card form
     * only — never fired for bank account.
     */
    onCardBrandChanged?: (event: PaymentMethodFormCardBrandChangeEvent) => void;
    /**
     * Called when the customer presses Escape in the iframe. PCI-safe —
     * no field values. Use this to close a host modal that contains the
     * iframe. Not fired while an iframe dropdown or address suggestion
     * list is open (that Escape dismisses the overlay first), or while
     * Plaid Embedded Institution Search is showing.
     */
    onEscapeKeyPressed?: () => void;
};
/**
 * Controller returned by {@link attachPaymentMethodFormListeners} and
 * the credit-card / bank-account `mount*` helpers.
 */
export type PaymentMethodFormController = {
    /**
     * Update one or more listener options without re-attaching the
     * message listener. Pass `{ appearance }` to push new appearance
     * overrides into the iframe. Pass `{ defaultValues }` to overwrite
     * matching name and billing fields.
     */
    update: (patch: Partial<PaymentMethodFormListenerOptions>) => void;
    /**
     * Focus a named control inside the iframe. No-op if the field is not
     * rendered, or while Plaid Embedded Institution Search is showing.
     * Queued until `IFRAME_READY` if called before handshake.
     */
    focus: (field: PaymentMethodFormField) => void;
    /**
     * Detach the iframe message listener.
     */
    destroy: () => void;
};
/**
 * Wire up the host-page side of the credit-card or bank-account iframe
 * message protocol on an existing `<iframe>` element. Returns a
 * controller for updating options and tearing down the listener.
 *
 * The iframe is expected to have already been added to the DOM with the
 * correct `src` (see {@link getCreditCardFormSrc} /
 * {@link getBankAccountFormSrc}).
 */
export declare function attachPaymentMethodFormListeners(iframe: HTMLIFrameElement, options: PaymentMethodFormListenerOptions): PaymentMethodFormController;