@xylabs/ts-scripts-common 7.5.0

package/dist/xy/lint/index.mjs

@@ -0,0 +1,1691 @@
+// src/xy/lint/cycleCommand.ts
+import chalk16 from "chalk";
+
+// src/lib/checkResult.ts
+import chalk from "chalk";
+var checkResult = (name, result, level = "error", exitOnFail = false) => {
+  if (result) {
+    const exiting = exitOnFail ? "[Exiting Process]" : "[Continuing]";
+    const chalkFunc = level === "error" ? chalk.red : chalk.yellow;
+    console[level](chalkFunc(`${name} had ${result} failures ${exiting}`));
+    if (exitOnFail) {
+      process.exit(result);
+    }
+  }
+};
+
+// src/pm/detectPackageManager.ts
+import { existsSync } from "fs";
+function detectPackageManager() {
+  if (existsSync("pnpm-lock.yaml") || existsSync("pnpm-workspace.yaml")) return "pnpm";
+  return "yarn";
+}
+
+// src/pm/registry.ts
+var implementations = /* @__PURE__ */ new Map();
+function getPackageManager(name) {
+  const pmName = name ?? detectPackageManager();
+  const pm = implementations.get(pmName);
+  if (!pm) {
+    throw new Error(
+      `No package manager implementation registered for "${pmName}". Install @xylabs/ts-scripts-${pmName === "yarn" ? "yarn3" : pmName} and ensure it is imported.`
+    );
+  }
+  return pm;
+}
+
+// src/lib/processEx.ts
+import chalk2 from "chalk";
+
+// src/lib/withError.ts
+var withError = (ex, closure, predicate = (ex2) => !!ex2.name && !!ex2.message) => {
+  return predicate(ex) ? closure(ex) : void 0;
+};
+
+// src/lib/withErrnoException.ts
+var withErrnoException = (ex, closure) => {
+  return withError(ex, closure, (ex2) => ex2.errno !== void 0);
+};
+
+// src/lib/processEx.ts
+var processEx = (ex) => {
+  const error = typeof ex === "string" ? new Error(ex) : ex;
+  const exitCode = withErrnoException(error, (error2) => {
+    if (error2.code === "ENOENT") {
+      console.error(chalk2.red(`'${error2.path}' not found.`));
+    } else {
+      console.error(chalk2.red(`Errno: ${error2.code}`));
+    }
+    return error2.errno ?? -1;
+  }) ?? withError(error, (error2) => {
+    console.error(chalk2.red(`${error2.name}: ${error2.message}`));
+    return -1;
+  }) ?? (() => {
+    console.error(chalk2.red(`Unexpected Error: ${JSON.stringify(ex, null, 2)}`));
+    return -1;
+  })();
+  process.exit(process.exitCode ?? exitCode);
+};
+
+// src/lib/safeExit.ts
+var safeExit = (func, exitOnFail = true) => {
+  try {
+    const result = func();
+    if (result && exitOnFail) {
+      process.exit(result);
+    }
+    return result;
+  } catch (ex) {
+    return processEx(ex);
+  }
+};
+var safeExitAsync = async (func, exitOnFail = true) => {
+  try {
+    const result = await func();
+    if (result && exitOnFail) {
+      process.exit(result);
+    }
+    return result;
+  } catch (ex) {
+    return processEx(ex);
+  }
+};
+
+// src/lib/initCwd.ts
+function INIT_CWD() {
+  if (!process.env.INIT_CWD) console.error("Missing INIT_CWD");
+  return process.env.INIT_CWD;
+}
+
+// src/lib/loadConfig.ts
+import chalk3 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(chalk3.green(`Loaded config from ${configFilePath}`));
+      if (config.verbose) {
+        console.log(chalk3.gray(`${JSON.stringify(config, null, 2)}`));
+      }
+    }
+  }
+  return deepmerge(config, params ?? {});
+};
+
+// src/lib/runSteps.ts
+import { spawnSync } from "child_process";
+import { existsSync as existsSync2 } from "fs";
+import chalk4 from "chalk";
+var runSteps = (name, steps, exitOnFail = true, messages) => {
+  return safeExit(() => {
+    const pkgName = process.env.npm_package_name;
+    console.log(chalk4.green(`${name} [${pkgName}]`));
+    let totalStatus = 0;
+    for (const [i, [command, args, config2]] of steps.entries()) {
+      if (messages?.[i]) {
+        console.log(chalk4.gray(messages?.[i]));
+      }
+      const argList = Array.isArray(args) ? args : args.split(" ");
+      if (command === "node" && !existsSync2(argList[0])) {
+        throw new Error(`File not found [${argList[0]}]`);
+      }
+      const status = spawnSync(command, Array.isArray(args) ? args : args.split(" "), {
+        ...config2,
+        encoding: "utf8",
+        env: { FORCE_COLOR: "3", ...process.env },
+        shell: true,
+        stdio: "inherit"
+      }).status ?? 0;
+      checkResult(name, status, "error", exitOnFail);
+      totalStatus += status ?? 0;
+    }
+    return totalStatus;
+  }, !!exitOnFail);
+};
+
+// src/lib/runStepsAsync.ts
+import { spawn } from "child_process";
+import { existsSync as existsSync3 } from "fs";
+import chalk5 from "chalk";
+var runStepAsync = (name, step, exitOnFail = true, message) => {
+  return new Promise((resolve) => {
+    const [command, args, config2] = step;
+    if (message) {
+      console.log(chalk5.gray(message));
+    }
+    const argList = Array.isArray(args) ? args : args.split(" ");
+    if (command === "node" && !existsSync3(argList[0])) {
+      throw new Error(`File not found [${argList[0]}]`);
+    }
+    spawn(command, Array.isArray(args) ? args : args.split(" "), {
+      ...config2,
+      env: { FORCE_COLOR: "3", ...process.env },
+      shell: true,
+      stdio: "inherit"
+    }).on("close", (code) => {
+      if (code) {
+        console.error(
+          chalk5.red(
+            `Command Exited With Non-Zero Result [${chalk5.gray(code)}] | ${chalk5.yellow(command)} ${chalk5.white(
+              Array.isArray(args) ? args.join(" ") : args
+            )}`
+          )
+        );
+        checkResult(name, code, "error", exitOnFail);
+        resolve(code);
+      } else {
+        resolve(0);
+      }
+    });
+  });
+};
+var runStepsAsync = async (name, steps, exitOnFail = true, messages) => {
+  return await safeExitAsync(async () => {
+    const pkgName = process.env.npm_package_name;
+    console.log(chalk5.green(`${name} [${pkgName}]`));
+    let result = 0;
+    for (const [i, step] of steps.entries()) {
+      result += await runStepAsync(name, step, exitOnFail, messages?.[i]);
+    }
+    return result;
+  });
+};
+
+// src/actions/cycle.ts
+import { cruise } from "dependency-cruiser";
+var cycle = async ({ verbose, pkg } = {}) => {
+  return pkg ? cyclePackage({ pkg, verbose }) : await cycleAll({ verbose });
+};
+var cyclePackage = ({ pkg, verbose }) => {
+  const pm = getPackageManager();
+  const verboseOptions = verbose ? ["--verbose"] : ["--no-verbose"];
+  return runSteps(
+    `Cycle [${pkg}]`,
+    [pm.runInWorkspace(pkg, "package-cycle", verboseOptions)]
+  );
+};
+var cycleAll = async ({ verbose = false }) => {
+  const pkgName = process.env.npm_package_name;
+  const cruiseOptions = {
+    ruleSet: {
+      forbidden: [
+        {
+          name: "no-circular",
+          severity: "error",
+          comment: "This dependency creates a circular reference",
+          from: {},
+          to: { circular: true }
+        }
+      ]
+    },
+    exclude: "node_modules|packages/.*/packages",
+    validate: true,
+    doNotFollow: { path: "node_modules|packages/.*/packages" },
+    tsPreCompilationDeps: false,
+    combinedDependencies: true,
+    outputType: verbose ? "text" : "err"
+  };
+  const target = "**/packages/*/src";
+  console.log(`Checking for circular dependencies in ${target}...`);
+  const result = await cruise([target], cruiseOptions);
+  if (result.output) {
+    console.log(result.output);
+  }
+  if (result.exitCode === 0) {
+    console.log(`${pkgName} \u2705 No dependency violations`);
+  } else {
+    console.error(`${pkgName} \u274C Dependency violations found`);
+  }
+  return result.exitCode;
+};
+
+// src/actions/deplint/deplint.ts
+import chalk11 from "chalk";
+
+// src/actions/deplint/findFiles.ts
+import fs from "fs";
+
+// src/actions/deplint/findFilesByGlob.ts
+import { globSync } from "glob";
+function findFilesByGlob(cwd, pattern, ignore) {
+  return globSync(pattern, {
+    cwd,
+    absolute: true,
+    ignore,
+    nodir: true
+  });
+}
+
+// src/actions/deplint/findFiles.ts
+var codeExtensions = "*.{ts,tsx,mts,cts,js,mjs,cjs}";
+function getWorkspaceIgnores(location) {
+  try {
+    const raw = fs.readFileSync(`${location}/package.json`, "utf8");
+    const pkg = JSON.parse(raw);
+    return pkg.workspaces ?? [];
+  } catch {
+    return [];
+  }
+}
+function findFiles(location) {
+  const workspaceIgnores = getWorkspaceIgnores(location).map((w) => `${w}/**`);
+  const ignore = ["**/node_modules/**", "dist/**", ...workspaceIgnores];
+  const allFiles = findFilesByGlob(location, `./**/${codeExtensions}`, ignore);
+  const distFiles = [
+    ...findFilesByGlob(location, "./dist/**/*.d.ts"),
+    ...findFilesByGlob(location, `./dist/**/${codeExtensions}`)
+  ];
+  return { allFiles, distFiles };
+}
+
+// src/actions/deplint/getDependenciesFromPackageJson.ts
+import fs2 from "fs";
+import path from "path";
+function getDependenciesFromPackageJson(packageJsonPath) {
+  const packageJsonFullPath = path.resolve(packageJsonPath);
+  const rawContent = fs2.readFileSync(packageJsonFullPath, "utf8");
+  const packageJson = JSON.parse(rawContent);
+  const dependencies = packageJson.dependencies ? Object.keys(packageJson.dependencies) : [];
+  const devDependencies = packageJson.devDependencies ? Object.keys(packageJson.devDependencies) : [];
+  const peerDependencies = packageJson.peerDependencies ? Object.keys(packageJson.peerDependencies) : [];
+  return {
+    dependencies,
+    devDependencies,
+    peerDependencies
+  };
+}
+
+// src/actions/deplint/getExtendsFromTsconfigs.ts
+import fs3 from "fs";
+import { globSync as globSync2 } from "glob";
+
+// src/actions/deplint/getBasePackageName.ts
+function getBasePackageName(importName) {
+  const importNameScrubbed = importName.replaceAll('"', "").trim();
+  if (importNameScrubbed.startsWith("@")) {
+    const parts = importNameScrubbed.split("/");
+    return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : importNameScrubbed;
+  }
+  return importNameScrubbed.split("/")[0];
+}
+
+// src/actions/deplint/getExtendsFromTsconfigs.ts
+var isExternalReference = (ref) => !ref.startsWith(".") && !ref.startsWith("/");
+function parseExtendsField(value) {
+  if (typeof value === "string") return [value];
+  if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
+  return [];
+}
+function getExtendsFromTsconfigs(location) {
+  const tsconfigFiles = globSync2("./tsconfig*.json", { cwd: location, absolute: true });
+  const packages = /* @__PURE__ */ new Set();
+  for (const file of tsconfigFiles) {
+    try {
+      const content = fs3.readFileSync(file, "utf8");
+      const cleaned = content.replaceAll(/\/\/.*/g, "").replaceAll(/,\s*([}\]])/g, "$1");
+      const parsed = JSON.parse(cleaned);
+      const refs = parseExtendsField(parsed.extends);
+      for (const ref of refs) {
+        if (isExternalReference(ref)) {
+          packages.add(getBasePackageName(ref));
+        }
+      }
+    } catch {
+    }
+  }
+  return [...packages];
+}
+
+// src/actions/deplint/getImportsFromFile.ts
+import fs4 from "fs";
+import path2 from "path";
+import ts from "typescript";
+function isTypeOnlyImportClause(clause) {
+  if (clause === void 0) {
+    return false;
+  }
+  if ("phaseModifier" in clause) {
+    const mod = clause.phaseModifier;
+    const kind = typeof mod === "number" ? mod : mod?.kind;
+    return kind === ts.SyntaxKind.TypeKeyword;
+  }
+  return clause.isTypeOnly;
+}
+function getImportsFromFile(filePath, importPaths, typeImportPaths) {
+  const sourceCode = fs4.readFileSync(filePath, "utf8");
+  const isMjsFile = filePath.endsWith(".mjs");
+  const sourceFile = ts.createSourceFile(
+    path2.basename(filePath),
+    sourceCode,
+    ts.ScriptTarget.Latest,
+    true,
+    isMjsFile ? ts.ScriptKind.JS : void 0
+  );
+  const imports = [];
+  const typeImports = [];
+  const isDeclarationFile2 = filePath.endsWith(".d.ts");
+  function visit(node) {
+    if (ts.isImportDeclaration(node) || ts.isExportDeclaration(node)) {
+      const moduleSpecifier = node.moduleSpecifier?.getFullText();
+      const isTypeImport = ts.isImportDeclaration(node) ? isTypeOnlyImportClause(node.importClause) : false;
+      if (typeof moduleSpecifier === "string") {
+        const trimmed = moduleSpecifier.replaceAll("'", "").replaceAll('"', "").trim();
+        if (isTypeImport || isDeclarationFile2) {
+          typeImports.push(trimmed);
+        } else {
+          imports.push(trimmed);
+        }
+      }
+    } else if (ts.isCallExpression(node) && node.expression.kind === ts.SyntaxKind.ImportKeyword) {
+      const [arg] = node.arguments;
+      if (ts.isStringLiteral(arg)) {
+        imports.push(arg.text);
+      }
+    } else if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "require" && node.arguments.length > 0 && ts.isStringLiteral(node.arguments[0])) {
+      imports.push(node.arguments[0].text);
+    }
+    ts.forEachChild(node, visit);
+  }
+  visit(sourceFile);
+  for (const ref of sourceFile.typeReferenceDirectives) {
+    typeImports.push(ref.fileName);
+  }
+  const importsStartsWithExcludes = [".", "#", "node:"];
+  const isValidImport = (imp) => !importsStartsWithExcludes.some((exc) => imp.startsWith(exc)) && !imp.includes("*") && !imp.includes("!");
+  const cleanedImports = imports.filter(isValidImport).map(getBasePackageName);
+  const cleanedTypeImports = typeImports.filter(isValidImport).map(getBasePackageName);
+  for (const imp of cleanedImports) {
+    importPaths[imp] = importPaths[imp] ?? [];
+    importPaths[imp].push(filePath);
+  }
+  for (const imp of cleanedTypeImports) {
+    typeImportPaths[imp] = typeImportPaths[imp] ?? [];
+    typeImportPaths[imp].push(filePath);
+  }
+  return [cleanedImports, cleanedTypeImports];
+}
+
+// src/actions/deplint/getExternalImportsFromFiles.ts
+var internalImportPrefixes = [".", "#", "node:"];
+var removeInternalImports = (imports) => {
+  return imports.filter((imp) => !internalImportPrefixes.some((prefix) => imp.startsWith(prefix)));
+};
+var isDeclarationFile = (file) => file.endsWith(".d.ts") || file.endsWith(".d.cts") || file.endsWith(".d.mts");
+function getExternalImportsFromFiles({
+  allFiles,
+  distFiles,
+  tsconfigExtends = []
+}) {
+  const allImportPaths = {};
+  const distImportPaths = {};
+  const distTypeImportPaths = {};
+  for (const path6 of allFiles) getImportsFromFile(path6, allImportPaths, allImportPaths).flat();
+  const distTypeFiles = distFiles.filter(isDeclarationFile);
+  const distCodeFiles = distFiles.filter((file) => !isDeclarationFile(file));
+  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);
+  const externalDistImports = removeInternalImports(distImports);
+  const externalDistTypeImports = removeInternalImports(Object.keys(distTypeImportPaths));
+  for (const ext of tsconfigExtends) {
+    if (!externalAllImports.includes(ext)) externalAllImports.push(ext);
+  }
+  return {
+    allImportPaths,
+    allImports,
+    distImportPaths,
+    distImports,
+    externalAllImports,
+    externalDistImports,
+    externalDistTypeImports
+  };
+}
+
+// src/actions/deplint/checkPackage/getUnlistedDependencies.ts
+import { builtinModules } from "module";
+import chalk6 from "chalk";
+function isRuntimeImportListed(imp, name, dependencies, peerDependencies) {
+  return dependencies.includes(imp) || imp === name || peerDependencies.includes(imp) || builtinModules.includes(imp);
+}
+function isTypeImportListed(imp, name, dependencies, devDependencies, peerDependencies) {
+  return dependencies.includes(imp) || imp === name || dependencies.includes(`@types/${imp}`) || peerDependencies.includes(imp) || peerDependencies.includes(`@types/${imp}`) || devDependencies.includes(`@types/${imp}`) || builtinModules.includes(imp);
+}
+function logMissing(name, imp, importPaths) {
+  console.log(`[${chalk6.blue(name)}] Missing dependency in package.json: ${chalk6.red(imp)}`);
+  if (importPaths[imp]) {
+    console.log(`  ${importPaths[imp].join("\n ")}`);
+  }
+}
+function getUnlistedDependencies({ name, location }, {
+  dependencies,
+  devDependencies,
+  peerDependencies
+}, {
+  externalDistImports,
+  externalDistTypeImports,
+  distImportPaths
+}) {
+  let unlistedDependencies = 0;
+  for (const imp of externalDistImports) {
+    if (!isRuntimeImportListed(imp, name, dependencies, peerDependencies)) {
+      unlistedDependencies++;
+      logMissing(name, imp, distImportPaths);
+    }
+  }
+  for (const imp of externalDistTypeImports) {
+    if (!isTypeImportListed(imp, name, dependencies, devDependencies, peerDependencies)) {
+      unlistedDependencies++;
+      logMissing(name, imp, distImportPaths);
+    }
+  }
+  if (unlistedDependencies > 0) {
+    const packageLocation = `${location}/package.json`;
+    console.log(`  ${chalk6.yellow(packageLocation)}
+`);
+  }
+  return unlistedDependencies;
+}
+
+// src/actions/deplint/checkPackage/getUnlistedDevDependencies.ts
+import { builtinModules as builtinModules2 } from "module";
+import chalk7 from "chalk";
+function getUnlistedDevDependencies({ name, location }, {
+  devDependencies,
+  dependencies,
+  peerDependencies
+}, {
+  allImportPaths,
+  externalAllImports,
+  distImports
+}) {
+  let unlistedDevDependencies = 0;
+  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(`[${chalk7.blue(name)}] Missing devDependency in package.json: ${chalk7.red(imp)}`);
+      if (allImportPaths[imp]) {
+        console.log(`  ${allImportPaths[imp].join("\n ")}`);
+      }
+    }
+  }
+  if (unlistedDevDependencies > 0) {
+    const packageLocation = `${location}/package.json`;
+    console.log(`  ${chalk7.yellow(packageLocation)}
+`);
+  }
+  return unlistedDevDependencies;
+}
+
+// src/actions/deplint/checkPackage/getUnusedDependencies.ts
+import chalk8 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(`[${chalk8.blue(name)}] dependency should be devDependency in package.json: ${chalk8.red(dep)}`);
+      } else {
+        console.log(`[${chalk8.blue(name)}] Unused dependency in package.json: ${chalk8.red(dep)}`);
+      }
+    }
+  }
+  if (unusedDependencies > 0) {
+    const packageLocation = `${location}/package.json`;
+    console.log(`  ${chalk8.yellow(packageLocation)}
+`);
+  }
+  return unusedDependencies;
+}
+
+// src/actions/deplint/checkPackage/getUnusedDevDependencies.ts
+import chalk9 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";
+import path3 from "path";
+function findDepPackageJson(location, dep) {
+  let dir = location;
+  while (true) {
+    const candidate = path3.join(dir, "node_modules", dep, "package.json");
+    if (fs5.existsSync(candidate)) return candidate;
+    const parent = path3.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function getRequiredPeerDependencies(location, allDeps) {
+  const required = /* @__PURE__ */ new Set();
+  for (const dep of allDeps) {
+    const depPkgPath = findDepPackageJson(location, dep);
+    if (!depPkgPath) continue;
+    try {
+      const raw = fs5.readFileSync(depPkgPath, "utf8");
+      const pkg = JSON.parse(raw);
+      if (pkg.peerDependencies) {
+        for (const peer of Object.keys(pkg.peerDependencies)) {
+          required.add(peer);
+        }
+      }
+    } catch {
+    }
+  }
+  return required;
+}
+
+// src/actions/deplint/getScriptReferencedPackages.ts
+function getBinNames(location, dep) {
+  const depPkgPath = findDepPackageJson(location, dep);
+  if (!depPkgPath) return [];
+  try {
+    const raw = fs6.readFileSync(depPkgPath, "utf8");
+    const pkg = JSON.parse(raw);
+    if (!pkg.bin) return [];
+    if (typeof pkg.bin === "string") return [pkg.name?.split("/").pop() ?? dep];
+    return Object.keys(pkg.bin);
+  } catch {
+    return [];
+  }
+}
+function tokenizeScript(script) {
+  return script.split(/[&|;$()"`\s]+/).map((t) => t.trim()).filter(Boolean);
+}
+function getScriptReferencedPackages(location, allDeps) {
+  const pkgPath = path4.join(location, "package.json");
+  let scripts = {};
+  try {
+    const raw = fs6.readFileSync(pkgPath, "utf8");
+    const pkg = JSON.parse(raw);
+    scripts = pkg.scripts ?? {};
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+  const scriptText = Object.values(scripts).join(" ");
+  const tokens = new Set(tokenizeScript(scriptText));
+  const binToPackage = /* @__PURE__ */ new Map();
+  for (const dep of allDeps) {
+    const bins = getBinNames(location, dep);
+    for (const bin of bins) {
+      binToPackage.set(bin, dep);
+    }
+  }
+  const referenced = /* @__PURE__ */ new Set();
+  for (const token of tokens) {
+    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/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 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 = fs8.readFileSync(file, "utf8");
+    return decoratorPattern.test(content);
+  } catch {
+    return false;
+  }
+});
+var importPlugins = /* @__PURE__ */ new Set(["eslint-plugin-import-x", "eslint-plugin-import"]);
+function hasImportPlugin({ location, allDependencies }) {
+  if (allDependencies.some((d) => importPlugins.has(d))) return true;
+  for (const dep of allDependencies) {
+    const pkgPath = findDepPackageJson(location, dep);
+    if (!pkgPath) continue;
+    try {
+      const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf8"));
+      const transitiveDeps = [
+        ...Object.keys(pkg.dependencies ?? {}),
+        ...Object.keys(pkg.peerDependencies ?? {})
+      ];
+      if (transitiveDeps.some((d) => importPlugins.has(d))) return true;
+    } catch {
+    }
+  }
+  return false;
+}
+var hasVitest = ({ allDependencies }) => allDependencies.includes("vitest");
+var rules = [
+  {
+    package: "typescript",
+    isNeeded: hasTypescriptFiles
+  },
+  {
+    package: "eslint-import-resolver-typescript",
+    isNeeded: (context) => hasTypescriptFiles(context) && context.allDependencies.includes("eslint") && hasImportPlugin(context)
+  },
+  {
+    package: "tslib",
+    isNeeded: hasDecorators
+  },
+  {
+    package: "@vitest/coverage-v8",
+    isNeeded: hasVitest
+  }
+];
+function getImplicitDevDependencies(context) {
+  const implicit = /* @__PURE__ */ new Set();
+  for (const rule of rules) {
+    if (rule.isNeeded(context)) {
+      implicit.add(rule.package);
+    }
+  }
+  return implicit;
+}
+
+// src/actions/deplint/checkPackage/getUnusedDevDependencies.ts
+var allExternalImports = ({
+  externalAllImports,
+  externalDistImports,
+  externalDistTypeImports
+}) => {
+  return /* @__PURE__ */ new Set([
+    ...externalAllImports,
+    ...externalDistImports,
+    ...externalDistTypeImports
+  ]);
+};
+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);
+  }
+  return allImports.has(dep);
+}
+function getUnusedDevDependencies({ name, location }, {
+  devDependencies,
+  dependencies,
+  peerDependencies
+}, sourceParams, fileContext, exclude) {
+  const allImports = allExternalImports(sourceParams);
+  const allDeps = [...dependencies, ...devDependencies, ...peerDependencies];
+  const implicitDeps = getImplicitDevDependencies({
+    ...fileContext,
+    allDependencies: allDeps,
+    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, cliRefs)) {
+      unusedDevDependencies++;
+      console.log(`[${chalk9.blue(name)}] Unused devDependency in package.json: ${chalk9.red(dep)}`);
+    }
+  }
+  if (unusedDevDependencies > 0) {
+    const packageLocation = `${location}/package.json`;
+    console.log(`  ${chalk9.yellow(packageLocation)}
+`);
+  }
+  return unusedDevDependencies;
+}
+
+// src/actions/deplint/checkPackage/getUnusedPeerDependencies.ts
+import chalk10 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(`[${chalk10.blue(name)}] Unused peerDependency [already a dependency] in package.json: ${chalk10.red(dep)}`);
+      } else {
+        console.log(`[${chalk10.blue(name)}] Unused peerDependency in package.json: ${chalk10.red(dep)}`);
+      }
+    }
+  }
+  if (unusedDependencies > 0) {
+    const packageLocation = `${location}/package.json`;
+    console.log(`  ${chalk10.yellow(packageLocation)}
+`);
+  }
+  return unusedDependencies;
+}
+
+// src/actions/deplint/checkPackage/checkPackage.ts
+function logVerbose(name, location, allFiles, distFiles, tsconfigExtends) {
+  console.info(`Checking package: ${name} at ${location}`);
+  console.info(`All files: ${allFiles.length}, Distribution files: ${distFiles.length}`);
+  for (const file of allFiles) {
+    console.info(`File: ${file}`);
+  }
+  for (const file of distFiles) {
+    console.info(`Distribution file: ${file}`);
+  }
+  for (const ext of tsconfigExtends) {
+    console.info(`Tsconfig extends: ${ext}`);
+  }
+}
+function checkPackage({
+  name,
+  location,
+  deps = false,
+  devDeps = false,
+  exclude,
+  peerDeps = false,
+  verbose = false
+}) {
+  const { allFiles, distFiles } = findFiles(location);
+  const tsconfigExtends = getExtendsFromTsconfigs(location);
+  if (verbose) {
+    logVerbose(name, location, allFiles, distFiles, tsconfigExtends);
+  }
+  const checkDeps = deps || !(deps || devDeps || peerDeps);
+  const checkDevDeps = devDeps || !(deps || devDeps || peerDeps);
+  const checkPeerDeps = peerDeps;
+  const sourceParams = getExternalImportsFromFiles({
+    allFiles,
+    distFiles,
+    tsconfigExtends
+  });
+  const packageParams = getDependenciesFromPackageJson(`${location}/package.json`);
+  const unlistedDependencies = checkDeps ? getUnlistedDependencies({ 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, 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 = async ({
+  pkg,
+  deps,
+  devDeps,
+  peerDeps,
+  verbose,
+  cliExclude
+}) => {
+  const config2 = await loadConfig();
+  const exclude = /* @__PURE__ */ new Set([
+    ...config2.deplint?.exclude ?? [],
+    ...cliExclude ?? []
+  ]);
+  let totalErrors = 0;
+  if (pkg === void 0) {
+    const workspaces = getPackageManager().listWorkspaces();
+    console.info("Deplint Started...");
+    for (const workspace of workspaces) {
+      totalErrors += checkPackage({
+        ...workspace,
+        deps,
+        devDeps,
+        exclude,
+        peerDeps,
+        verbose
+      });
+    }
+  } else {
+    const workspace = getPackageManager().findWorkspace(pkg);
+    if (!workspace) {
+      console.error(chalk11.red(`Workspace not found: ${pkg}`));
+      return 1;
+    }
+    const { location, name } = workspace;
+    console.info(`Running Deplint for ${name}`);
+    totalErrors += checkPackage({
+      name,
+      location,
+      devDeps,
+      deps,
+      exclude,
+      peerDeps,
+      verbose
+    });
+  }
+  if (totalErrors > 0) {
+    console.warn(`Deplint: Found ${chalk11.red(totalErrors)} dependency problems. ${chalk11.red("\u2716")}`);
+  } else {
+    console.info(`Deplint: Found no dependency problems. ${chalk11.green("\u2714")}`);
+  }
+  return 0;
+};
+
+// src/actions/lint.ts
+import chalk12 from "chalk";
+var lintPackage = ({
+  pkg,
+  fix: fix2,
+  verbose
+}) => {
+  console.log(chalk12.gray(`${fix2 ? "Fix" : "Lint"} [${pkg}]`));
+  const start = Date.now();
+  const pm = getPackageManager();
+  const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [${pkg}]`, [
+    pm.runInWorkspace(pkg, fix2 ? "package-fix" : verbose ? "package-lint-verbose" : "package-lint")
+  ]);
+  console.log(chalk12.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk12.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk12.gray("seconds")}`));
+  return result;
+};
+var lint = ({
+  pkg,
+  verbose,
+  incremental,
+  fix: fix2
+} = {}) => {
+  return pkg === void 0 ? lintAllPackages({
+    verbose,
+    incremental,
+    fix: fix2
+  }) : lintPackage({
+    pkg,
+    fix: fix2,
+    verbose
+  });
+};
+var lintAllPackages = ({ fix: fix2 = false } = {}) => {
+  console.log(chalk12.gray(`${fix2 ? "Fix" : "Lint"} [All-Packages]`));
+  const start = Date.now();
+  const fixOptions = fix2 ? ["--fix"] : [];
+  const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [All-Packages]`, [
+    ["eslint", ["--cache", "--cache-location", ".eslintcache", "--cache-strategy", "content", ...fixOptions]]
+  ]);
+  console.log(chalk12.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk12.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk12.gray("seconds")}`));
+  return result;
+};
+
+// src/actions/fix.ts
+var fix = (params) => {
+  return lint({ ...params, fix: true });
+};
+
+// src/actions/knip.ts
+var knip = () => {
+  return runSteps("Knip", [["knip", ["--dependencies", "--no-exit-code"]]]);
+};
+
+// src/actions/lintlint.ts
+import { readFileSync, writeFileSync } from "fs";
+import PATH from "path";
+import chalk13 from "chalk";
+import { findUp } from "find-up";
+function parseRuleValue(value) {
+  if (typeof value === "string") {
+    return { level: value };
+  }
+  if (typeof value === "number") {
+    return { level: String(value) };
+  }
+  if (Array.isArray(value) && value.length > 0) {
+    return {
+      level: String(value[0]),
+      options: value.length > 1 ? value.slice(1) : void 0
+    };
+  }
+  return void 0;
+}
+function normalizeLevel(level) {
+  if (level === "0" || level === "off") return "off";
+  if (level === "1" || level === "warn") return "warn";
+  if (level === "2" || level === "error") return "error";
+  return level;
+}
+function rulesMatch(a, b) {
+  if (normalizeLevel(a.level) !== normalizeLevel(b.level)) return false;
+  return JSON.stringify(a.options) === JSON.stringify(b.options);
+}
+function formatRule(entry) {
+  if (entry.options) {
+    return JSON.stringify([entry.level, ...entry.options]);
+  }
+  return JSON.stringify([entry.level]);
+}
+function mergeRulesFromBlocks(blocks) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const block of blocks) {
+    if (!block.rules) continue;
+    for (const [name, value] of Object.entries(block.rules)) {
+      const parsed = parseRuleValue(value);
+      if (parsed) merged.set(name, parsed);
+    }
+  }
+  return merged;
+}
+function detectSharedPackage(source) {
+  if (source.includes("@xylabs/eslint-config-react-flat")) return "@xylabs/eslint-config-react-flat";
+  if (source.includes("@xylabs/eslint-config-flat")) return "@xylabs/eslint-config-flat";
+  return void 0;
+}
+function extractLocalRuleBlocks(source) {
+  const blocks = [];
+  const ruleBlockRegex = /\{\s*(?:files\s*:\s*\[.*?\]\s*,\s*)?rules\s*:\s*\{([^}]*(?:\{[^}]*\}[^}]*)*)\}/g;
+  let match;
+  while ((match = ruleBlockRegex.exec(source)) !== null) {
+    blocks.push(match[1]);
+  }
+  return blocks;
+}
+function extractRulesFromSourceBlocks(blocks) {
+  const rules2 = /* @__PURE__ */ new Map();
+  for (const block of blocks) {
+    const ruleRegex = /['"]([^'"]+)['"]\s*:\s*(\[[\s\S]*?\](?=\s*,|\s*$))/gm;
+    let match;
+    while ((match = ruleRegex.exec(block)) !== null) {
+      rules2.set(match[1], match[2]);
+    }
+  }
+  return rules2;
+}
+async function resolveSharedConfig(configDir, sharedPkg) {
+  try {
+    const sharedModule = await import(sharedPkg);
+    const config2 = sharedModule.config ?? sharedModule.default;
+    if (Array.isArray(config2)) return config2;
+    return [];
+  } catch {
+    const distPath = PATH.resolve(configDir, "node_modules", sharedPkg, "dist", "node", "index.mjs");
+    try {
+      const sharedModule = await import(distPath);
+      const config2 = sharedModule.config ?? sharedModule.default;
+      if (Array.isArray(config2)) return config2;
+    } catch {
+      const neutralPath = PATH.resolve(configDir, "node_modules", sharedPkg, "dist", "neutral", "index.mjs");
+      const sharedModule = await import(neutralPath);
+      const config2 = sharedModule.config ?? sharedModule.default;
+      if (Array.isArray(config2)) return config2;
+    }
+    return [];
+  }
+}
+async function loadSharedRules(configDir, sharedPkg, verbose) {
+  const sharedBlocks = await resolveSharedConfig(configDir, sharedPkg);
+  const sharedRules = mergeRulesFromBlocks(sharedBlocks);
+  if (verbose) {
+    console.log(chalk13.gray(`Shared config defines ${sharedRules.size} rules`));
+  }
+  if (sharedRules.size === 0) {
+    console.error(chalk13.red("Could not load rules from shared config. Is it installed and built?"));
+    return void 0;
+  }
+  return sharedRules;
+}
+async function loadLocalRules(eslintConfigPath, source, verbose) {
+  const localModule = await import(eslintConfigPath);
+  const localConfig = localModule.default ?? localModule;
+  const localBlocks = Array.isArray(localConfig) ? localConfig : [localConfig];
+  const resolved = mergeRulesFromBlocks(localBlocks);
+  const localRuleBlocks = extractLocalRuleBlocks(source);
+  const explicit = extractRulesFromSourceBlocks(localRuleBlocks);
+  if (verbose) {
+    console.log(chalk13.gray(`Local config has ${explicit.size} explicit rule setting(s)`));
+  }
+  return { explicit, resolved };
+}
+function compareRules(explicitRuleNames, allResolvedRules, sharedRules) {
+  const redundant = [];
+  const overrides = [];
+  const additions = [];
+  for (const ruleName of explicitRuleNames.keys()) {
+    const resolvedEntry = allResolvedRules.get(ruleName);
+    const sharedEntry = sharedRules.get(ruleName);
+    if (!resolvedEntry) continue;
+    if (!sharedEntry) {
+      additions.push({ local: resolvedEntry, rule: ruleName });
+    } else if (rulesMatch(resolvedEntry, sharedEntry)) {
+      redundant.push({
+        local: resolvedEntry,
+        rule: ruleName,
+        shared: sharedEntry
+      });
+    } else {
+      overrides.push({
+        local: resolvedEntry,
+        rule: ruleName,
+        shared: sharedEntry
+      });
+    }
+  }
+  return {
+    additions,
+    overrides,
+    redundant
+  };
+}
+function reportResults({
+  additions,
+  overrides,
+  redundant
+}, verbose) {
+  if (redundant.length > 0) {
+    console.log(chalk13.yellow(`
+${redundant.length} redundant rule(s) (same as shared config \u2014 can be removed):`));
+    for (const { rule, local } of redundant) {
+      console.log(chalk13.yellow(`  ${rule}: ${formatRule(local)}`));
+    }
+  }
+  if (overrides.length > 0) {
+    console.log(chalk13.cyan(`
+${overrides.length} rule override(s) (different from shared config):`));
+    for (const {
+      rule,
+      local,
+      shared
+    } of overrides) {
+      console.log(chalk13.cyan(`  ${rule}:`));
+      console.log(chalk13.gray(`    shared: ${formatRule(shared)}`));
+      console.log(chalk13.white(`    local:  ${formatRule(local)}`));
+    }
+  }
+  if (additions.length > 0 && verbose) {
+    console.log(chalk13.gray(`
+${additions.length} local addition(s) (not in shared config):`));
+    for (const { rule, local } of additions) {
+      console.log(chalk13.gray(`  ${rule}: ${formatRule(local)}`));
+    }
+  }
+  if (redundant.length === 0 && overrides.length === 0) {
+    console.log(chalk13.green("No redundant or overridden rules found"));
+  }
+}
+function fixRedundantRules(eslintConfigPath, source, redundant) {
+  let updated = source;
+  for (const { rule } of redundant) {
+    const escaped = rule.replaceAll("/", String.raw`\/`);
+    const pattern = new RegExp(String.raw`[ \t]*['"]${escaped}['"]\s*:\s*\[[^\]]*\],?[ \t]*\n?`, "g");
+    updated = updated.replace(pattern, "");
+  }
+  updated = updated.replaceAll(/\n{3,}/g, "\n\n");
+  if (updated !== source) {
+    writeFileSync(eslintConfigPath, updated, "utf8");
+    console.log(chalk13.green(`
+Fixed: removed ${redundant.length} redundant rule(s)`));
+  }
+}
+async function lintlint({ fix: fix2, verbose } = {}) {
+  const eslintConfigPath = await findUp("eslint.config.mjs");
+  if (!eslintConfigPath) {
+    console.error(chalk13.red("No eslint.config.mjs found"));
+    return 1;
+  }
+  const configDir = PATH.dirname(eslintConfigPath);
+  if (verbose) {
+    console.log(chalk13.gray(`Found config: ${eslintConfigPath}`));
+  }
+  const source = readFileSync(eslintConfigPath, "utf8");
+  const sharedPkg = detectSharedPackage(source);
+  if (!sharedPkg) {
+    console.log(chalk13.yellow("No @xylabs/eslint-config-flat or @xylabs/eslint-config-react-flat imports found"));
+    return 0;
+  }
+  if (verbose) {
+    console.log(chalk13.gray(`Shared package: ${sharedPkg}`));
+  }
+  const sharedRules = await loadSharedRules(configDir, sharedPkg, !!verbose);
+  if (!sharedRules) return 1;
+  const { explicit, resolved } = await loadLocalRules(eslintConfigPath, source, !!verbose);
+  const results = compareRules(explicit, resolved, sharedRules);
+  reportResults(results, !!verbose);
+  if (results.redundant.length > 0 && fix2) {
+    fixRedundantRules(eslintConfigPath, source, results.redundant);
+  }
+  return results.redundant.length > 0 && !fix2 ? 1 : 0;
+}
+
+// src/actions/package-lint.ts
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import PATH2 from "path";
+import chalk14 from "chalk";
+import picomatch from "picomatch";
+function emptyResult() {
+  return {
+    errors: [],
+    fixable: [],
+    warnings: []
+  };
+}
+function readRootPackageJson(cwd) {
+  const raw = readFileSync2(PATH2.resolve(cwd, "package.json"), "utf8");
+  return JSON.parse(raw);
+}
+function writeRootPackageJson(cwd, pkg) {
+  const path6 = PATH2.resolve(cwd, "package.json");
+  writeFileSync2(path6, `${JSON.stringify(pkg, null, 2)}
+`, "utf8");
+}
+function isMonorepo(pkg) {
+  const workspaces = pkg.workspaces;
+  return Array.isArray(workspaces) && workspaces.length > 0;
+}
+function checkPackagesFolder(workspaces) {
+  const result = emptyResult();
+  for (const { location, name } of workspaces) {
+    if (location === ".") continue;
+    if (!location.startsWith("packages/") && !location.startsWith("packages\\")) {
+      result.errors.push(`${name} (${location}) is not inside a packages/ folder`);
+    }
+  }
+  return result;
+}
+function checkRootPrivate(pkg) {
+  const result = emptyResult();
+  if (!pkg.private) {
+    result.fixable.push("Root package.json must be private to prevent accidental publishing");
+  }
+  return result;
+}
+function fixRootPrivate(cwd, pkg) {
+  pkg.private = true;
+  writeRootPackageJson(cwd, pkg);
+  console.log(chalk14.green('  \u2714 Fixed: set "private": true in root package.json'));
+}
+function checkNoPublishConfigOnPrivate(pkg) {
+  const result = emptyResult();
+  if (pkg.private && pkg.publishConfig) {
+    result.fixable.push("Root package.json has publishConfig but is private \u2014 publishConfig is unnecessary");
+  }
+  return result;
+}
+function fixNoPublishConfigOnPrivate(cwd, pkg) {
+  delete pkg.publishConfig;
+  writeRootPackageJson(cwd, pkg);
+  console.log(chalk14.green("  \u2714 Fixed: removed publishConfig from private root package.json"));
+}
+function checkDiscoverable(pkg, workspaces) {
+  const result = emptyResult();
+  const globs = pkg.workspaces;
+  const matchers = globs.map((glob) => picomatch(glob));
+  const isMatch = (location) => matchers.some((m) => m(location));
+  for (const { location, name } of workspaces) {
+    if (location === ".") continue;
+    if (!isMatch(location)) {
+      result.errors.push(`${name} (${location}) is not matched by any workspace glob in package.json`);
+    }
+  }
+  return result;
+}
+function logResults(label, result, fix2) {
+  let errors = 0;
+  let fixed = 0;
+  for (const error of result.errors) {
+    console.log(chalk14.red(`  \u2717 ${error}`));
+    errors++;
+  }
+  for (const fixable of result.fixable) {
+    if (fix2) {
+      fixed++;
+    } else {
+      console.log(chalk14.red(`  \u2717 ${fixable} (fixable)`));
+      errors++;
+    }
+  }
+  for (const warning of result.warnings) {
+    console.log(chalk14.yellow(`  \u26A0 ${warning}`));
+  }
+  if (errors === 0 && fixed === 0 && result.warnings.length === 0) {
+    console.log(chalk14.green(`  \u2713 ${label}`));
+  }
+  return { errors, fixed };
+}
+function runChecks(entries, cwd, pkg, fix2) {
+  let totalErrors = 0;
+  let totalFixed = 0;
+  for (const entry of entries) {
+    const result = entry.check();
+    const log = logResults(entry.label, result, fix2);
+    if (fix2 && entry.fix && result.fixable.length > 0) {
+      entry.fix(cwd, pkg);
+    }
+    totalErrors += log.errors;
+    totalFixed += log.fixed;
+  }
+  return { errors: totalErrors, fixed: totalFixed };
+}
+function logSummary(errors, fixed) {
+  if (fixed > 0) {
+    console.log(chalk14.green(`
+  Fixed ${fixed} issue(s)`));
+  }
+  if (errors > 0) {
+    console.log(chalk14.red(`
+  ${errors} error(s) found`));
+  } else if (fixed === 0) {
+    console.log(chalk14.green("\n  All checks passed"));
+  }
+}
+function packageLintMonorepo(fix2 = false) {
+  const cwd = INIT_CWD() ?? process.cwd();
+  let pkg;
+  try {
+    pkg = readRootPackageJson(cwd);
+  } catch {
+    console.error(chalk14.red("Could not read package.json"));
+    return 1;
+  }
+  if (!isMonorepo(pkg)) {
+    console.log(chalk14.gray("Not a monorepo \u2014 skipping package-lint checks"));
+    return 0;
+  }
+  console.log(chalk14.green("Package Lint"));
+  const workspaces = getPackageManager().listWorkspaces();
+  const checks = [
+    {
+      check: () => checkRootPrivate(pkg),
+      fix: fixRootPrivate,
+      label: "Root package is private"
+    },
+    {
+      check: () => checkNoPublishConfigOnPrivate(pkg),
+      fix: fixNoPublishConfigOnPrivate,
+      label: "No publishConfig on private root"
+    },
+    { check: () => checkPackagesFolder(workspaces), label: "All packages are in packages/ folder" },
+    { check: () => checkDiscoverable(pkg, workspaces), label: "All packages are discoverable from workspace globs" }
+  ];
+  const { errors, fixed } = runChecks(checks, cwd, pkg, fix2);
+  logSummary(errors, fixed);
+  return errors > 0 ? 1 : 0;
+}
+
+// src/actions/publint.ts
+var publint = async ({ verbose, pkg }) => {
+  return pkg === void 0 ? publintAll({ verbose }) : await publintPackage({ pkg, verbose });
+};
+var publintPackage = ({ pkg }) => {
+  const pm = getPackageManager();
+  return runStepsAsync(`Publint [${pkg}]`, [pm.runInWorkspace(pkg, "package-publint")]);
+};
+var publintAll = ({ verbose }) => {
+  const pm = getPackageManager();
+  return runSteps("Publint", [pm.foreachWorkspace("package-publint", [], { verbose })]);
+};
+
+// src/actions/relint.ts
+import chalk15 from "chalk";
+var relintPackage = ({
+  pkg,
+  fix: fix2,
+  verbose
+}) => {
+  console.log(chalk15.gray(`${fix2 ? "Fix" : "Lint"} [${pkg}]`));
+  const start = Date.now();
+  const pm = getPackageManager();
+  const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [${pkg}]`, [
+    pm.runInWorkspace(pkg, fix2 ? "package-fix" : verbose ? "package-lint-verbose" : "package-lint")
+  ]);
+  console.log(chalk15.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk15.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk15.gray("seconds")}`));
+  return result;
+};
+var relint = ({
+  pkg,
+  verbose,
+  incremental,
+  fix: fix2
+} = {}) => {
+  return pkg === void 0 ? relintAllPackages({
+    verbose,
+    incremental,
+    fix: fix2
+  }) : relintPackage({
+    pkg,
+    fix: fix2,
+    verbose
+  });
+};
+var relintAllPackages = ({ fix: fix2 = false } = {}) => {
+  console.log(chalk15.gray(`${fix2 ? "Fix" : "Lint"} [All-Packages]`));
+  const start = Date.now();
+  const fixOptions = fix2 ? ["--fix"] : [];
+  const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [All-Packages]`, [
+    ["eslint", fixOptions]
+  ]);
+  console.log(chalk15.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk15.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk15.gray("seconds")}`));
+  return result;
+};
+
+// src/actions/sonar.ts
+var sonar = () => {
+  return runSteps("Sonar", [["eslint", ["-c", "sonar.eslintrc", "."]]]);
+};
+
+// src/xy/param.ts
+var packagePositionalParam = (yargs) => {
+  return yargs.positional("package", { describe: "Specific package to target", type: "string" });
+};
+
+// src/xy/lint/cycleCommand.ts
+var cycleCommand = {
+  command: "cycle [package]",
+  describe: "Cycle - Check for dependency cycles",
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  handler: async (argv) => {
+    const start = Date.now();
+    if (argv.verbose) console.log("Cycle");
+    process.exitCode = await cycle({ pkg: argv.package });
+    console.log(chalk16.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/deplintCommand.ts
+import chalk17 from "chalk";
+var deplintCommand = {
+  command: "deplint [package]",
+  describe: "Deplint - Run Deplint",
+  builder: (yargs) => {
+    return packagePositionalParam(yargs).option("deps", {
+      alias: "d",
+      default: false,
+      description: "Check dependencies",
+      type: "boolean"
+    }).option("devDeps", {
+      alias: "v",
+      default: false,
+      description: "Check devDependencies",
+      type: "boolean"
+    }).option("peerDeps", {
+      alias: "p",
+      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"
+    });
+  },
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Deplint");
+    const start = Date.now();
+    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,
+      peerDeps: !!argv.peerDeps,
+      verbose: !!argv.verbose
+    });
+    console.log(chalk17.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/fixCommand.ts
+import chalk18 from "chalk";
+var fixCommand = {
+  command: "fix [package]",
+  describe: "Fix - Run Eslint w/fix",
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  handler: (argv) => {
+    const start = Date.now();
+    if (argv.verbose) console.log("Fix");
+    process.exitCode = fix();
+    console.log(chalk18.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/knipCommand.ts
+import chalk19 from "chalk";
+var knipCommand = {
+  command: "knip",
+  describe: "Knip - Run Knip",
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log("Knip");
+    const start = Date.now();
+    process.exitCode = knip();
+    console.log(chalk19.blue(`Knip finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/lintCommand.ts
+import chalk20 from "chalk";
+var lintCommand = {
+  command: "lint [package]",
+  describe: "Lint - Run Eslint",
+  builder: (yargs) => {
+    return packagePositionalParam(yargs).option("fix", {
+      alias: "f",
+      default: false,
+      description: "Fix fixable issues",
+      type: "boolean"
+    }).option("cache", {
+      alias: "c",
+      default: false,
+      description: "Use caching for performance",
+      type: "boolean"
+    });
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log("Lint");
+    const start = Date.now();
+    process.exitCode = argv.fix ? fix({
+      pkg: argv.package,
+      cache: argv.cache,
+      verbose: !!argv.verbose
+    }) : lint({
+      pkg: argv.package,
+      cache: argv.cache,
+      verbose: !!argv.verbose
+    });
+    console.log(chalk20.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/lintlintCommand.ts
+var lintlintCommand = {
+  command: "lintlint",
+  describe: "Lint Lint - Check for redundant or overridden ESLint rules vs shared config",
+  builder: (yargs) => {
+    return yargs.option("fix", {
+      default: false,
+      description: "Remove redundant rules from local config",
+      type: "boolean"
+    });
+  },
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Lint Lint");
+    process.exitCode = await lintlint({
+      fix: argv.fix,
+      verbose: !!argv.verbose
+    });
+  }
+};
+
+// src/xy/lint/packageLintCommand.ts
+var packageLintCommand = {
+  builder: (yargs) => {
+    return yargs.option("fix", {
+      default: false,
+      description: "Auto-fix fixable issues",
+      type: "boolean"
+    });
+  },
+  command: "package-lint",
+  describe: "Package Lint - Check monorepo package structure",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Package Lint");
+    process.exitCode = packageLintMonorepo(!!argv.fix);
+  }
+};
+
+// src/xy/lint/publintCommand.ts
+import chalk21 from "chalk";
+var publintCommand = {
+  command: "publint [package]",
+  describe: "Publint - Run Publint",
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Publint");
+    const start = Date.now();
+    process.exitCode = await publint({ pkg: argv.package, verbose: !!argv.verbose });
+    console.log(chalk21.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/relintCommand.ts
+import chalk22 from "chalk";
+var relintCommand = {
+  command: "relint [package]",
+  describe: "Relint - Clean & Lint",
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log("Relinting");
+    const start = Date.now();
+    process.exitCode = relint();
+    console.log(chalk22.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/sonarCommand.ts
+import chalk23 from "chalk";
+var sonarCommand = {
+  command: "sonar",
+  describe: "Sonar - Run Sonar Check",
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  handler: (argv) => {
+    const start = Date.now();
+    if (argv.verbose) console.log("Sonar Check");
+    process.exitCode = sonar();
+    console.log(chalk23.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/index.ts
+var xyLintCommands = (args) => {
+  return args.command(cycleCommand).command(lintCommand).command(lintlintCommand).command(deplintCommand).command(fixCommand).command(relintCommand).command(publintCommand).command(knipCommand).command(packageLintCommand).command(sonarCommand);
+};
+export {
+  xyLintCommands
+};
+//# sourceMappingURL=index.mjs.map