xrkh-better-sidebar 0.18.27 → 0.18.29

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.
Files changed (57) hide show
  1. package/README.md +21 -1
  2. package/README_EN.md +9 -1
  3. package/lib/client-editor.js +375 -204
  4. package/lib/client-mermaid.js +337 -200
  5. package/lib/client-registry.js +953 -386
  6. package/lib/client-terminal.js +355 -200
  7. package/lib/client.js +957 -390
  8. package/lib/index.js +359 -8
  9. package/lib/types/client/TreePanel.d.ts +13 -2
  10. package/lib/types/client/api.d.ts +42 -1
  11. package/lib/types/client/editor-load.d.ts +27 -0
  12. package/lib/types/client/intercept.d.ts +6 -2
  13. package/lib/types/client/lang.d.ts +2 -0
  14. package/lib/types/client/locales.d.ts +1 -0
  15. package/lib/types/client/produced-files.d.ts +8 -0
  16. package/lib/types/client/service.d.ts +1 -1
  17. package/lib/types/client/tree-watch.d.ts +95 -0
  18. package/lib/types/fs-watch.d.ts +75 -0
  19. package/lib/types/map-bounded.d.ts +22 -0
  20. package/lib/types/wire.d.ts +24 -0
  21. package/package.json +1 -1
  22. package/src/client/EditorHost.tsx +95 -15
  23. package/src/client/FileTree.tsx +50 -6
  24. package/src/client/Sidebar.tsx +11 -1
  25. package/src/client/TreePanel.tsx +16 -4
  26. package/src/client/api.ts +63 -3
  27. package/src/client/editor-load.ts +38 -2
  28. package/src/client/intercept.tsx +27 -3
  29. package/src/client/lang.ts +23 -1
  30. package/src/client/locales-ar.ts +7 -0
  31. package/src/client/locales-de.ts +7 -0
  32. package/src/client/locales-fr.ts +7 -0
  33. package/src/client/locales-hi.ts +7 -0
  34. package/src/client/locales-id.ts +7 -0
  35. package/src/client/locales-it.ts +7 -0
  36. package/src/client/locales-ja.ts +7 -0
  37. package/src/client/locales-ko.ts +7 -0
  38. package/src/client/locales-nl.ts +7 -0
  39. package/src/client/locales-pl.ts +7 -0
  40. package/src/client/locales-pt.ts +7 -0
  41. package/src/client/locales-ru.ts +7 -0
  42. package/src/client/locales-sv.ts +7 -0
  43. package/src/client/locales-th.ts +7 -0
  44. package/src/client/locales-tr.ts +7 -0
  45. package/src/client/locales-vi.ts +7 -0
  46. package/src/client/locales-zh-HK.ts +7 -0
  47. package/src/client/locales-zh-MO.ts +7 -0
  48. package/src/client/locales-zh-TW.ts +7 -0
  49. package/src/client/locales.ts +2 -0
  50. package/src/client/produced-files.ts +27 -0
  51. package/src/client/service.ts +1 -1
  52. package/src/client/sidebar.module.css +22 -0
  53. package/src/client/tree-watch.ts +325 -0
  54. package/src/fs-watch.ts +245 -0
  55. package/src/index.ts +139 -5
  56. package/src/map-bounded.ts +41 -0
  57. package/src/wire.ts +44 -0
package/README.md CHANGED
@@ -10,7 +10,7 @@ Host 侧 `/sidebar/*` 由产品 Host 原生挂载(`createSidebarPublicHandler`
10
10
  前置:`xrkh web` 或 `npx @xrkseek/harness-cli web`,Node ≥ 26。建议 Host **≥ 0.3.4**。推荐从 **npmjs** 安装:
11
11
 
12
12
  ```bash
13
- xrkh plugin add xrkh-better-sidebar@0.18.27
13
+ xrkh plugin add xrkh-better-sidebar@0.18.29
14
14
  xrkh restart
15
15
  ```
16
16
 
@@ -18,6 +18,26 @@ xrkh restart
18
18
 
19
19
  源码路径仍可用(非推荐):`git clone git@github.com:xrkseek/xrkh-better-sidebar.git` 后 `xrkh plugin add ./xrkh-better-sidebar`。
20
20
 
21
+ ## 0.18.29
22
+
23
+ - 修复对话尾部文件行整个 slot 渲染崩溃(`Cannot read properties of undefined (reading 'modified')`)。**0.18.27 回归**:三条 lane 改造时把组件 prop 从宿主契约名 `matched` 改成了 `lanes`;ui-slots chain 始终把 selector 返回值注入为 `matched`(`ChainEntryProps`),同槽的 `@xrkseek/client-ui-deliverables` 也按 `matched` 读。改名后组件拿到 `undefined`
24
+ - 组件侧:只认 `matched`;用 `isFileLanes` 校验形状;缺失/坏形状时从宿主一并展开的 owner 字段重算 lanes,不再直接读 `.modified`
25
+ - 与宿主 Diff 卡共存:本轮已有 `workspace/changes` 卡时(按 closing `seq`,对齐宿主 `changesForClosing`)主动放弃 takeover,避免盖住 ChangedFiles;文件打开仍走 `workspaces.openPath` 拦截
26
+ - 测例钉住「select 输出 → 宿主 prop 名 `matched` → 组件消费」整条边界(此前只断言注册元数据,改错名字也会绿灯)
27
+ - 文件树:活动页心跳 1.2s→4s、隐藏 6s→12s;保存后 `nudgeTreeWatch` 立即拉一轮,少无感狂刷
28
+
29
+ ## 0.18.28
30
+
31
+ - 文件树增量自动刷新:AI 建/改/删文件后,已展开的树无感更新。Host 侧新增按 `sessionId` + 目录管理的非递归 `fs.watch` registry(per-subscriber 引用计数、单调 sequence + 有界 replay、watcher 失效自动重开),配 `fs.watch.sync`(只回「哪几层变了」+ 游标)与 `fs.tree.batch`(批量 listing + 可选 `statPaths`)
32
+ - 客户端共享 watch broker:同一会话/cwd 的文件树与多个编辑器合并成一份订阅与一轮请求;活动页 ~1.2s、隐藏页 ~6s、失败退避 4s;健康时每 20 轮全量 sweep,有不可监听目录时 5 轮
33
+ - 刷新语义:只替换真正变化的已加载层(`levelSignature` 比对,相同则跳过 setState),不显示 loading、不调 `refreshTick`、不物化未展开目录、不动展开/搜索/滚动/拖拽状态
34
+ - 打开中文件的外部修改:`mtimeMs` 贯穿 `fs.read` → 渲染 → baseline;内容 clean 时静默重载,dirty 时绝不覆盖草稿,显示「文件已被外部修改,草稿未覆盖」提示条与刷新按钮;无 baseline 的 viewer 不循环重载
35
+ - 修复:`fs.tree.batch` 的 listing/stat 回显改为调用方传入的原始路径(此前回显 Host 解析后的 realpath——symlink workspace root、Windows 大小写或分隔符规范化下,客户端的层级 key 与 stat 行会永久匹配不上,树看起来「不再刷新」)
36
+ - 点击卡顿(静态定位):`TreePanel` 加 memo 渲染边界、树回调 `useCallback` 稳定化、`FileTree` 单次 `setData` 批量提交(原为逐层提交)、CodeMirror 语言包按语言 key 缓存
37
+ - 测试环境:`vitest.config.ts` 加 `resolve.dedupe: ['react', 'react-dom']`(插件与宿主根各装一份 React,经 `client-ui-primitives` 跨界渲染时全部 UI 测试死于 `Invalid hook call`)
38
+ - i18n:19 个语言字典补齐 7 个漏键(`fileChangedOnDisk` / `laneModified` / `laneDeleted` / 四个 `viewer*`)
39
+ - 冗余清理:删除无消费者的 `onDegraded` 钩子、`mergeLevel` 导出与重复的 `messageOf`;`locales.spec.ts` 里测 0.18.0 已删除的 `attachBetterLocale` 覆盖层协议的残留一并清掉
40
+
21
41
  ## 0.18.27
22
42
 
23
43
  - 对话尾部文件行:按「本次改动 / 本次删除 / 本次产出」三条 lane 渲染(此前只有一条「本次产出」,改动与删除被丢弃)
package/README_EN.md CHANGED
@@ -10,7 +10,7 @@ Host mounts `/sidebar/*` natively (`createSidebarPublicHandler`); this package s
10
10
  Requires `xrkh web` or `npx @xrkseek/harness-cli web`, Node ≥ 26. Prefer Host **≥ 0.3.4**. Install from **npmjs**:
11
11
 
12
12
  ```bash
13
- xrkh plugin add xrkh-better-sidebar@0.18.27
13
+ xrkh plugin add xrkh-better-sidebar@0.18.29
14
14
  xrkh restart
15
15
  ```
16
16
 
@@ -18,6 +18,14 @@ Hard-refresh the browser after install (Ctrl+Shift+R).
18
18
 
19
19
  Source path still works (not preferred): `git clone git@github.com:xrkseek/xrkh-better-sidebar.git` then `xrkh plugin add ./xrkh-better-sidebar`.
20
20
 
21
+ ## 0.18.29
22
+
23
+ - Fix turn-tail slot crash (`Cannot read properties of undefined (reading 'modified')`). **0.18.27 regression**: the three-lane refactor renamed the component prop from the host contract name `matched` to `lanes`; ui-slots chain always injects the selector result as `matched` (`ChainEntryProps`), and `@xrkseek/client-ui-deliverables` reads `matched` too
24
+ - Component: accept only `matched`; validate with `isFileLanes`; if missing/bad shape, re-derive lanes from owner fields the host also spreads onto the seat — never read `.modified` on undefined
25
+ - Coexist with the host Diff card: decline takeover when this closing `seq` already has a `workspace/changes` card (same bound as host `changesForClosing`); file opens still use `workspaces.openPath` interception
26
+ - Tests pin the full edge `select output → host prop name matched → component`
27
+ - File tree: active heartbeat 1.2s→4s, hidden 6s→12s; `nudgeTreeWatch` after save so the tree updates without silent churn
28
+
21
29
  ## 0.18.27
22
30
 
23
31
  - Conversation tail file rows: render three lanes (modified / deleted / created); before, one flat "Produced" row swallowed edits and deletions