@quiteer/scripts 0.0.2 → 0.0.4

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

@@ -8,11 +8,11 @@ import { execa } from "execa";
 import { rimraf } from "rimraf";
 import { loadConfig } from "c12";
 import { readFileSync } from "node:fs";
-import { prompt } from "enquirer";
+import enquirer from "enquirer";
 import { versionBump } from "bumpp";
 
 //#region package.json
-var version = "0.0.2";
+var version = "0.0.3";
 
 //#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}`,
@@ -526,15 +502,16 @@ async function generateConfig() {
 * @returns {Promise<void>} 异步任务
 */
 async function gitCommitAdd() {
+	const { prompt: ask } = enquirer;
 	try {
-		if (!!!(await prompt([{
+		if (!!!(await ask([{
 			name: "confirm",
 			type: "confirm",
 			message: "是否添加所有变更文件到暂存区？"
 		}]))?.confirm) {
 			const files = (await execCommand("git", ["diff", "--name-only"])).split("\n").filter(Boolean);
 			if (files.length === 0) return;
-			const selected = (await prompt([{
+			const selected = (await ask([{
 				name: "selected",
 				type: "multiselect",
 				message: "选择需要添加到暂存区的文件（空格选择，回车确认）",
@@ -558,6 +535,7 @@ async function gitCommitAdd() {
 */
 async function gitCommit(lang = "en-us") {
 	try {
+		const { prompt: ask } = enquirer;
 		const { gitCommitMessages, gitCommitTypes, gitCommitScopes } = locales[lang];
 		const typesChoices = gitCommitTypes.map(([value, msg]) => {
 			return {
@@ -569,7 +547,7 @@ async function gitCommit(lang = "en-us") {
 			name: value,
 			message: `${value.padEnd(30)} (${msg})`
 		}));
-		const result = await prompt([
+		const result = await ask([
 			{
 				name: "types",
 				type: "select",
@@ -621,6 +599,7 @@ async function gitCommitVerify(lang = "zh-cn", ignores = []) {
 * @returns {Promise<void>} 异步任务
 */
 async function release(tagPrefix) {
+	const { prompt: ask } = enquirer;
 	const repoRoot = await execCommand("git", ["rev-parse", "--show-toplevel"]);
 	const files = (await execCommand("git", [
 		"-C",
@@ -637,7 +616,7 @@ async function release(tagPrefix) {
 			value: rel
 		});
 	} catch {}
-	const selected = ((await prompt([{
+	const selected = ((await ask([{
 		name: "selected",
 		type: "multiselect",
 		message: "选择需要提升版本的包（空格选择，回车确认）",
@@ -656,7 +635,7 @@ async function release(tagPrefix) {
 	const version$1 = JSON.parse(await readFile(firstPkgPath, "utf8")).version;
 	let prefix = tagPrefix;
 	if (prefix === void 0) try {
-		prefix = (await prompt([{
+		prefix = (await ask([{
 			name: "prefix",
 			type: "text",
 			message: "请输入标签前缀（可留空）"

package/package.json

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