/**
 * Tooltip — headless primitive wrapping Radix Tooltip.
 *
 * Radix's Tooltip owns the hard parts: hover + focus triggers with
 * configurable delay, `aria-describedby` wiring, keyboard reachability,
 * pointer-vs-touch heuristics (ARCHITECTURE §6). We wrap thinly:
 *   - `Tooltip.Provider` surfaces the default delay contract
 *   - Permission gating on <Root> (canView=false → primitive returns null)
 *   - `data-oshon-primitive="tooltip-*"` styling hooks
 *
 * Deliberately no audit events. Tooltips open/close on every hover and
 * an audit stream would be noise, not signal — principle #3 ("RBAC +
 * audit by default") covers actions, not purely informational surfaces.
 * See `docs/adr/primitives/003-tooltip-radix-wrap.md`.
 */
import * as RadixTooltip from '@radix-ui/react-tooltip';
import type { ComponentPropsWithoutRef, ReactNode } from 'react';
import { type PermissionContext } from '../context.js';
export type TooltipProviderProps = ComponentPropsWithoutRef<typeof RadixTooltip.Provider>;
/**
 * Configures default delay + skip-delay behavior for every descendant
 * Tooltip. Mount once near the app root.
 */
declare function Provider(props: TooltipProviderProps): import("react/jsx-runtime").JSX.Element;
declare namespace Provider {
    var displayName: string;
}
export interface TooltipRootProps extends RadixTooltip.TooltipProps {
    /**
     * Per-instance permission override. Merges over the ambient
     * `PermissionContext`. A tooltip has no useful non-interactive visible
     * state, so any denied permission (regardless of `mode`) hides both
     * trigger and content and emits a `permission:denied` audit event.
     */
    permissions?: Partial<PermissionContext>;
    /**
     * Resource name passed to `permissions.can('view', resource, attrs)`.
     * Default `'tooltip'`. Override for specific semantics like
     * `resource="field:ssn-help"`.
     */
    resource?: string;
    /** Attribute bag for attribute-based access control. */
    permissionAttrs?: Record<string, unknown>;
    children: ReactNode;
}
declare function Root({ children, permissions, resource, permissionAttrs, ...rest }: TooltipRootProps): import("react/jsx-runtime").JSX.Element | null;
declare namespace Root {
    var displayName: string;
}
export type TooltipTriggerProps = ComponentPropsWithoutRef<typeof RadixTooltip.Trigger>;
export type TooltipPortalProps = RadixTooltip.TooltipPortalProps;
declare function Portal(props: TooltipPortalProps): import("react/jsx-runtime").JSX.Element;
declare namespace Portal {
    var displayName: string;
}
export type TooltipContentProps = ComponentPropsWithoutRef<typeof RadixTooltip.Content>;
export type TooltipArrowProps = ComponentPropsWithoutRef<typeof RadixTooltip.Arrow>;
/**
 * Compound Tooltip primitive. Use as:
 *
 *   <Tooltip.Provider>
 *     <Tooltip.Root>
 *       <Tooltip.Trigger asChild>
 *         <button>Help</button>
 *       </Tooltip.Trigger>
 *       <Tooltip.Portal>
 *         <Tooltip.Content>Inline documentation.</Tooltip.Content>
 *       </Tooltip.Portal>
 *     </Tooltip.Root>
 *   </Tooltip.Provider>
 */
export declare const Tooltip: {
    Provider: typeof Provider;
    Root: typeof Root;
    Trigger: import("react").ForwardRefExoticComponent<Omit<RadixTooltip.TooltipTriggerProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
    Portal: typeof Portal;
    Content: import("react").ForwardRefExoticComponent<Omit<RadixTooltip.TooltipContentProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
    Arrow: import("react").ForwardRefExoticComponent<Omit<RadixTooltip.TooltipArrowProps & import("react").RefAttributes<SVGSVGElement>, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
};
export type TooltipProps = TooltipRootProps;
export {};
//# sourceMappingURL=tooltip.d.ts.map