Files
deepseek-harness/packages/client/ui-chat/tests/text-selection.client.spec.tsx
T
lsdsjyandlsdsjy 0e49f443dd feat(ui-conversation,ui-chat): 基于 user-text 支持富文本引用与草稿恢复 (#3206)
* feat(ui-chat,ui-conversation): 通过通用文本交互支持原文引用

* refactor(message-quotes): 插件化引用交互与文本扫描豁免

* test(message-quotes): 补齐插件装配预期与交互分发覆盖

* refactor(ui-conversation): 移除引用删除文案的语言切换刷新

* refactor(message-quotes): 移除引用扫描豁免并收窄文本交互接口

* fix(ui-chat): 修复引用浮层的滚动遮挡与恢复

* fix(ui-chat): 对齐 master 的聊天流注入与界面快照

* test(message-quotes): 补齐 Host 入口覆盖并固定子会话回放时序

* refactor(message-quotes): 清理文本依赖特例并修正引用按钮

* fix(ui-primitives): 让引用原文弹层按内容收缩

* fix(ui-primitives): 修复相邻引用悬停弹层重叠与误切换

* fix(message-quotes): 为引用悬停样式限定设备能力

---------

Co-authored-by: lsdsjy <[email protected]>
2026-10-21 14:41:41 +08:00

277 lines
11 KiB
TypeScript

// @vitest-environment jsdom
import { afterEach, describe, expect, it, vi } from 'vitest'
import { cleanup, render } from '@testing-library/react'
import { MarkdownText } from '@deepseek-ai/dsh-client-ui-primitives'
import { readTextSelection, selectedText } from '../src/client/chat/text-selection.ts'
function readSelection(root: HTMLElement, selection: Selection | null) {
const result = readTextSelection(root, selection)
return result === null ? null : { text: selectedText(result) }
}
const markdownLabels = {
code: { copyLabel: 'Copy', copiedLabel: 'Copied' },
footnotes: 'Footnotes',
}
afterEach(() => {
cleanup()
vi.useRealTimers()
vi.unstubAllGlobals()
})
describe('quote selection', () => {
it('extracts one source block and omits Markdown control copy', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source="">
<span>Hello </span>
<button type="button">Copy</button>
<span>world</span>
</div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const sourceRoot = view.container.querySelector<HTMLElement>('[data-text-interaction-source]')!
const range = document.createRange()
range.selectNodeContents(sourceRoot)
range.getBoundingClientRect = () => ({ left: 10, top: 20, width: 30, height: 10 }) as DOMRect
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
expect(readSelection(root, selection)).toMatchObject({
text: 'Hello world',
})
})
it('rejects cross-block and pending text selections', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source="">one</div>
<span>pending</span>
<div data-text-interaction-source="">two</div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const sources = view.container.querySelectorAll('[data-text-interaction-source]')
const range = document.createRange()
range.setStart(sources[0]!.firstChild!, 0)
range.setEnd(sources[1]!.firstChild!, 3)
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
expect(readSelection(root, selection)).toBeNull()
})
it('keeps one visible newline for the Markdown hard-break DOM pair', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source="">
<span>first</span><br />{'\n'}<span>second</span>
</div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const sourceRoot = view.container.querySelector<HTMLElement>('[data-text-interaction-source]')!
const range = document.createRange()
range.selectNodeContents(sourceRoot)
range.getBoundingClientRect = () => ({ left: 50, top: 60, width: 20, height: 10 }) as DOMRect
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
const candidate = readSelection(root, selection)
expect(candidate).toMatchObject({
text: 'first\nsecond',
})
})
it('projects Markdown soft line breaks as visible spaces', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source=""><p>{'hello\nworld'}</p></div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const sourceRoot = view.container.querySelector<HTMLElement>('[data-text-interaction-source]')!
const range = document.createRange()
range.selectNodeContents(sourceRoot)
range.getBoundingClientRect = () => ({ left: 50, top: 60, width: 20, height: 10 }) as DOMRect
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
expect(readSelection(root, selection)).toMatchObject({ text: 'hello world' })
const text = sourceRoot.querySelector('p')!.firstChild!
range.setStart(text, 6)
range.setEnd(text, 11)
expect(readSelection(root, selection)).toMatchObject({ text: 'world' })
})
it('omits code banners while preserving preformatted line breaks', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source="">
<div data-text-interaction-exclude="">typescript</div>
<pre style={{ whiteSpace: 'pre-wrap' }}>{'const x = 1\nreturn x'}</pre>
</div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const sourceRoot = view.container.querySelector<HTMLElement>('[data-text-interaction-source]')!
const range = document.createRange()
range.selectNodeContents(sourceRoot)
range.getBoundingClientRect = () => ({ left: 50, top: 60, width: 20, height: 10 }) as DOMRect
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
expect(readSelection(root, selection)).toMatchObject({ text: 'const x = 1\nreturn x' })
})
it('uses one synthetic newline when a hard break has no text-node newline', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source="">
<span>first</span><br /><span>second</span>
</div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const sourceRoot = view.container.querySelector<HTMLElement>('[data-text-interaction-source]')!
const range = document.createRange()
range.selectNodeContents(sourceRoot)
range.getBoundingClientRect = () => ({ left: 50, top: 60, width: 20, height: 10 }) as DOMRect
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
const candidate = readSelection(root, selection)
expect(candidate).toMatchObject({
text: 'first\nsecond',
})
})
it('preserves visible boundaries between adjacent Markdown blocks', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source="">
<p>first</p><p>second</p>
</div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const sourceRoot = view.container.querySelector<HTMLElement>('[data-text-interaction-source]')!
const range = document.createRange()
range.selectNodeContents(sourceRoot)
range.getBoundingClientRect = () => ({ left: 50, top: 60, width: 20, height: 10 }) as DOMRect
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
const candidate = readSelection(root, selection)
expect(candidate).toMatchObject({
text: 'first\nsecond',
})
})
it('omits Markdown renderer whitespace between adjacent blocks', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source="">
<MarkdownText text={'first\n\nsecond'} labels={markdownLabels} />
</div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const sourceRoot = view.container.querySelector<HTMLElement>('[data-text-interaction-source]')!
const paragraphs = sourceRoot.querySelectorAll('p')
expect(paragraphs[0]!.nextSibling?.textContent).toBe('\n')
const range = document.createRange()
range.setStart(paragraphs[0]!.firstChild!, 0)
range.setEnd(paragraphs[1]!.firstChild!, 'second'.length)
range.getBoundingClientRect = () => (
{ left: 50, top: 60, width: 20, height: 10 } as DOMRect
)
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
expect(readSelection(root, selection)).toMatchObject({ text: 'first\nsecond' })
})
it('maps visible KaTeX text while omitting its duplicate MathML branch', () => {
const view = render(
<div data-chat-flow="">
<div data-text-interaction-source="">
<span className="katex">
<span className="katex-mathml">hidden TeX source</span>
<span className="katex-html" aria-hidden="true">x + 1</span>
</span>
</div>
</div>,
)
const root = view.container.querySelector<HTMLElement>('[data-chat-flow]')!
const visible = view.container.querySelector<HTMLElement>('.katex-html')!
const range = document.createRange()
range.selectNodeContents(visible)
range.getBoundingClientRect = () => ({ left: 50, top: 60, width: 20, height: 10 }) as DOMRect
const selection = window.getSelection()!
selection.removeAllRanges()
selection.addRange(range)
expect(readSelection(root, selection)).toMatchObject({ text: 'x + 1' })
})
})
describe('text source boundaries', () => {
function source(html: string) {
const root = document.createElement('div')
const source = document.createElement('div')
source.setAttribute('data-text-interaction-source', '')
source.innerHTML = html
root.append(source)
const range = document.createRange()
range.selectNodeContents(source)
return { root, source, range }
}
it('preserves table cells, existing tabs, and inline code reference buttons', () => {
const fixture = source('<table><tbody><tr><td>one</td><td>two</td></tr><tr><td style="white-space:pre">three\t</td><td>four</td></tr><tr><td>five</td><td style="white-space:pre">\tsix</td></tr></tbody></table><code><button>reference</button></code>')
expect(selectedText(fixture)).toBe('one\ttwo\nthree\tfour\nfive\tsix\nreference')
})
it('omits hidden content, comments, and empty text nodes', () => {
const fixture = source('<!-- renderer --><span aria-hidden="true">decoration</span><span hidden>hidden</span><span class="sr-only">spoken</span><span>visible</span>')
fixture.source.append(document.createTextNode(''))
fixture.range.selectNodeContents(fixture.source)
expect(selectedText(fixture)).toBe('visible')
const hidden = fixture.source.querySelector('span')!
fixture.range.selectNodeContents(hidden)
expect(selectedText(fixture)).toBeNull()
fixture.range.setStart(hidden.firstChild!, 0)
fixture.range.setEnd(hidden.firstChild!, 4)
expect(selectedText(fixture)).toBeNull()
})
it('rejects whitespace-only and detached sources outside the area', () => {
const fixture = source(' ')
expect(selectedText(fixture)).toBeNull()
const selection = window.getSelection()!
selection.removeAllRanges()
expect(readTextSelection(fixture.root, null)).toBeNull()
expect(readTextSelection(fixture.root, selection)).toBeNull()
document.body.append(fixture.root)
try {
selection.addRange(fixture.range)
expect(readTextSelection(document.createElement('div'), selection)).toBeNull()
fixture.source.hidden = true
expect(readTextSelection(fixture.root, selection)).toBeNull()
} finally { fixture.root.remove(); selection.removeAllRanges() }
})
it('projects text in a document without a browsing context', () => {
const doc = document.implementation.createHTMLDocument()
const source = doc.createElement('div')
source.textContent = 'hello\nworld'
const range = doc.createRange()
range.selectNodeContents(source)
expect(selectedText({ source, range })).toBe('hello world')
})
})