import { type ReactNode, type RefObject } from 'react';
import type { TourActions, TourEndStatus, TourEvent, TourStep, TourTransition } from './types';
export interface TourRootProps {
    /** Ordered list of steps that make up the tour. */
    steps: TourStep[];
    /** Whether the tour is currently open (controlled). */
    open?: boolean;
    /** Whether the tour is initially open. @default false */
    defaultOpen?: boolean;
    /** Called when the tour opens or closes. `status` is set when closing. */
    onOpenChange?: (open: boolean, details: {
        status?: TourEndStatus;
    }) => void;
    /**
     * Active step index (controlled). Keep it within `0..steps.length - 1`: the
     * tour clamps out-of-range values internally for rendering but never writes
     * the clamped value back, so a controlled parent must not hold one out of
     * range (its `next`/`prev`/`go` operate on the clamped index).
     */
    stepIndex?: number;
    /** Initially active step when uncontrolled. @default 0 */
    defaultStepIndex?: number;
    /** Called when the active step changes. */
    onStepChange?: (index: number, step: TourStep) => void;
    /** Receives every tour lifecycle event. */
    onEvent?: (event: TourEvent) => void;
    /** A ref populated with the imperative tour controls. */
    actionsRef?: RefObject<TourActions | null>;
    /**
     * How long to wait for a step target to appear in the DOM before giving
     * up, in ms. @default 5000
     */
    targetTimeout?: number;
    /**
     * What to do when a step target cannot be found: skip to the next step or
     * stop the tour. Emits `error:target-not-found` either way.
     * @default 'skip'
     */
    targetNotFound?: 'skip' | 'stop';
    /**
     * How the popover card travels between steps. `fade` (default) cross-fades it
     * at each target; `move` glides it smoothly from one target to the next. The
     * spotlight always cross-fades regardless — it never slides. @default 'fade'
     */
    transition?: TourTransition;
    /**
     * Hide the dimmed overlay for the whole tour — only the popover is shown and
     * the page stays fully interactive. Steps can override with
     * `step.disableOverlay`. @default false
     */
    disableOverlay?: boolean;
    /**
     * Tour UI. Defaults to `<Tour.Overlay />` plus `<Tour.Content />` with the
     * standard card layout; compose the parts to customize.
     */
    children?: ReactNode;
}
export declare function TourRoot({ steps, open: openProp, defaultOpen, onOpenChange, stepIndex: stepIndexProp, defaultStepIndex, onStepChange, onEvent, actionsRef, targetTimeout, targetNotFound, transition, disableOverlay, children }: TourRootProps): import("react/jsx-runtime").JSX.Element;
export declare namespace TourRoot {
    var displayName: string;
}
//# sourceMappingURL=tour-root.d.ts.map