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。

8.9 KB
Raw Blame
// @vitest-environment jsdom
// (Editor 构造需要 DOM。)
import { Editor } from '@tiptap/core';
import Document from '@tiptap/extension-document';
import HardBreak from '@tiptap/extension-hard-break';
import Paragraph from '@tiptap/extension-paragraph';
import Text from '@tiptap/extension-text';
import { afterEach, describe, expect, it, vi } from 'vitest';

import {
  collapseBlankDocDomSelection,
  EmptyDocSelectionGuard,
  isBlankParagraphDoc,
  normalizeBlankDocSelection,
  type BlankDocSelectionView,
} from '@/components/new-chat/EmptyDocSelectionGuard';
import { ComposerBulletList, ComposerListItem } from '@/components/new-chat/ComposerListNodes';
import { MentionChipNode } from '@/components/new-chat/MentionChipNode';

// Editor 必须逐个 destroy:EditorView 的异步回调会在 jsdom 环境拆除后触发
// `document is not defined` 未处理异常,vitest 全绿也会 exit 1(CI 实撞)。
const editors: Editor[] = [];
afterEach(() => {
  for (const editor of editors.splice(0)) editor.destroy();
});

function makeEditor(options: { guard?: boolean } = {}): Editor {
  const { guard = true } = options;
  const editor = new Editor({
    extensions: [
      Document,
      Paragraph,
      Text,
      HardBreak,
      ComposerListItem,
      ComposerBulletList,
      MentionChipNode,
      ...(guard ? [EmptyDocSelectionGuard] : []),
    ],
    content: { type: 'doc', content: [{ type: 'paragraph', content: [] }] },
  });
  editors.push(editor);
  return editor;
}

describe('isBlankParagraphDoc', () => {
  it('只把单个空 paragraph 认作真空', () => {
    expect(isBlankParagraphDoc(makeEditor().state.doc)).toBe(true);
  });

  it('有文本时不是真空', () => {
    const editor = makeEditor();
    editor.commands.insertContent('draft');
    expect(isBlankParagraphDoc(editor.state.doc)).toBe(false);
  });

  // 多段落来自引用回填 / 历史草稿等程序化构造与多段粘贴;Shift/Alt+Enter 是
  // hardBreak(留在同一 paragraph 内),普通/修饰键 Enter 是否发送由快捷键 resolver 决定。
  it('多个空段落不是真空(多段结构本身是真实内容)', () => {
    const editor = makeEditor();
    editor.commands.setContent({
      type: 'doc',
      content: [{ type: 'paragraph' }, { type: 'paragraph' }],
    });
    expect(isBlankParagraphDoc(editor.state.doc)).toBe(false);
  });

  it('只含 atom chip 的草稿不是真空(chip 没有文本投影)', () => {
    const editor = makeEditor();
    editor.commands.insertContent({
      type: 'mentionChip',
      attrs: { kind: 'file', label: 'main.ts', path: 'src/main.ts' },
    });
    expect(editor.state.doc.textContent).toBe('');
    expect(isBlankParagraphDoc(editor.state.doc)).toBe(false);
  });

  it('空列表项不是真空', () => {
    const editor = makeEditor();
    editor.commands.setContent({
      type: 'doc',
      content: [
        { type: 'bulletList', content: [{ type: 'listItem', content: [{ type: 'paragraph' }] }] },
      ],
    });
    expect(isBlankParagraphDoc(editor.state.doc)).toBe(false);
  });
});

describe('normalizeBlankDocSelection', () => {
  it('真空文档的全选被折叠成光标', () => {
    const editor = makeEditor();
    editor.commands.selectAll();
    expect(editor.state.selection.empty).toBe(true);
    expect(editor.state.selection.from).toBe(1);
  });

  it('没有 guard 时全选会框住整个空段落(回归基线)', () => {
    // 这就是幽灵高亮的来源:AllSelection(0..2) 把空 paragraph 节点整体框进选区,
    // Chromium 于是在行首画出一块可见高亮。
    const editor = makeEditor({ guard: false });
    editor.commands.selectAll();
    expect(editor.state.selection.empty).toBe(false);
    expect(editor.state.selection.from).toBe(0);
    expect(editor.state.selection.to).toBe(2);
  });

  it('有内容时全选照旧生效', () => {
    const editor = makeEditor();
    editor.commands.insertContent('hello');
    editor.commands.selectAll();
    expect(editor.state.selection.empty).toBe(false);
  });

  it('多个空段落全选照旧生效', () => {
    const editor = makeEditor();
    editor.commands.setContent({
      type: 'doc',
      content: [{ type: 'paragraph' }, { type: 'paragraph' }],
    });
    editor.commands.selectAll();
    expect(editor.state.selection.empty).toBe(false);
  });

  it('全选后删空,状态层落在折叠光标上', () => {
    const editor = makeEditor();
    editor.commands.insertContent('123');
    editor.commands.selectAll();
    editor.commands.deleteSelection();
    expect(editor.state.doc.textContent).toBe('');
    expect(editor.state.selection.empty).toBe(true);
  });

  it('选区本就折叠时不产生多余 transaction', () => {
    const editor = makeEditor();
    expect(normalizeBlankDocSelection(editor.state)).toBeNull();
  });
});

describe('collapseBlankDocDomSelection', () => {
  interface FakeSelection {
    rangeCount: number;
    isCollapsed: boolean;
    anchorNode: Node | null;
    focusNode: Node | null;
    collapse: (node: Node, offset: number) => void;
  }

  function makeView(
    overrides: {
      composing?: boolean;
      docHasText?: boolean;
      selection?: Partial<FakeSelection> | null;
      anchorInside?: boolean;
      focusInside?: boolean;
    } = {},
  ): { view: BlankDocSelectionView; selection: FakeSelection } {
    const {
      composing = false,
      docHasText = false,
      anchorInside = true,
      focusInside = true,
    } = overrides;
    const editor = makeEditor();
    if (docHasText) editor.commands.insertContent('draft');
    const paragraph = { nodeName: 'P' } as unknown as Node;
    const anchor = { nodeName: '#text' } as unknown as Node;
    const focus = { nodeName: '#text' } as unknown as Node;
    const selection: FakeSelection = {
      rangeCount: 1,
      isCollapsed: false,
      anchorNode: anchor,
      focusNode: focus,
      collapse: vi.fn(),
      ...overrides.selection,
    };
    const inside = new Set<Node>([paragraph]);
    if (anchorInside) inside.add(anchor);
    if (focusInside) inside.add(focus);
    const dom = {
      ownerDocument: { getSelection: () => (overrides.selection === null ? null : selection) },
      contains: (node: Node) => inside.has(node),
      firstChild: paragraph,
    } as unknown as HTMLElement;
    return {
      view: { composing, dom, state: { doc: editor.state.doc } },
      selection,
    };
  }

  it('真空文档 + 跨节点 DOM 选区 → 折叠到段落起点', () => {
    const { view, selection } = makeView();
    expect(collapseBlankDocDomSelection(view)).toBe(true);
    expect(selection.collapse).toHaveBeenCalledWith(view.dom.firstChild, 0);
  });

  it('DOM 选区已折叠时不动作(收敛性:第二轮直接返回)', () => {
    const { view, selection } = makeView({ selection: { isCollapsed: true } });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
    expect(selection.collapse).not.toHaveBeenCalled();
  });

  it('文档非真空时不动作', () => {
    const { view, selection } = makeView({ docHasText: true });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
    expect(selection.collapse).not.toHaveBeenCalled();
  });

  it('IME 组字期间不介入', () => {
    const { view, selection } = makeView({ composing: true });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
    expect(selection.collapse).not.toHaveBeenCalled();
  });

  it('anchor 不在本 editor 内时不动作(反向拖选:从外部拖进空输入框)', () => {
    const { view, selection } = makeView({ anchorInside: false });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
    expect(selection.collapse).not.toHaveBeenCalled();
  });

  it('focus 不在本 editor 内时不动作(从空输入框内起手往外拖选)', () => {
    // 只校验 anchor 会把这种跨边界选区当成自己的并折叠掉,清掉用户合法的选择
    // (PR #896 review:copilot + greptile P2)。
    const { view, selection } = makeView({ focusInside: false });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
    expect(selection.collapse).not.toHaveBeenCalled();
  });

  it('两端都不在本 editor 内时不动作(同页多个 composer 互不干扰)', () => {
    const { view, selection } = makeView({ anchorInside: false, focusInside: false });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
    expect(selection.collapse).not.toHaveBeenCalled();
  });

  it('focusNode 缺失时安全返回', () => {
    const { view, selection } = makeView({ selection: { focusNode: null } });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
    expect(selection.collapse).not.toHaveBeenCalled();
  });

  it('没有 selection 对象时安全返回', () => {
    const { view } = makeView({ selection: null });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
  });

  it('rangeCount 为 0 时不动作', () => {
    const { view, selection } = makeView({ selection: { rangeCount: 0 } });
    expect(collapseBlankDocDomSelection(view)).toBe(false);
    expect(selection.collapse).not.toHaveBeenCalled();
  });
});