import * as react from 'react';

/**
 * MagicWand — selection-anchored floating toolbar for text inputs.
 *
 * When the user highlights text inside the wrapped <Textarea>, a small
 * pill of AI quick-actions floats above the selection. Clicking an
 * action invokes the host callback with the selected substring + range;
 * the host returns a replacement string and MagicWand swaps it in-place.
 *
 *   <MagicWand
 *     value={body}
 *     onValueChange={setBody}
 *     actions={[
 *       { id: "rephrase", label: "Rephrase", hint: "same meaning, different words",
 *         run: async (s) => await ai.rephrase(s) },
 *       …
 *     ]}
 *   />
 *
 * Two appearances: `"floating"` (default — full labels) and `"pill"`
 * (icon-only, compact). Auto-hides on click-away or scroll by default.
 */
type MagicWandSelection = {
    start: number;
    end: number;
    text: string;
};
type MagicWandAction = {
    /** Stable id, also shown as the busy-state key. */
    id: string;
    /** Display label (first character used in `pill` mode). */
    label: string;
    /** Tooltip body. */
    hint?: string;
    /** Optional kind chip rendered next to the label. */
    tag?: string;
    /** Returns the replacement text for the selection. */
    run: (selection: string, range: MagicWandSelection) => Promise<string> | string;
};
type MagicWandAppearance = "pill" | "floating";
interface MagicWandProps {
    /** Controlled textarea value. */
    value: string;
    /** Called on every edit. */
    onValueChange: (v: string) => void;
    /** Action list. */
    actions: MagicWandAction[];
    /** Visual treatment. Defaults to "floating". */
    appearance?: MagicWandAppearance;
    /** Auto-hide the wand on click-away or scroll. Defaults to true. */
    autoHide?: boolean;
    /** Textarea rows. */
    rows?: number;
    /** Placeholder. */
    placeholder?: string;
    /** Called after an action runs successfully. */
    onAction?: (action: MagicWandAction, selection: MagicWandSelection, replacement: string) => void;
}
declare function MagicWand({ value, onValueChange, actions, appearance, autoHide, rows, placeholder, onAction, }: MagicWandProps): react.JSX.Element;

export { MagicWand, type MagicWandAction, type MagicWandAppearance, type MagicWandProps, type MagicWandSelection };