@xylabs/ts-scripts-yarn3 7.4.10 → 7.4.11

package/dist/actions/index.mjs

@@ -344,8 +344,8 @@ var loadConfig = async (params) => {
 
 // src/lib/parsedPackageJSON.ts
 import { readFileSync as readFileSync3 } from "fs";
-var parsedPackageJSON = (path13) => {
-  const pathToPackageJSON = path13 ?? process.env.npm_package_json ?? "";
+var parsedPackageJSON = (path14) => {
+  const pathToPackageJSON = path14 ?? process.env.npm_package_json ?? "";
   const packageJSON = readFileSync3(pathToPackageJSON).toString();
   return JSON.parse(packageJSON);
 };
@@ -976,11 +976,11 @@ function getExternalImportsFromFiles({
   const allImportPaths = {};
   const distImportPaths = {};
   const distTypeImportPaths = {};
-  for (const path13 of allFiles) getImportsFromFile(path13, allImportPaths, allImportPaths).flat();
+  for (const path14 of allFiles) getImportsFromFile(path14, allImportPaths, allImportPaths).flat();
   const distTypeFiles = distFiles.filter(isDeclarationFile);
   const distCodeFiles = distFiles.filter((file) => !isDeclarationFile(file));
-  for (const path13 of distCodeFiles) getImportsFromFile(path13, distImportPaths, distImportPaths).flat();
-  for (const path13 of distTypeFiles) getImportsFromFile(path13, distTypeImportPaths, distTypeImportPaths).flat();
+  for (const path14 of distCodeFiles) getImportsFromFile(path14, distImportPaths, distImportPaths).flat();
+  for (const path14 of distTypeFiles) getImportsFromFile(path14, distTypeImportPaths, distTypeImportPaths).flat();
   const allImports = Object.keys(allImportPaths);
   const distImports = Object.keys(distImportPaths);
   const externalAllImports = removeInternalImports(allImports);
@@ -1074,9 +1074,10 @@ 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)) {
@@ -1097,6 +1098,15 @@ function getUnusedDependencies({ name, location }, { dependencies }, {
 // src/actions/deplint/checkPackage/getUnusedDevDependencies.ts
 import chalk17 from "chalk";
 
+// src/actions/deplint/getCliReferencedPackagesFromFiles.ts
+import fs8 from "fs";
+import path7 from "path";
+import ts2 from "typescript";
+
+// src/actions/deplint/getScriptReferencedPackages.ts
+import fs7 from "fs";
+import path6 from "path";
+
 // src/actions/deplint/getRequiredPeerDependencies.ts
 import fs6 from "fs";
 import path5 from "path";
@@ -1130,8 +1140,6 @@ function getRequiredPeerDependencies(location, allDeps) {
 }
 
 // src/actions/deplint/getScriptReferencedPackages.ts
-import fs7 from "fs";
-import path6 from "path";
 function getBinNames(location, dep) {
   const depPkgPath = findDepPackageJson(location, dep);
   if (!depPkgPath) return [];
@@ -1181,15 +1189,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 = fs8.readFileSync(filePath, "utf8");
+  } catch {
+    return tokens;
+  }
+  const isMjsFile = filePath.endsWith(".mjs");
+  const sourceFile = ts2.createSourceFile(
+    path7.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 fs8 from "fs";
+import fs9 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 = fs8.readFileSync(file, "utf8");
+    const content = fs9.readFileSync(file, "utf8");
     return decoratorPattern.test(content);
   } catch {
     return false;
@@ -1202,7 +1296,7 @@ function hasImportPlugin({ location, allDependencies }) {
     const pkgPath = findDepPackageJson(location, dep);
     if (!pkgPath) continue;
     try {
-      const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf8"));
+      const pkg = JSON.parse(fs9.readFileSync(pkgPath, "utf8"));
       const transitiveDeps = [
         ...Object.keys(pkg.dependencies ?? {}),
         ...Object.keys(pkg.peerDependencies ?? {})
@@ -1254,10 +1348,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);
@@ -1268,7 +1363,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({
@@ -1278,10 +1373,12 @@ 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(`[${chalk17.blue(name)}] Unused devDependency in package.json: ${chalk17.red(dep)}`);
     }
@@ -1296,9 +1393,10 @@ function getUnusedDevDependencies({ name, location }, {
 
 // src/actions/deplint/checkPackage/getUnusedPeerDependencies.ts
 import chalk18 from "chalk";
-function getUnusedPeerDependencies({ name, location }, { peerDependencies, dependencies }, { externalDistImports, externalDistTypeImports }) {
+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)) {
@@ -1335,6 +1433,7 @@ function checkPackage({
   location,
   deps = false,
   devDeps = false,
+  exclude,
   peerDeps = false,
   verbose = false
 }) {
@@ -1353,23 +1452,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();
@@ -1379,6 +1484,7 @@ var deplint = ({
         ...workspace,
         deps,
         devDeps,
+        exclude,
         peerDeps,
         verbose
       });
@@ -1391,6 +1497,7 @@ var deplint = ({
       location,
       devDeps,
       deps,
+      exclude,
       peerDeps,
       verbose
     });
@@ -1724,12 +1831,12 @@ var filename2 = ".npmignore";
 var npmignoreGen = (pkg) => generateIgnoreFiles(filename2, pkg);
 
 // src/actions/package/clean-outputs.ts
-import path7 from "path";
+import path8 from "path";
 import chalk25 from "chalk";
 var packageCleanOutputs = () => {
   const pkg = process.env.INIT_CWD ?? ".";
   const pkgName = process.env.npm_package_name;
-  const folders = [path7.join(pkg, "dist"), path7.join(pkg, "build"), path7.join(pkg, "docs")];
+  const folders = [path8.join(pkg, "dist"), path8.join(pkg, "build"), path8.join(pkg, "docs")];
   console.log(chalk25.green(`Cleaning Outputs [${pkgName}]`));
   for (let folder of folders) {
     deleteGlob(folder);
@@ -1738,13 +1845,13 @@ var packageCleanOutputs = () => {
 };
 
 // src/actions/package/clean-typescript.ts
-import path8 from "path";
+import path9 from "path";
 import chalk26 from "chalk";
 var packageCleanTypescript = () => {
   const pkg = process.env.INIT_CWD ?? ".";
   const pkgName = process.env.npm_package_name;
   console.log(chalk26.green(`Cleaning Typescript [${pkgName}]`));
-  const files = [path8.join(pkg, "*.tsbuildinfo"), path8.join(pkg, ".tsconfig.*"), path8.join(pkg, ".eslintcache")];
+  const files = [path9.join(pkg, "*.tsbuildinfo"), path9.join(pkg, ".tsconfig.*"), path9.join(pkg, ".eslintcache")];
   for (let file of files) {
     deleteGlob(file);
   }
@@ -1837,7 +1944,7 @@ function deepMergeObjects(objects) {
 import { cwd as cwd2 } from "process";
 import chalk28 from "chalk";
 import { createProgramFromConfig } from "tsc-prog";
-import ts2, {
+import ts3, {
   DiagnosticCategory,
   formatDiagnosticsWithColorAndContext,
   getPreEmitDiagnostics,
@@ -1859,10 +1966,10 @@ var packageCompileTsc = (platform, entries, srcDir = "src", outDir = "dist", com
   if (verbose) {
     console.log(chalk28.cyan(`Validating code START: ${entries.length} files to ${outDir} from ${srcDir}`));
   }
-  const configFilePath = ts2.findConfigFile(
+  const configFilePath = ts3.findConfigFile(
     "./",
     // search path
-    ts2.sys.fileExists,
+    ts3.sys.fileExists,
     "tsconfig.json"
   );
   if (configFilePath === void 0) {
@@ -1912,7 +2019,7 @@ var packageCompileTsc = (platform, entries, srcDir = "src", outDir = "dist", com
         if (nonEmitPatterns.some((pattern) => fileName.includes(pattern))) {
           return;
         }
-        ts2.sys.writeFile(fileName, text, writeByteOrderMark);
+        ts3.sys.writeFile(fileName, text, writeByteOrderMark);
       });
       return diagnostics.reduce((acc, diag) => acc + (diag.category === DiagnosticCategory.Error ? 1 : 0), 0);
     }
@@ -1925,7 +2032,7 @@ var packageCompileTsc = (platform, entries, srcDir = "src", outDir = "dist", com
 };
 
 // src/actions/package/compile/packageCompileTscTypes.ts
-import path9 from "path";
+import path10 from "path";
 import { cwd as cwd3 } from "process";
 import chalk29 from "chalk";
 import { rollup } from "rollup";
@@ -1934,7 +2041,7 @@ import nodeExternals from "rollup-plugin-node-externals";
 var ignoredWarningCodes = /* @__PURE__ */ new Set(["EMPTY_BUNDLE", "UNRESOLVED_IMPORT"]);
 async function bundleDts(inputPath, outputPath, platform, options, verbose = false) {
   const pkg = process.env.INIT_CWD ?? cwd3();
-  const tsconfigPath = path9.resolve(pkg, "tsconfig.json");
+  const tsconfigPath = path10.resolve(pkg, "tsconfig.json");
   const nodePlugIns = platform === "node" ? [nodeExternals()] : [];
   try {
     const bundle = await rollup({
@@ -2163,7 +2270,7 @@ var packageCompile = async (inConfig = {}) => {
 };
 
 // src/actions/package/copy-assets.ts
-import path10 from "path/posix";
+import path11 from "path/posix";
 import chalk32 from "chalk";
 import cpy2 from "cpy";
 var copyTargetAssets2 = async (target, name, location) => {
@@ -2172,7 +2279,7 @@ var copyTargetAssets2 = async (target, name, location) => {
       ["**/*.jpg", "**/*.png", "**/*.gif", "**/*.svg", "**/*.webp", "**/*.sass", "**/*.scss", "**/*.gif", "**/*.css"],
       `../dist/${target}`,
       {
-        cwd: path10.join(location, "src"),
+        cwd: path11.join(location, "src"),
         flat: false
       }
     );
@@ -2243,7 +2350,7 @@ var packageCycle = async () => {
 
 // src/actions/package/gen-docs.ts
 import { existsSync as existsSync6 } from "fs";
-import path11 from "path";
+import path12 from "path";
 import chalk33 from "chalk";
 import {
   Application,
@@ -2262,7 +2369,7 @@ var ExitCodes = {
 };
 var packageGenDocs = async () => {
   const pkg = process.env.INIT_CWD;
-  if (pkg !== void 0 && !existsSync6(path11.join(pkg, "typedoc.json"))) {
+  if (pkg !== void 0 && !existsSync6(path12.join(pkg, "typedoc.json"))) {
     return;
   }
   const app = await Application.bootstrap({
@@ -2354,7 +2461,7 @@ var runTypeDoc = async (app) => {
 
 // src/actions/package/lint.ts
 import { readdirSync as readdirSync4 } from "fs";
-import path12 from "path";
+import path13 from "path";
 import { cwd as cwd4 } from "process";
 import { pathToFileURL } from "url";
 import chalk34 from "chalk";
@@ -2391,7 +2498,7 @@ function getFiles(dir, ignoreFolders) {
   const subDirectory = dir.split(currentDirectory)[1]?.split("/")[1];
   if (ignoreFolders.includes(subDirectory)) return [];
   return readdirSync4(dir, { withFileTypes: true }).flatMap((dirent) => {
-    const res = path12.resolve(dir, dirent.name);
+    const res = path13.resolve(dir, dirent.name);
     const relativePath = subDirectory === void 0 ? dirent.name : `${subDirectory}/${dirent.name}`;
     const ignoreMatchers = ignoreFolders.map((pattern) => picomatch(pattern));
     if (ignoreMatchers.some((isMatch) => isMatch(relativePath))) return [];
@@ -2430,7 +2537,7 @@ var packageLint = async (fix2 = false, verbose = false, cache = true) => {
 };
 
 // src/actions/package/publint.ts
-import { promises as fs9 } from "fs";
+import { promises as fs10 } from "fs";
 import chalk35 from "chalk";
 import sortPackageJson from "sort-package-json";
 var customPubLint = (pkg) => {
@@ -2457,9 +2564,9 @@ var customPubLint = (pkg) => {
 };
 var packagePublint = async ({ strict = true, verbose = false } = {}) => {
   const pkgDir = process.env.INIT_CWD;
-  const sortedPkg = sortPackageJson(await fs9.readFile(`${pkgDir}/package.json`, "utf8"));
-  await fs9.writeFile(`${pkgDir}/package.json`, sortedPkg);
-  const pkg = JSON.parse(await fs9.readFile(`${pkgDir}/package.json`, "utf8"));
+  const sortedPkg = sortPackageJson(await fs10.readFile(`${pkgDir}/package.json`, "utf8"));
+  await fs10.writeFile(`${pkgDir}/package.json`, sortedPkg);
+  const pkg = JSON.parse(await fs10.readFile(`${pkgDir}/package.json`, "utf8"));
   console.log(chalk35.green(`Publint: ${pkg.name}`));
   console.log(chalk35.gray(pkgDir));
   const { publint: publint2 } = await import("publint");