@adbayb/stack 2.4.0 → 2.6.0

package/bin/index.js

@@ -3,6 +3,6 @@
 import { join } from "node:path";
 import { createRequire } from "node:module";
 
-const pkg = createRequire(import.meta.url)("../package.json");
+const package_ = createRequire(import.meta.url)("../package.json");
 
-import(join("..", pkg.exports["."].default));
+import(join("..", package_.exports["."].default));

package/configs/eslint/index.js

@@ -1,3 +1,4 @@
+import { config as unicornConfig } from "./presets/unicorn.js";
 import { config as uncategorizedConfig } from "./presets/uncategorized.js";
 import { config as typescriptConfig } from "./presets/typescript.js";
 import { config as testConfig } from "./presets/test.js";
@@ -24,6 +25,7 @@ export default createConfig(
 	...sonarConfig,
 	...stylisticConfig,
 	...testConfig,
+	...unicornConfig,
 	...uncategorizedConfig,
 	...overridableConfig,
 );

package/configs/eslint/presets/eslint.js

@@ -66,19 +66,23 @@ export const config = [
 			"no-regex-spaces": "error",
 			"no-restricted-syntax": [
 				"error",
-				// https://medium.com/@hbarcelos/why-i-banned-null-from-my-js-code-and-why-you-should-too-13df90323cfa
+				/*
+				 * https://medium.com/@hbarcelos/why-i-banned-null-from-my-js-code-and-why-you-should-too-13df90323cfa
+				 * https://www.youtube.com/watch?v=PSGEjv3Tqo0&t=561s
+				 */
 				{
-					message: "Use undefined instead of null",
+					message: "Use `undefined` instead of `null`.",
 					selector: "VariableDeclarator > Literal[raw='null']",
 				},
 				{
-					message: "Use undefined instead of null",
+					message: "Use `undefined` instead of `null`.",
 					selector: "AssignmentExpression > Literal[raw='null']",
 				},
 			],
 			"no-self-assign": "error",
 			"no-shadow-restricted-names": "error",
 			"no-sparse-arrays": "error",
+			"no-template-curly-in-string": "error",
 			"no-unexpected-multiline": "error",
 			"no-unsafe-finally": "error",
 			"no-unsafe-optional-chaining": "error",

package/configs/eslint/presets/import.js

@@ -17,7 +17,6 @@ export const config = [
 			"import-x/no-absolute-path": "error",
 			"import-x/no-amd": "error",
 			"import-x/no-anonymous-default-export": "error",
-			"import-x/no-commonjs": "error",
 			"import-x/no-cycle": "error",
 			"import-x/no-default-export": "error",
 			"import-x/no-deprecated": "error",

package/configs/eslint/presets/overridable.js

@@ -1,11 +1,6 @@
-import tseslint from "typescript-eslint";
 import eslintPluginPrettierRecommended from "eslint-plugin-prettier/recommended";
 
 export const config = [
-	{
-		files: ["**/*.{js,jsx,cjs,mjs}"],
-		...tseslint.configs.disableTypeChecked,
-	},
 	{
 		// Relaxed rules for example-like folder, and [config-, story-, and test]-like files
 		files: [

package/configs/eslint/presets/react.js

@@ -1,3 +1,5 @@
+import reactWebApiPlugin from "eslint-plugin-react-web-api";
+import reactHooksExtraPlugin from "eslint-plugin-react-hooks-extra";
 import reactHooksPlugin from "eslint-plugin-react-hooks";
 // eslint-disable-next-line depend/ban-dependencies
 import reactPlugin from "eslint-plugin-react";
@@ -8,16 +10,29 @@ export const config = [
 		plugins: {
 			"react": reactPlugin,
 			"react-hooks": reactHooksPlugin,
+			"react-hooks-extra": reactHooksExtraPlugin,
+			"react-web-api": reactWebApiPlugin,
 		},
 		rules: {
+			"react-hooks-extra/no-direct-set-state-in-use-effect": "error",
+			"react-hooks-extra/no-direct-set-state-in-use-layout-effect": "error",
+			"react-hooks-extra/no-redundant-custom-hook": "error",
+			"react-hooks-extra/no-unnecessary-use-callback": "error",
+			"react-hooks-extra/no-unnecessary-use-memo": "error",
+			"react-hooks-extra/prefer-use-state-lazy-initialization": "error",
 			"react-hooks/exhaustive-deps": "warn",
 			"react-hooks/rules-of-hooks": "error",
+			"react-web-api/no-leaked-event-listener": "error",
+			"react-web-api/no-leaked-interval": "error",
+			"react-web-api/no-leaked-resize-observer": "error",
+			"react-web-api/no-leaked-timeout": "error",
 			"react/boolean-prop-naming": [
 				"error",
 				{ rule: "^(is|has)[A-Z]([A-Za-z0-9]?)+" },
 			],
 			"react/button-has-type": "error",
 			"react/checked-requires-onchange-or-readonly": "error",
+			"react/destructuring-assignment": ["error", "always"],
 			"react/display-name": "error",
 			"react/forbid-component-props": "error",
 			"react/forward-ref-uses-ref": "error",
@@ -28,14 +43,13 @@ export const config = [
 			"react/jsx-handler-names": "error",
 			"react/jsx-key": "error",
 			"react/jsx-no-bind": "error",
+			"react/jsx-no-comment-textnodes": "error",
 			"react/jsx-no-constructed-context-values": "error",
 			"react/jsx-no-leaked-render": "error",
 			"react/jsx-no-script-url": "error",
 			"react/jsx-no-target-blank": "error",
 			"react/jsx-no-useless-fragment": "error",
-			"react/jsx-pascal-case": "error",
 			"react/jsx-props-no-spread-multi": "error",
-			"react/jsx-sort-props": "error",
 			"react/jsx-uses-react": "error",
 			"react/jsx-uses-vars": "error",
 			"react/no-access-state-in-setstate": "error",
@@ -56,6 +70,7 @@ export const config = [
 			"react/no-this-in-sfc": "error",
 			"react/no-typos": "error",
 			"react/no-unescaped-entities": "error",
+			"react/no-unknown-property": "error",
 			"react/no-unsafe": "error",
 			"react/no-unstable-nested-components": "error",
 			"react/no-unused-class-component-methods": "error",
@@ -63,7 +78,8 @@ export const config = [
 			"react/no-will-update-set-state": "error",
 			"react/prefer-read-only-props": "error",
 			"react/prefer-stateless-function": "error",
-			"react/self-closing-comp": "error",
+			"react/sort-comp": "error",
+			"react/state-in-constructor": ["error", "never"],
 			"react/style-prop-object": "error",
 			"react/void-dom-elements-no-children": "error",
 		},

package/configs/eslint/presets/sonar.js

@@ -151,7 +151,6 @@ export const config = [
 			"sonarjs/no-unenclosed-multiline-block": "error",
 			"sonarjs/no-uniq-key": "error",
 			"sonarjs/no-unsafe-unzip": "error",
-			"sonarjs/no-unstable-nested-components": "error",
 			"sonarjs/no-unthrown-error": "error",
 			"sonarjs/no-unused-collection": "error",
 			"sonarjs/no-useless-call": "error",
@@ -193,11 +192,9 @@ export const config = [
 			"sonarjs/sonar-no-empty-character-class": "error",
 			"sonarjs/sonar-no-fallthrough": "error",
 			"sonarjs/sonar-no-invalid-regexp": "error",
-			"sonarjs/sonar-no-magic-numbers": "error",
 			"sonarjs/sonar-no-misleading-character-class": "error",
 			"sonarjs/sonar-no-regex-spaces": "error",
-			"sonarjs/sonar-no-unused-class-component-methods": "error",
-			"sonarjs/sonar-prefer-regexp-exec": "error",
+			// "sonarjs/sonar-no-unused-class-component-methods": "error", // Disabled since it involves `eslint-plugin-react` activation
 			"sonarjs/sql-queries": "error",
 			"sonarjs/stable-tests": "error",
 			"sonarjs/stateful-regex": "error",

package/configs/eslint/presets/stylistic.js

@@ -9,6 +9,9 @@ export const config = [
 			"@stylistic": stylistic,
 		},
 		rules: {
+			"@stylistic/jsx-pascal-case": "error",
+			"@stylistic/jsx-self-closing-comp": "error",
+			"@stylistic/jsx-sort-props": "error",
 			"@stylistic/lines-between-class-members": ["error", "always"],
 			"@stylistic/multiline-comment-style": ["error", "starred-block"],
 			"@stylistic/padding-line-between-statements": [
@@ -59,6 +62,11 @@ export const config = [
 					prev: ["cjs-export", "export"],
 				},
 			],
+			"@stylistic/quotes": [
+				"error",
+				"double",
+				{ allowTemplateLiterals: false, avoidEscape: true },
+			],
 			"@stylistic/spaced-comment": [
 				"error",
 				"always",

package/configs/eslint/presets/typescript.js

@@ -1,6 +1,10 @@
 import tseslint from "typescript-eslint";
 
-import { CWD, JAVASCRIPT_LIKE_EXTENSIONS } from "../constants.js";
+import {
+	CWD,
+	JAVASCRIPT_EXTENSIONS,
+	JAVASCRIPT_LIKE_EXTENSIONS,
+} from "../constants.js";
 
 export const config = [
 	{
@@ -169,4 +173,8 @@ export const config = [
 			"@typescript-eslint/use-unknown-in-catch-callback-variable": "error",
 		},
 	},
+	{
+		files: JAVASCRIPT_EXTENSIONS,
+		...tseslint.configs.disableTypeChecked,
+	},
 ];

package/configs/eslint/presets/unicorn.js

@@ -0,0 +1,138 @@
+/* eslint-disable unicorn/string-content */
+import unicornPlugin from "eslint-plugin-unicorn";
+
+import { JAVASCRIPT_LIKE_EXTENSIONS } from "../constants.js";
+
+export const config = [
+	{
+		files: JAVASCRIPT_LIKE_EXTENSIONS,
+		plugins: {
+			unicorn: unicornPlugin,
+		},
+		rules: {
+			"unicorn/better-regex": "error",
+			"unicorn/catch-error-name": [
+				"error",
+				{
+					name: "error",
+				},
+			],
+			"unicorn/consistent-empty-array-spread": "error",
+			"unicorn/consistent-existence-index-check": "error",
+			"unicorn/consistent-function-scoping": "error",
+			"unicorn/custom-error-definition": "error",
+			"unicorn/error-message": "error",
+			"unicorn/escape-case": "error",
+			"unicorn/expiring-todo-comments": "error",
+			"unicorn/explicit-length-check": "error",
+			"unicorn/filename-case": [
+				"error",
+				{
+					cases: {
+						camelCase: true,
+						pascalCase: true,
+					},
+				},
+			],
+			"unicorn/new-for-builtins": "error",
+			"unicorn/no-abusive-eslint-disable": "error",
+			"unicorn/no-array-callback-reference": "error",
+			"unicorn/no-array-push-push": "error",
+			"unicorn/no-await-in-promise-methods": "error",
+			"unicorn/no-console-spaces": "error",
+			"unicorn/no-document-cookie": "error",
+			"unicorn/no-empty-file": "error",
+			"unicorn/no-for-loop": "error",
+			"unicorn/no-instanceof-array": "error",
+			"unicorn/no-invalid-fetch-options": "error",
+			"unicorn/no-invalid-remove-event-listener": "error",
+			"unicorn/no-length-as-slice-end": "error",
+			"unicorn/no-new-buffer": "error",
+			"unicorn/no-object-as-default-parameter": "error",
+			"unicorn/no-process-exit": "error",
+			"unicorn/no-single-promise-in-promise-methods": "error",
+			"unicorn/no-static-only-class": "error",
+			"unicorn/no-typeof-undefined": "error",
+			"unicorn/no-unnecessary-polyfills": "error",
+			"unicorn/no-unreadable-array-destructuring": "error",
+			"unicorn/no-unreadable-iife": "error",
+			"unicorn/no-unused-properties": "error",
+			"unicorn/no-useless-fallback-in-spread": "error",
+			"unicorn/no-useless-length-check": "error",
+			"unicorn/no-useless-promise-resolve-reject": "error",
+			"unicorn/no-useless-spread": "error",
+			"unicorn/no-zero-fractions": "error",
+			"unicorn/number-literal-case": "error",
+			"unicorn/prefer-add-event-listener": "error",
+			"unicorn/prefer-array-find": "error",
+			"unicorn/prefer-array-flat": "error",
+			"unicorn/prefer-array-flat-map": "error",
+			"unicorn/prefer-array-index-of": "error",
+			"unicorn/prefer-array-some": "error",
+			"unicorn/prefer-blob-reading-methods": "error",
+			"unicorn/prefer-code-point": "error",
+			"unicorn/prefer-date-now": "error",
+			"unicorn/prefer-dom-node-append": "error",
+			"unicorn/prefer-dom-node-remove": "error",
+			"unicorn/prefer-dom-node-text-content": "error",
+			"unicorn/prefer-event-target": "error",
+			"unicorn/prefer-export-from": "error",
+			"unicorn/prefer-global-this": "error",
+			"unicorn/prefer-includes": "error",
+			"unicorn/prefer-keyboard-event-key": "error",
+			"unicorn/prefer-logical-operator-over-ternary": "error",
+			"unicorn/prefer-math-min-max": "error",
+			"unicorn/prefer-math-trunc": "error",
+			"unicorn/prefer-modern-dom-apis": "error",
+			"unicorn/prefer-modern-math-apis": "error",
+			"unicorn/prefer-module": "error",
+			"unicorn/prefer-native-coercion-functions": "error",
+			"unicorn/prefer-negative-index": "error",
+			"unicorn/prefer-number-properties": "error",
+			"unicorn/prefer-object-from-entries": "error",
+			"unicorn/prefer-optional-catch-binding": "error",
+			"unicorn/prefer-prototype-methods": "error",
+			"unicorn/prefer-query-selector": "error",
+			"unicorn/prefer-reflect-apply": "error",
+			"unicorn/prefer-regexp-test": "error",
+			"unicorn/prefer-set-has": "error",
+			"unicorn/prefer-set-size": "error",
+			"unicorn/prefer-spread": "error",
+			"unicorn/prefer-string-raw": "error",
+			"unicorn/prefer-string-replace-all": "error",
+			"unicorn/prefer-string-slice": "error",
+			"unicorn/prefer-string-starts-ends-with": "error",
+			"unicorn/prefer-string-trim-start-end": "error",
+			"unicorn/prefer-structured-clone": "error",
+			"unicorn/prefer-switch": "error",
+			"unicorn/prefer-ternary": "error",
+			"unicorn/prefer-top-level-await": "error",
+			"unicorn/prefer-type-error": "error",
+			"unicorn/prevent-abbreviations": [
+				"error",
+				{
+					allowList: {
+						props: true,
+						Props: true,
+					},
+				},
+			],
+			"unicorn/relative-url-style": ["error", "always"],
+			"unicorn/require-array-join-separator": "error",
+			"unicorn/require-number-to-fixed-digits-argument": "error",
+			"unicorn/string-content": [
+				"error",
+				{
+					patterns: {
+						"->": "→",
+						"\\.\\.\\.": "…",
+						"^http:\\/\\/": String.raw`^https:\/\/`,
+					},
+				},
+			],
+			"unicorn/switch-case-braces": "error",
+			"unicorn/text-encoding-identifier-case": "error",
+			"unicorn/throw-new-error": "error",
+		},
+	},
+];

package/dist/index.js

@@ -2,7 +2,7 @@ import { helpers, termost } from 'termost';
 import process from 'node:process';
 import { resolve, join } from 'node:path';
 import { createRequire } from 'node:module';
-import { writeFile, chmod, mkdir, symlink } from 'node:fs/promises';
+import { writeFile, chmod, mkdir, symlink, rm } from 'node:fs/promises';
 import { existsSync, cpSync, readFileSync, renameSync, writeFileSync, readdirSync } from 'node:fs';
 import { fdir } from 'fdir';
 
@@ -96,7 +96,7 @@ const getStackCommand = (command, isNodeRuntime = true)=>{
 const hasDependency = (packageName)=>{
     return Boolean(require.resolve(packageName));
 };
-const setPkgManager = async ()=>{
+const setPackageManager = async ()=>{
     return helpers.exec("corepack enable");
 };
 const request = {
@@ -117,35 +117,53 @@ const eslint = (options)=>async (files = [])=>{
             eslintFiles.push(".");
         } else {
             eslintFiles = files.filter((file)=>{
-                return ESLINT_EXTENSIONS.some((ext)=>file.endsWith(ext));
+                return ESLINT_EXTENSIONS.some((extension)=>file.endsWith(extension));
             });
-            if (eslintFiles.length === 0) return Promise.resolve();
+            if (eslintFiles.length === 0) return;
         }
-        const args = [
+        const arguments_ = [
             ...eslintFiles
         ];
-        args.push("--cache");
-        args.push(`--cache-location ${resolveFromProjectDirectory("node_modules/.cache/.eslintcache")}`);
-        // @note: prevent errors when no matched file is found
-        args.push("--no-error-on-unmatched-pattern");
+        arguments_.push("--cache", `--cache-location ${resolveFromProjectDirectory("node_modules/.cache/.eslintcache")}`, "--no-error-on-unmatched-pattern");
         if (options.isFixMode) {
-            args.push("--fix");
+            arguments_.push("--fix");
         }
         try {
-            return await helpers.exec(`eslint ${args.join(" ")}`);
+            return await helpers.exec(`eslint ${arguments_.join(" ")}`);
         } catch (error) {
             throw createError("eslint", error);
         }
     };
-const turbo = async (command, options = {
-    hasLiveOutput: true
-})=>{
+const turbo = async (command, options = {})=>{
     try {
-        return await helpers.exec(`turbo run ${command}`, options);
+        const { excludeExamples = false, hasLiveOutput = true, ...restOptions } = options;
+        return await helpers.exec(`turbo run ${command} ${excludeExamples ? "--filter !@examples/*" : ""}`, {
+            ...restOptions,
+            hasLiveOutput
+        });
     } catch (error) {
         throw createError("turbo", error);
     }
 };
+const logCheckableFiles = (files)=>{
+    if (files.length === 0) {
+        helpers.message("The whole project will be checked.", {
+            label: false,
+            lineBreak: {
+                end: true,
+                start: false
+            }
+        });
+        return;
+    }
+    helpers.message(files.join("\n   "), {
+        label: "Following files will be checked:",
+        lineBreak: {
+            end: true,
+            start: false
+        }
+    });
+};
 const changeset = async (command)=>{
     try {
         return await helpers.exec(command, {
@@ -168,9 +186,7 @@ const ESLINT_EXTENSIONS = [
     "mdx"
 ];
 
-var version = "2.4.0";
-
-const VERSION = version;
+var version = "2.6.0";
 
 const createWatchCommand = (program)=>{
     program.command({
@@ -223,7 +239,6 @@ const createReleaseCommand = (program)=>{
         description: "Publish package(s) to the registry"
     }).task({
         async handler () {
-            // TODO: label instead?
             helpers.message("New changelog entry\n");
             await changeset("changeset");
         },
@@ -253,7 +268,9 @@ const createInstallCommand = (program)=>{
     }).task({
         label: label$4("Install `git.pre-commit` hook"),
         async handler () {
-            await installGitHook("pre-commit", `${getStackCommand("fix $(git status --porcelain | awk 'BEGIN{ ORS=\" \" } { print $2 }')", false)} && git add -A`);
+            const lineBreakMatcher = String.raw`\n|\r\n`;
+            const modifiedFilesCommand = `node -e 'console.log(require("child_process").execSync("git status --porcelain", {encoding: "utf8"}).split(/${lineBreakMatcher}/).filter(Boolean).map(item => item.split(" ").at(-1)).join(" "))'`;
+            await installGitHook("pre-commit", `${getStackCommand(`fix $(${modifiedFilesCommand})`, false)} && git add -A`);
         }
     }).task({
         label: label$4("Install `git.commit-msg` hook"),
@@ -286,19 +303,17 @@ const fixFormatting = async (files)=>{
             return !PRETTIER_IGNORE_FILES.some((filename)=>file.endsWith(filename)) && // The root `README.md` file is ignored to prevent error due to its symbolic link nature when specified explicitly as a file
             file !== "README.md";
         });
-        if (prettierFiles.length === 0) return Promise.resolve();
+        if (prettierFiles.length === 0) return;
     }
-    const args = [
+    const arguments_ = [
         ...prettierFiles
     ];
     if (existsSync(resolveFromProjectDirectory(".gitignore"))) {
-        args.push("--ignore-path .gitignore");
+        arguments_.push("--ignore-path .gitignore");
     }
-    args.push("--write");
-    args.push("--ignore-unknown");
-    args.push("--no-error-on-unmatched-pattern");
+    arguments_.push("--write", "--ignore-unknown", "--no-error-on-unmatched-pattern");
     try {
-        return await helpers.exec(`prettier ${args.join(" ")}`);
+        return await helpers.exec(`prettier ${arguments_.join(" ")}`);
     } catch (error) {
         throw createError("prettier", error);
     }
@@ -308,10 +323,15 @@ const createFixCommand = (program)=>{
     program.command({
         name: "fix",
         description: "Fix auto-fixable issues"
+    }).task({
+        handler (_, argv) {
+            logCheckableFiles(argv.operands);
+        }
     }).task({
         label: label$3("Prepare the project"),
         async handler () {
             await turbo("build", {
+                excludeExamples: true,
                 hasLiveOutput: false
             });
         }
@@ -336,7 +356,7 @@ const createCreateCommand = (program)=>{
     }).task({
         handler () {
             botMessage({
-                title: `I'm Stack v${VERSION}, your bot assistant`,
+                title: `I'm Stack v${version}, your bot assistant`,
                 description: "I can guarantee you a project creation in under 1 minute 🚀",
                 type: "information"
             });
@@ -420,21 +440,21 @@ const createCreateCommand = (program)=>{
     }).task({
         label: label$2("Set up the package manager"),
         async handler () {
-            await setPkgManager();
+            await setPackageManager();
         }
     }).task({
         label: label$2("Install dependencies"),
         async handler ({ data }) {
-            const localDevDependencies = [
+            const localDevelopmentDependencies = [
                 "quickbundle",
                 "vitest"
             ];
-            const globalDevDependencies = [
+            const globalDevelopmentDependencies = [
                 "@adbayb/stack"
             ];
             try {
-                await helpers.exec(`pnpm add ${globalDevDependencies.join(" ")} --save-dev --ignore-workspace-root-check`);
-                await helpers.exec(`pnpm add ${localDevDependencies.join(" ")} --save-dev --filter ${data.projectName}`);
+                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 install");
             } catch (error) {
                 throw createError("pnpm", error);
@@ -476,7 +496,7 @@ const label$2 = (message)=>`${message} 🔨`;
     const projectRootPath = resolveFromProjectDirectory("./");
     const templateExpressionRegExp = /{{(.*?)}}/g;
     const evaluate = (content)=>{
-        return content.replace(templateExpressionRegExp, (_, key)=>dataModel[key] || "");
+        return content.replaceAll(templateExpressionRegExp, (_, key)=>dataModel[key] || "");
     };
     /** Copy the template before mutations. */ cpSync(templateRootPath, projectRootPath, {
         force: true,
@@ -484,15 +504,15 @@ const label$2 = (message)=>`${message} 🔨`;
     });
     /** 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, "utf-8"));
+        const content = evaluate(readFileSync(templateFilePath, "utf8"));
         renameSync(templateFilePath, projectFilePath);
-        writeFileSync(projectFilePath, content, "utf-8");
+        writeFileSync(projectFilePath, content, "utf8");
     });
     /** Template folder mutations. */ new fdir().withBasePath().onlyDirs().filter((path)=>{
-        return Boolean(templateExpressionRegExp.exec(path));
+        return templateExpressionRegExp.test(path);
     }).crawl(projectRootPath).sync()// Re-order from longest to lowest path length to apply first renaming operations on deepest file structure
     .sort((a, b)=>b.length - a.length).forEach((templateFolderPath)=>{
-        const newPath = templateFolderPath.replace(templateExpressionRegExp, (_, dataModelKey)=>{
+        const newPath = templateFolderPath.replaceAll(templateExpressionRegExp, (_, dataModelKey)=>{
             return dataModel[dataModelKey];
         });
         renameSync(templateFolderPath, newPath);
@@ -524,7 +544,12 @@ const createCleanCommand = (program)=>{
         }
     }).task({
         handler ({ files }) {
-            helpers.message(`Removed assets: ${files.join(", ")}\n`, {
+            helpers.message(files.join("\n   "), {
+                label: "Removed assets",
+                lineBreak: {
+                    end: false,
+                    start: true
+                },
                 type: "information"
             });
         },
@@ -535,14 +560,17 @@ const createCleanCommand = (program)=>{
 };
 const label$1 = (message)=>`${message} 🧹`;
 const cleanFiles = async (files)=>{
-    return helpers.exec(`rm -rf ${files.join(" ")}`);
+    return Promise.all(files.map(async (file)=>rm(file, {
+            force: true,
+            recursive: true
+        })));
 };
 const isDirectoryExistAndNotEmpty = (path)=>{
     return existsSync(path) && readdirSync(path).length > 0;
 };
 const retrieveIgnoredFiles = async ()=>{
-    const rawFiles = await helpers.exec(`git clean -fdXn | grep -v '${PRESERVE_FILES.join("\\|")}' | cut -c 14-`);
-    return rawFiles.split(/\n/).filter(Boolean);
+    const rawFiles = await helpers.exec("git clean -fdXn");
+    return rawFiles.split(/\n|\r\n/).filter((cleanOutput)=>!PRESERVE_FILES.some((excludedFile)=>cleanOutput.includes(excludedFile))).map((cleanOutput)=>cleanOutput.split(" ").at(-1));
 };
 const PRESERVE_FILES = [
     "node_modules"
@@ -559,25 +587,25 @@ const checkTypes = async ()=>{
 const checkPackages = async ()=>{
     const stdout = await helpers.exec("pnpm recursive ls --json");
     const checkPackagesVersionMismatch = createPackagesVersionMismatchChecker();
-    const packages = JSON.parse(stdout).map((pkg)=>{
-        const pkgPath = join(pkg.path, "package.json");
-        assert(pkg.name, ()=>createPackageError(`\`${pkgPath}\` must have a name field.`));
-        const pkgContent = require(pkgPath);
-        const peerDependencies = pkgContent.peerDependencies ?? {};
-        const devDependencies = pkgContent.devDependencies ?? {};
-        const dependencies = pkgContent.dependencies ?? {};
+    const packages = JSON.parse(stdout).map((package_)=>{
+        const packagePath = join(package_.path, "package.json");
+        assert(package_.name, ()=>createPackageError(`\`${packagePath}\` must have a name field.`));
+        const packageContent = require(packagePath);
+        const peerDependencies = packageContent.peerDependencies ?? {};
+        const devDependencies = packageContent.devDependencies ?? {};
+        const dependencies = packageContent.dependencies ?? {};
         return {
-            name: pkg.name,
+            name: package_.name,
             dependencies,
             devDependencies,
             peerDependencies
         };
     });
-    for (const pkg of packages){
+    for (const package_ of packages){
         // Check version mismatches to guarantee a single copy for a given package in the monorepo (use case: prevent singleton-like issues with React contexts)
-        checkPackagesVersionMismatch(pkg);
+        checkPackagesVersionMismatch(package_);
         // Check version range accordingly to our dependency guidelines (ie. dev dependencies must be pinned and dependencies must have caret)
-        checkPackagesVersionRange(pkg);
+        checkPackagesVersionRange(package_);
     }
 };
 const checkPackagesVersionRange = ({ name, dependencies, devDependencies, peerDependencies })=>{
@@ -587,13 +615,11 @@ const checkPackagesVersionRange = ({ name, dependencies, devDependencies, peerDe
             name: dependencyName,
             consumedBy: name
         });
-        if (version !== "workspace:*" && !/^\d/.exec(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:*" && !/^\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.`, {
             name: dependencyName,
             consumedBy: name
         });
     }
-    const isPreReleaseVersion = (version)=>/\d+\.\d+\.\d+-(alpha|beta|experimental|next|rc).*/.exec(version);
-    const hasNoCaret = (version)=>!isPreReleaseVersion(version) && !/^\^/.exec(version);
     for (const dependencyName of Object.keys(dependencies)){
         const version = dependencies[dependencyName];
         assertVersion(version, {
@@ -623,12 +649,12 @@ const checkPackagesVersionRange = ({ name, dependencies, devDependencies, peerDe
 };
 const createPackagesVersionMismatchChecker = ()=>{
     const monorepoDependencies = new Map();
-    const monorepoDevDependencies = new Map();
-    const lint = (pkg, type)=>{
-        const pkgName = pkg.name;
-        const isDev = type === "development";
-        const store = isDev ? monorepoDevDependencies : monorepoDependencies;
-        const dependencies = isDev ? pkg.devDependencies : pkg.dependencies;
+    const monorepoDevelopmentDependencies = new Map();
+    const lint = (package_, type)=>{
+        const packageName = package_.name;
+        const isDevelopment = type === "development";
+        const store = isDevelopment ? monorepoDevelopmentDependencies : monorepoDependencies;
+        const dependencies = isDevelopment ? package_.devDependencies : package_.dependencies;
         for (const dependencyName of Object.keys(dependencies)){
             const depVersion = dependencies[dependencyName];
             if (!depVersion) continue;
@@ -639,20 +665,20 @@ const createPackagesVersionMismatchChecker = ()=>{
             }
             const isSameMonorepoVersion = depVersion === storedVersion;
             if (!isSameMonorepoVersion) {
-                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}\`.`, {
+                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}\`).`, {
                     name: dependencyName,
-                    consumedBy: pkgName
+                    consumedBy: packageName
                 });
             }
         }
     };
-    return (pkg)=>{
-        lint(pkg, "development");
-        lint(pkg, "production");
+    return (package_)=>{
+        lint(package_, "development");
+        lint(package_, "production");
     };
 };
 const createPackageError = (message, context)=>{
-    return createError("stack check", !context ? message : `\`${context.name}\` consumed by \`${context.consumedBy}\` doesn't conform to \`package.json\` guidelines.\n${message}`);
+    return createError("stack check", !context ? message : `\`${context.name}\` consumed by \`${context.consumedBy}\` doesn't conform to package guidelines.\n${message}`);
 };
 function assertVersion(version, { name, consumedBy }) {
     assert(version, ()=>createPackageError(`\`${name}\` must have a valid version specified (current version equals to \`${String(version)}\`).`, {
@@ -660,6 +686,8 @@ function assertVersion(version, { name, consumedBy }) {
             consumedBy
         }));
 }
+const isPreReleaseVersion = (version)=>/\d+\.\d+\.\d+-(alpha|beta|experimental|next|rc).*/.exec(version);
+const hasNoCaret = (version)=>!isPreReleaseVersion(version) && !version.startsWith("^");
 
 const checkLinter = eslint({
     isFixMode: false
@@ -688,15 +716,21 @@ const createCheckCommand = (program)=>{
         name: "only",
         description: `Run only one specified task (accepted value: ${ONLY_VALUES.join(", ")})`,
         defaultValue: undefined
+    }).task({
+        handler (_, argv) {
+            logCheckableFiles(argv.operands);
+        },
+        skip: ifOnlyDefinedAndNotEqualTo("linter")
     }).task({
         label: label("Prepare the project"),
         async handler () {
             await turbo("build", {
+                excludeExamples: true,
                 hasLiveOutput: false
             });
         },
         skip ({ only }) {
-            return only === "commit"; // No need to build if only commitlint is run
+            return only === "commit"; // No need to build if only commit is checked
         }
     }).task({
         label: label("Check package guidelines"),
@@ -759,7 +793,7 @@ const createProgram = (...commandFactories)=>{
                 type: "error"
             });
         },
-        version: VERSION
+        version: version
     });
     for (const commandBuilder of commandFactories){
         commandBuilder(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adbayb/stack",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "My opinionated JavaScript-based toolchain",
   "publishConfig": {
     "access": "public"
@@ -50,10 +50,10 @@
     "@changesets/cli": "^2.27.9",
     "@commitlint/cli": "^19.5.0",
     "@commitlint/config-conventional": "^19.5.0",
-    "@eslint/compat": "^1.2.2",
-    "@eslint/eslintrc": "^3.1.0",
+    "@eslint/compat": "^1.2.3",
+    "@eslint/eslintrc": "^3.2.0",
     "@stylistic/eslint-plugin": "^2.10.1",
-    "@vitest/eslint-plugin": "^1.1.8",
+    "@vitest/eslint-plugin": "^1.1.10",
     "eslint-config-prettier": "^9.1.0",
     "eslint-import-resolver-typescript": "^3.6.3",
     "eslint-plugin-depend": "^0.12.0",
@@ -61,18 +61,21 @@
     "eslint-plugin-jest-formatting": "^3.1.0",
     "eslint-plugin-jsdoc": "^50.5.0",
     "eslint-plugin-mdx": "^3.1.5",
-    "eslint-plugin-n": "^17.13.1",
+    "eslint-plugin-n": "^17.13.2",
     "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-react-hooks-extra": "^1.16.1",
     "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react-web-api": "^1.16.1",
     "eslint-plugin-react": "^7.37.2",
     "eslint-plugin-sonarjs": "^2.0.4",
     "eslint-plugin-sort-keys-custom-order": "^2.2.0",
+    "eslint-plugin-unicorn": "^56.0.0",
     "eslint": "^9.14.0",
     "fdir": "^6.4.2",
     "globals": "^15.12.0",
     "prettier": "^3.3.3",
-    "termost": "^1.2.0",
-    "turbo": "^2.2.3",
+    "termost": "^1.4.0",
+    "turbo": "^2.3.0",
     "typescript-eslint": "^8.14.0",
     "typescript": "^5.6.3"
   },