Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
// @vitest-environment jsdom
/**
* markdown 表格内的文件内搜索高亮。
*
* 背景:markdown 表格在 live preview 里是 `Decoration.replace({block: true,
* widget})` —— widget 覆盖区间内的文本不再由 CodeMirror 渲染,落在同一区间
* 的 `cm-doc-search-match` mark 装饰无处可显示。这些用例锁住"命中计数 =
* 可见高亮"这条口径:单元格文字由 widget 补高亮,表格结构字符与图片 alt
* 从命中里剔除。
*/
import { describe, expect, it } from 'vitest';
import { EditorState, type Text as CodeMirrorText } from '@codemirror/state';
import { EditorView, type DecorationSet, type WidgetType } from '@codemirror/view';
import { SearchCursor } from '@codemirror/search';
import {
collectMarkdownTableBlocks,
collectMarkdownTableHiddenRanges,
markdownTableDecorationField,
} from '@/components/markdown/markdownTableLivePreview';
import {
collectDocSearchHiddenRanges,
searchHighlightField,
} from '@/components/markdown/PlaintextEditor';
import {
docSearchIndexOfLine,
docSearchRangesField,
filterVisibleDocSearchRanges,
setDocSearchRangesEffect,
type DocSearchRange,
} from '@/components/markdown/docSearchRanges';
const DOC = [
'alpha outside table',
'',
'| Name | Status |',
'| --- | --- |',
'| alpha | ready |',
'| beta | blocked |',
].join('\n');
const DOC_WITH_MERMAID = [
'intro alpha',
'',
'```mermaid',
'graph TD',
' A[alpha] --> B[结束]',
'```',
'',
'tail alpha',
].join('\n');
const DOC_WITH_MARKUP = [
'# alpha heading',
'',
'- alpha bullet',
'',
'plain **alpha** text with `alpha` code',
'',
'> alpha quote',
].join('\n');
/** TableWidget 是模块私有的,测试按结构取它暴露的两个成员。 */
interface TableWidgetLike extends WidgetType {
highlights: DocSearchRange[];
updateDOM: (dom: HTMLElement, view: EditorView, from: WidgetType) => boolean;
}
function docOf(doc = DOC): CodeMirrorText {
return EditorState.create({ doc }).doc;
}
function findMatches(query: string, doc: CodeMirrorText): DocSearchRange[] {
const cursor = new SearchCursor(doc, query, 0, doc.length, (s) => s.toLowerCase());
const out: DocSearchRange[] = [];
while (!cursor.next().done) {
out.push({ from: cursor.value.from, to: cursor.value.to, active: false });
}
return out;
}
/** 复刻 PlaintextEditor.findAll 的可见性口径(直接调用生产实现)。 */
function visibleMatches(query: string, doc: CodeMirrorText = docOf()): DocSearchRange[] {
return filterVisibleDocSearchRanges(
findMatches(query, doc),
collectDocSearchHiddenRanges(doc, true),
);
}
function mountView(doc = DOC): EditorView {
const host = document.createElement('div');
document.body.appendChild(host);
const view = new EditorView({
state: EditorState.create({
doc,
extensions: [docSearchRangesField, markdownTableDecorationField, searchHighlightField],
}),
parent: host,
});
view.requestMeasure();
return view;
}
function readTableWidget(view: EditorView): { dom: HTMLElement; widget: TableWidgetLike } {
const decorations = view.state.field(markdownTableDecorationField) as DecorationSet;
let widget: TableWidgetLike | undefined;
decorations.between(0, view.state.doc.length, (_from, _to, decoration) => {
if (!widget) widget = decoration.spec.widget as TableWidgetLike;
});
if (!widget) throw new Error('expected exactly one markdown table widget');
const dom = view.dom.querySelector('.cm-md-table-widget') as HTMLElement | null;
if (!dom) throw new Error('expected .cm-md-table-widget in editor DOM');
return { dom, widget };
}
function dispatchRanges(view: EditorView, ranges: DocSearchRange[]): void {
view.dispatch({ effects: setDocSearchRangesEffect.of(ranges) });
view.requestMeasure();
}
describe('markdown table hidden ranges (search visibility)', () => {
it('excludes structural characters but keeps every cell text', () => {
const doc = docOf();
const hidden = collectMarkdownTableHiddenRanges(doc);
const tableFrom = doc.line(3).from;
const tableTo = doc.line(6).to;
const isHidden = (from: number, to: number) =>
hidden.some((span) => from < span.to && to > span.from);
// 表格行起点是 "|",属于结构字符
expect(isHidden(tableFrom, tableFrom + 1)).toBe(true);
// 表头 / 单元格文字都算可见内容(在表格块内定位,不取文档开头的同名词)
const tableStart = DOC.indexOf('| Name');
for (const needle of ['Name', 'Status', 'alpha', 'ready', 'beta', 'blocked']) {
const at = DOC.indexOf(needle, tableStart);
expect(isHidden(at, at + needle.length)).toBe(false);
}
// 分隔行整行没有可见文字
const separator = doc.line(4);
expect(isHidden(separator.from, separator.to)).toBe(true);
// hidden 区间不溢出表格块
for (const span of hidden) {
expect(span.from).toBeGreaterThanOrEqual(tableFrom);
expect(span.to).toBeLessThanOrEqual(tableTo);
}
});
it('drops separator matches from the hit count but keeps cell matches', () => {
// "---" 只出现在分隔行,用户看不见 → 不计入命中
expect(visibleMatches('---')).toEqual([]);
// 表外的 alpha + 表格单元格里的 alpha 都保留
expect(visibleMatches('alpha')).toHaveLength(2);
});
it('keeps every match when the document has no markdown table', () => {
const doc = docOf('plain text without tables');
expect(collectMarkdownTableHiddenRanges(doc)).toEqual([]);
expect(visibleMatches('plain', doc)).toHaveLength(1);
});
});
describe('search only matches text the user can see', () => {
it('drops mermaid block matches because the figure cannot be highlighted', () => {
const doc = docOf(DOC_WITH_MERMAID);
// 源码里有 3 处 alpha(正文 2 + 图内 label 1)
expect(findMatches('alpha', doc)).toHaveLength(3);
// 去掉 mermaid 块后只剩正文两处,且它们都真的画得出高亮
const visible = visibleMatches('alpha', doc);
expect(visible).toHaveLength(2);
for (const range of visible) {
expect(doc.lineAt(range.from).text).toContain('alpha');
}
// 图内其它 label 文字也不再命中
expect(visibleMatches('开始', doc)).toEqual([]);
});
it('drops concealed markdown markers but keeps the text around them', () => {
const doc = docOf(DOC_WITH_MARKUP);
// `#`、`> `、`**`、反引号都被 live preview 换成 widget / 空白
expect(visibleMatches('#', doc)).toEqual([]);
expect(visibleMatches('> ', doc)).toEqual([]);
expect(visibleMatches('**', doc)).toEqual([]);
expect(visibleMatches('`', doc)).toEqual([]);
// 正文文字全保留(标题 / 列表 / 强体 / 行内代码 / 引用)
expect(visibleMatches('alpha', doc)).toHaveLength(5);
});
it('drops table structure and cell-level inline markers, keeps cell words', () => {
const doc = docOf(
[
'| h1 | h2 |',
'| :--- | ---: |',
'| **x** | y |',
'| a \\| b | `c` |',
'| <br> d | e |',
].join('\n'),
);
// 块级结构字符:竖线 / 分隔行 / 对齐冒号
expect(visibleMatches('-', doc)).toEqual([]);
expect(visibleMatches(':', doc)).toEqual([]);
// 单元格内的 inline 标记:星号、反引号、<br> 本身不显示
expect(visibleMatches('**', doc)).toEqual([]);
expect(visibleMatches('`', doc)).toEqual([]);
expect(visibleMatches('<br>', doc)).toEqual([]);
// 被标记包住的文字、转义竖线、普通单元格文字都照常命中
expect(visibleMatches('x', doc)).toHaveLength(1);
expect(visibleMatches('y', doc)).toHaveLength(1);
expect(visibleMatches('c', doc)).toHaveLength(1);
expect(visibleMatches('e', doc)).toHaveLength(1);
expect(visibleMatches('\\|', doc)).toHaveLength(1);
});
it('leaves non-mermaid fenced code alone', () => {
const doc = docOf(['```js', 'const alpha = 1;', '```', '', 'alpha tail'].join('\n'));
// 围栏内是普通文本(不做 conceal),两处都该命中
expect(visibleMatches('alpha', doc)).toHaveLength(2);
});
it('drops cells beyond the rendered column count', () => {
// 表头 2 列 → 渲染模型截掉数据行的第 3 列,那一列没有单元格可高亮
const doc = docOf(['| h1 | h2 |', '| --- | --- |', '| a | b | c |', '| d | e | f |'].join('\n'));
expect(visibleMatches('c', doc)).toEqual([]);
expect(visibleMatches('f', doc)).toEqual([]);
// 前两列照常命中
expect(visibleMatches('a', doc)).toHaveLength(1);
expect(visibleMatches('b', doc)).toHaveLength(1);
});
it('stays linear on documents full of pipes that are not tables', () => {
// 含竖线但没有分隔行 → 不是表格;两路判定都不得把它当表格反复扫描
const lines: string[] = [];
for (let index = 0; index < 200; index++) lines.push(`| pipe line ${index} | tail`);
const doc = docOf(lines.join('\n'));
expect(collectMarkdownTableBlocks(doc)).toEqual([]);
expect(visibleMatches('pipe', doc)).toHaveLength(200);
});
it('never filters anything for non-markdown documents', () => {
const doc = docOf(['# alpha', '- alpha', '```mermaid', 'graph TD', '```'].join('\n'));
expect(collectDocSearchHiddenRanges(doc, false)).toEqual([]);
expect(visibleMatches('alpha', doc)).toHaveLength(2);
});
});
describe('markdown table widget search highlight', () => {
it('highlights matches inside table cells, not just in the body text', () => {
const view = mountView();
const ranges = visibleMatches('alpha');
expect(ranges).toHaveLength(2);
dispatchRanges(view, ranges);
const bodyMarks = view.dom.querySelectorAll('.cm-content > .cm-line .cm-doc-search-match');
const widgetMarks = view.dom.querySelectorAll('.cm-md-table-widget .cm-doc-search-match');
expect(bodyMarks).toHaveLength(1);
expect(widgetMarks).toHaveLength(1);
expect(widgetMarks[0].textContent).toBe('alpha');
expect(widgetMarks[0].closest('td, th')?.getAttribute('data-source-text')).toBe('alpha');
view.destroy();
});
it('keeps the active match distinguishable inside cells', () => {
const view = mountView();
const ranges = visibleMatches('alpha');
dispatchRanges(
view,
ranges.map((range, index) => ({ ...range, active: index === 1 })),
);
const active = view.dom.querySelectorAll('.cm-md-table-widget .cm-doc-search-active');
expect(active).toHaveLength(1);
expect(active[0].textContent).toBe('alpha');
view.destroy();
});
it('paints highlighted cell text that still serializes back to the source', () => {
const view = mountView();
dispatchRanges(view, visibleMatches('alpha'));
const cell = view.dom.querySelector('.cm-md-table-widget td') as HTMLTableCellElement;
expect(cell.textContent).toBe(cell.dataset.sourceText);
view.destroy();
});
it('hands the widget the matches inside its own source range', () => {
const view = mountView();
const ranges = visibleMatches('alpha');
dispatchRanges(view, ranges);
const { widget } = readTableWidget(view);
const doc = docOf();
expect(widget.highlights).toHaveLength(1);
expect(doc.sliceString(widget.highlights[0].from, widget.highlights[0].to)).toBe('alpha');
expect(doc.lineAt(widget.highlights[0].from).number).toBe(5);
view.destroy();
});
it('repaints in place when the query changes, without dropping cell DOM', () => {
const view = mountView();
dispatchRanges(view, visibleMatches('alpha'));
const cell = view.dom.querySelector('.cm-md-table-widget td') as HTMLTableCellElement;
// 同一个 table widget 只换了 hits:CodeMirror 走 updateDOM 原地更新,
// 整表重建会打断正在编辑的单元格。
dispatchRanges(view, visibleMatches('ready'));
expect(view.dom.querySelector('.cm-md-table-widget td')).toBe(cell);
expect(view.dom.querySelector('.cm-md-table-widget .cm-doc-search-match')?.textContent).toBe(
'ready',
);
expect(cell.textContent).toBe('alpha');
view.destroy();
});
it('leaves the cell being edited untouched so typing is not interrupted', () => {
const view = mountView();
dispatchRanges(view, visibleMatches('alpha'));
const cell = view.dom.querySelector('.cm-md-table-widget td') as HTMLTableCellElement;
// jsdom 不给 contentEditable 元素派发焦点,补一个 tabIndex 模拟“正在编辑”
cell.tabIndex = -1;
cell.focus();
cell.textContent = 'alpha edited';
// 新查询仍命中这个 cell,但起点不同 → dataset 要跟着变
dispatchRanges(view, visibleMatches('lpha'));
view.requestMeasure();
expect(cell.textContent).toBe('alpha edited');
// dataset 必须已经存了新查询的高亮:失焦重画才不会回到旧查询
// (project-search 跳转不聚焦搜索框,新命中会在 cell 仍聚焦时到达)
expect(cell.dataset.searchHighlights).toBe('1:5');
cell.blur();
view.destroy();
});
});
describe('docSearchIndexOfLine (project-search jump target)', () => {
// mermaid 块整块不可见 → findAll 剔除其中的命中。目标行之前若有这类同词
// 命中,按源码计数会偏大:这里可见命中 4 个(源码计数给 5,越界 → setActive
// 直接 return,用户点了跳转却什么都没滚)。
const DOC_WITH_HIDDEN_HIT = [
'```mermaid',
'graph TD',
' A[alpha] --> B[x]',
'```',
'',
'alpha one',
'alpha two',
'alpha three',
'alpha target',
].join('\n');
it('counts only visible hits, so a hidden earlier hit does not offset the target', () => {
const doc = docOf(DOC_WITH_HIDDEN_HIT);
const visible = visibleMatches('alpha', doc);
const lineOf = (from: number) => doc.lineAt(from).number;
// mermaid 块里(line 3)那处命中被剔除 → 可见命中只剩 line 6/7/8/9 四处
expect(visible).toHaveLength(4);
expect(doc.lineAt(visible[0].from).number).toBe(6);
expect(doc.lineAt(visible[3].from).number).toBe(9);
// 跳到 line 9 → 下标 3。
expect(docSearchIndexOfLine(visible, lineOf, 9)).toBe(3);
// 对照:旧口径(数 line 9 之前的源码命中)会把隐藏那处一起算进去 → 4,
// 而可见命中总共只有 4 个 → setActive(4) 越界直接 return,跳转根本不发生。
const linesBeforeTarget = DOC_WITH_HIDDEN_HIT.split(/\r?\n/).slice(0, 8);
const sourceCount = linesBeforeTarget
.join('\n')
.toLowerCase()
.split('alpha').length - 1;
expect(sourceCount).toBe(4);
expect(sourceCount).toBeGreaterThanOrEqual(visible.length);
});
it('returns 0 when no visible match is on or after the line', () => {
const doc = docOf(DOC_WITH_MERMAID);
const visible = visibleMatches('alpha', doc);
const lineOf = (from: number) => doc.lineAt(from).number;
expect(docSearchIndexOfLine(visible, lineOf, 99)).toBe(0);
expect(docSearchIndexOfLine([], lineOf, 1)).toBe(0);
});
});