ts-repo-utils 5.0.2 → 5.2.0

package/dist/functions/workspace-utils/run-cmd-in-parallel.mjs

@@ -4,11 +4,15 @@ import { getWorkspacePackages } from './get-workspace-packages.mjs';
 
 /**
  * Executes a npm script command across all workspace packages in parallel.
+ *
  * @param options - Configuration options for the parallel execution
- * @param options.rootPackageJsonDir - The directory containing the root package.json file
+ * @param options.rootPackageJsonDir - The directory containing the root
+ *   package.json file
  * @param options.cmd - The npm script command to execute in each package
- * @param options.concurrency - Maximum number of packages to process simultaneously (default: 3)
- * @param options.filterWorkspacePattern - Optional function to filter packages by name
+ * @param options.concurrency - Maximum number of packages to process
+ *   simultaneously (default: 3)
+ * @param options.filterWorkspacePattern - Optional function to filter packages
+ *   by name
  * @returns A promise that resolves when all packages have completed execution
  */
 const runCmdInParallelAcrossWorkspaces = async ({ rootPackageJsonDir, cmd, concurrency = 3, filterWorkspacePattern, }) => {
@@ -20,8 +24,8 @@ const runCmdInParallelAcrossWorkspaces = async ({ rootPackageJsonDir, cmd, concu
         await executeParallel(filteredPackages, cmd, concurrency);
         console.log(`\n✅ ${cmd} completed successfully`);
     }
-    catch (err) {
-        console.error(`\n❌ ${cmd} failed:`, err instanceof Error ? err.message : (err?.toString() ?? ''));
+    catch (error) {
+        console.error(`\n❌ ${cmd} failed:`, error instanceof Error ? error.message : (error?.toString() ?? ''));
         process.exit(1);
     }
 };

package/dist/functions/workspace-utils/run-cmd-in-parallel.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run-cmd-in-parallel.mjs","sources":["../../../src/functions/workspace-utils/run-cmd-in-parallel.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;AAQG;AACI,MAAM,gCAAgC,GAAG,OAAO,EACrD,kBAAkB,EAClB,GAAG,EACH,WAAW,GAAG,CAAC,EACf,sBAAsB,GAMtB,KAAmB;AACnB,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GACpB,sBAAsB,KAAK;AACzB,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,eAAe,CAAC,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;AACzD,QAAA,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAA,uBAAA,CAAyB,CAAC;IAClD;IAAE,OAAO,GAAG,EAAE;AACZ,QAAA,OAAO,CAAC,KAAK,CACX,CAAA,IAAA,EAAO,GAAG,CAAA,QAAA,CAAU,EACpB,GAAG,YAAY,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAC7D;AACD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;;;;"}
+{"version":3,"file":"run-cmd-in-parallel.mjs","sources":["../../../src/functions/workspace-utils/run-cmd-in-parallel.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;AAYG;AACI,MAAM,gCAAgC,GAAG,OAAO,EACrD,kBAAkB,EAClB,GAAG,EACH,WAAW,GAAG,CAAC,EACf,sBAAsB,GAMtB,KAAmB;AACnB,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GACpB,sBAAsB,KAAK;AACzB,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,eAAe,CAAC,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;AACzD,QAAA,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAA,uBAAA,CAAyB,CAAC;IAClD;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CACX,CAAA,IAAA,EAAO,GAAG,CAAA,QAAA,CAAU,EACpB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CACnE;AACD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;;;;"}

package/dist/functions/workspace-utils/run-cmd-in-stages.d.mts

@@ -1,13 +1,17 @@
 #!/usr/bin/env tsx
 /**
- * Executes a npm script command across all workspace packages in dependency order stages.
- * Packages are grouped into stages where each stage contains packages whose
- * dependencies have been completed in previous stages.
+ * Executes a npm script command across all workspace packages in dependency
+ * order stages. Packages are grouped into stages where each stage contains
+ * packages whose dependencies have been completed in previous stages.
+ *
  * @param options - Configuration options for the staged execution
- * @param options.rootPackageJsonDir - The directory containing the root package.json file
+ * @param options.rootPackageJsonDir - The directory containing the root
+ *   package.json file
  * @param options.cmd - The npm script command to execute in each package
- * @param options.concurrency - Maximum number of packages to process simultaneously within each stage (default: 3)
- * @param options.filterWorkspacePattern - Optional function to filter packages by name
+ * @param options.concurrency - Maximum number of packages to process
+ *   simultaneously within each stage (default: 3)
+ * @param options.filterWorkspacePattern - Optional function to filter packages
+ *   by name
  * @returns A promise that resolves when all stages have completed execution
  */
 export declare const runCmdInStagesAcrossWorkspaces: ({ rootPackageJsonDir, cmd, concurrency, filterWorkspacePattern, }: Readonly<{

package/dist/functions/workspace-utils/run-cmd-in-stages.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"run-cmd-in-stages.d.mts","sourceRoot":"","sources":["../../../src/functions/workspace-utils/run-cmd-in-stages.mts"],"names":[],"mappings":";AAKA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,GAAU,mEAKlD,QAAQ,CAAC;IACV,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D,CAAC,KAAG,OAAO,CAAC,IAAI,CAkBhB,CAAC"}
+{"version":3,"file":"run-cmd-in-stages.d.mts","sourceRoot":"","sources":["../../../src/functions/workspace-utils/run-cmd-in-stages.mts"],"names":[],"mappings":";AAKA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,8BAA8B,GAAU,mEAKlD,QAAQ,CAAC;IACV,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D,CAAC,KAAG,OAAO,CAAC,IAAI,CAkBhB,CAAC"}

package/dist/functions/workspace-utils/run-cmd-in-stages.mjs

@@ -3,14 +3,18 @@ import { executeStages } from './execute-parallel.mjs';
 import { getWorkspacePackages } from './get-workspace-packages.mjs';
 
 /**
- * Executes a npm script command across all workspace packages in dependency order stages.
- * Packages are grouped into stages where each stage contains packages whose
- * dependencies have been completed in previous stages.
+ * Executes a npm script command across all workspace packages in dependency
+ * order stages. Packages are grouped into stages where each stage contains
+ * packages whose dependencies have been completed in previous stages.
+ *
  * @param options - Configuration options for the staged execution
- * @param options.rootPackageJsonDir - The directory containing the root package.json file
+ * @param options.rootPackageJsonDir - The directory containing the root
+ *   package.json file
  * @param options.cmd - The npm script command to execute in each package
- * @param options.concurrency - Maximum number of packages to process simultaneously within each stage (default: 3)
- * @param options.filterWorkspacePattern - Optional function to filter packages by name
+ * @param options.concurrency - Maximum number of packages to process
+ *   simultaneously within each stage (default: 3)
+ * @param options.filterWorkspacePattern - Optional function to filter packages
+ *   by name
  * @returns A promise that resolves when all stages have completed execution
  */
 const runCmdInStagesAcrossWorkspaces = async ({ rootPackageJsonDir, cmd, concurrency = 3, filterWorkspacePattern, }) => {
@@ -22,8 +26,8 @@ const runCmdInStagesAcrossWorkspaces = async ({ rootPackageJsonDir, cmd, concurr
         await executeStages(filteredPackages, cmd, concurrency);
         console.log(`\n✅ ${cmd} completed successfully`);
     }
-    catch (err) {
-        console.error(`\n❌ ${cmd} failed:`, err instanceof Error ? err.message : (err?.toString() ?? ''));
+    catch (error) {
+        console.error(`\n❌ ${cmd} failed:`, error instanceof Error ? error.message : (error?.toString() ?? ''));
         process.exit(1);
     }
 };

package/dist/functions/workspace-utils/run-cmd-in-stages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run-cmd-in-stages.mjs","sources":["../../../src/functions/workspace-utils/run-cmd-in-stages.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;AAUG;AACI,MAAM,8BAA8B,GAAG,OAAO,EACnD,kBAAkB,EAClB,GAAG,EACH,WAAW,GAAG,CAAC,EACf,sBAAsB,GAMtB,KAAmB;AACnB,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GACpB,sBAAsB,KAAK;AACzB,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,aAAa,CAAC,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;AACvD,QAAA,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAA,uBAAA,CAAyB,CAAC;IAClD;IAAE,OAAO,GAAG,EAAE;AACZ,QAAA,OAAO,CAAC,KAAK,CACX,CAAA,IAAA,EAAO,GAAG,CAAA,QAAA,CAAU,EACpB,GAAG,YAAY,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAC7D;AACD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;;;;"}
+{"version":3,"file":"run-cmd-in-stages.mjs","sources":["../../../src/functions/workspace-utils/run-cmd-in-stages.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;;;AAcG;AACI,MAAM,8BAA8B,GAAG,OAAO,EACnD,kBAAkB,EAClB,GAAG,EACH,WAAW,GAAG,CAAC,EACf,sBAAsB,GAMtB,KAAmB;AACnB,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GACpB,sBAAsB,KAAK;AACzB,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,aAAa,CAAC,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;AACvD,QAAA,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAA,uBAAA,CAAyB,CAAC;IAClD;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CACX,CAAA,IAAA,EAAO,GAAG,CAAA,QAAA,CAAU,EACpB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CACnE;AACD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;;;;"}

package/dist/globals.d.mts

@@ -1 +1,2 @@
+/* eslint-disable import/unambiguous */
 /// <reference types="ts-type-forge" />

package/dist/node-global.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"node-global.d.mts","sourceRoot":"","sources":["../src/node-global.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAarD,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAE/B,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,EAAE,EAAE,OAAO,GAAG,CAAC;IACrB,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;CAC1B"}
+{"version":3,"file":"node-global.d.mts","sourceRoot":"","sources":["../src/node-global.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAcrD,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAE/B,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,EAAE,EAAE,OAAO,GAAG,CAAC;IACrB,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;CAC1B"}

package/dist/node-global.mjs

@@ -10,5 +10,6 @@ const globalsDef = {
     fs: fs_,
     glob: glob_,
 };
+// eslint-disable-next-line functional/immutable-data
 Object.assign(globalThis, globalsDef);
 //# sourceMappingURL=node-global.mjs.map

package/dist/node-global.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node-global.mjs","sources":["../src/node-global.mts"],"sourcesContent":[null],"names":["$_"],"mappings":";;;;;AAKA,MAAM,UAAU,GAAG;AACjB,IAAA,CAAC,EAAEA,CAAE;IACL,IAAI,EAAE,OAAO,CAAC,GAAG;AAEjB,IAAA,IAAI,EAAE,KAAK;AACX,IAAA,EAAE,EAAE,GAAG;AACP,IAAA,IAAI,EAAE,KAAK;CACH;AAEV,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC"}
+{"version":3,"file":"node-global.mjs","sources":["../src/node-global.mts"],"sourcesContent":[null],"names":["$_"],"mappings":";;;;;AAOA,MAAM,UAAU,GAAG;AACjB,IAAA,CAAC,EAAEA,CAAE;IACL,IAAI,EAAE,OAAO,CAAC,GAAG;AAEjB,IAAA,IAAI,EAAE,KAAK;AACX,IAAA,EAAE,EAAE,GAAG;AACP,IAAA,IAAI,EAAE,KAAK;CACH;AAEV;AACA,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-repo-utils",
-  "version": "5.0.2",
+  "version": "5.2.0",
   "private": false,
   "keywords": [
     "typescript"
@@ -16,13 +16,13 @@
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/index.d.mts",
+        "types": "./dist/type.d.mts",
         "default": "./dist/index.mjs"
       }
     }
   },
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "types": "./dist/type.d.mts",
   "files": [
     "src",
     "dist",
@@ -47,7 +47,7 @@
     "test:ui": "npm run z:vitest -- --ui",
     "testw": "npm run z:vitest -- watch",
     "tsc": "tsc --noEmit",
-    "tscw": "tsc --noEmit --watch",
+    "tscw": "tsc --noEmit --watch -p ./tsconfig.json",
     "type-check": "tsc --noEmit",
     "update-packages": "npx npm-check-updates -u --install always",
     "z:vitest": "vitest --config ./configs/vitest.config.ts"
@@ -57,7 +57,7 @@
     "fast-glob": "^3.3.3",
     "micromatch": "^4.0.8",
     "prettier": "^3.6.2",
-    "ts-data-forge": "^3.0.2"
+    "ts-data-forge": "^3.0.4"
   },
   "devDependencies": {
     "@eslint/js": "^9.31.0",
@@ -69,21 +69,32 @@
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^11.0.3",
-    "@semantic-release/npm": "^12.0.1",
+    "@semantic-release/npm": "^12.0.2",
     "@semantic-release/release-notes-generator": "^14.0.3",
     "@types/node": "^24.1.0",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
     "conventional-changelog-conventionalcommits": "^9.1.0",
-    "cspell": "^9.1.5",
+    "cspell": "^9.2.0",
     "dedent": "^1.6.0",
-    "eslint": "^9.31.0",
+    "eslint": "^9.32.0",
+    "eslint-import-resolver-typescript": "4.4.4",
+    "eslint-plugin-array-func": "5.0.2",
+    "eslint-plugin-functional": "9.0.2",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-prefer-arrow-functions": "3.6.2",
+    "eslint-plugin-promise": "7.2.1",
+    "eslint-plugin-security": "3.0.1",
+    "eslint-plugin-unicorn": "60.0.0",
+    "eslint-plugin-vitest": "0.5.4",
     "markdownlint-cli2": "^0.18.1",
+    "prettier-plugin-jsdoc": "^1.3.3",
     "prettier-plugin-organize-imports": "^4.2.0",
     "prettier-plugin-packagejson": "^2.5.19",
     "rollup": "^4.45.1",
     "semantic-release": "^24.2.7",
     "ts-type-forge": "^2.1.1",
+    "tslib": "^2.8.1",
     "tsx": "^4.20.3",
     "typedoc": "^0.28.7",
     "typedoc-plugin-markdown": "^4.7.1",

package/src/functions/assert-ext.mts

@@ -1,27 +1,32 @@
-import { isString } from 'ts-data-forge';
+import { Arr, type IMap, isString } from 'ts-data-forge';
 import '../node-global.mjs';
 import { assertPathExists } from './assert-path-exists.mjs';
 
-/**
- * Configuration for directory extension checking.
- */
+/** Configuration for directory extension checking. */
 export type CheckExtConfig = DeepReadonly<{
   /** Array of directory paths and their expected extensions */
   directories: {
     /** Directory path to check */
     path: string;
 
-    /** Expected file extension(s) (including the dot). Can be a single extension or an array of valid extensions */
+    /**
+     * Expected file extension(s) (including the dot). Can be a single extension
+     * or an array of valid extensions
+     */
     extension: `.${string}` | `.${string}`[];
 
-    /** Optional glob patterns to ignore (defaults to ['tsconfig.json', 'globals.d.*']) */
+    /**
+     * Optional glob patterns to ignore (defaults to ['tsconfig.json',
+     * 'globals.d.*'])
+     */
     ignorePatterns?: string[];
   }[];
 }>;
 
 /**
- * Validates that all files in specified directories have the correct extensions.
- * Exits with code 1 if any files have incorrect extensions.
+ * Validates that all files in specified directories have the correct
+ * extensions. Exits with code 1 if any files have incorrect extensions.
+ *
  * @param config - Configuration specifying directories and expected extensions.
  */
 export const assertExt = async (config: CheckExtConfig): Promise<void> => {
@@ -47,22 +52,35 @@ export const assertExt = async (config: CheckExtConfig): Promise<void> => {
   if (allIncorrectFiles.length > 0) {
     const generateErrorMessage = (): string => {
       // Group directories by extension for a cleaner message
-      const extensionGroups = new Map<string, string[]>();
-
-      for (const { path: dirPath, extension } of config.directories) {
-        const relativePath = path.relative(process.cwd(), dirPath);
-        const extKey = isString(extension) ? extension : extension.join(' or ');
-        if (!extensionGroups.has(extKey)) {
-          extensionGroups.set(extKey, []);
-        }
-        extensionGroups.get(extKey)?.push(relativePath);
-      }
+      const extensionGroups: IMap<
+        string,
+        readonly Readonly<{
+          relativePath: string;
+          extKey: string;
+        }>[]
+      > = Arr.groupBy(
+        config.directories.map(({ path: dirPath, extension }) => {
+          const relativePath = path.relative(process.cwd(), dirPath);
+          const extKey = isString(extension)
+            ? extension
+            : extension.join(' or ');
+
+          return {
+            relativePath,
+            extKey,
+          };
+        }),
+        ({ extKey }) => extKey,
+      );
 
       // Generate message parts for each extension
       const messageParts = Array.from(
         extensionGroups.entries(),
         ([ext, dirs]) => {
-          const dirList = dirs.length === 1 ? dirs[0] : dirs.join(', ');
+          const dirList =
+            dirs.length === 1
+              ? dirs[0]?.relativePath
+              : dirs.map((d) => d.relativePath).join(', ');
           return `${dirList} should have ${ext} extension`;
         },
       );
@@ -86,6 +104,7 @@ export const assertExt = async (config: CheckExtConfig): Promise<void> => {
 
 /**
  * Checks if all files in a directory have the expected extension.
+ *
  * @param dir - The directory to check.
  * @param expectedExtensions - The expected file extensions.
  * @param ignorePatterns - Optional glob patterns to ignore.

package/src/functions/assert-path-exists.mts

@@ -2,6 +2,7 @@ import '../node-global.mjs';
 
 /**
  * Checks if a file or directory exists.
+ *
  * @param filePath - The path to check.
  * @returns True if the path exists.
  */
@@ -16,6 +17,7 @@ export const pathExists = async (filePath: string): Promise<boolean> => {
 
 /**
  * Validates that a path exists and exits with code 1 if it doesn't.
+ *
  * @param filePath - The path to validate.
  * @param description - Description for error message (defaults to 'Path').
  */

package/src/functions/assert-repo-is-clean.mts

@@ -3,6 +3,7 @@ import '../node-global.mjs';
 
 /**
  * Checks if the repository has uncommitted changes.
+ *
  * @returns True if the repo is dirty, false otherwise.
  * @throws Error if git command fails.
  */
@@ -14,8 +15,8 @@ export const repoIsDirty = async (
 };
 
 /**
- * Checks if the repository is clean and exits with code 1 if it is dirty.
- * Shows git status and diff output before exiting.
+ * Checks if the repository is clean and exits with code 1 if it is dirty. Shows
+ * git status and diff output before exiting.
  */
 export const assertRepoIsClean = async (
   options?: Readonly<{ silent?: boolean }>,
@@ -56,6 +57,7 @@ export const assertRepoIsClean = async (
 
 /**
  * Gets the git status of the repository.
+ *
  * @returns An object containing status information.
  */
 const getGitStatus = async (

package/src/functions/diff.mts

@@ -2,9 +2,7 @@ import { type ExecException } from 'node:child_process';
 import { Result } from 'ts-data-forge';
 import '../node-global.mjs';
 
-/**
- * Get files that have been changed (git status).
- */
+/** Get files that have been changed (git status). */
 export const getUntrackedFiles = async (
   options?: Readonly<{
     /** @default true */
@@ -42,9 +40,7 @@ export const getUntrackedFiles = async (
   return Result.ok(files);
 };
 
-/**
- * Get files that differ from the specified base branch or commit
- */
+/** Get files that differ from the specified base branch or commit */
 export const getDiffFrom = async (
   base: string,
   options?: Readonly<{

package/src/functions/diff.test.mts

@@ -3,12 +3,9 @@ import '../node-global.mjs';
 import { getDiffFrom, getUntrackedFiles } from './diff.mjs';
 
 describe('diff', () => {
-  // Use project root for test files to ensure git tracking
-  const testFiles: string[] = [];
-
-  afterEach(async () => {
-    // Clean up test files
-    for (const file of testFiles) {
+  // Helper function to clean up test files
+  const cleanupTestFiles = async (files: Set<string>): Promise<void> => {
+    for (const file of files) {
       try {
         // eslint-disable-next-line no-await-in-loop
         await fs.rm(file, { force: true });
@@ -16,8 +13,7 @@ describe('diff', () => {
         // Ignore cleanup errors
       }
     }
-    testFiles.length = 0;
-  });
+  };
 
   describe('getUntrackedFiles', () => {
     test('should return empty array when no files are changed', async () => {
@@ -30,10 +26,12 @@ describe('diff', () => {
     });
 
     test('should detect newly created files', async () => {
+      const mut_testFiles = new Set<string>();
+
       // Create a new file in project root
       const testFileName = 'test-new-file.tmp';
       const testFilePath = path.join(process.cwd(), testFileName);
-      testFiles.push(testFilePath);
+      mut_testFiles.add(testFilePath);
 
       await fs.writeFile(testFilePath, 'test content');
 
@@ -42,42 +40,51 @@ describe('diff', () => {
       expect(Result.isOk(result)).toBe(true);
       if (Result.isOk(result)) {
         const files = result.value;
-        expect(files.some((file) => file === testFileName)).toBe(true);
+        expect(files).toContain(testFileName);
       }
+
+      await cleanupTestFiles(mut_testFiles);
     });
 
     test('should detect modified existing files', async () => {
+      const mut_testFiles = new Set<string>();
+
       // Use an existing file in the project that we can modify safely
       const testFileName = 'test-modify-file.tmp';
-      const testFilePath = path.join(process.cwd(), testFileName);
-      testFiles.push(testFilePath);
+      const mut_testFilePath = path.join(process.cwd(), testFileName);
+      mut_testFiles.add(mut_testFilePath);
 
       // Create and commit the file first
-      await fs.writeFile(testFilePath, 'initial content');
+      await fs.writeFile(mut_testFilePath, 'initial content');
 
       // Add to git to track it
       await $(`git add ${testFileName}`, { silent: true });
 
       // Modify the file
-      await fs.writeFile(testFilePath, 'modified content');
+      await fs.writeFile(mut_testFilePath, 'modified content');
 
       const result = await getUntrackedFiles({ silent: true });
 
       expect(Result.isOk(result)).toBe(true);
       if (Result.isOk(result)) {
         const files = result.value;
-        expect(files.some((file) => file === testFileName)).toBe(false);
+        expect(files).not.toContain(testFileName);
       }
 
       // Reset git state
       await $(`git reset HEAD ${testFileName}`, { silent: true });
+
+      await cleanupTestFiles(mut_testFiles);
     });
 
     test('should detect multiple types of changes', async () => {
+      const mut_testFiles = new Set<string>();
+
       // Create multiple test files
       const newFile = path.join(process.cwd(), 'test-new-file.tmp');
       const modifyFile = path.join(process.cwd(), 'test-modify-file.tmp');
-      testFiles.push(newFile, modifyFile);
+      mut_testFiles.add(newFile);
+      mut_testFiles.add(modifyFile);
 
       // Create new file
       await fs.writeFile(newFile, 'new file content');
@@ -94,14 +101,14 @@ describe('diff', () => {
       expect(Result.isOk(result)).toBe(true);
       if (Result.isOk(result)) {
         const files = result.value;
-        expect(files.some((file) => file === 'test-new-file.tmp')).toBe(true);
-        expect(files.some((file) => file === 'test-modify-file.tmp')).toBe(
-          false,
-        );
+        expect(files).toContain('test-new-file.tmp');
+        expect(files).not.toContain('test-modify-file.tmp');
       }
 
       // Reset git state
       await $(`git reset HEAD test-modify-file.tmp`, { silent: true });
+
+      await cleanupTestFiles(mut_testFiles);
     });
 
     test('should exclude deleted files from results', async () => {
@@ -113,10 +120,10 @@ describe('diff', () => {
       if (Result.isOk(result)) {
         const files = result.value;
         // Verify no deleted files are included (status 'D')
-        files.forEach((file) => {
+        for (const file of files) {
           expect(typeof file).toBe('string');
           expect(file.length).toBeGreaterThan(0);
-        });
+        }
       }
     });
 
@@ -137,11 +144,11 @@ describe('diff', () => {
         const files = result.value;
 
         // Each file should be a non-empty string
-        files.forEach((file) => {
+        for (const file of files) {
           expect(typeof file).toBe('string');
           expect(file.trim()).toBe(file); // No leading/trailing whitespace
           expect(file.length).toBeGreaterThan(0);
-        });
+        }
       }
     });
 

package/src/functions/exec-async.mts

@@ -3,6 +3,7 @@ import { Result } from 'ts-data-forge';
 
 /**
  * Executes a shell command asynchronously.
+ *
  * @param cmd - The command to execute.
  * @param options - Optional configuration for command execution.
  * @returns A promise that resolves with the command result.
@@ -22,6 +23,7 @@ export const $ = (
   return new Promise((resolve) => {
     const execOptions = { timeout };
 
+    // eslint-disable-next-line security/detect-child-process
     exec(cmd, execOptions, (error, stdout, stderr) => {
       if (!silent) {
         if (stdout !== '') {

package/src/functions/format.mts

@@ -5,6 +5,7 @@ import { getDiffFrom, getUntrackedFiles } from './diff.mjs';
 
 /**
  * Format a list of files using Prettier
+ *
  * @param files - Array of file paths to format
  * @returns 'ok' if successful, 'err' if any errors occurred
  */
@@ -74,6 +75,7 @@ export const formatFilesList = async (
 
 /**
  * Format files matching the given glob pattern using Prettier
+ *
  * @param pathGlob - Glob pattern to match files
  * @returns 'ok' if successful, 'err' if any errors occurred
  */
@@ -107,6 +109,7 @@ export const formatFiles = async (
 
 /**
  * Format only files that have been changed (git status)
+ *
  * @param options - Options for formatting
  * @returns 'ok' if successful, 'err' if any errors occurred
  */
@@ -169,10 +172,14 @@ export const formatUntracked = async (
 
 /**
  * Format only files that differ from the specified base branch or commit
- * @param base - Base branch name or commit hash to compare against (defaults to 'main')
+ *
+ * @param base - Base branch name or commit hash to compare against (defaults to
+ *   'main')
  * @param options - Options for formatting
- * @param options.includeUntracked - Include untracked files in addition to diff files (default is true)
- * @param options.silent - Silent mode to suppress command output (default is false)
+ * @param options.includeUntracked - Include untracked files in addition to diff
+ *   files (default is true)
+ * @param options.silent - Silent mode to suppress command output (default is
+ *   false)
  * @returns 'ok' if successful, 'err' if any errors occurred
  */
 export const formatDiffFrom = async (

package/src/functions/format.test.mts

@@ -27,6 +27,7 @@ describe('formatFiles', () => {
     fs.readFile(filePath, 'utf8');
 
   test('should format files matching glob pattern', async () => {
+    vi.clearAllMocks();
     // Setup test directory
     await fs.mkdir(testDir, { recursive: true });
 
@@ -84,6 +85,7 @@ describe('formatFiles', () => {
   });
 
   test('should return ok when no files match pattern', async () => {
+    vi.clearAllMocks();
     const result = await formatFiles('/non-existent-path/*.ts', {
       silent: true,
     });
@@ -91,6 +93,7 @@ describe('formatFiles', () => {
   });
 
   test('should handle nested directories with glob pattern', async () => {
+    vi.clearAllMocks();
     // Setup test directory with nested structure
     await fs.mkdir(path.join(testDir, 'src', 'utils'), { recursive: true });
 
@@ -143,6 +146,7 @@ describe('formatFilesList', () => {
     fs.readFile(filePath, 'utf8');
 
   test('should format a list of files', async () => {
+    vi.clearAllMocks();
     await fs.mkdir(testDir, { recursive: true });
 
     try {
@@ -189,6 +193,7 @@ describe('formatFilesList', () => {
   });
 
   test('should return ok for empty file list', async () => {
+    vi.clearAllMocks();
     const result = await formatFilesList([], {
       silent: true,
     });
@@ -211,11 +216,8 @@ describe('formatDiffFrom', () => {
   const readTestFile = async (filePath: string): Promise<string> =>
     fs.readFile(filePath, 'utf8');
 
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
   test('should format files from diff', async () => {
+    vi.clearAllMocks();
     await fs.mkdir(testDir, { recursive: true });
 
     try {
@@ -250,6 +252,7 @@ describe('formatDiffFrom', () => {
   });
 
   test('should include untracked files when option is set', async () => {
+    vi.clearAllMocks();
     await fs.mkdir(testDir, { recursive: true });
 
     try {
@@ -302,6 +305,7 @@ describe('formatDiffFrom', () => {
   });
 
   test('should deduplicate files when including untracked', async () => {
+    vi.clearAllMocks();
     await fs.mkdir(testDir, { recursive: true });
 
     try {