@types/atom/src/tooltip-manager.d.ts

import { Disposable, Tooltip } from '../index';

export type TooltipPlacement =
    | 'top'
    | 'bottom'
    | 'left'
    | 'right'
    | 'auto'
    | 'auto top'
    | 'auto bottom'
    | 'auto left'
    | 'auto right';

/** Associates tooltips with HTML elements or selectors. */
export interface TooltipManager {
    /** Add a tooltip to the given element. */
    add(
        target: HTMLElement | JQueryCompatible,
        options:
            | {
                  item?: object | undefined;
              }
            | ({
                  title?: string | (() => string) | undefined;
                  html?: boolean | undefined;
                  keyBindingCommand?: string | undefined;
                  keyBindingTarget?: HTMLElement | undefined;
              } & {
                  class?: string | undefined;
                  placement?: TooltipPlacement | (() => TooltipPlacement) | undefined;
                  trigger?: 'click' | 'hover' | 'focus' | 'manual' | undefined;
                  delay?: { show: number; hide: number } | undefined;
              }),
    ): Disposable;

    /** Find the tooltips that have been applied to the given element. */
    findTooltips(target: HTMLElement): Tooltip[];
}

export interface JQueryCompatible<Element extends Node = HTMLElement> extends Iterable<Element> {
    jquery: string;
}