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。

3.3 KB
Raw Blame
/**
 * 键盘快捷键的「让位」判据:焦点落在可编辑控件里时,全局快捷键不该抢走按键。
 *
 * 独立成模块而不是各处自己写一份:MessageStream(历史导航键)与
 * ShareSelectionBar(⌘A / Esc)共用同一判据,同一语义只留一个实现;也让
 * 依赖它的小组件不必为了一个工具函数 import 整个 MessageStream。
 */
export function isEditableKeyboardTarget(target: EventTarget | null): target is HTMLElement {
  if (!(target instanceof HTMLElement)) return false;
  const tagName = target.tagName;
  return (
    tagName === 'INPUT' ||
    tagName === 'TEXTAREA' ||
    tagName === 'SELECT' ||
    target.isContentEditable
  );
}

/** 自带键盘语义的控件:焦点在这里时,回车 / 空格由它自己激活。 */
const INTERACTIVE_SELECTOR = [
  'button',
  'a[href]',
  'select',
  'summary',
  '[role="button"]',
  '[role="link"]',
  '[role^="menuitem"]',
  '[role="option"]',
  '[role="tab"]',
  '[role="radio"]',
  '[role="checkbox"]',
  '[role="switch"]',
  '[role="combobox"]',
  '[role="slider"]',
  '[role="spinbutton"]',
  '[role="treeitem"]',
].join(',');

/** 自己处理 Esc / 方向键的浮层:菜单、下拉列表、弹层与对话框。 */
const LAYER_SELECTOR = [
  '[role="menu"]',
  '[role="listbox"]',
  '[role="dialog"]',
  '[role="alertdialog"]',
  '[data-radix-popper-content-wrapper]',
].join(',');

/**
 * 焦点是否落在「别处的控件」上:可编辑控件、按钮 / 链接等自带键盘语义的控件,
 * 或菜单 / 弹层 / 对话框。调用方已确认焦点不在自己的卡片里时,用它判断按键是否属于那里。
 */
export function isForeignKeyboardControl(target: Element): boolean {
  return isEditableKeyboardTarget(target) || target.closest(INTERACTIVE_SELECTOR) !== null
    || target.closest(LAYER_SELECTOR) !== null;
}

/**
 * 替代输入框的交互卡片(授权、计划审批、提问)在 window 上挂了回车 / Esc / 数字键
 * 快捷键。这些按键同时可能属于别处:焦点所在的按钮、刚被关闭的菜单、正在打字的
 * 输入框。快捷键只在按键确实「无人认领」时才替用户做决定,否则让位。
 *
 * - 已被别处处理(defaultPrevented)或处于输入法组字中:让位。
 * - 焦点在可编辑控件、或卡片外的菜单 / 弹层 / 对话框里:让位。
 * - 焦点在卡片外的按钮、链接等控件上:让位,按键属于那个控件所在的界面。
 * - 焦点在卡片自己的控件上:普通回车 / 空格让给控件原生激活(在「拒绝」上按回车就是拒绝);
 *   Esc 与数字键没有原生含义,仍按卡片快捷键处理。带修饰键的卡片快捷键也保留自己的语义。
 */
export function shouldCardShortcutYield(
  event: KeyboardEvent,
  kind: 'activate' | 'modifiedActivate' | 'dismiss' | 'character',
  owner: Element | null,
): boolean {
  if (event.defaultPrevented || event.isComposing) return true;
  const target = event.target;
  if (isEditableKeyboardTarget(target)) return true;
  if (!(target instanceof Element)) return false;
  const insideOwner = owner?.contains(target) ?? false;
  if (!insideOwner && target.closest(LAYER_SELECTOR)) return true;
  if (!target.closest(INTERACTIVE_SELECTOR)) return false;
  return !insideOwner || kind === 'activate';
}