@peiyanlu/cli-utils 0.0.6 → 0.0.7

package/dist/index.cjs

@@ -4,6 +4,7 @@ let node_os = require("node:os");
 let node_path = require("node:path");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
+let semver = require("semver");
 
 //#region src/enums.ts
 let PkgManager = /* @__PURE__ */ function(PkgManager$1) {
@@ -42,6 +43,9 @@ const red = (text) => (0, node_util.styleText)(["red"], text);
 
 //#endregion
 //#region src/shell.ts
+const formatErr = (caller, cmd, err) => {
+	return `${red(caller)} ${dim(cmd)}${eol()}${err}`;
+};
 /** 异步执行 `spawn` 获取字符串类型的结果 */
 const spawnAsync = (cmd, args, options) => {
 	return new Promise((resolve$2, reject) => {
@@ -65,7 +69,7 @@ const spawnAsync = (cmd, args, options) => {
 		child.on("error", reject);
 		child.on("close", (code) => {
 			if (code !== 0) {
-				const msg = `${red("spawnAsync")} ${dim(fullCmd)} ${stderr}`;
+				const msg = formatErr("spawnAsync", fullCmd, stderr);
 				if (error === "log") {
 					console.error(msg);
 					return resolve$2(void 0);
@@ -96,7 +100,8 @@ const execAsync = (cmd, argsOrOptions, maybeOptions) => {
 		}
 		(0, node_child_process.exec)(command, { ...others }, (err, stdout, stderr) => {
 			if (err) {
-				const msg = `${red("execAsync")} ${dim(command)} ${stderr || err.message}`;
+				const detail = stderr?.toString?.() || err?.message || "";
+				const msg = formatErr("execAsync", command, detail);
 				if (error === "log") {
 					console.error(msg);
 					return resolve$2(void 0);
@@ -121,8 +126,7 @@ const spawnSyncWithString = (cmd, args, options) => {
 		...others
 	});
 	if (status !== 0 || err) {
-		const detail = err?.message || stderr?.toString?.() || "";
-		const msg = `${red("spawnSync")} ${dim(fullCmd)} ${detail}`;
+		const msg = formatErr("spawnSync", fullCmd, err?.message || stderr?.toString?.() || "");
 		if (error === "log") {
 			console.error(msg);
 			return;
@@ -156,7 +160,7 @@ const execSyncWithString = (cmd, argsOrOptions, maybeOptions) => {
 		return trim ? stdout.trim() : stdout;
 	} catch (e) {
 		const stderr = e?.stderr?.toString?.() || e?.message || "";
-		const msg = `${red("execSync")} ${dim(command)} ${stderr}`;
+		const msg = formatErr("execSync", command, stderr);
 		if (error === "log") {
 			console.error(msg);
 			return;
@@ -1108,7 +1112,35 @@ const publishPackage = (options) => {
 		...registryArg(registry),
 		"--workspaces=false",
 		...args
-	], { cwd });
+	], {
+		cwd,
+		error: "throw"
+	});
+};
+
+//#endregion
+//#region src/version.ts
+const isPrerelease = (version) => {
+	return Boolean((0, semver.prerelease)(version));
+};
+const isValid = (version) => {
+	return Boolean((0, semver.valid)(version));
+};
+const cleanVersion = (version) => {
+	return (0, semver.clean)(version) ?? version;
+};
+const parseVersion = (raw) => {
+	const version = isValid(raw) ? raw : (0, semver.coerce)(raw)?.toString();
+	if (!version) return {};
+	const { prerelease: prerelease$1 } = (0, semver.parse)(version);
+	const isPrerelease$1 = Boolean(prerelease$1.length);
+	const [preId, preBase] = prerelease$1.map(String);
+	return {
+		version,
+		isPrerelease: isPrerelease$1,
+		preId,
+		preBase
+	};
 };
 
 //#endregion
@@ -1122,6 +1154,7 @@ exports.YesOrNo = YesOrNo;
 exports.accessArg = accessArg;
 exports.bumpPackageVersion = bumpPackageVersion;
 exports.checkVersion = checkVersion;
+exports.cleanVersion = cleanVersion;
 exports.coloredChangeset = coloredChangeset;
 exports.copyDirAsync = copyDirAsync;
 exports.countCommitsSinceLatestTag = countCommitsSinceLatestTag;
@@ -1174,13 +1207,16 @@ exports.hasUpstreamBranch = hasUpstreamBranch;
 exports.hasWriteAccess = hasWriteAccess;
 exports.isEmpty = isEmpty;
 exports.isGitRepo = isGitRepo;
+exports.isPrerelease = isPrerelease;
 exports.isRemoteName = isRemoteName;
 exports.isTestFile = isTestFile;
+exports.isValid = isValid;
 exports.isValidPackageName = isValidPackageName;
 exports.isWorkingDirClean = isWorkingDirClean;
 exports.joinUrl = joinUrl;
 exports.parseArgs = parseArgs;
 exports.parseGitHubRepo = parseGitHubRepo;
+exports.parseVersion = parseVersion;
 exports.pingRegistry = pingRegistry;
 exports.pkgFromUserAgent = pkgFromUserAgent;
 exports.publishPackage = publishPackage;

package/dist/index.d.cts

@@ -522,4 +522,20 @@ declare const publishPackage: (options?: {
   cwd?: string;
 }) => Promise<string | undefined>;
 //#endregion
-export { CliOptions, ConfirmResult, CopyOptions, DEFAULT_ACCESS, DEFAULT_REGISTRY, DEFAULT_TAG, ExecAsyncWithStringOptions, ExecResultOptions, ExecSyncWithStringOptions, HttpLibrary, PkgInfo, PkgManager, SpawnAsyncWithStringOptions, SpawnSyncWithStringOptions, YesOrNo, accessArg, bumpPackageVersion, checkVersion, coloredChangeset, copyDirAsync, countCommitsSinceLatestTag, deleteTag, deleteTagSync, discardAll, discardAllSync, discardFile, editFile, editJsonFile, emptyDir, eol, execAsync, execSyncWithString, fetchAllBranch, getAccess, getAllRemotes, getAuthenticatedUser, getCurrentBranch, getDefaultRemote, getDistTags, getFullHash, getGitConfig, getGitRemoteUrl, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLocalTags, getLog, getOtherRemotes, getPackageInfo, getPackageUrl, getPreviousTag, getPublishedVersion, getRegistry, getRemote, getRemoteForBranch, getRemoteTags, getSortedTags, getStatus, getUpstreamArgs, gitAddAll, gitAddTracked, gitCommit, gitCommitAmend, gitTagAnnotated, gitTagLightweight, gitUndo, hasUpstreamBranch, hasWriteAccess, isEmpty, isGitRepo, isRemoteName, isTestFile, isValidPackageName, isWorkingDirClean, joinUrl, parseArgs, parseGitHubRepo, pingRegistry, pkgFromUserAgent, publishPackage, pushBranch, pushTag, readJsonFile, readSubDirs, registryArg, resetHard, resetHardSync, resetMixed, resetSoft, resolveChangelogRange, restoreAll, restoreAllSync, restoreFile, restoreFileFromCommit, restoreFromCommit, revertCommit, runCliForTest, runGit, runGitSync, runNode, runNodeSync, runNpm, runNpmSync, space, spawnAsync, spawnSyncWithString, stringifyArgs, tagArg, toValidPackageName, toValidProjectName, trimTemplate, unstageAll, unstageFile };
+//#region src/version.d.ts
+declare const isPrerelease: (version: string) => boolean;
+declare const isValid: (version: string) => boolean;
+declare const cleanVersion: (version: string) => string;
+declare const parseVersion: (raw: string) => {
+  version?: undefined;
+  isPrerelease?: undefined;
+  preId?: undefined;
+  preBase?: undefined;
+} | {
+  version: string;
+  isPrerelease: boolean;
+  preId: string;
+  preBase: string;
+};
+//#endregion
+export { CliOptions, ConfirmResult, CopyOptions, DEFAULT_ACCESS, DEFAULT_REGISTRY, DEFAULT_TAG, ExecAsyncWithStringOptions, ExecResultOptions, ExecSyncWithStringOptions, HttpLibrary, PkgInfo, PkgManager, SpawnAsyncWithStringOptions, SpawnSyncWithStringOptions, YesOrNo, accessArg, bumpPackageVersion, checkVersion, cleanVersion, coloredChangeset, copyDirAsync, countCommitsSinceLatestTag, deleteTag, deleteTagSync, discardAll, discardAllSync, discardFile, editFile, editJsonFile, emptyDir, eol, execAsync, execSyncWithString, fetchAllBranch, getAccess, getAllRemotes, getAuthenticatedUser, getCurrentBranch, getDefaultRemote, getDistTags, getFullHash, getGitConfig, getGitRemoteUrl, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLocalTags, getLog, getOtherRemotes, getPackageInfo, getPackageUrl, getPreviousTag, getPublishedVersion, getRegistry, getRemote, getRemoteForBranch, getRemoteTags, getSortedTags, getStatus, getUpstreamArgs, gitAddAll, gitAddTracked, gitCommit, gitCommitAmend, gitTagAnnotated, gitTagLightweight, gitUndo, hasUpstreamBranch, hasWriteAccess, isEmpty, isGitRepo, isPrerelease, isRemoteName, isTestFile, isValid, isValidPackageName, isWorkingDirClean, joinUrl, parseArgs, parseGitHubRepo, parseVersion, pingRegistry, pkgFromUserAgent, publishPackage, pushBranch, pushTag, readJsonFile, readSubDirs, registryArg, resetHard, resetHardSync, resetMixed, resetSoft, resolveChangelogRange, restoreAll, restoreAllSync, restoreFile, restoreFileFromCommit, restoreFromCommit, revertCommit, runCliForTest, runGit, runGitSync, runNode, runNodeSync, runNpm, runNpmSync, space, spawnAsync, spawnSyncWithString, stringifyArgs, tagArg, toValidPackageName, toValidProjectName, trimTemplate, unstageAll, unstageFile };

package/dist/index.d.mts

@@ -522,4 +522,20 @@ declare const publishPackage: (options?: {
   cwd?: string;
 }) => Promise<string | undefined>;
 //#endregion
-export { CliOptions, ConfirmResult, CopyOptions, DEFAULT_ACCESS, DEFAULT_REGISTRY, DEFAULT_TAG, ExecAsyncWithStringOptions, ExecResultOptions, ExecSyncWithStringOptions, HttpLibrary, PkgInfo, PkgManager, SpawnAsyncWithStringOptions, SpawnSyncWithStringOptions, YesOrNo, accessArg, bumpPackageVersion, checkVersion, coloredChangeset, copyDirAsync, countCommitsSinceLatestTag, deleteTag, deleteTagSync, discardAll, discardAllSync, discardFile, editFile, editJsonFile, emptyDir, eol, execAsync, execSyncWithString, fetchAllBranch, getAccess, getAllRemotes, getAuthenticatedUser, getCurrentBranch, getDefaultRemote, getDistTags, getFullHash, getGitConfig, getGitRemoteUrl, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLocalTags, getLog, getOtherRemotes, getPackageInfo, getPackageUrl, getPreviousTag, getPublishedVersion, getRegistry, getRemote, getRemoteForBranch, getRemoteTags, getSortedTags, getStatus, getUpstreamArgs, gitAddAll, gitAddTracked, gitCommit, gitCommitAmend, gitTagAnnotated, gitTagLightweight, gitUndo, hasUpstreamBranch, hasWriteAccess, isEmpty, isGitRepo, isRemoteName, isTestFile, isValidPackageName, isWorkingDirClean, joinUrl, parseArgs, parseGitHubRepo, pingRegistry, pkgFromUserAgent, publishPackage, pushBranch, pushTag, readJsonFile, readSubDirs, registryArg, resetHard, resetHardSync, resetMixed, resetSoft, resolveChangelogRange, restoreAll, restoreAllSync, restoreFile, restoreFileFromCommit, restoreFromCommit, revertCommit, runCliForTest, runGit, runGitSync, runNode, runNodeSync, runNpm, runNpmSync, space, spawnAsync, spawnSyncWithString, stringifyArgs, tagArg, toValidPackageName, toValidProjectName, trimTemplate, unstageAll, unstageFile };
+//#region src/version.d.ts
+declare const isPrerelease: (version: string) => boolean;
+declare const isValid: (version: string) => boolean;
+declare const cleanVersion: (version: string) => string;
+declare const parseVersion: (raw: string) => {
+  version?: undefined;
+  isPrerelease?: undefined;
+  preId?: undefined;
+  preBase?: undefined;
+} | {
+  version: string;
+  isPrerelease: boolean;
+  preId: string;
+  preBase: string;
+};
+//#endregion
+export { CliOptions, ConfirmResult, CopyOptions, DEFAULT_ACCESS, DEFAULT_REGISTRY, DEFAULT_TAG, ExecAsyncWithStringOptions, ExecResultOptions, ExecSyncWithStringOptions, HttpLibrary, PkgInfo, PkgManager, SpawnAsyncWithStringOptions, SpawnSyncWithStringOptions, YesOrNo, accessArg, bumpPackageVersion, checkVersion, cleanVersion, coloredChangeset, copyDirAsync, countCommitsSinceLatestTag, deleteTag, deleteTagSync, discardAll, discardAllSync, discardFile, editFile, editJsonFile, emptyDir, eol, execAsync, execSyncWithString, fetchAllBranch, getAccess, getAllRemotes, getAuthenticatedUser, getCurrentBranch, getDefaultRemote, getDistTags, getFullHash, getGitConfig, getGitRemoteUrl, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLocalTags, getLog, getOtherRemotes, getPackageInfo, getPackageUrl, getPreviousTag, getPublishedVersion, getRegistry, getRemote, getRemoteForBranch, getRemoteTags, getSortedTags, getStatus, getUpstreamArgs, gitAddAll, gitAddTracked, gitCommit, gitCommitAmend, gitTagAnnotated, gitTagLightweight, gitUndo, hasUpstreamBranch, hasWriteAccess, isEmpty, isGitRepo, isPrerelease, isRemoteName, isTestFile, isValid, isValidPackageName, isWorkingDirClean, joinUrl, parseArgs, parseGitHubRepo, parseVersion, pingRegistry, pkgFromUserAgent, publishPackage, pushBranch, pushTag, readJsonFile, readSubDirs, registryArg, resetHard, resetHardSync, resetMixed, resetSoft, resolveChangelogRange, restoreAll, restoreAllSync, restoreFile, restoreFileFromCommit, restoreFromCommit, revertCommit, runCliForTest, runGit, runGitSync, runNode, runNodeSync, runNpm, runNpmSync, space, spawnAsync, spawnSyncWithString, stringifyArgs, tagArg, toValidPackageName, toValidProjectName, trimTemplate, unstageAll, unstageFile };

package/dist/index.mjs

@@ -4,6 +4,7 @@ import { EOL } from "node:os";
 import { join, resolve } from "node:path";
 import { exec, execSync, spawn, spawnSync } from "node:child_process";
 import { styleText } from "node:util";
+import { clean, coerce, parse, prerelease, valid } from "semver";
 
 //#region src/enums.ts
 let PkgManager = /* @__PURE__ */ function(PkgManager$1) {
@@ -42,6 +43,9 @@ const red = (text) => styleText(["red"], text);
 
 //#endregion
 //#region src/shell.ts
+const formatErr = (caller, cmd, err) => {
+	return `${red(caller)} ${dim(cmd)}${eol()}${err}`;
+};
 /** 异步执行 `spawn` 获取字符串类型的结果 */
 const spawnAsync = (cmd, args, options) => {
 	return new Promise((resolve$1, reject) => {
@@ -65,7 +69,7 @@ const spawnAsync = (cmd, args, options) => {
 		child.on("error", reject);
 		child.on("close", (code) => {
 			if (code !== 0) {
-				const msg = `${red("spawnAsync")} ${dim(fullCmd)} ${stderr}`;
+				const msg = formatErr("spawnAsync", fullCmd, stderr);
 				if (error === "log") {
 					console.error(msg);
 					return resolve$1(void 0);
@@ -96,7 +100,8 @@ const execAsync = (cmd, argsOrOptions, maybeOptions) => {
 		}
 		exec(command, { ...others }, (err, stdout, stderr) => {
 			if (err) {
-				const msg = `${red("execAsync")} ${dim(command)} ${stderr || err.message}`;
+				const detail = stderr?.toString?.() || err?.message || "";
+				const msg = formatErr("execAsync", command, detail);
 				if (error === "log") {
 					console.error(msg);
 					return resolve$1(void 0);
@@ -121,8 +126,7 @@ const spawnSyncWithString = (cmd, args, options) => {
 		...others
 	});
 	if (status !== 0 || err) {
-		const detail = err?.message || stderr?.toString?.() || "";
-		const msg = `${red("spawnSync")} ${dim(fullCmd)} ${detail}`;
+		const msg = formatErr("spawnSync", fullCmd, err?.message || stderr?.toString?.() || "");
 		if (error === "log") {
 			console.error(msg);
 			return;
@@ -156,7 +160,7 @@ const execSyncWithString = (cmd, argsOrOptions, maybeOptions) => {
 		return trim ? stdout.trim() : stdout;
 	} catch (e) {
 		const stderr = e?.stderr?.toString?.() || e?.message || "";
-		const msg = `${red("execSync")} ${dim(command)} ${stderr}`;
+		const msg = formatErr("execSync", command, stderr);
 		if (error === "log") {
 			console.error(msg);
 			return;
@@ -1108,8 +1112,36 @@ const publishPackage = (options) => {
 		...registryArg(registry),
 		"--workspaces=false",
 		...args
-	], { cwd });
+	], {
+		cwd,
+		error: "throw"
+	});
+};
+
+//#endregion
+//#region src/version.ts
+const isPrerelease = (version) => {
+	return Boolean(prerelease(version));
+};
+const isValid = (version) => {
+	return Boolean(valid(version));
+};
+const cleanVersion = (version) => {
+	return clean(version) ?? version;
+};
+const parseVersion = (raw) => {
+	const version = isValid(raw) ? raw : coerce(raw)?.toString();
+	if (!version) return {};
+	const { prerelease: prerelease$1 } = parse(version);
+	const isPrerelease$1 = Boolean(prerelease$1.length);
+	const [preId, preBase] = prerelease$1.map(String);
+	return {
+		version,
+		isPrerelease: isPrerelease$1,
+		preId,
+		preBase
+	};
 };
 
 //#endregion
-export { ConfirmResult, DEFAULT_ACCESS, DEFAULT_REGISTRY, DEFAULT_TAG, HttpLibrary, PkgManager, YesOrNo, accessArg, bumpPackageVersion, checkVersion, coloredChangeset, copyDirAsync, countCommitsSinceLatestTag, deleteTag, deleteTagSync, discardAll, discardAllSync, discardFile, editFile, editJsonFile, emptyDir, eol, execAsync, execSyncWithString, fetchAllBranch, getAccess, getAllRemotes, getAuthenticatedUser, getCurrentBranch, getDefaultRemote, getDistTags, getFullHash, getGitConfig, getGitRemoteUrl, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLocalTags, getLog, getOtherRemotes, getPackageInfo, getPackageUrl, getPreviousTag, getPublishedVersion, getRegistry, getRemote, getRemoteForBranch, getRemoteTags, getSortedTags, getStatus, getUpstreamArgs, gitAddAll, gitAddTracked, gitCommit, gitCommitAmend, gitTagAnnotated, gitTagLightweight, gitUndo, hasUpstreamBranch, hasWriteAccess, isEmpty, isGitRepo, isRemoteName, isTestFile, isValidPackageName, isWorkingDirClean, joinUrl, parseArgs, parseGitHubRepo, pingRegistry, pkgFromUserAgent, publishPackage, pushBranch, pushTag, readJsonFile, readSubDirs, registryArg, resetHard, resetHardSync, resetMixed, resetSoft, resolveChangelogRange, restoreAll, restoreAllSync, restoreFile, restoreFileFromCommit, restoreFromCommit, revertCommit, runCliForTest, runGit, runGitSync, runNode, runNodeSync, runNpm, runNpmSync, space, spawnAsync, spawnSyncWithString, stringifyArgs, tagArg, toValidPackageName, toValidProjectName, trimTemplate, unstageAll, unstageFile };
+export { ConfirmResult, DEFAULT_ACCESS, DEFAULT_REGISTRY, DEFAULT_TAG, HttpLibrary, PkgManager, YesOrNo, accessArg, bumpPackageVersion, checkVersion, cleanVersion, coloredChangeset, copyDirAsync, countCommitsSinceLatestTag, deleteTag, deleteTagSync, discardAll, discardAllSync, discardFile, editFile, editJsonFile, emptyDir, eol, execAsync, execSyncWithString, fetchAllBranch, getAccess, getAllRemotes, getAuthenticatedUser, getCurrentBranch, getDefaultRemote, getDistTags, getFullHash, getGitConfig, getGitRemoteUrl, getGithubReleaseUrl, getGithubUrl, getLatestTag, getLocalTags, getLog, getOtherRemotes, getPackageInfo, getPackageUrl, getPreviousTag, getPublishedVersion, getRegistry, getRemote, getRemoteForBranch, getRemoteTags, getSortedTags, getStatus, getUpstreamArgs, gitAddAll, gitAddTracked, gitCommit, gitCommitAmend, gitTagAnnotated, gitTagLightweight, gitUndo, hasUpstreamBranch, hasWriteAccess, isEmpty, isGitRepo, isPrerelease, isRemoteName, isTestFile, isValid, isValidPackageName, isWorkingDirClean, joinUrl, parseArgs, parseGitHubRepo, parseVersion, pingRegistry, pkgFromUserAgent, publishPackage, pushBranch, pushTag, readJsonFile, readSubDirs, registryArg, resetHard, resetHardSync, resetMixed, resetSoft, resolveChangelogRange, restoreAll, restoreAllSync, restoreFile, restoreFileFromCommit, restoreFromCommit, revertCommit, runCliForTest, runGit, runGitSync, runNode, runNodeSync, runNpm, runNpmSync, space, spawnAsync, spawnSyncWithString, stringifyArgs, tagArg, toValidPackageName, toValidProjectName, trimTemplate, unstageAll, unstageFile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peiyanlu/cli-utils",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Shared utils for building interactive Node.js CLI applications.",
   "license": "MIT",
   "type": "module",
@@ -21,6 +21,7 @@
   "devDependencies": {
     "@release-it/conventional-changelog": "^10.0.2",
     "@types/node": "^24.10.3",
+    "@types/semver": "^7.7.1",
     "@vitest/coverage-v8": "^4.0.15",
     "release-it": "^19.0.2",
     "release-it-pnpm": "^4.6.6",
@@ -54,6 +55,9 @@
     "url": "https://github.com/peiyanlu/cli-utils/issues"
   },
   "homepage": "https://github.com/peiyanlu/cli-utils#readme",
+  "dependencies": {
+    "semver": "^7.7.3"
+  },
   "scripts": {
     "dev": "tsdown -w",
     "build": "tsdown",