dsh-selection-annotations 0.0.0-stage → 2.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +171 -0
- package/LICENSE +21 -0
- package/README.md +161 -3
- package/README.zh-CN.md +161 -0
- package/client.js +11136 -0
- package/cordis.patch.yml +3 -0
- package/icon.svg +7 -0
- package/lib/annotations-db.js +1157 -0
- package/lib/index.js +1304 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +76 -6
- package/scripts/build.mjs +37 -0
- package/scripts/check-build.mjs +10 -0
- package/src/core/annotation-clipboard.js +93 -0
- package/src/core/annotation-utils.js +27 -0
- package/src/core/cards.js +502 -0
- package/src/core/config.js +91 -0
- package/src/core/constants.js +34 -0
- package/src/core/draft-codec.js +77 -0
- package/src/core/draft-store.js +85 -0
- package/src/core/hidden-payload.js +73 -0
- package/src/core/image-codec.js +111 -0
- package/src/core/jump-icon.js +25 -0
- package/src/core/locale.js +59 -0
- package/src/core/log.js +19 -0
- package/src/core/markdown.js +80 -0
- package/src/core/messages.js +311 -0
- package/src/core/note-tone.js +77 -0
- package/src/core/panel-render.js +315 -0
- package/src/core/payload.js +191 -0
- package/src/core/preview-bridge.js +216 -0
- package/src/core/remote-sync.js +206 -0
- package/src/core/scroll-trace.js +177 -0
- package/src/core/sent-store.js +148 -0
- package/src/core/session.js +60 -0
- package/src/core/settings.js +168 -0
- package/src/core/side-tab-state.js +30 -0
- package/src/core/source-capture.js +530 -0
- package/src/core/source-locate.js +220 -0
- package/src/core/source-resolve.js +89 -0
- package/src/core/styles.js +590 -0
- package/src/core/turn-anchor.js +54 -0
- package/src/core/util.js +55 -0
- package/src/core/uuid.js +23 -0
- package/src/core/web-picker.js +426 -0
- package/src/entry.js +22 -0
- package/src/plugin.js +8706 -0
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
import { safe } from './util.js'
|
|
2
|
+
|
|
3
|
+
export function offsetRange(root, range) {
|
|
4
|
+
const measure = (node, offset) =>
|
|
5
|
+
safe(() => {
|
|
6
|
+
const probe = range.cloneRange()
|
|
7
|
+
probe.setStart(root, 0)
|
|
8
|
+
probe.setEnd(node, offset)
|
|
9
|
+
return probe.toString().length
|
|
10
|
+
})
|
|
11
|
+
const start = measure(range.startContainer, range.startOffset)
|
|
12
|
+
const end = measure(range.endContainer, range.endOffset)
|
|
13
|
+
if (start === undefined) return { start: undefined, end: undefined }
|
|
14
|
+
return { start, end: end === undefined || end < start ? start : end }
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* 按「根元素文本里的字符偏移」重建一个 Range。
|
|
19
|
+
* 从 source-capture 挪到这里,让分段捕获、分段定位共用同一份测量口径。
|
|
20
|
+
*/
|
|
21
|
+
export function rangeFromOffsets(root, start, length) {
|
|
22
|
+
const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT)
|
|
23
|
+
let offset = 0
|
|
24
|
+
let startNode
|
|
25
|
+
let startOffset = 0
|
|
26
|
+
let endNode
|
|
27
|
+
let endOffset = 0
|
|
28
|
+
let node = walker.nextNode()
|
|
29
|
+
while (node !== null) {
|
|
30
|
+
const size = node.nodeValue === null ? 0 : node.nodeValue.length
|
|
31
|
+
if (startNode === undefined && offset + size >= start) {
|
|
32
|
+
startNode = node
|
|
33
|
+
startOffset = start - offset
|
|
34
|
+
}
|
|
35
|
+
if (startNode !== undefined && offset + size >= start + length) {
|
|
36
|
+
endNode = node
|
|
37
|
+
endOffset = start + length - offset
|
|
38
|
+
break
|
|
39
|
+
}
|
|
40
|
+
offset += size
|
|
41
|
+
node = walker.nextNode()
|
|
42
|
+
}
|
|
43
|
+
if (startNode === undefined || endNode === undefined) return undefined
|
|
44
|
+
return safe(() => {
|
|
45
|
+
const range = document.createRange()
|
|
46
|
+
range.setStart(startNode, Math.max(0, Math.min(startOffset, startNode.nodeValue.length)))
|
|
47
|
+
range.setEnd(endNode, Math.max(0, Math.min(endOffset, endNode.nodeValue.length)))
|
|
48
|
+
return range
|
|
49
|
+
})
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function pathFromPreviewUrl(url) {
|
|
53
|
+
// dsh-resource://file/session/<sessionId>/<encoded path>
|
|
54
|
+
const marker = '/session/'
|
|
55
|
+
const at = url.indexOf(marker)
|
|
56
|
+
if (at === -1) return undefined
|
|
57
|
+
const rest = url.slice(at + marker.length)
|
|
58
|
+
const slash = rest.indexOf('/')
|
|
59
|
+
if (slash === -1) return undefined
|
|
60
|
+
const raw = rest.slice(slash + 1)
|
|
61
|
+
return safe(() => decodeURIComponent(raw)) ?? raw
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export function lineNumberOf(element) {
|
|
65
|
+
if (element === null) return undefined
|
|
66
|
+
const holder = element.closest('[data-textpreview-line]')
|
|
67
|
+
if (holder === null) return undefined
|
|
68
|
+
const value = Number(holder.getAttribute('data-textpreview-line'))
|
|
69
|
+
return Number.isFinite(value) ? value : undefined
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* 代码预览没有行号属性,只能按 `.line` 的序号推算。
|
|
74
|
+
* 先看选区端点能不能向上找到最近的 `.line`;找不到再退回「第几个 .line 包含它」。
|
|
75
|
+
*/
|
|
76
|
+
export function codeLineNumberOf(scope, element) {
|
|
77
|
+
if (element === null || scope === null || scope === undefined) return undefined
|
|
78
|
+
const lines = [...scope.querySelectorAll('.line')]
|
|
79
|
+
const own = typeof element.closest === 'function' ? element.closest('.line') : null
|
|
80
|
+
const target = own !== null ? own : lines.find((line) => line.contains(element))
|
|
81
|
+
if (target === null || target === undefined) return undefined
|
|
82
|
+
const index = lines.indexOf(target)
|
|
83
|
+
return index === -1 ? undefined : index + 1
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** 空白折叠成单个空格,并记下每个规范化字符对应的源文本下标。 */
|
|
87
|
+
export function normalizeWithMap(value) {
|
|
88
|
+
const chars = []
|
|
89
|
+
const map = []
|
|
90
|
+
let spaceAt = -1
|
|
91
|
+
for (let i = 0; i < value.length; i += 1) {
|
|
92
|
+
const ch = value[i]
|
|
93
|
+
if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r') {
|
|
94
|
+
if (spaceAt === -1) spaceAt = i
|
|
95
|
+
continue
|
|
96
|
+
}
|
|
97
|
+
if (spaceAt !== -1) {
|
|
98
|
+
if (chars.length > 0) {
|
|
99
|
+
chars.push(' ')
|
|
100
|
+
map.push(spaceAt)
|
|
101
|
+
}
|
|
102
|
+
spaceAt = -1
|
|
103
|
+
}
|
|
104
|
+
chars.push(ch)
|
|
105
|
+
map.push(i)
|
|
106
|
+
}
|
|
107
|
+
return { text: chars.join(''), map }
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* 在源文件文本里定位引文。
|
|
112
|
+
*
|
|
113
|
+
* 渲染后的正文与原文并不一样(标题丢了 `#`、强调丢了 `**`、链接只剩文字),而且换行、
|
|
114
|
+
* 缩进也会被重排,所以不能直接 `indexOf`:先把两边都做空白折叠再比,命中后把区间映射回
|
|
115
|
+
* 源文本下标。找不到就返回 undefined —— 那时宁可不要行号,也不要给一个错的。
|
|
116
|
+
* @returns { start, end } 源文本里的半开区间。
|
|
117
|
+
*/
|
|
118
|
+
export function locateInSource(source, quote) {
|
|
119
|
+
const needle = quote.replace(/\s+/g, ' ').trim()
|
|
120
|
+
if (needle === '') return undefined
|
|
121
|
+
const hay = normalizeWithMap(source)
|
|
122
|
+
const at = hay.text.indexOf(needle)
|
|
123
|
+
if (at === -1) return undefined
|
|
124
|
+
const start = hay.map[at]
|
|
125
|
+
const end = hay.map[at + needle.length - 1]
|
|
126
|
+
if (start === undefined || end === undefined) return undefined
|
|
127
|
+
return { start, end: end + 1 }
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* 在根元素里按「空白折叠后」的文本定位一段引文。
|
|
132
|
+
*
|
|
133
|
+
* 渲染后的正文会被换行、缩进重排:`p` 与 `p` 之间的换行、`li` 的缩进都不在文本节点里,
|
|
134
|
+
* 但 `textContent` 会原样拼出空白序列,于是同一个选区在窄屏/宽屏下空白数量可能不同,
|
|
135
|
+
* 精确 `indexOf` 就会落空。两边都折叠空白再比,命中后把规范化下标映射回源文本下标:
|
|
136
|
+
* 末端取 `map[pos + len]`(命中后的第一个规范化字符),越界时取文本长度 ——
|
|
137
|
+
* 用 `map[pos + len - 1] + 1` 会在末字符后紧跟空白时把结尾的空白吞掉。
|
|
138
|
+
* 重复片段按保存时的偏移取最近的一处。
|
|
139
|
+
* @param root - 搜索范围(元素)。
|
|
140
|
+
* @param needle - 要定位的引文(原始空白即可,函数内部折叠)。
|
|
141
|
+
* @param savedOffset - 保存时的根内字符偏移,用于在多处命中里选最近的一处。
|
|
142
|
+
* @returns 命中的 Range;找不到返回 undefined。
|
|
143
|
+
*/
|
|
144
|
+
export function matchInRootNormalized(root, needle, savedOffset) {
|
|
145
|
+
if (root === null || root === undefined) return undefined
|
|
146
|
+
if (typeof needle !== 'string' || needle === '') return undefined
|
|
147
|
+
const target = needle.replace(/\s+/g, ' ').trim()
|
|
148
|
+
if (target === '') return undefined
|
|
149
|
+
const raw = safe(() => root.textContent) ?? ''
|
|
150
|
+
if (raw === '') return undefined
|
|
151
|
+
const hay = normalizeWithMap(raw)
|
|
152
|
+
if (hay.text === '') return undefined
|
|
153
|
+
const positions = []
|
|
154
|
+
let from = 0
|
|
155
|
+
for (;;) {
|
|
156
|
+
const at = hay.text.indexOf(target, from)
|
|
157
|
+
if (at === -1 || positions.length >= 64) break
|
|
158
|
+
positions.push(at)
|
|
159
|
+
from = at + 1
|
|
160
|
+
}
|
|
161
|
+
if (positions.length === 0) return undefined
|
|
162
|
+
let best = positions[0]
|
|
163
|
+
if (positions.length > 1 && Number.isFinite(savedOffset)) {
|
|
164
|
+
best = positions.reduce((a, b) => {
|
|
165
|
+
const nearA = Math.abs((hay.map[a] ?? a) - savedOffset)
|
|
166
|
+
const nearB = Math.abs((hay.map[b] ?? b) - savedOffset)
|
|
167
|
+
return nearB < nearA ? b : a
|
|
168
|
+
})
|
|
169
|
+
}
|
|
170
|
+
const start = hay.map[best]
|
|
171
|
+
if (start === undefined) return undefined
|
|
172
|
+
const rawEnd = hay.map[best + target.length]
|
|
173
|
+
// 命中顶到规范化文本末尾时,末端取原文长度:map 存的是原文下标,
|
|
174
|
+
// 用规范化文本长度当原文下标会把折叠掉的空白算进来、把最后几个字符截掉。
|
|
175
|
+
const end = rawEnd === undefined ? raw.length : rawEnd
|
|
176
|
+
const length = Math.max(0, Math.min(end, raw.length) - start)
|
|
177
|
+
if (length <= 0) return undefined
|
|
178
|
+
return rangeFromOffsets(root, start, length)
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
/** 源文本里某个下标所处的 1 基行号。 */
|
|
182
|
+
export function lineOfOffset(text, offset) {
|
|
183
|
+
let line = 1
|
|
184
|
+
const limit = Math.max(0, Math.min(offset, text.length))
|
|
185
|
+
for (let i = 0; i < limit; i += 1) if (text.charCodeAt(i) === 10) line += 1
|
|
186
|
+
return line
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* 给一次远端调用套上超时,并且不吞掉失败原因 ——
|
|
191
|
+
* 返回 `{ ok: true, value }` 或 `{ ok: false, reason }`,便于把「超时」与「抛错」分开。
|
|
192
|
+
*/
|
|
193
|
+
export function withTimeout(promise, ms) {
|
|
194
|
+
return new Promise((resolve) => {
|
|
195
|
+
let settled = false
|
|
196
|
+
const settle = (outcome) => {
|
|
197
|
+
if (settled) return
|
|
198
|
+
settled = true
|
|
199
|
+
window.clearTimeout(timer)
|
|
200
|
+
resolve(outcome)
|
|
201
|
+
}
|
|
202
|
+
const timer = window.setTimeout(() => settle({ ok: false, reason: `${ms}ms 内没有返回` }), ms)
|
|
203
|
+
Promise.resolve(promise).then(
|
|
204
|
+
(value) => settle({ ok: true, value }),
|
|
205
|
+
(error) => settle({ ok: false, reason: error instanceof Error ? error.message : String(error) }),
|
|
206
|
+
)
|
|
207
|
+
})
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* 行号区间:优先用行自带的 `data-textpreview-line`(纯文本预览有);
|
|
212
|
+
* 代码预览没有这个属性,退回按 `.line` 序号推算。两者都拿不到就不写行号。
|
|
213
|
+
*/
|
|
214
|
+
export function lineRangeWithin(root, startEl, endEl) {
|
|
215
|
+
const marked = lineNumberOf(startEl) ?? lineNumberOf(endEl)
|
|
216
|
+
if (marked !== undefined) return { start: marked, end: lineNumberOf(endEl) ?? marked }
|
|
217
|
+
const start = codeLineNumberOf(root, startEl)
|
|
218
|
+
if (start === undefined) return { start: undefined, end: undefined }
|
|
219
|
+
return { start, end: codeLineNumberOf(root, endEl) ?? start }
|
|
220
|
+
}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { safe } from './util.js'
|
|
2
|
+
import { withTimeout, locateInSource, lineOfOffset } from './source-locate.js'
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* 出处精修:读到工作区源文件时,把引文折算成原文坐标(行号 + 字符区间)。
|
|
6
|
+
* 读不到就安静退回渲染坐标,绝不阻断批注创建;失败原因交给 onSkip 显示在面板上。
|
|
7
|
+
*/
|
|
8
|
+
export function createSourceResolver({ ctx, getSessionId, log, timeoutMs }) {
|
|
9
|
+
function unwrapRemote(value) {
|
|
10
|
+
if (value !== null && typeof value === 'object' && 'ok' in value && 'value' in value) {
|
|
11
|
+
return value.ok === true ? value.value : undefined
|
|
12
|
+
}
|
|
13
|
+
return value
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
async function resolve(source, quote, onSkip) {
|
|
17
|
+
try {
|
|
18
|
+
return await resolveInner(source, quote, onSkip)
|
|
19
|
+
} catch (error) {
|
|
20
|
+
// 抛错绝不能无声消失:安静退回渲染坐标,控制台留一行原因。
|
|
21
|
+
log(`[selection-annotations] 位置精修抛错:${error instanceof Error ? error.message : String(error)}`)
|
|
22
|
+
return undefined
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
async function resolveInner(source, quote, onSkip) {
|
|
27
|
+
/**
|
|
28
|
+
* 精修失败一律安静退回(退到渲染坐标,绝不阻断创建),但原因要有去处:
|
|
29
|
+
* 控制台一行日志,另外交给 onSkip —— 插件把它显示在面板条目上。
|
|
30
|
+
*/
|
|
31
|
+
const skip = (reason) => {
|
|
32
|
+
log(`[selection-annotations] 位置精修跳过(${String(source?.path)}):${reason}`)
|
|
33
|
+
if (typeof onSkip === 'function') onSkip(reason)
|
|
34
|
+
return undefined
|
|
35
|
+
}
|
|
36
|
+
if (source?.kind !== 'file') return undefined
|
|
37
|
+
if (typeof source.path !== 'string' || source.path === '') return undefined
|
|
38
|
+
const sessionId = getSessionId()
|
|
39
|
+
if (sessionId === undefined) return skip('拿不到当前会话 id')
|
|
40
|
+
// 读原文要经 remote:客户端上下文只把 inject 里声明过的命名空间挂上去,
|
|
41
|
+
// 所以 `remote.workspaceFiles` 必须先写进 inject(少写就取值即抛)。
|
|
42
|
+
// 而 remote 本身有两种作用域 —— 会话作用域(sessions.scope().remote)与根上下文
|
|
43
|
+
// (ctx.remote)—— 前者不带这个命名空间,因此逐个探测、哪个能用用哪个。
|
|
44
|
+
const candidates = []
|
|
45
|
+
const agent = safe(() => ctx.sessions?.scope?.(sessionId))
|
|
46
|
+
if (agent?.remote !== undefined) candidates.push({ label: 'sessions.scope().remote', remote: agent.remote })
|
|
47
|
+
const direct = safe(() => ctx.remote) ?? safe(() => ctx.get('remote'))
|
|
48
|
+
if (direct !== undefined) candidates.push({ label: 'ctx.remote', remote: direct })
|
|
49
|
+
// 探测放在 safe 里:取不到的候选会抛,而不是返回 undefined。
|
|
50
|
+
let usable
|
|
51
|
+
for (const entry of candidates) {
|
|
52
|
+
const probe = safe(() => typeof entry.remote?.workspaceFiles?.read === 'function')
|
|
53
|
+
if (probe === undefined) continue
|
|
54
|
+
if (probe === true) {
|
|
55
|
+
usable = entry
|
|
56
|
+
break
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
if (usable === undefined) {
|
|
60
|
+
return skip(`拿不到 remote.workspaceFiles.read(试过 ${candidates.map((e) => e.label).join(' / ') || '无任何 remote'})`)
|
|
61
|
+
}
|
|
62
|
+
log(`[selection-annotations] 位置精修:经 ${usable.label} 读 ${source.path}`)
|
|
63
|
+
const outcome = await withTimeout(
|
|
64
|
+
safe(() => usable.remote.workspaceFiles.read(sessionId, source.path, {})),
|
|
65
|
+
timeoutMs,
|
|
66
|
+
)
|
|
67
|
+
if (outcome.ok === false) return skip(`读取失败:${outcome.reason}`)
|
|
68
|
+
const file = unwrapRemote(outcome.value)
|
|
69
|
+
const text = typeof file?.text === 'string' ? file.text : undefined
|
|
70
|
+
if (text === undefined) return skip('返回里没有 text(path 可能不被接受)')
|
|
71
|
+
const hit = locateInSource(text, quote)
|
|
72
|
+
if (hit === undefined) {
|
|
73
|
+
return skip(
|
|
74
|
+
file?.eof === false
|
|
75
|
+
? `引文不在读取窗口内(只拿到 ${text.length} 字符,eof=false)`
|
|
76
|
+
: '引文不在原文里(多半是跨了行内 Markdown 标记)',
|
|
77
|
+
)
|
|
78
|
+
}
|
|
79
|
+
return {
|
|
80
|
+
charStart: hit.start,
|
|
81
|
+
charEnd: hit.end,
|
|
82
|
+
lineStart: lineOfOffset(text, hit.start),
|
|
83
|
+
lineEnd: lineOfOffset(text, Math.max(hit.start, hit.end - 1)),
|
|
84
|
+
textOrigin: 'source',
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
return { resolve }
|
|
89
|
+
}
|