import { type ReactNode } from "react";
import { type StyleProp, type ViewStyle } from "../../style/index.js";
import { type TooltipSkin } from "./tooltip.styles.js";
export interface TooltipProps {
    /**
     * An arbitrary element for the tip to hang off: an existing Button, Chip, or
     * any other control that already owns its own press and accessible name. The
     * highest-precedence trigger: children win over `iconTrigger`, `textTrigger`,
     * and the default Button. The child renders as-is and stays the single
     * interactive, labelled element; the root view Tooltip wraps it in takes no
     * accessibility role and no tab stop, listens only for hover and focus, and
     * never claims the press, so a Button child keeps its `onPress` and the tip
     * does not toggle on tap.
     */
    children?: ReactNode;
    label?: string;
    /**
     * The element the tip describes. By default rendered as a text
     * `<Button outline small>`; set `iconTrigger` for a ghost icon button,
     * `textTrigger` to hang the tip off an inline pressable word, or pass
     * `children` to wrap an element you already have. Ignored when `children` is
     * passed.
     */
    trigger?: string;
    /**
     * Render the trigger as a ghost icon button (a settings glyph) instead of the
     * text Button. When set, `trigger` (the label string) is ignored. Ignored
     * when `children` is passed, which takes precedence.
     */
    iconTrigger?: boolean;
    /**
     * Render the `trigger` string as a pressable inline word (an underlined
     * hover-text affordance) rather than the default text Button, so the tip can
     * hang off a run of body copy. Orthogonal to placement (top/left/right/bottom).
     * Ignored when `children` or `iconTrigger` is set, both of which take
     * precedence.
     */
    textTrigger?: boolean;
    /**
     * Controlled visibility. Omit for uncontrolled: the tip shows while the
     * trigger is hovered or focused, and a tap toggles it (the touch analogue
     * of hover) on the built-in triggers. An element trigger (`children`) has no
     * tap toggle (the child keeps its own press), and native platforms never fire
     * hover, so `open` is the native and touch path for that trigger.
     */
    open?: boolean;
    onOpenChange?: (open: boolean) => void;
    top?: boolean;
    bottom?: boolean;
    left?: boolean;
    right?: boolean;
    /** E2E hook forwarded to the root element. */
    testID?: string;
    /** Outer layout composition only (width/flex within a parent), never a restyle hook. */
    style?: StyleProp<ViewStyle>;
}
/** Build a Tooltip component from a platform skin. */
export declare function createTooltip(skin: TooltipSkin): (props: TooltipProps) => import("react").JSX.Element;
//# sourceMappingURL=tooltip.shared.d.ts.map