fusion/packages/dashboard/app/hooks/useDashboardKeyboardShortcuts.ts

import { useEffect } from "react";
import {
  isEditableShortcutTarget,
  isTextEntryShortcutTarget,
  resolveDashboardKeyboardShortcuts,
  shortcutMatchesEvent,
  type DashboardKeyboardShortcutMap,
} from "../utils/keyboardShortcuts";

export interface DashboardKeyboardShortcutHandlers {
  /*
  FNXC:DashboardShortcuts 2026-07-16-00:00:
  FN-8069 requires every configurable dashboard shortcut to toggle its surface. App owns state and navigation history, so this listener only dispatches the toggle callbacks; a re-press closes modals or restores the view that was active before Settings or Command Center opened (Runfusion/Fusion#2118).
  */
  toggleQuickChat: () => void;
  toggleTerminal: () => void;
  closeTopmostPopup?: () => boolean;
  toggleFiles: () => void;
  toggleSettings: () => void;
  toggleCommandCenter: () => void;
  toggleNewTask: () => void;
}

export interface UseDashboardKeyboardShortcutsOptions extends DashboardKeyboardShortcutHandlers {
  shortcuts?: DashboardKeyboardShortcutMap | null;
  enabled?: boolean;
}

/*
FNXC:DashboardShortcuts 2026-07-04-00:00:
The global dashboard listener only handles document-level shortcuts after target/editable guards and default-prevented checks. This lets chat composers, task editors, Settings inputs, terminal fields, and nested widgets keep ownership of typed keys and Escape while the dashboard still opens high-value interfaces from page focus.
*/
export function useDashboardKeyboardShortcuts({
  shortcuts,
  enabled = true,
  toggleQuickChat,
  toggleTerminal,
  closeTopmostPopup,
  toggleFiles,
  toggleSettings,
  toggleCommandCenter,
  toggleNewTask,
}: UseDashboardKeyboardShortcutsOptions): void {
  useEffect(() => {
    if (!enabled || typeof document === "undefined") return;
    const resolved = resolveDashboardKeyboardShortcuts(shortcuts);

    const handleKeyDown = (event: KeyboardEvent) => {
      if (event.defaultPrevented) return;

      if (event.key === "Escape") {
        if (isTextEntryShortcutTarget(event.target)) return;
        if (closeTopmostPopup?.()) {
          event.preventDefault();
          event.stopPropagation();
          event.stopImmediatePropagation();
        }
        return;
      }

      if (isEditableShortcutTarget(event.target)) return;

      if (shortcutMatchesEvent(resolved.quickChat, event)) {
        event.preventDefault();
        toggleQuickChat();
        return;
      }

      if (shortcutMatchesEvent(resolved.terminal, event)) {
        event.preventDefault();
        toggleTerminal();
        return;
      }

      if (shortcutMatchesEvent(resolved.openFiles, event)) {
        event.preventDefault();
        toggleFiles();
        return;
      }

      if (shortcutMatchesEvent(resolved.openSettings, event)) {
        event.preventDefault();
        toggleSettings();
        return;
      }

      if (shortcutMatchesEvent(resolved.openCommandCenter, event)) {
        event.preventDefault();
        toggleCommandCenter();
        return;
      }

      if (shortcutMatchesEvent(resolved.newTask, event)) {
        event.preventDefault();
        toggleNewTask();
      }
    };

    document.addEventListener("keydown", handleKeyDown);
    return () => document.removeEventListener("keydown", handleKeyDown);
  }, [closeTopmostPopup, enabled, shortcuts, toggleCommandCenter, toggleFiles, toggleNewTask, toggleQuickChat, toggleSettings, toggleTerminal]);
}