Function initTerminal

src/server/web/terminal.ts:99–183

()

// ── Terminal initialisation ──────────────────────────────────────────────────

function initTerminal(): void {
  term = new Terminal({
    cursorBlink: true,
    cursorStyle: 'block',
    fontFamily:
      "'Cascadia Code', 'Fira Code', 'JetBrains Mono', 'SF Mono', Menlo, Monaco, 'Courier New', monospace",
    fontSize: 14,
    lineHeight: 1.2,
    theme: getTheme(),
    allowProposedApi: true,
    scrollback: 10_000,
    convertEol: true,
  })

  fitAddon = new FitAddon()
  term.loadAddon(fitAddon)
  term.loadAddon(new WebLinksAddon())

  searchAddon = new SearchAddon()
  term.loadAddon(searchAddon)

  const unicode11 = new Unicode11Addon()
  term.loadAddon(unicode11)
  term.unicode.activeVersion = '11'

  term.open(terminalContainer)

  // WebGL renderer with canvas fallback
  try {
    const webgl = new WebglAddon()
    webgl.onContextLoss(() => webgl.dispose())
    term.loadAddon(webgl)
  } catch {
    // Canvas renderer is already active — no action needed
  }

  fitAddon.fit()

  // Keep terminal fitted to container
  const resizeObserver = new ResizeObserver(() => fitAddon.fit())
  resizeObserver.observe(terminalContainer)

  // Propagate resize to server
  term.onResize(({ cols, rows }) => sendJSON({ type: 'resize', cols, rows }))

  // Forward all terminal input to PTY
  term.onData((data) => {
    if (ws?.readyState === WebSocket.OPEN) ws.send(data)
  })

  // Keyboard intercepts (return false = swallow; return true = pass through)
  term.attachCustomKeyEventHandler((ev) => {
    // Ctrl+Shift+F → in-terminal search
    if (ev.ctrlKey && ev.shiftKey && ev.key === 'F') {
      if (ev.type === 'keydown') {
        const query = window.prompt('Search terminal:')
        if (query) searchAddon.findNext(query, { caseSensitive: false, regex: false })
      }