difftab 0.1.3 → 0.2.1

package/README.md

@@ -37,14 +37,17 @@ Running it again in the same repository reuses the running instance.
 - **Diffs, lazily** — click a file to load its patch, rendered by
   [diff2html](https://diff2html.xyz/) + highlight.js in a VS Code-like theme, side by side
   until the pane gets too narrow.
+- **File tree** — a second sidebar tab browses the whole repository rather than only what
+  changed: tracked, untracked and ignored files (the ignored ones dimmed), loaded one
+  directory at a time. Click any file to read it, highlighted by the same theme.
 - **Branch status** — branch name, ahead/behind counts, "no upstream", detached HEAD, and
   an in-progress rebase / merge / cherry-pick / revert / bisect / `git am`.
 - **Auto-refresh** — a file watcher pushes changes over SSE, falling back to polling where
   recursive watching would exhaust the inotify quota (and saying so in the UI).
 - **Exits on its own** — 45 seconds after the last tab closes.
-- **Cheap to run** — about 30 ms from launch to a listening server, well inside the 300 ms
+- **Cheap to run** — about 40 ms from launch to a listening server, well inside the 300 ms
   budget CI enforces on every commit across nine Node × OS combinations; the JS bundle is
-  68 KB gzipped.
+  71 KB gzipped.
 
 Empty repositories, interrupted rebases, linked worktrees, submodules, binary and >5 MB
 files, renames, and paths with spaces, quotes, CJK or emoji are handled explicitly.

package/README.zh-CN.md

@@ -32,11 +32,12 @@ npx difftab
 
 - **变更列表**——已暂存、未暂存、未跟踪、冲突四组，未跟踪的目录展开到文件粒度。
 - **按文件懒加载的 diff**——点开某个文件才取它的补丁，渲染用 [diff2html](https://diff2html.xyz/) + highlight.js，配色仿 VS Code，面板窄到放不下两列时自动切成逐行。
+- **文件树**——侧栏第二个 tab 浏览整个仓库，而不只是改动过的那些：已跟踪、未跟踪与被忽略的文件（后者灰显），按目录懒加载。点任一文件在右侧只读查看，高亮复用同一套配色。
 - **分支状态**——当前分支、ahead/behind 计数、无上游、游离 HEAD，以及进行中的 rebase /
   merge / cherry-pick / revert / bisect / `git am`。
 - **自动刷新**——文件监听经 SSE 推到前端；递归监听会耗尽 inotify 配额的场合改用轮询，并在界面上标注。
 - **自己退出**——最后一个标签页关掉 45 秒后自动退。
-- **跑起来很轻**——从启动到端口就绪约 30ms，远在 CI 每次提交都验的 300ms 预算之内（九个 Node × 平台组合各跑一遍）；打包后的 JS gzip 68KB。
+- **跑起来很轻**——从启动到端口就绪约 40ms，远在 CI 每次提交都验的 300ms 预算之内（九个 Node × 平台组合各跑一遍）；打包后的 JS gzip 71KB。
 
 空仓库、停在中途的 rebase、linked worktree、submodule、二进制与超过 5MB 的文件、重命名，以及带空格、引号、中日韩文字或 emoji 的路径，都是被显式处理的。
 

package/bin/difftab.js

@@ -1,51 +1,43 @@
 #!/usr/bin/env node
-// difftab CLI 入口 —— 版本守卫。
+// difftab CLI 入口——版本守卫。
 //
-// 本文件手写维护,不参与 TypeScript 编译、不作为任何打包入口。
-// 一旦它进了构建管线,就可能被注入超出 Node 22 的语法或被合并进主模块,
-// 低于下限的用户拿到的将是解析期 SyntaxError —— 守卫在解析期即失效。
+// 本文件手写维护，不参与 TypeScript 编译、不作为任何打包入口：一旦它进了构建管线，就可能被
+// 注入超出 Node 22 的语法或被合并进主模块，低于下限的用户拿到的将是解析期 SyntaxError——
+// 守卫在解析期即失效。因此这里只用「保守语法」：ES2015 之内，不使用可选链 / 空值合并 /
+// 顶层 await / class 字段等更晚的语法。守卫通过后，才动态 import 主模块。
 //
-// 因此这里只用「保守语法」:ES2015 之内,不使用可选链 / 空值合并 /
-// 顶层 await / class 字段等更晚的语法。守卫通过后,才动态 import 主模块。
-//
-// `node:fs` 是**内建模块**,静态 import 它不违反上面那条 —— 守卫要防的是「解析期就
-// 炸掉」与「把主模块的新语法拖进来」,而内建模块两条都不沾,且在 Node 12 起就支持
-// `node:` 前缀。写成静态 import 而不是在分支里动态 import:那条路要么 `await`
-// (顶层 await 正是禁项),要么把报错塞进 `.then()` 回调里,而回调里的 `process.exit()`
-// 与本文件要修的问题是同一类。
+// `node:fs` 是**内建模块**，静态 import 它不违反上面那条——守卫要防的是解析期就炸掉与把
+// 主模块的新语法拖进来，而内建模块两条都不沾。写成静态 import 是因为动态那条要么 `await`
+// （顶层 await 正是禁项）、要么把报错塞进 `.then()` 回调里。
 
 import { writeSync } from 'node:fs';
 
 /**
- * 退出前的报错**一律 `writeSync(2, …)`**(红线)。
- *
- * `process.stderr.write(…)` + `process.exit()` 在 Windows 上写**管道**时是异步的,
- * 整条消息会被丢掉 —— 症状是 stderr 全空、只剩一个退出码。而**文件重定向看不出
- * 区别**(那条是同步写),所以门禁那侧必须经管道取回 stderr,见 CI 的 old-node-guard。
+ * 退出前的报错**一律 `writeSync(2, …)`**。`process.stderr.write(…)` + `process.exit()` 在
+ * Windows 上写**管道**时是异步的，整条消息会被丢掉——症状是 stderr 全空、只剩一个退出码，
+ * 而**文件重定向看不出区别**（那条是同步写），所以门禁那侧必须经管道取回 stderr。
  *
- * try/catch 是因为读端可能先走(`difftab | head -1`):此刻要报的是别的事,
- * 不该被一个 EPIPE 顶掉。
+ * try/catch 是因为读端可能先走(`difftab | head -1`)：此刻要报的是别的事，不该被 EPIPE 顶掉。
  */
 function writeStderr(message) {
   try {
     writeSync(2, message);
   } catch (_cause) {
-    // 报不出来就算了 —— 退出码仍然是对的。
-    // 绑定写成 `_cause` 而不是省略:可选 catch 绑定是 ES2019,本文件只用 ES2015
+    // 报不出来就算了——退出码仍然是对的。
+    // 绑定写成 `_cause` 而不是省略：可选 catch 绑定是 ES2019，本文件只用 ES2015
   }
 }
 
-// 下限只写一次。写成两个常量时,把 MIN_MAJOR 提到 24 却忘了改 MIN_VERSION,
-// 结果是守卫正确地拒掉 Node 22、却告诉用户「requires Node.js 22.0.0 or newer,
-// but this is v22.5.0」—— 没有任何门禁会因此变红。
-// 与 package.json 的 engines.node 对齐由冒烟测试断言。
+// 下限只写一次。写成两个常量时，把 MIN_MAJOR 提到 24 却忘了改 MIN_VERSION，结果是守卫正确
+// 地拒掉 Node 22、却告诉用户「requires Node.js 22.0.0 or newer, but this is v22.5.0」——
+// 没有任何门禁会因此变红。与 package.json 的 engines.node 对齐由冒烟测试断言
 const MIN_MAJOR = 22;
 const MIN_VERSION = `${MIN_MAJOR}.0.0`;
 
 const raw = process.versions.node;
 const major = parseInt(raw.split('.')[0], 10);
 
-// 写成 !(major >= MIN_MAJOR) 而非 major < MIN_MAJOR:解析失败得到 NaN 时同样报错。
+// 写成 !(major >= MIN_MAJOR) 而非 major < MIN_MAJOR：解析失败得到 NaN 时同样报错。
 if (!(major >= MIN_MAJOR)) {
   writeStderr(
     'difftab: requires Node.js ' +