dsh-knit 0.17.0 → 0.18.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/test/harness.mjs CHANGED
@@ -72,7 +72,10 @@ export function loadClientModule(options = {}) {
72
72
  // 右栏一起删除(2026-09-29)。名字留在这里,模块一加载就 ReferenceError ——
73
73
  // 这个替身是**只增不减**的重灾区,删功能时记得同步删名字。
74
74
  + 'MIN_RATIO, MAX_RATIO, ALL_DOC_CAP, MEDIA_MAX_ITEMS, MEDIA_TRACK_PX, '
75
- + 'MEDIA_LABEL_MIN_PX, MEDIA_GAP_PX }\n'
75
+ + 'MEDIA_LABEL_MIN_PX, MEDIA_GAP_PX, '
76
+ // v0.18 Context Usage Lens:纯函数与阈值(渲染层的东西仍走 DOM 断言)。
77
+ + 'LIFE_GLYPH, lifeStatusOf, coverageOf, groupOutsideDocs, groupDelta, '
78
+ + 'COMPACT_PANEL_PX, MAX_OUTSIDE_SHOWN, MAX_DELTA_SHOWN, MAX_DELTA_GROUP, FLASH_MS }\n'
76
79
  + " module.exports.inject = ['slots', 'locale']",
77
80
  )
78
81
 
@@ -6,7 +6,7 @@
6
6
  import test from 'node:test'
7
7
  import assert from 'node:assert/strict'
8
8
 
9
- import { loadClientModule, createHarness, byClass, textOf, makeLocale } from './harness.mjs'
9
+ import { loadClientModule, createHarness, byClass, byExactClass, textOf, makeLocale } from './harness.mjs'
10
10
 
11
11
  const harness = createHarness()
12
12
  const React = globalThis.__knitReact
@@ -435,6 +435,169 @@ test('守卫:英文环境下无障碍与提示属性里也没有汉字', async
435
435
  assert.deepEqual(bad, [], `英文环境的属性里混进了中文:${bad.join(' / ')}`)
436
436
  })
437
437
 
438
+ /* ── v0.18 Usage Lens:英文渲染里也不许有汉字 ───────────────
439
+ ⚠️ 上面那两条守卫用的是 `timePayload()` —— **它没有 usage**,所以 Lens 整块
440
+ 一个节点都没渲染。也就是说 v0.18 新增的几十条 Lens 文案(含挂在 `title` /
441
+ `aria-label` 上的)**不在那两条守卫的覆盖里**:JSX 里如果漏了 `t()`,
442
+ 它们照样全绿。下面这两条把 Lens 真的打开再查一遍。 */
443
+
444
+ /**
445
+ * v0.18 Usage Lens 的**英文语料**(全部 ASCII)。
446
+ *
447
+ * ⚠️ 与 `timePayload` 同一条规矩:标题 / 主题 / 摘要都是**数据**,
448
+ * 混进中文会被守卫误报成「文案漏了 t()」。
449
+ * 覆盖面:三块内容全在 —— Coverage 三层、最近读取、包外 12 篇(→「还有 2 篇」)、
450
+ * 变化 6 条(→「还有 3 条」,且 `taskChanged` 为真);生命周期四态齐全。
451
+ *
452
+ * @returns {object} 载荷
453
+ */
454
+ function lensPayload() {
455
+ const at = Date.now()
456
+ const item = (rel, title) => ({
457
+ rel, path: `/p/${rel}`, name: rel.split('/').pop(), title,
458
+ summary: 's', mtimeMs: at, kind: 'md', source: 'doc',
459
+ reason: { code: 'titleMatch', terms: ['bm25'], fields: 1 },
460
+ })
461
+ const delta = {
462
+ appeared: [{ rel: 'docs/new-a.md', tier: 'primary', rank: 2 },
463
+ { rel: 'docs/new-b.md', tier: 'related', rank: 3 }],
464
+ disappeared: [{ rel: 'docs/gone-a.md', tier: 'related', rank: 4 },
465
+ { rel: 'docs/gone-b.md', tier: 'related', rank: 5 }],
466
+ moved: [{ rel: 'docs/moved.md', from: 'supporting', to: 'related' }],
467
+ taskChanged: true,
468
+ }
469
+ return {
470
+ ok: true, root: '/p', total: 4, mode: 'relevance', topic: 'bm25 ranking', keywords: ['bm25'],
471
+ docs: [item('docs/algo.md', 'Algo'), item('docs/eval.md', 'Eval'),
472
+ item('CHANGELOG.md', 'Changelog'), item('README.md', 'Knit')],
473
+ context: {
474
+ mode: 'relevance', topic: 'bm25 ranking', task: '',
475
+ primary: [item('docs/algo.md', 'Algo')],
476
+ supporting: [item('docs/eval.md', 'Eval'), item('CHANGELOG.md', 'Changelog')],
477
+ related: [item('README.md', 'Knit'), item('out/doc-0.md', 'Out')],
478
+ },
479
+ usage: {
480
+ at, epochId: 4,
481
+ stats: {
482
+ reads: 7, distinct: 3, outside: 12, outsideReads: [],
483
+ firstReadTier: 'primary', firstReadRel: 'docs/algo.md', firstReadAt: 1,
484
+ primaryRel: 'docs/algo.md', primaryFollowThrough: true,
485
+ byTier: {
486
+ primary: { total: 1, read: 1 },
487
+ supporting: { total: 2, read: 1 },
488
+ related: { total: 2, read: 0 },
489
+ },
490
+ supportingCoverage: 0.5,
491
+ churn: { snapshots: 5, deltas: 4, retained: 4, appeared: 2, disappeared: 2, moved: 1, taskChanged: 1 },
492
+ },
493
+ delta, latestDelta: delta,
494
+ recentRead: { rel: 'docs/eval.md', at, seq: 42, epochId: 4, tier: 'supporting', rank: 2, inside: true },
495
+ outsideDocs: Array.from({ length: 12 }, (_, i) => ({
496
+ rel: `out/doc-${i}.md`, count: 12 - i, lastReadAt: i, seq: i,
497
+ })),
498
+ lifecycle: {
499
+ 'docs/algo.md': { status: 'read', count: 3, lastReadAt: 1 },
500
+ 'docs/eval.md': { status: 'reread_after_update', count: 2, lastReadAt: 2 },
501
+ 'CHANGELOG.md': { status: 'updated_after_read', count: 1, lastReadAt: 3 },
502
+ 'README.md': { status: 'unread', count: 0, lastReadAt: 0 },
503
+ // ⚠️ 包外那 12 篇在真实载荷里**每一篇都有 read 记录**(左右两栏同源)。
504
+ // 只给第一篇的话,守卫语料会自相矛盾:左边写 `×11`、右边写 `Unread`。
505
+ ...Object.fromEntries(Array.from({ length: 12 }, (_, i) => [
506
+ `out/doc-${i}.md`, { status: 'read', count: 12 - i, lastReadAt: i },
507
+ ])),
508
+ },
509
+ },
510
+ }
511
+ }
512
+
513
+ /**
514
+ * 把 Usage Lens **打开**(数据到位后再点,与真实用法一致),返回渲染出的节点。
515
+ * @param {string} locale - 活动语言
516
+ * @param {object} payload - 宿主载荷
517
+ * @returns {Promise<{nodes: object[], render: Function}>} 节点与重渲染
518
+ */
519
+ async function mountLens(locale, payload) {
520
+ installFetch(() => payload)
521
+ const { exports } = boot(locale)
522
+ const { KnitBody } = exports.__test
523
+ harness.reset()
524
+ const render = () => harness.render(h(KnitBody, { sessionId: 's1' }))
525
+ render()
526
+ await harness.flush()
527
+ render()
528
+ await harness.flush()
529
+ const toggle = byExactClass(render(), 'knit-btn').find((n) => textOf(n) === 'Usage')
530
+ assert.ok(toggle, '英文头部必须有 Usage 按钮')
531
+ toggle.props.onClick()
532
+ await harness.flush()
533
+ render()
534
+ await harness.flush()
535
+ return { nodes: render(), render }
536
+ }
537
+
538
+ /**
539
+ * 收集一棵树里所有 `title` / `aria-label` 之类的**文案属性**。
540
+ * @param {object[]} nodes - 扁平节点
541
+ * @returns {string[]} 属性值
542
+ */
543
+ function attrTexts(nodes) {
544
+ const attrs = ['aria-label', 'title', 'placeholder', 'alt']
545
+ const out = []
546
+ for (const n of nodes) {
547
+ for (const a of attrs) {
548
+ const v = n.props[a]
549
+ if (typeof v === 'string' && v) out.push(`${a}="${v}"`)
550
+ }
551
+ }
552
+ return out
553
+ }
554
+
555
+ test('守卫:英文环境下打开的 Usage Lens 里也没有汉字(文字 + title / aria-label)', async () => {
556
+ const { nodes: closed, render } = await mountLens('en', lensPayload())
557
+
558
+ // 折叠态先查一遍:`+3 more`(`usage.deltaMore`)只在折叠时出现(展开=明细全列,不再有尾巴)
559
+ const closedText = ownTexts(closed).join(' | ')
560
+ assert.ok(closedText.includes('+3 more'), `折叠态少了「+3 more」:${closedText}`)
561
+ assert.deepEqual(cjkIn(ownTexts(closed)), [], '英文折叠态 Lens 的文字里混进了中文')
562
+ assert.deepEqual(cjkIn(attrTexts(closed)), [], '英文折叠态 Lens 的属性里混进了中文')
563
+
564
+ // 两块集合默认折叠 —— 先把它们点开,否则那几条文案根本没进渲染树
565
+ for (const btn of byExactClass(closed, 'knit-more-btn')) btn.props.onClick()
566
+ const nodes = render()
567
+ const text = ownTexts(nodes).join(' | ')
568
+
569
+ // ⚠️ 先证明 Lens **真的渲染了**:找不到锚点就意味着下面是「空转绿灯」
570
+ for (const anchor of ['Usage', 'Epoch 4', 'Current context', 'Recent read',
571
+ 'Reads outside context', 'Context changes', 'Entered', 'Left', 'Moved tier',
572
+ 'Task context updated', '2 more']) {
573
+ assert.ok(text.includes(anchor), `英文 Lens 少了「${anchor}」:${text}`)
574
+ }
575
+
576
+ assert.deepEqual(cjkIn(ownTexts(nodes)), [], '英文 Usage Lens 的文字里混进了中文')
577
+ const bad = cjkIn(attrTexts(nodes))
578
+ assert.deepEqual(bad, [], `英文 Usage Lens 的属性里混进了中文:${bad.join(' / ')}`)
579
+ })
580
+
581
+ test('守卫:英文环境下**空**的 Usage Lens 里也没有汉字', async () => {
582
+ const payload = lensPayload()
583
+ const u = payload.usage
584
+ u.stats.reads = 0
585
+ u.stats.outside = 0
586
+ u.stats.churn.snapshots = 0
587
+ u.delta = null
588
+ u.latestDelta = null
589
+ u.recentRead = null
590
+ u.outsideDocs = []
591
+ u.lifecycle = {}
592
+
593
+ const { nodes } = await mountLens('en', payload)
594
+ const text = ownTexts(nodes).join(' | ')
595
+ assert.ok(text.includes('Nothing yet'), `空态少了「Nothing yet」:${text}`)
596
+ assert.ok(text.includes('0 reads'), `空态也要报事实(0 reads):${text}`)
597
+ assert.deepEqual(cjkIn(ownTexts(nodes)), [], '英文空 Lens 的文字里混进了中文')
598
+ assert.deepEqual(cjkIn(attrTexts(nodes)), [], '英文空 Lens 的属性里混进了中文')
599
+ })
600
+
438
601
  test('守卫:相对时间的六个分支都随语言(原来是硬编码中文)', async () => {
439
602
  const en = await renderPanel('en', () => timePayload())
440
603
  const enTimes = byClass(en.nodes, 'knit-time').map(textOf)
@@ -526,23 +689,43 @@ test('i18n: 宿主的每个 Context Pack 理由码都有中英译文', async ()
526
689
 
527
690
  /* ── v0.17 文档生命周期:数据层英文,界面按语言映射 ─────────────────── */
528
691
 
529
- test('词典:v0.17 的十六条生命周期 / 变化文案中英都对得上', () => {
692
+ test('词典:v0.18 的 Usage Lens / 生命周期文案中英都对得上', () => {
530
693
  const { registered } = boot('zh')
531
694
  const { zh, en } = registered.knit
532
695
 
533
696
  // 状态值本身在数据层是英文(unread / read / ...),中文只活在词典里(SDD §15.4)
534
697
  const expected = {
535
- 'usage.recentRead': ['最近读取:{rel} · {time}', 'Recently read: {rel} · {time}'],
536
- 'usage.outsideDocs': ['上下文外读取 · {n} 篇', 'Read outside the pack · {n}'],
537
- 'usage.deltaTitle': ['上下文刚刚变化', 'Context just changed'],
538
698
  'usage.deltaEnter': ['进入', 'Entered'],
539
699
  'usage.deltaLeave': ['离开', 'Left'],
540
700
  'usage.deltaMove': ['换层', 'Moved tier'],
541
701
  'usage.deltaTask': ['任务上下文已更新', 'Task context updated'],
542
702
  'usage.deltaMore': ['还有 {n} 条', '+{n} more'],
703
+ // v0.18 Usage Lens:标题 / 摘要行 / 三块内容
704
+ 'lens.title': ['使用情况', 'Usage'],
705
+ 'lens.expand': ['展开使用情况', 'Expand usage'],
706
+ 'lens.collapse': ['收起使用情况', 'Collapse usage'],
707
+ 'lens.epoch': ['Epoch {n}', 'Epoch {n}'],
708
+ 'lens.reads': ['{n} 次读取', '{n} reads'],
709
+ 'lens.outside': ['{n} 篇包外', '{n} outside the pack'],
710
+ 'lens.changes': ['上下文变化 {n} 次', 'context changed {n}×'],
711
+ 'lens.currentContext': ['当前上下文', 'Current context'],
712
+ 'lens.recentRead': ['最近读取', 'Recent read'],
713
+ 'lens.recentNone': ['暂无记录', 'Nothing yet'],
714
+ 'lens.outsideDocs': ['上下文外读取', 'Reads outside context'],
715
+ 'lens.more': ['还有 {n} 篇', '{n} more'],
716
+ 'lens.openDoc': ['打开 {rel}', 'Open {rel}'],
717
+ 'lens.delta': ['上下文变化', 'Context changes'],
718
+ 'lens.locate': ['定位到{tier}上下文', 'Locate {tier} context'],
719
+ // v0.18 UI 迭代新增:读屏专用的一句(视觉上不显示)+ 变化行右侧的「最近一次」
720
+ 'lens.coverageAria': ['{tier}上下文:{read} / {total} 篇已读', '{tier} context: {read} / {total} read'],
721
+ 'lens.deltaLatest': ['最近一次', 'Latest'],
722
+ // 类型页签 +「全部」分区标题(2026-10-06 用户定:原「图片与视频」→「媒体」;英文随
723
+ // count.media 走成 Media)。钉住它是因为这一个键同时管页签与分区标题,改一处就两处变。
724
+ 'kind.media': ['媒体', 'Media'],
543
725
  'lifecycle.unread': ['未读', 'Unread'],
544
726
  'lifecycle.read': ['已读', 'Read'],
545
727
  'lifecycle.readCount': ['已读 ×{n}', 'Read ×{n}'],
728
+ 'lifecycle.readCountShort': ['×{n}', '×{n}'],
546
729
  'lifecycle.updatedAfterRead': ['读后已更新', 'Updated after read'],
547
730
  'lifecycle.rereadAfterUpdate': ['修改后已重新读取', 'Re-read after update'],
548
731
  'tierName.primary': ['主要', 'Primary'],