alex-c-line 1.26.2 → 1.27.1

package/dist/configs/internal/index.d.cts

@@ -92,10 +92,16 @@ declare const alexCLineConfig: AlexCLineConfig<keyof typeof scripts>;
 //#region src/configs/internal/infrastructureConfig.d.ts
 declare const infrastructureConfig: AlexCLineConfig<"format" | "lint">;
 //#endregion
-//#region src/configs/internal/PreCommitSteps.d.ts
-type PreCommitSteps = "build" | "format" | "lint" | "test";
+//#region src/configs/internal/PreCommitStep.d.ts
+declare const PreCommitStep: {
+  readonly BUILD: "build";
+  readonly FORMAT: "format";
+  readonly LINT: "lint";
+  readonly TEST: "test";
+};
+type PreCommitStep = "build" | "format" | "lint" | "test";
 //#endregion
 //#region src/configs/internal/packageConfig.d.ts
-declare function packageConfig(steps?: PreCommitSteps[]): AlexCLineConfig<PreCommitSteps>;
+declare function packageConfig<ScriptName extends string = PreCommitStep>(steps?: (StepFunction | ScriptName | PreCommitStep | [ScriptName | PreCommitStep, PreCommitStepOptions])[]): AlexCLineConfig<PreCommitStep>;
 //#endregion
 export { alexCLineConfig, infrastructureConfig, packageConfig };

package/dist/configs/internal/index.d.ts

@@ -92,10 +92,16 @@ declare const alexCLineConfig: AlexCLineConfig<keyof typeof scripts>;
 //#region src/configs/internal/infrastructureConfig.d.ts
 declare const infrastructureConfig: AlexCLineConfig<"format" | "lint">;
 //#endregion
-//#region src/configs/internal/PreCommitSteps.d.ts
-type PreCommitSteps = "build" | "format" | "lint" | "test";
+//#region src/configs/internal/PreCommitStep.d.ts
+declare const PreCommitStep: {
+  readonly BUILD: "build";
+  readonly FORMAT: "format";
+  readonly LINT: "lint";
+  readonly TEST: "test";
+};
+type PreCommitStep = "build" | "format" | "lint" | "test";
 //#endregion
 //#region src/configs/internal/packageConfig.d.ts
-declare function packageConfig(steps?: PreCommitSteps[]): AlexCLineConfig<PreCommitSteps>;
+declare function packageConfig<ScriptName extends string = PreCommitStep>(steps?: (StepFunction | ScriptName | PreCommitStep | [ScriptName | PreCommitStep, PreCommitStepOptions])[]): AlexCLineConfig<PreCommitStep>;
 //#endregion
 export { alexCLineConfig, infrastructureConfig, packageConfig };

package/dist/index.cjs

@@ -98,12 +98,12 @@ function centerLine(text, width) {
 //#endregion
 //#region src/utility/miscellaneous/createAlexCLineArtwork.ts
 async function createAlexCLineArtwork(options) {
-	const { includeColors = true } = options ?? {};
+	const { includeColors = true, subtitleColor = chalk.default.green, subtitleText = "say my name and I'll assist ✓" } = options ?? {};
 	const title = await (0, figlet.default)("alex-c-line");
-	const subtitle = centerLine("say my name and I'll assist ✓", Math.max(...title.split("\n").map((line) => {
+	const subtitle = centerLine(subtitleText, Math.max(...title.split("\n").map((line) => {
 		return line.length;
 	})));
-	return (0, boxen.default)(includeColors ? [chalk.default.yellow(title), chalk.default.green(subtitle)].join("\n") : [title, subtitle].join("\n"), {
+	return (0, boxen.default)(includeColors ? [chalk.default.yellow(title), subtitleColor(subtitle)].join("\n") : [title, subtitle].join("\n"), {
 		padding: {
 			top: 1,
 			bottom: 1,
@@ -1250,32 +1250,207 @@ function setReleaseStatus2(program) {
 }
 
 //#endregion
-//#region src/utility/cache/createAlexCLineCache.ts
-async function createAlexCLineCache(cacheContents) {
+//#region package.json
+var name = "alex-c-line";
+var version = "1.27.1";
+var description = "Command-line tool with commands to streamline the developer workflow.";
+var package_default = {
+	name,
+	version,
+	description,
+	repository: {
+		"type": "git",
+		"url": "git+https://github.com/alextheman231/alex-c-line.git"
+	},
+	license: "MIT",
+	author: "alextheman",
+	type: "module",
+	exports: {
+		"./configs": {
+			"types": "./dist/configs/index.d.ts",
+			"require": "./dist/configs/index.cjs",
+			"import": "./dist/configs/index.js",
+			"default": "./dist/configs/index.js"
+		},
+		"./configs/internal": {
+			"types": "./dist/configs/internal/index.d.ts",
+			"require": "./dist/configs/internal/index.cjs",
+			"import": "./dist/configs/internal/index.js",
+			"default": "./dist/configs/internal/index.js"
+		}
+	},
+	main: "dist/index.js",
+	module: "dist/index.cjs",
+	types: "dist/index.d.ts",
+	bin: { "alex-c-line": "dist/index.js" },
+	files: ["dist", "templates"],
+	scripts: {
+		"build": "tsdown",
+		"command": "bash -c 'pnpm run build && echo && echo \"Command output:\" && node dist/index.js $@' --",
+		"create-local-package": "pnpm run build && rm -f alex-c-line-*.tgz && pnpm pack",
+		"create-release-note": "bash -c 'git pull origin main && pnpm run command create-release-note-2 $@' --",
+		"format": "pnpm run format-prettier && pnpm run format-eslint",
+		"format-eslint": "eslint --fix --suppress-all \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\" && rm -f eslint-suppressions.json",
+		"format-prettier": "pnpm run format-prettier-typescript && pnpm run format-prettier-javascript && pnpm run format-prettier-yml",
+		"format-prettier-javascript": "prettier --write \"./**/*.js\"",
+		"format-prettier-typescript": "prettier --write --parser typescript \"./**/*.ts\"",
+		"format-prettier-yml": "prettier --write \"./**/*.{yml,yaml}\"",
+		"lint": "pnpm run lint-tsc && pnpm run lint-eslint && pnpm run lint-prettier",
+		"lint-eslint": "eslint \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\"",
+		"lint-prettier": "pnpm run lint-prettier-typescript && pnpm run lint-prettier-javascript && pnpm run lint-prettier-yml",
+		"lint-prettier-javascript": "prettier --check \"./**.js\"",
+		"lint-prettier-typescript": "prettier --check --parser typescript \"./**/*.ts\"",
+		"lint-prettier-yml": "prettier --check \"./**/*.{yml,yaml}\"",
+		"lint-tsc": "tsc --noEmit",
+		"pre-commit": "pnpm run command pre-commit-2",
+		"prepare": "husky",
+		"prepare-live-eslint-plugin": "pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev @alextheman/eslint-plugin",
+		"prepare-live-utility": "pnpm uninstall @alextheman/utility && pnpm install @alextheman/utility",
+		"prepare-local-eslint-plugin": "dotenv -e .env -- sh -c 'ESLINT_PLUGIN_PATH=${LOCAL_ESLINT_PLUGIN_PATH:-../eslint-plugin}; pnpm --prefix \"$ESLINT_PLUGIN_PATH\" run build && pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev file:\"$ESLINT_PLUGIN_PATH\"'",
+		"prepare-local-utility": "dotenv -e .env -- sh -c 'UTILITY_PATH=${LOCAL_UTILITY_PATH:-../utility}; pnpm --prefix \"$UTILITY_PATH\" run build && pnpm uninstall @alextheman/utility && pnpm install file:\"$UTILITY_PATH\"'",
+		"test": "vitest run",
+		"test-watch": "vitest",
+		"update-dependencies": "pnpm update --latest && pnpm update",
+		"use-live-eslint-plugin": "pnpm run prepare-live-eslint-plugin && pnpm run lint",
+		"use-live-utility": "pnpm run prepare-live-utility",
+		"use-local-eslint-plugin": "pnpm run prepare-local-eslint-plugin && pnpm run lint",
+		"use-local-utility": "pnpm run prepare-local-utility"
+	},
+	dependencies: {
+		"@alextheman/utility": "^4.16.2",
+		"@inquirer/prompts": "^8.2.0",
+		"boxen": "^8.0.1",
+		"canvas": "^3.2.1",
+		"chalk": "^5.6.2",
+		"commander": "^14.0.3",
+		"dotenv": "^17.3.1",
+		"dotenv-stringify": "^3.0.1",
+		"execa": "^9.6.1",
+		"figlet": "^1.10.0",
+		"gray-matter": "^4.0.3",
+		"libsodium-wrappers": "^0.8.2",
+		"supports-color": "^10.2.2",
+		"update-notifier": "^7.3.1",
+		"zod": "^4.3.6"
+	},
+	devDependencies: {
+		"@alextheman/eslint-plugin": "^5.7.0",
+		"@commander-js/extra-typings": "^14.0.0",
+		"@types/eslint": "^9.6.1",
+		"@types/node": "^25.2.3",
+		"@types/update-notifier": "^6.0.8",
+		"dotenv-cli": "^11.0.0",
+		"eslint": "^10.0.0",
+		"husky": "^9.1.7",
+		"prettier": "^3.8.1",
+		"tempy": "^3.2.0",
+		"ts-node": "^10.9.2",
+		"tsdown": "^0.20.3",
+		"typescript": "^5.9.3",
+		"vite-tsconfig-paths": "^6.1.1",
+		"vitest": "^4.0.18"
+	},
+	packageManager: "pnpm@10.29.3+sha512.498e1fb4cca5aa06c1dcf2611e6fafc50972ffe7189998c409e90de74566444298ffe43e6cd2acdc775ba1aa7cc5e092a8b7054c811ba8c5770f84693d33d2dc",
+	engines: { "node": ">=22.0.0" },
+	pnpm: { "onlyBuiltDependencies": [
+		"canvas",
+		"core-js",
+		"esbuild",
+		"fsevents",
+		"unrs-resolver"
+	] }
+};
+
+//#endregion
+//#region src/commands/update/checkUpdate.ts
+async function checkUpdate(program) {
+	const currentVersion = new _alextheman_utility.VersionNumber(version);
+	const { stdout: npmViewResult } = await execa.execa`npm view alex-c-line version`;
+	const latestVersion = new _alextheman_utility.VersionNumber(npmViewResult.trim());
+	if (!_alextheman_utility.VersionNumber.isEqual(currentVersion, latestVersion)) {
+		const message = _alextheman_utility.normaliseIndents`
+              A new update of \`alex-c-line\` is available!
+              ${currentVersion.toString()} → ${latestVersion.toString()}
+              Run \`npm install -g alex-c-line@latest\` to update.
+          `;
+		const width = Math.max(...message.split("\n").map((line) => {
+			return line.length;
+		}));
+		const messageWithArtwork = await createAlexCLineArtwork({
+			includeColors: Boolean(supports_color.default.stdout),
+			subtitleColor: chalk.default.white,
+			subtitleText: message.split("\n").map((line) => {
+				return centerLine(line, width);
+			}).join("\n")
+		});
+		if (program) program.error(messageWithArtwork, {
+			exitCode: 2,
+			code: "OUTDATED_VERSION"
+		});
+		else console.info(messageWithArtwork);
+	} else console.info(`alex-c-line is up to date (${currentVersion}).`);
+}
+
+//#endregion
+//#region src/utility/errors/convertDataErrorToProgramError.ts
+function convertDataErrorToProgramError(dataError, programError, options) {
+	programError(dataError.message, {
+		exitCode: options?.exitCode ?? 1,
+		code: dataError.code
+	});
+}
+
+//#endregion
+//#region src/utility/miscellaneous/parseZodSchemaForProgram.ts
+function parseZodSchemaForProgram(programError, schema, data) {
+	try {
+		return (0, _alextheman_utility.parseZodSchema)(schema, data);
+	} catch (error) {
+		if (_alextheman_utility.DataError.check(error)) convertDataErrorToProgramError(error, programError);
+		throw error;
+	}
+}
+
+//#endregion
+//#region src/commands/update/index.ts
+const optionsSchema = zod.default.object({ check: zod.default.boolean().optional() });
+function update(program) {
+	program.command("update").description("Handle updates of the currently installed alex-c-line").option("--check", "Check for available updates").action(async (rawOptions) => {
+		if (parseZodSchemaForProgram(program.error, optionsSchema, rawOptions).check) await checkUpdate(program);
+		else console.info("Unsupported option. Expected `--check`.");
+	});
+}
+
+//#endregion
+//#region src/cache/project/createAlexCLineProjectCache.ts
+async function createAlexCLineProjectCache(cacheContents) {
 	const cacheFilePath = node_path.default.join(process.cwd(), ".alex-c-line", "cache.json");
 	await (0, node_fs_promises.mkdir)(node_path.default.dirname(cacheFilePath), { recursive: true });
 	await (0, node_fs_promises.writeFile)(cacheFilePath, JSON.stringify(cacheContents, void 0, 2));
 }
 
 //#endregion
-//#region src/utility/cache/parseAlexCLineCache.ts
-const alexCLineCacheSchema = zod.default.object({ useLocalPackage: zod.default.object({ dependencies: zod.default.record(zod.default.string(), zod.default.object({
+//#region src/cache/project/types/AlexCLineProjectCache.ts
+const alexCLineProjectCacheSchema = zod.default.object({ useLocalPackage: zod.default.object({ dependencies: zod.default.record(zod.default.string(), zod.default.object({
 	currentVersion: zod.default.string(),
 	previousVersion: zod.default.union([zod.default.instanceof(_alextheman_utility.VersionNumber), zod.default.string()]).transform((value) => {
 		return value instanceof _alextheman_utility.VersionNumber ? value.toString({ omitPrefix: true }) : value;
 	}),
 	dependencyGroup: zod.default.enum(DependencyGroup)
 })) }).partial() }).partial();
-function parseAlexCLineCache(data) {
-	return (0, _alextheman_utility.parseZodSchema)(alexCLineCacheSchema, data);
+
+//#endregion
+//#region src/cache/project/parseAlexCLineCache.ts
+function parseAlexCLineProjectCache(data) {
+	return (0, _alextheman_utility.parseZodSchema)(alexCLineProjectCacheSchema, data);
 }
 
 //#endregion
-//#region src/utility/cache/loadAlexCLineCache.ts
-async function loadAlexCLineCache(cachePath = node_path.default.join(".alex-c-line", "cache.json")) {
+//#region src/cache/project/loadAlexCLineProjectCache.ts
+async function loadAlexCLineProjectCache(cachePath = node_path.default.join(".alex-c-line", "cache.json")) {
 	const fullCachePath = node_path.default.join(process.cwd(), cachePath);
 	try {
-		return parseAlexCLineCache(JSON.parse(await (0, node_fs_promises.readFile)(fullCachePath, "utf-8")));
+		return parseAlexCLineProjectCache(JSON.parse(await (0, node_fs_promises.readFile)(fullCachePath, "utf-8")));
 	} catch (error) {
 		if (error instanceof Error && "code" in error && error.code === "ENOENT") return null;
 		throw error;
@@ -1417,7 +1592,7 @@ function useLocalPackage(program) {
 				code: "LOCAL_ALEX_C_LINE_ERROR"
 			});
 		} else {
-			const cacheContents = await loadAlexCLineCache();
+			const cacheContents = await loadAlexCLineProjectCache();
 			if (!reverse) {
 				if (prepareScript) await (0, execa.execa)({ cwd: localPackagePath })`${packageManager} run ${prepareScript}`;
 				if (!keepOldTarballs) await removeAllTarballs(localPackagePath, packageName);
@@ -1446,7 +1621,7 @@ function useLocalPackage(program) {
 					dependencyGroup,
 					currentVersion: getDependenciesFromGroup(await getPackageJsonContents(process.cwd()) ?? {}, dependencyGroup)[packageName]
 				};
-				await createAlexCLineCache({
+				await createAlexCLineProjectCache({
 					...cacheContents ?? {},
 					useLocalPackage: {
 						...cacheContents?.useLocalPackage,
@@ -1456,7 +1631,7 @@ function useLocalPackage(program) {
 						}
 					}
 				});
-			} else await createAlexCLineCache({
+			} else await createAlexCLineProjectCache({
 				...cacheContents ?? {},
 				useLocalPackage: {
 					...cacheContents?.useLocalPackage,
@@ -1546,6 +1721,7 @@ function createCommands(program) {
 		sayHello,
 		setReleaseStatus,
 		setReleaseStatus2,
+		update,
 		useLocalPackage
 	});
 }
@@ -1573,118 +1749,6 @@ function formatError(error) {
 	throw error;
 }
 
-//#endregion
-//#region package.json
-var name = "alex-c-line";
-var version = "1.26.2";
-var description = "Command-line tool with commands to streamline the developer workflow.";
-var package_default = {
-	name,
-	version,
-	description,
-	repository: {
-		"type": "git",
-		"url": "git+https://github.com/alextheman231/alex-c-line.git"
-	},
-	license: "MIT",
-	author: "alextheman",
-	type: "module",
-	exports: {
-		"./configs": {
-			"types": "./dist/configs/index.d.ts",
-			"require": "./dist/configs/index.cjs",
-			"import": "./dist/configs/index.js",
-			"default": "./dist/configs/index.js"
-		},
-		"./configs/internal": {
-			"types": "./dist/configs/internal/index.d.ts",
-			"require": "./dist/configs/internal/index.cjs",
-			"import": "./dist/configs/internal/index.js",
-			"default": "./dist/configs/internal/index.js"
-		}
-	},
-	main: "dist/index.js",
-	module: "dist/index.cjs",
-	types: "dist/index.d.ts",
-	bin: { "alex-c-line": "dist/index.js" },
-	files: ["dist", "templates"],
-	scripts: {
-		"build": "tsdown",
-		"command": "bash -c 'pnpm run build && echo && echo \"Command output:\" && node dist/index.js $@' --",
-		"create-local-package": "pnpm run build && rm -f alex-c-line-*.tgz && pnpm pack",
-		"create-release-note": "bash -c 'git pull origin main && pnpm run command create-release-note-2 $@' --",
-		"format": "pnpm run format-prettier && pnpm run format-eslint",
-		"format-eslint": "eslint --fix --suppress-all \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\" && rm -f eslint-suppressions.json",
-		"format-prettier": "pnpm run format-prettier-typescript && pnpm run format-prettier-javascript && pnpm run format-prettier-yml",
-		"format-prettier-javascript": "prettier --write \"./**/*.js\"",
-		"format-prettier-typescript": "prettier --write --parser typescript \"./**/*.ts\"",
-		"format-prettier-yml": "prettier --write \"./**/*.{yml,yaml}\"",
-		"lint": "pnpm run lint-tsc && pnpm run lint-eslint && pnpm run lint-prettier",
-		"lint-eslint": "eslint \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\"",
-		"lint-prettier": "pnpm run lint-prettier-typescript && pnpm run lint-prettier-javascript && pnpm run lint-prettier-yml",
-		"lint-prettier-javascript": "prettier --check \"./**.js\"",
-		"lint-prettier-typescript": "prettier --check --parser typescript \"./**/*.ts\"",
-		"lint-prettier-yml": "prettier --check \"./**/*.{yml,yaml}\"",
-		"lint-tsc": "tsc --noEmit",
-		"pre-commit": "pnpm run command pre-commit-2",
-		"prepare": "husky",
-		"prepare-live-eslint-plugin": "pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev @alextheman/eslint-plugin",
-		"prepare-live-utility": "pnpm uninstall @alextheman/utility && pnpm install @alextheman/utility",
-		"prepare-local-eslint-plugin": "dotenv -e .env -- sh -c 'ESLINT_PLUGIN_PATH=${LOCAL_ESLINT_PLUGIN_PATH:-../eslint-plugin}; pnpm --prefix \"$ESLINT_PLUGIN_PATH\" run build && pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev file:\"$ESLINT_PLUGIN_PATH\"'",
-		"prepare-local-utility": "dotenv -e .env -- sh -c 'UTILITY_PATH=${LOCAL_UTILITY_PATH:-../utility}; pnpm --prefix \"$UTILITY_PATH\" run build && pnpm uninstall @alextheman/utility && pnpm install file:\"$UTILITY_PATH\"'",
-		"test": "vitest run",
-		"test-watch": "vitest",
-		"update-dependencies": "pnpm update --latest && pnpm update",
-		"use-live-eslint-plugin": "pnpm run prepare-live-eslint-plugin && pnpm run lint",
-		"use-live-utility": "pnpm run prepare-live-utility",
-		"use-local-eslint-plugin": "pnpm run prepare-local-eslint-plugin && pnpm run lint",
-		"use-local-utility": "pnpm run prepare-local-utility"
-	},
-	dependencies: {
-		"@alextheman/utility": "^4.15.0",
-		"@inquirer/prompts": "^8.2.0",
-		"boxen": "^8.0.1",
-		"canvas": "^3.2.1",
-		"chalk": "^5.6.2",
-		"commander": "^14.0.3",
-		"dotenv": "^17.2.4",
-		"dotenv-stringify": "^3.0.1",
-		"execa": "^9.6.1",
-		"figlet": "^1.10.0",
-		"gray-matter": "^4.0.3",
-		"libsodium-wrappers": "^0.8.2",
-		"supports-color": "^10.2.2",
-		"update-notifier": "^7.3.1",
-		"zod": "^4.3.6"
-	},
-	devDependencies: {
-		"@alextheman/eslint-plugin": "^5.6.2",
-		"@commander-js/extra-typings": "^14.0.0",
-		"@types/eslint": "^9.6.1",
-		"@types/node": "^25.2.1",
-		"@types/update-notifier": "^6.0.8",
-		"dotenv-cli": "^11.0.0",
-		"eslint": "^10.0.0",
-		"husky": "^9.1.7",
-		"prettier": "^3.8.1",
-		"tempy": "^3.2.0",
-		"ts-node": "^10.9.2",
-		"tsdown": "^0.20.3",
-		"typescript": "^5.9.3",
-		"vite-tsconfig-paths": "^6.0.5",
-		"vitest": "^4.0.18"
-	},
-	packageManager: "pnpm@10.29.2+sha512.bef43fa759d91fd2da4b319a5a0d13ef7a45bb985a3d7342058470f9d2051a3ba8674e629672654686ef9443ad13a82da2beb9eeb3e0221c87b8154fff9d74b8",
-	engines: { "node": ">=22.0.0" },
-	pnpm: { "onlyBuiltDependencies": [
-		"canvas",
-		"core-js",
-		"esbuild",
-		"fsevents",
-		"unrs-resolver"
-	] }
-};
-
 //#endregion
 //#region src/index.ts
 (async () => {

package/dist/index.js

@@ -60,12 +60,12 @@ function centerLine(text, width) {
 //#endregion
 //#region src/utility/miscellaneous/createAlexCLineArtwork.ts
 async function createAlexCLineArtwork(options) {
-	const { includeColors = true } = options ?? {};
+	const { includeColors = true, subtitleColor = chalk.green, subtitleText = "say my name and I'll assist ✓" } = options ?? {};
 	const title = await figlet("alex-c-line");
-	const subtitle = centerLine("say my name and I'll assist ✓", Math.max(...title.split("\n").map((line) => {
+	const subtitle = centerLine(subtitleText, Math.max(...title.split("\n").map((line) => {
 		return line.length;
 	})));
-	return boxen(includeColors ? [chalk.yellow(title), chalk.green(subtitle)].join("\n") : [title, subtitle].join("\n"), {
+	return boxen(includeColors ? [chalk.yellow(title), subtitleColor(subtitle)].join("\n") : [title, subtitle].join("\n"), {
 		padding: {
 			top: 1,
 			bottom: 1,
@@ -1212,32 +1212,207 @@ function setReleaseStatus2(program) {
 }
 
 //#endregion
-//#region src/utility/cache/createAlexCLineCache.ts
-async function createAlexCLineCache(cacheContents) {
+//#region package.json
+var name = "alex-c-line";
+var version = "1.27.1";
+var description = "Command-line tool with commands to streamline the developer workflow.";
+var package_default = {
+	name,
+	version,
+	description,
+	repository: {
+		"type": "git",
+		"url": "git+https://github.com/alextheman231/alex-c-line.git"
+	},
+	license: "MIT",
+	author: "alextheman",
+	type: "module",
+	exports: {
+		"./configs": {
+			"types": "./dist/configs/index.d.ts",
+			"require": "./dist/configs/index.cjs",
+			"import": "./dist/configs/index.js",
+			"default": "./dist/configs/index.js"
+		},
+		"./configs/internal": {
+			"types": "./dist/configs/internal/index.d.ts",
+			"require": "./dist/configs/internal/index.cjs",
+			"import": "./dist/configs/internal/index.js",
+			"default": "./dist/configs/internal/index.js"
+		}
+	},
+	main: "dist/index.js",
+	module: "dist/index.cjs",
+	types: "dist/index.d.ts",
+	bin: { "alex-c-line": "dist/index.js" },
+	files: ["dist", "templates"],
+	scripts: {
+		"build": "tsdown",
+		"command": "bash -c 'pnpm run build && echo && echo \"Command output:\" && node dist/index.js $@' --",
+		"create-local-package": "pnpm run build && rm -f alex-c-line-*.tgz && pnpm pack",
+		"create-release-note": "bash -c 'git pull origin main && pnpm run command create-release-note-2 $@' --",
+		"format": "pnpm run format-prettier && pnpm run format-eslint",
+		"format-eslint": "eslint --fix --suppress-all \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\" && rm -f eslint-suppressions.json",
+		"format-prettier": "pnpm run format-prettier-typescript && pnpm run format-prettier-javascript && pnpm run format-prettier-yml",
+		"format-prettier-javascript": "prettier --write \"./**/*.js\"",
+		"format-prettier-typescript": "prettier --write --parser typescript \"./**/*.ts\"",
+		"format-prettier-yml": "prettier --write \"./**/*.{yml,yaml}\"",
+		"lint": "pnpm run lint-tsc && pnpm run lint-eslint && pnpm run lint-prettier",
+		"lint-eslint": "eslint \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\"",
+		"lint-prettier": "pnpm run lint-prettier-typescript && pnpm run lint-prettier-javascript && pnpm run lint-prettier-yml",
+		"lint-prettier-javascript": "prettier --check \"./**.js\"",
+		"lint-prettier-typescript": "prettier --check --parser typescript \"./**/*.ts\"",
+		"lint-prettier-yml": "prettier --check \"./**/*.{yml,yaml}\"",
+		"lint-tsc": "tsc --noEmit",
+		"pre-commit": "pnpm run command pre-commit-2",
+		"prepare": "husky",
+		"prepare-live-eslint-plugin": "pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev @alextheman/eslint-plugin",
+		"prepare-live-utility": "pnpm uninstall @alextheman/utility && pnpm install @alextheman/utility",
+		"prepare-local-eslint-plugin": "dotenv -e .env -- sh -c 'ESLINT_PLUGIN_PATH=${LOCAL_ESLINT_PLUGIN_PATH:-../eslint-plugin}; pnpm --prefix \"$ESLINT_PLUGIN_PATH\" run build && pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev file:\"$ESLINT_PLUGIN_PATH\"'",
+		"prepare-local-utility": "dotenv -e .env -- sh -c 'UTILITY_PATH=${LOCAL_UTILITY_PATH:-../utility}; pnpm --prefix \"$UTILITY_PATH\" run build && pnpm uninstall @alextheman/utility && pnpm install file:\"$UTILITY_PATH\"'",
+		"test": "vitest run",
+		"test-watch": "vitest",
+		"update-dependencies": "pnpm update --latest && pnpm update",
+		"use-live-eslint-plugin": "pnpm run prepare-live-eslint-plugin && pnpm run lint",
+		"use-live-utility": "pnpm run prepare-live-utility",
+		"use-local-eslint-plugin": "pnpm run prepare-local-eslint-plugin && pnpm run lint",
+		"use-local-utility": "pnpm run prepare-local-utility"
+	},
+	dependencies: {
+		"@alextheman/utility": "^4.16.2",
+		"@inquirer/prompts": "^8.2.0",
+		"boxen": "^8.0.1",
+		"canvas": "^3.2.1",
+		"chalk": "^5.6.2",
+		"commander": "^14.0.3",
+		"dotenv": "^17.3.1",
+		"dotenv-stringify": "^3.0.1",
+		"execa": "^9.6.1",
+		"figlet": "^1.10.0",
+		"gray-matter": "^4.0.3",
+		"libsodium-wrappers": "^0.8.2",
+		"supports-color": "^10.2.2",
+		"update-notifier": "^7.3.1",
+		"zod": "^4.3.6"
+	},
+	devDependencies: {
+		"@alextheman/eslint-plugin": "^5.7.0",
+		"@commander-js/extra-typings": "^14.0.0",
+		"@types/eslint": "^9.6.1",
+		"@types/node": "^25.2.3",
+		"@types/update-notifier": "^6.0.8",
+		"dotenv-cli": "^11.0.0",
+		"eslint": "^10.0.0",
+		"husky": "^9.1.7",
+		"prettier": "^3.8.1",
+		"tempy": "^3.2.0",
+		"ts-node": "^10.9.2",
+		"tsdown": "^0.20.3",
+		"typescript": "^5.9.3",
+		"vite-tsconfig-paths": "^6.1.1",
+		"vitest": "^4.0.18"
+	},
+	packageManager: "pnpm@10.29.3+sha512.498e1fb4cca5aa06c1dcf2611e6fafc50972ffe7189998c409e90de74566444298ffe43e6cd2acdc775ba1aa7cc5e092a8b7054c811ba8c5770f84693d33d2dc",
+	engines: { "node": ">=22.0.0" },
+	pnpm: { "onlyBuiltDependencies": [
+		"canvas",
+		"core-js",
+		"esbuild",
+		"fsevents",
+		"unrs-resolver"
+	] }
+};
+
+//#endregion
+//#region src/commands/update/checkUpdate.ts
+async function checkUpdate(program) {
+	const currentVersion = new VersionNumber(version);
+	const { stdout: npmViewResult } = await execa`npm view alex-c-line version`;
+	const latestVersion = new VersionNumber(npmViewResult.trim());
+	if (!VersionNumber.isEqual(currentVersion, latestVersion)) {
+		const message = normaliseIndents`
+              A new update of \`alex-c-line\` is available!
+              ${currentVersion.toString()} → ${latestVersion.toString()}
+              Run \`npm install -g alex-c-line@latest\` to update.
+          `;
+		const width = Math.max(...message.split("\n").map((line) => {
+			return line.length;
+		}));
+		const messageWithArtwork = await createAlexCLineArtwork({
+			includeColors: Boolean(supportsColor.stdout),
+			subtitleColor: chalk.white,
+			subtitleText: message.split("\n").map((line) => {
+				return centerLine(line, width);
+			}).join("\n")
+		});
+		if (program) program.error(messageWithArtwork, {
+			exitCode: 2,
+			code: "OUTDATED_VERSION"
+		});
+		else console.info(messageWithArtwork);
+	} else console.info(`alex-c-line is up to date (${currentVersion}).`);
+}
+
+//#endregion
+//#region src/utility/errors/convertDataErrorToProgramError.ts
+function convertDataErrorToProgramError(dataError, programError, options) {
+	programError(dataError.message, {
+		exitCode: options?.exitCode ?? 1,
+		code: dataError.code
+	});
+}
+
+//#endregion
+//#region src/utility/miscellaneous/parseZodSchemaForProgram.ts
+function parseZodSchemaForProgram(programError, schema, data) {
+	try {
+		return parseZodSchema(schema, data);
+	} catch (error) {
+		if (DataError.check(error)) convertDataErrorToProgramError(error, programError);
+		throw error;
+	}
+}
+
+//#endregion
+//#region src/commands/update/index.ts
+const optionsSchema = z.object({ check: z.boolean().optional() });
+function update(program) {
+	program.command("update").description("Handle updates of the currently installed alex-c-line").option("--check", "Check for available updates").action(async (rawOptions) => {
+		if (parseZodSchemaForProgram(program.error, optionsSchema, rawOptions).check) await checkUpdate(program);
+		else console.info("Unsupported option. Expected `--check`.");
+	});
+}
+
+//#endregion
+//#region src/cache/project/createAlexCLineProjectCache.ts
+async function createAlexCLineProjectCache(cacheContents) {
 	const cacheFilePath = path.join(process.cwd(), ".alex-c-line", "cache.json");
 	await mkdir(path.dirname(cacheFilePath), { recursive: true });
 	await writeFile(cacheFilePath, JSON.stringify(cacheContents, void 0, 2));
 }
 
 //#endregion
-//#region src/utility/cache/parseAlexCLineCache.ts
-const alexCLineCacheSchema = z.object({ useLocalPackage: z.object({ dependencies: z.record(z.string(), z.object({
+//#region src/cache/project/types/AlexCLineProjectCache.ts
+const alexCLineProjectCacheSchema = z.object({ useLocalPackage: z.object({ dependencies: z.record(z.string(), z.object({
 	currentVersion: z.string(),
 	previousVersion: z.union([z.instanceof(VersionNumber), z.string()]).transform((value) => {
 		return value instanceof VersionNumber ? value.toString({ omitPrefix: true }) : value;
 	}),
 	dependencyGroup: z.enum(DependencyGroup)
 })) }).partial() }).partial();
-function parseAlexCLineCache(data) {
-	return parseZodSchema(alexCLineCacheSchema, data);
+
+//#endregion
+//#region src/cache/project/parseAlexCLineCache.ts
+function parseAlexCLineProjectCache(data) {
+	return parseZodSchema(alexCLineProjectCacheSchema, data);
 }
 
 //#endregion
-//#region src/utility/cache/loadAlexCLineCache.ts
-async function loadAlexCLineCache(cachePath = path.join(".alex-c-line", "cache.json")) {
+//#region src/cache/project/loadAlexCLineProjectCache.ts
+async function loadAlexCLineProjectCache(cachePath = path.join(".alex-c-line", "cache.json")) {
 	const fullCachePath = path.join(process.cwd(), cachePath);
 	try {
-		return parseAlexCLineCache(JSON.parse(await readFile(fullCachePath, "utf-8")));
+		return parseAlexCLineProjectCache(JSON.parse(await readFile(fullCachePath, "utf-8")));
 	} catch (error) {
 		if (error instanceof Error && "code" in error && error.code === "ENOENT") return null;
 		throw error;
@@ -1379,7 +1554,7 @@ function useLocalPackage(program) {
 				code: "LOCAL_ALEX_C_LINE_ERROR"
 			});
 		} else {
-			const cacheContents = await loadAlexCLineCache();
+			const cacheContents = await loadAlexCLineProjectCache();
 			if (!reverse) {
 				if (prepareScript) await execa({ cwd: localPackagePath })`${packageManager} run ${prepareScript}`;
 				if (!keepOldTarballs) await removeAllTarballs(localPackagePath, packageName);
@@ -1408,7 +1583,7 @@ function useLocalPackage(program) {
 					dependencyGroup,
 					currentVersion: getDependenciesFromGroup(await getPackageJsonContents(process.cwd()) ?? {}, dependencyGroup)[packageName]
 				};
-				await createAlexCLineCache({
+				await createAlexCLineProjectCache({
 					...cacheContents ?? {},
 					useLocalPackage: {
 						...cacheContents?.useLocalPackage,
@@ -1418,7 +1593,7 @@ function useLocalPackage(program) {
 						}
 					}
 				});
-			} else await createAlexCLineCache({
+			} else await createAlexCLineProjectCache({
 				...cacheContents ?? {},
 				useLocalPackage: {
 					...cacheContents?.useLocalPackage,
@@ -1508,6 +1683,7 @@ function createCommands(program) {
 		sayHello,
 		setReleaseStatus,
 		setReleaseStatus2,
+		update,
 		useLocalPackage
 	});
 }
@@ -1535,118 +1711,6 @@ function formatError(error) {
 	throw error;
 }
 
-//#endregion
-//#region package.json
-var name = "alex-c-line";
-var version = "1.26.2";
-var description = "Command-line tool with commands to streamline the developer workflow.";
-var package_default = {
-	name,
-	version,
-	description,
-	repository: {
-		"type": "git",
-		"url": "git+https://github.com/alextheman231/alex-c-line.git"
-	},
-	license: "MIT",
-	author: "alextheman",
-	type: "module",
-	exports: {
-		"./configs": {
-			"types": "./dist/configs/index.d.ts",
-			"require": "./dist/configs/index.cjs",
-			"import": "./dist/configs/index.js",
-			"default": "./dist/configs/index.js"
-		},
-		"./configs/internal": {
-			"types": "./dist/configs/internal/index.d.ts",
-			"require": "./dist/configs/internal/index.cjs",
-			"import": "./dist/configs/internal/index.js",
-			"default": "./dist/configs/internal/index.js"
-		}
-	},
-	main: "dist/index.js",
-	module: "dist/index.cjs",
-	types: "dist/index.d.ts",
-	bin: { "alex-c-line": "dist/index.js" },
-	files: ["dist", "templates"],
-	scripts: {
-		"build": "tsdown",
-		"command": "bash -c 'pnpm run build && echo && echo \"Command output:\" && node dist/index.js $@' --",
-		"create-local-package": "pnpm run build && rm -f alex-c-line-*.tgz && pnpm pack",
-		"create-release-note": "bash -c 'git pull origin main && pnpm run command create-release-note-2 $@' --",
-		"format": "pnpm run format-prettier && pnpm run format-eslint",
-		"format-eslint": "eslint --fix --suppress-all \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\" && rm -f eslint-suppressions.json",
-		"format-prettier": "pnpm run format-prettier-typescript && pnpm run format-prettier-javascript && pnpm run format-prettier-yml",
-		"format-prettier-javascript": "prettier --write \"./**/*.js\"",
-		"format-prettier-typescript": "prettier --write --parser typescript \"./**/*.ts\"",
-		"format-prettier-yml": "prettier --write \"./**/*.{yml,yaml}\"",
-		"lint": "pnpm run lint-tsc && pnpm run lint-eslint && pnpm run lint-prettier",
-		"lint-eslint": "eslint \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\"",
-		"lint-prettier": "pnpm run lint-prettier-typescript && pnpm run lint-prettier-javascript && pnpm run lint-prettier-yml",
-		"lint-prettier-javascript": "prettier --check \"./**.js\"",
-		"lint-prettier-typescript": "prettier --check --parser typescript \"./**/*.ts\"",
-		"lint-prettier-yml": "prettier --check \"./**/*.{yml,yaml}\"",
-		"lint-tsc": "tsc --noEmit",
-		"pre-commit": "pnpm run command pre-commit-2",
-		"prepare": "husky",
-		"prepare-live-eslint-plugin": "pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev @alextheman/eslint-plugin",
-		"prepare-live-utility": "pnpm uninstall @alextheman/utility && pnpm install @alextheman/utility",
-		"prepare-local-eslint-plugin": "dotenv -e .env -- sh -c 'ESLINT_PLUGIN_PATH=${LOCAL_ESLINT_PLUGIN_PATH:-../eslint-plugin}; pnpm --prefix \"$ESLINT_PLUGIN_PATH\" run build && pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev file:\"$ESLINT_PLUGIN_PATH\"'",
-		"prepare-local-utility": "dotenv -e .env -- sh -c 'UTILITY_PATH=${LOCAL_UTILITY_PATH:-../utility}; pnpm --prefix \"$UTILITY_PATH\" run build && pnpm uninstall @alextheman/utility && pnpm install file:\"$UTILITY_PATH\"'",
-		"test": "vitest run",
-		"test-watch": "vitest",
-		"update-dependencies": "pnpm update --latest && pnpm update",
-		"use-live-eslint-plugin": "pnpm run prepare-live-eslint-plugin && pnpm run lint",
-		"use-live-utility": "pnpm run prepare-live-utility",
-		"use-local-eslint-plugin": "pnpm run prepare-local-eslint-plugin && pnpm run lint",
-		"use-local-utility": "pnpm run prepare-local-utility"
-	},
-	dependencies: {
-		"@alextheman/utility": "^4.15.0",
-		"@inquirer/prompts": "^8.2.0",
-		"boxen": "^8.0.1",
-		"canvas": "^3.2.1",
-		"chalk": "^5.6.2",
-		"commander": "^14.0.3",
-		"dotenv": "^17.2.4",
-		"dotenv-stringify": "^3.0.1",
-		"execa": "^9.6.1",
-		"figlet": "^1.10.0",
-		"gray-matter": "^4.0.3",
-		"libsodium-wrappers": "^0.8.2",
-		"supports-color": "^10.2.2",
-		"update-notifier": "^7.3.1",
-		"zod": "^4.3.6"
-	},
-	devDependencies: {
-		"@alextheman/eslint-plugin": "^5.6.2",
-		"@commander-js/extra-typings": "^14.0.0",
-		"@types/eslint": "^9.6.1",
-		"@types/node": "^25.2.1",
-		"@types/update-notifier": "^6.0.8",
-		"dotenv-cli": "^11.0.0",
-		"eslint": "^10.0.0",
-		"husky": "^9.1.7",
-		"prettier": "^3.8.1",
-		"tempy": "^3.2.0",
-		"ts-node": "^10.9.2",
-		"tsdown": "^0.20.3",
-		"typescript": "^5.9.3",
-		"vite-tsconfig-paths": "^6.0.5",
-		"vitest": "^4.0.18"
-	},
-	packageManager: "pnpm@10.29.2+sha512.bef43fa759d91fd2da4b319a5a0d13ef7a45bb985a3d7342058470f9d2051a3ba8674e629672654686ef9443ad13a82da2beb9eeb3e0221c87b8154fff9d74b8",
-	engines: { "node": ">=22.0.0" },
-	pnpm: { "onlyBuiltDependencies": [
-		"canvas",
-		"core-js",
-		"esbuild",
-		"fsevents",
-		"unrs-resolver"
-	] }
-};
-
 //#endregion
 //#region src/index.ts
 (async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alex-c-line",
-  "version": "1.26.2",
+  "version": "1.27.1",
   "description": "Command-line tool with commands to streamline the developer workflow.",
   "repository": {
     "type": "git",
@@ -34,13 +34,13 @@
     "templates"
   ],
   "dependencies": {
-    "@alextheman/utility": "^4.15.0",
+    "@alextheman/utility": "^4.16.2",
     "@inquirer/prompts": "^8.2.0",
     "boxen": "^8.0.1",
     "canvas": "^3.2.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "dotenv": "^17.2.4",
+    "dotenv": "^17.3.1",
     "dotenv-stringify": "^3.0.1",
     "execa": "^9.6.1",
     "figlet": "^1.10.0",
@@ -51,10 +51,10 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^5.6.2",
+    "@alextheman/eslint-plugin": "^5.7.0",
     "@commander-js/extra-typings": "^14.0.0",
     "@types/eslint": "^9.6.1",
-    "@types/node": "^25.2.1",
+    "@types/node": "^25.2.3",
     "@types/update-notifier": "^6.0.8",
     "dotenv-cli": "^11.0.0",
     "eslint": "^10.0.0",
@@ -64,7 +64,7 @@
     "ts-node": "^10.9.2",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^6.0.5",
+    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.0.18"
   },
   "engines": {