@adbayb/stack 2.39.0-next-b0fcf5b → 2.39.0

package/dist/index.js

@@ -1,8 +1,9 @@
 import { helpers, termost } from "termost";
 import { createRequire } from "node:module";
-import { basename, join, resolve } from "node:path";
-import { existsSync, readdirSync } from "node:fs";
-import { chmod, cp, mkdir, readFile, readdir, rename, rm, symlink, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { cpSync, existsSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
+import { chmod, mkdir, rm, symlink, writeFile } from "node:fs/promises";
+import { fdir } from "fdir";
 
 //#region src/helpers.ts
 const require = createRequire(import.meta.url);
@@ -48,20 +49,20 @@ ${input.body}
 * @param path - The relative path.
 * @returns The resolved absolute path.
 * @example
-* resolveFromWorkingDirectory(".gitignore");
+* resolveFromProjectDirectory(".gitignore");
 */
-const resolveFromWorkingDirectory = (...path) => {
-	return resolve(process.cwd(), ...path);
+const resolveFromProjectDirectory = (path) => {
+	return resolve(process.cwd(), path);
 };
 /**
 * Resolve a relative path to an absolute one resolved from the `stack` node module directory.
 * @param path - The relative path.
 * @returns The resolved absolute path.
 * @example
-* resolveFromPackageDirectory("./templates");
+* resolveFromStackDirectory("./templates");
 */
-const resolveFromPackageDirectory = (...path) => {
-	return resolve(import.meta.dirname, "../", ...path);
+const resolveFromStackDirectory = (path) => {
+	return resolve(import.meta.dirname, "../", path);
 };
 const createError = (bin, error) => {
 	const errorMessage = `\`${bin}\` command failed.\n${String(error)}`;
@@ -71,7 +72,7 @@ const createError = (bin, error) => {
 	}
 	return new Error(errorMessage);
 };
-const getPnpmVersion = async () => {
+const getNpmVersion = async () => {
 	try {
 		return await helpers.exec("pnpm -v");
 	} catch {
@@ -89,7 +90,7 @@ const setPackageManager = async () => {
 	* Corepack is downloaded remotely to get always up-to-date npm registry fingerprints since they're hardcoded.
 	* @see {@link https://github.com/nodejs/corepack/issues/613}
 	*/
-	return helpers.exec("pnx corepack enable");
+	return helpers.exec("npx corepack enable");
 };
 const request = { async get(url, responseType) {
 	const response = await fetch(url);
@@ -111,7 +112,7 @@ const eslint = (options) => async (files = []) => {
 	const arguments_ = [
 		...eslintFiles,
 		"--cache",
-		`--cache-location ${resolveFromWorkingDirectory("node_modules/.cache/.eslintcache")}`,
+		`--cache-location ${resolveFromProjectDirectory("node_modules/.cache/.eslintcache")}`,
 		"--no-error-on-unmatched-pattern"
 	];
 	if (options.isFixMode) arguments_.push("--fix");
@@ -381,7 +382,7 @@ const createCleanCommand = (program) => {
 		async handler() {
 			const cachePath = "node_modules/.cache";
 			const files = await retrieveIgnoredFiles();
-			if (isDirectoryExistAndNotEmpty(resolveFromWorkingDirectory(cachePath))) files.push(cachePath);
+			if (isDirectoryExistAndNotEmpty(resolveFromProjectDirectory(cachePath))) files.push(cachePath);
 			return files;
 		},
 		key: "files",
@@ -427,7 +428,7 @@ const PRESERVE_FILES = ["node_modules"];
 
 //#endregion
 //#region package.json
-var version = "2.39.0-next-b0fcf5b";
+var version = "2.39.0";
 
 //#endregion
 //#region src/commands/create.ts
@@ -438,12 +439,12 @@ const createCreateCommand = (program) => {
 	}).task({ handler() {
 		botMessage({
 			description: "I can guarantee you a project creation in under 1 minute 🚀",
-			title: `I'm Stack v${version} 👋`,
+			title: `I'm Stack v${version}, your bot assistant`,
 			type: "information"
 		});
 	} }).task({
 		async handler() {
-			await getPnpmVersion();
+			await getNpmVersion();
 		},
 		label: label$2("Check pre-requisites")
 	}).input({
@@ -466,92 +467,61 @@ const createCreateCommand = (program) => {
 		options: ["single-project", "multi-projects"],
 		type: "select"
 	}).task({
-		async handler({ inputDescription, inputName, inputTemplate, inputUrl }) {
+		async handler({ inputDescription, inputName, inputUrl }) {
 			if (!inputName) throw createError("stack create", "The project name is not optional. Make sure to provide a valid value (non-empty string).");
 			const { repoName, repoOwner } = (inputUrl.startsWith("git") ? /^git@.*:(?<repoOwner>.*)\/(?<repoName>.*)\.git$/ : /^https?:\/\/.*\/(?<repoOwner>.*)\/(?<repoName>.*)\.git$/).exec(inputUrl)?.groups ?? {};
 			if (!repoOwner || !repoName) throw createError("git", "The owner and repository name can not be extracted. Please make sure to follow either `/^git@.*:(?<repoOwner>.*)/(?<repoName>.*).git$/` or `/^https?://.*/(?<repoOwner>.*)/(?<repoName>.*).git$/` pattern.");
 			const nodeVersion = await request.get("https://resolve-node.vercel.app/lts", "text");
-			const { version: pnpmVersion } = await request.get("https://registry.npmjs.org/pnpm/latest", "json");
-			const projectName = slugify(inputName);
+			const { version: npmVersion } = await request.get("https://registry.npmjs.org/pnpm/latest", "json");
 			return {
 				licenseYear: (/* @__PURE__ */ new Date()).getFullYear().toString(),
 				nodeVersion: nodeVersion.replace("v", ""),
-				pnpmVersion: String(pnpmVersion),
-				projectDescription: toCapitalLetter(inputDescription),
-				projectName,
+				npmVersion: String(npmVersion),
+				projectDescription: inputDescription.charAt(0).toUpperCase() + inputDescription.slice(1),
+				projectName: inputName.toLowerCase(),
 				projectUrl: inputUrl,
-				repoId: `${repoOwner}/${repoName}`,
-				templatePath: resolveFromPackageDirectory("templates", inputTemplate),
-				workingPath: resolveFromWorkingDirectory(projectName)
+				repoId: `${repoOwner}/${repoName}`
 			};
 		},
 		key: "data",
 		label: label$2("Check and format input")
-	}).input({
-		defaultValue: true,
-		key: "canRemoveExistingDirectoryInput",
-		label({ data: { projectName } }) {
-			return label$2(`\`${projectName}\` directory already exists, do you want to remove it?`);
-		},
-		skip({ data: { workingPath } }) {
-			return !existsSync(workingPath);
+	}).task({
+		async handler({ data }) {
+			const projectPath = resolve(process.cwd(), data.projectName);
+			await mkdir(projectPath);
+			process.chdir(projectPath);
 		},
-		type: "confirm",
-		validate({ canRemoveExistingDirectoryInput, data: { projectName } }) {
-			if (canRemoveExistingDirectoryInput) return;
-			return createError("mkdir", `Remove or rename the \`${projectName}\` existing directory to apply the template from a clean state.`);
+		label({ data }) {
+			return label$2(`Create \`${data.projectName}\` folder`);
 		}
 	}).task({
-		async handler({ canRemoveExistingDirectoryInput, data: { licenseYear, nodeVersion, pnpmVersion, projectDescription, projectName, projectUrl, repoId, templatePath, workingPath }, inputTemplate }) {
-			if (canRemoveExistingDirectoryInput) await rm(workingPath, {
-				force: true,
-				recursive: true
-			});
-			return createTemplateEngine(workingPath, {
-				projectName,
-				templateModel: {
-					licenseYear,
-					nodeVersion,
-					pnpmVersion,
-					projectDescription,
-					projectName,
-					projectUrl,
-					repoId
-				},
-				templateName: inputTemplate,
-				templatePath
-			});
+		async handler({ data }) {
+			await helpers.exec("git init");
+			await helpers.exec(`git remote add origin ${data.projectUrl}`);
 		},
-		key: "templateEngine",
-		label({ data: { projectName }, inputTemplate }) {
-			return label$2(`Copy \`${inputTemplate}\` template to \`${projectName}\` directory`);
-		}
+		label: label$2("Initialize `git`")
 	}).task({
-		async handler({ templateEngine }) {
-			await templateEngine.processContents();
-			await templateEngine.processPaths();
+		handler({ data, inputTemplate }) {
+			applyTemplate(inputTemplate, data);
 		},
-		label() {
-			return label$2("Process template");
-		}
+		label: label$2("Apply template")
 	}).task({
-		async handler({ data: { projectUrl } }) {
-			await helpers.exec("git init");
-			await helpers.exec(`git remote add origin ${projectUrl}`);
+		async handler({ data: { projectName }, inputTemplate }) {
+			await symlink(join(inputTemplate === "single-project" ? projectName : join("libraries", projectName), "README.md"), "./README.md");
 		},
-		label: label$2("Initialize `git`")
+		label: label$2("Create a symlink to `README.md` file")
 	}).task({
 		async handler() {
 			await setPackageManager();
 		},
 		label: label$2("Set up the package manager")
 	}).task({
-		async handler({ data: { projectName } }) {
+		async handler({ data }) {
 			const localDevelopmentDependencies = ["quickbundle", "vitest"];
 			const globalDevelopmentDependencies = ["@adbayb/stack"];
 			try {
 				await helpers.exec(`pnpm add ${globalDevelopmentDependencies.join(" ")} --save-dev --ignore-workspace-root-check`);
-				await helpers.exec(`pnpm add ${localDevelopmentDependencies.join(" ")} --save-dev --filter ${projectName}`);
+				await helpers.exec(`pnpm add ${localDevelopmentDependencies.join(" ")} --save-dev --filter ${data.projectName}`);
 				await helpers.exec("pnpm install");
 			} catch (error) {
 				throw createError("pnpm", error);
@@ -569,95 +539,53 @@ const createCreateCommand = (program) => {
 			await helpers.exec("git commit -m \"chore: initial commit\"");
 		},
 		label: label$2("Commit")
-	}).task({ handler({ data: { projectName } }) {
+	}).task({ handler({ data }) {
 		botMessage({
-			description: `Run \`cd ./${projectName}\` and Enjoy 🚀`,
+			description: `Run \`cd ./${data.projectName}\` and Enjoy 🚀`,
 			title: "The project was successfully created",
 			type: "success"
 		});
 	} });
 };
 const label$2 = (message) => `${message} 🔨`;
-const slugify = (input) => {
-	return input.toLowerCase().replaceAll(/[^a-z0-9\s-]/g, "").trim().replaceAll(/\s+/g, "-").replaceAll(/-+/g, "-");
-};
-const toCapitalLetter = (input) => {
-	return input.charAt(0).toUpperCase() + input.slice(1);
-};
-const createTemplateEngine = async (workingPath, { projectName, templateModel, templateName, templatePath }) => {
-	if (!existsSync(workingPath)) await mkdir(workingPath);
-	await cp(templatePath, workingPath, {
+/**
+* A simple template engine to evaluate dynamic expressions and apply side effets (such as hydrating a content with values from an input object) on impacted template files.
+* @param template - The selected template.
+* @param dataModel - Data model mapping the template expression key with its corresponding value.
+* @example
+* applyTemplate(
+* 	{ toReplace: "value" },
+* );
+*/
+const applyTemplate = (template, dataModel) => {
+	const templateExtension = ".tmpl";
+	const templateRootPath = resolveFromStackDirectory(join("./templates", template));
+	const projectRootPath = resolveFromProjectDirectory("./");
+	const templateExpressionRegExp = /{{(.*?)}}/g;
+	const evaluate = (content) => {
+		return content.replaceAll(templateExpressionRegExp, (_, key) => dataModel[key] || "");
+	};
+	/** Copy the template before mutations. */
+	cpSync(templateRootPath, projectRootPath, {
 		force: true,
 		recursive: true
 	});
-	const gitignoreFile = join(workingPath, ".gitignore.tmpl");
-	if (existsSync(gitignoreFile)) await rename(gitignoreFile, join(workingPath, ".gitignore"));
-	const eslintConfigFile = join(workingPath, "eslint.config.js.tmpl");
-	if (existsSync(eslintConfigFile)) await rename(eslintConfigFile, join(workingPath, "eslint.config.js"));
-	const templateEntries = await getTemplateEntries(workingPath);
-	process.chdir(workingPath);
-	return {
-		async processContents() {
-			await Promise.all(templateEntries.filter(({ type }) => type === "content").map(async (entry) => {
-				return writeFile(entry.path, setTemplateVariables(entry, templateModel));
-			}));
-		},
-		async processPaths() {
-			const sortedDirectoryEntries = templateEntries.filter(({ content, type }) => {
-				if (type === "path.directory" || type === "path.file") return hasTemplateVariable(basename(content));
-				return false;
-			}).toSorted(({ path: pathA }, { path: pathB }) => pathB.length - pathA.length);
-			for (const entry of sortedDirectoryEntries) {
-				const newPath = setTemplateVariables(entry, templateModel);
-				await rename(entry.path, newPath);
-			}
-			await symlink(join(templateName === "single-project" ? projectName : join("libraries", projectName), "README.md"), "./README.md");
-		}
-	};
-};
-const getTemplateEntries = async (path) => {
-	const entries = await readdir(path, {
-		recursive: true,
-		withFileTypes: true
+	/** Template file mutations. */
+	new fdir().withBasePath().glob(`**/*${templateExtension}`).crawl(projectRootPath).sync().forEach((templateFilePath) => {
+		const projectFilePath = templateFilePath.slice(0, templateFilePath.lastIndexOf(templateExtension));
+		const content = evaluate(readFileSync(templateFilePath, "utf8"));
+		renameSync(templateFilePath, projectFilePath);
+		writeFileSync(projectFilePath, content, "utf8");
 	});
-	return (await Promise.all(entries.map(async (entry) => {
-		const isDirectory = entry.isDirectory();
-		if (!isDirectory && !entry.isFile()) return [];
-		const entryPath = resolve(entry.parentPath, entry.name);
-		return (isDirectory ? [{
-			content: entryPath,
-			type: "path.directory"
-		}] : [{
-			content: entryPath,
-			type: "path.file"
-		}, {
-			content: await readFile(entryPath, "utf8"),
-			type: "content"
-		}]).map(({ content, type }) => {
-			if (!hasTemplateVariable(content)) return void 0;
-			return {
-				content,
-				path: entryPath,
-				type
-			};
-		}).filter((input) => Boolean(input));
-	}))).flat();
-};
-const setTemplateVariables = (entry, model) => {
-	return entry.content.replaceAll(TEMPLATE_VARIABLE_MATCHER, (match, dataModelKey) => {
-		return model[dataModelKey] ?? match;
+	/** Template folder mutations. */
+	new fdir().withBasePath().onlyDirs().filter((path) => {
+		return templateExpressionRegExp.test(path);
+	}).crawl(projectRootPath).sync().toSorted((a, b) => b.length - a.length).forEach((templateFolderPath) => {
+		renameSync(templateFolderPath, templateFolderPath.replaceAll(templateExpressionRegExp, (_, dataModelKey) => {
+			return dataModel[dataModelKey];
+		}));
 	});
 };
-const TEMPLATE_VARIABLE_MATCHER = /* @__PURE__ */ new RegExp(/{{(.*?)}}/g, "gi");
-const hasTemplateVariable = (input) => {
-	/**
-	* TemplateVariableMatcher.test() is not used since the `RegExp` is stateful when the global is used leading to some unstable results
-	* (relying on latest `lastIndex` set (lastIndex specifies the index at which to start the next match)).
-	* String.search is stateless.
-	* @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/test MDN documentation}.
-	*/
-	return input.search(TEMPLATE_VARIABLE_MATCHER) >= 0;
-};
 
 //#endregion
 //#region src/commands/fix/fixFormatting.ts
@@ -672,7 +600,7 @@ const fixFormatting = async (files) => {
 		if (prettierFiles.length === 0) return;
 	}
 	const arguments_ = [...prettierFiles];
-	if (existsSync(resolveFromWorkingDirectory(".gitignore"))) arguments_.push("--ignore-path .gitignore");
+	if (existsSync(resolveFromProjectDirectory(".gitignore"))) arguments_.push("--ignore-path .gitignore");
 	arguments_.push("--write", "--ignore-unknown", "--no-error-on-unmatched-pattern");
 	try {
 		return await helpers.exec(`prettier ${arguments_.join(" ")}`);
@@ -735,7 +663,7 @@ const createInstallCommand = (program) => {
 };
 const label = (message) => `${message} 📲`;
 const installGitHook = async (hook, content) => {
-	const filename = resolveFromWorkingDirectory(`.git/hooks/${hook}`);
+	const filename = resolveFromProjectDirectory(`.git/hooks/${hook}`);
 	await writeFile(filename, content);
 	return chmod(filename, "0755");
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adbayb/stack",
-  "version": "2.39.0-next-b0fcf5b",
+  "version": "2.39.0",
   "description": "My opinionated JavaScript-based toolchain",
   "keywords": [
     "stack",
@@ -59,6 +59,7 @@
     "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-sonarjs": "^4.1.0",
     "eslint-plugin-unicorn": "^68.0.0",
+    "fdir": "^6.5.0",
     "globals": "^17.6.0",
     "prettier": "^3.8.4",
     "prettier-plugin-packagejson": "^3.0.2",

package/templates/multi-projects/.npmrc.tmpl

@@ -0,0 +1 @@
+save-exact=true

package/templates/{single-project/package.json → multi-projects/package.json.tmpl}

@@ -17,13 +17,18 @@
 		"watch": "stack watch"
 	},
 	"prettier": "@adbayb/stack/prettier",
-	"packageManager": "pnpm@{{pnpmVersion}}",
+	"packageManager": "pnpm@{{npmVersion}}",
 	"devEngines": {
-		"packageManager": {
-			"name": "pnpm",
-			"version": "{{pnpmVersion}}",
-			"onFail": "download"
-		},
+		"packageManager": [
+			{
+				"name": "pnpm",
+				"version": "{{npmVersion}}",
+				"onFail": "download"
+			},
+			{
+				"name": "npm"
+			}
+		],
 		"runtime": {
 			"name": "node",
 			"version": ">=24.0.0",

package/templates/multi-projects/{pnpm-workspace.yaml → pnpm-workspace.yaml.tmpl}

@@ -1,6 +1,3 @@
-allowBuilds:
-    esbuild: true
-    unrs-resolver: true
 minimumReleaseAgeExclude:
     - "@adbayb/*"
 packages:
@@ -16,5 +13,3 @@ publicHoistPattern:
     - "*turbo*"
     - "*typescript*"
     - "*types*"
-saveExact: true
-verifyDepsBeforeRun: "warn"

package/templates/single-project/.npmrc.tmpl

@@ -0,0 +1 @@
+save-exact=true

package/templates/{multi-projects/package.json → single-project/package.json.tmpl}

@@ -17,13 +17,18 @@
 		"watch": "stack watch"
 	},
 	"prettier": "@adbayb/stack/prettier",
-	"packageManager": "pnpm@{{pnpmVersion}}",
+	"packageManager": "pnpm@{{npmVersion}}",
 	"devEngines": {
-		"packageManager": {
-			"name": "pnpm",
-			"version": "{{pnpmVersion}}",
-			"onFail": "download"
-		},
+		"packageManager": [
+			{
+				"name": "pnpm",
+				"version": "{{npmVersion}}",
+				"onFail": "download"
+			},
+			{
+				"name": "npm"
+			}
+		],
 		"runtime": {
 			"name": "node",
 			"version": ">=24.0.0",

package/templates/single-project/{pnpm-workspace.yaml → pnpm-workspace.yaml.tmpl}

@@ -1,6 +1,3 @@
-allowBuilds:
-    esbuild: true
-    unrs-resolver: true
 minimumReleaseAgeExclude:
     - "@adbayb/*"
 packages:
@@ -15,5 +12,3 @@ publicHoistPattern:
     - "*turbo*"
     - "*typescript*"
     - "*types*"
-saveExact: true
-verifyDepsBeforeRun: "warn"