alex-c-line 1.32.0 → 1.33.1

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

@@ -65,12 +65,14 @@ declare let scripts: {
   format: string;
   "format-eslint": string;
   "format-prettier": string;
+  "format-prettier-html": string;
   "format-prettier-javascript": string;
   "format-prettier-typescript": string;
   "format-prettier-yml": string;
   lint: string;
   "lint-eslint": string;
   "lint-prettier": string;
+  "lint-prettier-html": string;
   "lint-prettier-javascript": string;
   "lint-prettier-typescript": string;
   "lint-prettier-yml": string;

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

@@ -65,12 +65,14 @@ declare let scripts: {
   format: string;
   "format-eslint": string;
   "format-prettier": string;
+  "format-prettier-html": string;
   "format-prettier-javascript": string;
   "format-prettier-typescript": string;
   "format-prettier-yml": string;
   lint: string;
   "lint-eslint": string;
   "lint-prettier": string;
+  "lint-prettier-html": string;
   "lint-prettier-javascript": string;
   "lint-prettier-typescript": string;
   "lint-prettier-yml": string;

package/dist/index.cjs

@@ -50,9 +50,9 @@ zod = __toESM(zod);
 let _inquirer_prompts = require("@inquirer/prompts");
 let node_os = require("node:os");
 node_os = __toESM(node_os);
+let node_url = require("node:url");
 let _alextheman_utility_internal = require("@alextheman/utility/internal");
 let node_module = require("node:module");
-let node_url = require("node:url");
 let gray_matter = require("gray-matter");
 gray_matter = __toESM(gray_matter);
 let _alextheman_utility_node = require("@alextheman/utility/node");
@@ -628,35 +628,35 @@ async function parseDotenvFile(envFilePath) {
 //#endregion
 //#region src/cli/commands/edit-env-file/index.ts
 function editEnvFile(program) {
-	program.command("edit-env-file").description("Edit properties in a .env file").option("--interactive", "Enable interactive mode", true).option("--file <filePath>", "The path to the .env file you want to edit, relative to the working directory this command is run", ".env").action(async ({ interactive, file }) => {
+	program.command("edit-env-file").description("Edit properties in a .env file").option("--interactive", "Enable interactive mode", true).option("--file <filePath>", "The path to the .env file you want to edit, relative to the working directory this command is run", ".env").action(async ({ file, interactive }) => {
 		if (interactive) {
 			let exitInteractiveMode = false;
 			while (!exitInteractiveMode) {
 				const envFileContents = await parseDotenvFile(file);
 				const variableToEdit = await (0, _inquirer_prompts.select)({
-					message: _alextheman_utility.normaliseIndents`
-            Please select the environment variable you wish to edit
-            Currently editing file: ${file}
-            `,
 					choices: [
 						...Object.keys(envFileContents).map((key) => {
 							return {
+								description: envFileContents[key] === "" ? "<empty>" : "<redacted for safety>",
 								name: key,
-								value: key,
-								description: envFileContents[key] === "" ? "<empty>" : "<redacted for safety>"
+								value: key
 							};
 						}),
 						{
+							description: `Add a new environment variable to .env.`,
 							name: `${chalk.default.green("+")} Add new environment variable`,
-							value: "Add new",
-							description: `Add a new environment variable to .env.`
+							value: "Add new"
 						},
 						{
+							description: "Exit the .env file interactive editor.",
 							name: `${chalk.default.dim("⏎")} Exit editor`,
-							value: "Exit editor",
-							description: "Exit the .env file interactive editor."
+							value: "Exit editor"
 						}
-					]
+					],
+					message: _alextheman_utility.normaliseIndents`
+            Please select the environment variable you wish to edit
+            Currently editing file: ${file}
+            `
 				});
 				switch (variableToEdit) {
 					case "Add new":
@@ -736,6 +736,58 @@ function gitPostMergeCleanup(program) {
 	});
 }
 
+//#endregion
+//#region src/utility/fileSystem/findPackageRoot.ts
+async function findPackageRoot(startDirectory, packageName) {
+	let directory = startDirectory;
+	while (true) {
+		const packagePath = node_path.default.join(directory, "package.json");
+		try {
+			if (JSON.parse(await (0, node_fs_promises.readFile)(packagePath, "utf-8"))?.name === packageName) return directory;
+		} catch {}
+		const parent = node_path.default.dirname(directory);
+		if (parent === directory) break;
+		directory = parent;
+	}
+	throw new _alextheman_utility.DataError({ packageName }, "PACKAGE_ROOT_NOT_FOUND", `Could not find package root for ${packageName}`);
+}
+
+//#endregion
+//#region src/utility/constants/alexCLinePackageRoot.ts
+const __filename$4 = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
+const alexCLinePackageRoot = findPackageRoot(node_path.default.dirname(__filename$4), "alex-c-line");
+
+//#endregion
+//#region src/cli/commands/internal/outdated-dependencies.ts
+function outdatedDependencies(program) {
+	program.command("outdated-dependencies").action(async () => {
+		const { exitCode, stdout, stderr } = await (0, execa.execa)({ reject: false })`pnpm outdated --json`;
+		if (![0, 1].includes(exitCode)) program.error(stderr ?? stdout, {
+			exitCode,
+			code: "PNPM_OUDATED_ERROR"
+		});
+		const outdatedDependencies = JSON.parse(stdout.trim());
+		const outdatedTemplatesPath = node_path.default.join(await alexCLinePackageRoot, "templates", "outdated");
+		const tableTemplate = await (0, node_fs_promises.readFile)(node_path.default.join(outdatedTemplatesPath, "table.html"), "utf-8");
+		const tableRowTemplate = await (0, node_fs_promises.readFile)(node_path.default.join(outdatedTemplatesPath, "tableRow.html"), "utf-8");
+		console.info(tableTemplate.replace("{{tableRows}}", Object.entries(outdatedDependencies).map(([packageName, metadata]) => {
+			return tableRowTemplate.replace("{{packageName}}", packageName).replace("{{currentVersion}}", metadata.current).replace("{{latestVersion}}", metadata.latest);
+		}).join("\n")));
+	});
+}
+
+//#endregion
+//#region src/utility/miscellaneous/loadCommands.ts
+function loadCommands(program, commandMap) {
+	for (const loader of Object.values(commandMap)) loader(program);
+}
+
+//#endregion
+//#region src/cli/commands/internal/index.ts
+function internal(program) {
+	loadCommands(program.command("internal").description("Commands meant more for internal use by me and is not recommended for production usage."), { outdatedDependencies });
+}
+
 //#endregion
 //#region src/cli/commands/pre-commit/createStepRunner.ts
 const runCommandAndLogToConsole = (0, execa.execa)({
@@ -954,22 +1006,6 @@ function parseAlexCLinePrivateConfig(data) {
 	return (0, _alextheman_utility.parseZodSchema)(alexCLinePrivateConfigSchema, data);
 }
 
-//#endregion
-//#region src/utility/fileSystem/findPackageRoot.ts
-async function findPackageRoot(startDirectory, packageName) {
-	let directory = startDirectory;
-	while (true) {
-		const packagePath = node_path.default.join(directory, "package.json");
-		try {
-			if (JSON.parse(await (0, node_fs_promises.readFile)(packagePath, "utf-8"))?.name === packageName) return directory;
-		} catch {}
-		const parent = node_path.default.dirname(directory);
-		if (parent === directory) break;
-		directory = parent;
-	}
-	throw new _alextheman_utility.DataError({ packageName }, "PACKAGE_ROOT_NOT_FOUND", `Could not find package root for ${packageName}`);
-}
-
 //#endregion
 //#region src/utility/markdownTemplates/pullRequest/getPullRequestTemplatesFromMarkdown.ts
 const __filename$3 = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
@@ -1317,7 +1353,7 @@ function parseZodSchemaForProgram(programError, schema, data) {
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version = "1.32.0";
+var version = "1.33.1";
 var description = "Command-line tool with commands to streamline the developer workflow.";
 
 //#endregion
@@ -1562,12 +1598,6 @@ function generateUUID(program) {
 	});
 }
 
-//#endregion
-//#region src/utility/miscellaneous/loadCommands.ts
-function loadCommands(program, commandMap) {
-	for (const loader of Object.values(commandMap)) loader(program);
-}
-
 //#endregion
 //#region src/cli/commands/uuid/index.ts
 function uuid(program) {
@@ -1686,7 +1716,9 @@ function createCommands(program) {
 		getVersionType,
 		gitPostMergeCleanup,
 		incrementVersion,
+		internal,
 		migrateReleaseNotes,
+		packageJson,
 		preCommit,
 		preCommit2,
 		sayHello,
@@ -1694,8 +1726,7 @@ function createCommands(program) {
 		setReleaseStatus2,
 		update,
 		useLocalPackage,
-		uuid,
-		packageJson
+		uuid
 	});
 }
 

package/dist/index.js

@@ -15,8 +15,8 @@ import dotenvStringify from "dotenv-stringify";
 import z from "zod";
 import { confirm, input, password, select } from "@inquirer/prompts";
 import os from "node:os";
-import { PackageManager, getDependenciesFromGroup, getExpectedTgzName, getPackageJsonContents, packageJsonNotFoundError } from "@alextheman/utility/internal";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { PackageManager, getDependenciesFromGroup, getExpectedTgzName, getPackageJsonContents, packageJsonNotFoundError } from "@alextheman/utility/internal";
 import matter from "gray-matter";
 import { parseFilePath } from "@alextheman/utility/node";
 import supportsColor from "supports-color";
@@ -590,35 +590,35 @@ async function parseDotenvFile(envFilePath) {
 //#endregion
 //#region src/cli/commands/edit-env-file/index.ts
 function editEnvFile(program) {
-	program.command("edit-env-file").description("Edit properties in a .env file").option("--interactive", "Enable interactive mode", true).option("--file <filePath>", "The path to the .env file you want to edit, relative to the working directory this command is run", ".env").action(async ({ interactive, file }) => {
+	program.command("edit-env-file").description("Edit properties in a .env file").option("--interactive", "Enable interactive mode", true).option("--file <filePath>", "The path to the .env file you want to edit, relative to the working directory this command is run", ".env").action(async ({ file, interactive }) => {
 		if (interactive) {
 			let exitInteractiveMode = false;
 			while (!exitInteractiveMode) {
 				const envFileContents = await parseDotenvFile(file);
 				const variableToEdit = await select({
-					message: normaliseIndents`
-            Please select the environment variable you wish to edit
-            Currently editing file: ${file}
-            `,
 					choices: [
 						...Object.keys(envFileContents).map((key) => {
 							return {
+								description: envFileContents[key] === "" ? "<empty>" : "<redacted for safety>",
 								name: key,
-								value: key,
-								description: envFileContents[key] === "" ? "<empty>" : "<redacted for safety>"
+								value: key
 							};
 						}),
 						{
+							description: `Add a new environment variable to .env.`,
 							name: `${chalk.green("+")} Add new environment variable`,
-							value: "Add new",
-							description: `Add a new environment variable to .env.`
+							value: "Add new"
 						},
 						{
+							description: "Exit the .env file interactive editor.",
 							name: `${chalk.dim("⏎")} Exit editor`,
-							value: "Exit editor",
-							description: "Exit the .env file interactive editor."
+							value: "Exit editor"
 						}
-					]
+					],
+					message: normaliseIndents`
+            Please select the environment variable you wish to edit
+            Currently editing file: ${file}
+            `
 				});
 				switch (variableToEdit) {
 					case "Add new":
@@ -698,6 +698,58 @@ function gitPostMergeCleanup(program) {
 	});
 }
 
+//#endregion
+//#region src/utility/fileSystem/findPackageRoot.ts
+async function findPackageRoot(startDirectory, packageName) {
+	let directory = startDirectory;
+	while (true) {
+		const packagePath = path.join(directory, "package.json");
+		try {
+			if (JSON.parse(await readFile(packagePath, "utf-8"))?.name === packageName) return directory;
+		} catch {}
+		const parent = path.dirname(directory);
+		if (parent === directory) break;
+		directory = parent;
+	}
+	throw new DataError({ packageName }, "PACKAGE_ROOT_NOT_FOUND", `Could not find package root for ${packageName}`);
+}
+
+//#endregion
+//#region src/utility/constants/alexCLinePackageRoot.ts
+const __filename$3 = fileURLToPath(import.meta.url);
+const alexCLinePackageRoot = findPackageRoot(path.dirname(__filename$3), "alex-c-line");
+
+//#endregion
+//#region src/cli/commands/internal/outdated-dependencies.ts
+function outdatedDependencies(program) {
+	program.command("outdated-dependencies").action(async () => {
+		const { exitCode, stdout, stderr } = await execa({ reject: false })`pnpm outdated --json`;
+		if (![0, 1].includes(exitCode)) program.error(stderr ?? stdout, {
+			exitCode,
+			code: "PNPM_OUDATED_ERROR"
+		});
+		const outdatedDependencies = JSON.parse(stdout.trim());
+		const outdatedTemplatesPath = path.join(await alexCLinePackageRoot, "templates", "outdated");
+		const tableTemplate = await readFile(path.join(outdatedTemplatesPath, "table.html"), "utf-8");
+		const tableRowTemplate = await readFile(path.join(outdatedTemplatesPath, "tableRow.html"), "utf-8");
+		console.info(tableTemplate.replace("{{tableRows}}", Object.entries(outdatedDependencies).map(([packageName, metadata]) => {
+			return tableRowTemplate.replace("{{packageName}}", packageName).replace("{{currentVersion}}", metadata.current).replace("{{latestVersion}}", metadata.latest);
+		}).join("\n")));
+	});
+}
+
+//#endregion
+//#region src/utility/miscellaneous/loadCommands.ts
+function loadCommands(program, commandMap) {
+	for (const loader of Object.values(commandMap)) loader(program);
+}
+
+//#endregion
+//#region src/cli/commands/internal/index.ts
+function internal(program) {
+	loadCommands(program.command("internal").description("Commands meant more for internal use by me and is not recommended for production usage."), { outdatedDependencies });
+}
+
 //#endregion
 //#region src/cli/commands/pre-commit/createStepRunner.ts
 const runCommandAndLogToConsole = execa({
@@ -916,22 +968,6 @@ function parseAlexCLinePrivateConfig(data) {
 	return parseZodSchema(alexCLinePrivateConfigSchema, data);
 }
 
-//#endregion
-//#region src/utility/fileSystem/findPackageRoot.ts
-async function findPackageRoot(startDirectory, packageName) {
-	let directory = startDirectory;
-	while (true) {
-		const packagePath = path.join(directory, "package.json");
-		try {
-			if (JSON.parse(await readFile(packagePath, "utf-8"))?.name === packageName) return directory;
-		} catch {}
-		const parent = path.dirname(directory);
-		if (parent === directory) break;
-		directory = parent;
-	}
-	throw new DataError({ packageName }, "PACKAGE_ROOT_NOT_FOUND", `Could not find package root for ${packageName}`);
-}
-
 //#endregion
 //#region src/utility/markdownTemplates/pullRequest/getPullRequestTemplatesFromMarkdown.ts
 const __filename$2 = fileURLToPath(import.meta.url);
@@ -1279,7 +1315,7 @@ function parseZodSchemaForProgram(programError, schema, data) {
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version = "1.32.0";
+var version = "1.33.1";
 var description = "Command-line tool with commands to streamline the developer workflow.";
 
 //#endregion
@@ -1524,12 +1560,6 @@ function generateUUID(program) {
 	});
 }
 
-//#endregion
-//#region src/utility/miscellaneous/loadCommands.ts
-function loadCommands(program, commandMap) {
-	for (const loader of Object.values(commandMap)) loader(program);
-}
-
 //#endregion
 //#region src/cli/commands/uuid/index.ts
 function uuid(program) {
@@ -1648,7 +1678,9 @@ function createCommands(program) {
 		getVersionType,
 		gitPostMergeCleanup,
 		incrementVersion,
+		internal,
 		migrateReleaseNotes,
+		packageJson,
 		preCommit,
 		preCommit2,
 		sayHello,
@@ -1656,8 +1688,7 @@ function createCommands(program) {
 		setReleaseStatus2,
 		update,
 		useLocalPackage,
-		uuid,
-		packageJson
+		uuid
 	});
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alex-c-line",
-  "version": "1.32.0",
+  "version": "1.33.1",
   "description": "Command-line tool with commands to streamline the developer workflow.",
   "repository": {
     "type": "git",
@@ -52,7 +52,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^5.9.0",
+    "@alextheman/eslint-plugin": "^5.9.1",
     "@commander-js/extra-typings": "^14.0.0",
     "@types/eslint": "^9.6.1",
     "@types/node": "^25.3.2",
@@ -81,13 +81,15 @@
     "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": "pnpm run format-prettier-typescript && pnpm run format-prettier-javascript && pnpm run format-prettier-yml && pnpm run format-prettier-html",
+    "format-prettier-html": "prettier --write \"**/*.html\"",
     "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": "pnpm run lint-prettier-typescript && pnpm run lint-prettier-javascript && pnpm run lint-prettier-yml && pnpm run lint-prettier-html",
+    "lint-prettier-html": "prettier --check \"**/*.html\"",
     "lint-prettier-javascript": "prettier --check \"./**.js\"",
     "lint-prettier-typescript": "prettier --check --parser typescript \"./**/*.ts\"",
     "lint-prettier-yml": "prettier --check \"./**/*.{yml,yaml}\"",

package/templates/outdated/table.html

@@ -0,0 +1,12 @@
+<table>
+  <thead>
+    <tr>
+      <th scope="col">Name</th>
+      <th scope="col">Current Version</th>
+      <th scope="col">Latest Version</th>
+    </tr>
+  </thead>
+  <tbody>
+    {{tableRows}}
+  </tbody>
+</table>

package/templates/outdated/tableRow.html

@@ -0,0 +1,5 @@
+<tr>
+  <th scope="row">{{packageName}}</th>
+  <td>{{currentVersion}}</td>
+  <td>{{latestVersion}}</td>
+</tr>