dsh-knit 0.4.0 → 0.5.0
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/README.en.md +18 -7
- package/README.md +16 -7
- package/package.json +9 -4
- package/src/client/client.js +793 -53
- package/src/host/index.js +232 -47
- package/test/client.test.mjs +491 -1
- package/test/harness.mjs +30 -6
- package/test/host-http.test.mjs +118 -0
- package/test/host.test.mjs +137 -0
- package/test/path.test.mjs +208 -0
- package/test/peek.test.mjs +338 -0
|
@@ -0,0 +1,338 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 「悬停偷看」测试:鼠标停入口按钮 → 弹一个只读浮层;点击才进右边栏。
|
|
3
|
+
*
|
|
4
|
+
* 浮层是我们自己画的,不走框架的 `sidebarRight.float` —— 因为
|
|
5
|
+
* `openTab` 一定会展开右侧栏,`float` 又要求 tab 已经停靠,
|
|
6
|
+
* 那条路会让一次悬停引发布局抖动。
|
|
7
|
+
*
|
|
8
|
+
* 跑法:node --test test/
|
|
9
|
+
*/
|
|
10
|
+
import test from 'node:test'
|
|
11
|
+
import assert from 'node:assert/strict'
|
|
12
|
+
|
|
13
|
+
import { loadClientModule, createHarness, byClass, byExactClass, textOf, makeLocale } from './harness.mjs'
|
|
14
|
+
|
|
15
|
+
const harness = createHarness()
|
|
16
|
+
const React = globalThis.__knitReact
|
|
17
|
+
const h = React.createElement
|
|
18
|
+
|
|
19
|
+
/* ── 脚手架 ─────────────────────────────────────────── */
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* 造一份列表载荷。
|
|
23
|
+
* @param {number} [count] - 几篇文档
|
|
24
|
+
* @returns {object} 载荷
|
|
25
|
+
*/
|
|
26
|
+
function listPayload(count = 3) {
|
|
27
|
+
return {
|
|
28
|
+
ok: true,
|
|
29
|
+
root: '/p',
|
|
30
|
+
total: count,
|
|
31
|
+
mode: 'time',
|
|
32
|
+
topic: '',
|
|
33
|
+
docs: Array.from({ length: count }, (_, i) => ({
|
|
34
|
+
path: `/p/d${i}.md`,
|
|
35
|
+
rel: `d${i}.md`,
|
|
36
|
+
name: `d${i}.md`,
|
|
37
|
+
title: `文档 ${i}`,
|
|
38
|
+
summary: 's',
|
|
39
|
+
mtimeMs: Date.now() - i * 60000,
|
|
40
|
+
score: null,
|
|
41
|
+
})),
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* 装载模块并 apply 到一个带 sessions 的假上下文。
|
|
47
|
+
* @param {{docs?: number, current?: string}} [options] - 列表条数与当前会话 id
|
|
48
|
+
* @returns {{exports: object, log: object, fetches: string[]}} 结果
|
|
49
|
+
*/
|
|
50
|
+
function boot(options = {}) {
|
|
51
|
+
const loaded = loadClientModule()
|
|
52
|
+
const log = { effects: [] }
|
|
53
|
+
const fetches = []
|
|
54
|
+
const { locale } = makeLocale({ active: 'zh' })
|
|
55
|
+
const count = options.docs === undefined ? 3 : options.docs
|
|
56
|
+
|
|
57
|
+
globalThis.fetch = async (url) => {
|
|
58
|
+
fetches.push(url)
|
|
59
|
+
return { json: async () => listPayload(count) }
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
const services = {
|
|
63
|
+
slots: { inject(n, cb) { cb(); return () => {} }, register() { return () => {} } },
|
|
64
|
+
sessions: {
|
|
65
|
+
list: {
|
|
66
|
+
getSnapshot: () => ({ current: options.current === undefined ? 's-1' : options.current }),
|
|
67
|
+
},
|
|
68
|
+
},
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
const ctx = {
|
|
72
|
+
slots: services.slots,
|
|
73
|
+
locale,
|
|
74
|
+
effect(fn, label) { log.effects.push(label); return fn() },
|
|
75
|
+
get: (name) => services[name],
|
|
76
|
+
inject(deps, cb) {
|
|
77
|
+
for (const d of deps) if (!services[d]) return
|
|
78
|
+
cb({ ...services, effect: (fn) => fn() })
|
|
79
|
+
},
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
loaded.exports.apply(ctx)
|
|
83
|
+
return { exports: loaded.exports, log, fetches }
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** 取按钮(整段匹配,避免命中 .knit-peek-anchor 这种前缀)。 */
|
|
87
|
+
const buttonOf = (nodes) => byExactClass(nodes, 'knit-entry')[0]
|
|
88
|
+
/** 取悬停锚点。 */
|
|
89
|
+
const anchorOf = (nodes) => byClass(nodes, 'knit-peek-anchor')[0]
|
|
90
|
+
/** 取浮层。 */
|
|
91
|
+
const peekOf = (nodes) => byExactClass(nodes, 'knit-peek')[0]
|
|
92
|
+
|
|
93
|
+
/* ── 悬停显示 ───────────────────────────────────────── */
|
|
94
|
+
|
|
95
|
+
test('悬停:进入后延迟才显示,不是一碰就弹', async () => {
|
|
96
|
+
const { exports } = boot()
|
|
97
|
+
const Button = exports.__test.makeEntryButton(() => true)
|
|
98
|
+
|
|
99
|
+
harness.reset()
|
|
100
|
+
let nodes = harness.render(h(Button, {}))
|
|
101
|
+
assert.equal(peekOf(nodes), undefined, '初始没有浮层')
|
|
102
|
+
|
|
103
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
104
|
+
nodes = harness.render(h(Button, {}))
|
|
105
|
+
assert.equal(peekOf(nodes), undefined, '刚进入还不该有(要等延时)')
|
|
106
|
+
assert.ok(harness.pendingTimers() >= 1, '应排了一个延时')
|
|
107
|
+
|
|
108
|
+
harness.tick()
|
|
109
|
+
nodes = harness.render(h(Button, {}))
|
|
110
|
+
assert.ok(peekOf(nodes), '延时到点后才出现')
|
|
111
|
+
})
|
|
112
|
+
|
|
113
|
+
test('悬停:延时到点后浮层出现,并去拉列表', async () => {
|
|
114
|
+
const { exports, fetches } = boot()
|
|
115
|
+
const Button = exports.__test.makeEntryButton(() => true)
|
|
116
|
+
|
|
117
|
+
harness.reset()
|
|
118
|
+
let nodes = harness.render(h(Button, {}))
|
|
119
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
120
|
+
harness.tick() // 跑掉「延迟显示」
|
|
121
|
+
await harness.flush() // 等拉列表
|
|
122
|
+
nodes = harness.render(h(Button, {}))
|
|
123
|
+
|
|
124
|
+
const peek = peekOf(nodes)
|
|
125
|
+
assert.ok(peek, '延时到点后应出现浮层')
|
|
126
|
+
assert.equal(fetches.length, 1, '应去拉一次列表')
|
|
127
|
+
assert.match(fetches[0], /\/knit\/api\/recent/, '拉的是列表接口')
|
|
128
|
+
assert.match(fetches[0], /sessionId=s-1/, '带上当前会话')
|
|
129
|
+
})
|
|
130
|
+
|
|
131
|
+
test('悬停:浮层列出文档标题与相对时间', async () => {
|
|
132
|
+
const { exports } = boot({ docs: 3 })
|
|
133
|
+
const Button = exports.__test.makeEntryButton(() => true)
|
|
134
|
+
|
|
135
|
+
harness.reset()
|
|
136
|
+
let nodes = harness.render(h(Button, {}))
|
|
137
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
138
|
+
harness.tick()
|
|
139
|
+
await harness.flush()
|
|
140
|
+
nodes = harness.render(h(Button, {}))
|
|
141
|
+
|
|
142
|
+
const docs = byClass(nodes, 'knit-peek-doc')
|
|
143
|
+
assert.equal(docs.length, 3, '三篇都列出来')
|
|
144
|
+
assert.match(textOf(docs[0]), /文档 0/)
|
|
145
|
+
assert.equal(byClass(nodes, 'knit-peek-time').length, 3, '每篇带相对时间')
|
|
146
|
+
})
|
|
147
|
+
|
|
148
|
+
test('悬停:没有当前会话时给出空态而不是一直转圈', async () => {
|
|
149
|
+
const { exports } = boot({ current: '' })
|
|
150
|
+
const Button = exports.__test.makeEntryButton(() => true)
|
|
151
|
+
|
|
152
|
+
harness.reset()
|
|
153
|
+
let nodes = harness.render(h(Button, {}))
|
|
154
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
155
|
+
harness.tick()
|
|
156
|
+
await harness.flush()
|
|
157
|
+
nodes = harness.render(h(Button, {}))
|
|
158
|
+
|
|
159
|
+
assert.ok(peekOf(nodes), '浮层仍在')
|
|
160
|
+
assert.match(textOf(byClass(nodes, 'knit-peek-hint')[0]), /还没有/)
|
|
161
|
+
})
|
|
162
|
+
|
|
163
|
+
/* ── 离开收起 ───────────────────────────────────────── */
|
|
164
|
+
|
|
165
|
+
test('离开:延迟收起,鼠标移进浮层可取消', async () => {
|
|
166
|
+
const { exports } = boot()
|
|
167
|
+
const Button = exports.__test.makeEntryButton(() => true)
|
|
168
|
+
|
|
169
|
+
harness.reset()
|
|
170
|
+
let nodes = harness.render(h(Button, {}))
|
|
171
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
172
|
+
harness.tick()
|
|
173
|
+
await harness.flush()
|
|
174
|
+
nodes = harness.render(h(Button, {}))
|
|
175
|
+
assert.ok(peekOf(nodes), '先显示出来')
|
|
176
|
+
|
|
177
|
+
// 离开按钮 → 排一个收起延时
|
|
178
|
+
anchorOf(nodes).props.onMouseLeave()
|
|
179
|
+
// 还没到点,鼠标移进浮层 → 取消收起
|
|
180
|
+
peekOf(nodes).props.onMouseEnter()
|
|
181
|
+
harness.tick()
|
|
182
|
+
nodes = harness.render(h(Button, {}))
|
|
183
|
+
assert.ok(peekOf(nodes), '移进浮层后不该被收起')
|
|
184
|
+
|
|
185
|
+
// 真正离开浮层
|
|
186
|
+
peekOf(nodes).props.onMouseLeave()
|
|
187
|
+
harness.tick()
|
|
188
|
+
nodes = harness.render(h(Button, {}))
|
|
189
|
+
assert.equal(peekOf(nodes), undefined, '离开后应收起')
|
|
190
|
+
})
|
|
191
|
+
|
|
192
|
+
/* ── 点击 ───────────────────────────────────────────── */
|
|
193
|
+
|
|
194
|
+
test('点击按钮:收起浮层并打开面板', async () => {
|
|
195
|
+
const { exports } = boot()
|
|
196
|
+
const opened = []
|
|
197
|
+
const Button = exports.__test.makeEntryButton(() => { opened.push(1); return true })
|
|
198
|
+
|
|
199
|
+
harness.reset()
|
|
200
|
+
let nodes = harness.render(h(Button, {}))
|
|
201
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
202
|
+
harness.tick()
|
|
203
|
+
await harness.flush()
|
|
204
|
+
nodes = harness.render(h(Button, {}))
|
|
205
|
+
|
|
206
|
+
let prevented = false
|
|
207
|
+
let stopped = false
|
|
208
|
+
buttonOf(nodes).props.onClick({ preventDefault() { prevented = true }, stopPropagation() { stopped = true } })
|
|
209
|
+
|
|
210
|
+
nodes = harness.render(h(Button, {}))
|
|
211
|
+
assert.equal(peekOf(nodes), undefined, '点击后浮层应收起')
|
|
212
|
+
assert.equal(opened.length, 1, '应打开面板')
|
|
213
|
+
assert.equal(prevented, true)
|
|
214
|
+
assert.equal(stopped, true)
|
|
215
|
+
})
|
|
216
|
+
|
|
217
|
+
test('点击浮层里的某一篇:打开面板并记住要预览哪一篇', async () => {
|
|
218
|
+
const { exports } = boot({ docs: 3 })
|
|
219
|
+
const opened = []
|
|
220
|
+
const Button = exports.__test.makeEntryButton(() => { opened.push(1); return true })
|
|
221
|
+
|
|
222
|
+
harness.reset()
|
|
223
|
+
let nodes = harness.render(h(Button, {}))
|
|
224
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
225
|
+
harness.tick()
|
|
226
|
+
await harness.flush()
|
|
227
|
+
nodes = harness.render(h(Button, {}))
|
|
228
|
+
|
|
229
|
+
byClass(nodes, 'knit-peek-doc')[1].props.onClick() // 点第二篇
|
|
230
|
+
|
|
231
|
+
nodes = harness.render(h(Button, {}))
|
|
232
|
+
assert.equal(peekOf(nodes), undefined, '点完应收起浮层')
|
|
233
|
+
assert.equal(opened.length, 1, '应打开面板')
|
|
234
|
+
|
|
235
|
+
// pendingPreviewRel 是模块内状态,KnitBody 首次拉到列表后会消费它。
|
|
236
|
+
// 这里直接验证「消费」这一半:
|
|
237
|
+
const { KnitBody } = exports.__test
|
|
238
|
+
harness.reset()
|
|
239
|
+
let panel = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
240
|
+
await harness.flush()
|
|
241
|
+
panel = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
242
|
+
assert.ok(byExactClass(panel, 'knit-preview').length === 1, '面板应直接展开那一篇的预览')
|
|
243
|
+
})
|
|
244
|
+
|
|
245
|
+
test('点击浮层里的某一篇:只消费一次,不粘住下一次打开', async () => {
|
|
246
|
+
const { exports } = boot({ docs: 3 })
|
|
247
|
+
const Button = exports.__test.makeEntryButton(() => true)
|
|
248
|
+
const { KnitBody } = exports.__test
|
|
249
|
+
|
|
250
|
+
harness.reset()
|
|
251
|
+
let nodes = harness.render(h(Button, {}))
|
|
252
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
253
|
+
harness.tick()
|
|
254
|
+
await harness.flush()
|
|
255
|
+
nodes = harness.render(h(Button, {}))
|
|
256
|
+
|
|
257
|
+
byClass(nodes, 'knit-peek-doc')[0].props.onClick()
|
|
258
|
+
|
|
259
|
+
// 第一次:应展开
|
|
260
|
+
harness.reset()
|
|
261
|
+
let first = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
262
|
+
await harness.flush()
|
|
263
|
+
first = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
264
|
+
assert.equal(byExactClass(first, 'knit-preview').length, 1)
|
|
265
|
+
|
|
266
|
+
// 第二次开面板:不该又自动展开
|
|
267
|
+
harness.reset()
|
|
268
|
+
let second = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
269
|
+
await harness.flush()
|
|
270
|
+
second = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
271
|
+
assert.equal(byExactClass(second, 'knit-preview').length, 0, 'pendingPreviewRel 应已被消费掉')
|
|
272
|
+
})
|
|
273
|
+
|
|
274
|
+
test('浮层:没有可用宿主时点击也不抛错', async () => {
|
|
275
|
+
const { exports } = boot()
|
|
276
|
+
const Button = exports.__test.makeEntryButton(() => false)
|
|
277
|
+
|
|
278
|
+
harness.reset()
|
|
279
|
+
let nodes = harness.render(h(Button, {}))
|
|
280
|
+
anchorOf(nodes).props.onMouseEnter()
|
|
281
|
+
harness.tick()
|
|
282
|
+
await harness.flush()
|
|
283
|
+
nodes = harness.render(h(Button, {}))
|
|
284
|
+
|
|
285
|
+
assert.doesNotThrow(() => buttonOf(nodes).props.onClick({ preventDefault() {}, stopPropagation() {} }))
|
|
286
|
+
})
|
|
287
|
+
|
|
288
|
+
/* ── 即时响应(这次修复的核心)────────────────────── */
|
|
289
|
+
|
|
290
|
+
test('即时响应:面板已挂着时,点浮层某篇立刻展开预览,不等列表也不等轮询', async () => {
|
|
291
|
+
const { exports } = boot({ docs: 3 })
|
|
292
|
+
const { KnitBody, requestPreview } = exports.__test
|
|
293
|
+
|
|
294
|
+
// 列表接口**永远不返回**(模拟慢扫描);文档接口正常。
|
|
295
|
+
// 旧实现要等 load() 把列表拉回来才消费目标,这里就能复现「卡几秒」。
|
|
296
|
+
globalThis.fetch = (url) => (String(url).includes('/api/doc')
|
|
297
|
+
? Promise.resolve({ json: async () => ({ ok: true, rel: 'target.md', title: '目标', text: '# 目标', truncated: false }) })
|
|
298
|
+
: new Promise(() => {}))
|
|
299
|
+
|
|
300
|
+
harness.reset()
|
|
301
|
+
let panel = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
302
|
+
await harness.flush() // 订阅建立;列表请求挂住不返回
|
|
303
|
+
panel = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
304
|
+
assert.equal(byExactClass(panel, 'knit-preview').length, 0, '此时还没有预览')
|
|
305
|
+
|
|
306
|
+
requestPreview({ rel: 'target.md', title: '目标' }) // 等价于点浮层里那一篇
|
|
307
|
+
panel = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
308
|
+
assert.equal(byExactClass(panel, 'knit-preview').length, 1, '不等列表就该展开')
|
|
309
|
+
|
|
310
|
+
await harness.flush() // 只等文档接口
|
|
311
|
+
panel = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
312
|
+
assert.match(textOf(byExactClass(panel, 'knit-preview')[0]), /目标/, '正文应已渲染')
|
|
313
|
+
})
|
|
314
|
+
|
|
315
|
+
test('即时响应:面板还没挂时,信号留成挂起值,挂载第一帧就取走', async () => {
|
|
316
|
+
const { exports } = boot({ docs: 3 })
|
|
317
|
+
const { KnitBody, requestPreview } = exports.__test
|
|
318
|
+
|
|
319
|
+
// 面板还没挂(用户从没开过),此时先来一次请求
|
|
320
|
+
requestPreview({ rel: 'queued.md', title: '排队的目标' })
|
|
321
|
+
|
|
322
|
+
globalThis.fetch = (url) => (String(url).includes('/api/doc')
|
|
323
|
+
? Promise.resolve({ json: async () => ({ ok: true, rel: 'queued.md', title: '排队的目标', text: '# 排队的目标', truncated: false }) })
|
|
324
|
+
: Promise.resolve({ json: async () => listPayload(3) }))
|
|
325
|
+
|
|
326
|
+
harness.reset()
|
|
327
|
+
let panel = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
328
|
+
await harness.flush()
|
|
329
|
+
panel = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
330
|
+
assert.equal(byExactClass(panel, 'knit-preview').length, 1, '挂载后应自动展开挂起的那一篇')
|
|
331
|
+
|
|
332
|
+
// 挂起值只消费一次
|
|
333
|
+
harness.reset()
|
|
334
|
+
let again = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
335
|
+
await harness.flush()
|
|
336
|
+
again = harness.render(h(KnitBody, { sessionId: 's-1' }))
|
|
337
|
+
assert.equal(byExactClass(again, 'knit-preview').length, 0, '不该粘住')
|
|
338
|
+
})
|