Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

2.2 KB
Raw Blame
import { useEffect, type RefObject } from 'react';

import { isEditableKeyboardTarget, shouldCardShortcutYield } from '@/lib/editableKeyboardTarget';

/**
 * 设置页的 Esc 逐层返回(全平台同一套)。按键只在无人认领时才由设置页处理:
 * 搜索框清空、快捷键录制、弹窗 / 菜单 / 插件详情等内层先消费,输入法组字中的
 * Esc 只取消候选。焦点在设置页的输入框里时,第一下只离开输入框(等同点到别处,
 * 失焦即保存的字段照常提交),再按一次才交给 onEscape。一次按下只退一层,按住
 * 不放产生的自动连发一律忽略。
 *
 * 挂在 window 冒泡阶段,晚于 document 与组件层的处理者;同在 window 上的内层
 * (帮助面板)由调用方通过 enabled 让路。
 */
export function useSettingsEscape(
  rootRef: RefObject<HTMLElement | null>,
  enabled: boolean,
  onEscape: () => void,
) {
  useEffect(() => {
    if (!enabled) return;
    const onKeyDown = (event: KeyboardEvent) => {
      // 按住 Esc 的自动连发不算新的一下:首个 keydown 关掉内层后,连发不能接着退出设置。
      if (
        event.key !== 'Escape' ||
        event.repeat ||
        event.keyCode === 229 ||
        event.altKey ||
        event.ctrlKey ||
        event.metaKey ||
        event.shiftKey
      ) {
        return;
      }
      const root = rootRef.current;
      const target = event.target;
      if (
        !event.defaultPrevented &&
        !event.isComposing &&
        isEditableKeyboardTarget(target) &&
        root?.contains(target)
      ) {
        event.preventDefault();
        target.blur();
        return;
      }
      if (shouldCardShortcutYield(event, 'dismiss', root)) return;
      // MorphPopover(模型选择器等)在 document capture 里关闭但不 preventDefault,
      // 面板会挂到收合动画结束;它在场时这一下 Esc 归它。
      if (document.querySelector('[data-morph-side]')) return;
      event.preventDefault();
      onEscape();
    };
    window.addEventListener('keydown', onKeyDown);
    return () => window.removeEventListener('keydown', onKeyDown);
  }, [enabled, onEscape, rootRef]);
}