@peiyanlu/release 0.0.5 → 0.0.7

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) $YEAR $OWNER
+Copyright (c) 2026 离殇
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -65,6 +65,18 @@ pnpm release minor --ci
 | `--show-changelog` | 打印生成的 Changelog 并退出                                        |
 | `--ci`             | 启用 CI 模式：禁用交互提示，缺少必要参数时直接失败；GitHub Actions 等 CI/CD 环境中默认启用 |
 
+### Prepare 相关参数
+
+| 参数          | 说明                       |
+|-------------|--------------------------|
+| `--prepare` | 仅仅变更版本、提交代码、创建 Tag、推送到远程 |
+
+```bash
+pnpm release minor --prepare --ci --package pkg-a
+```
+
+> 后续可以通过 tag 进行 npm 发布和创建 GitHub release
+
 ### Monorepo / CI 相关参数
 
 | 参数                    | 说明                               |
@@ -72,7 +84,7 @@ pnpm release minor --ci
 | `-p, --package <pkg>` | 指定要发布的子包名称（仅用于 Monorepo 的 CI 场景） |
 
 ```bash
-pnpm release minor --ci --package test-a
+pnpm release minor --ci --package pkg-a
 ```
 
 ### npm 发布相关参数
@@ -268,6 +280,36 @@ GitHub Release 可基于 Git Tag 自动创建，并支持附带：
 
 工具默认配置偏向于 **单仓库（Single Repo）** 项目，但是可以通过配置使其支持 **Monorepo**
 
+## 流程拆分
+
+### 本地准备 Release（仅创建 Tag）
+
+在本地完成版本确认与变更准备：
+
+- 确定下一个版本
+- 更新 `package.json` / `CHANGELOG`
+- 创建发布提交
+- 创建并推送 git 标签
+
+### CI/CD 自动发布（由 Tag 触发）
+
+当 Tag 推送到远端后，CI/CD 自动执行：
+
+- 发布到 npm
+- 创建 GItHub release
+
+```ts
+// publishCI.ts
+import { publishTagToNpm } from '@peiyanlu/release'
+
+
+await publishTagToNpm({
+  gitTag: '1.0.16',
+  getPkgDir: () => '.',
+  defaultPackage: '.',
+})
+```
+
 ## Dry Run
 
 ```bash

package/dist/cli.mjs

@@ -1,24 +1,24 @@
 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, isWorkingDirClean, parseGitHubRepo, pingRegistry, publishPackage, pushBranch, pushTag, readJsonFile, resolveChangelogRange, runGit } from "@peiyanlu/cli-utils";
+import { bumpPackageVersion, coloredChangeset, eol, execAsync, getAllRemotes, getAuthenticatedUser, getCurrentBranch, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLog, getPackageInfo, getPackageUrl, getPublishedVersion, getRemote, getStatus, gitAddAll, gitAddTracked, gitCommit, gitTagAnnotated, hasWriteAccess, isGitRepo, isPrerelease, isValid, isWorkingDirClean, parseGitHubRepo, parseVersion, pingRegistry, publishPackage, pushBranch, pushTag, readJsonFile, resolveChangelogRange } 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 { publint } from "publint";
 import { formatMessage } from "publint/utils";
-import { coerce, eq, inc, lt, parse, prerelease, valid } from "semver";
-import { castArray, isPlainObject, isUndefined } from "@peiyanlu/ts-utils";
+import { inc, lt, neq } from "semver";
+import { castArray, isFunction, isPlainObject, isUndefined } from "@peiyanlu/ts-utils";
 import { spawnSync } from "node:child_process";
-import { Octokit } from "@octokit/rest";
-import { contentType } from "mime-types";
-import open from "open";
-import { glob } from "tinyglobby";
 import { inspect } from "node:util";
 import { ConventionalChangelog } from "conventional-changelog";
 import createPreset from "conventional-changelog-conventionalcommits";
 import { writeFile } from "node:fs/promises";
 import { finished } from "node:stream/promises";
+import { Octokit } from "@octokit/rest";
+import { contentType } from "mime-types";
+import open from "open";
+import { glob } from "tinyglobby";
 
 //#region node_modules/.pnpm/tsdown@0.18.4_publint@0.3.17_typescript@5.9.3/node_modules/tsdown/esm-shims.js
 const getFilename = () => fileURLToPath(import.meta.url);
@@ -55,7 +55,6 @@ const resolveConfig = async (cwd) => {
 		config: await loadConfig(configFile)
 	};
 };
-const isFunction = (v) => typeof v === "function";
 const mergeConfig = (defaults, overrides) => {
 	if (!overrides) return structuredClone(defaults);
 	if (Object.keys(defaults).length === 0) return structuredClone(overrides);
@@ -78,7 +77,9 @@ const n = (b) => b ? "(dry run)" : "";
 const t = () => green(`${Math.floor(process.uptime())}s`);
 const MSG = {
 	INTRO: (dryRun) => `🚀  Starting release ${n(dryRun)}`,
+	INTRO_PREPARE: (dryRun) => `🚀  Starting prepare release ${n(dryRun)}`,
 	OUTRO: (dryRun) => `🎉  Release finished successfully in ${t()} ${n(dryRun)}`,
+	OUTRO_PREPARE: (dryRun) => `🎉  Prepare release finished successfully in ${t()} ${n(dryRun)}`,
 	LOG: {
 		SHOW_VERSION: (version) => `🎉  Released ${green(version)}`,
 		SHOW_CHANGELOG: "🎉  Changelog collected",
@@ -93,6 +94,10 @@ const MSG = {
 		NPM: {
 			CHECKING: "Checking npm registry",
 			CHECKED: (registry, msg$1) => `NPM registry: ${underline(dim(registry))} ${underline(dim(msg$1))}`
+		},
+		GITHUB: {
+			CHECKING: "Checking github repository",
+			CHECKED: (repository, msg$1) => `GitHub repository: ${underline(dim(repository))} ${underline(dim(msg$1))}`
 		}
 	},
 	TASK: {
@@ -151,123 +156,6 @@ const MSG = {
 	}
 };
 
-//#endregion
-//#region src/github/release.ts
-const truncateBody = (body) => {
-	if (body && body.length >= 124e3) return body.substring(0, 124e3) + "...";
-	return body;
-};
-const uploadAssets = async (ctx, config) => {
-	const { github: { assets } } = config;
-	const { github: { isReleased, owner, repo, uploadUrl, releaseId, token }, pkg: { name } } = ctx;
-	if (!assets?.length || !isReleased) return;
-	const octokit = new Octokit({ auth: token });
-	const files = await glob(assets);
-	await Promise.all(files.map((file) => {
-		return octokit.repos.uploadReleaseAsset({
-			owner,
-			repo,
-			name,
-			url: uploadUrl,
-			release_id: releaseId,
-			data: createReadStream(file),
-			headers: {
-				"content-type": contentType(file) || "application/octet-stream",
-				"content-length": statSync(file).size
-			}
-		});
-	}));
-};
-const createWebRelease = async (ctx, config) => {
-	const { pkg: { toPreRelease }, github: { owner, repo, changelog, releaseName }, git: { currentTag } } = ctx;
-	const { github: { prerelease: prerelease$1 } } = config;
-	const github = getGithubUrl(owner, repo);
-	const url = new URL(`${github}/releases/new`);
-	url.searchParams.set("tag", currentTag);
-	url.searchParams.set("title", releaseName);
-	url.searchParams.set("body", truncateBody(changelog));
-	url.searchParams.set("prelease", String(toPreRelease || prerelease$1));
-	const isWindows = process.platform === "win32";
-	await open(url.toString(), { wait: isWindows });
-};
-const createCiRelease = async (ctx, config) => {
-	const { pkg: { toPreRelease }, github: { owner, repo, token, changelog, releaseName }, git: { currentTag } } = ctx;
-	const { github: { prerelease: prerelease$1, draft, autoGenerate } } = config;
-	const octokit = new Octokit({ auth: token });
-	try {
-		const { data } = await octokit.repos.createRelease({
-			owner,
-			repo,
-			tag_name: currentTag,
-			target_commitish: void 0,
-			name: releaseName,
-			body: autoGenerate ? "" : truncateBody(changelog),
-			draft: draft ?? false,
-			prerelease: (toPreRelease || prerelease$1) ?? false,
-			discussion_category_name: void 0,
-			generate_release_notes: autoGenerate,
-			make_latest: "true"
-		});
-		const { html_url, upload_url, id, discussion_url } = data;
-		Object.assign(ctx.github, {
-			isReleased: true,
-			releaseId: id,
-			releaseUrl: html_url,
-			uploadUrl: upload_url,
-			discussionUrl: discussion_url
-		});
-	} catch (e) {
-		if (e?.status === 422) throw new Error(MSG.ERROR.GITHUB_TAG_EXIT(currentTag));
-		throw e;
-	}
-};
-const parseGithubUrl = (ctx) => {
-	const { git: { remoteUrl } } = ctx;
-	const [owner, repo] = parseGitHubRepo(remoteUrl);
-	Object.assign(ctx.github, {
-		owner,
-		repo
-	});
-};
-const createRelease = async (ctx, config) => {
-	const { github: { owner, repo }, isCI } = ctx;
-	const { github: { tokenRef, release, skipChecks } } = config;
-	if (!release) return;
-	const token = tokenRef ? process.env[tokenRef] : process.env.GITHUB_TOKEN;
-	if (!token) {
-		Object.assign(ctx.github, { isWeb: true });
-		if (isCI && process.env.GITHUB_ACTIONS) throw new Error(MSG.ERROR.GITHUB_TOKEN(tokenRef));
-	}
-	Object.assign(ctx.github, { token });
-	const octokit = new Octokit({ auth: token });
-	if (token && !skipChecks) if (process.env.GITHUB_ACTIONS) Object.assign(ctx.github, { username: process.env.GITHUB_ACTOR });
-	else {
-		try {
-			const { data: { login: username } } = await octokit.users.getAuthenticated();
-			Object.assign(ctx.github, { username });
-		} catch (e) {
-			throw new Error(MSG.ERROR.GITHUB_AUTH);
-		}
-		try {
-			const { github: { username } } = ctx;
-			await octokit.repos.checkCollaborator({
-				owner,
-				repo,
-				username
-			});
-		} catch (e) {
-			throw new Error(MSG.ERROR.GITHUB_USER);
-		}
-	}
-	const { github: { isWeb }, dryRun } = ctx;
-	if (dryRun) return true;
-	if (isWeb) await createWebRelease(ctx, config);
-	else if (isCI) {
-		await createCiRelease(ctx, config);
-		await uploadAssets(ctx, config);
-	}
-};
-
 //#endregion
 //#region src/git/commit.ts
 const gitCheck = async (ctx, config) => {
@@ -289,7 +177,11 @@ const gitCheck = async (ctx, config) => {
 		remoteName,
 		remoteUrl
 	});
-	parseGithubUrl(ctx);
+	const [owner, repo] = parseGitHubRepo(remoteUrl);
+	Object.assign(ctx.github, {
+		owner,
+		repo
+	});
 };
 const commitAndTag = async (ctx, config) => {
 	const { git: { remoteName, currentTag, commitMessage, tagMessage }, dryRun } = ctx;
@@ -406,37 +298,13 @@ const formatTemplate = async (ctx, config) => {
 	Object.assign(ctx.github, { releaseName });
 };
 
-//#endregion
-//#region src/version/bump.ts
-const isPreRelease = (version) => {
-	return Boolean(prerelease(version));
-};
-const isValid = (version) => {
-	return Boolean(valid(version));
-};
-const parseVersion = (raw) => {
-	const next = isValid(raw) ? raw : coerce(raw)?.toString();
-	if (!next) return {};
-	const { prerelease: prerelease$1 } = parse(next);
-	const toPreRelease = Boolean(prerelease$1.length);
-	const [preId, preBase] = prerelease$1.map(String);
-	return {
-		next,
-		toPreRelease,
-		preId,
-		preBase
-	};
-};
-const getCIVersion = (current) => {
-	return inc(current, Release.PATCH) ?? "";
-};
-
 //#endregion
 //#region src/version/prompts.ts
 let Release = /* @__PURE__ */ function(Release$1) {
 	Release$1["MAJOR"] = "major";
 	Release$1["MINOR"] = "minor";
 	Release$1["PATCH"] = "patch";
+	Release$1["RELEASE"] = "release";
 	return Release$1;
 }({});
 let PreRelease = /* @__PURE__ */ function(PreRelease$1) {
@@ -456,76 +324,45 @@ let PreId = /* @__PURE__ */ function(PreId$1) {
 	PreId$1["DEV"] = "dev";
 	return PreId$1;
 }({});
+const createVersionMap = (current) => ({
+	patch: inc(current, Release.PATCH),
+	minor: inc(current, Release.MINOR),
+	major: inc(current, Release.MAJOR),
+	release: inc(current, Release.RELEASE),
+	prerelease: inc(current, PreRelease.RELEASE),
+	prepatch: inc(current, PreRelease.PATCH, PreId.BETA),
+	preminor: inc(current, PreRelease.MINOR, PreId.BETA),
+	premajor: inc(current, PreRelease.MAJOR, PreId.BETA)
+});
+const option = (label, value, hint) => ({
+	label,
+	value,
+	hint: hint ?? value
+});
 const runVersionPrompts = async (ctx, config) => {
 	const { pkg: { current, fromPreRelease } } = ctx;
 	const selectVersion = async () => {
-		const patch = inc(current, Release.PATCH);
-		const minor = inc(current, Release.MINOR);
-		const major = inc(current, Release.MAJOR);
-		const prerelease$1 = inc(current, PreRelease.RELEASE);
-		const prepatch = inc(current, PreRelease.PATCH, PreId.BETA);
-		const preminor = inc(current, PreRelease.MINOR, PreId.BETA);
-		const premajor = inc(current, PreRelease.MAJOR, PreId.BETA);
-		const pr = [{
-			label: "Pre-Release",
-			value: prerelease$1,
-			hint: prerelease$1
-		}];
-		const pre = [
-			{
-				label: "Pre-Patch",
-				value: prepatch,
-				hint: prepatch
-			},
-			{
-				label: "Pre-Minor",
-				value: preminor,
-				hint: preminor
-			},
-			{
-				label: "Pre-Major",
-				value: premajor,
-				hint: premajor
-			}
-		];
-		const release = [
-			{
-				label: "Patch",
-				value: patch,
-				hint: patch
-			},
-			{
-				label: "Minor",
-				value: minor,
-				hint: minor
-			},
-			{
-				label: "Major",
-				value: major,
-				hint: major
-			}
+		const versions = createVersionMap(current);
+		const options = [
+			...fromPreRelease ? [option("Pre-Release", "prerelease", versions.prerelease)] : [],
+			option("Patch", "patch", versions.patch),
+			option("Minor", "minor", versions.minor),
+			option("Major", "major", versions.major),
+			...!fromPreRelease ? [
+				option("Pre-Patch", "prepatch", versions.prepatch),
+				option("Pre-Minor", "preminor", versions.preminor),
+				option("Pre-Major", "premajor", versions.premajor)
+			] : [],
+			option("As-Is", "ignore", current),
+			option("Custom", "custom", "custom specified")
 		];
-		const custom = [{
-			label: "As-Is",
-			value: "ignore",
-			hint: current
-		}, {
-			label: "Custom",
-			value: "custom",
-			hint: "custom specified"
-		}];
-		const version = await select({
+		const type = await select({
 			message: question(MSG.PROMPT.SELECT_VERSION, "version"),
-			options: [
-				...fromPreRelease ? pr : [],
-				...release,
-				...fromPreRelease ? [] : pre,
-				...custom
-			],
-			initialValue: fromPreRelease ? prerelease$1 : patch
+			options,
+			initialValue: fromPreRelease ? "prerelease" : "patch"
 		});
-		abortSinglePrompt(version);
-		return version;
+		abortSinglePrompt(type);
+		return type;
 	};
 	const inputVersion = async () => {
 		const version = await text({
@@ -538,10 +375,12 @@ const runVersionPrompts = async (ctx, config) => {
 		abortSinglePrompt(version);
 		return version;
 	};
-	const type = await selectVersion();
-	const next = type === "custom" ? await inputVersion() : type === "ignore" ? current : type;
-	ctx.isIncrement = !eq(next, current);
-	return { next };
+	const resolveNextVersion = async (type, current$1) => {
+		if (type === "ignore") return current$1;
+		if (type === "custom") return inputVersion();
+		return createVersionMap(current$1)[type];
+	};
+	return await resolveNextVersion(await selectVersion(), current);
 };
 
 //#endregion
@@ -644,8 +483,7 @@ const createDefaultConfig = (isCI) => {
 		},
 		npm: {
 			publish: isCI,
-			publishPath: ".",
-			pushArgs: [],
+			publishArgs: [],
 			skipChecks: false
 		},
 		github: {
@@ -758,11 +596,8 @@ const defaultTypes = [
 
 //#endregion
 //#region src/git/changelog.ts
-const generateChangelog = async ({ getPkgDir, tagPrefix }) => {
+const createGenerator = async ({ getPkgDir, tagPrefix }) => {
 	const pkgDir = getPkgDir();
-	const infile = join(pkgDir, "CHANGELOG.md");
-	if (!existsSync(infile)) await writeFile(infile, "");
-	const originalChangelog = readFileSync(infile, "utf-8");
 	const preset = await createPreset({ types: defaultTypes.map((t$1) => ({
 		...t$1,
 		hidden: false
@@ -815,17 +650,30 @@ const generateChangelog = async ({ getPkgDir, tagPrefix }) => {
 {{> commit root=@root}}
 {{/each}}
 {{/each}}`.trim() + eol(2);
-	const generator = new ConventionalChangelog().readPackage(`${pkgDir}/package.json`).config(preset).options({ releaseCount: 1 }).commits({ path: pkgDir }).tags({ prefix: tagPrefix });
-	const writeStream = createWriteStream(infile);
+	return new ConventionalChangelog().readPackage(`${pkgDir}/package.json`).config(preset).options({ releaseCount: 1 }).commits({ path: pkgDir }).tags({ prefix: tagPrefix });
+};
+const getChangelog = async ({ getPkgDir, tagPrefix }) => {
+	const generator = await createGenerator({
+		getPkgDir,
+		tagPrefix
+	});
 	let changelog = "";
-	for await (const chunk of generator.write()) {
-		changelog += chunk;
-		writeStream.write(chunk);
-	}
+	for await (const chunk of generator.write()) changelog += chunk;
+	return changelog;
+};
+const generateChangelog = async ({ getPkgDir, tagPrefix }) => {
+	const infile = join(getPkgDir(), "CHANGELOG.md");
+	if (!existsSync(infile)) await writeFile(infile, "");
+	const originalChangelog = readFileSync(infile, "utf-8");
+	const generator = await createGenerator({
+		getPkgDir,
+		tagPrefix
+	});
+	const writeStream = createWriteStream(infile);
+	for await (const chunk of generator.write()) writeStream.write(chunk);
 	writeStream.write(originalChangelog);
 	writeStream.end();
 	await finished(writeStream);
-	return changelog;
 };
 
 //#endregion
@@ -887,6 +735,172 @@ const runGithubPrompts = async (ctx, config) => {
 	return res;
 };
 
+//#endregion
+//#region src/github/release.ts
+const truncateBody = (body) => {
+	if (body && body.length >= 124e3) return body.substring(0, 124e3) + "...";
+	return body;
+};
+const getReleaseByTagSafe = async (octokit, options) => {
+	try {
+		const { data } = await octokit.repos.getReleaseByTag({ ...options });
+		return data;
+	} catch (e) {
+		if (e?.status === 404) return null;
+		throw e;
+	}
+};
+const createCRelease = async (octokit, options) => {
+	const { owner, repo, tag, name, body, draft, prerelease, generateReleaseNotes, makeLatest, targetCommitish, discussionCategoryName } = options;
+	const { data } = await octokit.repos.createRelease({
+		owner,
+		repo,
+		tag_name: tag,
+		name,
+		body,
+		draft,
+		prerelease,
+		generate_release_notes: generateReleaseNotes,
+		make_latest: makeLatest,
+		target_commitish: targetCommitish,
+		discussion_category_name: discussionCategoryName
+	});
+	return data;
+};
+const updateCRelease = async (octokit, options) => {
+	const { owner, repo, tag, name, body, draft, prerelease, generateReleaseNotes, makeLatest, targetCommitish, discussionCategoryName, releaseId } = options;
+	const { data } = await octokit.repos.updateRelease({
+		owner,
+		repo,
+		release_id: releaseId,
+		tag_name: tag,
+		name,
+		body,
+		draft,
+		prerelease,
+		generate_release_notes: generateReleaseNotes,
+		make_latest: makeLatest,
+		target_commitish: targetCommitish,
+		discussion_category_name: discussionCategoryName
+	});
+	return data;
+};
+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`);
+	return updateCRelease(octokit, {
+		releaseId,
+		...options
+	});
+};
+const uploadAssets = async (octokit, options) => {
+	const { owner, repo, name, uploadUrl, releaseId, assets } = options;
+	const files = await glob(assets);
+	await Promise.all(files.map((file) => {
+		return octokit.repos.uploadReleaseAsset({
+			owner,
+			repo,
+			name,
+			url: uploadUrl,
+			release_id: releaseId,
+			data: createReadStream(file),
+			headers: {
+				"content-type": contentType(file) || "application/octet-stream",
+				"content-length": statSync(file).size
+			}
+		});
+	}));
+};
+const createWebRelease = async (options) => {
+	const { owner, repo, tag, title, body, prerelease } = options;
+	const url = new URL(`${getGithubUrl(owner, repo)}/releases/new`);
+	Object.entries({
+		tag,
+		title,
+		body,
+		prerelease
+	}).forEach(([key, value]) => {
+		url.searchParams.set(key, value);
+	});
+	const isWindows = process.platform === "win32";
+	await open(url.toString(), { wait: isWindows });
+};
+const githubCheck = async (ctx, config) => {
+	const { github: { owner, repo }, isCI } = ctx;
+	const { github: { tokenRef, skipChecks } } = config;
+	const token = tokenRef ? process.env[tokenRef] : process.env.GITHUB_TOKEN;
+	if (!token) {
+		Object.assign(ctx.github, { isWeb: true });
+		if (isCI && process.env.GITHUB_ACTIONS) throw new Error(MSG.ERROR.GITHUB_TOKEN(tokenRef));
+		return "";
+	}
+	Object.assign(ctx.github, { token });
+	if (skipChecks) return "";
+	let username = "";
+	if (process.env.GITHUB_ACTIONS) username = process.env.GITHUB_ACTOR;
+	else {
+		const octokit = new Octokit({ auth: token });
+		try {
+			const { data: { login } } = await octokit.users.getAuthenticated();
+			username = login;
+		} catch (e) {
+			throw new Error(MSG.ERROR.GITHUB_AUTH);
+		}
+		try {
+			await octokit.repos.checkCollaborator({
+				owner,
+				repo,
+				username
+			});
+		} catch (e) {
+			throw new Error(MSG.ERROR.GITHUB_USER);
+		}
+	}
+	return username;
+};
+const createRelease = async (ctx, config) => {
+	const { pkg: { name, toPreRelease }, git: { currentTag }, isCI, dryRun } = ctx;
+	const { github: { isWeb, token, owner, repo, changelog, releaseName } } = ctx;
+	const { github: { release, assets, prerelease, autoGenerate, draft } } = config;
+	if (!release || dryRun) return;
+	const octokit = new Octokit({ auth: token });
+	if (isWeb) await createWebRelease({
+		owner,
+		repo,
+		tag: currentTag,
+		title: releaseName,
+		body: truncateBody(changelog),
+		prerelease: String(toPreRelease || prerelease)
+	});
+	else if (isCI) {
+		const res = await createCReleaseByTag(octokit, {
+			owner,
+			repo,
+			tag: currentTag,
+			name: releaseName,
+			body: autoGenerate ? "" : truncateBody(changelog),
+			draft,
+			prerelease: toPreRelease || prerelease,
+			generateReleaseNotes: autoGenerate,
+			makeLatest: "true"
+		});
+		if (!res) return;
+		if (assets.length) {
+			const { id: releaseId, upload_url: uploadUrl } = res;
+			await uploadAssets(octokit, {
+				owner,
+				repo,
+				name,
+				uploadUrl,
+				releaseId,
+				assets
+			});
+		}
+	}
+};
+
 //#endregion
 //#region src/npm/prompts.ts
 const runNpmPublishPrompts = async (ctx, config) => {
@@ -921,11 +935,11 @@ const runNpmOptPrompts = async (ctx, config) => {
 //#endregion
 //#region src/npm/publish.ts
 const resolvePublishTag = async (pkgName, version) => {
-	const { toPreRelease, preId } = parseVersion(version);
-	if (!toPreRelease) {
-		const active = await getPublishedVersion(pkgName);
-		return active && lt(version, active) ? "previous" : "latest";
-	} else return preId || "prerelease";
+	const { isPrerelease: isPrerelease$1, preId } = parseVersion(version);
+	if (isPrerelease$1) return preId || "next";
+	const active = await getPublishedVersion(pkgName);
+	if (!active) return "latest";
+	return lt(version, active) ? "previous" : "latest";
 };
 const isOtpError = (err) => err instanceof Error && /one-time password|otp/i.test(err.message);
 const npmCheck = async (ctx, config) => {
@@ -946,7 +960,7 @@ const npmCheck = async (ctx, config) => {
 };
 const publishNpm = async (ctx, config) => {
 	const { dryRun, selectedPkg, npm: { otp, tag } } = ctx;
-	const { npm: { publish, pushArgs }, getPkgDir } = config;
+	const { npm: { publish, publishArgs }, getPkgDir } = config;
 	if (!publish) return;
 	const otpArgs = otp ? ["--otp", otp] : [];
 	const dryRunArg = dryRun ? ["--dry-run"] : [];
@@ -954,7 +968,7 @@ const publishNpm = async (ctx, config) => {
 		tag,
 		args: [
 			...otpArgs,
-			...pushArgs,
+			...publishArgs,
 			...dryRunArg
 		],
 		cwd: getPkgDir(selectedPkg)
@@ -964,7 +978,27 @@ const publishNpm = async (ctx, config) => {
 //#endregion
 //#region src/action.ts
 var Action = class {
-	async handle(cmdArgs, options) {
+	async handleRelease(cmdArgs, options) {
+		const { ctx, config } = await this.createContext(cmdArgs, options);
+		await this.checkTask(ctx, config);
+		await this.bumpTask(ctx, config);
+		await this.changelogTask(ctx, config);
+		await this.gitTask(ctx, config);
+		await this.npmTask(ctx, config);
+		await this.githubTask(ctx, config);
+		if (ctx.dryRun) gitRollback(ctx);
+		taskEnd(MSG.OUTRO(ctx.dryRun));
+	}
+	async handlePrepareRelease(cmdArgs, options) {
+		const { ctx, config } = await this.createContext(cmdArgs, options, true);
+		await this.checkTask(ctx, config);
+		await this.bumpTask(ctx, config);
+		await this.changelogTask(ctx, config);
+		await this.gitTask(ctx, config);
+		if (ctx.dryRun) gitRollback(ctx);
+		taskEnd(MSG.OUTRO_PREPARE(ctx.dryRun));
+	}
+	async createContext(cmdArgs, options, prepare = false) {
 		const { version: cVersion, name: cName } = readJsonFile(join(__dirname, "../package.json"));
 		const { otp, package: defPkg, ...others } = options;
 		const { showChangelog, showRelease, ci, dryRun } = Object.fromEntries(Object.entries(others).map(([k, v]) => [k, Boolean(v)]));
@@ -974,7 +1008,7 @@ var Action = class {
 		info(MSG.INFO.TOOL(cName, cVersion));
 		info(MSG.INFO.CONFIG(configPath));
 		console.log();
-		intro(MSG.INTRO(dryRun));
+		intro(prepare ? MSG.INTRO_PREPARE(dryRun) : MSG.INTRO(dryRun));
 		const { isMonorepo, packages, getPkgDir } = config;
 		if (isMonorepo) {
 			if (ci) {
@@ -1015,7 +1049,7 @@ var Action = class {
 			pkg: {
 				name: pkgName,
 				isPrivate: pkgPrivate,
-				fromPreRelease: isPreRelease(pkgVersion),
+				fromPreRelease: isPrerelease(pkgVersion),
 				current: pkgVersion,
 				next: nextVersion,
 				toPreRelease: false,
@@ -1028,33 +1062,42 @@ var Action = class {
 			const formated = formatMessage(message, pkg$1);
 			formated && msg("PKG", formated);
 		}
-		await this.checkTask(ctx, config);
-		await this.bumpTask(ctx, config);
-		await this.changelogTask(ctx, config);
-		await this.gitTask(ctx, config);
-		await this.npmTask(ctx, config);
-		await this.githubTask(ctx, config);
-		if (dryRun) gitRollback(ctx);
-		taskEnd(MSG.OUTRO(dryRun));
+		return {
+			ctx,
+			config
+		};
 	}
 	async checkTask(ctx, config) {
-		const { noNpm, dryRun } = ctx;
-		await tasks([{
-			title: MSG.CHECK.GIT.CHECKING,
-			task: async () => {
-				await gitCheck(ctx, config);
-				const { git: { remoteName, remoteUrl } } = ctx;
-				return success(MSG.CHECK.GIT.CHECKED(remoteName, remoteUrl), dryRun);
-			}
-		}, {
-			title: MSG.CHECK.NPM.CHECKING,
-			task: async () => {
-				const msg$1 = await npmCheck(ctx, config);
-				const { pkg: { publishConfig: { registry } } } = ctx;
-				return success(MSG.CHECK.NPM.CHECKED(registry, msg$1), dryRun);
+		const { dryRun } = ctx;
+		await tasks([
+			{
+				title: MSG.CHECK.GIT.CHECKING,
+				task: async () => {
+					await gitCheck(ctx, config);
+					const { git: { remoteName, remoteUrl } } = ctx;
+					return success(MSG.CHECK.GIT.CHECKED(remoteName, remoteUrl), dryRun);
+				}
 			},
-			enabled: !noNpm
-		}]).catch(abortOnError);
+			{
+				title: MSG.CHECK.NPM.CHECKING,
+				task: async () => {
+					const msg$1 = await npmCheck(ctx, config);
+					const { pkg: { publishConfig: { registry } } } = ctx;
+					return success(MSG.CHECK.NPM.CHECKED(registry, msg$1), dryRun);
+				},
+				enabled: !ctx.noNpm
+			},
+			{
+				title: MSG.CHECK.GITHUB.CHECKING,
+				task: async () => {
+					const msg$1 = await githubCheck(ctx, config);
+					const { github: { owner, repo } } = ctx;
+					const repository = getGithubUrl(owner, repo);
+					return success(MSG.CHECK.GITHUB.CHECKED(repository, msg$1), dryRun);
+				},
+				enabled: !ctx.noGitHub
+			}
+		]).catch(abortOnError);
 	}
 	async bumpTask(ctx, config) {
 		const { pkg: { current }, dryRun, isCI, showRelease, showChangelog, selectedPkg } = ctx;
@@ -1064,8 +1107,15 @@ var Action = class {
 			return !next$1 && isIncrement$1;
 		};
 		if (need(ctx)) {
-			const parsed = parseVersion(isCI && getCIVersion(current) || (await runVersionPrompts(ctx, config)).next);
-			Object.assign(ctx.pkg, { ...parsed });
+			const nextVersion = (isCI ? inc(current, "patch") : void 0) || await runVersionPrompts(ctx, config);
+			ctx.isIncrement = neq(current, nextVersion);
+			const { version: next$1, isPrerelease: toPreRelease, preId, preBase } = parseVersion(nextVersion);
+			Object.assign(ctx.pkg, {
+				next: next$1,
+				toPreRelease,
+				preId,
+				preBase
+			});
 		}
 		const { pkg: { next }, isIncrement } = ctx;
 		if (showRelease) taskEnd(MSG.LOG.SHOW_VERSION(next));
@@ -1081,9 +1131,15 @@ var Action = class {
 		}]).catch((err) => abortOnError(err, ctx));
 		await runLifeCycleHook(hooks, "after:bump", dryRun);
 		const { from, to } = await resolveChangelogRange(isIncrement, isMonorepo ? `${tagPrefix?.(selectedPkg)}*` : "*");
-		const logStr = await getLog(from, to, getPkgDir(selectedPkg));
-		if (logStr) {
-			msg("GIT", `Changelog(${from}...${to}):${eol(2)}` + logStr);
+		const commits = await getLog(from, to, getPkgDir(selectedPkg));
+		const changelog = await getChangelog({
+			getPkgDir: () => getPkgDir(selectedPkg),
+			tagPrefix: tagPrefix?.(selectedPkg)
+		});
+		Object.assign(ctx.github, { changelog });
+		if (commits) {
+			msg("GIT", `Changelog(${from}...${to}):${eol(2)}` + changelog.trimEnd());
+			msg("GIT", `Commits(${from}...${to}):${eol(2)}` + commits);
 			if (showChangelog) taskEnd(MSG.LOG.SHOW_CHANGELOG);
 		} else msg("GIT", MSG.LOG.CHANGELOG_EMPTY);
 	}
@@ -1093,12 +1149,11 @@ var Action = class {
 		await tasks([{
 			title: MSG.TASK.CHANGELOG.START,
 			task: async () => {
-				const changelog = await generateChangelog({
+				await generateChangelog({
 					getPkgDir: () => getPkgDir(selectedPkg),
 					tagPrefix: tagPrefix?.(selectedPkg)
 				});
-				await runGit(["add", `${getPkgDir(selectedPkg)}/CHANGELOG.md`]);
-				Object.assign(ctx.github, { changelog });
+				await gitAddAll();
 				return success(MSG.TASK.CHANGELOG.END, dryRun);
 			},
 			enabled: isIncrement
@@ -1165,8 +1220,10 @@ var Action = class {
 //#endregion
 //#region src/cli.ts
 const pkg = readJsonFile(join(__dirname, "..", "package.json"));
-program.name("release").description(pkg.description).version(pkg.version, "-v, --version", "Print the tool version and exit.").usage("[release-type] [options]").argument("[release-type]", "Version bump type: patch | minor | major").option("-n, --dry-run", "Run in dry mode: show what would be released without making any changes.", false).option("-p, --package <pkg>", "Specify package name for mono-repo release (CI only).", "").option("--otp <code>", "One-time password for npm publish (used for 2FA).", "").option("--ci", "Enable CI mode: disable prompts and fail on missing required options.", false).option("--show-changelog", "Print the generated changelog and exit.", false).option("--show-release", "Print the version that would be released and exit.", false).helpOption("-h, --help", "Display help information.").action(async (releaseType, options) => {
-	await new Action().handle(releaseType, options);
+program.name("release").description(pkg.description).version(pkg.version, "-v, --version", "Print the tool version and exit.").usage("[release-type] [options]").argument("[release-type]", "Version bump type: patch | minor | major").option("-n, --dry-run", "Run in dry mode", false).option("-p, --package <pkg>", "Specify package name (CI only).", "").option("--otp <code>", "One-time password for npm publish.", "").option("--prepare", "Prepare a release.", false).option("--ci", "Enable CI mode.", false).option("--show-changelog", "Print changelog and exit.", false).option("--show-release", "Print release version and exit.", false).helpOption("-h, --help", "Display help information.").action(async (releaseType, options) => {
+	const { prepare } = options;
+	const action = new Action();
+	prepare ? await action.handlePrepareRelease(releaseType, options) : await action.handleRelease(releaseType, options);
 });
 program.command("init").description("Create a release configuration file").option("-f, --force", "Overwrite existing config file", false).option("-m, --monorepo", "Mono-repo project", false).action((options) => {
 	const { force = false, monorepo = false } = options;
@@ -1174,9 +1231,10 @@ program.command("init").description("Create a release configuration file").optio
 	const { type } = readJsonFile(join(cwd, "package.json"));
 	const isESM = type === "module";
 	const isTS = existsSync(join(cwd, "tsconfig.json"));
-	const configPath = join(cwd, `release.config.${isESM ? "" : "m"}${isTS ? "ts" : "js"}`);
+	const infile = `release.config.${isESM ? "" : "m"}${isTS ? "ts" : "js"}`;
+	const configPath = join(cwd, infile);
 	if (existsSync(configPath) && !force) {
-		console.error(`${red`Error:`} ${yellow`release.config.ts`} already exists.\nUse ${green`--force`} to overwrite.`);
+		console.error(`${red`Error:`} ${yellow(infile)} already exists.\nUse ${green`--force`} to overwrite.`);
 		process.exit(1);
 	}
 	const monoConfigToString = () => `{
@@ -1186,10 +1244,8 @@ program.command("init").description("Create a release configuration file").optio
   toTag: (pkg, version) => \`\${ pkg }@\${ version }\`,
   tagPrefix: (pkg) => \`\${ pkg }@\`,
 }`;
-	writeFileSync(configPath, `import { defineConfig } from '@peiyanlu/release'
-
-export default defineConfig(${monorepo ? monoConfigToString() : "{}"})`, "utf-8");
-	console.log(`${green`✔ release.config.ts`} created successfully`);
+	writeFileSync(configPath, [`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);
 program.on("command:*", () => {

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { DeepPartial, DeepRequired } from "@peiyanlu/ts-utils";
+import { ConventionalChangelog } from "conventional-changelog";
 import { log } from "@clack/prompts";
 
 //#region src/types.d.ts
@@ -88,14 +89,10 @@ interface ReleaseConfig {
      * 是否启用 npm 发布流程
      */
     publish: boolean | undefined;
-    /**
-     * npm 发布目标路径，对应 `npm publish <package-spec>`
-     */
-    publishPath: string;
     /**
      * 额外的 npm publish 参数（透传给 npm CLI）
      */
-    pushArgs: string[];
+    publishArgs: string[];
     /**
      * 是否跳过发布前检查（如 ping、whoami 等校验）
      */
@@ -155,4 +152,48 @@ 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>;
 //#endregion
-export { type Logger, type UserConfig, defineConfig, mergeConfig };
+//#region src/git/changelog.d.ts
+interface Options {
+  /** @example () => `packages/${pkg}` */
+  getPkgDir: () => string;
+  /** @example `${pkg}@` */
+  tagPrefix?: string;
+}
+declare const createGenerator: ({
+  getPkgDir,
+  tagPrefix
+}: Options) => Promise<ConventionalChangelog>;
+declare const getChangelog: ({
+  getPkgDir,
+  tagPrefix
+}: Options) => Promise<string>;
+declare const generateChangelog: ({
+  getPkgDir,
+  tagPrefix
+}: Options) => Promise<void>;
+//#endregion
+//#region src/index.d.ts
+interface PublishTagOptions {
+  /**
+   * 支持通过命令行参数提供
+   * @example v1.0.0; pkg@1.0.1;
+   * @example my-cli v1.0.0;
+   */
+  gitTag?: string;
+  /** @defaults `@` */
+  tagSeparator?: string;
+  /**
+   * monorepo 仓库子包不使用 `pkg@version` 格式创建 tag 时需要指定
+   * @example pkg-demo
+   */
+  defaultPackage?: string;
+  /**
+   * @example (pkg) => `packages/${pkg}`; (pkg) => '.';
+   */
+  getPkgDir?: (pkg: string) => string;
+  /** npm Trusted Publishing（OIDC） */
+  provenance?: boolean;
+}
+declare const publishTagToNpm: (options: PublishTagOptions) => Promise<void>;
+//#endregion
+export { type Logger, type UserConfig, createGenerator, defineConfig, generateChangelog, getChangelog, mergeConfig, publishTagToNpm };

package/dist/index.mjs

@@ -1,10 +1,113 @@
-import { isPlainObject } from "@peiyanlu/ts-utils";
+import { eol, getPackageInfo, getPublishedVersion, parseVersion, publishPackage } from "@peiyanlu/cli-utils";
+import { blue, cyan, dim, green, magenta, red, underline, yellow } from "ansis";
+import { lt } from "semver";
+import { isFunction, isPlainObject } from "@peiyanlu/ts-utils";
+import { createWriteStream, existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ConventionalChangelog } from "conventional-changelog";
+import createPreset from "conventional-changelog-conventionalcommits";
+import { writeFile } from "node:fs/promises";
+import { finished } from "node:stream/promises";
 
+//#region src/messages.ts
+const n = (b) => b ? "(dry run)" : "";
+const t = () => green(`${Math.floor(process.uptime())}s`);
+const MSG = {
+	INTRO: (dryRun) => `🚀  Starting release ${n(dryRun)}`,
+	INTRO_PREPARE: (dryRun) => `🚀  Starting prepare release ${n(dryRun)}`,
+	OUTRO: (dryRun) => `🎉  Release finished successfully in ${t()} ${n(dryRun)}`,
+	OUTRO_PREPARE: (dryRun) => `🎉  Prepare release finished successfully in ${t()} ${n(dryRun)}`,
+	LOG: {
+		SHOW_VERSION: (version) => `🎉  Released ${green(version)}`,
+		SHOW_CHANGELOG: "🎉  Changelog collected",
+		CHANGELOG_EMPTY: "No commits found since last release",
+		CHANGES_EMPTY: "Working tree clean. No files changed"
+	},
+	CHECK: {
+		GIT: {
+			CHECKING: "Checking Git repository",
+			CHECKED: (name, url) => `Git remote resolved: ${url ? `${dim(name)} → ${underline(dim(url))}` : "not found"}`
+		},
+		NPM: {
+			CHECKING: "Checking npm registry",
+			CHECKED: (registry, msg) => `NPM registry: ${underline(dim(registry))} ${underline(dim(msg))}`
+		},
+		GITHUB: {
+			CHECKING: "Checking github repository",
+			CHECKED: (repository, msg) => `GitHub repository: ${underline(dim(repository))} ${underline(dim(msg))}`
+		}
+	},
+	TASK: {
+		VERSION: {
+			START: "Bumping version",
+			END: (to) => `Version bumped: ${underline(dim(to))}`
+		},
+		CHANGELOG: {
+			START: "Generating changelog",
+			END: `Changelog generated`
+		},
+		NPM: {
+			START: "Publishing npm package",
+			END: (url) => `NPM package published: ${underline(dim(url))}`
+		},
+		GIT: {
+			START: "Creating git commit, tag & push",
+			END: "Git commit, tag & push completed"
+		},
+		GITHUB: {
+			START: "Creating GitHub release",
+			END: (url) => `GitHub release created: ${underline(dim(url))}`
+		}
+	},
+	PROMPT: {
+		SELECT_PACKAGE: "Select package release:",
+		SELECT_VERSION: "Select version bump:",
+		INPUT_VERSION: "Enter custom version:",
+		NPM_PUBLISH: (pkg) => `Publish to npm ${underline(dim`(${pkg})`)}?`,
+		NPM_OTP: "Enter npm one-time password (OTP):",
+		GITHUB_RELEASE: (title) => `Create a new GitHub release ${underline(dim`(${title})`)}?`,
+		GIT_COMMIT: (msg) => `Create git commit ${underline(dim`(${msg})`)}?`,
+		GIT_TAG: (msg) => `Create git tag ${underline(dim`(${msg})`)}?`,
+		GIT_PUSH: "Push commits and tags to remote?"
+	},
+	ERROR: {
+		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_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)}.`
+	},
+	ABORT: {
+		CANCEL: "Operation cancelled",
+		MONOREPO_CI_NO_PACKAGE: "CI mode requires a target package in monorepo. Please specify it via \"--package <pkg>\"",
+		MONOREPO_NO_PACKAGES: "Monorepo detected, but no packages found. Please configure \"config.packages\""
+	},
+	INFO: {
+		TOOL: (name, version) => `${name} ${dim(`v${version}`)}`,
+		CONFIG: (path) => `config file: ${underline(dim(path || "not found"))}`
+	}
+};
+
+//#endregion
+//#region src/npm/publish.ts
+const resolvePublishTag = async (pkgName, version) => {
+	const { isPrerelease, preId } = parseVersion(version);
+	if (isPrerelease) return preId || "next";
+	const active = await getPublishedVersion(pkgName);
+	if (!active) return "latest";
+	return lt(version, active) ? "previous" : "latest";
+};
+
+//#endregion
 //#region src/config.ts
 function defineConfig(config) {
 	return config;
 }
-const isFunction = (v) => typeof v === "function";
 const mergeConfig = (defaults, overrides) => {
 	if (!overrides) return structuredClone(defaults);
 	if (Object.keys(defaults).length === 0) return structuredClone(overrides);
@@ -22,4 +125,218 @@ const mergeConfig = (defaults, overrides) => {
 };
 
 //#endregion
-export { defineConfig, mergeConfig };
+//#region src/git/changetype.ts
+const defaultTypes = [
+	{
+		type: "feat",
+		section: "✨ 新功能",
+		description: "新增功能"
+	},
+	{
+		type: "feature",
+		section: "✨ 新功能",
+		description: "新增功能"
+	},
+	{
+		type: "fix",
+		section: "🐛 Bug 修复",
+		description: "修复 bug"
+	},
+	{
+		type: "perf",
+		section: "⚡ 性能优化",
+		description: "提升性能"
+	},
+	{
+		type: "revert",
+		section: "⏪ 回退",
+		description: "回退到之前版本"
+	},
+	{
+		type: "docs",
+		section: "📝 文档",
+		description: "文档更新"
+	},
+	{
+		type: "style",
+		section: "💄 样式调整",
+		description: "样式或格式修改"
+	},
+	{
+		type: "chore",
+		section: "🎫 其他更新",
+		description: "非功能性更改"
+	},
+	{
+		type: "refactor",
+		section: "♻ 代码重构",
+		description: "重构代码"
+	},
+	{
+		type: "test",
+		section: "✅ 测试",
+		description: "测试更新"
+	},
+	{
+		type: "build",
+		section: "👷‍ 构建系统",
+		description: "构建工具和系统修改"
+	},
+	{
+		type: "ci",
+		section: "🔧 CI 配置",
+		description: "持续集成配置"
+	},
+	{
+		type: "config",
+		section: "🔨 配置",
+		description: "配置文件更新"
+	},
+	{
+		type: "deps",
+		section: "🔗 依赖更新",
+		description: "依赖版本变更"
+	},
+	{
+		type: "security",
+		section: "🔒 安全修复",
+		description: "安全性更新"
+	},
+	{
+		type: "i18n",
+		section: "🌐 国际化",
+		description: "国际化相关更新"
+	},
+	{
+		type: "ux",
+		section: "🖥️ 用户体验",
+		description: "用户体验改进"
+	},
+	{
+		type: "hotfix",
+		section: "🔥 热修复",
+		description: "紧急修复"
+	}
+];
+
+//#endregion
+//#region src/git/changelog.ts
+const createGenerator = async ({ getPkgDir, tagPrefix }) => {
+	const pkgDir = getPkgDir();
+	const preset = await createPreset({ types: defaultTypes.map((t$1) => ({
+		...t$1,
+		hidden: false
+	})) });
+	preset.writer ??= {};
+	preset.writer.headerPartial = `
+## {{#if isPatch~}} <small> {{~/if~}}
+{{#if @root.linkCompare~}}
+[{{version}}](
+{{~#if @root.repository~}}
+  {{~#if @root.host}}
+    {{~@root.host}}/
+  {{~/if}}
+  {{~#if @root.owner}}
+    {{~@root.owner}}/
+  {{~/if}}
+  {{~@root.repository}}
+{{~else}}
+  {{~@root.repoUrl}}
+{{~/if~}}
+/compare/{{previousTag}}...{{currentTag}})
+{{~else}}
+{{~version}}
+{{~/if}}
+{{~#if title}} "{{title}}"
+{{~/if}}
+{{~#if date}} ({{date}})
+{{~/if}}
+{{~#if isPatch~}} </small> {{~/if}}
+`.trim() + eol();
+	preset.writer.mainTemplate = `
+{{> header}}
+{{#if noteGroups}}
+{{#each noteGroups}}
+
+### ⚠ {{title}}
+
+{{#each notes}}
+* {{#if commit.scope}}**{{commit.scope}}:** {{/if}}{{commit.subject}} {{#if commit.hash}}([{{commit.shortHash}}](https://github.com/{{@root.owner}}/{{@root.repository}}/commit/{{commit.hash}})){{/if}}
+{{/each}}
+{{/each}}
+{{/if}}
+{{#each commitGroups}}
+
+{{#if title}}
+### {{title}}
+
+{{/if}}
+{{#each commits}}
+{{> commit root=@root}}
+{{/each}}
+{{/each}}`.trim() + eol(2);
+	return new ConventionalChangelog().readPackage(`${pkgDir}/package.json`).config(preset).options({ releaseCount: 1 }).commits({ path: pkgDir }).tags({ prefix: tagPrefix });
+};
+const getChangelog = async ({ getPkgDir, tagPrefix }) => {
+	const generator = await createGenerator({
+		getPkgDir,
+		tagPrefix
+	});
+	let changelog = "";
+	for await (const chunk of generator.write()) changelog += chunk;
+	return changelog;
+};
+const generateChangelog = async ({ getPkgDir, tagPrefix }) => {
+	const infile = join(getPkgDir(), "CHANGELOG.md");
+	if (!existsSync(infile)) await writeFile(infile, "");
+	const originalChangelog = readFileSync(infile, "utf-8");
+	const generator = await createGenerator({
+		getPkgDir,
+		tagPrefix
+	});
+	const writeStream = createWriteStream(infile);
+	for await (const chunk of generator.write()) writeStream.write(chunk);
+	writeStream.write(originalChangelog);
+	writeStream.end();
+	await finished(writeStream);
+};
+
+//#endregion
+//#region src/index.ts
+const publishTagToNpm = async (options) => {
+	const { gitTag, defaultPackage, tagSeparator = "@", getPkgDir = () => ".", provenance } = options;
+	const tag = process.argv.slice(2)[0] || gitTag;
+	if (!tag) throw new Error(`❌ No git tag specified.`);
+	console.log(`\n📦 Start publishing from git tag: ${cyan(tag)}`);
+	let pkgName = defaultPackage;
+	let version;
+	if (tag.includes(tagSeparator)) {
+		[pkgName, version] = tag.split(tagSeparator);
+		console.log(`🔍 Parsed tag → package: "${yellow(pkgName)}", version: "${green(version)}"`);
+	} else {
+		version = tag;
+		console.log(`🔍 Parsed tag → version only: "${green(version)}"`);
+	}
+	if (version.startsWith("v")) {
+		version = version.slice(1);
+		console.log(`✂️  Normalized version (strip v): ${version}`);
+	}
+	if (!pkgName) throw new Error(`❌ Package name should be specified in tag "${tag}" when defaultPackage is not set`);
+	console.log(`📁 Resolving package info for "${magenta(pkgName)}"...`);
+	const { pkg, pkgDir } = getPackageInfo(pkgName, getPkgDir);
+	console.log(`📄 package.json → name: ${yellow(pkg.name)}, version: ${green(pkg.version)}`);
+	console.log(`📂 Package directory: ${underline(pkgDir)}`);
+	if (pkg.version !== version) throw new Error(`❌ Package version from tag "${version}" mismatches with current version "${pkg.version}"`);
+	const publishTag = await resolvePublishTag(pkg.name, version);
+	console.log(`🏷 Resolved npm dist-tag: "${blue(publishTag)}" (version ${green(version)})`);
+	console.log(`🚀 Publishing "${red`${pkg.name}@${version}`}" to npm...`);
+	await publishPackage({
+		tag: publishTag,
+		args: provenance ? ["--provenance"] : [],
+		cwd: pkgDir
+	});
+	console.log(`🎉 Successfully published ${red`${pkg.name}@${version}`} with dist-tag "${blue(publishTag)}"\n`);
+};
+
+//#endregion
+export { createGenerator, defineConfig, generateChangelog, getChangelog, mergeConfig, publishTagToNpm };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peiyanlu/release",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Release project tool.",
   "license": "MIT",
   "type": "module",
@@ -21,15 +21,15 @@
     "dev": "tsdown -w",
     "build": "tsdown",
     "prepublish": "tsdown",
-    "release": "tsdown && node index.js",
+    "release": "node index.js",
     "test": "vitest run",
     "test:cov": "vitest run --coverage"
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
     "@octokit/rest": "^22.0.1",
-    "@peiyanlu/cli-utils": "^0.0.6",
-    "@peiyanlu/ts-utils": "^0.0.4",
+    "@peiyanlu/cli-utils": "^0.0.7",
+    "@peiyanlu/ts-utils": "^0.0.5",
     "ansis": "^4.2.0",
     "commander": "^14.0.2",
     "conventional-changelog": "^7.1.1",