@peiyanlu/release 0.0.14 → 0.0.16

package/README.md

@@ -122,7 +122,9 @@ export default defineConfig({
   packages: [],
   getPkgDir: (pkg) => `.`,
   toTag: (pkg: string, version: string) => `v${ version }`,
-  tagPrefix: undefined,
+  changelog: {
+    tagPrefix: undefined,
+  },
   
   git: {
     commit: true,
@@ -157,7 +159,9 @@ export default defineConfig({
   packages: [ 'demo-a', 'demo-b' ],
   getPkgDir: (pkg) => `packages/${ pkg }`,
   toTag: (pkg: string, version: string) => `${ pkg }@${ version }`,
-  tagPrefix: (pkg: string) => `${ pkg }@`,
+  changelog: {
+    tagPrefix: (pkg: string) => `${ pkg }@`,
+  },
   
   git: {
     commit: true,

package/dist/cli.mjs

@@ -1,15 +1,14 @@
 import path, { join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { bumpPackageVersion, coloredChangeset, eol, execAsync, getAllRemotes, getAuthenticatedUser, getCurrentBranch, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLog, getPackageInfo, getPackageUrl, getPublishedVersion, getRemote, getStatus, gitAddAll, gitAddTracked, gitCommit, gitTagAnnotated, hasWriteAccess, isGitRepo, isOtpError, isPrerelease, isValid, isWorkingDirClean, parseGitHubRepo, parseVersion, pingRegistry, publishPackage, pushBranch, pushTag, readJsonFile, resolveChangelogRange, resolvePublishTag } from "@peiyanlu/cli-utils";
+import { bumpPackageVersion, canPublish, coloredStatus, eol, execAsync, getAuthenticatedUser, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLogSince, getPackageInfo, getPackageUrl, getPublishedVersion, getRemoteList, getRemoteNames, getShortStatus, gitAddAll, gitAddTracked, gitBranchCurrent, gitCommitMessage, gitPushBranch, gitPushTag, gitResetHardSync, gitTagAnnotated, gitTagDeleteSync, hasWriteAccess, isGitRepo, isOtpError, isPrerelease, isValidVersion, isWorkingTreeClean, parseGitHubRepo, parseVersion, pingRegistry, publishPackage, readJsonFile, resolveChangelogRange, resolvePublishTag } from "@peiyanlu/cli-utils";
 import { dim, green, red, rgb, underline, yellow } from "ansis";
 import { program } from "commander";
 import { createReadStream, createWriteStream, existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { cancel, confirm, group, intro, isCancel, log, outro, select, tasks, text } from "@clack/prompts";
+import { castArray, isFunction, isPlainObject, isUndefined, isZero } from "@peiyanlu/ts-utils";
 import { publint } from "publint";
 import { formatMessage } from "publint/utils";
 import { inc, neq } from "semver";
-import { castArray, isFunction, isPlainObject, isUndefined } from "@peiyanlu/ts-utils";
-import { spawnSync } from "node:child_process";
 import { inspect } from "node:util";
 import { ConventionalChangelog } from "conventional-changelog";
 import createPreset from "conventional-changelog-conventionalcommits";
@@ -19,7 +18,7 @@ import { Octokit } from "@octokit/rest";
 import { contentType } from "mime-types";
 import open from "open";
 import { glob } from "tinyglobby";
-//#region node_modules/.pnpm/tsdown@0.22.1_publint@0.3.21_typescript@6.0.3/node_modules/tsdown/esm-shims.js
+//#region node_modules/.pnpm/tsdown@0.22.3_publint@0.3.21_typescript@6.0.3/node_modules/tsdown/esm-shims.js
 const getFilename = () => fileURLToPath(import.meta.url);
 const getDirname = () => path.dirname(getFilename());
 const __dirname = /* @__PURE__ */ getDirname();
@@ -45,22 +44,21 @@ const loadConfig = async (file) => {
 const resolveConfig = async (cwd) => {
 	const configFile = findConfigFile(cwd);
 	if (!configFile) return {
-		configPath: "",
+		configFile: "",
 		config: {}
 	};
 	return {
-		configPath: configFile,
+		configFile,
 		config: await loadConfig(configFile)
 	};
 };
 const mergeConfig = (defaults, overrides) => {
-	if (!overrides) return structuredClone(defaults);
-	if (Object.keys(defaults).length === 0) return structuredClone(overrides);
 	const result = {};
-	for (const key in defaults) {
+	for (const key of Object.keys(defaults)) {
 		const defaultValue = defaults[key];
 		const overrideValue = overrides[key];
-		if (overrideValue === void 0) if (isFunction(defaultValue)) result[key] = defaultValue;
+		if (isUndefined(overrideValue)) if (isFunction(defaultValue)) result[key] = defaultValue;
+		else if (isPlainObject(defaultValue)) result[key] = mergeConfig(defaultValue, {});
 		else result[key] = structuredClone(defaultValue);
 		else if (isPlainObject(defaultValue) && isPlainObject(overrideValue)) result[key] = mergeConfig(defaultValue, overrideValue);
 		else if (isFunction(overrideValue)) result[key] = overrideValue;
@@ -134,13 +132,14 @@ const MSG = {
 		GIT_WORKDIR: `[git] Working dir must be clean`,
 		GIT_REGISTRY: (name) => `[git] Repository not found for ${dim(name)}`,
 		GIT_REMOTE: (name) => `[git] Remote "${dim(name)}" not found`,
-		GITHUB_TAG_EXIT: (tag) => `[github] Release or tag "${tag}" already exists`,
+		GITHUB_TAG_EXIT: (tag) => `[github] Release for tag "${tag}" already exists and is not a draft`,
 		GITHUB_TOKEN: (tokenRef) => `[github] Missing GitHub token. Please set ${yellow(tokenRef ?? "GITHUB_TOKEN")}`,
 		GITHUB_AUTH: "[github] Invalid GitHub token or insufficient permissions",
 		GITHUB_USER: "[github] User does not have permission to create releases",
 		NPM_REGISTRY: (registry) => `[npm] Unable to reach npm registry ${underline(dim(registry))}`,
-		NPM_AUTH: `[npm] Not authenticated with npm. Please run ${yellow("npm login")} and try again.`,
-		NPM_USER: (user, name) => `[npm] User ${dim(user)} is not a collaborator of ${dim(name)}.`
+		NPM_AUTH: `[npm] Not authenticated with npm. Please run ${yellow("npm login")} and try again`,
+		NPM_PERMISSION: `[npm] Missing publish permission. Please use a token with publish access and try again`,
+		NPM_USER: (user, name) => `[npm] User ${dim(user)} is not a collaborator of ${dim(name)}`
 	},
 	ABORT: {
 		CANCEL: "Operation cancelled",
@@ -168,12 +167,12 @@ const gitCheck = async (ctx, config) => {
 		ctx.noGitHub = true;
 		return;
 	}
-	if (requireWorkDirClean && !await isWorkingDirClean()) throw new Error(MSG.ERROR.GIT_WORKDIR);
+	if (requireWorkDirClean && !await isWorkingTreeClean()) throw new Error(MSG.ERROR.GIT_WORKDIR);
 	if (ignoreGithub) {
 		ctx.noGitHub = true;
 		return;
 	}
-	const { remoteName, remoteUrl } = await getRemote();
+	const { name: remoteName, url: remoteUrl } = (await getRemoteList())[0];
 	if (!remoteUrl) if (requireRemote) throw new Error(MSG.ERROR.GIT_REMOTE(name));
 	else {
 		ctx.noGitHub = true;
@@ -194,18 +193,18 @@ const commitAndTag = async (ctx, config) => {
 	const { git: { commit, tag, push, addUntrackedFiles, commitArgs, tagArgs, pushArgs } } = config;
 	if (!commit) return;
 	const args = dryRun ? ["--dry-run"] : [];
-	addUntrackedFiles ? await gitAddAll() : await gitAddTracked(args);
-	await gitCommit(commitMessage, [...commitArgs, ...args]);
+	addUntrackedFiles ? await gitAddAll(args) : await gitAddTracked(args);
+	await gitCommitMessage(commitMessage, [...commitArgs, ...args]);
 	if (!dryRun) Object.assign(ctx.git, { isCommitted: true });
 	if (tag) {
 		await gitTagAnnotated(currentTag, tagMessage, [...tagArgs, ...args]);
 		if (!dryRun) Object.assign(ctx.git, { isTagged: true });
 	}
 	if (push) {
-		const remotes = await getAllRemotes();
+		const remotes = await getRemoteNames();
 		for (const remoteName of remotes) {
-			await pushTag(remoteName, currentTag, args);
-			await pushBranch(remoteName, await getCurrentBranch(), [...pushArgs, ...args]);
+			await gitPushTag(remoteName, currentTag, args);
+			await gitPushBranch(remoteName, await gitBranchCurrent(), [...pushArgs, ...args]);
 		}
 		if (!dryRun) Object.assign(ctx.git, { isPushed: true });
 	}
@@ -213,40 +212,8 @@ const commitAndTag = async (ctx, config) => {
 const gitRollback = (ctx) => {
 	const { git: { currentTag, isCommitted, isTagged, isPushed } } = ctx;
 	if (isPushed) return;
-	spawnSync("git", ["restore", "."]);
-	if (isTagged) spawnSync("git", [
-		"tag",
-		"--delete",
-		currentTag
-	]);
-	spawnSync("git", [
-		"reset",
-		"--hard",
-		isCommitted ? "HEAD~1" : "HEAD"
-	]);
-};
-//#endregion
-//#region src/prompts.ts
-const abortTask = (msg) => {
-	cancel(`${red("✕")} ${msg}`);
-	process.exit(0);
-};
-const abortSinglePrompt = (value) => {
-	if (isCancel(value)) abortTask(MSG.ABORT.CANCEL);
-};
-const abortGroupPrompt = (ctx) => {
-	ctx && gitRollback(ctx);
-	abortTask(MSG.ABORT.CANCEL);
-};
-const abortOnError = (err, ctx, exit = true) => {
-	ctx && gitRollback(ctx);
-	const msg = err.message.replace(/^\[(github|npm|git)]/, (a) => red(a));
-	log.message(`\n${msg}\n`);
-	exit && process.exit(1);
-};
-const taskEnd = (msg) => {
-	outro(msg);
-	process.exit(0);
+	if (isTagged) gitTagDeleteSync(currentTag);
+	gitResetHardSync(isCommitted ? 1 : 0);
 };
 //#endregion
 //#region src/utils.ts
@@ -301,6 +268,27 @@ const formatTemplate = async (ctx, config) => {
 	});
 	Object.assign(ctx.github, { releaseName });
 };
+const abortTask = (msg) => {
+	cancel(`${red("✕")} ${msg}`);
+	process.exit(0);
+};
+const abortSinglePrompt = (value) => {
+	if (isCancel(value)) abortTask(MSG.ABORT.CANCEL);
+};
+const abortGroupPrompt = (ctx) => {
+	ctx && gitRollback(ctx);
+	abortTask(MSG.ABORT.CANCEL);
+};
+const abortOnError = (err, ctx, exit = true) => {
+	ctx && gitRollback(ctx);
+	const msg = err.message.replace(/^\[(github|npm|git)]/, (a) => red(a));
+	log.message(`\n${msg}\n`);
+	exit && process.exit(1);
+};
+const taskEnd = (msg) => {
+	outro(msg);
+	process.exit(0);
+};
 //#endregion
 //#region src/version/prompts.ts
 const createVersionMap = (current) => ({
@@ -348,7 +336,7 @@ const runVersionPrompts = async (ctx, config) => {
 			message: question(MSG.PROMPT.INPUT_VERSION, "version"),
 			initialValue: current,
 			validate: (val) => {
-				if (!isValid(val)) return "Invalid version";
+				if (isUndefined(val) || !isValidVersion(val)) return "Invalid version";
 			}
 		});
 		abortSinglePrompt(version);
@@ -444,8 +432,11 @@ const createDefaultConfig = (isCI) => {
 		toTag(pkg, version) {
 			return `v${version}`;
 		},
-		tagPrefix(pkg) {
-			return "";
+		changelog: {
+			tagPrefix(pkg) {
+				return "";
+			},
+			releaseCount: 1
 		},
 		ignoreGit: false,
 		ignoreNpm: false,
@@ -521,42 +512,42 @@ const defaultTypes = [
 	},
 	{
 		type: "chore",
-		section: "🎫 其他更新",
+		section: "🧹 其他更新",
 		description: "非功能性更改"
 	},
 	{
 		type: "refactor",
-		section: "♻ 代码重构",
+		section: "♻️ 代码重构",
 		description: "重构代码"
 	},
 	{
 		type: "test",
-		section: "✅ 测试",
+		section: "🧪 测试",
 		description: "测试更新"
 	},
 	{
 		type: "build",
-		section: "👷‍ 构建系统",
+		section: "🏗️ 构建系统",
 		description: "构建工具和系统修改"
 	},
 	{
 		type: "ci",
-		section: "🔧 CI 配置",
+		section: "🤖 CI",
 		description: "持续集成配置"
 	},
 	{
 		type: "config",
-		section: "🔨 配置",
+		section: "⚙️ 配置",
 		description: "配置文件更新"
 	},
 	{
 		type: "deps",
-		section: "🔗 依赖更新",
+		section: "📦 依赖更新",
 		description: "依赖版本变更"
 	},
 	{
 		type: "security",
-		section: "🔒 安全修复",
+		section: "🛡️ 安全修复",
 		description: "安全性更新"
 	},
 	{
@@ -566,13 +557,18 @@ const defaultTypes = [
 	},
 	{
 		type: "ux",
-		section: "🖥️ 用户体验",
+		section: "🎨 用户体验",
 		description: "用户体验改进"
 	},
 	{
 		type: "hotfix",
-		section: "🔥 热修复",
+		section: "🚑 热修复",
 		description: "紧急修复"
+	},
+	{
+		type: "tool",
+		section: "🛠️ 工具链",
+		description: "工具链变更"
 	}
 ];
 //#endregion
@@ -583,8 +579,7 @@ const parsePreset = async () => {
 		hidden: false
 	})) });
 	preset.writer ??= {};
-	preset.writer.headerPartial = `
-## {{#if isPatch~}} <small> {{~/if~}}
+	preset.writer.headerPartial = `## {{#if isPatch~}} <small> {{~/if~}}
 {{#if @root.linkCompare~}}
 [{{version}}](
 {{~#if @root.repository~}}
@@ -608,8 +603,7 @@ const parsePreset = async () => {
 {{~/if}}
 {{~#if isPatch~}} </small> {{~/if}}
 `.trim() + eol();
-	preset.writer.mainTemplate = `
-{{> header}}
+	preset.writer.mainTemplate = `{{> header}}
 {{#if noteGroups}}
 {{#each noteGroups}}
 
@@ -632,32 +626,37 @@ const parsePreset = async () => {
 {{/each}}`.trim();
 	return preset;
 };
-const createGenerator = async ({ getPkgDir, tagPrefix }) => {
+const createGenerator = async ({ getPkgDir, tagPrefix, releaseCount = 1 }) => {
 	const pkgDir = getPkgDir();
 	const preset = await parsePreset();
-	return new ConventionalChangelog().readPackage(`${pkgDir}/package.json`).config(preset).options({ releaseCount: 1 }).commits({ path: pkgDir }).tags({ prefix: tagPrefix });
+	return new ConventionalChangelog().readPackage(`${pkgDir}/package.json`).config(preset).options({ releaseCount }).commits({ path: pkgDir }).tags({ prefix: tagPrefix });
 };
-const getChangelog = async ({ getPkgDir, tagPrefix }) => {
+const getChangelog = async ({ getPkgDir, tagPrefix, releaseCount = 1 }) => {
 	const generator = await createGenerator({
 		getPkgDir,
-		tagPrefix
+		tagPrefix,
+		releaseCount
 	});
 	let changelog = "";
 	for await (const chunk of generator.write()) changelog += chunk;
-	return changelog;
+	return changelog.trimEnd();
 };
-const generateChangelog = async ({ getPkgDir, tagPrefix }) => {
+const generateChangelog = async ({ getPkgDir, tagPrefix, releaseCount = 1 }) => {
 	const infile = join(getPkgDir(), "CHANGELOG.md");
 	if (!existsSync(infile)) await writeFile(infile, "");
 	const exist = readFileSync(infile, "utf-8");
+	const writeStream = createWriteStream(infile);
 	const generator = await createGenerator({
 		getPkgDir,
-		tagPrefix
+		tagPrefix,
+		releaseCount
 	});
-	const writeStream = createWriteStream(infile);
 	for await (const chunk of generator.write()) writeStream.write(chunk);
-	if (exist.trim().length) writeStream.write(eol(2));
-	writeStream.write(exist);
+	const override = isZero(releaseCount);
+	if (!(isZero(exist.trim().length) || override)) {
+		writeStream.write(eol());
+		writeStream.write(exist);
+	}
 	writeStream.end();
 	await finished(writeStream);
 };
@@ -776,7 +775,7 @@ const createCReleaseByTag = async (octokit, options) => {
 	const existing = await getReleaseByTagSafe(octokit, options);
 	if (!existing) return createCRelease(octokit, { ...options });
 	const { draft, id: releaseId } = existing;
-	if (!draft) throw new Error(`Release for tag "${options.tag}" already exists and is not a draft`);
+	if (!draft) throw new Error(MSG.ERROR.GITHUB_TAG_EXIT(options.tag));
 	return updateCRelease(octokit, {
 		releaseId,
 		...options
@@ -925,9 +924,14 @@ const npmCheck = async (ctx, config) => {
 	const tag = await resolvePublishTag(name, current);
 	Object.assign(ctx.npm, { tag });
 	if (skipChecks) return "";
-	const [pinged, username] = await Promise.all([pingRegistry(registry), getAuthenticatedUser(registry)]);
+	const [pinged, username, canPublished] = await Promise.all([
+		pingRegistry(registry),
+		getAuthenticatedUser(registry),
+		canPublish(registry)
+	]);
 	if (!pinged) throw new Error(MSG.ERROR.NPM_REGISTRY(registry));
 	if (!username) throw new Error(MSG.ERROR.NPM_AUTH);
+	if (!canPublished) throw new Error(MSG.ERROR.NPM_PERMISSION);
 	Object.assign(ctx.npm, { username });
 	const latest = await getPublishedVersion(`${name}@${tag}`);
 	if (latest) {
@@ -979,10 +983,10 @@ var Action = class {
 		const { otp, package: defPkg, ...others } = options;
 		const { showChangelog, showRelease, ci, dryRun } = Object.fromEntries(Object.entries(others).map(([k, v]) => [k, Boolean(v)]));
 		process.env["dryRun"] = String(dryRun);
-		const { configPath, config: local } = await resolveConfig(process.cwd());
+		const { configFile, config: local } = await resolveConfig(process.cwd());
 		const config = mergeConfig(createDefaultConfig(ci ? true : void 0), local);
 		info(MSG.INFO.TOOL(cName, cVersion));
-		info(MSG.INFO.CONFIG(configPath));
+		info(MSG.INFO.CONFIG(configFile));
 		console.log();
 		intro(prepare ? MSG.INTRO_PREPARE(dryRun) : MSG.INTRO(dryRun));
 		const { isMonorepo, packages, getPkgDir, ignoreNpm } = config;
@@ -1077,7 +1081,7 @@ var Action = class {
 	}
 	async bumpTask(ctx, config) {
 		const { pkg: { current }, dryRun, isCI, showRelease, showChangelog, selectedPkg, noGit } = ctx;
-		const { isMonorepo, hooks, getPkgDir, tagPrefix } = config;
+		const { isMonorepo, hooks, getPkgDir, changelog: { tagPrefix, releaseCount } } = config;
 		const need = (ctx) => {
 			const { pkg: { next }, isIncrement } = ctx;
 			return !next && isIncrement;
@@ -1107,37 +1111,43 @@ var Action = class {
 		}]).catch((err) => abortOnError(err, ctx));
 		await runLifeCycleHook(hooks, "after:bump", dryRun);
 		if (noGit) return;
-		const { from, to } = await resolveChangelogRange(isIncrement, isMonorepo ? `${tagPrefix?.(selectedPkg)}*` : "*");
-		const commits = await getLog(from, to, getPkgDir(selectedPkg));
+		const match = isMonorepo ? `${tagPrefix?.(selectedPkg)}*` : "*";
+		const { from, to } = isZero(releaseCount) ? {
+			from: "",
+			to: "HEAD"
+		} : await resolveChangelogRange(isIncrement, match);
+		const commits = await getLogSince(from, to, getPkgDir(selectedPkg));
 		const changelog = await getChangelog({
 			getPkgDir: () => getPkgDir(selectedPkg),
-			tagPrefix: tagPrefix?.(selectedPkg)
+			tagPrefix: tagPrefix?.(selectedPkg),
+			releaseCount
 		});
 		Object.assign(ctx.github, { changelog });
 		if (commits) {
-			msg("GIT", `Changelog(${from}...${to}):${eol(2)}` + changelog.trimEnd());
+			msg("GIT", `Changelog(${from}...${to}):${eol(2)}` + changelog);
 			msg("GIT", `Commits(${from}...${to}):${eol(2)}` + commits);
 			if (showChangelog) taskEnd(MSG.LOG.SHOW_CHANGELOG);
 		} else msg("GIT", MSG.LOG.CHANGELOG_EMPTY);
 	}
 	async changelogTask(ctx, config) {
 		const { isIncrement, dryRun, selectedPkg, noGit } = ctx;
-		const { getPkgDir, tagPrefix } = config;
+		const { getPkgDir, changelog: { tagPrefix, releaseCount } } = config;
 		if (noGit) return;
 		await tasks([{
 			title: MSG.TASK.CHANGELOG.START,
 			task: async () => {
 				await generateChangelog({
 					getPkgDir: () => getPkgDir(selectedPkg),
-					tagPrefix: tagPrefix?.(selectedPkg)
+					tagPrefix: tagPrefix?.(selectedPkg),
+					releaseCount
 				});
 				await gitAddAll();
 				return success(MSG.TASK.CHANGELOG.END, dryRun);
 			},
 			enabled: isIncrement
 		}]).catch((err) => abortOnError(err, ctx));
-		const changeset = await getStatus();
-		if (changeset) msg("GIT", `Changes:${eol(2)}` + coloredChangeset(changeset));
+		const changeset = await getShortStatus();
+		if (changeset) msg("GIT", `Changes:${eol(2)}` + coloredStatus(changeset));
 		else msg("GIT", MSG.LOG.CHANGES_EMPTY);
 	}
 	async gitTask(ctx, config) {
@@ -1212,8 +1222,8 @@ program.command("init").description("Create a release configuration file").optio
 	const isESM = type === "module";
 	const isTS = existsSync(join(cwd, "tsconfig.json"));
 	const infile = `release.config.${isESM ? "" : "m"}${isTS ? "ts" : "js"}`;
-	const configPath = join(cwd, infile);
-	if (existsSync(configPath) && !force) {
+	const configFile = join(cwd, infile);
+	if (existsSync(configFile) && !force) {
 		console.error(`${red`Error:`} ${yellow(infile)} already exists.\nUse ${green`--force`} to overwrite.`);
 		process.exit(1);
 	}
@@ -1222,9 +1232,11 @@ program.command("init").description("Create a release configuration file").optio
   packages: [ 'demo-a', 'demo-b' ],
   getPkgDir: (pkg) => \`packages/\${ pkg }\`,
   toTag: (pkg, version) => \`\${ pkg }@\${ version }\`,
-  tagPrefix: (pkg) => \`\${ pkg }@\`,
+  changelog: {
+    tagPrefix: (pkg) => \`\${ pkg }@\`,
+  },
 }`;
-	writeFileSync(configPath, [`import { defineConfig } from '@peiyanlu/release'`, `export default defineConfig(${monorepo ? monoConfigToString() : "{}"})`].join(eol(2)), "utf-8");
+	writeFileSync(configFile, [`import { defineConfig } from '@peiyanlu/release'`, `export default defineConfig(${monorepo ? monoConfigToString() : "{}"})`].join(eol(2)), "utf-8");
 	console.log(`${green`✔`} ${infile} created successfully`);
 });
 program.parse(process.argv);

package/dist/index.d.mts

@@ -23,14 +23,20 @@ interface ReleaseConfig {
   getPkgDir: (pkg: string) => string;
   /** 使用 monorepo 时使用 toTag，例如 `${pkg}@${version}`，默认为 `v${version}` 作为单仓库 */
   toTag: (pkg: string, version: string) => string;
-  /** 作为 CHANGELOG 标题的 Tag 前缀，多包场景下需要 `${pkg}@` */
-  tagPrefix: ((pkg: string) => string) | undefined;
+  /**
+   * CHANGELOG 相关配置
+   * 影响生成的日志数量、日志标题（monorepo）。
+   */
+  changelog: {
+    /** 作为 CHANGELOG 标题的 Tag 前缀，多包场景下需要 `${pkg}@` */tagPrefix: ((pkg: string) => string); /** 生成多少个版本的变更日志，详见 {@link Options} */
+    releaseCount: number;
+  };
   /** 忽略 git、github 环境检查以及后续操作  */
-  ignoreGit: boolean | undefined;
+  ignoreGit: boolean;
   /** 忽略 npm 环境检查以及后续操作 */
-  ignoreNpm: boolean | undefined;
+  ignoreNpm: boolean;
   /** 忽略 github 环境检查以及后续操作 */
-  ignoreGithub: boolean | undefined;
+  ignoreGithub: boolean;
   /**
    * Git 相关配置
    * 影响提交、打 tag、推送等本地/远程 Git 行为。
@@ -156,27 +162,32 @@ declare function defineConfig(config: UserConfigFnObject): UserConfigFnObject;
 declare function defineConfig(config: UserConfigFnPromise): UserConfigFnPromise;
 declare function defineConfig(config: UserConfigFn): UserConfigFn;
 declare function defineConfig(config: UserConfigExport): UserConfigExport;
-declare const mergeConfig: <T extends object>(defaults: DeepRequired<T>, overrides?: DeepPartial<T>) => DeepRequired<T>;
+declare const mergeConfig: <T extends object>(defaults: DeepRequired<T>, overrides: DeepPartial<T>) => DeepRequired<T>;
 //#endregion
 //#region src/git/changelog.d.ts
-interface Options {
+interface GenerateOptions {
   /** @example () => `packages/${pkg}` */
   getPkgDir: () => string;
   /** @example `${pkg}@` */
   tagPrefix?: string;
+  /** 生成多少个变更日志，详见 {@link Options} */
+  releaseCount?: number;
 }
 declare const createGenerator: ({
   getPkgDir,
-  tagPrefix
-}: Options) => Promise<ConventionalChangelog>;
+  tagPrefix,
+  releaseCount
+}: GenerateOptions) => Promise<ConventionalChangelog>;
 declare const getChangelog: ({
   getPkgDir,
-  tagPrefix
-}: Options) => Promise<string>;
+  tagPrefix,
+  releaseCount
+}: GenerateOptions) => Promise<string>;
 declare const generateChangelog: ({
   getPkgDir,
-  tagPrefix
-}: Options) => Promise<void>;
+  tagPrefix,
+  releaseCount
+}: GenerateOptions) => Promise<void>;
 //#endregion
 //#region src/npm/publish.d.ts
 interface PublishTagOptions {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { isFunction, isPlainObject } from "@peiyanlu/ts-utils";
+import { isFunction, isPlainObject, isUndefined, isZero } from "@peiyanlu/ts-utils";
 import { createWriteStream, existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { eol, getPackageInfo, publishPackage, resolvePublishTag } from "@peiyanlu/cli-utils";
@@ -12,13 +12,12 @@ function defineConfig(config) {
 	return config;
 }
 const mergeConfig = (defaults, overrides) => {
-	if (!overrides) return structuredClone(defaults);
-	if (Object.keys(defaults).length === 0) return structuredClone(overrides);
 	const result = {};
-	for (const key in defaults) {
+	for (const key of Object.keys(defaults)) {
 		const defaultValue = defaults[key];
 		const overrideValue = overrides[key];
-		if (overrideValue === void 0) if (isFunction(defaultValue)) result[key] = defaultValue;
+		if (isUndefined(overrideValue)) if (isFunction(defaultValue)) result[key] = defaultValue;
+		else if (isPlainObject(defaultValue)) result[key] = mergeConfig(defaultValue, {});
 		else result[key] = structuredClone(defaultValue);
 		else if (isPlainObject(defaultValue) && isPlainObject(overrideValue)) result[key] = mergeConfig(defaultValue, overrideValue);
 		else if (isFunction(overrideValue)) result[key] = overrideValue;
@@ -66,42 +65,42 @@ const defaultTypes = [
 	},
 	{
 		type: "chore",
-		section: "🎫 其他更新",
+		section: "🧹 其他更新",
 		description: "非功能性更改"
 	},
 	{
 		type: "refactor",
-		section: "♻ 代码重构",
+		section: "♻️ 代码重构",
 		description: "重构代码"
 	},
 	{
 		type: "test",
-		section: "✅ 测试",
+		section: "🧪 测试",
 		description: "测试更新"
 	},
 	{
 		type: "build",
-		section: "👷‍ 构建系统",
+		section: "🏗️ 构建系统",
 		description: "构建工具和系统修改"
 	},
 	{
 		type: "ci",
-		section: "🔧 CI 配置",
+		section: "🤖 CI",
 		description: "持续集成配置"
 	},
 	{
 		type: "config",
-		section: "🔨 配置",
+		section: "⚙️ 配置",
 		description: "配置文件更新"
 	},
 	{
 		type: "deps",
-		section: "🔗 依赖更新",
+		section: "📦 依赖更新",
 		description: "依赖版本变更"
 	},
 	{
 		type: "security",
-		section: "🔒 安全修复",
+		section: "🛡️ 安全修复",
 		description: "安全性更新"
 	},
 	{
@@ -111,13 +110,18 @@ const defaultTypes = [
 	},
 	{
 		type: "ux",
-		section: "🖥️ 用户体验",
+		section: "🎨 用户体验",
 		description: "用户体验改进"
 	},
 	{
 		type: "hotfix",
-		section: "🔥 热修复",
+		section: "🚑 热修复",
 		description: "紧急修复"
+	},
+	{
+		type: "tool",
+		section: "🛠️ 工具链",
+		description: "工具链变更"
 	}
 ];
 //#endregion
@@ -128,8 +132,7 @@ const parsePreset = async () => {
 		hidden: false
 	})) });
 	preset.writer ??= {};
-	preset.writer.headerPartial = `
-## {{#if isPatch~}} <small> {{~/if~}}
+	preset.writer.headerPartial = `## {{#if isPatch~}} <small> {{~/if~}}
 {{#if @root.linkCompare~}}
 [{{version}}](
 {{~#if @root.repository~}}
@@ -153,8 +156,7 @@ const parsePreset = async () => {
 {{~/if}}
 {{~#if isPatch~}} </small> {{~/if}}
 `.trim() + eol();
-	preset.writer.mainTemplate = `
-{{> header}}
+	preset.writer.mainTemplate = `{{> header}}
 {{#if noteGroups}}
 {{#each noteGroups}}
 
@@ -177,32 +179,37 @@ const parsePreset = async () => {
 {{/each}}`.trim();
 	return preset;
 };
-const createGenerator = async ({ getPkgDir, tagPrefix }) => {
+const createGenerator = async ({ getPkgDir, tagPrefix, releaseCount = 1 }) => {
 	const pkgDir = getPkgDir();
 	const preset = await parsePreset();
-	return new ConventionalChangelog().readPackage(`${pkgDir}/package.json`).config(preset).options({ releaseCount: 1 }).commits({ path: pkgDir }).tags({ prefix: tagPrefix });
+	return new ConventionalChangelog().readPackage(`${pkgDir}/package.json`).config(preset).options({ releaseCount }).commits({ path: pkgDir }).tags({ prefix: tagPrefix });
 };
-const getChangelog = async ({ getPkgDir, tagPrefix }) => {
+const getChangelog = async ({ getPkgDir, tagPrefix, releaseCount = 1 }) => {
 	const generator = await createGenerator({
 		getPkgDir,
-		tagPrefix
+		tagPrefix,
+		releaseCount
 	});
 	let changelog = "";
 	for await (const chunk of generator.write()) changelog += chunk;
-	return changelog;
+	return changelog.trimEnd();
 };
-const generateChangelog = async ({ getPkgDir, tagPrefix }) => {
+const generateChangelog = async ({ getPkgDir, tagPrefix, releaseCount = 1 }) => {
 	const infile = join(getPkgDir(), "CHANGELOG.md");
 	if (!existsSync(infile)) await writeFile(infile, "");
 	const exist = readFileSync(infile, "utf-8");
+	const writeStream = createWriteStream(infile);
 	const generator = await createGenerator({
 		getPkgDir,
-		tagPrefix
+		tagPrefix,
+		releaseCount
 	});
-	const writeStream = createWriteStream(infile);
 	for await (const chunk of generator.write()) writeStream.write(chunk);
-	if (exist.trim().length) writeStream.write(eol(2));
-	writeStream.write(exist);
+	const override = isZero(releaseCount);
+	if (!(isZero(exist.trim().length) || override)) {
+		writeStream.write(eol());
+		writeStream.write(exist);
+	}
 	writeStream.end();
 	await finished(writeStream);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peiyanlu/release",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "Release project tool.",
   "license": "MIT",
   "type": "module",
@@ -20,7 +20,7 @@
   "scripts": {
     "dev": "tsdown -w",
     "build": "tsdown",
-    "prepublish": "tsdown",
+    "prepublishOnly": "tsdown",
     "release": "node index.js",
     "test": "vitest run",
     "test:cov": "vitest run --coverage"
@@ -30,16 +30,17 @@
     "@actions/github": "^9.1.1",
     "@clack/prompts": "^1.5.0",
     "@octokit/rest": "^22.0.1",
-    "@peiyanlu/cli-utils": "^0.0.8",
-    "@peiyanlu/ts-utils": "^0.0.5",
+    "@peiyanlu/cli-utils": "^0.0.12",
+    "@peiyanlu/ts-utils": "^0.0.7",
     "ansis": "^4.3.1",
     "commander": "^15.0.0",
-    "conventional-changelog": "^7.2.0",
+    "conventional-changelog": "^7.2.1",
     "conventional-changelog-conventionalcommits": "^9.3.1",
+    "conventional-changelog-writer": "^8.3.0",
     "mime-types": "^3.0.2",
     "open": "^11.0.0",
     "publint": "^0.3.21",
-    "semver": "^7.8.1",
+    "semver": "^7.8.5",
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
@@ -47,9 +48,9 @@
     "@types/node": "^24.12.4",
     "@types/semver": "^7.7.1",
     "@vitest/coverage-v8": "^4.1.8",
-    "tsdown": "^0.22.1",
+    "tsdown": "^0.22.3",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.9"
   },
   "author": {
     "name": "YanluPei",