@kidd-cli/cli 0.1.3 → 0.2.0

package/dist/commands/add/command.mjs

@@ -1,10 +1,9 @@
-import { n as isKebabCase, r as renderTemplate, t as writeFiles } from "../../write-dfZMTbtn.mjs";
-import { t as detectProject } from "../../detect-t9mL3oTg.mjs";
+import { n as isKebabCase, r as renderTemplate, t as writeFiles } from "../../write-CdoqLFeH.mjs";
+import { t as detectProject } from "../../detect-DcO0_CWy.mjs";
 import { command } from "@kidd-cli/core";
 import { join } from "node:path";
 import { loadConfig } from "@kidd-cli/config/loader";
 import { z } from "zod";
-
 //#region src/commands/add/command.ts
 const addCommandCommand = command({
 	args: z.object({
@@ -117,6 +116,5 @@ function resolveCommandsDir(configResult, rootDir) {
 	if (configResult) return join(rootDir, configResult.config.commands ?? DEFAULT_COMMANDS);
 	return join(rootDir, DEFAULT_COMMANDS);
 }
-
 //#endregion
-export { addCommandCommand as default };
+export { addCommandCommand as default };

package/dist/commands/add/index.mjs

@@ -1,7 +1,5 @@
 import { command } from "@kidd-cli/core";
-
 //#region src/commands/add/index.ts
 const addCommand = command({ description: "Add a command or middleware to your project" });
-
 //#endregion
-export { addCommand as default };
+export { addCommand as default };

package/dist/commands/add/middleware.mjs

@@ -1,9 +1,8 @@
-import { n as isKebabCase, r as renderTemplate, t as writeFiles } from "../../write-dfZMTbtn.mjs";
-import { t as detectProject } from "../../detect-t9mL3oTg.mjs";
+import { n as isKebabCase, r as renderTemplate, t as writeFiles } from "../../write-CdoqLFeH.mjs";
+import { t as detectProject } from "../../detect-DcO0_CWy.mjs";
 import { command } from "@kidd-cli/core";
 import { join } from "node:path";
 import { z } from "zod";
-
 //#region src/commands/add/middleware.ts
 const addMiddlewareCommand = command({
 	args: z.object({
@@ -82,6 +81,5 @@ async function resolveDescription(ctx) {
 		placeholder: "What does this middleware do?"
 	});
 }
-
 //#endregion
-export { addMiddlewareCommand as default };
+export { addMiddlewareCommand as default };

package/dist/commands/build.mjs

@@ -1,10 +1,9 @@
-import { t as extractConfig } from "../config-helpers-QvhfBI9b.mjs";
+import { t as extractConfig } from "../config-helpers-wZhBJJXJ.mjs";
 import { command } from "@kidd-cli/core";
 import { relative } from "node:path";
 import { build, compile, resolveTargetLabel } from "@kidd-cli/bundler";
 import { loadConfig } from "@kidd-cli/config/loader";
 import { z } from "zod";
-
 //#region src/commands/build.ts
 /**
 * Build a kidd CLI project for production using tsdown.
@@ -42,7 +41,8 @@ const buildCommand = command({
 			ctx.logger.note(formatBuildNote({
 				cwd,
 				entryFile: buildOutput.entryFile,
-				outDir: buildOutput.outDir
+				outDir: buildOutput.outDir,
+				version: buildOutput.version
 			}), "Bundle");
 			return;
 		}
@@ -64,7 +64,8 @@ const buildCommand = command({
 		ctx.logger.note(formatBuildNote({
 			cwd,
 			entryFile: buildOutput.entryFile,
-			outDir: buildOutput.outDir
+			outDir: buildOutput.outDir,
+			version: buildOutput.version
 		}), "Bundle");
 		ctx.logger.note(formatBinariesNote({
 			binaries: compileOutput.binaries,
@@ -134,7 +135,22 @@ function resolveExistingCompile(value) {
 * @returns A formatted string with entry and output directory.
 */
 function formatBuildNote(params) {
-	return [`entry   ${relative(params.cwd, params.entryFile)}`, `output  ${relative(params.cwd, params.outDir)}`].join("\n");
+	return [
+		`entry    ${relative(params.cwd, params.entryFile)}`,
+		`output   ${relative(params.cwd, params.outDir)}`,
+		...formatVersionLine(params.version)
+	].join("\n");
+}
+/**
+* Format a version line for the build note, if a version is available.
+*
+* @private
+* @param version - The version string, or undefined.
+* @returns A single-element array with the formatted line, or an empty array.
+*/
+function formatVersionLine(version) {
+	if (!version) return [];
+	return [`version  ${version}`];
 }
 /**
 * Format compiled binaries into an aligned, multi-line string for display.
@@ -147,6 +163,5 @@ function formatBinariesNote(params) {
 	const maxLen = Math.max(...params.binaries.map((b) => b.label.length));
 	return params.binaries.map((binary) => `${binary.label.padEnd(maxLen)}  ${relative(params.cwd, binary.path)}`).join("\n");
 }
-
 //#endregion
-export { buildCommand as default };
+export { buildCommand as default };

package/dist/commands/commands.mjs

@@ -1,9 +1,8 @@
-import { t as extractConfig } from "../config-helpers-QvhfBI9b.mjs";
+import { t as extractConfig } from "../config-helpers-wZhBJJXJ.mjs";
 import { autoload, command } from "@kidd-cli/core";
 import { join } from "node:path";
 import { loadConfig } from "@kidd-cli/config/loader";
 import { existsSync } from "node:fs";
-
 //#region src/commands/commands.ts
 /**
 * Display the command tree for a kidd CLI project.
@@ -44,21 +43,79 @@ async function resolveSubcommands(commands) {
 /**
 * Recursively build a sorted tree of entries from a CommandMap.
 *
+* Commands listed in the order array appear first in the specified order;
+* omitted commands fall back to alphabetical sort.
+*
 * @private
 * @param commandMap - The map of command names to Command objects.
+* @param order - Optional array of command names defining display order.
 * @returns A sorted array of TreeEntry nodes.
 */
-async function buildTree(commandMap) {
-	const entries = Object.entries(commandMap).toSorted(([a], [b]) => a.localeCompare(b));
+async function buildTree(commandMap, order) {
+	const entries = sortEntries({
+		entries: Object.entries(commandMap),
+		order
+	});
 	return Promise.all(entries.map(async ([name, cmd]) => {
 		return {
-			children: await buildTree(await resolveSubcommands(cmd.commands)),
+			children: await buildTree(await resolveSubcommands(cmd.commands), cmd.order),
 			description: cmd.description ?? "",
 			name
 		};
 	}));
 }
 /**
+* Sort command entries with ordered names first (in specified order),
+* remaining names alphabetically.
+*
+* Validates the order array against available command names and logs a
+* warning for unknown or duplicate entries rather than failing silently.
+*
+* @private
+* @param params - The command entries and optional order array.
+* @returns Sorted array of entries.
+*/
+function sortEntries(params) {
+	const { entries, order } = params;
+	if (!order || order.length === 0) return entries.toSorted(([a], [b]) => a.localeCompare(b));
+	const validOrder = validateOrder({
+		commandNames: entries.map(([name]) => name),
+		order
+	});
+	const entryMap = new Map(entries);
+	const orderedSet = new Set(validOrder);
+	const ordered = validOrder.filter((name) => entryMap.has(name)).map((name) => [name, entryMap.get(name)]);
+	const remaining = entries.filter(([name]) => !orderedSet.has(name)).toSorted(([a], [b]) => a.localeCompare(b));
+	return [...ordered, ...remaining];
+}
+/**
+* Validate the order array by filtering out unknown and duplicate names.
+*
+* Logs warnings for invalid entries so developers see the mismatch
+* during `kidd commands` introspection, matching the runtime behaviour.
+*
+* @private
+* @param params - The order array and available command names.
+* @returns A deduplicated array of valid order names.
+*/
+function validateOrder(params) {
+	const { commandNames, order } = params;
+	const nameSet = new Set(commandNames);
+	const seen = /* @__PURE__ */ new Set();
+	return order.filter((name) => {
+		if (seen.has(name)) {
+			console.warn(`Warning: duplicate command name "${name}" in order array`);
+			return false;
+		}
+		seen.add(name);
+		if (!nameSet.has(name)) {
+			console.warn(`Warning: unknown command "${name}" in order array`);
+			return false;
+		}
+		return true;
+	});
+}
+/**
 * Render a tree of entries into an ASCII tree string.
 *
 * @private
@@ -118,6 +175,5 @@ function formatLabel(name, description) {
 	if (description) return `${name} — ${description}`;
 	return name;
 }
-
 //#endregion
-export { commandsCommand as default };
+export { commandsCommand as default };

package/dist/commands/dev.mjs

@@ -1,8 +1,7 @@
-import { t as extractConfig } from "../config-helpers-QvhfBI9b.mjs";
+import { t as extractConfig } from "../config-helpers-wZhBJJXJ.mjs";
 import { command } from "@kidd-cli/core";
 import { watch } from "@kidd-cli/bundler";
 import { loadConfig } from "@kidd-cli/config/loader";
-
 //#region src/commands/dev.ts
 /**
 * Start a kidd CLI project in development mode with file watching.
@@ -52,6 +51,5 @@ function createOnSuccess(ctx) {
 		ctx.logger.success("Rebuilt successfully");
 	};
 }
-
 //#endregion
-export { devCommand as default };
+export { devCommand as default };

package/dist/commands/doctor.mjs

@@ -3,12 +3,11 @@ import { dirname, join, relative } from "node:path";
 import { readManifest } from "@kidd-cli/utils/manifest";
 import { loadConfig } from "@kidd-cli/config/loader";
 import { z } from "zod";
+import { attemptAsync, err, match, ok } from "@kidd-cli/utils/fp";
 import pc from "picocolors";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { attemptAsync, err, ok } from "@kidd-cli/utils/fp";
 import { fileExists } from "@kidd-cli/utils/fs";
 import { jsonParse, jsonStringify } from "@kidd-cli/utils/json";
-
 //#region src/lib/checks.ts
 /**
 * Default entry point for the CLI source.
@@ -493,7 +492,6 @@ async function updatePackageJson(cwd, transform) {
 	if (writeError) return err(`Failed to write package.json: ${writeError.message}`);
 	return ok();
 }
-
 //#endregion
 //#region src/commands/doctor.ts
 /**
@@ -636,10 +634,7 @@ function formatResultLine(result, fixResults) {
 * @returns A colored string representation of the status.
 */
 function formatDisplayStatus(status) {
-	if (status === "pass") return pc.green("pass");
-	if (status === "warn") return pc.yellow("warn");
-	if (status === "fix") return pc.blue("fix ");
-	return pc.red("fail");
+	return match(status).with("pass", () => pc.green("pass")).with("warn", () => pc.yellow("warn")).with("fix", () => pc.blue("fix ")).with("fail", () => pc.red("fail")).exhaustive();
 }
 /**
 * Format the summary line with counts.
@@ -664,6 +659,5 @@ function pluralizeCheck(count) {
 	if (count === 1) return "check";
 	return "checks";
 }
-
 //#endregion
-export { doctorCommand as default };
+export { doctorCommand as default };

package/dist/commands/init.mjs

@@ -1,11 +1,28 @@
-import { n as isKebabCase, r as renderTemplate, t as writeFiles } from "../write-dfZMTbtn.mjs";
+import { n as isKebabCase, r as renderTemplate, t as writeFiles } from "../write-CdoqLFeH.mjs";
 import { createRequire } from "node:module";
 import { command } from "@kidd-cli/core";
 import { dirname, join } from "node:path";
 import { readManifest } from "@kidd-cli/utils/manifest";
 import { z } from "zod";
 import { attempt } from "@kidd-cli/utils/fp";
-
+//#region src/generated/template-versions.ts
+/**
+* Zod version from the workspace catalog.
+*/
+const ZOD_VERSION = "^4.3.6";
+/**
+* TypeScript version from the workspace catalog.
+*/
+const TYPESCRIPT_VERSION = "^5.9.3";
+/**
+* Vitest version from the workspace catalog.
+*/
+const VITEST_VERSION = "^4.0.18";
+/**
+* Tsdown version from the workspace catalog.
+*/
+const TSDOWN_VERSION = "^0.21.1";
+//#endregion
 //#region src/commands/init.ts
 const initCommand = command({
 	args: z.object({
@@ -34,7 +51,11 @@ const initCommand = command({
 				coreVersion,
 				description: projectDescription,
 				name: projectName,
-				packageManager
+				packageManager,
+				tsdownVersion: TSDOWN_VERSION,
+				typescriptVersion: TYPESCRIPT_VERSION,
+				vitestVersion: VITEST_VERSION,
+				zodVersion: ZOD_VERSION
 			}
 		});
 		if (renderError) {
@@ -190,6 +211,5 @@ async function resolveDependencyVersion(packageName) {
 	if (manifestError || !manifest.version) return DEFAULT_VERSION;
 	return manifest.version;
 }
-
 //#endregion
-export { initCommand as default };
+export { initCommand as default };

package/dist/{config-helpers-QvhfBI9b.mjs → config-helpers-wZhBJJXJ.mjs}

@@ -9,6 +9,5 @@ function extractConfig(result) {
 	if (result) return result.config;
 	return {};
 }
-
 //#endregion
-export { extractConfig as t };
+export { extractConfig as t };

package/dist/{detect-t9mL3oTg.mjs → detect-DcO0_CWy.mjs}

@@ -1,8 +1,7 @@
 import { join } from "node:path";
-import { readFile } from "node:fs/promises";
 import { attemptAsync, ok, toErrorMessage } from "@kidd-cli/utils/fp";
+import { readFile } from "node:fs/promises";
 import { fileExists } from "@kidd-cli/utils/fs";
-
 //#region src/lib/detect.ts
 /**
 * Detect whether the given directory contains a kidd-based CLI project.
@@ -58,6 +57,5 @@ async function readPackageJson(filePath) {
 		}, null];
 	}
 }
-
 //#endregion
-export { detectProject as t };
+export { detectProject as t };

package/dist/index.mjs

@@ -1,7 +1,6 @@
 import { cli } from "@kidd-cli/core";
 import { join } from "node:path";
 import { readManifest } from "@kidd-cli/utils/manifest";
-
 //#region src/manifest.ts
 /**
 * Read and validate the CLI package manifest.
@@ -26,16 +25,15 @@ async function loadCLIManifest(baseDir) {
 		version: manifest.version
 	};
 }
-
 //#endregion
 //#region src/index.ts
 const manifest = await loadCLIManifest(import.meta.dirname);
 await cli({
 	commands: `${import.meta.dirname}/commands`,
 	description: manifest.description,
+	help: { header: `${manifest.name} v${manifest.version}` },
 	name: manifest.name,
 	version: manifest.version
 });
-
 //#endregion
-export {  };
+export {};

package/dist/lib/templates/project/package.json.liquid

@@ -5,7 +5,7 @@
   "keywords": [],
   "license": "MIT",
   "bin": {
-    "{{ name }}": "./dist/index.js"
+    "{{ name }}": "./dist/index.mjs"
   },
   "files": [
     "dist"
@@ -19,11 +19,12 @@
   },
   "dependencies": {
     "@kidd-cli/core": "^{{ coreVersion }}",
-    "zod": "^3.24.0"
+    "zod": "{{ zodVersion }}"
   },
   "devDependencies": {
     "@kidd-cli/cli": "^{{ cliVersion }}",
-    "typescript": "^5.7.0",
-    "vitest": "^4.0.0"
+    "tsdown": "{{ tsdownVersion }}",
+    "typescript": "{{ typescriptVersion }}",
+    "vitest": "{{ vitestVersion }}"
   }
 }

package/dist/lib/templates/project/tsconfig.json.liquid

@@ -1,6 +1,6 @@
 {
   "compilerOptions": {
-    "target": "ES2022",
+    "target": "ES2024",
     "module": "ESNext",
     "moduleResolution": "bundler",
     "strict": true,

package/dist/{write-dfZMTbtn.mjs → write-CdoqLFeH.mjs}

@@ -1,9 +1,8 @@
 import { dirname, join, relative } from "node:path";
-import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 import { ok, toErrorMessage } from "@kidd-cli/utils/fp";
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 import { fileExists } from "@kidd-cli/utils/fs";
 import { Liquid } from "liquidjs";
-
 //#region src/lib/render.ts
 /**
 * Render all `.liquid` templates in a directory using LiquidJS.
@@ -92,7 +91,6 @@ function isGenerateError(value) {
 	if (typeof value !== "object" || value === null) return false;
 	return "type" in value && "message" in value;
 }
-
 //#endregion
 //#region src/lib/validate.ts
 const KEBAB_CASE_CHARS_RE = /^[a-z][\da-z-]*$/;
@@ -108,7 +106,6 @@ function isKebabCase(value) {
 	if (value.includes("--")) return false;
 	return true;
 }
-
 //#endregion
 //#region src/lib/write.ts
 /**
@@ -162,6 +159,5 @@ async function writeSingleFile(file, outputDir, overwrite) {
 		}, null];
 	}
 }
-
 //#endregion
-export { isKebabCase as n, renderTemplate as r, writeFiles as t };
+export { isKebabCase as n, renderTemplate as r, writeFiles as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kidd-cli/cli",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "DX companion CLI for the kidd framework",
   "keywords": [
     "cli",
@@ -22,20 +22,21 @@
   ],
   "type": "module",
   "dependencies": {
-    "fs-extra": "^11.3.3",
+    "fs-extra": "^11.3.4",
     "liquidjs": "^10.25.0",
     "picocolors": "^1.1.1",
     "zod": "^4.3.6",
-    "@kidd-cli/bundler": "0.1.2",
-    "@kidd-cli/config": "0.1.2",
-    "@kidd-cli/core": "0.2.0",
-    "@kidd-cli/utils": "0.1.2"
+    "@kidd-cli/bundler": "0.2.0",
+    "@kidd-cli/config": "0.1.4",
+    "@kidd-cli/core": "0.4.0",
+    "@kidd-cli/utils": "0.1.4"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
-    "tsdown": "0.21.0-beta.2",
+    "tsdown": "0.21.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "yaml": "^2.8.0"
   },
   "scripts": {
     "build": "tsdown && mkdir -p dist/lib && cp -r src/lib/templates dist/lib/templates",