Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

5.1 KB
Raw Blame
import { act, fireEvent, render, screen } from '@testing-library/react';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';

import Tooltip from './Tooltip';

describe('Tooltip', () => {
  beforeEach(() => {
    vi.useFakeTimers();
  });

  afterEach(() => {
    vi.runOnlyPendingTimers();
    vi.useRealTimers();
  });

  it('does not show the pill until the trigger is hovered past the delay', () => {
    render(
      <Tooltip label="Wallet" delayMs={300}>
        <button type="button" aria-label="Wallet">
          icon
        </button>
      </Tooltip>
    );
    expect(screen.queryByTestId('tooltip')).toBeNull();

    fireEvent.mouseEnter(screen.getByRole('button', { name: 'Wallet' }));
    // Before the dwell elapses, nothing is shown.
    act(() => {
      vi.advanceTimersByTime(200);
    });
    expect(screen.queryByTestId('tooltip')).toBeNull();

    act(() => {
      vi.advanceTimersByTime(100);
    });
    expect(screen.getByTestId('tooltip')).toHaveTextContent('Wallet');
  });

  it('hides the pill on mouse leave and cancels a pending show', () => {
    render(
      <Tooltip label="Settings">
        <button type="button" aria-label="Settings">
          icon
        </button>
      </Tooltip>
    );
    const btn = screen.getByRole('button', { name: 'Settings' });

    fireEvent.mouseEnter(btn);
    fireEvent.mouseLeave(btn);
    act(() => {
      vi.advanceTimersByTime(500);
    });
    // Leaving before the delay cancels the show entirely.
    expect(screen.queryByTestId('tooltip')).toBeNull();
  });

  it('shows on keyboard focus and hides on blur-sm', () => {
    render(
      <Tooltip label="Home" delayMs={0}>
        <button type="button" aria-label="Home">
          icon
        </button>
      </Tooltip>
    );
    const btn = screen.getByRole('button', { name: 'Home' });

    fireEvent.focus(btn);
    act(() => {
      vi.advanceTimersByTime(0);
    });
    expect(screen.getByTestId('tooltip')).toHaveTextContent('Home');

    fireEvent.blur(btn);
    expect(screen.queryByTestId('tooltip')).toBeNull();
  });

  it('preserves the trigger’s own handlers', () => {
    const onMouseEnter = vi.fn();
    const onClick = vi.fn();
    render(
      <Tooltip label="Chat" delayMs={0}>
        <button type="button" aria-label="Chat" onMouseEnter={onMouseEnter} onClick={onClick}>
          icon
        </button>
      </Tooltip>
    );
    const btn = screen.getByRole('button', { name: 'Chat' });

    fireEvent.mouseEnter(btn);
    fireEvent.click(btn);
    expect(onMouseEnter).toHaveBeenCalledTimes(1);
    expect(onClick).toHaveBeenCalledTimes(1);
  });

  it('marks the pill aria-hidden so screen readers use the trigger label', () => {
    render(
      <Tooltip label="Connections" delayMs={0}>
        <button type="button" aria-label="Connections">
          icon
        </button>
      </Tooltip>
    );
    fireEvent.mouseEnter(screen.getByRole('button', { name: 'Connections' }));
    act(() => {
      vi.advanceTimersByTime(0);
    });
    expect(screen.getByTestId('tooltip')).toHaveAttribute('aria-hidden', 'true');
  });

  it.each([
    ['right', 'translateY(-50%)'],
    ['left', 'translate(-100%, -50%)'],
    ['top', 'translate(-50%, -100%)'],
    ['bottom', 'translate(-50%, 0)'],
  ] as const)('positions the pill against the %s edge', (side, transform) => {
    render(
      <Tooltip label="Brain" side={side} delayMs={0}>
        <button type="button" aria-label="Brain">
          icon
        </button>
      </Tooltip>
    );
    fireEvent.mouseEnter(screen.getByRole('button', { name: 'Brain' }));
    act(() => {
      vi.advanceTimersByTime(0);
    });
    expect(screen.getByTestId('tooltip')).toHaveStyle({ transform });
  });

  it('renders an invalid (non-element) child as-is without a pill', () => {
    render(<Tooltip label="Noop">{'just text' as never}</Tooltip>);
    expect(screen.getByText('just text')).toBeInTheDocument();
    expect(screen.queryByTestId('tooltip')).toBeNull();
  });

  it('applies a native title fallback on the trigger (CEF-occlusion safety net)', () => {
    render(
      <Tooltip label="Wallet" delayMs={0}>
        <button type="button" aria-label="Wallet">
          icon
        </button>
      </Tooltip>
    );
    expect(screen.getByRole('button', { name: 'Wallet' })).toHaveAttribute('title', 'Wallet');
  });

  it('respects a trigger-supplied title over the label fallback', () => {
    render(
      <Tooltip label="Wallet" delayMs={0}>
        <button type="button" aria-label="Wallet" title="Custom">
          icon
        </button>
      </Tooltip>
    );
    expect(screen.getByRole('button', { name: 'Wallet' })).toHaveAttribute('title', 'Custom');
  });

  it('clears a pending show when the trigger unmounts mid-hover', () => {
    const { unmount } = render(
      <Tooltip label="Human" delayMs={300}>
        <button type="button" aria-label="Human">
          icon
        </button>
      </Tooltip>
    );
    fireEvent.mouseEnter(screen.getByRole('button', { name: 'Human' }));
    unmount();
    // The timer must not fire setState on the unmounted component.
    act(() => {
      vi.advanceTimersByTime(500);
    });
    expect(screen.queryByTestId('tooltip')).toBeNull();
  });
});