@xylabs/ts-scripts-yarn3 7.4.9 → 7.4.11

package/dist/actions/deplint/index.mjs

@@ -1,5 +1,5 @@
 // src/actions/deplint/deplint.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 
 // src/lib/yarn/workspace/yarnWorkspaces.ts
 import { spawnSync } from "child_process";
@@ -20,6 +20,27 @@ var yarnWorkspace = (pkg) => {
   return workspace;
 };
 
+// src/lib/loadConfig.ts
+import chalk from "chalk";
+import { cosmiconfig } from "cosmiconfig";
+import { TypeScriptLoader } from "cosmiconfig-typescript-loader";
+import deepmerge from "deepmerge";
+var config;
+var loadConfig = async (params) => {
+  if (config === void 0) {
+    const cosmicConfigResult = await cosmiconfig("xy", { cache: true, loaders: { ".ts": TypeScriptLoader() } }).search();
+    config = cosmicConfigResult?.config;
+    const configFilePath = cosmicConfigResult?.filepath;
+    if (configFilePath !== void 0) {
+      console.log(chalk.green(`Loaded config from ${configFilePath}`));
+      if (config.verbose) {
+        console.log(chalk.gray(`${JSON.stringify(config, null, 2)}`));
+      }
+    }
+  }
+  return deepmerge(config, params ?? {});
+};
+
 // src/actions/deplint/findFiles.ts
 import fs from "fs";
 
@@ -194,11 +215,11 @@ function getExternalImportsFromFiles({
   const allImportPaths = {};
   const distImportPaths = {};
   const distTypeImportPaths = {};
-  for (const path5 of allFiles) getImportsFromFile(path5, allImportPaths, allImportPaths).flat();
+  for (const path6 of allFiles) getImportsFromFile(path6, allImportPaths, allImportPaths).flat();
   const distTypeFiles = distFiles.filter(isDeclarationFile);
   const distCodeFiles = distFiles.filter((file) => !isDeclarationFile(file));
-  for (const path5 of distCodeFiles) getImportsFromFile(path5, distImportPaths, distImportPaths).flat();
-  for (const path5 of distTypeFiles) getImportsFromFile(path5, distTypeImportPaths, distTypeImportPaths).flat();
+  for (const path6 of distCodeFiles) getImportsFromFile(path6, distImportPaths, distImportPaths).flat();
+  for (const path6 of distTypeFiles) getImportsFromFile(path6, distTypeImportPaths, distTypeImportPaths).flat();
   const allImports = Object.keys(allImportPaths);
   const distImports = Object.keys(distImportPaths);
   const externalAllImports = removeInternalImports(allImports);
@@ -220,12 +241,12 @@ function getExternalImportsFromFiles({
 
 // src/actions/deplint/checkPackage/getUnlistedDependencies.ts
 import { builtinModules } from "module";
-import chalk from "chalk";
+import chalk2 from "chalk";
 function isListedOrBuiltin(imp, name, dependencies, peerDependencies) {
   return dependencies.includes(imp) || imp === name || dependencies.includes(`@types/${imp}`) || peerDependencies.includes(imp) || peerDependencies.includes(`@types/${imp}`) || builtinModules.includes(imp) || builtinModules.includes(`@types/${imp}`);
 }
 function logMissing(name, imp, importPaths) {
-  console.log(`[${chalk.blue(name)}] Missing dependency in package.json: ${chalk.red(imp)}`);
+  console.log(`[${chalk2.blue(name)}] Missing dependency in package.json: ${chalk2.red(imp)}`);
   if (importPaths[imp]) {
     console.log(`  ${importPaths[imp].join("\n ")}`);
   }
@@ -250,7 +271,7 @@ function getUnlistedDependencies({ name, location }, { dependencies, peerDepende
   }
   if (unlistedDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk.yellow(packageLocation)}
+    console.log(`  ${chalk2.yellow(packageLocation)}
 `);
   }
   return unlistedDependencies;
@@ -258,7 +279,7 @@ function getUnlistedDependencies({ name, location }, { dependencies, peerDepende
 
 // src/actions/deplint/checkPackage/getUnlistedDevDependencies.ts
 import { builtinModules as builtinModules2 } from "module";
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 function getUnlistedDevDependencies({ name, location }, {
   devDependencies,
   dependencies,
@@ -272,7 +293,7 @@ function getUnlistedDevDependencies({ name, location }, {
   for (const imp of externalAllImports) {
     if (!distImports.includes(imp) && imp !== name && !dependencies.includes(imp) && !dependencies.includes(`@types/${imp}`) && !peerDependencies.includes(imp) && !peerDependencies.includes(`@types/${imp}`) && !devDependencies.includes(imp) && !devDependencies.includes(`@types/${imp}`) && !builtinModules2.includes(imp)) {
       unlistedDevDependencies++;
-      console.log(`[${chalk2.blue(name)}] Missing devDependency in package.json: ${chalk2.red(imp)}`);
+      console.log(`[${chalk3.blue(name)}] Missing devDependency in package.json: ${chalk3.red(imp)}`);
       if (allImportPaths[imp]) {
         console.log(`  ${allImportPaths[imp].join("\n ")}`);
       }
@@ -280,40 +301,50 @@ function getUnlistedDevDependencies({ name, location }, {
   }
   if (unlistedDevDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk2.yellow(packageLocation)}
+    console.log(`  ${chalk3.yellow(packageLocation)}
 `);
   }
   return unlistedDevDependencies;
 }
 
 // src/actions/deplint/checkPackage/getUnusedDependencies.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 function getUnusedDependencies({ name, location }, { dependencies }, {
   externalDistImports,
   externalDistTypeImports,
   externalAllImports
-}) {
+}, exclude) {
   let unusedDependencies = 0;
   for (const dep of dependencies) {
+    if (exclude?.has(dep)) continue;
     if (!externalDistImports.includes(dep) && !externalDistImports.includes(dep.replace(/^@types\//, "")) && !externalDistTypeImports.includes(dep) && !externalDistTypeImports.includes(dep.replace(/^@types\//, ""))) {
       unusedDependencies++;
       if (externalAllImports.includes(dep)) {
-        console.log(`[${chalk3.blue(name)}] dependency should be devDependency in package.json: ${chalk3.red(dep)}`);
+        console.log(`[${chalk4.blue(name)}] dependency should be devDependency in package.json: ${chalk4.red(dep)}`);
       } else {
-        console.log(`[${chalk3.blue(name)}] Unused dependency in package.json: ${chalk3.red(dep)}`);
+        console.log(`[${chalk4.blue(name)}] Unused dependency in package.json: ${chalk4.red(dep)}`);
       }
     }
   }
   if (unusedDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk3.yellow(packageLocation)}
+    console.log(`  ${chalk4.yellow(packageLocation)}
 `);
   }
   return unusedDependencies;
 }
 
 // src/actions/deplint/checkPackage/getUnusedDevDependencies.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
+
+// src/actions/deplint/getCliReferencedPackagesFromFiles.ts
+import fs7 from "fs";
+import path5 from "path";
+import ts2 from "typescript";
+
+// src/actions/deplint/getScriptReferencedPackages.ts
+import fs6 from "fs";
+import path4 from "path";
 
 // src/actions/deplint/getRequiredPeerDependencies.ts
 import fs5 from "fs";
@@ -348,8 +379,6 @@ function getRequiredPeerDependencies(location, allDeps) {
 }
 
 // src/actions/deplint/getScriptReferencedPackages.ts
-import fs6 from "fs";
-import path4 from "path";
 function getBinNames(location, dep) {
   const depPkgPath = findDepPackageJson(location, dep);
   if (!depPkgPath) return [];
@@ -399,15 +428,101 @@ function getScriptReferencedPackages(location, allDeps) {
   return referenced;
 }
 
+// src/actions/deplint/getCliReferencedPackagesFromFiles.ts
+var shellCommandFunctions = /* @__PURE__ */ new Set(["execSync", "exec"]);
+var directExecFunctions = /* @__PURE__ */ new Set(["spawn", "spawnSync", "execFile", "execFileSync"]);
+var allExecFunctions = /* @__PURE__ */ new Set([...shellCommandFunctions, ...directExecFunctions]);
+function getCommandTokensFromFile(filePath) {
+  const tokens = /* @__PURE__ */ new Set();
+  let sourceCode;
+  try {
+    sourceCode = fs7.readFileSync(filePath, "utf8");
+  } catch {
+    return tokens;
+  }
+  const isMjsFile = filePath.endsWith(".mjs");
+  const sourceFile = ts2.createSourceFile(
+    path5.basename(filePath),
+    sourceCode,
+    ts2.ScriptTarget.Latest,
+    true,
+    isMjsFile ? ts2.ScriptKind.JS : void 0
+  );
+  function visit(node) {
+    if (ts2.isCallExpression(node) && node.arguments.length > 0) {
+      const fnName = getFunctionName(node.expression);
+      if (fnName && allExecFunctions.has(fnName)) {
+        const firstArg = node.arguments[0];
+        if (ts2.isStringLiteral(firstArg) || ts2.isNoSubstitutionTemplateLiteral(firstArg)) {
+          const value = firstArg.text;
+          if (shellCommandFunctions.has(fnName)) {
+            for (const token of tokenizeScript(value)) {
+              tokens.add(token);
+            }
+          } else {
+            tokens.add(value);
+          }
+        } else if (ts2.isTemplateExpression(firstArg)) {
+          const head = firstArg.head.text;
+          if (head) {
+            for (const token of tokenizeScript(head)) {
+              tokens.add(token);
+            }
+          }
+        }
+      }
+    }
+    ts2.forEachChild(node, visit);
+  }
+  visit(sourceFile);
+  return tokens;
+}
+function getFunctionName(expr) {
+  if (ts2.isIdentifier(expr)) {
+    return expr.text;
+  }
+  if (ts2.isPropertyAccessExpression(expr) && ts2.isIdentifier(expr.name)) {
+    return expr.name.text;
+  }
+  return void 0;
+}
+function getCliReferencedPackagesFromFiles(allFiles, location, allDeps) {
+  const allTokens = /* @__PURE__ */ new Set();
+  for (const file of allFiles) {
+    for (const token of getCommandTokensFromFile(file)) {
+      allTokens.add(token);
+    }
+  }
+  if (allTokens.size === 0) return /* @__PURE__ */ new Set();
+  const binToPackage = /* @__PURE__ */ new Map();
+  for (const dep of allDeps) {
+    for (const bin of getBinNames(location, dep)) {
+      binToPackage.set(bin, dep);
+    }
+  }
+  const referenced = /* @__PURE__ */ new Set();
+  for (const token of allTokens) {
+    const baseName = getBasePackageName(token);
+    if (allDeps.includes(baseName)) {
+      referenced.add(baseName);
+    }
+    const pkg = binToPackage.get(token);
+    if (pkg) {
+      referenced.add(pkg);
+    }
+  }
+  return referenced;
+}
+
 // src/actions/deplint/implicitDevDependencies.ts
-import fs7 from "fs";
+import fs8 from "fs";
 var hasFileWithExtension = (files, extensions) => files.some((f) => extensions.some((ext) => f.endsWith(ext)));
 var tsExtensions = [".ts", ".tsx", ".mts", ".cts"];
 var hasTypescriptFiles = ({ allFiles }) => hasFileWithExtension(allFiles, tsExtensions);
 var decoratorPattern = /^\s*@[a-zA-Z]\w*/m;
 var hasDecorators = ({ allFiles }) => allFiles.filter((f) => tsExtensions.some((ext) => f.endsWith(ext))).some((file) => {
   try {
-    const content = fs7.readFileSync(file, "utf8");
+    const content = fs8.readFileSync(file, "utf8");
     return decoratorPattern.test(content);
   } catch {
     return false;
@@ -420,7 +535,7 @@ function hasImportPlugin({ location, allDependencies }) {
     const pkgPath = findDepPackageJson(location, dep);
     if (!pkgPath) continue;
     try {
-      const pkg = JSON.parse(fs7.readFileSync(pkgPath, "utf8"));
+      const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf8"));
       const transitiveDeps = [
         ...Object.keys(pkg.dependencies ?? {}),
         ...Object.keys(pkg.peerDependencies ?? {})
@@ -472,10 +587,11 @@ var allExternalImports = ({
     ...externalDistTypeImports
   ]);
 };
-function isDevDepUsed(dep, allImports, implicitDeps, requiredPeers, scriptRefs) {
+function isDevDepUsed(dep, allImports, implicitDeps, requiredPeers, scriptRefs, cliRefs) {
   if (implicitDeps.has(dep)) return true;
   if (requiredPeers.has(dep)) return true;
   if (scriptRefs.has(dep)) return true;
+  if (cliRefs.has(dep)) return true;
   if (dep.startsWith("@types/")) {
     const baseName = dep.replace(/^@types\//, "");
     return allImports.has(baseName) || allImports.has(dep) || implicitDeps.has(baseName);
@@ -486,7 +602,7 @@ function getUnusedDevDependencies({ name, location }, {
   devDependencies,
   dependencies,
   peerDependencies
-}, sourceParams, fileContext) {
+}, sourceParams, fileContext, exclude) {
   const allImports = allExternalImports(sourceParams);
   const allDeps = [...dependencies, ...devDependencies, ...peerDependencies];
   const implicitDeps = getImplicitDevDependencies({
@@ -496,39 +612,42 @@ function getUnusedDevDependencies({ name, location }, {
   });
   const requiredPeers = getRequiredPeerDependencies(location, allDeps);
   const scriptRefs = getScriptReferencedPackages(location, allDeps);
+  const cliRefs = getCliReferencedPackagesFromFiles(fileContext.allFiles, location, allDeps);
   let unusedDevDependencies = 0;
   for (const dep of devDependencies) {
+    if (exclude?.has(dep)) continue;
     if (dependencies.includes(dep) || peerDependencies.includes(dep)) continue;
-    if (!isDevDepUsed(dep, allImports, implicitDeps, requiredPeers, scriptRefs)) {
+    if (!isDevDepUsed(dep, allImports, implicitDeps, requiredPeers, scriptRefs, cliRefs)) {
       unusedDevDependencies++;
-      console.log(`[${chalk4.blue(name)}] Unused devDependency in package.json: ${chalk4.red(dep)}`);
+      console.log(`[${chalk5.blue(name)}] Unused devDependency in package.json: ${chalk5.red(dep)}`);
     }
   }
   if (unusedDevDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk4.yellow(packageLocation)}
+    console.log(`  ${chalk5.yellow(packageLocation)}
 `);
   }
   return unusedDevDependencies;
 }
 
 // src/actions/deplint/checkPackage/getUnusedPeerDependencies.ts
-import chalk5 from "chalk";
-function getUnusedPeerDependencies({ name, location }, { peerDependencies, dependencies }, { externalDistImports, externalDistTypeImports }) {
+import chalk6 from "chalk";
+function getUnusedPeerDependencies({ name, location }, { peerDependencies, dependencies }, { externalDistImports, externalDistTypeImports }, exclude) {
   let unusedDependencies = 0;
   for (const dep of peerDependencies) {
+    if (exclude?.has(dep)) continue;
     if (!externalDistImports.includes(dep) && !externalDistImports.includes(dep.replace(/^@types\//, "")) && !externalDistTypeImports.includes(dep) && !externalDistTypeImports.includes(dep.replace(/^@types\//, ""))) {
       unusedDependencies++;
       if (dependencies.includes(dep)) {
-        console.log(`[${chalk5.blue(name)}] Unused peerDependency [already a dependency] in package.json: ${chalk5.red(dep)}`);
+        console.log(`[${chalk6.blue(name)}] Unused peerDependency [already a dependency] in package.json: ${chalk6.red(dep)}`);
       } else {
-        console.log(`[${chalk5.blue(name)}] Unused peerDependency in package.json: ${chalk5.red(dep)}`);
+        console.log(`[${chalk6.blue(name)}] Unused peerDependency in package.json: ${chalk6.red(dep)}`);
       }
     }
   }
   if (unusedDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk5.yellow(packageLocation)}
+    console.log(`  ${chalk6.yellow(packageLocation)}
 `);
   }
   return unusedDependencies;
@@ -553,6 +672,7 @@ function checkPackage({
   location,
   deps = false,
   devDeps = false,
+  exclude,
   peerDeps = false,
   verbose = false
 }) {
@@ -571,23 +691,29 @@ function checkPackage({
   });
   const packageParams = getDependenciesFromPackageJson(`${location}/package.json`);
   const unlistedDependencies = checkDeps ? getUnlistedDependencies({ name, location }, packageParams, sourceParams) : 0;
-  const unusedDependencies = checkDeps ? getUnusedDependencies({ name, location }, packageParams, sourceParams) : 0;
+  const unusedDependencies = checkDeps ? getUnusedDependencies({ name, location }, packageParams, sourceParams, exclude) : 0;
   const unlistedDevDependencies = checkDevDeps ? getUnlistedDevDependencies({ name, location }, packageParams, sourceParams) : 0;
   const fileContext = { allFiles, distFiles };
-  const unusedDevDependencies = checkDevDeps ? getUnusedDevDependencies({ name, location }, packageParams, sourceParams, fileContext) : 0;
-  const unusedPeerDependencies = checkPeerDeps ? getUnusedPeerDependencies({ name, location }, packageParams, sourceParams) : 0;
+  const unusedDevDependencies = checkDevDeps ? getUnusedDevDependencies({ name, location }, packageParams, sourceParams, fileContext, exclude) : 0;
+  const unusedPeerDependencies = checkPeerDeps ? getUnusedPeerDependencies({ name, location }, packageParams, sourceParams, exclude) : 0;
   const totalErrors = unlistedDependencies + unlistedDevDependencies + unusedDependencies + unusedDevDependencies + unusedPeerDependencies;
   return totalErrors;
 }
 
 // src/actions/deplint/deplint.ts
-var deplint = ({
+var deplint = async ({
   pkg,
   deps,
   devDeps,
   peerDeps,
-  verbose
+  verbose,
+  cliExclude
 }) => {
+  const config2 = await loadConfig();
+  const exclude = /* @__PURE__ */ new Set([
+    ...config2.deplint?.exclude ?? [],
+    ...cliExclude ?? []
+  ]);
   let totalErrors = 0;
   if (pkg === void 0) {
     const workspaces = yarnWorkspaces();
@@ -597,6 +723,7 @@ var deplint = ({
         ...workspace,
         deps,
         devDeps,
+        exclude,
         peerDeps,
         verbose
       });
@@ -609,14 +736,15 @@ var deplint = ({
       location,
       devDeps,
       deps,
+      exclude,
       peerDeps,
       verbose
     });
   }
   if (totalErrors > 0) {
-    console.warn(`Deplint: Found ${chalk6.red(totalErrors)} dependency problems. ${chalk6.red("\u2716")}`);
+    console.warn(`Deplint: Found ${chalk7.red(totalErrors)} dependency problems. ${chalk7.red("\u2716")}`);
   } else {
-    console.info(`Deplint: Found no dependency problems. ${chalk6.green("\u2714")}`);
+    console.info(`Deplint: Found no dependency problems. ${chalk7.green("\u2714")}`);
   }
   return 0;
 };