Skip to content

The agent that grows with you

2.6 KB
Raw Blame
import { describe, expect, it, vi } from 'vitest'

import { suppressNonKeyboardFocusOpen } from './tooltip'

// Radix opens tooltips on ANY trigger focus; menus/dialogs restore focus to
// their trigger on close, which left tips stuck open after a mouse pick (e.g.
// the composer model pill). The trigger's focus handler must preventDefault —
// which Radix's composed handler honors — for non-keyboard focus only.
//
// The regression these guard: `:focus-visible` on its own says "true" for a
// mouse pick out of a Radix menu, because the menu's autofocus/arrow-key
// navigation puts Chromium in keyboard modality before focus returns to the
// trigger. Only the last real input device separates the two cases.

const focusEvent = (matchesImpl: (selector: string) => boolean) => {
  const preventDefault = vi.fn()

  return {
    event: {
      currentTarget: { matches: matchesImpl } as unknown as HTMLElement,
      preventDefault
    } as unknown as React.FocusEvent<HTMLElement>,
    preventDefault
  }
}

const focusVisible = (selector: string) => selector === ':focus-visible'
const notFocusVisible = (selector: string) => selector !== ':focus-visible'

describe('suppressNonKeyboardFocusOpen', () => {
  it('suppresses the focus-open when a mouse pick restores focus to the trigger', () => {
    // The menu leaves Chromium in keyboard modality, so :focus-visible matches
    // even though the user clicked — this is the model-pill bug.
    const { event, preventDefault } = focusEvent(focusVisible)

    suppressNonKeyboardFocusOpen(event, 'pointer')

    expect(preventDefault).toHaveBeenCalledOnce()
  })

  it('keeps the focus-open for keyboard (Tab) focus — a11y path', () => {
    const { event, preventDefault } = focusEvent(focusVisible)

    suppressNonKeyboardFocusOpen(event, 'keyboard')

    expect(preventDefault).not.toHaveBeenCalled()
  })

  it('still suppresses a programmatic focus that is not focus-visible in keyboard modality', () => {
    const { event, preventDefault } = focusEvent(notFocusVisible)

    suppressNonKeyboardFocusOpen(event, 'keyboard')

    expect(preventDefault).toHaveBeenCalledOnce()
  })

  it('falls back to the modality when :focus-visible is unsupported', () => {
    const unsupported = () => {
      throw new Error('unsupported selector')
    }

    const keyboard = focusEvent(unsupported)

    suppressNonKeyboardFocusOpen(keyboard.event, 'keyboard')

    expect(keyboard.preventDefault).not.toHaveBeenCalled()

    const pointer = focusEvent(unsupported)

    suppressNonKeyboardFocusOpen(pointer.event, 'pointer')

    expect(pointer.preventDefault).toHaveBeenCalledOnce()
  })
})