dsh-knit 0.24.0 → 0.25.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/CHANGELOG.md +60 -0
- package/README.en.md +2 -2
- package/README.md +7 -5
- package/SECURITY.md +7 -2
- package/package.json +2 -2
- package/src/client/client.js +1147 -22
- package/src/host/attachments.js +245 -0
- package/src/host/index.js +131 -1
- package/test/attachments.test.mjs +285 -0
- package/test/client.test.mjs +1075 -7
- package/test/harness.mjs +12 -0
- package/test/index-incremental.test.mjs +13 -2
package/test/harness.mjs
CHANGED
|
@@ -99,6 +99,18 @@ export function loadClientModule(options = {}) {
|
|
|
99
99
|
// (归一化 + 取针)在这里;DOM 那半(`docAnchorHit` / `docBlockElement`)
|
|
100
100
|
// 需要真 document,走真机验证,不进这个替身。
|
|
101
101
|
+ 'docNeedleText, docAnchorNeedles, docPickOffset, scrollToDocAnchor, DocPane, '
|
|
102
|
+
// v0.25 预览里的查找:与上面同一条分界线 —— **纯函数那半**(匹配 / 下标映射 / 环形步进)
|
|
103
|
+
// 在这里,能被真断言钉住;DOM 那半(paintFindMarks / clearFindMarks / scrollMarkIntoView)
|
|
104
|
+
// 需要真 document,也一并导出但只在真机上验。
|
|
105
|
+
+ 'findRanges, normalizedIndexMap, stepFindIndex, paintFindMarks, clearFindMarks, scrollMarkIntoView, PreviewPanel, '
|
|
106
|
+
// v0.25 媒体收藏:全是纯函数(落盘解析 / 取某一格 / 加取消 / 稳定分区)—— 能被真断言钉住
|
|
107
|
+
+ 'parseFavorites, favoriteRelsFor, toggleFavoriteList, orderFavorites, MediaCard, FAV_KEY, '
|
|
108
|
+
// v0.25 媒体档「悬停看大图」:盒子几何是纯函数(上限 800 / 翻转 / 夹进视口都能真断言)
|
|
109
|
+
+ 'hoverShotBox, HOVER_SHOT_MAX, HOVER_SHOT_GAP, HOVER_SHOT_MARGIN, HOVER_SHOT_DELAY_MS, '
|
|
110
|
+
// v0.25 媒体档「双击全屏」:左侧带子的窗口算法是纯函数
|
|
111
|
+
+ 'lightboxRail, LIGHTBOX_RAIL, LIGHTBOX_RAIL_LEAD, '
|
|
112
|
+
+ 'mountLightbox, '
|
|
113
|
+
|
|
102
114
|
+ 'DOC_NEEDLE_CHARS, DOC_NEEDLE_MIN, DOC_NEEDLE_MAX, '
|
|
103
115
|
+ 'MOTION_ENTER_MS, MOTION_EXIT_MS, MOTION_STAGGER_MS, MOTION_STAGGER_MAX, MOTION_EASE, '
|
|
104
116
|
+ 'MOTION_MOVE_MS, MOTION_MOVE_EPS, '
|
|
@@ -182,6 +182,17 @@ test('抽验是**承重的**:同 mtime 同 size 的改写靠指纹抓得到;
|
|
|
182
182
|
const stale = async (budget) => {
|
|
183
183
|
const root = makeWorkspace([['docs/stale.md', '# 陈旧 A\n\nAAAA\n']])
|
|
184
184
|
const abs = join(root, 'docs/stale.md')
|
|
185
|
+
|
|
186
|
+
/* 🔴 「同 mtime 同 size」是这条用例的**前提**,所以 mtime 必须**按构造相等**,不能「还原」。
|
|
187
|
+
踩过的坑(连续四个版本 CI 各红一次:v0.23.0 / v0.23.1 / v0.24.0 / v0.25.0):
|
|
188
|
+
以前写 `utimesSync(abs, before.atimeMs / 1000, before.mtimeMs / 1000)` —— 浮点秒在 Linux 上
|
|
189
|
+
还原不出逐位相同的 `mtimeMs`(截断到整秒),于是「同 mtime」根本没造出来,索引走的是**正常的
|
|
190
|
+
mtime 变更路径**,指纹抽验压根没被考到。两种表现(都观测到了):
|
|
191
|
+
· 预算 8 ⇒ 不经过抽验,`repaired` 仍是 0 ⇒ `:207` 红;
|
|
192
|
+
· 预算 0 ⇒ 照样重读,拿到新内容 ⇒ `:211` 红。
|
|
193
|
+
现在把两次的 mtime 都钉成**同一个显式整数秒**(构造上必然逐位相等),断言也从 `<=1` 收紧到 `===`。 */
|
|
194
|
+
const PINNED_S = 1767225600 // 2026-01-01T00:00:00Z —— 整数秒,跨平台逐位可复现
|
|
195
|
+
utimesSync(abs, PINNED_S, PINNED_S)
|
|
185
196
|
const before = statSync(abs)
|
|
186
197
|
|
|
187
198
|
const cold = boot({ tables: {} }, { budget })
|
|
@@ -189,10 +200,10 @@ test('抽验是**承重的**:同 mtime 同 size 的改写靠指纹抓得到;
|
|
|
189
200
|
await cold.store.flush()
|
|
190
201
|
|
|
191
202
|
writeFileSync(abs, '# 陈旧 B\n\nBBBB\n') // 与上一份**等长**
|
|
192
|
-
utimesSync(abs,
|
|
203
|
+
utimesSync(abs, PINNED_S, PINNED_S) // 同一个定值 —— 不是「还原」
|
|
193
204
|
const after = statSync(abs)
|
|
194
205
|
assert.equal(after.size, before.size, '场景准备失败:两次内容不等长')
|
|
195
|
-
assert.
|
|
206
|
+
assert.equal(after.mtimeMs, before.mtimeMs, '场景准备失败:两次的 mtime 不相等(必须是同一个定值)')
|
|
196
207
|
|
|
197
208
|
boot(cold.medium, { budget }) // 「重启」
|
|
198
209
|
const out = await collectDocs(root)
|