@adbayb/stack 2.40.0-next-f8ad939 → 2.40.0-next-6049a9b

package/bin/index.js

@@ -1,7 +1,5 @@
 #!/usr/bin/env node
 
-import { createRequire } from "node:module";
-
-const pkg = createRequire(import.meta.url)("../package.json");
+import pkg from "../package.json" with { type: "json" };
 
 void import(new URL(`../${pkg.exports["."].default}`, import.meta.url));

package/configs/oxlint/index.ts

@@ -1,6 +1,64 @@
 import { defineConfig } from "oxlint";
 
+const JAVASCRIPT_EXTENSIONS = ["js", "jsx", "cjs", "mjs", "mjsx"];
+const TYPESCRIPT_EXTENSIONS = ["ts", "tsx", "cts", "mts", "mtsx"];
+const JAVASCRIPT_LIKE_EXTENSIONS = [...JAVASCRIPT_EXTENSIONS, ...TYPESCRIPT_EXTENSIONS];
+const JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING = JAVASCRIPT_LIKE_EXTENSIONS.join(",");
+
+const TEST_LIKE_FILES = [
+	`**/{test,test-d}.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+	`**/*.{test,test-d}.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+];
+
+const RELAXED_LIKE_FILES = [
+	...TEST_LIKE_FILES,
+	"**/.config/**",
+	"**/.configs/**",
+	"**/config/**",
+	"**/configs/**",
+	"**/examples/**",
+	"**/scripts/**",
+	"**/tools/**",
+	`**/config.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+	`**/configs.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+	`**/*.config.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+	`**/*.configs.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+	`**/stories.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+	`**/*.stories.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+];
+
 export default defineConfig({
+	categories: {
+		correctness: "error",
+		nursery: "error",
+		pedantic: "error",
+		perf: "error",
+		style: "error",
+		suspicious: "error",
+	},
+	options: {
+		denyWarnings: true,
+		reportUnusedDisableDirectives: "error",
+		respectEslintDisableDirectives: false,
+		typeAware: true,
+		typeCheck: true,
+	},
+	overrides: [
+		{
+			files: TEST_LIKE_FILES,
+			plugins: ["vitest"],
+		},
+		{
+			files: [
+				...RELAXED_LIKE_FILES,
+				`*.config(s)?.{${JAVASCRIPT_LIKE_EXTENSIONS_AS_STRING}}`,
+			],
+			rules: {
+				"import/no-anonymous-default-export": "off",
+			},
+		},
+	],
+	// TODO: add jsPlugins for perfectionist and padding-line-between-statements + add React rules (such as set-state-in-effect) from React X https://github.com/oxc-project/oxc/issues/1022 + potentially https://github.com/es-tooling/eslint-plugin-depend/blob/main/docs/rules/ban-dependencies.md
 	plugins: [
 		"eslint",
 		"import",
@@ -13,18 +71,38 @@ export default defineConfig({
 		"react-perf",
 		"typescript",
 		"unicorn",
-		"vitest",
 	],
-	categories: {
-		correctness: "error",
-		perf: "error",
-		suspicious: "error",
-	},
-	options: {
-		denyWarnings: true,
-		reportUnusedDisableDirectives: "error",
-		respectEslintDisableDirectives: false,
-		typeAware: true,
-		typeCheck: true,
+	rules: {
+		"array-callback-return": ["error", { allowImplicit: true }],
+		"arrow-body-style": ["error", "always"],
+		"id-length": "off",
+		"import/exports-last": "off",
+		"import/group-exports": "off",
+		"import/max-dependencies": "off",
+		"import/no-named-export": "off",
+		"import/no-nodejs-modules": "off",
+		"import/prefer-default-export": "off",
+		"jsdoc/require-param-type": "off",
+		"jsdoc/require-property-type": "off",
+		"jsdoc/require-returns-type": "off",
+		"max-classes-per-file": "off",
+		"max-lines": "off",
+		"max-lines-per-function": "off",
+		"max-statements": "off",
+		"no-continue": "off",
+		"no-magic-numbers": "off",
+		"no-ternary": "off",
+		"no-undef": "off",
+		"no-warning-comments": "off",
+		"node/no-sync": "off",
+		"prefer-named-capture-group": "off",
+		"prefer-readonly-parameter-types": "off",
+		"react/jsx-max-depth": "off",
+		"sort-imports": ["error", { ignoreDeclarationSort: true }],
+		"strict-boolean-expressions": "off",
+		"typescript/consistent-return": "off",
+		"typescript/consistent-type-definitions": ["error", "type"],
+		"typescript/no-unsafe-type-assertion": "off",
+		"unicorn/filename-case": "off",
 	},
 });

package/dist/index.js

@@ -6,9 +6,9 @@ import { chmod, cp, mkdir, readFile, readdir, rename, rm, symlink, writeFile } f
 
 //#region src/helpers.ts
 const require = createRequire(import.meta.url);
-function assert(expectedCondition, createError) {
+const assert = (expectedCondition, createError) => {
 	if (!expectedCondition) throw createError();
-}
+};
 /**
 * Helper to format log messages with a welcoming bot.
 *
@@ -91,7 +91,7 @@ const setPackageManager = async () => {
 	*
 	* @see {@link https://github.com/nodejs/corepack/issues/613}
 	*/
-	return helpers.exec("pnx corepack enable");
+	await helpers.exec("pnx corepack enable");
 };
 async function getRequest(url, responseType) {
 	const response = await fetch(url);
@@ -103,31 +103,35 @@ async function getRequest(url, responseType) {
 	return response.json();
 }
 const request = { get: getRequest };
-const oxlint = (options) => async (files = []) => {
-	const args = [
-		...files,
-		"--disable-nested-config",
-		"--no-error-on-unmatched-pattern"
-	];
-	if (options.isFixMode) args.push("--fix");
-	try {
-		return await helpers.exec(`oxlint ${args.join(" ")}`);
-	} catch (error) {
-		throw createError("oxlint", error instanceof Error ? error : new Error(String(error)));
-	}
+const oxlint = (options) => {
+	return async (files = []) => {
+		const args = [
+			...files,
+			"--disable-nested-config",
+			"--no-error-on-unmatched-pattern"
+		];
+		if (options.isFixMode) args.push("--fix");
+		try {
+			return await helpers.exec(`oxlint ${args.join(" ")}`);
+		} catch (error) {
+			throw createError("oxlint", error instanceof Error ? error : new Error(String(error)));
+		}
+	};
 };
-const oxfmt = (options) => async (files = []) => {
-	const args = [
-		...files,
-		"--disable-nested-config",
-		"--no-error-on-unmatched-pattern",
-		options.isFixMode ? "--write" : "--check"
-	];
-	try {
-		return await helpers.exec(`oxfmt ${args.join(" ")}`);
-	} catch (error) {
-		throw createError("oxfmt", error instanceof Error ? error : new Error(String(error)));
-	}
+const oxfmt = (options) => {
+	return async (files = []) => {
+		const args = [
+			...files,
+			"--disable-nested-config",
+			"--no-error-on-unmatched-pattern",
+			options.isFixMode ? "--write" : "--check"
+		];
+		try {
+			return await helpers.exec(`oxfmt ${args.join(" ")}`);
+		} catch (error) {
+			throw createError("oxfmt", error instanceof Error ? error : new Error(String(error)));
+		}
+	};
 };
 const turbo = async (command, options = {}) => {
 	try {
@@ -199,7 +203,9 @@ const checkDependency = async () => {
 	const checkDependencyVersionMismatch = createPackagesVersionMismatchChecker();
 	const packages = JSON.parse(stdout).map((pkg) => {
 		const packagePath = join(pkg.path, "package.json");
-		assert(pkg.name, () => createPackageError(`\`${packagePath}\` must have a name field.`));
+		assert(pkg.name, () => {
+			return createPackageError(`\`${packagePath}\` must have a name field.`);
+		});
 		const packageContent = require(packagePath);
 		const peerDependencies = packageContent.peerDependencies ?? {};
 		const devDependencies = packageContent.devDependencies ?? {};
@@ -221,7 +227,7 @@ const checkDependencyVersionRange = ({ dependencies, devDependencies, name, peer
 			consumedBy: name,
 			name: dependencyName
 		});
-		if (version !== "workspace:*" && !isExcluded(version) && !/^\d/.test(version)) throw createPackageError(`As a dev dependency, \`${dependencyName}\` version must be fixed (or set as "workspace:*" for local packages) to reduce accidental breaking change risks due to an implicit semver upgrade.`, {
+		if (version !== "workspace:*" && !isExcluded(version) && !/^\d/u.test(version)) throw createPackageError(`As a dev dependency, \`${dependencyName}\` version must be fixed (or set as "workspace:*" for local packages) to reduce accidental breaking change risks due to an implicit semver upgrade.`, {
 			consumedBy: name,
 			name: dependencyName
 		});
@@ -276,17 +282,21 @@ const createPackagesVersionMismatchChecker = () => {
 const createPackageError = (message, context) => {
 	return createError("stack check", context ? `\`${context.name}\` consumed by \`${context.consumedBy}\` doesn't conform to package guidelines.\n${message}` : message);
 };
-function assertVersion(version, { consumedBy, name }) {
-	assert(version, () => createPackageError(`\`${name}\` must have a valid version specified (current version equals to \`${String(version)}\`).`, {
-		consumedBy,
-		name
-	}));
-}
+const assertVersion = (version, { consumedBy, name }) => {
+	assert(version, () => {
+		return createPackageError(`\`${name}\` must have a valid version specified (current version equals to \`${String(version)}\`).`, {
+			consumedBy,
+			name
+		});
+	});
+};
 const isExcluded = (version) => {
-	const isPreReleaseVersion = /\d+\.\d+\.\d+-(alpha|beta|experimental|next|rc).*/.exec(version);
+	const isPreReleaseVersion = /\d+\.\d+\.\d+-(alpha|beta|experimental|next|rc).*/u.exec(version);
 	return version.startsWith("npm:") || isPreReleaseVersion;
 };
-const hasCaret = (version) => version.startsWith("^");
+const hasCaret = (version) => {
+	return version.startsWith("^");
+};
 
 //#endregion
 //#region src/commands/check/checkFormatting.ts
@@ -355,9 +365,13 @@ const createCheckCommand = (program) => {
 		}
 	});
 };
-const label$4 = (message) => `${message} 🧐`;
-const ifFilterDefinedAndNotEqualTo = (filter) => (context) => {
-	return context.filter !== void 0 && context.filter !== filter;
+const label$4 = (message) => {
+	return `${message} 🧐`;
+};
+const ifFilterDefinedAndNotEqualTo = (filter) => {
+	return (context) => {
+		return context.filter !== void 0 && context.filter !== filter;
+	};
 };
 
 //#endregion
@@ -399,24 +413,34 @@ const createCleanCommand = (program) => {
 		}
 	});
 };
-const label$3 = (message) => `${message} 🧹`;
+const label$3 = (message) => {
+	return `${message} 🧹`;
+};
 const cleanFiles = async (files) => {
-	return Promise.all(files.map(async (file) => rm(file, {
-		force: true,
-		recursive: true
-	})));
+	await Promise.all(files.map(async (file) => {
+		await rm(file, {
+			force: true,
+			recursive: true
+		});
+	}));
 };
 const isDirectoryExistAndNotEmpty = (path) => {
 	return existsSync(path) && readdirSync(path).length > 0;
 };
 const retrieveIgnoredFiles = async () => {
-	return (await helpers.exec("git clean -fdXn")).split(/\n|\r\n/).filter((cleanOutput) => PRESERVE_FILES.every((excludedFile) => !cleanOutput.includes(excludedFile))).map((cleanOutput) => cleanOutput.split(" ").at(-1) ?? "").filter(Boolean);
+	return (await helpers.exec("git clean -fdXn")).split(/\n|\r\n/u).filter((cleanOutput) => {
+		return PRESERVE_FILES.every((excludedFile) => {
+			return !cleanOutput.includes(excludedFile);
+		});
+	}).map((cleanOutput) => {
+		return cleanOutput.split(" ").at(-1) ?? "";
+	}).filter(Boolean);
 };
 const PRESERVE_FILES = ["node_modules"];
 
 //#endregion
 //#region package.json
-var version = "2.40.0-next-f8ad939";
+var version = "2.40.0-next-6049a9b";
 
 //#endregion
 //#region src/commands/create.ts
@@ -457,7 +481,7 @@ const createCreateCommand = (program) => {
 	}).task({
 		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 ?? {};
+			const { repoName, repoOwner } = (inputUrl.startsWith("git") ? /^git@.*:(?<repoOwner>.*)\/(?<repoName>.*)\.git$/u : /^https?:\/\/.*\/(?<repoOwner>.*)\/(?<repoName>.*)\.git$/u).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");
@@ -487,7 +511,7 @@ const createCreateCommand = (program) => {
 		},
 		type: "confirm",
 		validate({ canRemoveExistingDirectoryInput, data: { projectName } }) {
-			if (canRemoveExistingDirectoryInput) return void 0;
+			if (canRemoveExistingDirectoryInput) return;
 			return createError("mkdir", `Remove or rename the \`${projectName}\` existing directory to apply the template from a clean state.`);
 		}
 	}).task({
@@ -566,9 +590,11 @@ const createCreateCommand = (program) => {
 		});
 	} });
 };
-const label$2 = (message) => `${message} 🔨`;
+const label$2 = (message) => {
+	return `${message} 🔨`;
+};
 const slugify = (input) => {
-	return input.toLowerCase().replaceAll(/[^a-z0-9\s-]/g, "").trim().replaceAll(/\s+/g, "-").replaceAll(/-+/g, "-");
+	return input.toLowerCase().replaceAll(/[^a-z0-9\s-]/gu, "").trim().replaceAll(/\s+/gu, "-").replaceAll(/-+/gu, "-");
 };
 const toCapitalLetter = (input) => {
 	return input.charAt(0).toUpperCase() + input.slice(1);
@@ -587,15 +613,19 @@ const createTemplateEngine = async (workingPath, { projectName, templateModel, t
 	process.chdir(workingPath);
 	return {
 		async processContents() {
-			await Promise.all(templateEntries.filter(({ type }) => type === "content").map(async (entry) => {
-				return writeFile(entry.path, setTemplateVariables(entry, templateModel));
+			await Promise.all(templateEntries.filter(({ type }) => {
+				return type === "content";
+			}).map(async (entry) => {
+				await 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);
+			}).toSorted(({ path: pathA }, { path: pathB }) => {
+				return pathB.length - pathA.length;
+			});
 			for (const entry of sortedDirectoryEntries) {
 				const newPath = setTemplateVariables(entry, templateModel);
 				await rename(entry.path, newPath);
@@ -623,13 +653,15 @@ const getTemplateEntries = async (path) => {
 			content: await readFile(entryPath, "utf8"),
 			type: "content"
 		}]).map(({ content, type }) => {
-			if (!hasTemplateVariable(content)) return void 0;
+			if (!hasTemplateVariable(content)) return;
 			return {
 				content,
 				path: entryPath,
 				type
 			};
-		}).filter((input) => Boolean(input));
+		}).filter((input) => {
+			return Boolean(input);
+		});
 	}))).flat();
 };
 const setTemplateVariables = (entry, model) => {
@@ -637,7 +669,7 @@ const setTemplateVariables = (entry, model) => {
 		return model[dataModelKey] ?? match;
 	});
 };
-const TEMPLATE_VARIABLE_MATCHER = /* @__PURE__ */ new RegExp(/{{(.*?)}}/g, "gi");
+const TEMPLATE_VARIABLE_MATCHER = /\{\{(.*?)\}\}/giu;
 const hasTemplateVariable = (input) => {
 	/**
 	* TemplateVariableMatcher.test() is not used since the `RegExp` is stateful when the global is
@@ -685,7 +717,9 @@ const createFixCommand = (program) => {
 		label: label$1("Fix code issues")
 	});
 };
-const label$1 = (message) => `${message} 🚑`;
+const label$1 = (message) => {
+	return `${message} 🚑`;
+};
 
 //#endregion
 //#region src/commands/install.ts
@@ -705,7 +739,9 @@ const createInstallCommand = (program) => {
 		label: label("Install `git.commit-msg` hook")
 	});
 };
-const label = (message) => `${message} 📲`;
+const label = (message) => {
+	return `${message} 📲`;
+};
 const installGitHook = async (hook, content) => {
 	const filename = resolveFromWorkingDirectory(`.git/hooks/${hook}`);
 	await writeFile(filename, content);
@@ -760,8 +796,10 @@ const createReleaseCommand = (program) => {
 		skip: ifNotEqualTo("publish")
 	});
 };
-const ifNotEqualTo = (validOption) => (context) => {
-	return !context[validOption];
+const ifNotEqualTo = (validOption) => {
+	return (context) => {
+		return !context[validOption];
+	};
 };
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adbayb/stack",
-  "version": "2.40.0-next-f8ad939",
+  "version": "2.40.0-next-6049a9b",
   "description": "My opinionated JavaScript-based toolchain",
   "keywords": [
     "development",