Function handler

packages/app-core/src/components/VimNav.tsx:297–1014

(e: KeyboardEvent)

  useEffect(() => {
    if (!vimMode) return
    const handler = (e: KeyboardEvent): void => {
      const state = useStore.getState()
      const overrides = state.keymapOverrides
      const leaderToken = getSequenceTokens(overrides, 'vim.leaderPrefix')[0] ?? 'Space'
      const panePrefixToken = getSequenceTokens(overrides, 'vim.panePrefix')[0] ?? 'Ctrl+W'

      // Skip when modals / overlays are open
      if (
        state.searchOpen ||
        state.vaultTextSearchOpen ||
        state.settingsOpen ||
        state.commandPaletteOpen ||
        state.bufferPaletteOpen
      ) return
      if (
        document.querySelector('[data-ctx-menu]') ||
        document.querySelector('[data-prompt-modal]') ||
        document.querySelector('[data-confirm-modal]')
      ) return

      // Hint mode — handled entirely by HintOverlay's own listener
      if (hintRef.current) return

      // `e.target` is only an HTMLElement for real DOM-dispatched events.
      // Synthetic events fired at `window`/`document` (e.g. programmatic
      // shortcuts) have a non-Element target, so narrow with `instanceof`
      // before touching Element-only methods like `.closest()`.
      const target = e.target instanceof HTMLElement ? e.target : null
      const tag = target?.tagName
      // Never steal keys from normal text-entry fields such as the
      // inline note title, prompt inputs, or textarea-based controls.
      if (tag === 'INPUT' || tag === 'TEXTAREA') return
      // The selection format toolbar handles its own keyboard navigation
      // (arrows / Enter / Esc) once focused — yield to it entirely.
      if (target?.closest('[data-selection-toolbar]')) return
      // The home view owns its own roving-focus navigation (↑/↓/j/k/Enter), but
      // it does not handle the leader key — so the leader (and any pending leader
      // sequence) must fall through to VimNav, or Space-as-leader is swallowed
      // while the home view is focused (no note open). (#273)
      if (
        shouldYieldToHomeNav(
          target,
          sequenceTokenFromEvent(e) === leaderToken,
          !!leaderPending.current
        )
      ) {
        return
      }
      // The database/table view runs its own vim-style motion grid; yield to it
      // so sidebar/note-list navigation doesn't steal j/k/h/l etc. — EXCEPT the
      // pane prefix (Ctrl+W) and its pending direction key, so the grid can hand
      // off to pane/tab navigation (Ctrl+W k → tabs) like every other surface.
      if (
        target?.closest('[data-zen-db-grid]') &&
        !ctrlWPending.current &&
        sequenceTokenFromEvent(e) !== panePrefixToken
      ) {
        return