/** One selectable merge-token. */
export interface TokenInsertMenuToken {
    /** Raw token text inserted verbatim (e.g. `"{{patient.name}}"`). */
    value: string;
    /** Human-readable label shown in the menu. Already localised by the consumer. */
    label: string;
    /** Optional section heading — when ANY token has one, the menu renders grouped. */
    group?: string;
}
/** Agent-readiness curated handle for TokenInsertMenu. */
export interface TokenInsertMenuHandle {
    isOpen: () => boolean;
    open: () => void;
    close: () => void;
    /** Emit a token to the consumer (mirrors a user selecting it). */
    insert: (token: string) => void;
}
export interface TokenInsertMenuProps {
    /** The merge-tokens to offer. `value` is inserted; `label` is shown. */
    tokens: TokenInsertMenuToken[];
    /** Called with the chosen token's raw `value`. The consumer inserts it at
     *  the caret of their target field — this component never owns the field. */
    onInsert: (token: string) => void;
    /** The trigger button's visible text (already localised by the consumer). */
    triggerLabel: string;
    disabled?: boolean;
    /** Opaque instance id — surfaced as `data-component-id` + agent instance id. */
    id?: string;
    /** Extra classes for the trigger button. */
    className?: string;
}
export declare const TokenInsertMenu: import("react").ForwardRefExoticComponent<TokenInsertMenuProps & import("react").RefAttributes<HTMLButtonElement>>;
//# sourceMappingURL=token-insert-menu.d.ts.map