create-template-project 1.1.2 → 1.2.0

package/dist/index.js

@@ -7,9 +7,8 @@ import { execa } from "execa";
 import path from "node:path";
 import fs from "node:fs/promises";
 import debugLib from "debug";
-import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
-//#region src/types.ts
+//#region src/shared/types.ts
 var TemplateTypeSchema = z.enum([
 	"cli",
 	"web-vanilla",
@@ -39,8 +38,8 @@ var ProjectOptionsSchema = z.object({
 //#region src/utils/templating/generic.ts
 var genericProcessor = (content, { opts }) => {
 	const { projectName, template, author, githubUsername } = opts;
-	let description = opts.description || "";
-	if (!description) switch (template) {
+	let description = opts.description ?? "";
+	if (description.length === 0) switch (template) {
 		case "cli":
 			description = "A modern Node.js CLI application with TypeScript and automated tooling.";
 			break;
@@ -53,10 +52,11 @@ var genericProcessor = (content, { opts }) => {
 		case "web-app":
 			description = "A React application with MUI and TanStack Query.";
 			break;
+		default: break;
 	}
-	const pm = opts.packageManager || "npm";
+	const pm = opts.packageManager;
 	const lockfileRules = pm === "pnpm" ? "package-lock.json\nyarn.lock" : pm === "yarn" ? "package-lock.json\npnpm-lock.yaml" : "yarn.lock\npnpm-lock.yaml";
-	return content.replaceAll("{{projectName}}", projectName).replaceAll("{{description}}", description).replaceAll("{{packageManager}}", pm).replaceAll("{{author}}", author || "").replaceAll("{{githubUsername}}", githubUsername || "").replaceAll("{{year}}", (/* @__PURE__ */ new Date()).getFullYear().toString()).replaceAll("{{lockfileRules}}", lockfileRules);
+	return content.replaceAll("{{projectName}}", projectName).replaceAll("{{description}}", description).replaceAll("{{packageManager}}", pm).replaceAll("{{author}}", author).replaceAll("{{githubUsername}}", githubUsername).replaceAll("{{year}}", (/* @__PURE__ */ new Date()).getFullYear().toString()).replaceAll("{{lockfileRules}}", lockfileRules);
 };
 //#endregion
 //#region src/utils/templating/github-workflow.ts
@@ -69,7 +69,7 @@ var WORKFLOW_PLAYWRIGHT_SETUP = `      - name: Install Playwright Browsers & Dep
         run: npx playwright install --with-deps chromium`;
 var githubWorkflowProcessor = (content, { filePath, opts }) => {
 	if (!filePath.includes(".github/workflows/node.js.yml")) return content;
-	const { template, packageManager: pm = "npm" } = opts;
+	const { template, packageManager: pm } = opts;
 	let installCommand = "npm ci";
 	let pmSetup = "";
 	if (pm === "pnpm") {
@@ -99,7 +99,7 @@ var tsconfigProcessor = (content, { filePath, opts }) => {
 	if (filePath !== "tsconfig.json") return content;
 	const { template } = opts;
 	let processed = content;
-	if (template === "web-fullstack" || template === "web-vanilla" || template === "web-app") processed = processed.replace(/\/\* Language and Environment \*\/[\s\S]*?\/\* Strict Type-Checking Options \*\//, WEB_ENV + "\n\n		/* Strict Type-Checking Options */");
+	if (template === "web-fullstack" || template === "web-vanilla" || template === "web-app") processed = processed.replace(/\/\* Language and Environment \*\/[\s\S]*?\/\* Strict Type-Checking Options \*\//, `${WEB_ENV}\n\n\t\t/* Strict Type-Checking Options */`);
 	if (template === "web-fullstack") processed = processed.replace(/"include":\s*\[\s*"src\/\*\*\/\*"\s*\]/, "\"include\": [\"client/src/**/*\", \"server/src/**/*\"]");
 	return processed;
 };
@@ -109,7 +109,7 @@ var contributingProcessor = (content, { filePath, addedDeps }) => {
 	if (filePath !== "CONTRIBUTING.md" || addedDeps.length === 0) return content;
 	let processed = content;
 	processed += "\n## Dependencies\n\n";
-	const uniqueDeps = Array.from(new Set(addedDeps.map((d) => JSON.stringify(d)))).map((s) => JSON.parse(s));
+	const uniqueDeps = [...new Map(addedDeps.map((dep) => [dep.name, dep])).values()];
 	for (const dep of uniqueDeps) processed += `- **${dep.name}**: ${dep.description}\n`;
 	return processed;
 };
@@ -120,59 +120,94 @@ var webVanillaHtmlProcessor = (content, { filePath, opts }) => {
 	return content;
 };
 //#endregion
+//#region src/utils/templating/oxc-config.ts
+var oxcConfigProcessor = (content, { filePath, opts }) => {
+	if (filePath !== "oxc.config.ts") return content;
+	const shouldAddNodeEnv = opts.template === "cli" || opts.template === "web-fullstack";
+	const shouldAddBrowserEnv = opts.template === "web-vanilla" || opts.template === "web-app" || opts.template === "web-fullstack";
+	const linesToAdd = [];
+	if (shouldAddNodeEnv && !content.includes("node: true")) linesToAdd.push("		node: true,");
+	if (shouldAddBrowserEnv && !content.includes("browser: true")) linesToAdd.push("		browser: true,");
+	if (linesToAdd.length === 0) return content;
+	for (const envBlock of ["	env: {\n		builtin: true,\n", "env: {\n		builtin: true,\n"]) if (content.includes(envBlock)) return content.replace(envBlock, `${envBlock}${linesToAdd.join("\n")}\n`);
+	return content;
+};
+//#endregion
 //#region src/utils/templating/index.ts
 var processors = [
 	genericProcessor,
 	githubWorkflowProcessor,
 	tsconfigProcessor,
 	contributingProcessor,
-	webVanillaHtmlProcessor
+	webVanillaHtmlProcessor,
+	oxcConfigProcessor
 ];
-function processContent$1(filePath, content, opts, addedDeps) {
+var processContent$1 = (filePath, content, opts, addedDeps) => {
 	const context = {
 		filePath,
 		opts,
 		addedDeps
 	};
-	return processors.reduce((acc, processor) => processor(acc, context), content);
-}
+	let processed = content;
+	for (const processor of processors) processed = processor(processed, context);
+	return processed;
+};
 //#endregion
-//#region src/utils/file.ts
+//#region src/shared/file.ts
 var debug$3 = debugLib("create-template-project:utils:file");
-function getTemplateDir(dirname, templateName) {
+var toErrorDetail$1 = (error) => {
+	if (error instanceof Error) {
+		const value = error;
+		const stdout = value.stdout ?? "";
+		const stderr = value.stderr ?? "";
+		const detail = stdout.length > 0 || stderr.length > 0 ? `\n\nOutput:\n${stdout}\n${stderr}` : "";
+		return {
+			message: error.message,
+			detail,
+			exitCode: value.exitCode
+		};
+	}
+	return {
+		message: String(error),
+		detail: ""
+	};
+};
+var getTemplateDir = (dirname, templateName) => {
 	const sourcePath = path.resolve(dirname, "files");
 	const distPath = path.resolve(dirname, "templates", templateName, "files");
 	return existsSync(distPath) ? distPath : sourcePath;
-}
-async function getAllFiles(dirPath, arrayOfFiles = []) {
-	const files = await fs.readdir(dirPath);
-	for (const file of files) {
-		if (file === ".DS_Store") continue;
-		if ((await fs.stat(path.join(dirPath, file))).isDirectory()) arrayOfFiles = await getAllFiles(path.join(dirPath, file), arrayOfFiles);
-		else arrayOfFiles.push(path.join(dirPath, file));
-	}
-	return arrayOfFiles;
-}
-function processContent(filePath, content, opts, addedDeps) {
-	return processContent$1(filePath, content, opts, addedDeps);
-}
-function mergePackageJson(target, source) {
-	if (source.scripts) target.scripts = {
+};
+var getAllFiles = async (dirPath, arrayOfFiles = []) => {
+	const filteredEntries = (await fs.readdir(dirPath, { withFileTypes: true })).filter((entry) => entry.name !== ".DS_Store");
+	const files = filteredEntries.filter((entry) => entry.isFile()).map((entry) => path.join(dirPath, entry.name));
+	const directories = filteredEntries.filter((entry) => entry.isDirectory());
+	const nestedResults = await Promise.all(directories.map(async (entry) => {
+		return await getAllFiles(path.join(dirPath, entry.name));
+	}));
+	return [
+		...arrayOfFiles,
+		...files,
+		...nestedResults.flat()
+	];
+};
+var processContent = (filePath, content, opts, addedDeps) => processContent$1(filePath, content, opts, addedDeps);
+var mergePackageJson = (target, source) => {
+	if (source.scripts !== void 0) target.scripts = {
 		...target.scripts,
 		...source.scripts
 	};
-	if (source.dependencies) target.dependencies = {
+	if (source.dependencies !== void 0) target.dependencies = {
 		...target.dependencies,
 		...source.dependencies
 	};
-	if (source.devDependencies) target.devDependencies = {
+	if (source.devDependencies !== void 0) target.devDependencies = {
 		...target.devDependencies,
 		...source.devDependencies
 	};
-	if (source.workspaces) target.workspaces = source.workspaces;
-	if (source.bin) target.bin = source.bin;
-}
-function isSeedFile(filePath) {
+	if (source.workspaces !== void 0) target.workspaces = source.workspaces;
+	if (source.bin !== void 0) target.bin = source.bin;
+};
+var isSeedFile = (filePath) => {
 	return [
 		"src/",
 		"client/src/",
@@ -186,14 +221,14 @@ function isSeedFile(filePath) {
 		"index.tsx",
 		"LICENSE"
 	].some((file) => filePath === file) || filePath.toLowerCase().endsWith(".md");
-}
-async function mergeFile(filePath, existing, template, log) {
+};
+var mergeFile = async (filePath, existing, template, log) => {
 	debug$3("Merging file: %s", filePath);
-	const tempBase = filePath + ".base.tmp";
-	const tempNew = filePath + ".new.tmp";
+	const tempBase = `${filePath}.base.tmp`;
+	const tempNew = `${filePath}.new.tmp`;
 	try {
 		await fs.writeFile(tempNew, template);
-		await fs.writeFile(tempBase, "");
+		await fs.writeFile(tempBase, existing);
 		try {
 			const stdio = debug$3.enabled ? "inherit" : "pipe";
 			debug$3("Executing: git merge-file %s %s %s", filePath, tempBase, tempNew);
@@ -207,82 +242,76 @@ async function mergeFile(filePath, existing, template, log) {
 				preferLocal: true
 			});
 			return (await fs.readFile(filePath, "utf8")).trim() !== template.trim() ? "merged" : "updated";
-		} catch (e) {
-			if (e.exitCode >= 1 && e.exitCode < 128) return "conflict";
-			else {
-				debug$3("Git merge-file failed: %O", e);
-				const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
-				log.error(`Failed to merge ${filePath}: ${e.message}${detail}`);
-				return "error";
-			}
+		} catch (error) {
+			const detail = toErrorDetail$1(error);
+			if (detail.exitCode !== void 0 && detail.exitCode >= 1 && detail.exitCode < 128) return "conflict";
+			debug$3("Git merge-file failed: %O", error);
+			log.error(`Failed to merge ${filePath}: ${detail.message}${detail.detail}`);
+			return "error";
 		}
 	} finally {
 		await fs.rm(tempBase, { force: true });
 		await fs.rm(tempNew, { force: true });
 	}
-}
+};
 //#endregion
 //#region src/templates/base/index.ts
-var __dirname$5 = path.dirname(fileURLToPath(import.meta.url));
-var getBaseTemplate = (_opts) => {
-	return {
-		name: "base",
-		description: "The foundation for all project templates, including common tooling and configuration.",
-		components: [
-			{
-				name: "TypeScript",
-				description: "Mandatory strict mode for type safety."
-			},
-			{
-				name: "oxlint",
-				description: "Ultra-fast Rust-based linter."
-			},
-			{
-				name: "oxfmt",
-				description: "High performance code formatting."
-			},
-			{
-				name: "Vitest",
-				description: "Modern, fast unit testing with coverage."
-			},
-			{
-				name: "Husky",
-				description: "Git hooks for pre-commit linting."
-			},
-			{
-				name: "commitlint",
-				description: "Standardized commit messages."
-			},
-			{
-				name: "conventional-changelog",
-				description: "Automated release notes."
-			},
-			{
-				name: "release-it",
-				description: "Automated release workflow."
-			},
-			{
-				name: "debug",
-				description: "Structured logging for debugging."
-			},
-			{
-				name: "Zod",
-				description: "TypeScript-first schema validation for runtime type safety."
-			}
-		],
-		dependencies: { zod: "zod" },
-		devDependencies: {
-			"eslint-plugin-regexp": "",
-			"release-it": ""
+var getBaseTemplate = (_opts) => ({
+	name: "base",
+	description: "The foundation for all project templates, including common tooling and configuration.",
+	components: [
+		{
+			name: "TypeScript",
+			description: "Mandatory strict mode for type safety."
 		},
-		scripts: {},
-		files: [],
-		templateDir: getTemplateDir(__dirname$5, "base")
-	};
-};
+		{
+			name: "oxlint",
+			description: "Ultra-fast Rust-based linter."
+		},
+		{
+			name: "oxfmt",
+			description: "High performance code formatting."
+		},
+		{
+			name: "Vitest",
+			description: "Modern, fast unit testing with coverage."
+		},
+		{
+			name: "Husky",
+			description: "Git hooks for pre-commit linting."
+		},
+		{
+			name: "commitlint",
+			description: "Standardized commit messages."
+		},
+		{
+			name: "conventional-changelog",
+			description: "Automated release notes."
+		},
+		{
+			name: "release-it",
+			description: "Automated release workflow."
+		},
+		{
+			name: "debug",
+			description: "Structured logging for debugging."
+		},
+		{
+			name: "Zod",
+			description: "TypeScript-first schema validation for runtime type safety."
+		}
+	],
+	dependencies: { zod: "zod" },
+	devDependencies: {
+		"eslint-plugin-regexp": "",
+		"release-it": ""
+	},
+	scripts: {},
+	files: [],
+	templateDir: getTemplateDir(import.meta.dirname, "base")
+});
 //#endregion
 //#region src/templates/cli/index.ts
-var __dirname$4 = path.dirname(fileURLToPath(import.meta.url));
 var getCliTemplate = (_opts) => {
 	return {
 		name: "cli",
@@ -305,194 +334,201 @@ var getCliTemplate = (_opts) => {
 		devDependencies: { vite: "vite" },
 		scripts: {},
 		files: [],
-		templateDir: getTemplateDir(__dirname$4, "cli")
+		templateDir: getTemplateDir(import.meta.dirname, "cli")
 	};
 };
 //#endregion
 //#region src/templates/web-vanilla/index.ts
-var __dirname$3 = path.dirname(fileURLToPath(import.meta.url));
-var getWebVanillaTemplate = (_opts) => {
-	return {
-		name: "web-vanilla",
-		description: "A modern, standalone web page template with built-in development and testing tooling.",
-		components: [
-			{
-				name: "Vite",
-				description: "Fast frontend build tool and development server."
-			},
-			{
-				name: "Vitest",
-				description: "Modern testing framework with browser support."
-			},
-			{
-				name: "Playwright",
-				description: "Comprehensive end-to-end testing for modern web apps."
-			}
-		],
-		dependencies: {},
-		devDependencies: {
-			vite: "vite",
-			vitest: "vitest",
-			"@vitest/browser": "@vitest/browser",
-			"@vitest/browser-playwright": "@vitest/browser-playwright",
-			playwright: "playwright",
-			"@playwright/test": "@playwright/test"
+var getWebVanillaTemplate = (_opts) => ({
+	name: "web-vanilla",
+	description: "A modern, standalone web page template with built-in development and testing tooling.",
+	components: [
+		{
+			name: "Vite",
+			description: "Fast frontend build tool and development server."
 		},
-		scripts: {
-			dev: "vite",
-			build: "vite build",
-			preview: "vite preview",
-			test: "vitest run",
-			"test:ui": "vitest",
-			"integration-test": "playwright test"
+		{
+			name: "Vitest",
+			description: "Modern testing framework with browser support."
 		},
-		files: [],
-		templateDir: getTemplateDir(__dirname$3, "web-vanilla")
-	};
-};
+		{
+			name: "Playwright",
+			description: "Comprehensive end-to-end testing for modern web apps."
+		}
+	],
+	dependencies: {},
+	devDependencies: {
+		vite: "vite",
+		vitest: "vitest",
+		"@vitest/browser": "@vitest/browser",
+		"@vitest/browser-playwright": "@vitest/browser-playwright",
+		playwright: "playwright",
+		"@playwright/test": "@playwright/test"
+	},
+	scripts: {
+		dev: "vite",
+		build: "vite build",
+		preview: "vite preview",
+		test: "vitest run",
+		"test:ui": "vitest",
+		"integration-test": "playwright test"
+	},
+	files: [],
+	templateDir: getTemplateDir(import.meta.dirname, "web-vanilla")
+});
 //#endregion
 //#region src/templates/web-app/index.ts
-var __dirname$2 = path.dirname(fileURLToPath(import.meta.url));
-var getWebAppTemplate = (_opts) => {
-	return {
-		name: "web-app",
-		description: "A React application with MUI and TanStack Query, powered by Vite.",
-		components: [
-			{
-				name: "React",
-				description: "Powerful library for building component-based user interfaces."
-			},
-			{
-				name: "MUI",
-				description: "Rich set of Material Design UI components for React."
-			},
-			{
-				name: "TanStack React Query",
-				description: "Powerful asynchronous state management for React."
-			},
-			{
-				name: "Vite",
-				description: "Next-generation frontend tooling."
-			},
-			{
-				name: "Vitest",
-				description: "Testing framework with cross-browser support."
-			},
-			{
-				name: "Playwright",
-				description: "End-to-end testing for modern web apps."
-			}
-		],
-		dependencies: {
-			react: "react",
-			"react-dom": "react-dom",
-			"@mui/material": "@mui/material",
-			"@mui/icons-material": "@mui/icons-material",
-			"@emotion/react": "@emotion/react",
-			"@emotion/styled": "@emotion/styled",
-			"@tanstack/react-query": "@tanstack/react-query"
+var getWebAppTemplate = (_opts) => ({
+	name: "web-app",
+	description: "A React application with MUI and TanStack Query, powered by Vite.",
+	components: [
+		{
+			name: "React",
+			description: "Powerful library for building component-based user interfaces."
 		},
-		devDependencies: {
-			"@types/react": "@types/react",
-			"@types/react-dom": "@types/react-dom",
-			vite: "vite",
-			"@vitejs/plugin-react": "@vitejs/plugin-react",
-			vitest: "vitest",
-			"@vitest/browser": "@vitest/browser",
-			"@vitest/browser-playwright": "@vitest/browser-playwright",
-			playwright: "playwright",
-			"@playwright/test": "@playwright/test",
-			"vitest-browser-react": "vitest-browser-react"
+		{
+			name: "MUI",
+			description: "Rich set of Material Design UI components for React."
 		},
-		scripts: {
-			dev: "vite",
-			build: "vite build",
-			preview: "vite preview",
-			test: "vitest run",
-			"test:ui": "vitest",
-			"integration-test": "playwright test",
-			start: "vite preview"
+		{
+			name: "TanStack React Query",
+			description: "Powerful asynchronous state management for React."
 		},
-		files: [],
-		templateDir: getTemplateDir(__dirname$2, "web-app")
-	};
-};
+		{
+			name: "Vite",
+			description: "Next-generation frontend tooling."
+		},
+		{
+			name: "Vitest",
+			description: "Testing framework with cross-browser support."
+		},
+		{
+			name: "Playwright",
+			description: "End-to-end testing for modern web apps."
+		}
+	],
+	dependencies: {
+		react: "react",
+		"react-dom": "react-dom",
+		"@mui/material": "@mui/material",
+		"@mui/icons-material": "@mui/icons-material",
+		"@emotion/react": "@emotion/react",
+		"@emotion/styled": "@emotion/styled",
+		"@tanstack/react-query": "@tanstack/react-query"
+	},
+	devDependencies: {
+		"@types/react": "@types/react",
+		"@types/react-dom": "@types/react-dom",
+		vite: "vite",
+		"@vitejs/plugin-react": "@vitejs/plugin-react",
+		vitest: "vitest",
+		"@vitest/browser": "@vitest/browser",
+		"@vitest/browser-playwright": "@vitest/browser-playwright",
+		playwright: "playwright",
+		"@playwright/test": "@playwright/test",
+		"vitest-browser-react": "vitest-browser-react"
+	},
+	scripts: {
+		dev: "vite",
+		build: "vite build",
+		preview: "vite preview",
+		test: "vitest run",
+		"test:ui": "vitest",
+		"integration-test": "playwright test",
+		start: "vite preview"
+	},
+	files: [],
+	templateDir: getTemplateDir(import.meta.dirname, "web-app")
+});
 //#endregion
 //#region src/templates/web-fullstack/index.ts
-var __dirname$1 = path.dirname(fileURLToPath(import.meta.url));
-var getWebFullstackTemplate = (_opts) => {
-	return {
-		name: "web-fullstack",
-		description: "A comprehensive full-stack monorepo featuring an Express backend with tRPC and a modern React client with MUI.",
-		components: [
-			{
-				name: "React",
-				description: "Powerful library for building component-based user interfaces."
-			},
-			{
-				name: "MUI",
-				description: "Rich set of Material Design UI components for React."
-			},
-			{
-				name: "tRPC",
-				description: "End-to-end typesafe APIs made easy."
-			},
-			{
-				name: "React Query",
-				description: "Powerful asynchronous state management for React."
-			},
-			{
-				name: "Express",
-				description: "Fast, minimalist backend web framework."
-			},
-			{
-				name: "React Router",
-				description: "Declarative routing for the frontend."
-			},
-			{
-				name: "Vite",
-				description: "Fast, modern frontend build tool."
-			}
-		],
-		dependencies: {
-			react: "react",
-			"react-dom": "react-dom",
-			"@mui/material": "@mui/material",
-			"@mui/icons-material": "@mui/icons-material",
-			"@emotion/react": "@emotion/react",
-			"@emotion/styled": "@emotion/styled",
-			express: "express",
-			"@trpc/server": "@trpc/server",
-			"@trpc/client": "@trpc/client",
-			"@trpc/react-query": "@trpc/react-query",
-			"@tanstack/react-query": "@tanstack/react-query",
-			"react-router-dom": "react-router-dom",
-			cors: "cors"
+var getWebFullstackTemplate = (_opts) => ({
+	name: "web-fullstack",
+	description: "A comprehensive full-stack monorepo featuring an Express backend with tRPC and a modern React client with MUI.",
+	components: [
+		{
+			name: "React",
+			description: "Powerful library for building component-based user interfaces."
 		},
-		devDependencies: {
-			"@types/react": "@types/react",
-			"@types/react-dom": "@types/react-dom",
-			"@types/express": "@types/express",
-			"@types/cors": "@types/cors",
-			"@playwright/test": "@playwright/test",
-			vite: "vite",
-			"@vitejs/plugin-react": "@vitejs/plugin-react",
-			vitest: "vitest",
-			"@vitest/browser": "@vitest/browser",
-			"@vitest/browser-playwright": "@vitest/browser-playwright",
-			playwright: "playwright",
-			"vitest-browser-react": "vitest-browser-react"
+		{
+			name: "MUI",
+			description: "Rich set of Material Design UI components for React."
 		},
-		scripts: {
-			build: "npm run build --workspaces",
-			dev: "npm run dev --workspaces",
-			test: "npm run test --workspaces",
-			"integration-test": "playwright test"
+		{
+			name: "tRPC",
+			description: "End-to-end typesafe APIs made easy."
 		},
-		files: [],
-		templateDir: getTemplateDir(__dirname$1, "web-fullstack")
-	};
+		{
+			name: "React Query",
+			description: "Powerful asynchronous state management for React."
+		},
+		{
+			name: "Express",
+			description: "Fast, minimalist backend web framework."
+		},
+		{
+			name: "React Router",
+			description: "Declarative routing for the frontend."
+		},
+		{
+			name: "Vite",
+			description: "Fast, modern frontend build tool."
+		}
+	],
+	dependencies: {
+		react: "react",
+		"react-dom": "react-dom",
+		"@mui/material": "@mui/material",
+		"@mui/icons-material": "@mui/icons-material",
+		"@emotion/react": "@emotion/react",
+		"@emotion/styled": "@emotion/styled",
+		express: "express",
+		"@trpc/server": "@trpc/server",
+		"@trpc/client": "@trpc/client",
+		"@trpc/react-query": "@trpc/react-query",
+		"@tanstack/react-query": "@tanstack/react-query",
+		"react-router-dom": "react-router-dom",
+		cors: "cors"
+	},
+	devDependencies: {
+		"@types/react": "@types/react",
+		"@types/react-dom": "@types/react-dom",
+		"@types/express": "@types/express",
+		"@types/cors": "@types/cors",
+		"@playwright/test": "@playwright/test",
+		vite: "vite",
+		"@vitejs/plugin-react": "@vitejs/plugin-react",
+		vitest: "vitest",
+		"@vitest/browser": "@vitest/browser",
+		"@vitest/browser-playwright": "@vitest/browser-playwright",
+		playwright: "playwright",
+		"vitest-browser-react": "vitest-browser-react"
+	},
+	scripts: {
+		build: "npm run build --workspaces",
+		dev: "npm run dev --workspaces",
+		test: "npm run test --workspaces",
+		"integration-test": "playwright test"
+	},
+	files: [],
+	templateDir: getTemplateDir(import.meta.dirname, "web-fullstack")
+});
+//#endregion
+//#region src/templates/registry.ts
+var templateFactories = {
+	cli: getCliTemplate,
+	"web-vanilla": getWebVanillaTemplate,
+	"web-app": getWebAppTemplate,
+	"web-fullstack": getWebFullstackTemplate
 };
+var getTemplateByType = (type, opts) => templateFactories[type](opts);
+var getProjectTemplates = (opts) => [getBaseTemplate(opts), getTemplateByType(opts.template, opts)];
+var getTemplateTypes = () => [
+	"cli",
+	"web-vanilla",
+	"web-app",
+	"web-fullstack"
+];
 //#endregion
 //#region src/generators/info.ts
 var MOCK_OPTS = {
@@ -513,45 +549,57 @@ var getTemplateInfo = (type) => {
 		template: type
 	};
 	const base = getBaseTemplate(opts);
-	let template;
-	switch (type) {
-		case "cli":
-			template = getCliTemplate(opts);
-			break;
-		case "web-vanilla":
-			template = getWebVanillaTemplate(opts);
-			break;
-		case "web-app":
-			template = getWebAppTemplate(opts);
-			break;
-		case "web-fullstack":
-			template = getWebFullstackTemplate(opts);
-			break;
-	}
+	const template = getTemplateByType(type, opts);
 	return {
 		name: template.name,
 		description: template.description,
 		components: [...base.components, ...template.components]
 	};
 };
-var getAllTemplatesInfo = () => {
-	return [
-		"cli",
-		"web-vanilla",
-		"web-app",
-		"web-fullstack"
-	].map((type) => getTemplateInfo(type));
-};
+var getAllTemplatesInfo = () => getTemplateTypes().map((type) => getTemplateInfo(type));
 //#endregion
 //#region src/cli.ts
-var pathExists$1 = (p) => fs.access(p).then(() => true).catch(() => false);
+var isRecord$2 = (value) => typeof value === "object" && value !== null;
+var isPackageManager = (value) => value === "npm" || value === "pnpm" || value === "yarn";
+var pathExists$1 = async (filePath) => {
+	try {
+		await fs.access(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+};
+var parseStoredPackageJson = (raw) => {
+	const parsed = JSON.parse(raw);
+	if (!isRecord$2(parsed)) return {};
+	const pkg = parsed;
+	const config = pkg["create-template-project"];
+	const configRecord = isRecord$2(config) ? config : void 0;
+	let template;
+	if (configRecord !== void 0 && typeof configRecord.template === "string") {
+		const result = TemplateTypeSchema.safeParse(configRecord.template);
+		if (result.success) template = result.data;
+	}
+	return {
+		name: typeof pkg.name === "string" ? pkg.name : void 0,
+		description: typeof pkg.description === "string" ? pkg.description : void 0,
+		keywords: Array.isArray(pkg.keywords) ? pkg.keywords.filter((keyword) => typeof keyword === "string") : void 0,
+		author: typeof pkg.author === "string" ? pkg.author : void 0,
+		"create-template-project": configRecord ? {
+			template,
+			githubUsername: typeof configRecord.githubUsername === "string" ? configRecord.githubUsername : void 0,
+			author: typeof configRecord.author === "string" ? configRecord.author : void 0
+		} : void 0
+	};
+};
+var noop = () => void 0;
 var stripQuotes = (str) => {
 	if (typeof str !== "string") return str;
 	let result = str.trim();
 	while (result.length >= 2) {
-		const first = result[0];
-		const last = result[result.length - 1];
-		if (first === "\"" && last === "\"" || first === "'" && last === "'") result = result.substring(1, result.length - 1).trim();
+		const [first] = result;
+		const last = result.at(-1);
+		if (first === "\"" && last === "\"" || first === "'" && last === "'") result = result.slice(1, -1).trim();
 		else break;
 	}
 	return result;
@@ -560,7 +608,7 @@ var getDefaultAuthor = async () => {
 	try {
 		const { stdout } = await execa("git", ["config", "user.name"]);
 		return stdout.trim();
-	} catch (e) {
+	} catch {
 		return "";
 	}
 };
@@ -568,7 +616,7 @@ var getDefaultGithubUsername = async () => {
 	try {
 		const { stdout } = await execa("git", ["config", "github.user"]);
 		return stdout.trim();
-	} catch (e) {
+	} catch {
 		return "";
 	}
 };
@@ -577,11 +625,11 @@ var parseArgs = async () => {
 	debug$2("Parsing CLI arguments: %O", process.argv);
 	const program = new Command();
 	if (process.env.NODE_ENV === "test") program.configureOutput({
-		writeOut: () => {},
-		writeErr: () => {}
+		writeOut: noop,
+		writeErr: noop
 	});
 	program.name("create-template-project").exitOverride().description("Scaffold a new project template").version("0.1.0").option("--debug", "Enable debug output").on("option:debug", () => {
-		process.env["DEBUG"] = "create-template-project:*";
+		process.env.DEBUG = "create-template-project:*";
 		debugLib.enable("create-template-project:*");
 	}).addHelpText("after", `
 Commands:
@@ -600,8 +648,9 @@ Templates:
 	program.command("info").description("Show detailed information about available templates and their components").option("-t, --template <type>", "Template type (cli, web-vanilla, web-app, web-fullstack)").action((opts) => {
 		debug$2("Executing \"info\" command with options: %O", opts);
 		p.intro("Template Information");
-		if (opts.template) {
-			const typeResult = TemplateTypeSchema.safeParse(opts.template);
+		if (opts.template !== void 0 && opts.template.length > 0) {
+			const template = stripQuotes(opts.template);
+			const typeResult = TemplateTypeSchema.safeParse(template);
 			if (!typeResult.success) {
 				p.log.error(`Invalid template type: ${opts.template}. Must be one of: cli, web-vanilla, web-app, web-fullstack`);
 				process.exit(1);
@@ -627,19 +676,25 @@ Templates:
 	});
 	program.command("create").description("Create a new project from a template").option("-t, --template <type>", "Template type (cli, web-vanilla, web-app, web-fullstack)").option("-n, --name <name>", "Project name").option("--description <description>", "Project description").option("-k, --keywords <keywords>", "Project keywords (comma separated)").option("-a, --author <author>", "Author name (defaults to 'git config user.name')").option("--github-username <username>", "GitHub username (defaults to 'git config github.user')").option("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "pnpm").option("--create-github-repository", "Create GitHub repository and push initial commit").requiredOption("--path <path>", "Output directory").option("--build", "Run the CI script (lint, build, test) after scaffolding", false).option("--no-progress", "Do not show progress indicators").action(async (opts) => {
 		debug$2("Executing \"create\" command with options: %O", opts);
+		const templateInput = stripQuotes(opts.template);
+		const templateResult = TemplateTypeSchema.safeParse(templateInput);
+		if (!templateResult.success) {
+			p.log.error(`Invalid template type: ${opts.template}. Must be one of: cli, web-vanilla, web-app, web-fullstack`);
+			process.exit(1);
+		}
 		commandResult = {
-			...opts,
 			update: false,
-			template: opts.template,
+			template: templateResult.data,
 			projectName: opts.name,
 			description: opts.description,
 			keywords: opts.keywords,
-			author: opts.author || await getDefaultAuthor(),
-			githubUsername: opts.githubUsername || await getDefaultGithubUsername(),
+			author: opts.author ?? await getDefaultAuthor(),
+			githubUsername: opts.githubUsername ?? await getDefaultGithubUsername(),
 			packageManager: opts.packageManager,
 			directory: path.resolve(opts.path),
-			createGithubRepository: !!opts.createGithubRepository,
-			progress: !!opts.progress
+			createGithubRepository: Boolean(opts.createGithubRepository),
+			build: Boolean(opts.build),
+			progress: Boolean(opts.progress)
 		};
 		debug$2("Processed \"create\" options: %O", commandResult);
 	});
@@ -663,32 +718,45 @@ Restrictions & Behavior:
 		}
 		let pkg;
 		try {
-			pkg = JSON.parse(await fs.readFile(pkgPath, "utf8"));
-		} catch (e) {
-			p.log.error(`Failed to read or parse package.json at ${pkgPath}: ${e.message}`);
+			pkg = parseStoredPackageJson(await fs.readFile(pkgPath, "utf8"));
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			p.log.error(`Failed to read or parse package.json at ${pkgPath}: ${message}`);
 			process.exit(1);
 		}
-		if (!pkg.name) {
+		if (pkg.name === void 0 || pkg.name.length === 0) {
 			p.log.error(`No name property found in ${pkgPath}.`);
 			process.exit(1);
 		}
-		if (!pkg["create-template-project"]?.template) {
+		const projectConfig = pkg["create-template-project"];
+		if (projectConfig === void 0 || projectConfig.template === void 0) {
 			p.log.error(`No "create-template-project" configuration found in ${pkgPath}. The update command can only be used on projects created with this tool.`);
 			process.exit(1);
 		}
+		let template = projectConfig.template;
+		if (opts.template !== void 0) {
+			const templateInput = stripQuotes(opts.template);
+			const templateResult = TemplateTypeSchema.safeParse(templateInput);
+			if (!templateResult.success) {
+				p.log.error(`Invalid template type: ${opts.template}. Must be one of: cli, web-vanilla, web-app, web-fullstack`);
+				process.exit(1);
+			}
+			template = templateResult.data;
+		}
 		commandResult = {
 			...opts,
 			update: true,
-			template: opts.template || pkg["create-template-project"]?.template,
+			template,
 			projectName: pkg.name,
-			description: opts.description || pkg.description,
-			keywords: opts.keywords || (pkg.keywords ? pkg.keywords.join(", ") : void 0),
-			author: opts.author || pkg.author || await getDefaultAuthor(),
-			githubUsername: opts.githubUsername || pkg["create-template-project"]?.githubUsername || await getDefaultGithubUsername(),
+			description: opts.description ?? pkg.description,
+			keywords: opts.keywords ?? (pkg.keywords !== void 0 ? pkg.keywords.join(", ") : void 0),
+			author: opts.author ?? pkg.author ?? await getDefaultAuthor(),
+			githubUsername: opts.githubUsername ?? projectConfig.githubUsername ?? await getDefaultGithubUsername(),
 			packageManager: opts.packageManager,
 			directory,
-			createGithubRepository: !!opts.createGithubRepository,
-			progress: !!opts.progress
+			createGithubRepository: Boolean(opts.createGithubRepository),
+			build: Boolean(opts.build),
+			progress: Boolean(opts.progress)
 		};
 		debug$2("Processed \"update\" options: %O", commandResult);
 	});
@@ -698,7 +766,7 @@ Restrictions & Behavior:
 			message: "Project name:",
 			placeholder: "my-app",
 			defaultValue: "my-app",
-			validate: (value) => value && value.length > 0 ? void 0 : "Project name is required"
+			validate: (value = "") => value.length > 0 ? void 0 : "Project name is required"
 		});
 		if (p.isCancel(projectName)) {
 			p.cancel("Operation cancelled.");
@@ -722,20 +790,20 @@ Restrictions & Behavior:
 		let existingDescription = "";
 		let existingKeywords = [];
 		if (pkgExists) try {
-			const pkg = JSON.parse(await fs.readFile(pkgPath, "utf8"));
-			existingConfig = pkg["create-template-project"] || {};
-			existingAuthor = pkg.author;
-			existingGithubUsername = existingConfig.githubUsername;
-			existingDescription = pkg.description;
-			existingKeywords = pkg.keywords || [];
+			const pkg = parseStoredPackageJson(await fs.readFile(pkgPath, "utf8"));
+			existingConfig = pkg["create-template-project"] ?? {};
+			existingAuthor = pkg.author ?? "";
+			existingGithubUsername = existingConfig.githubUsername ?? "";
+			existingDescription = pkg.description ?? "";
+			existingKeywords = pkg.keywords ?? [];
 			debug$2("Found existing project config: %O", existingConfig);
-		} catch (e) {
-			debug$2("Failed to read existing package.json: %O", e);
+		} catch (error) {
+			debug$2("Failed to read existing package.json: %O", error);
 		}
 		const projectDescription = await p.text({
 			message: "Project description:",
 			placeholder: "A new project",
-			defaultValue: existingDescription || ""
+			defaultValue: existingDescription
 		});
 		if (p.isCancel(projectDescription)) {
 			p.cancel("Operation cancelled.");
@@ -744,29 +812,31 @@ Restrictions & Behavior:
 		const projectKeywords = await p.text({
 			message: "Project keywords (comma separated):",
 			placeholder: "cli, nodejs, typescript",
-			defaultValue: existingKeywords ? existingKeywords.join(", ") : ""
+			defaultValue: existingKeywords.join(", ")
 		});
 		if (p.isCancel(projectKeywords)) {
 			p.cancel("Operation cancelled.");
 			process.exit(0);
 		}
 		const defaultAuthor = await getDefaultAuthor();
+		const authorDefault = existingAuthor.length > 0 ? existingAuthor : existingConfig.author ?? defaultAuthor;
 		const author = await p.text({
 			message: "Author name:",
 			placeholder: "Your Name",
-			defaultValue: existingAuthor || existingConfig.author || defaultAuthor,
-			validate: (value) => value && value.length > 0 ? void 0 : "Author name is required"
+			defaultValue: authorDefault,
+			validate: (value = "") => value.length > 0 ? void 0 : "Author name is required"
 		});
 		if (p.isCancel(author)) {
 			p.cancel("Operation cancelled.");
 			process.exit(0);
 		}
 		const defaultGithubUsername = await getDefaultGithubUsername();
+		const githubDefault = existingGithubUsername.length > 0 ? existingGithubUsername : defaultGithubUsername;
 		const githubUsername = await p.text({
 			message: "GitHub username:",
 			placeholder: "your-github-username",
-			defaultValue: existingGithubUsername || defaultGithubUsername,
-			validate: (value) => value && value.length > 0 ? void 0 : "GitHub username is required"
+			defaultValue: githubDefault,
+			validate: (value = "") => value.length > 0 ? void 0 : "GitHub username is required"
 		});
 		if (p.isCancel(githubUsername)) {
 			p.cancel("Operation cancelled.");
@@ -788,19 +858,18 @@ Restrictions & Behavior:
 				p.cancel("Operation cancelled.");
 				process.exit(0);
 			}
-			if (action === "update") {
-				if (!existingConfig.template) {
-					p.log.error(`No "create-template-project" configuration found in ${pkgPath}. The update command can only be used on projects created with this tool.`);
-					process.exit(1);
-				}
-				update = true;
+			if (!existingConfig.template) {
+				p.log.error(`No "create-template-project" configuration found in ${pkgPath}. The update command can only be used on projects created with this tool.`);
+				process.exit(1);
 			}
+			update = true;
 		}
-		let template = existingConfig.template;
+		const { template: existingTemplate } = existingConfig;
+		let template = existingTemplate;
 		if (!update || !template) {
-			template = await p.select({
+			const selectedTemplate = await p.select({
 				message: "Select project template:",
-				initialValue: template || "cli",
+				initialValue: template ?? "cli",
 				options: [
 					{
 						label: "CLI Application (Node.js)",
@@ -820,14 +889,24 @@ Restrictions & Behavior:
 					}
 				]
 			});
-			if (p.isCancel(template)) {
+			if (p.isCancel(selectedTemplate)) {
 				p.cancel("Operation cancelled.");
 				process.exit(0);
 			}
+			if (typeof selectedTemplate !== "string") {
+				p.cancel("Invalid template selection.");
+				process.exit(1);
+			}
+			const templateResult = TemplateTypeSchema.safeParse(selectedTemplate);
+			if (!templateResult.success) {
+				p.cancel("Invalid template selection.");
+				process.exit(1);
+			}
+			template = templateResult.data;
 		} else p.log.info(`Using existing template type: ${template}`);
 		let packageManager = "pnpm";
 		if (!update) {
-			packageManager = await p.select({
+			const selectedPackageManager = await p.select({
 				message: "Select package manager:",
 				initialValue: "pnpm",
 				options: [
@@ -845,10 +924,15 @@ Restrictions & Behavior:
 					}
 				]
 			});
-			if (p.isCancel(packageManager)) {
+			if (p.isCancel(selectedPackageManager)) {
 				p.cancel("Operation cancelled.");
 				process.exit(0);
 			}
+			if (typeof selectedPackageManager !== "string" || !isPackageManager(selectedPackageManager)) {
+				p.cancel("Invalid package manager selection.");
+				process.exit(1);
+			}
+			packageManager = selectedPackageManager;
 		}
 		const build = await p.confirm({
 			message: "Should we run the CI script (lint, build, test)?",
@@ -887,10 +971,12 @@ Restrictions & Behavior:
 	}
 	try {
 		await program.parseAsync(process.argv);
-	} catch (e) {
-		if (e.code === "commander.helpDisplayed" || e.code === "commander.version" || e.code === "PROCESS_EXIT_0") process.exit(0);
-		if (e.code === "PROCESS_EXIT_1") process.exit(1);
-		p.cancel(e.message);
+	} catch (error) {
+		const code = typeof error === "object" && error !== null && "code" in error ? String(error.code) : "";
+		if (code === "commander.helpDisplayed" || code === "commander.version" || code === "PROCESS_EXIT_0") process.exit(0);
+		if (code === "PROCESS_EXIT_1") process.exit(1);
+		const message = error instanceof Error ? error.message : String(error);
+		p.cancel(message);
 		process.exit(1);
 	}
 	if (!commandResult) {
@@ -898,13 +984,29 @@ Restrictions & Behavior:
 		p.cancel("Unknown command or missing options.");
 		process.exit(1);
 	}
-	if (commandResult.template) commandResult.template = stripQuotes(commandResult.template);
-	if (commandResult.projectName) commandResult.projectName = stripQuotes(commandResult.projectName);
-	if (commandResult.description) commandResult.description = stripQuotes(commandResult.description);
-	if (commandResult.keywords) commandResult.keywords = stripQuotes(commandResult.keywords);
-	if (commandResult.author) commandResult.author = stripQuotes(commandResult.author);
-	if (commandResult.githubUsername) commandResult.githubUsername = stripQuotes(commandResult.githubUsername);
-	if (commandResult.packageManager) commandResult.packageManager = stripQuotes(commandResult.packageManager);
+	const template = stripQuotes(commandResult.template);
+	if (template !== void 0) {
+		const templateResult = TemplateTypeSchema.safeParse(template);
+		if (templateResult.success) commandResult.template = templateResult.data;
+	}
+	if (commandResult.projectName !== void 0) {
+		const projectName = stripQuotes(commandResult.projectName);
+		if (projectName !== void 0) commandResult.projectName = projectName;
+	}
+	if (commandResult.description !== void 0) commandResult.description = stripQuotes(commandResult.description);
+	if (commandResult.keywords !== void 0) commandResult.keywords = stripQuotes(commandResult.keywords);
+	if (commandResult.author !== void 0) {
+		const author = stripQuotes(commandResult.author);
+		if (author !== void 0) commandResult.author = author;
+	}
+	if (commandResult.githubUsername !== void 0) {
+		const githubUsername = stripQuotes(commandResult.githubUsername);
+		if (githubUsername !== void 0) commandResult.githubUsername = githubUsername;
+	}
+	if (commandResult.packageManager !== void 0) {
+		const packageManager = stripQuotes(commandResult.packageManager);
+		if (packageManager !== void 0 && isPackageManager(packageManager)) commandResult.packageManager = packageManager;
+	}
 	debug$2("Validating command result with Zod");
 	const validationResult = ProjectOptionsSchema.safeParse(commandResult);
 	if (!validationResult.success) {
@@ -912,35 +1014,54 @@ Restrictions & Behavior:
 		p.cancel(`Invalid options: ${errors}`);
 		process.exit(1);
 	}
-	commandResult = validationResult.data;
-	const projectDir = commandResult.directory;
-	if (await pathExists$1(projectDir) && !commandResult.update) {
+	const validated = validationResult.data;
+	const projectDir = validated.directory;
+	if (await pathExists$1(projectDir) && !validated.update) {
 		p.cancel(`Directory "${projectDir}" already exists. Use the "update" command to update.`);
 		process.exit(1);
 	}
-	return commandResult;
+	return validated;
 };
 //#endregion
 //#region src/generators/project.ts
 var debug$1 = debugLib("create-template-project:generator");
-var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var moduleDir = import.meta.dirname;
+var pathExists = async (filePath) => {
+	try {
+		await fs.access(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+};
 var getDependencyConfigPath = async () => {
-	const sourcePath = path.resolve(__dirname, "../config/dependencies.json");
-	const distPath = path.resolve(__dirname, "config/dependencies.json");
+	const sourcePath = path.resolve(moduleDir, "../config/dependencies.json");
+	const distPath = path.resolve(moduleDir, "config/dependencies.json");
 	return await pathExists(distPath) ? distPath : sourcePath;
 };
-var pathExists = (p) => fs.access(p).then(() => true).catch(() => false);
 var getLog = (progress) => ({
-	info: (msg) => progress ? p.log.info(msg) : void 0,
-	success: (msg) => progress ? p.log.success(msg) : void 0,
-	warn: (msg) => p.log.warn(msg),
-	error: (msg) => p.log.error(msg)
+	info: (msg) => {
+		if (progress) p.log.info(msg);
+	},
+	success: (msg) => {
+		if (progress) p.log.success(msg);
+	},
+	warn: (msg) => {
+		p.log.warn(msg);
+	},
+	error: (msg) => {
+		p.log.error(msg);
+	}
 });
 var getSpinner = (progress) => {
 	const s = p.spinner();
 	return {
-		start: (msg) => progress ? s.start(msg) : void 0,
-		stop: (msg) => progress ? s.stop(msg) : void 0
+		start: (msg) => {
+			if (progress) s.start(msg);
+		},
+		stop: (msg) => {
+			if (progress) s.stop(msg);
+		}
 	};
 };
 var isFileRequired = (relativePath, type) => {
@@ -952,70 +1073,111 @@ var isFileRequired = (relativePath, type) => {
 	].includes(type);
 	return true;
 };
+var getTemplateArchitectureSection;
+var generateGeneratedMd;
+var isTemplateType = (value) => value === "cli" || value === "web-vanilla" || value === "web-app" || value === "web-fullstack";
+var isRecord$1 = (value) => typeof value === "object" && value !== null;
+var parseStringRecord = (value) => {
+	if (!isRecord$1(value)) return {};
+	const out = {};
+	for (const [key, entry] of Object.entries(value)) if (typeof entry === "string") out[key] = entry;
+	return out;
+};
+var parseDependencyConfig = (raw) => {
+	const parsed = JSON.parse(raw);
+	if (!isRecord$1(parsed) || !isRecord$1(parsed.dependencies)) throw new Error("Invalid dependency configuration file format.");
+	const dependencies = {};
+	for (const [name, value] of Object.entries(parsed.dependencies)) {
+		if (!isRecord$1(value)) continue;
+		const { version, description } = value;
+		if (typeof version === "string" && typeof description === "string") dependencies[name] = {
+			version,
+			description
+		};
+	}
+	return { dependencies };
+};
+var parseExistingProjectPackage = (raw) => {
+	const parsed = JSON.parse(raw);
+	if (!isRecord$1(parsed)) return {};
+	const createTemplateProject = isRecord$1(parsed["create-template-project"]) ? parsed["create-template-project"] : void 0;
+	const template = createTemplateProject ? createTemplateProject.template : void 0;
+	return {
+		...parsed,
+		scripts: parseStringRecord(parsed.scripts),
+		dependencies: parseStringRecord(parsed.dependencies),
+		devDependencies: parseStringRecord(parsed.devDependencies),
+		"create-template-project": typeof template === "string" && isTemplateType(template) ? { template } : void 0
+	};
+};
+var parseTemplatePackageJson = (raw) => {
+	const parsed = JSON.parse(raw);
+	if (!isRecord$1(parsed)) return {};
+	return {
+		...parsed,
+		dependencies: parseStringRecord(parsed.dependencies),
+		devDependencies: parseStringRecord(parsed.devDependencies)
+	};
+};
+var toErrorDetail = (error) => {
+	if (error instanceof Error) {
+		const withOutput = error;
+		const stdout = withOutput.stdout ?? "";
+		const stderr = withOutput.stderr ?? "";
+		const detail = stdout.length > 0 || stderr.length > 0 ? `\n\nOutput:\n${stdout}\n${stderr}` : "";
+		return {
+			message: error.message,
+			detail
+		};
+	}
+	return {
+		message: String(error),
+		detail: ""
+	};
+};
 var generateProject = async (opts) => {
 	const { template: type, projectName, author, githubUsername, directory, update, progress } = opts;
-	const isProgress = progress !== false;
+	const isProgress = progress;
 	const log = getLog(isProgress);
 	const spinner = () => getSpinner(isProgress);
 	const projectDir = directory;
 	debug$1("Project generation started for: %s", projectName);
 	debug$1("Options: %O", opts);
 	debug$1("Project directory: %s", projectDir);
-	let isUpdate = !!update;
-	if (await pathExists(projectDir)) {
-		if (!isUpdate) throw new Error(`Directory "${projectDir}" already exists. Use the "update" command to update.`);
-	}
-	const templates = [getBaseTemplate(opts)];
+	const isUpdate = update;
+	if (await pathExists(projectDir) && !isUpdate) throw new Error(`Directory "${projectDir}" already exists. Use the "update" command to update.`);
 	debug$1("Applying template: base");
-	switch (type) {
-		case "cli":
-			debug$1("Applying template: cli");
-			templates.push(getCliTemplate(opts));
-			break;
-		case "web-vanilla":
-			debug$1("Applying template: web-vanilla");
-			templates.push(getWebVanillaTemplate(opts));
-			break;
-		case "web-app":
-			debug$1("Applying template: web-app");
-			templates.push(getWebAppTemplate(opts));
-			break;
-		case "web-fullstack":
-			debug$1("Applying template: web-fullstack");
-			templates.push(getWebFullstackTemplate(opts));
-			break;
-	}
+	debug$1("Applying template: %s", type);
+	const templates = getProjectTemplates(opts);
 	debug$1("Ensuring directory exists: %s", projectDir);
 	await fs.mkdir(projectDir, { recursive: true });
 	debug$1("Loading dependency configuration");
 	const depConfigPath = await getDependencyConfigPath();
-	const depConfig = JSON.parse(await fs.readFile(depConfigPath, "utf8"));
+	const depConfig = parseDependencyConfig(await fs.readFile(depConfigPath, "utf8"));
 	const addedDeps = [];
 	const resolveDeps = (deps = {}) => {
-		for (const dep of Object.keys(deps)) {
+		for (const dep of Object.keys(deps)) if (Object.hasOwn(depConfig.dependencies, dep)) {
 			const config = depConfig.dependencies[dep];
-			if (config) {
-				deps[dep] = config.version;
-				addedDeps.push({
-					name: dep,
-					description: config.description
-				});
-			} else {
-				log.warn(`Dependency "${dep}" not found in central configuration. Using empty version.`);
-				debug$1(`Dependency "${dep}" missing in config`);
-			}
+			deps[dep] = config.version;
+			addedDeps.push({
+				name: dep,
+				description: config.description
+			});
+		} else {
+			log.warn(`Dependency "${dep}" not found in central configuration. Using empty version.`);
+			debug$1(`Dependency "${dep}" missing in config`);
 		}
 	};
 	let finalPkg = {
 		name: projectName,
 		version: "0.1.0",
 		private: true,
-		description: opts.description || "TODO: Add project description",
-		keywords: opts.keywords ? opts.keywords.split(",").map((k) => k.trim()) : ["TODO: Add keywords"],
+		description: opts.description ?? "TODO: Add project description",
+		keywords: opts.keywords !== void 0 ? opts.keywords.split(",").map((k) => k.trim()) : ["TODO: Add keywords"],
 		homepage: `https://github.com/${githubUsername}/${projectName}#readme`,
 		bugs: { url: `https://github.com/${githubUsername}/${projectName}/issues` },
 		license: "MIT",
-		author: author || "",
+		author,
 		repository: {
 			type: "git",
 			url: `https://github.com/${githubUsername}/${projectName}.git`
@@ -1029,22 +1191,28 @@ var generateProject = async (opts) => {
 	const pkgPath = path.join(projectDir, "package.json");
 	if (isUpdate && await pathExists(pkgPath)) {
 		debug$1("Loading existing package.json for update");
-		const existingPkg = JSON.parse(await fs.readFile(pkgPath, "utf8"));
-		if (!existingPkg["create-template-project"]?.template) throw new Error(`No "create-template-project" configuration found in ${pkgPath}. The update command can only be used on projects created with this tool.`);
+		const existingPkg = parseExistingProjectPackage(await fs.readFile(pkgPath, "utf8"));
+		if (!existingPkg["create-template-project"]) throw new Error(`No "create-template-project" configuration found in ${pkgPath}. The update command can only be used on projects created with this tool.`);
 		finalPkg = {
 			...finalPkg,
-			...existingPkg
-		};
-		finalPkg["create-template-project"] = {
-			...existingPkg["create-template-project"],
-			template: type
+			...existingPkg,
+			"create-template-project": {
+				...existingPkg["create-template-project"],
+				template: type
+			},
+			scripts: { ...existingPkg.scripts },
+			dependencies: { ...existingPkg.dependencies },
+			devDependencies: { ...existingPkg.devDependencies }
 		};
-		finalPkg.scripts = { ...existingPkg.scripts };
-		finalPkg.dependencies = { ...existingPkg.dependencies };
-		finalPkg.devDependencies = { ...existingPkg.devDependencies };
 		debug$1("Loaded existing package.json: %O", finalPkg);
 	}
-	for (const t of templates) {
+	const templatePackageParts = await Promise.all(templates.map(async (template) => {
+		if (template.templateDir === void 0) return;
+		const templatePkgPath = path.join(template.templateDir, "package.json");
+		if (!await pathExists(templatePkgPath)) return;
+		return parseTemplatePackageJson(await fs.readFile(templatePkgPath, "utf8"));
+	}));
+	for (const [index, t] of templates.entries()) {
 		debug$1("Collecting dependencies and scripts from template: %s", t.name);
 		const templateDeps = { ...t.dependencies };
 		const templateDevDeps = { ...t.devDependencies };
@@ -1053,22 +1221,19 @@ var generateProject = async (opts) => {
 		Object.assign(finalPkg.scripts, t.scripts);
 		Object.assign(finalPkg.dependencies, templateDeps);
 		Object.assign(finalPkg.devDependencies, templateDevDeps);
-		if (t.workspaces) finalPkg.workspaces = t.workspaces;
-		if (t.templateDir) {
-			const templatePkgPath = path.join(t.templateDir, "package.json");
-			if (await pathExists(templatePkgPath)) {
-				const pkgPart = JSON.parse(await fs.readFile(templatePkgPath, "utf8"));
-				resolveDeps(pkgPart.dependencies);
-				resolveDeps(pkgPart.devDependencies);
-				mergePackageJson(finalPkg, pkgPart);
-			}
+		if (t.workspaces !== void 0) finalPkg.workspaces = t.workspaces;
+		const pkgPart = templatePackageParts[index];
+		if (pkgPart !== void 0) {
+			resolveDeps(pkgPart.dependencies);
+			resolveDeps(pkgPart.devDependencies);
+			mergePackageJson(finalPkg, pkgPart);
 		}
 	}
 	const actions = [];
 	const pendingOperations = [];
 	for (const t of templates) {
 		debug$1("Collecting template files for: %s", t.name);
-		if (t.templateDir) {
+		if (t.templateDir !== void 0) {
 			debug$1("Reading physical files from: %s", t.templateDir);
 			const files = await getAllFiles(t.templateDir);
 			for (const file of files) {
@@ -1096,7 +1261,7 @@ var generateProject = async (opts) => {
 					continue;
 				}
 				if (relativePath.startsWith("_") && relativePath.endsWith(".config.ts")) {
-					relativePath = relativePath.substring(1);
+					relativePath = relativePath.slice(1);
 					targetPath = path.join(projectDir, relativePath);
 				}
 				if (relativePath === "package.json") continue;
@@ -1214,7 +1379,7 @@ var generateProject = async (opts) => {
 			}
 		}
 	}
-	const pm = opts.packageManager || "npm";
+	const pm = opts.packageManager;
 	if (pm !== "npm") {
 		for (const [key, value] of Object.entries(finalPkg.scripts)) if (typeof value === "string") finalPkg.scripts[key] = value.replaceAll("npm run ", `${pm} run `);
 	}
@@ -1275,7 +1440,10 @@ var generateProject = async (opts) => {
 			}
 		} else log.info("No changes detected.");
 	}
-	for (const op of pendingOperations) await op();
+	await pendingOperations.reduce(async (previous, operation) => {
+		await previous;
+		await operation();
+	}, Promise.resolve());
 	const states = {
 		gitInitialized: false,
 		githubCreated: false,
@@ -1298,10 +1466,10 @@ var generateProject = async (opts) => {
 			});
 			log.success("Initialized Git repository (main branch).");
 			states.gitInitialized = true;
-		} catch (e) {
-			debug$1("Failed to initialize Git: %O", e);
-			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
-			log.error(`Failed to initialize Git: ${e.message}${detail}`);
+		} catch (error) {
+			debug$1("Failed to initialize Git: %O", error);
+			const { message, detail } = toErrorDetail(error);
+			log.error(`Failed to initialize Git: ${message}${detail}`);
 		}
 	} else states.gitInitialized = true;
 	if (opts.build) {
@@ -1317,12 +1485,12 @@ var generateProject = async (opts) => {
 			});
 			s.stop(`\x1b[1G\x1b[2K\x1b[32m◆\x1b[39m  Dependencies installed (${pm} install).`);
 			states.depsInstalled = true;
-		} catch (e) {
-			debug$1("Failed to install dependencies: %O", e);
+		} catch (error) {
+			debug$1("Failed to install dependencies: %O", error);
 			s.stop("Failed to install dependencies.");
-			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
-			log.error(`${e.message}${detail}`);
-			throw new Error(`Failed to install dependencies: ${e.message}${detail}`);
+			const { message, detail } = toErrorDetail(error);
+			log.error(`${message}${detail}`);
+			throw new Error(`Failed to install dependencies: ${message}${detail}`, { cause: error });
 		}
 	}
 	if (opts.build && finalPkg.scripts.ci) {
@@ -1338,11 +1506,11 @@ var generateProject = async (opts) => {
 					preferLocal: true
 				});
 				s.stop(`\x1b[1G\x1b[2K\x1b[32m◆\x1b[39m  Files formatted (${pm} run format).`);
-			} catch (e) {
-				debug$1("Failed to format files: %O", e);
+			} catch (error) {
+				debug$1("Failed to format files: %O", error);
 				s.stop("Failed to format files.");
-				const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
-				log.error(`${e.message}${detail}`);
+				const { message, detail } = toErrorDetail(error);
+				log.error(`${message}${detail}`);
 			}
 		}
 		s.start(`Running CI script (lint, build, test) (${pm} run ci)...`);
@@ -1355,12 +1523,12 @@ var generateProject = async (opts) => {
 			});
 			s.stop(`\x1b[1G\x1b[2K\x1b[32m◆\x1b[39m  CI script completed (${pm} run ci).`);
 			states.ciRun = true;
-		} catch (e) {
-			debug$1("Failed to run CI script: %O", e);
+		} catch (error) {
+			debug$1("Failed to run CI script: %O", error);
 			s.stop("Failed to run CI script.");
-			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
-			log.error(`${e.message}${detail}`);
-			throw new Error(`Failed to run CI script: ${e.message}${detail}`);
+			const { message, detail } = toErrorDetail(error);
+			log.error(`${message}${detail}`);
+			throw new Error(`Failed to run CI script: ${message}${detail}`, { cause: error });
 		}
 	}
 	if (opts.createGithubRepository && !isUpdate) {
@@ -1400,32 +1568,38 @@ var generateProject = async (opts) => {
 			});
 			s.stop(`\x1b[1G\x1b[2K\x1b[32m◆\x1b[39m  Created GitHub repository and pushed initial commit.`);
 			states.githubCreated = true;
-		} catch (e) {
-			debug$1("Failed to create/push GitHub repository: %O", e);
+		} catch (error) {
+			debug$1("Failed to create/push GitHub repository: %O", error);
 			s.stop("Failed to create/push GitHub repository.");
-			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
-			log.warn(`Failed to create/push GitHub repository: ${e.message}${detail}\nEnsure "gh" CLI is installed and authenticated.`);
-			states.githubError = e.message;
+			const { message, detail } = toErrorDetail(error);
+			log.warn(`Failed to create/push GitHub repository: ${message}${detail}\nEnsure "gh" CLI is installed and authenticated.`);
+			states.githubError = message;
 		}
 	}
-	let hasErrors = false;
 	let hasWarnings = false;
 	const errorMessages = [];
 	if (states.githubError) {
 		hasWarnings = true;
 		errorMessages.push(`GitHub repository creation failed: ${states.githubError}`);
 	}
+	const hasErrors = errorMessages.some((message) => message.startsWith("ERROR:"));
 	await generateGeneratedMd(projectDir, opts, pm, states, isUpdate, {
 		hasErrors,
 		hasWarnings,
 		errorMessages
 	}, actions);
 	const successMsg = `Project "${projectName}" ${isUpdate ? "updated" : "scaffolded"} successfully in ${projectDir}. A detailed setup guide has been generated at GENERATED.md`;
-	if (hasWarnings) log.warn(`${successMsg} (completed with warnings)`);
+	if (hasErrors) log.error(`${successMsg} (completed with errors)`);
+	else if (hasWarnings) log.warn(`${successMsg} (completed with warnings)`);
 	else log.success(successMsg);
 };
-async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, status, actions) {
+generateGeneratedMd = async (projectDir, opts, pm, states, isUpdate, status, actions) => {
 	const statusBadge = status.hasErrors ? "🔴 **Completed with Errors**" : status.hasWarnings ? "🟡 **Completed with Warnings**" : "🟢 **Successfully Completed**";
+	const skippedStepInstructions = [
+		...states.depsSkipped ? [`- [ ] **Install dependencies manually:** Run \`${pm} install\` from the project root.`] : [],
+		...states.githubSkipped ? [`- [ ] **Create and push GitHub repository manually:** Verify GitHub CLI auth with \`gh auth status\`, then run \`gh repo create ${opts.projectName} --public --source=. --remote=origin --push\`.`] : [],
+		...states.ciSkipped ? [`- [ ] **Run CI checks manually:** After dependencies are installed, run \`${pm} run ci\`.`] : []
+	];
 	const md = [
 		`# 🚀 Project Setup Guide: ${opts.projectName}`,
 		"",
@@ -1454,6 +1628,12 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 		`- [${states.githubCreated ? "x" : " "}] Create and push GitHub repository${states.githubSkipped ? " *(Skipped)*" : states.githubError ? " *(Failed)*" : ""}`,
 		`- [${states.ciRun ? "x" : " "}] Run initial CI pipeline (lint, build, test)${states.ciSkipped ? " *(Skipped)*" : ""}`,
 		"",
+		...skippedStepInstructions.length > 0 ? [
+			"## ⏭️ Complete Skipped Steps Manually",
+			"Some initialization steps were marked as *(Skipped)*. Use the guidance below to complete them yourself:",
+			...skippedStepInstructions,
+			""
+		] : [],
 		...isUpdate ? [
 			"### 🛠️ Upgrade Details",
 			"The following files were affected by this update:",
@@ -1468,8 +1648,8 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 					CONFLICT: "🔥 CONFLICT",
 					DELETE: "🗑️ DELETE",
 					UPDATED: "✨ UPDATED"
-				}[a.type] || a.type;
-				return `| \`${a.path}\` | ${actionIcon} | ${a.reason || "-"} | ${a.recommendedAction || (a.type === "CONFLICT" ? "**Resolve conflicts**" : "Review changes")} |`;
+				}[a.type] ?? a.type;
+				return `| \`${a.path}\` | ${actionIcon} | ${a.reason ?? "-"} | ${a.recommendedAction ?? (a.type === "CONFLICT" ? "**Resolve conflicts**" : "Review changes")} |`;
 			}),
 			""
 		] : [],
@@ -1544,6 +1724,7 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 		"| Command | Description |",
 		"| :--- | :--- |",
 		"| `gh repo view --web` | Open the repository in your default web browser |",
+		"| `gh repo create <name> --public --source=. --remote=origin --push` | Create and push a new GitHub repository |",
 		"| `gh pr create` | Create a new Pull Request |",
 		"| `gh pr checkout <pr-number>` | Checkout a Pull Request branch locally |",
 		"| `gh issue create` | Create a new Issue |",
@@ -1566,8 +1747,8 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 		"<p align=\"center\"><i>This file was auto-generated by <b>create-template-project</b>.</i></p>"
 	].join("\n");
 	await fs.writeFile(path.join(projectDir, "GENERATED.md"), md);
-}
-function getTemplateArchitectureSection(template) {
+};
+getTemplateArchitectureSection = (template) => {
 	switch (template) {
 		case "cli": return [
 			"## 🏗️ CLI Architecture",
@@ -1622,21 +1803,33 @@ function getTemplateArchitectureSection(template) {
 		];
 		default: return [];
 	}
-}
+};
 //#endregion
 //#region src/index.ts
 if (process.argv.includes("--debug")) {
-	process.env["DEBUG"] = "create-template-project:*";
+	process.env.DEBUG = "create-template-project:*";
 	debugLib.enable("create-template-project:*");
 }
 var debug = debugLib("create-template-project:main");
+var isRecord = (value) => typeof value === "object" && value !== null;
+var getErrorCode = (error) => {
+	if (!isRecord(error)) return;
+	const { code } = error;
+	return typeof code === "string" ? code : void 0;
+};
+var getErrorMessage = (error) => {
+	if (isRecord(error)) {
+		const { message } = error;
+		if (typeof message === "string") return message;
+	}
+	return String(error);
+};
 var main = async () => {
 	try {
 		debug("Starting CLI execution");
 		debug("Parsing arguments");
 		const options = await parseArgs();
-		if (!options) return;
-		const isProgress = options.progress !== false;
+		const isProgress = options.progress;
 		if (isProgress) intro("create-template-project");
 		debug("Arguments parsed: %O", options);
 		debug("Generating project");
@@ -1645,12 +1838,13 @@ var main = async () => {
 		if (isProgress) outro("Done!");
 	} catch (error) {
 		debug("Execution failed: %O", error);
-		if (error.code === "PROCESS_EXIT_0" || error.code === "commander.helpDisplayed" || error.code === "commander.version") process.exit(0);
-		if (error.code === "PROCESS_EXIT_1") process.exit(1);
-		cancel(error?.message || String(error));
+		const errorCode = getErrorCode(error);
+		if (errorCode === "PROCESS_EXIT_0" || errorCode === "commander.helpDisplayed" || errorCode === "commander.version") process.exit(0);
+		if (errorCode === "PROCESS_EXIT_1") process.exit(1);
+		cancel(getErrorMessage(error));
 		process.exit(1);
 	}
 };
-if (import.meta.url.endsWith("src/index.ts") || import.meta.url.endsWith("dist/index.js")) await main();
+if (process.env.NODE_ENV !== "test" && (import.meta.url.endsWith("src/index.ts") || import.meta.url.endsWith("dist/index.js"))) await main();
 //#endregion
 export { main };