Skip to content

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.

4.6 KB
Raw Blame
// @vitest-environment jsdom
import { afterEach, beforeEach, describe, expect, it } from 'vitest'
import { readFileSync } from 'node:fs'
import { join } from 'node:path'
import { createRoot, type Root } from 'react-dom/client'
import { act } from 'react'
import { ChatLoadingStatus, ChatPanelFallback } from './ChatPanelFallback'
;(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true

let host: HTMLDivElement
let root: Root
beforeEach(() => {
  host = document.createElement('div')
  document.body.appendChild(host)
  root = createRoot(host)
})
afterEach(() => {
  act(() => root.unmount())
  host.remove()
})

describe('ChatPanelFallback', () => {
  it('is the panel shell — same container classes, so it covers the terminal exactly as the panel will', () => {
    act(() => root.render(<ChatPanelFallback hint="⌘M to exit" />))
    const shell = host.firstElementChild as HTMLElement
    expect(shell.classList.contains('term-chat')).toBe(true)
    expect(shell.classList.contains('nodrag')).toBe(true)
    expect(shell.classList.contains('nowheel')).toBe(true)
    expect(shell.querySelector(':scope > .term-chat__bar')?.textContent).toContain('Chat')
    expect(shell.querySelector('.term-chat__hint')?.textContent).toBe('⌘M to exit')
    expect(shell.querySelector(':scope > .term-chat__msgs')).toBeTruthy()
  })

  it('shows the caller\'s own title and hint (the closed-transcript dialog: its title, "Esc to close")', () => {
    act(() => root.render(<ChatPanelFallback title="Closed session" hint="Esc to close" />))
    const bar = host.querySelector('.term-chat__bar') as HTMLElement
    expect(bar.firstElementChild?.textContent).toBe('Closed session')
    expect(bar.querySelector('.term-chat__hint')?.textContent).toBe('Esc to close')
  })

  it('says it is loading, with a spinner, inside a polite status region', () => {
    act(() => root.render(<ChatPanelFallback />))
    const status = host.querySelector('[role="status"]') as HTMLElement
    expect(status).toBeTruthy()
    expect(status.getAttribute('aria-live')).toBe('polite')
    expect(status.textContent).toBe('Loading conversation…')
    expect(status.querySelector('.nt-spinner')).toBeTruthy()
  })
})

// The fallback hands over to ChatPanel's own initial "Loading conversation…" row. Two different
// rows there swapped one spinner ring for another mid-load and REMOUNTED the role=status region,
// which a screen reader announces twice. Both now render ChatLoadingStatus — identical DOM.
describe('ChatLoadingStatus', () => {
  it('is the fallback\'s status row, verbatim', () => {
    act(() => root.render(<ChatPanelFallback />))
    const fromFallback = host.querySelector('.term-chat__msgs')!.innerHTML
    act(() => root.render(<ChatLoadingStatus text="Loading conversation…" />))
    expect(host.innerHTML).toBe(fromFallback)
    expect(host.innerHTML).toBe(
      '<div class="term-chat__status" role="status" aria-live="polite"><span class="nt-spinner" aria-hidden="true"></span>Loading conversation…</div>'
    )
  })
})

// styles.css carries ONE ring spinner for the chat surfaces: `.nt-spinner` (frozen under reduced
// motion). Lane B's local `.term-chat__spinner` kept rotating under reduced motion.
describe('styles.css spinner', () => {
  const css = readFileSync(join(__dirname, '../styles.css'), 'utf8').replace(/\r\n/g, '\n')
  it('has exactly one spinner @keyframes, and no chat-local spinner', () => {
    expect(css.match(/@keyframes [\w-]*spinner[\w-]*/g)).toEqual(['@keyframes nt-spinner-rotate'])
    expect(css).not.toMatch(/term-chat-spin|\.term-chat__spinner|\.term-chat__loading|\.term-chat__fallback-status/)
    expect(css).toContain('.term-chat__status {')
  })
})

// Every mount site of the lazy ChatPanel (canvas node, kanban card modal, closed-transcript dialog)
// must show the shell while the chunk loads; `fallback={null}` is what left the ⌘M face blank.
describe.each([
  ['TerminalNode.tsx', join(__dirname, 'TerminalNode.tsx')],
  ['CardModal.tsx', join(__dirname, '../components/kanban/CardModal.tsx')],
  ['ClosedTranscriptDialog.tsx', join(__dirname, '../components/ClosedTranscriptDialog.tsx')]
])('%s lazy ChatPanel', (_name, file) => {
  const src = readFileSync(file, 'utf8').replace(/\r\n/g, '\n')
  it('suspends into ChatPanelFallback, never into nothing', () => {
    const at = src.indexOf('<ChatPanel\n')
    expect(at).toBeGreaterThan(0)
    const opener = src.lastIndexOf('<Suspense', at)
    expect(opener).toBeGreaterThan(0)
    const wrapper = src.slice(opener, at)
    expect(wrapper).toContain('fallback={<ChatPanelFallback')
    expect(wrapper).not.toContain('fallback={null}')
  })
})