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。

7.1 KB
Raw Blame
import type { EditorView } from '@tiptap/pm/view';
import type { ResolvedPos } from '@tiptap/pm/model';

/**
 * Composer 纯文本 Markdown 列表的兼容接续。结构化 bullet / ordered list
 * 由编辑器 schema 处理;本模块继续覆盖粘贴或旧草稿中的文本前缀,以及尚未
 * 结构化的待办和引用前缀。调用方根据发送偏好,将用于换行的 Enter
 * (包括 Shift/Alt+Enter)交给本模块接续或退出当前项。
 */

export type ListContinuation =
  | { action: 'continue'; insert: string }
  | { action: 'exit' };

export interface ListPrefixMatch {
  /** 前缀(含缩进与其后空白)在行内占据的长度。 */
  prefixLength: number;
  /** 换行后应插入的下一个前缀(缩进 / 分隔符 / 空白与当前行保持一致)。 */
  nextPrefix: string;
}

// 顺序敏感:checkbox 必须先于 bullet 匹配(`- [ ] ` 也满足 bullet 的模式)。
// checkbox 允许行在 `]` 处截止(`(\s+|$)`),这样 "- [ ]" 也能识别成空项退出。
const CHECKBOX_RE = /^(\s*)([-+*])(\s+)\[[ xX]\](\s+|$)/;
const BULLET_RE = /^(\s*)([-+*•])(\s+)/;
const ORDERED_RE = /^(\s*)(\d{1,9})([.)])(\s+)/;
// 中文顿号序号(`1、`)不要求后随空格,符合中文输入习惯。
const ORDERED_CJK_RE = /^(\s*)(\d{1,9})(、)(\s*)/;
const QUOTE_RE = /^(\s*)(>)(\s+)/;

/**
 * 匹配行首的列表 / 待办 / 引用前缀。除列表接续外,也被 composer 的列表行
 * 缩进 decoration(ComposerListIndentDecoration)复用来判断"这行是列表项"。
 */
export function matchListPrefix(line: string): ListPrefixMatch | null {
  let m = line.match(CHECKBOX_RE);
  if (m) {
    // 新项永远是未勾选态;`]` 后无空白(行尾截止)时补一个空格。
    return {
      prefixLength: m[0].length,
      nextPrefix: `${m[1]}${m[2]}${m[3]}[ ]${m[4] || ' '}`,
    };
  }
  m = line.match(BULLET_RE);
  if (m) return { prefixLength: m[0].length, nextPrefix: m[0] };
  m = line.match(ORDERED_RE);
  if (m) {
    return {
      prefixLength: m[0].length,
      nextPrefix: `${m[1]}${Number(m[2]) + 1}${m[3]}${m[4]}`,
    };
  }
  m = line.match(ORDERED_CJK_RE);
  if (m) {
    return {
      prefixLength: m[0].length,
      nextPrefix: `${m[1]}${Number(m[2]) + 1}${m[3]}${m[4]}`,
    };
  }
  m = line.match(QUOTE_RE);
  if (m) return { prefixLength: m[0].length, nextPrefix: m[0] };
  return null;
}

/**
 * 根据"光标前的当前行文本"决定换行行为:
 * - `null`      → 不是列表行,走默认换行。
 * - `continue`  → 插入换行 + `insert` 前缀。
 * - `exit`      → 当前项为空,调用方应删除光标前的整段行文本(即前缀)退出列表。
 *
 * 行文本中的原子节点(mention chip 等)由调用方以 U+FFFC 占位表示——行首是
 * chip 时天然匹配不上任何前缀,无需特判。
 */
export function computeListContinuation(
  lineBeforeCaret: string,
  lineAfterCaret = '',
): ListContinuation | null {
  const match = matchListPrefix(lineBeforeCaret);
  if (!match) return null;
  const rest = lineBeforeCaret.slice(match.prefixLength);
  // 空项判定看**整行**(光标前 rest + 光标后正文):否则 `1. |todo`(光标在标记后、
  // 正文前)会被当成空项退出、删掉标记留下裸 "todo"。光标后仍有正文时
  // 走 continue —— 在光标处插换行 + 下一前缀,把 "todo" 顺成下一项(拆分列表)。
  if (rest.trim().length === 0 && lineAfterCaret.trim().length === 0) return { action: 'exit' };
  return { action: 'continue', insert: match.nextPrefix };
}

/**
 * 提取光标所在"行"里、光标之前的文本与行起点(段落内以 hardBreak 划分行)。
 * 原子节点(mention chip 等)以 U+FFFC 占位——行首是 chip 时天然匹配不上
 * 任何前缀,无需特判。lineStartOffset 是相对段落内容起点的 offset。
 */
function scanCaretLine($from: ResolvedPos): {
  lineText: string;
  lineStartOffset: number;
  lineAfter: string;
} {
  let lineText = '';
  let lineStartOffset = 0;
  $from.parent.nodesBetween(0, $from.parentOffset, (node, pos) => {
    if (node.type.name === 'hardBreak') {
      lineText = '';
      lineStartOffset = pos + node.nodeSize;
    } else if (node.isText) {
      lineText += (node.text ?? '').slice(0, $from.parentOffset - pos);
    } else {
      lineText += '\uFFFC';
    }
    return false;
  });
  // \u5149\u6807\u540E\u3001\u5230\u672C\u884C\u672B(\u4E0B\u4E00\u4E2A hardBreak \u6216\u6BB5\u843D\u672B)\u4E4B\u95F4\u7684\u6587\u672C \u2014\u2014 \u4F9B\u7A7A\u9879\u5224\u5B9A\u770B\u6574\u884C\u3002
  let lineAfter = '';
  let stopped = false;
  $from.parent.nodesBetween($from.parentOffset, $from.parent.content.size, (node, pos) => {
    if (stopped) return false;
    if (node.type.name === 'hardBreak') {
      stopped = true;
      return false;
    }
    if (node.isText) {
      lineAfter += (node.text ?? '').slice(Math.max(0, $from.parentOffset - pos));
    } else {
      lineAfter += '\uFFFC';
    }
    return false;
  });
  return { lineText, lineStartOffset, lineAfter };
}

/**
 * 在 ProseMirror view 上执行列表接续。返回 true 表示已处理(调用方应消费
 * 该按键),false 表示当前行不是列表项(调用方走原有行为:换行或发送)。
 */
export function applyListContinuation(view: EditorView): boolean {
  const { state } = view;
  if (!state.selection.empty) return false;
  const $from = state.selection.$from;
  if (!$from.parent.isTextblock) return false;

  const { lineText, lineStartOffset, lineAfter } = scanCaretLine($from);
  const continuation = computeListContinuation(lineText, lineAfter);
  if (!continuation) return false;

  if (continuation.action === 'exit') {
    // 空项:删除光标前的整段前缀(含缩进),退出列表。
    const lineStartAbs = $from.start() + lineStartOffset;
    view.dispatch(state.tr.delete(lineStartAbs, $from.pos).scrollIntoView());
    return true;
  }

  const hardBreak = state.schema.nodes.hardBreak;
  if (!hardBreak) return false;
  const tr = state.tr.replaceSelectionWith(hardBreak.create(), false);
  tr.insertText(continuation.insert);
  view.dispatch(tr.scrollIntoView());
  return true;
}

/**
 * 空列表项退出:当前行只剩前缀(如 "2. ")且光标在行尾时,一次 Backspace
 * 只删掉前缀(含缩进)、保留本行换行,与结构化列表的空项退出一致;再按一次
 * Backspace 才走默认退格回到上一行。其余情况返回 false,调用方走默认退格。
 */
export function applyListBackspace(view: EditorView): boolean {
  const { state } = view;
  if (!state.selection.empty) return false;
  const $from = state.selection.$from;
  if (!$from.parent.isTextblock) return false;

  // 光标必须在行尾:后面要么是段落末尾,要么紧跟 hardBreak。
  const after = $from.nodeAfter;
  if (after && after.type.name !== 'hardBreak') return false;

  const { lineText, lineStartOffset } = scanCaretLine($from);
  const match = matchListPrefix(lineText);
  if (!match) return false;
  // 前缀后还有内容 → 正常退格(一个字符一个字符删)。
  if (lineText.slice(match.prefixLength).trim().length > 0) return false;

  const lineStartAbs = $from.start() + lineStartOffset;
  view.dispatch(state.tr.delete(lineStartAbs, $from.pos).scrollIntoView());
  return true;
}