@xylabs/ts-scripts-yarn3 7.4.10 → 7.4.11

package/dist/index.d.ts

@@ -173,14 +173,21 @@ declare const INIT_CWD: () => string | undefined;
 interface CheckPackageOptions {
     deps?: boolean;
     devDeps?: boolean;
+    /**
+     * Set of package names to exclude from unused-dependency checks.
+     * Loaded from xy.config's deplint.exclude field.
+     */
+    exclude?: Set<string>;
     peerDeps?: boolean;
     verbose?: boolean;
 }
 
 interface DepLintOptions extends CheckPackageOptions {
+    /** Package names to exclude, passed via --exclude on the command line */
+    cliExclude?: string[];
     pkg?: string;
 }
-declare const deplint: ({ pkg, deps, devDeps, peerDeps, verbose, }: DepLintOptions) => number;
+declare const deplint: ({ pkg, deps, devDeps, peerDeps, verbose, cliExclude, }: DepLintOptions) => Promise<number>;
 
 declare const deploy: () => number;
 
@@ -281,8 +288,22 @@ type PackageCompileTsupConfig = CompileConfig & {
 type PackageCompileTscConfig = CompileConfig & {
     mode: 'tsc';
 };
+/**
+ * Configuration for deplint (dependency linting).
+ */
+interface DeplintConfig {
+    /**
+     * Package names to exclude from unused-dependency checks.
+     * Packages listed here will never be reported as "unused" by deplint,
+     * even if no import for them is detected in source or dist files.
+     * Useful for packages that are used implicitly (e.g. runtime plugins,
+     * CSS-in-JS themes, or polyfills that have side effects on import).
+     */
+    exclude?: string[];
+}
 interface XyConfigBase {
     compile?: CompileConfig;
+    deplint?: DeplintConfig;
     dynamicShare?: DynamicShareConfig;
     liveShare?: LiveShareConfig;
     /** @deprecated */
@@ -444,4 +465,4 @@ declare const xyLintCommands: (args: Argv) => Argv<{}>;
 
 declare const xyParseOptions: () => Argv;
 
-export { type BuildParams, CROSS_PLATFORM_NEWLINE, type CleanPackageParams, type CleanParams, type CompileConfig, type CompileParams, type CopyAssetsParams, type CycleParams, type DepLintOptions, DuplicateDetector, type DynamicShareConfig, type EntryMode, type GenDocsPackageParams, type GenDocsParams, INIT_CWD, type LintPackageParams, type LintParams, type LiveShareConfig, type PackageCompileTscConfig, type PackageCompileTsupConfig, type PackageCopyAssetsParams, type PackageJsonEx, type PackagePublintParams, type PathConfig, type PublintPackageParams, type PublintParams, type ReadFileSyncOptions, type RebuildParams, type RecompilePackageParams, type RecompileParams, type RelintPackageParams, type RelintParams, type ScriptStep, WINDOWS_NEWLINE_REGEX, type Workspace, XYLABS_COMMANDS_PREFIX, XYLABS_RULES_PREFIX, type XyConfig, type XyConfigBase, type XyConfigLegacy, type XyTscConfig, type XyTsupConfig, build, bundleDts, checkResult, claudeCommandTemplates, claudeCommands, claudeMdProjectTemplate, claudeMdRuleTemplates, claudeRules, clean, cleanAll, cleanDocs, cleanPackage, compile, compileAll, compilePackage, copyAssets, createBuildConfig, cycle, cycleAll, cyclePackage, dead, defaultBuildConfig, defaultReadFileSyncOptions, deleteGlob, deplint, deploy, deployMajor, deployMinor, deployNext, detectDuplicateDependencies, dupdeps, empty, fix, genDocs, genDocsAll, genDocsPackage, generateIgnoreFiles, gitignoreGen, gitlint, gitlintFix, isYarnVersionOrGreater, knip, license, lint, lintAllPackages, lintPackage, loadConfig, loadPackageConfig, multiLineToJSONArray, notEmpty, npmignoreGen, packageClean, packageCleanOutputs, packageCleanTypescript, packageCompile, packageCompileTsc, packageCompileTscTypes, packageCompileTsup, packageCopyAssets, packageCycle, packageGenDocs, packageLint, packagePublint, packageRecompile, parsedPackageJSON, processEx, publint, publintAll, publintPackage, publish, readLines, readNonEmptyLines, rebuild, recompile, recompileAll, recompilePackage, reinstall, relint, relintAllPackages, relintPackage, retest, runStepAsync, runSteps, runStepsAsync, runXy, runXyWithWarning, safeExit, safeExitAsync, sonar, statics, test, tryReadFileSync, tsupOptions, union, up, updateYarnPlugins, updateYarnVersion, updo, withErrnoException, withError, writeLines, xy, xyBuildCommands, xyCommonCommands, xyDeployCommands, xyInstallCommands, xyLintCommands, xyParseOptions, yarn3Only, yarnWorkspace, yarnWorkspaces };
+export { type BuildParams, CROSS_PLATFORM_NEWLINE, type CleanPackageParams, type CleanParams, type CompileConfig, type CompileParams, type CopyAssetsParams, type CycleParams, type DepLintOptions, type DeplintConfig, DuplicateDetector, type DynamicShareConfig, type EntryMode, type GenDocsPackageParams, type GenDocsParams, INIT_CWD, type LintPackageParams, type LintParams, type LiveShareConfig, type PackageCompileTscConfig, type PackageCompileTsupConfig, type PackageCopyAssetsParams, type PackageJsonEx, type PackagePublintParams, type PathConfig, type PublintPackageParams, type PublintParams, type ReadFileSyncOptions, type RebuildParams, type RecompilePackageParams, type RecompileParams, type RelintPackageParams, type RelintParams, type ScriptStep, WINDOWS_NEWLINE_REGEX, type Workspace, XYLABS_COMMANDS_PREFIX, XYLABS_RULES_PREFIX, type XyConfig, type XyConfigBase, type XyConfigLegacy, type XyTscConfig, type XyTsupConfig, build, bundleDts, checkResult, claudeCommandTemplates, claudeCommands, claudeMdProjectTemplate, claudeMdRuleTemplates, claudeRules, clean, cleanAll, cleanDocs, cleanPackage, compile, compileAll, compilePackage, copyAssets, createBuildConfig, cycle, cycleAll, cyclePackage, dead, defaultBuildConfig, defaultReadFileSyncOptions, deleteGlob, deplint, deploy, deployMajor, deployMinor, deployNext, detectDuplicateDependencies, dupdeps, empty, fix, genDocs, genDocsAll, genDocsPackage, generateIgnoreFiles, gitignoreGen, gitlint, gitlintFix, isYarnVersionOrGreater, knip, license, lint, lintAllPackages, lintPackage, loadConfig, loadPackageConfig, multiLineToJSONArray, notEmpty, npmignoreGen, packageClean, packageCleanOutputs, packageCleanTypescript, packageCompile, packageCompileTsc, packageCompileTscTypes, packageCompileTsup, packageCopyAssets, packageCycle, packageGenDocs, packageLint, packagePublint, packageRecompile, parsedPackageJSON, processEx, publint, publintAll, publintPackage, publish, readLines, readNonEmptyLines, rebuild, recompile, recompileAll, recompilePackage, reinstall, relint, relintAllPackages, relintPackage, retest, runStepAsync, runSteps, runStepsAsync, runXy, runXyWithWarning, safeExit, safeExitAsync, sonar, statics, test, tryReadFileSync, tsupOptions, union, up, updateYarnPlugins, updateYarnVersion, updo, withErrnoException, withError, writeLines, xy, xyBuildCommands, xyCommonCommands, xyDeployCommands, xyInstallCommands, xyLintCommands, xyParseOptions, yarn3Only, yarnWorkspace, yarnWorkspaces };

package/dist/index.mjs

@@ -402,8 +402,8 @@ var loadConfig = async (params) => {
 
 // src/lib/parsedPackageJSON.ts
 import { readFileSync as readFileSync5 } 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 = readFileSync5(pathToPackageJSON).toString();
   return JSON.parse(packageJSON);
 };
@@ -1052,11 +1052,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);
@@ -1150,9 +1150,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)) {
@@ -1173,6 +1174,15 @@ function getUnusedDependencies({ name, location }, { dependencies }, {
 // src/actions/deplint/checkPackage/getUnusedDevDependencies.ts
 import chalk18 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";
@@ -1206,8 +1216,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 [];
@@ -1257,15 +1265,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;
@@ -1278,7 +1372,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 ?? {})
@@ -1330,10 +1424,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);
@@ -1344,7 +1439,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({
@@ -1354,10 +1449,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(`[${chalk18.blue(name)}] Unused devDependency in package.json: ${chalk18.red(dep)}`);
     }
@@ -1372,9 +1469,10 @@ function getUnusedDevDependencies({ name, location }, {
 
 // src/actions/deplint/checkPackage/getUnusedPeerDependencies.ts
 import chalk19 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)) {
@@ -1411,6 +1509,7 @@ function checkPackage({
   location,
   deps = false,
   devDeps = false,
+  exclude,
   peerDeps = false,
   verbose = false
 }) {
@@ -1429,23 +1528,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();
@@ -1455,6 +1560,7 @@ var deplint = ({
         ...workspace,
         deps,
         devDeps,
+        exclude,
         peerDeps,
         verbose
       });
@@ -1467,6 +1573,7 @@ var deplint = ({
       location,
       devDeps,
       deps,
+      exclude,
       peerDeps,
       verbose
     });
@@ -1800,12 +1907,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 chalk26 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(chalk26.green(`Cleaning Outputs [${pkgName}]`));
   for (let folder of folders) {
     deleteGlob(folder);
@@ -1814,13 +1921,13 @@ var packageCleanOutputs = () => {
 };
 
 // src/actions/package/clean-typescript.ts
-import path8 from "path";
+import path9 from "path";
 import chalk27 from "chalk";
 var packageCleanTypescript = () => {
   const pkg = process.env.INIT_CWD ?? ".";
   const pkgName = process.env.npm_package_name;
   console.log(chalk27.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);
   }
@@ -1913,7 +2020,7 @@ function deepMergeObjects(objects) {
 import { cwd as cwd2 } from "process";
 import chalk29 from "chalk";
 import { createProgramFromConfig } from "tsc-prog";
-import ts2, {
+import ts3, {
   DiagnosticCategory,
   formatDiagnosticsWithColorAndContext,
   getPreEmitDiagnostics,
@@ -1935,10 +2042,10 @@ var packageCompileTsc = (platform, entries, srcDir = "src", outDir = "dist", com
   if (verbose) {
     console.log(chalk29.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) {
@@ -1988,7 +2095,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);
     }
@@ -2001,7 +2108,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 chalk30 from "chalk";
 import { rollup } from "rollup";
@@ -2010,7 +2117,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({
@@ -2239,7 +2346,7 @@ var packageCompile = async (inConfig = {}) => {
 };
 
 // src/actions/package/copy-assets.ts
-import path10 from "path/posix";
+import path11 from "path/posix";
 import chalk33 from "chalk";
 import cpy2 from "cpy";
 var copyTargetAssets2 = async (target, name, location) => {
@@ -2248,7 +2355,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
       }
     );
@@ -2319,7 +2426,7 @@ var packageCycle = async () => {
 
 // src/actions/package/gen-docs.ts
 import { existsSync as existsSync7 } from "fs";
-import path11 from "path";
+import path12 from "path";
 import chalk34 from "chalk";
 import {
   Application,
@@ -2338,7 +2445,7 @@ var ExitCodes = {
 };
 var packageGenDocs = async () => {
   const pkg = process.env.INIT_CWD;
-  if (pkg !== void 0 && !existsSync7(path11.join(pkg, "typedoc.json"))) {
+  if (pkg !== void 0 && !existsSync7(path12.join(pkg, "typedoc.json"))) {
     return;
   }
   const app = await Application.bootstrap({
@@ -2430,7 +2537,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 chalk35 from "chalk";
@@ -2467,7 +2574,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 [];
@@ -2506,7 +2613,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 chalk36 from "chalk";
 import sortPackageJson from "sort-package-json";
 var customPubLint = (pkg) => {
@@ -2533,9 +2640,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(chalk36.green(`Publint: ${pkg.name}`));
   console.log(chalk36.gray(pkgDir));
   const { publint: publint2 } = await import("publint");
@@ -3257,12 +3364,18 @@ var xyLintCommands = (args) => {
         default: false,
         description: "Check peerDependencies",
         type: "boolean"
+      }).option("exclude", {
+        alias: "e",
+        description: "Package names to exclude from unused checks (comma-separated or repeated)",
+        type: "array"
       });
     },
-    (argv) => {
+    async (argv) => {
       if (argv.verbose) console.log("Deplint");
       const start = Date.now();
-      process.exitCode = deplint({
+      const cliExclude = argv.exclude?.flatMap((v) => String(v).split(",")).map((v) => v.trim()).filter(Boolean);
+      process.exitCode = await deplint({
+        cliExclude,
         pkg: argv.package,
         deps: !!argv.deps,
         devDeps: !!argv.devDeps,