@adbayb/stack 2.38.1 → 2.39.0-next-00b7c69

package/configs/eslint/presets/sonar.js

@@ -18,7 +18,6 @@ export const config = createConfig(
 			"sonarjs/bitwise-operators": "error",
 			"sonarjs/bool-param-default": "error",
 			"sonarjs/call-argument-line": "error",
-			"sonarjs/certificate-transparency": "error",
 			"sonarjs/class-name": "error",
 			"sonarjs/class-prototype": "error",
 			"sonarjs/code-eval": "error",

package/configs/eslint/presets/unicorn.js

@@ -17,8 +17,10 @@ export const config = createConfig({
 				name: "error",
 			},
 		],
+		"unicorn/consistent-boolean-name": "error",
 		"unicorn/consistent-class-member-order": "error",
 		"unicorn/consistent-compound-words": "error",
+		"unicorn/consistent-conditional-object-spread": "error",
 		"unicorn/consistent-empty-array-spread": "error",
 		"unicorn/consistent-existence-index-check": "error",
 		"unicorn/consistent-export-decorator-position": "error",
@@ -43,62 +45,103 @@ export const config = createConfig({
 			},
 		],
 		"unicorn/isolated-functions": "error",
+		"unicorn/logical-assignment-operators": "error",
 		"unicorn/max-nested-calls": ["error", { max: 3 }],
+		"unicorn/name-replacements": [
+			"error",
+			{
+				replacements: {
+					application: false,
+					applications: false,
+					prop: false,
+					props: false,
+					ref: false,
+					refs: false,
+					repositories: false,
+					repository: false,
+				},
+			},
+		],
 		"unicorn/new-for-builtins": "error",
 		"unicorn/no-abusive-eslint-disable": "error",
+		"unicorn/no-accidental-bitwise-operator": "error",
 		"unicorn/no-array-callback-reference": "error",
+		"unicorn/no-array-concat-in-loop": "error",
 		"unicorn/no-array-reverse": "error",
 		"unicorn/no-array-sort": "error",
+		"unicorn/no-array-sort-for-min-max": "error",
+		"unicorn/no-array-splice": "error",
 		"unicorn/no-await-expression-member": "error",
 		"unicorn/no-await-in-promise-methods": "error",
+		"unicorn/no-chained-comparison": "error",
 		"unicorn/no-console-spaces": "error",
+		"unicorn/no-constant-zero-expression": "error",
 		"unicorn/no-declarations-before-early-exit": "error",
 		"unicorn/no-document-cookie": "error",
+		"unicorn/no-double-comparison": "error",
+		"unicorn/no-duplicate-if-branches": "error",
+		"unicorn/no-duplicate-logical-operands": "error",
 		"unicorn/no-duplicate-loops": "error",
 		"unicorn/no-empty-file": "error",
 		"unicorn/no-error-property-assignment": "error",
 		"unicorn/no-for-loop": "error",
 		"unicorn/no-immediate-mutation": "error",
+		"unicorn/no-impossible-length-comparison": "error",
 		"unicorn/no-incorrect-template-string-interpolation": "error",
 		"unicorn/no-instanceof-array": "error",
+		"unicorn/no-invalid-character-comparison": "error",
 		"unicorn/no-invalid-fetch-options": "error",
 		"unicorn/no-invalid-remove-event-listener": "error",
 		"unicorn/no-lonely-if": "error",
+		"unicorn/no-loop-iterable-mutation": "error",
 		"unicorn/no-mismatched-map-key": "error",
+		"unicorn/no-misrefactored-assignment": "error",
 		"unicorn/no-negated-array-predicate": "error",
 		"unicorn/no-negated-comparison": "error",
 		"unicorn/no-negated-condition": "error",
 		"unicorn/no-nested-ternary": "error",
 		"unicorn/no-new-buffer": "error",
+		"unicorn/no-non-function-verb-prefix": "error",
 		"unicorn/no-object-as-default-parameter": "error",
 		"unicorn/no-object-methods-with-collections": "error",
 		"unicorn/no-process-exit": "error",
 		"unicorn/no-redundant-comparison": "error",
 		"unicorn/no-return-array-push": "error",
+		"unicorn/no-selector-as-dom-name": "error",
 		"unicorn/no-single-promise-in-promise-methods": "error",
 		"unicorn/no-static-only-class": "error",
 		"unicorn/no-subtraction-comparison": "error",
+		"unicorn/no-top-level-assignment-in-function": "error",
 		"unicorn/no-typeof-undefined": "error",
+		"unicorn/no-uncalled-method": "error",
 		"unicorn/no-unnecessary-array-flat-depth": "error",
 		"unicorn/no-unnecessary-array-splice-count": "error",
+		"unicorn/no-unnecessary-boolean-comparison": "error",
 		"unicorn/no-unnecessary-global-this": "error",
 		"unicorn/no-unnecessary-polyfills": "error",
 		"unicorn/no-unnecessary-slice-end": "error",
 		"unicorn/no-unnecessary-splice": "error",
 		"unicorn/no-unreadable-array-destructuring": "error",
+		"unicorn/no-unreadable-for-of-expression": "error",
 		"unicorn/no-unreadable-iife": "error",
 		"unicorn/no-unreadable-object-destructuring": "error",
 		"unicorn/no-unsafe-buffer-conversion": "error",
 		"unicorn/no-unsafe-string-replacement": "error",
 		"unicorn/no-unused-properties": "error",
 		"unicorn/no-useless-boolean-cast": "error",
+		"unicorn/no-useless-coercion": "error",
 		"unicorn/no-useless-collection-argument": "error",
+		"unicorn/no-useless-compound-assignment": "error",
 		"unicorn/no-useless-concat": "error",
+		"unicorn/no-useless-continue": "error",
+		"unicorn/no-useless-delete-check": "error",
 		"unicorn/no-useless-else": "error",
 		"unicorn/no-useless-error-capture-stack-trace": "error",
 		"unicorn/no-useless-fallback-in-spread": "error",
 		"unicorn/no-useless-iterator-to-array": "error",
 		"unicorn/no-useless-length-check": "error",
+		"unicorn/no-useless-logical-operand": "error",
+		"unicorn/no-useless-override": "error",
 		"unicorn/no-useless-promise-resolve-reject": "error",
 		"unicorn/no-useless-recursion": "error",
 		"unicorn/no-useless-spread": "error",
@@ -106,6 +149,7 @@ export const config = createConfig({
 		"unicorn/no-zero-fractions": "error",
 		"unicorn/number-literal-case": "error",
 		"unicorn/numeric-separators-style": "error",
+		"unicorn/operator-assignment": "error",
 		"unicorn/prefer-add-event-listener": "error",
 		"unicorn/prefer-add-event-listener-options": "error",
 		"unicorn/prefer-array-find": "error",
@@ -113,24 +157,32 @@ export const config = createConfig({
 		"unicorn/prefer-array-flat-map": "error",
 		"unicorn/prefer-array-from-map": "error",
 		"unicorn/prefer-array-index-of": "error",
+		"unicorn/prefer-array-iterable-methods": "error",
+		"unicorn/prefer-array-slice": "error",
 		"unicorn/prefer-array-some": "error",
 		"unicorn/prefer-at": "error",
 		"unicorn/prefer-await": "error",
 		"unicorn/prefer-bigint-literals": "error",
 		"unicorn/prefer-blob-reading-methods": "error",
+		"unicorn/prefer-boolean-return": "error",
 		"unicorn/prefer-class-fields": "error",
 		"unicorn/prefer-classlist-toggle": "error",
 		"unicorn/prefer-code-point": "error",
+		"unicorn/prefer-continue": "error",
 		"unicorn/prefer-date-now": "error",
 		"unicorn/prefer-direct-iteration": "error",
 		"unicorn/prefer-dom-node-append": "error",
 		"unicorn/prefer-dom-node-remove": "error",
 		"unicorn/prefer-dom-node-text-content": "error",
 		"unicorn/prefer-early-return": "error",
+		"unicorn/prefer-else-if": "error",
 		"unicorn/prefer-event-target": "error",
 		"unicorn/prefer-export-from": ["error", { checkUsedVariables: false }],
+		"unicorn/prefer-flat-math-min-max": "error",
 		"unicorn/prefer-global-number-constants": "error",
 		"unicorn/prefer-global-this": "error",
+		"unicorn/prefer-has-check": "error",
+		"unicorn/prefer-hoisting-branch-code": "error",
 		"unicorn/prefer-identifier-import-export-specifiers": "error",
 		"unicorn/prefer-import-meta-properties": "error",
 		"unicorn/prefer-includes": "error",
@@ -138,6 +190,8 @@ export const config = createConfig({
 		"unicorn/prefer-keyboard-event-key": "error",
 		"unicorn/prefer-location-assign": "error",
 		"unicorn/prefer-logical-operator-over-ternary": "error",
+		"unicorn/prefer-map-from-entries": "error",
+		"unicorn/prefer-math-constants": "error",
 		"unicorn/prefer-math-min-max": "error",
 		"unicorn/prefer-math-trunc": "error",
 		"unicorn/prefer-minimal-ternary": "error",
@@ -159,6 +213,7 @@ export const config = createConfig({
 		"unicorn/prefer-prototype-methods": "error",
 		"unicorn/prefer-query-selector": "error",
 		"unicorn/prefer-reflect-apply": "error",
+		"unicorn/prefer-regexp-escape": "error",
 		"unicorn/prefer-regexp-test": "error",
 		"unicorn/prefer-response-static-json": "error",
 		"unicorn/prefer-scoped-selector": "error",
@@ -169,6 +224,7 @@ export const config = createConfig({
 		"unicorn/prefer-single-array-predicate": "error",
 		"unicorn/prefer-single-call": "error",
 		"unicorn/prefer-single-object-destructuring": "error",
+		"unicorn/prefer-single-replace": "error",
 		"unicorn/prefer-smaller-scope": "error",
 		"unicorn/prefer-spread": "error",
 		"unicorn/prefer-string-raw": "error",
@@ -182,14 +238,10 @@ export const config = createConfig({
 		"unicorn/prefer-top-level-await": "error",
 		"unicorn/prefer-type-error": "error",
 		"unicorn/prefer-uint8array-base64": "error",
+		"unicorn/prefer-unary-minus": "error",
 		"unicorn/prefer-unicode-code-point-escapes": "error",
 		"unicorn/prefer-url-href": "error",
-		"unicorn/prevent-abbreviations": [
-			"error",
-			{
-				ignore: [/^props/i, /props$/i, /^ref/i, /ref$/i],
-			},
-		],
+		"unicorn/prefer-while-loop-condition": "error",
 		"unicorn/relative-url-style": ["error", "always"],
 		"unicorn/require-array-join-separator": "error",
 		"unicorn/require-array-sort-compare": "error",

package/dist/index.js

@@ -1,9 +1,8 @@
 import { helpers, termost } from "termost";
 import { createRequire } from "node:module";
-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";
+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";
 
 //#region src/helpers.ts
 const require = createRequire(import.meta.url);
@@ -49,20 +48,20 @@ ${input.body}
 * @param path - The relative path.
 * @returns The resolved absolute path.
 * @example
-* resolveFromProjectDirectory(".gitignore");
+* resolveFromWorkingDirectory(".gitignore");
 */
-const resolveFromProjectDirectory = (path) => {
-	return resolve(process.cwd(), path);
+const resolveFromWorkingDirectory = (...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
-* resolveFromStackDirectory("./templates");
+* resolveFromPackageDirectory("./templates");
 */
-const resolveFromStackDirectory = (path) => {
-	return resolve(import.meta.dirname, "../", path);
+const resolveFromPackageDirectory = (...path) => {
+	return resolve(import.meta.dirname, "../", ...path);
 };
 const createError = (bin, error) => {
 	const errorMessage = `\`${bin}\` command failed.\n${String(error)}`;
@@ -72,7 +71,7 @@ const createError = (bin, error) => {
 	}
 	return new Error(errorMessage);
 };
-const getNpmVersion = async () => {
+const getPnpmVersion = async () => {
 	try {
 		return await helpers.exec("pnpm -v");
 	} catch {
@@ -112,7 +111,7 @@ const eslint = (options) => async (files = []) => {
 	const arguments_ = [
 		...eslintFiles,
 		"--cache",
-		`--cache-location ${resolveFromProjectDirectory("node_modules/.cache/.eslintcache")}`,
+		`--cache-location ${resolveFromWorkingDirectory("node_modules/.cache/.eslintcache")}`,
 		"--no-error-on-unmatched-pattern"
 	];
 	if (options.isFixMode) arguments_.push("--fix");
@@ -260,14 +259,14 @@ const createPackagesVersionMismatchChecker = () => {
 		const isDevelopment = type === "development";
 		const store = isDevelopment ? monorepoDevelopmentDependencies : monorepoDependencies;
 		const dependencies = package_[isDevelopment ? "devDependencies" : "dependencies"];
-		for (const [dependencyName, depVersion] of Object.entries(dependencies)) {
-			if (!depVersion) continue;
+		for (const [dependencyName, dependencyVersion] of Object.entries(dependencies)) {
+			if (!dependencyVersion) continue;
 			const storedVersion = store.get(dependencyName);
 			if (!storedVersion) {
-				store.set(dependencyName, depVersion);
+				store.set(dependencyName, dependencyVersion);
 				continue;
 			}
-			if (!(depVersion === storedVersion)) throw createPackageError(`Mismatched versions: received version \`${depVersion}\` while others use \`${storedVersion}\`. To prevent issues with singleton-like code (React contexts, …), please make sure to update all packages to use the same \`${dependencyName}\` version (either \`${storedVersion}\` or \`${depVersion}\`).`, {
+			if (!(dependencyVersion === storedVersion)) throw createPackageError(`Mismatched versions: received version \`${dependencyVersion}\` while others use \`${storedVersion}\`. To prevent issues with singleton-like code (React contexts, …), please make sure to update all packages to use the same \`${dependencyName}\` version (either \`${storedVersion}\` or \`${dependencyVersion}\`).`, {
 				consumedBy: packageName,
 				name: dependencyName
 			});
@@ -382,7 +381,7 @@ const createCleanCommand = (program) => {
 		async handler() {
 			const cachePath = "node_modules/.cache";
 			const files = await retrieveIgnoredFiles();
-			if (isDirectoryExistAndNotEmpty(resolveFromProjectDirectory(cachePath))) files.push(cachePath);
+			if (isDirectoryExistAndNotEmpty(resolveFromWorkingDirectory(cachePath))) files.push(cachePath);
 			return files;
 		},
 		key: "files",
@@ -428,7 +427,7 @@ const PRESERVE_FILES = ["node_modules"];
 
 //#endregion
 //#region package.json
-var version = "2.38.1";
+var version = "2.39.0-next-00b7c69";
 
 //#endregion
 //#region src/commands/create.ts
@@ -444,7 +443,7 @@ const createCreateCommand = (program) => {
 		});
 	} }).task({
 		async handler() {
-			await getNpmVersion();
+			await getPnpmVersion();
 		},
 		label: label$2("Check pre-requisites")
 	}).input({
@@ -467,61 +466,92 @@ const createCreateCommand = (program) => {
 		options: ["single-project", "multi-projects"],
 		type: "select"
 	}).task({
-		async handler({ inputDescription, inputName, inputUrl }) {
+		async handler({ inputDescription, inputName, inputTemplate, 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: npmVersion } = await request.get("https://registry.npmjs.org/pnpm/latest", "json");
+			const { version: pnpmVersion } = await request.get("https://registry.npmjs.org/pnpm/latest", "json");
+			const projectName = slugify(inputName);
 			return {
 				licenseYear: (/* @__PURE__ */ new Date()).getFullYear().toString(),
 				nodeVersion: nodeVersion.replace("v", ""),
-				npmVersion: String(npmVersion),
-				projectDescription: inputDescription.charAt(0).toUpperCase() + inputDescription.slice(1),
-				projectName: inputName.toLowerCase(),
+				pnpmVersion: String(pnpmVersion),
+				projectDescription: toCapitalLetter(inputDescription),
+				projectName,
 				projectUrl: inputUrl,
-				repoId: `${repoOwner}/${repoName}`
+				repoId: `${repoOwner}/${repoName}`,
+				templatePath: resolveFromPackageDirectory("templates", inputTemplate),
+				workingPath: resolveFromWorkingDirectory(projectName)
 			};
 		},
 		key: "data",
 		label: label$2("Check and format input")
-	}).task({
-		async handler({ data }) {
-			const projectPath = resolve(process.cwd(), data.projectName);
-			await mkdir(projectPath);
-			process.chdir(projectPath);
+	}).input({
+		defaultValue: true,
+		key: "canRemoveExistingDirectoryInput",
+		label({ data: { projectName } }) {
+			return label$2(`\`${projectName}\` directory already exists, do you want to remove it?`);
 		},
-		label({ data }) {
-			return label$2(`Create \`${data.projectName}\` folder`);
+		skip({ data: { workingPath } }) {
+			return !existsSync(workingPath);
+		},
+		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.`);
 		}
 	}).task({
-		async handler({ data }) {
-			await helpers.exec("git init");
-			await helpers.exec(`git remote add origin ${data.projectUrl}`);
+		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
+			});
 		},
-		label: label$2("Initialize `git`")
+		key: "templateEngine",
+		label({ data: { projectName }, inputTemplate }) {
+			return label$2(`Copy \`${inputTemplate}\` template to \`${projectName}\` directory`);
+		}
 	}).task({
-		handler({ data, inputTemplate }) {
-			applyTemplate(inputTemplate, data);
+		async handler({ templateEngine }) {
+			await templateEngine.processContents();
+			await templateEngine.processPaths();
 		},
-		label: label$2("Apply template")
+		label() {
+			return label$2("Process template");
+		}
 	}).task({
-		async handler({ data: { projectName }, inputTemplate }) {
-			await symlink(join(inputTemplate === "single-project" ? projectName : join("libraries", projectName), "README.md"), "./README.md");
+		async handler({ data: { projectUrl } }) {
+			await helpers.exec("git init");
+			await helpers.exec(`git remote add origin ${projectUrl}`);
 		},
-		label: label$2("Create a symlink to `README.md` file")
+		label: label$2("Initialize `git`")
 	}).task({
 		async handler() {
 			await setPackageManager();
 		},
 		label: label$2("Set up the package manager")
 	}).task({
-		async handler({ data }) {
+		async handler({ data: { projectName } }) {
 			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 ${data.projectName}`);
+				await helpers.exec(`pnpm add ${localDevelopmentDependencies.join(" ")} --save-dev --filter ${projectName}`);
 				await helpers.exec("pnpm install");
 			} catch (error) {
 				throw createError("pnpm", error);
@@ -539,53 +569,95 @@ const createCreateCommand = (program) => {
 			await helpers.exec("git commit -m \"chore: initial commit\"");
 		},
 		label: label$2("Commit")
-	}).task({ handler({ data }) {
+	}).task({ handler({ data: { projectName } }) {
 		botMessage({
-			description: `Run \`cd ./${data.projectName}\` and Enjoy 🚀`,
+			description: `Run \`cd ./${projectName}\` and Enjoy 🚀`,
 			title: "The project was successfully created",
 			type: "success"
 		});
 	} });
 };
 const label$2 = (message) => `${message} 🔨`;
-/**
-* 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, {
+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, {
 		force: true,
 		recursive: 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");
+	const gitignoreFile = join(workingPath, "gitignore");
+	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 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];
-		}));
+	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;
 	});
 };
+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
@@ -600,7 +672,7 @@ const fixFormatting = async (files) => {
 		if (prettierFiles.length === 0) return;
 	}
 	const arguments_ = [...prettierFiles];
-	if (existsSync(resolveFromProjectDirectory(".gitignore"))) arguments_.push("--ignore-path .gitignore");
+	if (existsSync(resolveFromWorkingDirectory(".gitignore"))) arguments_.push("--ignore-path .gitignore");
 	arguments_.push("--write", "--ignore-unknown", "--no-error-on-unmatched-pattern");
 	try {
 		return await helpers.exec(`prettier ${arguments_.join(" ")}`);
@@ -663,7 +735,7 @@ const createInstallCommand = (program) => {
 };
 const label = (message) => `${message} 📲`;
 const installGitHook = async (hook, content) => {
-	const filename = resolveFromProjectDirectory(`.git/hooks/${hook}`);
+	const filename = resolveFromWorkingDirectory(`.git/hooks/${hook}`);
 	await writeFile(filename, content);
 	return chmod(filename, "0755");
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adbayb/stack",
-  "version": "2.38.1",
+  "version": "2.39.0-next-00b7c69",
   "description": "My opinionated JavaScript-based toolchain",
   "keywords": [
     "stack",
@@ -43,7 +43,7 @@
     "@changesets/cli": "^2.31.0",
     "@commitlint/cli": "^21.0.2",
     "@commitlint/config-conventional": "^21.0.2",
-    "@eslint-react/eslint-plugin": "^5.9.0",
+    "@eslint-react/eslint-plugin": "^5.9.1",
     "@eslint/compat": "^2.1.0",
     "@stylistic/eslint-plugin": "^5.10.0",
     "@vitest/eslint-plugin": "^1.6.20",
@@ -52,21 +52,20 @@
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-depend": "^1.5.0",
     "eslint-plugin-import-x": "^4.16.2",
-    "eslint-plugin-jsdoc": "^63.0.2",
+    "eslint-plugin-jsdoc": "^63.0.6",
     "eslint-plugin-mdx": "^3.8.1",
     "eslint-plugin-n": "^18.1.0",
-    "eslint-plugin-perfectionist": "^5.9.0",
+    "eslint-plugin-perfectionist": "^5.9.1",
     "eslint-plugin-prettier": "^5.5.6",
-    "eslint-plugin-sonarjs": "^4.0.3",
-    "eslint-plugin-unicorn": "^66.0.0",
-    "fdir": "^6.5.0",
+    "eslint-plugin-sonarjs": "^4.1.0",
+    "eslint-plugin-unicorn": "^68.0.0",
     "globals": "^17.6.0",
     "prettier": "^3.8.4",
     "prettier-plugin-packagejson": "^3.0.2",
     "termost": "^1.9.1",
     "turbo": "^2.9.18",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.61.0"
+    "typescript-eslint": "^8.61.1"
   },
   "devDependencies": {
     "@types/node": "24.13.2",

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

@@ -17,12 +17,12 @@
 		"watch": "stack watch"
 	},
 	"prettier": "@adbayb/stack/prettier",
-	"packageManager": "pnpm@{{npmVersion}}",
+	"packageManager": "pnpm@{{pnpmVersion}}",
 	"devEngines": {
 		"packageManager": [
 			{
 				"name": "pnpm",
-				"version": "{{npmVersion}}",
+				"version": "{{pnpmVersion}}",
 				"onFail": "download"
 			},
 			{

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

@@ -1,3 +1,8 @@
+allowBuilds:
+    esbuild: true
+    unrs-resolver: true
+minimumReleaseAgeExclude:
+    - "@adbayb/*"
 packages:
     - "applications/*"
     - "examples/*"
@@ -11,3 +16,4 @@ publicHoistPattern:
     - "*turbo*"
     - "*typescript*"
     - "*types*"
+verifyDepsBeforeRun: "warn"

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

@@ -17,12 +17,12 @@
 		"watch": "stack watch"
 	},
 	"prettier": "@adbayb/stack/prettier",
-	"packageManager": "pnpm@{{npmVersion}}",
+	"packageManager": "pnpm@{{pnpmVersion}}",
 	"devEngines": {
 		"packageManager": [
 			{
 				"name": "pnpm",
-				"version": "{{npmVersion}}",
+				"version": "{{pnpmVersion}}",
 				"onFail": "download"
 			},
 			{

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

@@ -1,3 +1,8 @@
+allowBuilds:
+    esbuild: true
+    unrs-resolver: true
+minimumReleaseAgeExclude:
+    - "@adbayb/*"
 packages:
     - "examples/*"
     - "tools/*"
@@ -10,3 +15,4 @@ publicHoistPattern:
     - "*turbo*"
     - "*typescript*"
     - "*types*"
+verifyDepsBeforeRun: "warn"

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

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

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

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