@peiyanlu/git-utils 0.0.0-stage → 0.1.0

package/dist/index.mjs

@@ -0,0 +1,1096 @@
+import { runGit, runGitSync } from "@peiyanlu/command-utils";
+import { splitNonEmptyLines } from "@peiyanlu/ts-utils";
+// src/raw.ts
+/**
+* 引用解析操作
+* @defaults `git rev-parse <args>`
+*/
+const gitRevParse = async (args, options) => {
+	return runGit(["rev-parse", ...args], options);
+};
+/** {@link gitRevParse} 的同步版本 */
+const gitRevParseSync = (args, options) => {
+	return runGitSync(["rev-parse", ...args], options);
+};
+/**
+* 提交遍历操作
+* @defaults `git rev-list <args>`
+*/
+const gitRevList = async (args, options) => {
+	return runGit(["rev-list", ...args], options);
+};
+/** {@link gitRevList} 的同步版本 */
+const gitRevListSync = (args, options) => {
+	return runGitSync(["rev-list", ...args], options);
+};
+/**
+* 引用遍历操作
+* @defaults `git for-each-ref <args>`
+*/
+const gitForEachRef = async (args, options) => {
+	return runGit(["for-each-ref", ...args], options);
+};
+/** {@link gitForEachRef} 的同步版本 */
+const gitForEachRefSync = (args, options) => {
+	return runGitSync(["for-each-ref", ...args], options);
+};
+/**
+* 暂存操作
+* @defaults `git add <args>`
+*/
+const gitAdd = async (args, options) => {
+	return runGit(["add", ...args], options);
+};
+/** {@link gitAdd} 的同步版本 */
+const gitAddSync = (args, options) => {
+	return runGitSync(["add", ...args], options);
+};
+/**
+* 分支操作
+* @defaults `git branch <args>`
+*/
+const gitBranch = async (args, options) => {
+	return runGit(["branch", ...args], options);
+};
+/** {@link gitBranch} 的同步版本 */
+const gitBranchSync = (args, options) => {
+	return runGitSync(["branch", ...args], options);
+};
+/**
+* 迁出操作
+* @defaults `git checkout <args>`
+*/
+const gitCheckout = async (args, options) => {
+	return runGit(["checkout", ...args], options);
+};
+/** {@link gitCheckout} 的同步版本 */
+const gitCheckoutSync = (args, options) => {
+	return runGitSync(["checkout", ...args], options);
+};
+/**
+* 提交操作
+* @defaults `git commit <args>`
+*/
+const gitCommit = async (args = [], options) => {
+	return runGit(["commit", ...args], options);
+};
+/** {@link gitCommit} 的同步版本 */
+const gitCommitSync = (args = [], options) => {
+	return runGitSync(["commit", ...args], options);
+};
+/**
+* 配置操作
+* @defaults `git config <args>`
+*/
+const gitConfig = async (args, options) => {
+	return runGit(["config", ...args], options);
+};
+/** {@link gitConfig} 的同步版本 */
+const gitConfigSync = (args, options) => {
+	return runGitSync(["config", ...args], options);
+};
+/**
+* 符号引用操作
+* @defaults `git symbolic-ref <args>`
+*/
+const gitSymbolicRef = async (args, options) => {
+	return runGit(["symbolic-ref", ...args], options);
+};
+/** {@link gitSymbolicRef} 的同步版本 */
+const gitSymbolicRefSync = (args, options) => {
+	return runGitSync(["symbolic-ref", ...args], options);
+};
+/**
+* 引用更新操作
+* @defaults `git update-ref <args>`
+*/
+const gitUpdateRef = async (args, options) => {
+	return runGit(["update-ref", ...args], options);
+};
+/** {@link gitUpdateRef} 的同步版本 */
+const gitUpdateRefSync = (args, options) => {
+	return runGitSync(["update-ref", ...args], options);
+};
+/**
+* 推送操作
+* @defaults `git push <args>`
+*/
+const gitPush = async (args, options) => {
+	return runGit(["push", ...args], options);
+};
+/** {@link gitPush} 的同步版本 */
+const gitPushSync = (args, options) => {
+	return runGitSync(["push", ...args], options);
+};
+/**
+* 远程操作
+* @defaults `git remote <args>`
+*/
+const gitRemote = async (args, options) => {
+	return runGit(["remote", ...args], options);
+};
+/** {@link gitRemote} 的同步版本 */
+const gitRemoteSync = (args, options) => {
+	return runGitSync(["remote", ...args], options);
+};
+/**
+* tag 操作
+* @defaults `git tag <args>`
+*/
+const gitTag = async (args, options) => {
+	return runGit(["tag", ...args], options);
+};
+/** {@link gitTag} 的同步版本 */
+const gitTagSync = (args, options) => {
+	return runGitSync(["tag", ...args], options);
+};
+/**
+* 重置操作
+* @defaults `git reset <args>`
+*/
+const gitReset = async (args, options) => {
+	return runGit(["reset", ...args], options);
+};
+/** {@link gitReset} 的同步版本 */
+const gitResetSync = (args, options) => {
+	return runGitSync(["reset", ...args], options);
+};
+/**
+* 恢复操作
+* @defaults `git restore <args>`
+*/
+const gitRestore = async (args, options) => {
+	return runGit(["restore", ...args], options);
+};
+/** {@link gitRestore} 的同步版本 */
+const gitRestoreSync = (args, options) => {
+	return runGitSync(["restore", ...args], options);
+};
+/**
+* 回退操作
+* @defaults `git revert <args>`
+*/
+const gitRevert = async (args, options) => {
+	return runGit(["revert", ...args], options);
+};
+/** {@link gitRevert} 的同步版本 */
+const gitRevertSync = (args, options) => {
+	return runGitSync(["revert", ...args], options);
+};
+/**
+* 远程引用查询操作
+* @defaults `git ls-remote <args>`
+*/
+const gitLsRemote = async (args, options) => {
+	return runGit(["ls-remote", ...args], options);
+};
+/** {@link gitLsRemote} 的同步版本 */
+const gitLsRemoteSync = (args, options) => {
+	return runGitSync(["ls-remote", ...args], options);
+};
+/**
+* 状态查询操作
+* @defaults `git status <args>`
+*/
+const gitStatus = async (args = [], options) => {
+	return runGit(["status", ...args], options);
+};
+/** {@link gitStatus} 的同步版本 */
+const gitStatusSync = (args = [], options) => {
+	return runGitSync(["status", ...args], options);
+};
+/**
+* 对象查看操作
+* @defaults `git show <args>`
+*/
+const gitShow = async (args, options) => {
+	return runGit(["show", ...args], options);
+};
+/** {@link gitShow} 的同步版本 */
+const gitShowSync = (args, options) => {
+	return runGitSync(["show", ...args], options);
+};
+/**
+* 差异比较操作
+* @defaults `git diff <args>`
+*/
+const gitDiff = async (args = [], options) => {
+	return runGit(["diff", ...args], options);
+};
+/** {@link gitDiff} 的同步版本 */
+const gitDiffSync = (args = [], options) => {
+	return runGitSync(["diff", ...args], options);
+};
+/**
+* 暂存区保存操作
+* @defaults `git stash <args>`
+*/
+const gitStash = async (args = [], options) => {
+	return runGit(["stash", ...args], options);
+};
+/** {@link gitStash} 的同步版本 */
+const gitStashSync = (args = [], options) => {
+	return runGitSync(["stash", ...args], options);
+};
+/**
+* 删除文件操作
+* @defaults `git rm <args>`
+*/
+const gitRm = async (args, options) => {
+	return runGit(["rm", ...args], options);
+};
+/** {@link gitRm} 的同步版本 */
+const gitRmSync = (args, options) => {
+	return runGitSync(["rm", ...args], options);
+};
+/**
+* 移动文件操作
+* @defaults `git mv <args>`
+*/
+const gitMv = async (args, options) => {
+	return runGit(["mv", ...args], options);
+};
+/** {@link gitMv} 的同步版本 */
+const gitMvSync = (args, options) => {
+	return runGitSync(["mv", ...args], options);
+};
+/**
+* 对象内容操作
+* @defaults `git cat-file <args>`
+*/
+const gitCatFile = async (args, options) => {
+	return runGit(["cat-file", ...args], options);
+};
+/** {@link gitCatFile} 的同步版本 */
+const gitCatFileSync = (args, options) => {
+	return runGitSync(["cat-file", ...args], options);
+};
+/**
+* 日志查询操作
+* @defaults `git log <args>`
+*/
+const gitLog = async (args, options) => {
+	return runGit(["log", ...args], options);
+};
+/** {@link gitLog} 的同步版本 */
+const gitLogSync = (args, options) => {
+	return runGitSync(["log", ...args], options);
+};
+/**
+* 仓库初始化操作
+* @defaults `git init <args>`
+*/
+const gitInit = async (args, options) => {
+	return runGit(["init", ...args], options);
+};
+/** {@link gitInit} 的同步版本 */
+const gitInitSync = (args, options) => {
+	return runGitSync(["init", ...args], options);
+};
+/**
+* 获取远程更新操作
+* @defaults `git fetch <args>`
+*/
+const gitFetch = async (args, options) => {
+	return runGit(["fetch", ...args], options);
+};
+/** {@link gitFetch} 的同步版本 */
+const gitFetchSync = (args, options) => {
+	return runGitSync(["fetch", ...args], options);
+};
+// src/add.ts
+/**
+* 暂存所有文件
+* @defaults `git add --all`
+*/
+const gitAddAll = async (args = []) => {
+	await gitAdd(["--all", ...args]);
+};
+/**
+* 暂存已追踪文件
+* @defaults `git add --update`
+*/
+const gitAddTracked = async (args = []) => {
+	await gitAdd(["--update", ...args]);
+};
+// src/branch.ts
+/**
+* 获取当前分支
+* @defaults `git branch --show-current`
+* */
+const gitBranchCurrent = async () => {
+	const branch = await gitBranch(["--show-current"]);
+	if (!branch) throw new Error("Detached HEAD");
+	return branch;
+};
+/**
+* 重命名本地分支
+* @defaults `git branch -m <old-name> <new-name>`
+*/
+const gitBranchMove = async (oldName, newName) => {
+	await gitBranch([
+		"-m",
+		oldName,
+		newName
+	]);
+};
+/**
+* 重命名本地分支（强制）
+* @defaults `git branch -M <old-name> <new-name>`
+*/
+const gitBranchMoveForce = async (oldName, newName) => {
+	await gitBranch([
+		"-M",
+		oldName,
+		newName
+	]);
+};
+/**
+* 删除本地分支
+* @defaults `git branch -d <branch>`
+*/
+const gitBranchDelete = async (branch) => {
+	await gitBranch(["-d", branch]);
+};
+/**
+* 删除本地分支（强制）
+* @defaults `git branch -D <branch>`
+*/
+const gitBranchDeleteForce = async (branch) => {
+	await gitBranch(["-D", branch]);
+};
+/** 获取所有分支 */
+const getLocalBranches = async () => {
+	const res = await gitBranch(["--format", "%(refname:short)"]);
+	return splitNonEmptyLines(res);
+};
+const getRemoteBranches = async () => {
+	const res = await gitBranch([
+		"--remotes",
+		"--format",
+		"%(refname:short)"
+	]);
+	return splitNonEmptyLines(res);
+};
+// src/checkout.ts
+/**
+* 创建并签出
+* @defaults `git checkout -b <branch> <start-point>`
+* @fallback `git checkout <branch>`
+* @see
+* ```
+* git branch <branch> <start-point>
+* git checkout <branch>
+* ```
+*/
+const gitCheckoutBranch = async (branch, startpoint) => {
+	await gitCheckout([
+		"-b",
+		branch,
+		...startpoint ? [startpoint] : []
+	], { error: "throw" }).catch((_) => gitCheckout([branch], { error: "throw" }));
+};
+/**
+* 强制创建/重置并签出
+* @defaults `git checkout -B <branch> <start-point>`
+* @see
+* ```
+* git checkout <start-point>
+* git branch -f <branch> HEAD
+* git checkout <branch>
+* ```
+*/
+const gitCheckoutBranchForce = async (branch, startpoint) => {
+	await gitCheckout([
+		"-B",
+		branch,
+		...startpoint ? [startpoint] : []
+	]);
+};
+/**
+* 创建孤儿分支
+* @defaults `git checkout --orphan <branch>`
+*/
+const gitCheckoutBranchOrphan = async (branch, startpoint) => {
+	await gitCheckout([
+		"--orphan",
+		branch,
+		...startpoint ? [startpoint] : []
+	]);
+};
+// src/commit.ts
+/**
+* 提交
+* @defaults `git commit --message message <args>`
+*/
+const gitCommitMessage = async (message, args = []) => {
+	await gitCommit([
+		"--message",
+		message,
+		...args
+	]);
+};
+/**
+* 空内容提交
+* @defaults `git commit --message message --allow-empty <args>`
+*/
+const gitCommitAllowEmpty = async (message, args = []) => {
+	await gitCommitMessage(message, ["--allow-empty", ...args]);
+};
+/**
+* 修正提交
+* @defaults `git commit --message message --amend <args>`
+*/
+const gitCommitAmend = async (message, args = []) => {
+	await gitCommitMessage(message, ["--amend", ...args]);
+};
+/**
+* 修正提交 保留信息
+* @defaults `git commit --amend --no-edit <args>`
+*/
+const gitCommitAmendNoEdit = async (args = []) => {
+	await gitCommit([
+		"--amend",
+		"--no-edit",
+		...args
+	]);
+};
+// src/config.ts
+/**
+* 获取指定的 git 配置
+* @defaults `git config [--global] --get <key>`
+*/
+const gitConfigGet = async (key, global = false) => {
+	return gitConfig([
+		...global ? ["--global"] : [],
+		"--get",
+		key
+	]);
+};
+/**
+* 指定的 git 配置
+* @defaults `git config [--global] <key> <value>`
+*/
+const gitConfigSet = async (key, value, global = false) => {
+	await gitConfig([
+		...global ? ["--global"] : [],
+		key,
+		value
+	]);
+};
+/**
+* 移除指定配置
+* @defaults `git config [--global] --unset <key>`
+*/
+const gitConfigUnset = async (key, global = false) => {
+	await gitConfig([
+		...global ? ["--global"] : [],
+		"--unset",
+		key
+	]);
+};
+/**
+* 配置列表
+* @defaults `git config [--global] --list`
+*/
+const gitConfigList = async (global = false) => {
+	return gitConfig([...global ? ["--global"] : [], "--list"]);
+};
+// src/tag.ts
+/**
+* 创建 lightweight tag
+* @defaults `git tag <tag> <args>`
+*/
+const gitTagLightweight = async (tag, args = []) => {
+	await gitTag([tag, ...args]);
+};
+/**
+* 创建 annotated tag
+* @defaults `git tag --annotate --message <msg> <tag> <args>`
+*/
+const gitTagAnnotated = async (tag, message = tag, args = []) => {
+	await gitTag([
+		"--annotate",
+		"--message",
+		message,
+		tag,
+		...args
+	]);
+};
+/**
+* 创建 signed tag
+* @defaults `git tag --sign --message <msg> <tag> <args>`
+*/
+const gitTagSigned = async (tag, message = tag, args = []) => {
+	await gitTag([
+		"--sign",
+		"--message",
+		message,
+		tag,
+		...args
+	]);
+};
+/**
+* 删除本地 tag
+* @defaults `git tag --delete <tag> <args>`
+*/
+const gitTagDelete = async (tag, args = []) => {
+	await gitTag([
+		"--delete",
+		tag,
+		...args
+	]);
+};
+/** {@link gitTagDelete} 的同步版本 */
+const gitTagDeleteSync = (tag, args = []) => {
+	gitTagSync([
+		"--delete",
+		tag,
+		...args
+	]);
+};
+let GitSorter = /* @__PURE__ */ function(GitSorter) {
+	GitSorter["NAME_ASC"] = "v:refname";
+	GitSorter["NAME_DESC"] = "-v:refname";
+	GitSorter["DATE_ASC"] = "creatordate";
+	GitSorter["DATE_DESC"] = "-creatordate";
+	return GitSorter;
+}({});
+/**
+* 获取本地所有 tag
+* @defaults `git for-each-ref refs/tags/<match> --format "%(refname:short)" --sort <sort>
+*   --exclude refs/tags/<match> --count <count>`
+*/
+const getLocalTags = async (match = "*", exclude = "*-beta.*", sort = "-v:refname", count = 0) => {
+	const excludes = [exclude].flat().flatMap((k) => [`--exclude`, `refs/tags/${k}`]);
+	const res = await gitForEachRef([
+		`refs/tags/${match}`,
+		...excludes,
+		"--format",
+		"%(refname:short)",
+		`--sort`,
+		`${sort}`,
+		`--count`,
+		`${count}`
+	]);
+	return res ? splitNonEmptyLines(res) : [];
+};
+/**
+* 获取远程所有 tag
+* @defaults `git ls-remote --tags --refs --sort <sort> <remote>`
+*/
+const getRemoteTags = async (remote = "origin", sort = "-v:refname") => {
+	const res = await gitLsRemote([
+		"--tags",
+		"--refs",
+		"--sort",
+		sort,
+		remote
+	]);
+	return res ? splitNonEmptyLines(res).map((t) => t.split("refs/tags/")[1]) : [];
+};
+/** 获取最新 tag */
+const getLatestTag = async (match = "*", exclude = "*-beta.*") => {
+	const [latestTag] = await getLocalTags(match, exclude, "-v:refname", 1);
+	return latestTag;
+};
+/** 获取上一个 tag */
+const getPreviousTag = async (tag, match = "*", exclude = "*-beta.*") => {
+	const all = await getLocalTags(match, exclude, "-v:refname", 0);
+	return all[all.findIndex((k) => tag === k) + 1];
+};
+// src/misc.ts
+/** 初始化裸仓库，模拟远程仓库 */
+const initBareRepo = async (dir) => {
+	await gitInit(["--bare", dir]);
+};
+/** 初始化仓库 */
+const initRepo = async (branch = "master") => {
+	await gitInit(["--initial-branch", branch]);
+};
+/** 判断指定目录是否是 git 仓库 */
+const isGitRepo = async (dir = ".") => {
+	return runGit([
+		"-C",
+		dir,
+		"status"
+	], {
+		error: "throw",
+		trimEnd: true
+	}).then((_) => true).catch((_) => false);
+};
+/** 判断指定目录是否是 git 裸仓库 */
+const isGitBareRepo = async (dir = ".") => {
+	return gitRevParse(["--is-bare-repository"], {
+		trimEnd: true,
+		cwd: dir
+	}).then((res) => "true" === res);
+};
+/** 判断工作区是否干净 */
+const isWorkingTreeClean = async () => {
+	const status = await gitStatus(["--porcelain"]);
+	return !Boolean(status);
+};
+/**
+* 判断当前分支是否已设置 upstream
+* @defaults `git rev-parse --abbrev-ref --symbolic-full-name "<branch>@{u}"`
+*/
+const hasUpstream = async (branch) => {
+	const ref = branch ? `${branch}@{u}` : "@{u}";
+	const upstream = await gitRevParse([
+		"--abbrev-ref",
+		"--symbolic-full-name",
+		ref
+	]);
+	return Boolean(upstream);
+};
+/**
+* 获取完整 hash
+* @defaults `git rev-parse <rev>`
+*/
+const getFullHash = async (rev) => {
+	return gitRevParse([rev]);
+};
+/**
+* 获取短 hash
+* @defaults `git rev-parse --short <rev>`
+*/
+const getShortHash = async (rev) => {
+	return gitRevParse(["--short", rev]);
+};
+/**
+* 提取所有分支
+* @defaults `git fetch --all --prune`
+*/
+const fetchAllPrune = async () => {
+	await gitFetch(["--all", "--prune"]);
+};
+/**
+* 获取当前工作区状态
+* @defaults `git status --short --untracked-files=no`
+*/
+const getShortStatus = async () => {
+	return gitStatus(["--short"]);
+};
+/**
+* 为 git status / changeset 输出添加颜色
+*
+* M -> 黄色（修改）
+* A -> 绿色（新增）
+* D -> 红色（删除）
+* @param {string} log `git status --short` 输出
+* @returns {string}
+*/
+const coloredStatus = (log) => {
+	const colorStatusChar = (ch) => {
+		switch (ch) {
+			case "M": return `\x1b[33m${ch}\x1b[39m`;
+			case "A": return `\x1b[32m${ch}\x1b[39m`;
+			case "D": return `\x1b[31m${ch}\x1b[39m`;
+			case "?": return `\x1b[34m${ch}\x1b[39m`;
+			default: return ch;
+		}
+	};
+	const colorStatus = (status) => status.split("").map(colorStatusChar).join("");
+	return splitNonEmptyLines(log).map((line) => {
+		const status = line.slice(0, 2);
+		const file = line.slice(3);
+		return `${colorStatus(status)} \x1b[2m${file}\x1b[22m`;
+	}).join("\n");
+};
+/**
+* 计算 changelog 的 commit 范围
+* @param {boolean} isIncrement 是否为版本递增发布
+* @param {string} match tag match
+* @param {string} exclude tag exclude
+* @returns {Promise<{from: string, to: string}>}
+*/
+const resolveChangelogRange = async (isIncrement = true, match = "*", exclude = "*-beta.*") => {
+	const latestTag = await getLatestTag(match, exclude);
+	if (!latestTag) return {
+		from: "",
+		to: "HEAD"
+	};
+	const previousTag = await getPreviousTag(latestTag);
+	if (!isIncrement && previousTag) return {
+		from: previousTag,
+		to: `${latestTag}^1`
+	};
+	return {
+		from: latestTag,
+		to: "HEAD"
+	};
+};
+/**
+* 获取指定范围内的 commit 日志
+* @defaults `git log --pretty=format:"* %s (%h)" <from>...<to> -- <scope>`
+*/
+const getLogSince = async (from = "", to = "HEAD", scope) => {
+	const cmd = ["--pretty=format:* %s (%h)"];
+	if (from) cmd.push(`${from}...${to}`);
+	if (scope) cmd.push(...["--", scope]);
+	return gitLog(cmd);
+};
+/** 判断字符串是否为合法 remote 名称 */
+const isRemoteName = async (remote) => {
+	const res = await gitRevParse(["--verify", `refs/remotes/${remote}`]);
+	return Boolean(res);
+};
+/** 统计自 tag 以来的提交数量 */
+const countCommitsSince = async (tag) => {
+	const ref = tag ? `${tag}...HEAD` : "HEAD";
+	return gitRevList([ref, "--count"], { error: "throw" }).then(Number).catch((_) => 0);
+};
+/**
+* 将 HEAD 指向指定分支（不会切换工作区）
+*/
+const gitSetHeadBranch = async (branch) => {
+	await gitSymbolicRef(["HEAD", `refs/heads/${branch}`]);
+};
+/** 删除当前分支引用 */
+const gitDeleteHeadRef = async () => {
+	await gitUpdateRef(["-d", "HEAD"]);
+};
+/**
+* 创建一个没有任何提交的分支状态。
+*/
+const createUnbornBranch = async (branch) => {
+	await gitSymbolicRef(["HEAD", `refs/heads/${branch}`]);
+	await gitUpdateRef(["-d", "HEAD"]);
+};
+// src/push.ts
+/**
+* 推送 tag 到远程
+* @defaults `git push <remote> refs/tags/<tag> <args>`
+*/
+const gitPushTag = async (remote, tag, args = []) => {
+	await gitPush([
+		remote,
+		`refs/tags/${tag}`,
+		...args
+	]);
+};
+/**
+* 推送分支到远程
+* 自动处理 upstream
+* @defaults `git push <remote> <branch> [--set-upstream] <args>`
+*/
+const gitPushBranch = async (remote, branch, args = []) => {
+	const u = !await hasUpstream() ? ["--set-upstream"] : [];
+	await gitPush([
+		remote,
+		branch,
+		...u,
+		...args
+	]);
+};
+/**
+* 删除远程引用（分支、tag）
+* @defaults `git push <remote> <ref> --delete <args>`
+*/
+const gitPushDeleteRef = async (remote, ref, args = []) => {
+	await gitPush([
+		remote,
+		ref,
+		"--delete",
+		...args
+	]);
+};
+// src/remote.ts
+/**
+* 获取 url
+* @defaults `git remote get-url <args>`
+*/
+const gitRemoteGetUrl = async (args) => {
+	return gitRemote(["get-url", ...args]);
+};
+/**
+* 设置 url
+* @defaults `git remote set-url <args>`
+*/
+const gitRemoteSetUrl = async (args) => {
+	await gitRemote(["set-url", ...args]);
+};
+/**
+* 添加远程
+* @defaults `git remote add <name> <url>`
+*/
+const gitRemoteAdd = async (name, url) => {
+	await gitRemote([
+		"add",
+		name,
+		url
+	]);
+};
+/**
+* 重命名远程
+* @defaults `git remote rename <old-name> <new-name>`
+*/
+const gitRemoteRename = async (oldName, newName) => {
+	await gitRemote([
+		"rename",
+		oldName,
+		newName
+	]);
+};
+/**
+* 移除远程
+* @defaults `git remote remove <name>`
+*/
+const gitRemoteRemove = async (name) => {
+	await gitRemote(["remove", name]);
+};
+/** 获取关联的所有远程 */
+const getRemoteNames = async () => {
+	const res = await gitRemote([]);
+	return res ? splitNonEmptyLines(res) : [];
+};
+/** 获取远程地址 */
+const getRemoteUrl = async (remote) => {
+	return gitRemoteGetUrl([remote]);
+};
+/** 获取所有远程 */
+const getRemoteList = async () => {
+	const remotes = await getRemoteNames();
+	return Promise.all(remotes.map(async (name) => {
+		return {
+			name,
+			url: await gitRemoteGetUrl([name])
+		};
+	}));
+};
+// src/undo.revert.ts
+/**
+* 安全撤销一个已提交（并可能已 push）的 commit
+* @defaults `git revert <commit>`
+*/
+const gitRevertCommit = async (hash) => {
+	await gitRevert([hash]);
+};
+// src/undo.reset.ts
+const headArg = (count = 1) => {
+	if (count < 0) throw new RangeError("count must be >= 0");
+	return count === 0 ? "HEAD" : `HEAD~${count}`;
+};
+/**
+* 撤销最近的 commit（移动 HEAD + 取消暂存）
+* - 暂存区被重置到目标 commit
+* - 未提交修改保持不变
+* @defaults `git reset --mixed HEAD~<count>`
+*/
+const gitResetMixed = async (count = 1) => {
+	await gitReset(["--mixed", headArg(count)]);
+};
+/**
+* 撤销最近的 commit（完全重置）
+* - 暂存区 + 工作区都会被重置到目标 commit
+* - 未提交修改会丢失
+* @defaults `git reset --hard HEAD~<count>`
+*/
+const gitResetHard = async (count = 1) => {
+	await gitReset(["--hard", headArg(count)]);
+};
+/**
+* 撤销最近的 commit（仅移动 HEAD）
+* - 暂存区保持不变
+* - 未提交修改保持不变
+* @defaults `git reset --soft HEAD~<count>`
+*/
+const gitResetSoft = async (count = 1) => {
+	await gitReset(["--soft", headArg(count)]);
+};
+/**
+* 撤销最近的 commit（安全重置）
+* - 行为类似 --hard
+* - 若会覆盖工作区未提交修改则直接失败
+* @defaults `git reset --keep HEAD~<count>`
+*/
+const gitResetKeep = async (count = 1) => {
+	await gitReset(["--keep", headArg(count)]);
+};
+/** {@link gitResetMixed} 的同步版本 */
+const gitResetMixedSync = (count = 1) => {
+	gitResetSync(["--mixed", headArg(count)]);
+};
+/** {@link gitResetHard} 的同步版本 */
+const gitResetHardSync = (count = 1) => {
+	gitResetSync(["--hard", headArg(count)]);
+};
+/** {@link gitResetSoft} 的同步版本 */
+const gitResetSoftSync = (count = 1) => {
+	gitResetSync(["--soft", headArg(count)]);
+};
+/** {@link gitResetKeep} 的同步版本 */
+const gitResetKeepSync = (count = 1) => {
+	gitResetSync(["--keep", headArg(count)]);
+};
+// src/undo.restore.ts
+/**
+* 用【暂存区】覆盖【工作区】单个文件
+* - 用 Index 覆盖 Working Tree
+* - 不影响暂存区（Index）
+* @defaults `git restore --worktree <file>`
+*/
+const gitRestoreFile = async (file) => {
+	await gitRestore(["--worktree", file]);
+};
+/**
+* 用【暂存区】覆盖【工作区】所有文件
+* - 用 Index 覆盖 Working Tree
+* - 不影响暂存区（Index）
+* @defaults `git --worktree restore .`
+*/
+const gitRestoreAll = async () => {
+	await gitRestore(["--worktree", "."]);
+};
+/**
+* 用 指定 source 中的文件内容覆盖【工作区】文件
+* - 仅修改 Working Tree
+* - 不影响暂存区（Index）
+* - 不会改变提交历史（HEAD）
+* @defaults `git restore --worktree --source <source> <file>`
+* @see source = `git rev-parse <expr>`
+*/
+const gitRestoreWorktreeFileFrom = async (source, file) => {
+	await gitRestore([
+		"--worktree",
+		"--source",
+		source,
+		file
+	]);
+};
+/**
+* 用指定 source 中的文件内容覆盖【工作区】所有文件
+* - 仅修改 Working Tree
+* - 不影响暂存区（Index）
+* - 不会改变提交历史（HEAD）
+* @defaults `git restore --worktree --source <source> .`
+* @see source = `git rev-parse <expr>`
+*/
+const gitRestoreWorktreeAllFrom = async (source) => {
+	await gitRestore([
+		"--worktree",
+		"--source",
+		source,
+		"."
+	]);
+};
+/**
+* 用指定 source 覆盖【暂存区】中的文件
+* - 用 source 覆盖 Index
+* - 不影响工作区（Working Tree）
+* - 不会改变提交历史（HEAD）
+* @defaults `git restore --staged --source <source> <file>`
+* @see source = `git rev-parse <expr>`
+*/
+const gitRestoreIndexFileFrom = async (source, file) => {
+	await gitRestore([
+		`--staged`,
+		"--source",
+		source,
+		file
+	]);
+};
+/**
+* 用指定 source 覆盖整个【暂存区】
+* - 用 source 覆盖 Index
+* - 不影响工作区（Working Tree）
+* - 不会改变提交历史（HEAD）
+* @defaults `git restore --staged --source <source> .`
+* @see source = `git rev-parse <expr>`
+*/
+const gitRestoreIndexAllFrom = async (source) => {
+	await gitRestore([
+		`--staged`,
+		"--source",
+		source,
+		"."
+	]);
+};
+/**
+* 用指定 source 覆盖指定文件（暂存区 + 工作区）
+* - 将 Index 和 Working Tree 恢复到 source 状态
+* - 不会移动 HEAD
+* - 不会改变提交历史
+* @defaults `git restore --staged --worktree --source <source> <file>`
+* @see source = `git rev-parse <expr>`
+*/
+const gitRestoreFileFrom = async (source, file) => {
+	await gitRestore([
+		"--staged",
+		"--worktree",
+		"--source",
+		source,
+		file
+	]);
+};
+/**
+* 用指定 source 覆盖所有文件（暂存区 + 工作区）
+* - 将 Index 和 Working Tree 恢复到 source 状态
+* - 不会移动 HEAD
+* - 不会改变提交历史
+* @defaults `git restore --staged --worktree --source <source> .`
+* @see source = `git rev-parse <expr>`
+*/
+const gitRestoreAllFrom = async (source) => {
+	await gitRestore([
+		"--staged",
+		"--worktree",
+		"--source",
+		source,
+		"."
+	]);
+};
+// src/undo.unstaged.ts
+/**
+* 取消单个文件的暂存状态
+* - 用 HEAD 覆盖暂存区（Index）
+* - 不影响工作区（Working Tree）
+* - 等价于撤销 git add
+* @defaults `git restore --staged <file>`
+*/
+const gitUnstageFile = async (file) => {
+	await gitRestore(["--staged", file]);
+};
+/**
+* 取消所有文件的暂存状态
+* - 用 HEAD 覆盖暂存区（Index）
+* - 不影响工作区（Working Tree）
+* - 等价于撤销所有 git add
+* @defaults `git restore --staged .`
+*/
+const gitUnstageAll = async () => {
+	await gitRestore(["--staged", "."]);
+};
+// src/undo.discard.ts
+/**
+* 丢弃指定文件的所有修改（暂存区 + 工作区）
+* - 强制将文件恢复到 HEAD 状态
+* - 同时重置 Index 和 Working Tree
+* - 不会改变提交历史（HEAD）
+* @defaults `git restore --source=HEAD --staged --worktree <file>`
+*/
+const gitDiscardFile = async (file) => {
+	await gitRestore([
+		"--staged",
+		"--worktree",
+		"--source=HEAD",
+		file
+	]);
+};
+/**
+* 丢弃所有文件的所有修改（暂存区 + 工作区）
+* - 强制将整个工作区恢复到 HEAD 状态
+* - 行为等价于 git reset --hard HEAD（按文件粒度）
+* - 不会删除未跟踪文件（untracked files）
+* @defaults `git restore --source=HEAD --staged --worktree .`
+*/
+const gitDiscardAll = async () => {
+	await gitRestore([
+		"--staged",
+		"--worktree",
+		"--source=HEAD",
+		"."
+	]);
+};
+export { GitSorter, coloredStatus, countCommitsSince, createUnbornBranch, fetchAllPrune, getFullHash, getLatestTag, getLocalBranches, getLocalTags, getLogSince, getPreviousTag, getRemoteBranches, getRemoteList, getRemoteNames, getRemoteTags, getRemoteUrl, getShortHash, getShortStatus, gitAdd, gitAddAll, gitAddSync, gitAddTracked, gitBranch, gitBranchCurrent, gitBranchDelete, gitBranchDeleteForce, gitBranchMove, gitBranchMoveForce, gitBranchSync, gitCatFile, gitCatFileSync, gitCheckout, gitCheckoutBranch, gitCheckoutBranchForce, gitCheckoutBranchOrphan, gitCheckoutSync, gitCommit, gitCommitAllowEmpty, gitCommitAmend, gitCommitAmendNoEdit, gitCommitMessage, gitCommitSync, gitConfig, gitConfigGet, gitConfigList, gitConfigSet, gitConfigSync, gitConfigUnset, gitDeleteHeadRef, gitDiff, gitDiffSync, gitDiscardAll, gitDiscardFile, gitFetch, gitFetchSync, gitForEachRef, gitForEachRefSync, gitInit, gitInitSync, gitLog, gitLogSync, gitLsRemote, gitLsRemoteSync, gitMv, gitMvSync, gitPush, gitPushBranch, gitPushDeleteRef, gitPushSync, gitPushTag, gitRemote, gitRemoteAdd, gitRemoteGetUrl, gitRemoteRemove, gitRemoteRename, gitRemoteSetUrl, gitRemoteSync, gitReset, gitResetHard, gitResetHardSync, gitResetKeep, gitResetKeepSync, gitResetMixed, gitResetMixedSync, gitResetSoft, gitResetSoftSync, gitResetSync, gitRestore, gitRestoreAll, gitRestoreAllFrom, gitRestoreFile, gitRestoreFileFrom, gitRestoreIndexAllFrom, gitRestoreIndexFileFrom, gitRestoreSync, gitRestoreWorktreeAllFrom, gitRestoreWorktreeFileFrom, gitRevList, gitRevListSync, gitRevParse, gitRevParseSync, gitRevert, gitRevertCommit, gitRevertSync, gitRm, gitRmSync, gitSetHeadBranch, gitShow, gitShowSync, gitStash, gitStashSync, gitStatus, gitStatusSync, gitSymbolicRef, gitSymbolicRefSync, gitTag, gitTagAnnotated, gitTagDelete, gitTagDeleteSync, gitTagLightweight, gitTagSigned, gitTagSync, gitUnstageAll, gitUnstageFile, gitUpdateRef, gitUpdateRefSync, hasUpstream, headArg, initBareRepo, initRepo, isGitBareRepo, isGitRepo, isRemoteName, isWorkingTreeClean, resolveChangelogRange };