dsh-worktree-groups 0.0.0-stage → 0.1.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/LICENSE +21 -0
- package/README.md +168 -2
- package/cordis.patch.yml +17 -0
- package/icon.svg +20 -0
- package/lib/activity.d.ts +78 -0
- package/lib/activity.d.ts.map +1 -0
- package/lib/activity.js +241 -0
- package/lib/activity.js.map +1 -0
- package/lib/client.d.ts +78 -0
- package/lib/client.d.ts.map +1 -0
- package/lib/client.js +4280 -0
- package/lib/git.d.ts +109 -0
- package/lib/git.d.ts.map +1 -0
- package/lib/git.js +317 -0
- package/lib/git.js.map +1 -0
- package/lib/icons.d.ts +148 -0
- package/lib/icons.d.ts.map +1 -0
- package/lib/icons.js +144 -0
- package/lib/icons.js.map +1 -0
- package/lib/index.d.ts +32 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +47 -0
- package/lib/index.js.map +1 -0
- package/lib/ledger.d.ts +97 -0
- package/lib/ledger.d.ts.map +1 -0
- package/lib/ledger.js +276 -0
- package/lib/ledger.js.map +1 -0
- package/lib/live-merge.d.ts +44 -0
- package/lib/live-merge.d.ts.map +1 -0
- package/lib/live-merge.js +227 -0
- package/lib/live-merge.js.map +1 -0
- package/lib/live-state.d.ts +158 -0
- package/lib/live-state.d.ts.map +1 -0
- package/lib/live-state.js +281 -0
- package/lib/live-state.js.map +1 -0
- package/lib/locales.d.ts +71 -0
- package/lib/locales.d.ts.map +1 -0
- package/lib/locales.js +199 -0
- package/lib/locales.js.map +1 -0
- package/lib/projects.d.ts +88 -0
- package/lib/projects.d.ts.map +1 -0
- package/lib/projects.js +418 -0
- package/lib/projects.js.map +1 -0
- package/lib/routes.d.ts +376 -0
- package/lib/routes.d.ts.map +1 -0
- package/lib/routes.js +1875 -0
- package/lib/routes.js.map +1 -0
- package/lib/row-memo.d.ts +34 -0
- package/lib/row-memo.d.ts.map +1 -0
- package/lib/row-memo.js +46 -0
- package/lib/row-memo.js.map +1 -0
- package/lib/sidebar.d.ts +126 -0
- package/lib/sidebar.d.ts.map +1 -0
- package/lib/tree-model.d.ts +1226 -0
- package/lib/tree-model.d.ts.map +1 -0
- package/lib/tree-model.js +2143 -0
- package/lib/tree-model.js.map +1 -0
- package/lib/types.d.ts +98 -0
- package/lib/types.d.ts.map +1 -0
- package/lib/types.js +8 -0
- package/lib/types.js.map +1 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +88 -4
package/lib/git.d.ts
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import type { RepoInfo, WorktreeEntry } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* 跑一条 git 命令,返回 stdout(已 trim 掉首尾空白,含尾换行)。
|
|
4
|
+
*
|
|
5
|
+
* 关键约束:
|
|
6
|
+
* - 一律走 `execFile` 数组参数,**绝不经 shell**(防注入);
|
|
7
|
+
* - 非零退出码时 reject,错误信息带上 stderr 摘要与 cwd,便于定位;
|
|
8
|
+
* - 统一附加 `-c core.quotepath=false`,否则含中文等非 ASCII 的路径会被转义成八进制;
|
|
9
|
+
* - 遵守传入的 AbortSignal(调用方取消即中断子进程)。
|
|
10
|
+
*/
|
|
11
|
+
export declare function runGit(cwd: string, args: string[], signal?: AbortSignal): Promise<string>;
|
|
12
|
+
/**
|
|
13
|
+
* 同 {@link runGit},但任何失败(非 git 仓、命令不存在、被取消)都返回 `null`。
|
|
14
|
+
*
|
|
15
|
+
* 用于探测类调用(`rev-parse`、目录存在性相关的判断),调用方无需 try/catch。
|
|
16
|
+
*/
|
|
17
|
+
export declare function runGitSafe(cwd: string, args: string[], signal?: AbortSignal): Promise<string | null>;
|
|
18
|
+
/**
|
|
19
|
+
* 归一化路径:绝对化(`path.resolve`)、反斜杠转正斜杠、去掉尾斜杠。
|
|
20
|
+
*
|
|
21
|
+
* 例外:文件系统根(`/`)与 Windows 盘根(`C:/`)保留其唯一斜杠。
|
|
22
|
+
* 本函数是本包内所有路径比较的**唯一**基准,任何路径进入比较前都必须先过它,
|
|
23
|
+
* 否则 `/a/b` 与 `/a/b/` 会被当成两个不同的 worktree。
|
|
24
|
+
*/
|
|
25
|
+
export declare function normalizePath(p: string): string;
|
|
26
|
+
/**
|
|
27
|
+
* 解析 `git worktree list --porcelain` 输出。
|
|
28
|
+
*
|
|
29
|
+
* 输出形如(条目之间以空行分隔):
|
|
30
|
+
* ```
|
|
31
|
+
* worktree /Users/a/repo
|
|
32
|
+
* HEAD d6399b7bf0f5ad0854b055bba3a8e75a7feede62
|
|
33
|
+
* branch refs/heads/develop
|
|
34
|
+
*
|
|
35
|
+
* worktree /Users/a/repo-ohos
|
|
36
|
+
* HEAD 914bbe2ffbfb7ebda989a779083227ae6b533d5c
|
|
37
|
+
* branch refs/heads/feature/ohos
|
|
38
|
+
* ```
|
|
39
|
+
*
|
|
40
|
+
* 关键约束:
|
|
41
|
+
* - `branch refs/heads/X` ⇒ `branch: 'X'`,**分支名里的 `/` 必须保留**
|
|
42
|
+
* (`feature/ohos`、`release/6.1.20` 都只能截掉 `refs/heads/` 前缀);
|
|
43
|
+
* - `detached` 行 ⇒ `branch: undefined`;
|
|
44
|
+
* - `bare` 行 ⇒ `bare: true`;
|
|
45
|
+
* - **第一个条目 `isMain: true`**,其余 `false`(git 保证主工作树排在最前);
|
|
46
|
+
* - 本函数是**纯解析**:`exists` 无法从文本得知,这里乐观地置为 `true`,
|
|
47
|
+
* 真实存在性由 {@link scanRepo} 用 `fs.stat` 逐条覆盖。这样即使调用方忘了探测,
|
|
48
|
+
* 也只是「多显示一个 worktree」,而不会把活着的会话错判进 history 桶。
|
|
49
|
+
* - 未知行(如 `locked` / `prunable`)跳过,保持前向兼容。
|
|
50
|
+
*/
|
|
51
|
+
export declare function parseWorktreeList(porcelain: string): WorktreeEntry[];
|
|
52
|
+
/**
|
|
53
|
+
* 解析仓库的 common dir(`git rev-parse --git-common-dir`),非 git 仓返回 `null`。
|
|
54
|
+
*
|
|
55
|
+
* **关键坑**:该命令对主工作树通常只回相对路径 `.git`,必须相对 `repoPath` 再
|
|
56
|
+
* resolve 成绝对路径后才能当仓库身份键;对 linked worktree 则回绝对路径
|
|
57
|
+
* (`<主仓>/.git`)——两者归一后必须相等,同一仓才能被合并成一个项目节点。
|
|
58
|
+
*/
|
|
59
|
+
export declare function resolveCommonDir(repoPath: string, signal?: AbortSignal): Promise<string | null>;
|
|
60
|
+
/**
|
|
61
|
+
* 解析工作树根目录(`git rev-parse --show-toplevel`),非 git 仓 / bare 仓返回 `null`。
|
|
62
|
+
*
|
|
63
|
+
* **⚠️ 陷阱**:在 linked worktree 里执行得到的是**该 worktree 自己**的路径,而不是主树。
|
|
64
|
+
* 因此本函数**不能**用来求「仓的主工作树路径」。需要主树请用 {@link scanRepo} 的
|
|
65
|
+
* `mainPath`(它取 `git worktree list --porcelain` 的第一个 / `isMain` 条目),
|
|
66
|
+
* 或自行从 `parseWorktreeList` 的结果里取 `isMain: true` 那条。
|
|
67
|
+
*
|
|
68
|
+
* 本函数保留导出,用于「只想知道给定路径落在哪个工作树根」的场景(例如 `scanRepo`
|
|
69
|
+
* 用它排除 bare 仓)。参见 {@link scanRepo} 的 JSDoc 了解完整背景。
|
|
70
|
+
*/
|
|
71
|
+
export declare function resolveToplevel(repoPath: string, signal?: AbortSignal): Promise<string | null>;
|
|
72
|
+
/**
|
|
73
|
+
* 完整扫描一个仓:common dir + 主树 + 全部 worktree + 逐条目录存在性。
|
|
74
|
+
* 非 git 仓返回 `null`;被取消时返回 `null`(不抛错,交由调用方按「本次无数据」处理)。
|
|
75
|
+
*
|
|
76
|
+
* 步骤:
|
|
77
|
+
* 1. `resolveCommonDir` —— 拿仓库身份键,非 git 仓直接 null;
|
|
78
|
+
* 2. `resolveToplevel` —— **只作门槛**:确认 `repoPath` 落在一个真实工作树里
|
|
79
|
+
* (bare 仓会在这里被排除)。它返回的值**不**直接当 `mainPath`,原因见下;
|
|
80
|
+
* 3. 在 `repoPath` 下跑 `git worktree list --porcelain` 并解析;
|
|
81
|
+
* 4. **`mainPath` 取列表里 `isMain: true` 那条的 `path`** —— `parseWorktreeList` 已把
|
|
82
|
+
* 第一个条目标为 `isMain: true`,而 git 保证主工作树排在最前;
|
|
83
|
+
* 5. **逐条 `fs.stat`** 判定 `exists` —— 绝不能用 git 输出推断:被 `rm -rf` 掉的
|
|
84
|
+
* worktree 仍会留在 git 的列表里,只有 stat 才能识别「已关闭」;
|
|
85
|
+
* 6. 返回 `{ commonDir, mainPath, worktrees }`(worktrees 保持 git 顺序,主树在首位)。
|
|
86
|
+
*
|
|
87
|
+
* ## `mainPath` 的语义(**本函数的关键不变量**)
|
|
88
|
+
*
|
|
89
|
+
* `mainPath` = **该仓的主工作树路径,与「从哪个 worktree 扫描」无关**。
|
|
90
|
+
*
|
|
91
|
+
* 为什么不能直接用 `resolveToplevel`:`git rev-parse --show-toplevel` 在 **linked
|
|
92
|
+
* worktree** 里执行时返回的是**那个 worktree 自己**的路径,不是主工作树:
|
|
93
|
+
*
|
|
94
|
+
* ```
|
|
95
|
+
* $ git -C <repo> rev-parse --show-toplevel → <repo> ✅ 主树
|
|
96
|
+
* $ git -C <repo>-ohos rev-parse --show-toplevel → <repo>-ohos ❌ worktree 自身
|
|
97
|
+
* $ git -C <repo>-ohos rev-parse --git-common-dir → <repo>/.git ✅ 两者一致
|
|
98
|
+
* ```
|
|
99
|
+
*
|
|
100
|
+
* 于是「工作区注册表里先扫到哪个入口」会决定 `mainPath`,进而让
|
|
101
|
+
* `buildProjects` 的 `basename(repo.mainPath)` 把项目标题算成 worktree 名
|
|
102
|
+
* (真实数据里 `MyProject` 曾被显示为 `MyProject-ohos`)。改用
|
|
103
|
+
* `git worktree list --porcelain` 的第一个条目后,从任何入口扫描都得到同一个主树路径。
|
|
104
|
+
*
|
|
105
|
+
* `resolveToplevel` 仅作为**拿不到列表时**的兜底(此时无从得知主树,只能退回当前
|
|
106
|
+
* 工作树;这种降级在正常仓里不会发生)。
|
|
107
|
+
*/
|
|
108
|
+
export declare function scanRepo(repoPath: string, signal?: AbortSignal): Promise<RepoInfo | null>;
|
|
109
|
+
//# sourceMappingURL=git.d.ts.map
|
package/lib/git.d.ts.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AA8DzD;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB/F;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM1G;AAYD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO/C;AAWD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAoDpE;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKrG;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIpG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA8C/F"}
|
package/lib/git.js
ADDED
|
@@ -0,0 +1,317 @@
|
|
|
1
|
+
import { execFile } from 'node:child_process';
|
|
2
|
+
import { stat } from 'node:fs/promises';
|
|
3
|
+
import { resolve } from 'node:path';
|
|
4
|
+
/** 子进程输出上限;8 MiB 足以容纳超大仓的 `worktree list` / `for-each-ref` 输出。 */
|
|
5
|
+
const MAX_BUFFER = 8 * 1024 * 1024;
|
|
6
|
+
/**
|
|
7
|
+
* git 可执行文件探测顺序:先用 PATH 上的裸名 `git`,失败再依次退到 macOS/Linux
|
|
8
|
+
* 的常见绝对安装位置。裸名优先可兼容 nvm/asdf 等自管 PATH 的场景。
|
|
9
|
+
*/
|
|
10
|
+
const GIT_CANDIDATES = ['git', '/usr/bin/git', '/usr/local/bin/git', '/opt/homebrew/bin/git'];
|
|
11
|
+
/**
|
|
12
|
+
* 模块级探测缓存。
|
|
13
|
+
*
|
|
14
|
+
* 缓存的是「探测 Promise」而不是结果,因此多个并发调用只会真正探测一次;
|
|
15
|
+
* 探测失败时清空缓存,让下一次调用有机会重试(例如 git 刚被安装)。
|
|
16
|
+
*/
|
|
17
|
+
let gitBinPromise;
|
|
18
|
+
/**
|
|
19
|
+
* 判断 signal 是否已取消。
|
|
20
|
+
*
|
|
21
|
+
* 刻意包成函数而不是内联 `signal?.aborted === true`:内联写法会让 TypeScript
|
|
22
|
+
* 把 `aborted` 收窄成 `false`,导致 `await` 之后再判断时报「无交集」的假错误,
|
|
23
|
+
* 而 signal 其实可以在 await 期间被取消。
|
|
24
|
+
*/
|
|
25
|
+
function isAborted(signal) {
|
|
26
|
+
return signal?.aborted === true;
|
|
27
|
+
}
|
|
28
|
+
/** 试跑 `<bin> --version`,只关心能否成功执行。 */
|
|
29
|
+
function probeGitBin(bin) {
|
|
30
|
+
return new Promise((resolveProbe) => {
|
|
31
|
+
execFile(bin, ['--version'], { windowsHide: true, timeout: 10_000 }, (error) => {
|
|
32
|
+
resolveProbe(error === null);
|
|
33
|
+
});
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* 解析可执行的 git 路径(模块级缓存,避免每条命令都重试一遍候选列表)。
|
|
38
|
+
*
|
|
39
|
+
* 候选顺序:`git` → `/usr/bin/git` → `/usr/local/bin/git` → `/opt/homebrew/bin/git`。
|
|
40
|
+
* 全部失败时抛错;调用方若只做探测请改用 {@link runGitSafe}。
|
|
41
|
+
*/
|
|
42
|
+
function resolveGitBin() {
|
|
43
|
+
if (gitBinPromise === undefined) {
|
|
44
|
+
const probing = (async () => {
|
|
45
|
+
for (const candidate of GIT_CANDIDATES) {
|
|
46
|
+
if (await probeGitBin(candidate))
|
|
47
|
+
return candidate;
|
|
48
|
+
}
|
|
49
|
+
throw new Error(`找不到可执行的 git(已尝试 ${GIT_CANDIDATES.join('、')})`);
|
|
50
|
+
})();
|
|
51
|
+
gitBinPromise = probing.catch((error) => {
|
|
52
|
+
// 失败不缓存:下次调用重新探测,避免临时故障(PATH 尚未就绪)被永久记忆。
|
|
53
|
+
gitBinPromise = undefined;
|
|
54
|
+
throw error;
|
|
55
|
+
});
|
|
56
|
+
}
|
|
57
|
+
return gitBinPromise;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* 跑一条 git 命令,返回 stdout(已 trim 掉首尾空白,含尾换行)。
|
|
61
|
+
*
|
|
62
|
+
* 关键约束:
|
|
63
|
+
* - 一律走 `execFile` 数组参数,**绝不经 shell**(防注入);
|
|
64
|
+
* - 非零退出码时 reject,错误信息带上 stderr 摘要与 cwd,便于定位;
|
|
65
|
+
* - 统一附加 `-c core.quotepath=false`,否则含中文等非 ASCII 的路径会被转义成八进制;
|
|
66
|
+
* - 遵守传入的 AbortSignal(调用方取消即中断子进程)。
|
|
67
|
+
*/
|
|
68
|
+
export async function runGit(cwd, args, signal) {
|
|
69
|
+
const bin = await resolveGitBin();
|
|
70
|
+
if (isAborted(signal))
|
|
71
|
+
throw new Error(`git ${args.join(' ')} 已取消`);
|
|
72
|
+
return new Promise((resolveRun, rejectRun) => {
|
|
73
|
+
execFile(bin, ['-c', 'core.quotepath=false', ...args], { cwd, windowsHide: true, maxBuffer: MAX_BUFFER, signal }, (error, stdout, stderr) => {
|
|
74
|
+
if (error !== null) {
|
|
75
|
+
const reason = stderr.trim() === '' ? error.message : stderr.trim();
|
|
76
|
+
rejectRun(new Error(`git ${args.join(' ')} 失败(cwd=${cwd}):${reason}`));
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
resolveRun(stdout.trim());
|
|
80
|
+
});
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* 同 {@link runGit},但任何失败(非 git 仓、命令不存在、被取消)都返回 `null`。
|
|
85
|
+
*
|
|
86
|
+
* 用于探测类调用(`rev-parse`、目录存在性相关的判断),调用方无需 try/catch。
|
|
87
|
+
*/
|
|
88
|
+
export async function runGitSafe(cwd, args, signal) {
|
|
89
|
+
try {
|
|
90
|
+
return await runGit(cwd, args, signal);
|
|
91
|
+
}
|
|
92
|
+
catch {
|
|
93
|
+
return null;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
/** 判断目录/文件是否存在(`fs.stat` 判定,不跟随任何 git 输出推断)。 */
|
|
97
|
+
async function pathExists(target) {
|
|
98
|
+
try {
|
|
99
|
+
await stat(target);
|
|
100
|
+
return true;
|
|
101
|
+
}
|
|
102
|
+
catch {
|
|
103
|
+
return false;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* 归一化路径:绝对化(`path.resolve`)、反斜杠转正斜杠、去掉尾斜杠。
|
|
108
|
+
*
|
|
109
|
+
* 例外:文件系统根(`/`)与 Windows 盘根(`C:/`)保留其唯一斜杠。
|
|
110
|
+
* 本函数是本包内所有路径比较的**唯一**基准,任何路径进入比较前都必须先过它,
|
|
111
|
+
* 否则 `/a/b` 与 `/a/b/` 会被当成两个不同的 worktree。
|
|
112
|
+
*/
|
|
113
|
+
export function normalizePath(p) {
|
|
114
|
+
const absolute = resolve(p).replace(/\\/g, '/');
|
|
115
|
+
if (absolute.length <= 1)
|
|
116
|
+
return absolute;
|
|
117
|
+
if (/^[A-Za-z]:\/$/.test(absolute))
|
|
118
|
+
return absolute;
|
|
119
|
+
let out = absolute;
|
|
120
|
+
while (out.length > 1 && out.endsWith('/'))
|
|
121
|
+
out = out.slice(0, -1);
|
|
122
|
+
return out;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* 解析 `git worktree list --porcelain` 输出。
|
|
126
|
+
*
|
|
127
|
+
* 输出形如(条目之间以空行分隔):
|
|
128
|
+
* ```
|
|
129
|
+
* worktree /Users/a/repo
|
|
130
|
+
* HEAD d6399b7bf0f5ad0854b055bba3a8e75a7feede62
|
|
131
|
+
* branch refs/heads/develop
|
|
132
|
+
*
|
|
133
|
+
* worktree /Users/a/repo-ohos
|
|
134
|
+
* HEAD 914bbe2ffbfb7ebda989a779083227ae6b533d5c
|
|
135
|
+
* branch refs/heads/feature/ohos
|
|
136
|
+
* ```
|
|
137
|
+
*
|
|
138
|
+
* 关键约束:
|
|
139
|
+
* - `branch refs/heads/X` ⇒ `branch: 'X'`,**分支名里的 `/` 必须保留**
|
|
140
|
+
* (`feature/ohos`、`release/6.1.20` 都只能截掉 `refs/heads/` 前缀);
|
|
141
|
+
* - `detached` 行 ⇒ `branch: undefined`;
|
|
142
|
+
* - `bare` 行 ⇒ `bare: true`;
|
|
143
|
+
* - **第一个条目 `isMain: true`**,其余 `false`(git 保证主工作树排在最前);
|
|
144
|
+
* - 本函数是**纯解析**:`exists` 无法从文本得知,这里乐观地置为 `true`,
|
|
145
|
+
* 真实存在性由 {@link scanRepo} 用 `fs.stat` 逐条覆盖。这样即使调用方忘了探测,
|
|
146
|
+
* 也只是「多显示一个 worktree」,而不会把活着的会话错判进 history 桶。
|
|
147
|
+
* - 未知行(如 `locked` / `prunable`)跳过,保持前向兼容。
|
|
148
|
+
*/
|
|
149
|
+
export function parseWorktreeList(porcelain) {
|
|
150
|
+
const entries = [];
|
|
151
|
+
let current;
|
|
152
|
+
const flush = () => {
|
|
153
|
+
const pending = current;
|
|
154
|
+
current = undefined;
|
|
155
|
+
if (pending === undefined || pending.path === '')
|
|
156
|
+
return;
|
|
157
|
+
entries.push({
|
|
158
|
+
path: normalizePath(pending.path),
|
|
159
|
+
branch: pending.detached ? undefined : pending.branch,
|
|
160
|
+
head: pending.head,
|
|
161
|
+
isMain: entries.length === 0,
|
|
162
|
+
bare: pending.bare,
|
|
163
|
+
exists: true,
|
|
164
|
+
});
|
|
165
|
+
};
|
|
166
|
+
for (const rawLine of porcelain.split('\n')) {
|
|
167
|
+
const line = rawLine.replace(/\r$/, '');
|
|
168
|
+
if (line === '') {
|
|
169
|
+
flush();
|
|
170
|
+
continue;
|
|
171
|
+
}
|
|
172
|
+
const sep = line.indexOf(' ');
|
|
173
|
+
const key = sep === -1 ? line : line.slice(0, sep);
|
|
174
|
+
const value = sep === -1 ? '' : line.slice(sep + 1);
|
|
175
|
+
switch (key) {
|
|
176
|
+
case 'worktree':
|
|
177
|
+
flush();
|
|
178
|
+
current = { path: value, bare: false, detached: false };
|
|
179
|
+
break;
|
|
180
|
+
case 'HEAD':
|
|
181
|
+
if (current !== undefined)
|
|
182
|
+
current.head = value;
|
|
183
|
+
break;
|
|
184
|
+
case 'branch':
|
|
185
|
+
// 只截 refs/heads/ 前缀,保留分支名内部的斜杠。
|
|
186
|
+
if (current !== undefined)
|
|
187
|
+
current.branch = value.replace(/^refs\/heads\//, '');
|
|
188
|
+
break;
|
|
189
|
+
case 'detached':
|
|
190
|
+
if (current !== undefined)
|
|
191
|
+
current.detached = true;
|
|
192
|
+
break;
|
|
193
|
+
case 'bare':
|
|
194
|
+
if (current !== undefined)
|
|
195
|
+
current.bare = true;
|
|
196
|
+
break;
|
|
197
|
+
default:
|
|
198
|
+
break;
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
flush();
|
|
202
|
+
return entries;
|
|
203
|
+
}
|
|
204
|
+
/**
|
|
205
|
+
* 解析仓库的 common dir(`git rev-parse --git-common-dir`),非 git 仓返回 `null`。
|
|
206
|
+
*
|
|
207
|
+
* **关键坑**:该命令对主工作树通常只回相对路径 `.git`,必须相对 `repoPath` 再
|
|
208
|
+
* resolve 成绝对路径后才能当仓库身份键;对 linked worktree 则回绝对路径
|
|
209
|
+
* (`<主仓>/.git`)——两者归一后必须相等,同一仓才能被合并成一个项目节点。
|
|
210
|
+
*/
|
|
211
|
+
export async function resolveCommonDir(repoPath, signal) {
|
|
212
|
+
const raw = await runGitSafe(repoPath, ['rev-parse', '--git-common-dir'], signal);
|
|
213
|
+
if (raw === null || raw === '')
|
|
214
|
+
return null;
|
|
215
|
+
// path.resolve 对绝对路径忽略第二个参数,对相对路径(.git)按 repoPath 展开。
|
|
216
|
+
return normalizePath(resolve(repoPath, raw));
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* 解析工作树根目录(`git rev-parse --show-toplevel`),非 git 仓 / bare 仓返回 `null`。
|
|
220
|
+
*
|
|
221
|
+
* **⚠️ 陷阱**:在 linked worktree 里执行得到的是**该 worktree 自己**的路径,而不是主树。
|
|
222
|
+
* 因此本函数**不能**用来求「仓的主工作树路径」。需要主树请用 {@link scanRepo} 的
|
|
223
|
+
* `mainPath`(它取 `git worktree list --porcelain` 的第一个 / `isMain` 条目),
|
|
224
|
+
* 或自行从 `parseWorktreeList` 的结果里取 `isMain: true` 那条。
|
|
225
|
+
*
|
|
226
|
+
* 本函数保留导出,用于「只想知道给定路径落在哪个工作树根」的场景(例如 `scanRepo`
|
|
227
|
+
* 用它排除 bare 仓)。参见 {@link scanRepo} 的 JSDoc 了解完整背景。
|
|
228
|
+
*/
|
|
229
|
+
export async function resolveToplevel(repoPath, signal) {
|
|
230
|
+
const raw = await runGitSafe(repoPath, ['rev-parse', '--show-toplevel'], signal);
|
|
231
|
+
if (raw === null || raw === '')
|
|
232
|
+
return null;
|
|
233
|
+
return normalizePath(raw);
|
|
234
|
+
}
|
|
235
|
+
/**
|
|
236
|
+
* 完整扫描一个仓:common dir + 主树 + 全部 worktree + 逐条目录存在性。
|
|
237
|
+
* 非 git 仓返回 `null`;被取消时返回 `null`(不抛错,交由调用方按「本次无数据」处理)。
|
|
238
|
+
*
|
|
239
|
+
* 步骤:
|
|
240
|
+
* 1. `resolveCommonDir` —— 拿仓库身份键,非 git 仓直接 null;
|
|
241
|
+
* 2. `resolveToplevel` —— **只作门槛**:确认 `repoPath` 落在一个真实工作树里
|
|
242
|
+
* (bare 仓会在这里被排除)。它返回的值**不**直接当 `mainPath`,原因见下;
|
|
243
|
+
* 3. 在 `repoPath` 下跑 `git worktree list --porcelain` 并解析;
|
|
244
|
+
* 4. **`mainPath` 取列表里 `isMain: true` 那条的 `path`** —— `parseWorktreeList` 已把
|
|
245
|
+
* 第一个条目标为 `isMain: true`,而 git 保证主工作树排在最前;
|
|
246
|
+
* 5. **逐条 `fs.stat`** 判定 `exists` —— 绝不能用 git 输出推断:被 `rm -rf` 掉的
|
|
247
|
+
* worktree 仍会留在 git 的列表里,只有 stat 才能识别「已关闭」;
|
|
248
|
+
* 6. 返回 `{ commonDir, mainPath, worktrees }`(worktrees 保持 git 顺序,主树在首位)。
|
|
249
|
+
*
|
|
250
|
+
* ## `mainPath` 的语义(**本函数的关键不变量**)
|
|
251
|
+
*
|
|
252
|
+
* `mainPath` = **该仓的主工作树路径,与「从哪个 worktree 扫描」无关**。
|
|
253
|
+
*
|
|
254
|
+
* 为什么不能直接用 `resolveToplevel`:`git rev-parse --show-toplevel` 在 **linked
|
|
255
|
+
* worktree** 里执行时返回的是**那个 worktree 自己**的路径,不是主工作树:
|
|
256
|
+
*
|
|
257
|
+
* ```
|
|
258
|
+
* $ git -C <repo> rev-parse --show-toplevel → <repo> ✅ 主树
|
|
259
|
+
* $ git -C <repo>-ohos rev-parse --show-toplevel → <repo>-ohos ❌ worktree 自身
|
|
260
|
+
* $ git -C <repo>-ohos rev-parse --git-common-dir → <repo>/.git ✅ 两者一致
|
|
261
|
+
* ```
|
|
262
|
+
*
|
|
263
|
+
* 于是「工作区注册表里先扫到哪个入口」会决定 `mainPath`,进而让
|
|
264
|
+
* `buildProjects` 的 `basename(repo.mainPath)` 把项目标题算成 worktree 名
|
|
265
|
+
* (真实数据里 `MyProject` 曾被显示为 `MyProject-ohos`)。改用
|
|
266
|
+
* `git worktree list --porcelain` 的第一个条目后,从任何入口扫描都得到同一个主树路径。
|
|
267
|
+
*
|
|
268
|
+
* `resolveToplevel` 仅作为**拿不到列表时**的兜底(此时无从得知主树,只能退回当前
|
|
269
|
+
* 工作树;这种降级在正常仓里不会发生)。
|
|
270
|
+
*/
|
|
271
|
+
export async function scanRepo(repoPath, signal) {
|
|
272
|
+
if (isAborted(signal))
|
|
273
|
+
return null;
|
|
274
|
+
// 2026-11-14 PERF3:三条只读 git 命令互不依赖 ⇒ 并行(旧实现串行,耗时相加)。
|
|
275
|
+
const [commonDir, fallbackMainPath, porcelain] = await Promise.all([
|
|
276
|
+
resolveCommonDir(repoPath, signal),
|
|
277
|
+
// 门槛:非 git 仓 / bare 仓在这里被排除(bare 仓的 --show-toplevel 会失败)。
|
|
278
|
+
// 该值只在拿不到 worktree 列表时兜底,正常情况下会被下面的 isMain 条目覆盖。
|
|
279
|
+
resolveToplevel(repoPath, signal),
|
|
280
|
+
runGitSafe(repoPath, ['worktree', 'list', '--porcelain'], signal),
|
|
281
|
+
]);
|
|
282
|
+
if (commonDir === null)
|
|
283
|
+
return null;
|
|
284
|
+
if (fallbackMainPath === null)
|
|
285
|
+
return null;
|
|
286
|
+
if (porcelain === null) {
|
|
287
|
+
// 已是 git 仓却拿不到列表(极罕见:worktree 元数据损坏、又被取消)。
|
|
288
|
+
// 降级为「只有一个主树」而不是整体失败,保证侧栏仍有工作区行。
|
|
289
|
+
if (isAborted(signal))
|
|
290
|
+
return null;
|
|
291
|
+
return {
|
|
292
|
+
commonDir,
|
|
293
|
+
mainPath: fallbackMainPath,
|
|
294
|
+
worktrees: [
|
|
295
|
+
{ path: fallbackMainPath, isMain: true, bare: false, exists: await pathExists(fallbackMainPath) },
|
|
296
|
+
],
|
|
297
|
+
};
|
|
298
|
+
}
|
|
299
|
+
const parsed = parseWorktreeList(porcelain);
|
|
300
|
+
if (parsed.length === 0) {
|
|
301
|
+
return {
|
|
302
|
+
commonDir,
|
|
303
|
+
mainPath: fallbackMainPath,
|
|
304
|
+
worktrees: [
|
|
305
|
+
{ path: fallbackMainPath, isMain: true, bare: false, exists: await pathExists(fallbackMainPath) },
|
|
306
|
+
],
|
|
307
|
+
};
|
|
308
|
+
}
|
|
309
|
+
// 主树 = 列表里 isMain 那条(git 保证第一个条目就是主工作树,即使从 linked
|
|
310
|
+
// worktree 执行也成立)。拿不到才退回 resolveToplevel 的结果。
|
|
311
|
+
const mainEntry = parsed.find((entry) => entry.isMain);
|
|
312
|
+
const mainPath = mainEntry?.path ?? fallbackMainPath;
|
|
313
|
+
const exists = await Promise.all(parsed.map((entry) => pathExists(entry.path)));
|
|
314
|
+
const worktrees = parsed.map((entry, index) => ({ ...entry, exists: exists[index] === true }));
|
|
315
|
+
return { commonDir, mainPath, worktrees };
|
|
316
|
+
}
|
|
317
|
+
//# sourceMappingURL=git.js.map
|
package/lib/git.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"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"}
|
package/lib/icons.d.ts
ADDED
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 宿主图标解析层:把「逻辑图标名」映射到**当前宿主**真实存在的 primitives 导出。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么需要这一层(2026-10-19 侧栏整块渲染失败)
|
|
5
|
+
*
|
|
6
|
+
* `src/sidebar.tsx` 原来直接以**尺寸后缀**取宿主图标(`P.IconPlusOutline16`、
|
|
7
|
+
* `P.IconChevronDownOutline14`、`P.IconArchiveOutline20` …),这在宿主
|
|
8
|
+
* `@deepseek-ai/dsh-client-ui-primitives@0.1.5-rc.2` 上成立(导出快照见
|
|
9
|
+
* `docs/HOST-CONTRACTS.md` §B5)。
|
|
10
|
+
*
|
|
11
|
+
* 宿主 `0.2.1-rc.2` 把图标导出改成了**线重后缀**:`IconPlusOutlineRegular`
|
|
12
|
+
* (1px)/ `IconPlusOutlineMedium`(1.3px),尺寸改由 `size` prop 控制,
|
|
13
|
+
* **`Icon*16` / `*14` / `*20` 这整套名字都不再存在**(实测导出表里没有任何
|
|
14
|
+
* `Icon*` + 数字后缀的名字)。
|
|
15
|
+
*
|
|
16
|
+
* 直接取用因此不是"图标不显示",而是**渲染期硬崩**:
|
|
17
|
+
*
|
|
18
|
+
* ```js
|
|
19
|
+
* const LeadIcon = P.IconBranchOutline16 // undefined
|
|
20
|
+
* jsx(LeadIcon, {}) // Element type is invalid … got: undefined
|
|
21
|
+
* ```
|
|
22
|
+
*
|
|
23
|
+
* 抛点在 `SidebarBoundary` 的子树内 ⇒ 侧栏被换成「侧栏渲染出错」;若发生在边界之外,
|
|
24
|
+
* 宿主 `SlotErrorBoundary` 会 `abdicate` 本 entry,整块侧栏静默回落到官方
|
|
25
|
+
* `ui-workspace`。用户看到的现象就是"这个插件导致侧栏渲染失败"。
|
|
26
|
+
*
|
|
27
|
+
* ## 契约
|
|
28
|
+
*
|
|
29
|
+
* 1. **候选表**:每个逻辑名给出「新命名优先、旧命名兜底」的候选序列,任一命中即用 ⇒
|
|
30
|
+
* 插件对两个宿主版本同时成立,不需要跟宿主版本硬绑定。
|
|
31
|
+
* 2. **绝不返回 `undefined`**:全部候选都缺席时回落**空图标组件**(渲染 `null`)。
|
|
32
|
+
* 宿主再改一次命名,代价是少几个图标,而不是整块侧栏白掉。
|
|
33
|
+
* 3. **纯逻辑**:本文件不 import react、不 import 任何 `@deepseek-ai/*` 包,
|
|
34
|
+
* 宿主图标面由调用方以 `face` 传入(`sidebar.tsx` 传 esbuild external 的
|
|
35
|
+
* `Primitives`),因此可被 `node --test` 直接覆盖。
|
|
36
|
+
*
|
|
37
|
+
* 尺寸:宿主新组件的 `size` prop 默认 16;`ArchiveOutline20` 这类旧名字自带 20 的
|
|
38
|
+
* 画板,因此候选表里同时记录**默认尺寸**,渲染时与宿主给的同名 prop 合并
|
|
39
|
+
* (调用方显式传入的 `size` 优先)。
|
|
40
|
+
*/
|
|
41
|
+
/** 一个逻辑图标:候选导出名(新命名在前)+ 默认尺寸。 */
|
|
42
|
+
export interface IconSpec {
|
|
43
|
+
/** 候选导出名,按优先级排列(新命名在前)。 */
|
|
44
|
+
readonly candidates: readonly string[];
|
|
45
|
+
/** 宿主未收到 `size` 时使用的尺寸。 */
|
|
46
|
+
readonly size: number;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* 逻辑名 → 候选导出名。
|
|
50
|
+
*
|
|
51
|
+
* 新命名(`*Regular` / `*Medium`)必须排在首位:宿主 `0.2.1` 只认它;
|
|
52
|
+
* 旧命名(`Icon*16/14/20`)保留在后,让 `0.1.5` 组合继续可用。
|
|
53
|
+
*/
|
|
54
|
+
export declare const ICON_SPECS: {
|
|
55
|
+
readonly chevronDown: {
|
|
56
|
+
readonly candidates: readonly ["IconChevronDownOutlineRegular", "IconChevronDownOutline14"];
|
|
57
|
+
readonly size: 14;
|
|
58
|
+
};
|
|
59
|
+
readonly chevronRight: {
|
|
60
|
+
readonly candidates: readonly ["IconChevronRightOutlineRegular", "IconChevronRightOutline14"];
|
|
61
|
+
readonly size: 14;
|
|
62
|
+
};
|
|
63
|
+
readonly clock: {
|
|
64
|
+
readonly candidates: readonly ["IconClockOutlineRegular", "IconClockOutline16"];
|
|
65
|
+
readonly size: 16;
|
|
66
|
+
};
|
|
67
|
+
readonly folderOpen: {
|
|
68
|
+
readonly candidates: readonly ["IconFolderOpenOutlineRegular", "IconFolderOpenOutline16"];
|
|
69
|
+
readonly size: 16;
|
|
70
|
+
};
|
|
71
|
+
readonly folderClose: {
|
|
72
|
+
readonly candidates: readonly ["IconFolderCloseRegular", "IconFolderClose16"];
|
|
73
|
+
readonly size: 16;
|
|
74
|
+
};
|
|
75
|
+
readonly branch: {
|
|
76
|
+
readonly candidates: readonly ["IconBranchOutlineRegular", "IconBranchOutline16"];
|
|
77
|
+
readonly size: 16;
|
|
78
|
+
};
|
|
79
|
+
readonly panelLeft: {
|
|
80
|
+
readonly candidates: readonly ["IconPanelLeftOutlineRegular", "IconPanelLeftOutline16"];
|
|
81
|
+
readonly size: 16;
|
|
82
|
+
};
|
|
83
|
+
readonly plus: {
|
|
84
|
+
readonly candidates: readonly ["IconPlusOutlineRegular", "IconPlusOutline16"];
|
|
85
|
+
readonly size: 16;
|
|
86
|
+
};
|
|
87
|
+
readonly ellipsis: {
|
|
88
|
+
readonly candidates: readonly ["IconEllipsisOutlineRegular", "IconEllipsisOutline16"];
|
|
89
|
+
readonly size: 16;
|
|
90
|
+
};
|
|
91
|
+
readonly projectAdd: {
|
|
92
|
+
readonly candidates: readonly ["IconProjectAddOutlineRegular", "IconProjectAddOutline16"];
|
|
93
|
+
readonly size: 16;
|
|
94
|
+
};
|
|
95
|
+
readonly refresh: {
|
|
96
|
+
readonly candidates: readonly ["IconRefreshOutlineRegular", "IconRefreshOutline16"];
|
|
97
|
+
readonly size: 14;
|
|
98
|
+
};
|
|
99
|
+
readonly copy: {
|
|
100
|
+
readonly candidates: readonly ["IconCopyOutlineRegular", "IconCopyOutline16"];
|
|
101
|
+
readonly size: 16;
|
|
102
|
+
};
|
|
103
|
+
readonly edit: {
|
|
104
|
+
readonly candidates: readonly ["IconEditOutlineRegular", "IconEditOutline16"];
|
|
105
|
+
readonly size: 16;
|
|
106
|
+
};
|
|
107
|
+
readonly trash: {
|
|
108
|
+
readonly candidates: readonly ["IconTrashOutlineRegular", "IconTrashOutline16"];
|
|
109
|
+
readonly size: 16;
|
|
110
|
+
};
|
|
111
|
+
readonly archive: {
|
|
112
|
+
readonly candidates: readonly ["IconArchiveOutlineRegular", "IconArchiveOutline20"];
|
|
113
|
+
readonly size: 20;
|
|
114
|
+
};
|
|
115
|
+
readonly newChat: {
|
|
116
|
+
readonly candidates: readonly ["IconNewChatOutlineRegular", "IconNewChatOutline16"];
|
|
117
|
+
readonly size: 16;
|
|
118
|
+
};
|
|
119
|
+
};
|
|
120
|
+
/** 逻辑图标名(`ICON_SPECS` 的键)。 */
|
|
121
|
+
export type IconName = keyof typeof ICON_SPECS;
|
|
122
|
+
/** 全部逻辑图标名,顺序稳定(`ICON_SPECS` 的声明顺序)。 */
|
|
123
|
+
export declare const ICON_NAMES: readonly IconName[];
|
|
124
|
+
/** 解析结果:可渲染组件 + 命中的宿主导出名(回落时为 `undefined`)。 */
|
|
125
|
+
export interface ResolvedIcon {
|
|
126
|
+
/** 组件:命中的宿主导出,或回落用的空图标(永不 `undefined`)。 */
|
|
127
|
+
readonly Component: (props?: Record<string, unknown>) => unknown;
|
|
128
|
+
/** 命中的宿主导出名;回落时为 `undefined`。 */
|
|
129
|
+
readonly candidate: string | undefined;
|
|
130
|
+
}
|
|
131
|
+
export declare function resolveIcon(face: unknown, name: IconName): ResolvedIcon;
|
|
132
|
+
/**
|
|
133
|
+
* 列出该宿主面下**一个候选都不存在**的逻辑图标(漂移诊断用)。
|
|
134
|
+
*
|
|
135
|
+
* @param face 宿主 primitives 面。
|
|
136
|
+
* @returns 解析不到的图标名(顺序同 {@link ICON_NAMES})。
|
|
137
|
+
*/
|
|
138
|
+
export declare function unresolvedIcons(face: unknown): IconName[];
|
|
139
|
+
/**
|
|
140
|
+
* 图标默认尺寸(宿主新组件默认 16,`ArchiveOutline` 原画板 20)。
|
|
141
|
+
*
|
|
142
|
+
* 渲染层在 `jsx(Component, { size })` 时用它做默认值,调用方显式传入的 `size` 优先。
|
|
143
|
+
*
|
|
144
|
+
* @param name 逻辑图标名。
|
|
145
|
+
* @returns 该图标的默认尺寸。
|
|
146
|
+
*/
|
|
147
|
+
export declare function iconSize(name: IconName): number;
|
|
148
|
+
//# sourceMappingURL=icons.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBsB,CAAA;AAE7C,8BAA8B;AAC9B,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAA;AAE9C,wCAAwC;AACxC,eAAO,MAAM,UAAU,EAA8B,SAAS,QAAQ,EAAE,CAAA;AAExE,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAA;IAChE,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CACvC;AAiCD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,YAAY,CAyBvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAE/C"}
|