@quiteer/scripts 0.0.3 → 0.0.5

package/README.md

@@ -0,0 +1,68 @@
+# @quiteer/scripts
+
+简化多包仓库的版本管理与变更日志生成，提供便捷的 CLI 命令。
+
+## 安装
+
+- 全局安装（推荐）
+
+```bash
+pnpm i -g @quiteer/scripts
+# 或者
+npm i -g @quiteer/scripts
+```
+
+- 项目内安装（作为开发依赖）
+
+```bash
+pnpm add -D @quiteer/scripts
+```
+
+> 运行环境：Node.js ≥ 22.14.0，建议使用 pnpm 管理依赖。
+
+## 快速使用
+
+- 查看版本
+
+```bash
+qui -v
+```
+
+- 版本管理与打标签（支持多包选择与自定义前缀标签，同时生成全量 changelog）
+
+```bash
+# 交互选择需要提升版本的包
+qui r --tag-prefix scripts
+```
+
+- 生成全量变更日志（中文，生成 CHANGELOG.md 与 CHANGELOG_TIMELINE.md）
+
+```bash
+qui cl
+```
+
+- 规范化提交（交互式生成符合 Conventional Commits 的提交信息）
+
+```bash
+qui gc
+```
+
+## 常用工作流示例
+
+```bash
+# 1) 更新版本并创建标签（例如为 scripts 包增加前缀）
+qui r --tag-prefix scripts
+
+# 2) 生成 changelog（默认生成全部历史）
+qui cl
+
+# 3) 提交并推送（如需发布）
+git add -A && git commit -m "docs(changelog): update"
+# 可选：git push && git push --tags
+```
+
+## 说明
+
+- 多包仓库：发布时可交互选择要更新的包，未选中的包不受影响。
+- 标签前缀：标签命名为 `<prefix>-vX.Y.Z`，可避免多包仓库中的全局标签冲突。
+- changelog：默认基于仓库最初提交到当前 HEAD 的全量历史生成。

package/dist/index.mjs

@@ -12,7 +12,7 @@ import enquirer from "enquirer";
 import { versionBump } from "bumpp";
 
 //#region package.json
-var version = "0.0.2";
+var version = "0.0.4";
 
 //#endregion
 //#region src/locales/changelog.ts
@@ -196,13 +196,6 @@ function getTypeIcon(type) {
 		"typo": "✏️ "
 	}[type] || "";
 }
-async function getTags() {
-	return (await execCommand("git", [
-		"tag",
-		"--list",
-		"--sort=-version:refname"
-	])).split("\n").filter(Boolean);
-}
 async function getRootCommit() {
 	return await execCommand("git", [
 		"rev-list",
@@ -210,15 +203,6 @@ async function getRootCommit() {
 		"HEAD"
 	]);
 }
-async function getDateForRef(ref) {
-	return await execCommand("git", [
-		"log",
-		"-1",
-		"--date=short",
-		"--format=%ad",
-		ref
-	]) || (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-}
 async function getCommitsInRange(range) {
 	return (await execCommand("git", [
 		"log",
@@ -378,18 +362,10 @@ function formatTimeline(items, repoUrl) {
 async function generateChangelogFiles(options) {
 	const repoRoot = await execCommand("git", ["rev-parse", "--show-toplevel"]);
 	const homepage = await readHomepage();
-	const tags = await getTags();
-	let title = "未发布";
-	let date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-	let range = "";
-	if (tags.length >= 1) {
-		const latest = tags[0];
-		const prev = tags[1];
-		title = latest;
-		date = await getDateForRef(latest);
-		range = prev ? `${prev}..${latest}` : `${await getRootCommit()}..${latest}`;
-	} else range = "HEAD";
-	let items = await getCommitsInRange(range);
+	const root = await getRootCommit();
+	const title = "全部历史";
+	const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+	let items = await getCommitsInRange(`${root}..HEAD`);
 	items = await enrichCommit(items);
 	const fallback = [
 		`## ${title} - ${date}`,
@@ -693,6 +669,137 @@ async function updatePkg(args = ["--deep", "-u"]) {
 	execCommand("npx", ["npm-check-updates", ...args], { stdio: "inherit" });
 }
 
+//#endregion
+//#region src/commands/git-branches.ts
+/**
+* 列出远程仓库所有分支（含最新提交时间），并按时间倒序打印
+* - 会先执行 `git fetch --prune --tags` 同步远程引用
+* - 通过 `git for-each-ref` 获取 `refs/remotes/<remote>` 下的分支与提交时间
+* @param remote 远程仓库名，默认 `origin`
+* @returns Promise<void>
+*/
+async function gitRemoteBranches(urlOrRemote) {
+	const temp = "gb-temp";
+	const target = (urlOrRemote || "").trim();
+	let refBase = "";
+	try {
+		if (target) {
+			await execCommand("git", [
+				"fetch",
+				target,
+				`+refs/heads/*:refs/remotes/${temp}/*`,
+				"--prune",
+				"--no-tags"
+			]);
+			refBase = `refs/remotes/${temp}`;
+		} else {
+			const r = "origin";
+			await execCommand("git", [
+				"fetch",
+				r,
+				"--prune",
+				"--tags"
+			]);
+			refBase = `refs/remotes/${r}`;
+		}
+	} catch {
+		console.log("拉取远程分支失败，请检查 URL 或网络连接");
+		return;
+	}
+	const lines = (await execCommand("git", [
+		"for-each-ref",
+		"--format=%(refname:short)	%(committerdate:relative)	%(objectname:short)	%(contents:subject)",
+		"--sort=-committerdate",
+		refBase
+	])).split("\n").filter(Boolean);
+	if (lines.length === 0) {
+		console.log("未找到远程分支，请确认已配置远程并有追踪分支");
+		return;
+	}
+	/**
+	* 英文相对时间转中文
+	* @param rel 英文相对时间字符串（如：2 hours ago）
+	* @returns 中文相对时间（如：2小时前）
+	*/
+	function zhRelative(rel) {
+		const s = rel.toLowerCase().trim();
+		let m;
+		if (m = s.match(/^(\d+)\s+seconds?\s+ago$/)) return `${m[1]}秒前`;
+		if (m = s.match(/^(\d+)\s+minutes?\s+ago$/)) return `${m[1]}分钟前`;
+		if (m = s.match(/^(\d+)\s+hours?\s+ago$/)) return `${m[1]}小时前`;
+		if (m = s.match(/^(\d+)\s+days?\s+ago$/)) return `${m[1]}天前`;
+		if (m = s.match(/^(\d+)\s+weeks?\s+ago$/)) return `${m[1]}周前`;
+		if (m = s.match(/^(\d+)\s+months?\s+ago$/)) return `${m[1]}个月前`;
+		if (m = s.match(/^(\d+)\s+years?\s+ago$/)) return `${m[1]}年前`;
+		if (s === "yesterday") return "昨天";
+		if (s === "today") return "今天";
+		if (m = s.match(/^about\s+(\d+)\s+hours?\s+ago$/)) return `${m[1]}小时前`;
+		if (m = s.match(/^about\s+(\d+)\s+minutes?\s+ago$/)) return `${m[1]}分钟前`;
+		if (m = s.match(/^about\s+(\d+)\s+days?\s+ago$/)) return `${m[1]}天前`;
+		if (m = s.match(/^about\s+(\d+)\s+months?\s+ago$/)) return `${m[1]}个月前`;
+		if (m = s.match(/^about\s+(\d+)\s+years?\s+ago$/)) return `${m[1]}年前`;
+		return rel;
+	}
+	/**
+	* 计算字符串在等宽终端中的显示宽度（简单处理全角字符为宽度 2）
+	* @param s 输入字符串（不含 ANSI 颜色码）
+	* @returns 可视宽度
+	*/
+	function displayWidth(s) {
+		let w = 0;
+		for (const ch of s) {
+			const code = ch.codePointAt(0) || 0;
+			w += code >= 4352 && code <= 4447 || code >= 11904 && code <= 42191 || code >= 44032 && code <= 55203 || code >= 63744 && code <= 64255 || code >= 65040 && code <= 65049 || code >= 65072 && code <= 65135 || code >= 65280 && code <= 65376 || code >= 65504 && code <= 65510 ? 2 : 1;
+		}
+		return w;
+	}
+	/**
+	* 基于显示宽度的左对齐填充
+	* @param s 源字符串
+	* @param width 目标显示宽度
+	* @returns 左对齐并填充空格的字符串
+	*/
+	function padEndDisplay(s, width) {
+		const w = displayWidth(s);
+		if (w >= width) return s;
+		return s + " ".repeat(width - w);
+	}
+	const rows = lines.map((line) => {
+		const [nameRaw, relRaw, shaRaw, subjectRaw] = line.split("	");
+		return {
+			name: nameRaw.replace(/^.+\//, ""),
+			relZh: zhRelative(relRaw || ""),
+			sha: (shaRaw || "").slice(0, 7),
+			subject: subjectRaw || ""
+		};
+	}).filter((item) => item.name && item.name !== "HEAD");
+	const nameWidth = Math.max(...rows.map((r) => displayWidth(r.name)));
+	const relValues = rows.map((r) => `(${r.relZh})`);
+	const relWidth = Math.max(...relValues.map((v) => displayWidth(v)), 0);
+	const label = " 最新 ";
+	const labelWidth = displayWidth(label);
+	const tag = bgGreen(white(label));
+	const pad = " ".repeat(labelWidth);
+	rows.forEach((row, i) => {
+		const relText = padEndDisplay(`(${row.relZh})`, relWidth);
+		const line = `${padEndDisplay(row.name, nameWidth)}  ${relText}  ${row.sha} ${row.subject}`;
+		if (i === 0) console.log(`${tag} ${lightGreen(line)}`);
+		else console.log(`${pad} ${white(line)}`);
+	});
+	if (target) {
+		const refnames = await execCommand("git", [
+			"for-each-ref",
+			"--format=%(refname)",
+			refBase
+		]);
+		for (const ref of refnames.split("\n").filter(Boolean)) await execCommand("git", [
+			"update-ref",
+			"-d",
+			ref
+		]);
+	}
+}
+
 //#endregion
 //#region src/index.ts
 async function setupCli() {
@@ -727,6 +834,9 @@ async function setupCli() {
 	cli.command("git-commit-verify", `${bgGreen(white("便捷命令"))} ${lightBlue("qui gv")}  校验提交信息是否符合 Conventional Commits 标准`).alias("gv").option("-l --lang", "校验提交信息的语言", { default: cliOptions.lang }).action(async (args) => {
 		await gitCommitVerify(args?.lang, cliOptions.gitCommitVerifyIgnores);
 	});
+	cli.command("git-branches [url]", `${bgGreen(white("便捷命令"))} ${lightBlue("qui gb")}  查看远程仓库所有分支（分支名 + 最新时间），倒序排序`).alias("gb").action(async (url) => {
+		await gitRemoteBranches(url);
+	});
 	cli.command("release", `${bgGreen(white("便捷命令"))} ${lightBlue("qui r")}  版本管理：选择包并提升版本，创建自定义前缀标签并生成 changelog`).alias("r").option("--tag-prefix <prefix>", "标签前缀（可选，留空则交互输入）").action(async (args) => {
 		await release(args?.tagPrefix);
 	});

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@quiteer/scripts",
   "type": "module",
-  "version": "0.0.3",
-  "homepage": "https://github.com/TaiAiAc/web",
+  "version": "0.0.5",
+  "homepage": "https://taiaiac.github.io/web/ci/scripts.html",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"