@xylabs/ts-scripts-yarn3 7.4.22 → 7.4.24

package/dist/xy/lint/index.mjs

@@ -1,5 +1,5 @@
 // src/xy/lint/cycleCommand.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 
 // src/lib/checkResult.ts
 import chalk from "chalk";
@@ -90,6 +90,12 @@ var yarnWorkspace = (pkg) => {
   return workspace;
 };
 
+// src/lib/yarn/yarnInitCwd.ts
+var 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";
@@ -1015,6 +1021,161 @@ var knip = () => {
   return runSteps("Knip", [["yarn", ["knip", "--dependencies", "--no-exit-code"]]]);
 };
 
+// src/actions/package-lint.ts
+import { readFileSync, writeFileSync } from "fs";
+import PATH from "path";
+import chalk13 from "chalk";
+import picomatch from "picomatch";
+function emptyResult() {
+  return {
+    errors: [],
+    fixable: [],
+    warnings: []
+  };
+}
+function readRootPackageJson(cwd) {
+  const raw = readFileSync(PATH.resolve(cwd, "package.json"), "utf8");
+  return JSON.parse(raw);
+}
+function writeRootPackageJson(cwd, pkg) {
+  const path6 = PATH.resolve(cwd, "package.json");
+  writeFileSync(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(chalk13.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(chalk13.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(chalk13.red(`  \u2717 ${error}`));
+    errors++;
+  }
+  for (const fixable of result.fixable) {
+    if (fix2) {
+      fixed++;
+    } else {
+      console.log(chalk13.red(`  \u2717 ${fixable} (fixable)`));
+      errors++;
+    }
+  }
+  for (const warning of result.warnings) {
+    console.log(chalk13.yellow(`  \u26A0 ${warning}`));
+  }
+  if (errors === 0 && fixed === 0 && result.warnings.length === 0) {
+    console.log(chalk13.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(chalk13.green(`
+  Fixed ${fixed} issue(s)`));
+  }
+  if (errors > 0) {
+    console.log(chalk13.red(`
+  ${errors} error(s) found`));
+  } else if (fixed === 0) {
+    console.log(chalk13.green("\n  All checks passed"));
+  }
+}
+function packageLintMonorepo(fix2 = false) {
+  const cwd = INIT_CWD() ?? process.cwd();
+  let pkg;
+  try {
+    pkg = readRootPackageJson(cwd);
+  } catch {
+    console.error(chalk13.red("Could not read package.json"));
+    return 1;
+  }
+  if (!isMonorepo(pkg)) {
+    console.log(chalk13.gray("Not a monorepo \u2014 skipping package-lint checks"));
+    return 0;
+  }
+  console.log(chalk13.green("Package Lint"));
+  const workspaces = yarnWorkspaces();
+  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 });
@@ -1028,13 +1189,13 @@ var publintAll = ({ verbose }) => {
 };
 
 // src/actions/relint.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 var relintPackage = ({
   pkg,
   fix: fix2,
   verbose
 }) => {
-  console.log(chalk13.gray(`${fix2 ? "Fix" : "Lint"} [${pkg}]`));
+  console.log(chalk14.gray(`${fix2 ? "Fix" : "Lint"} [${pkg}]`));
   const start = Date.now();
   const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [${pkg}]`, [
     ["yarn", [
@@ -1044,7 +1205,7 @@ var relintPackage = ({
       fix2 ? "package-fix" : verbose ? "package-lint-verbose" : "package-lint"
     ]]
   ]);
-  console.log(chalk13.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk13.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk13.gray("seconds")}`));
+  console.log(chalk14.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk14.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk14.gray("seconds")}`));
   return result;
 };
 var relint = ({
@@ -1064,13 +1225,13 @@ var relint = ({
   });
 };
 var relintAllPackages = ({ fix: fix2 = false } = {}) => {
-  console.log(chalk13.gray(`${fix2 ? "Fix" : "Lint"} [All-Packages]`));
+  console.log(chalk14.gray(`${fix2 ? "Fix" : "Lint"} [All-Packages]`));
   const start = Date.now();
   const fixOptions = fix2 ? ["--fix"] : [];
   const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [All-Packages]`, [
     ["yarn", ["eslint", ...fixOptions]]
   ]);
-  console.log(chalk13.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk13.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk13.gray("seconds")}`));
+  console.log(chalk14.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk14.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk14.gray("seconds")}`));
   return result;
 };
 
@@ -1095,12 +1256,12 @@ var cycleCommand = {
     const start = Date.now();
     if (argv.verbose) console.log("Cycle");
     process.exitCode = await cycle({ pkg: argv.package });
-    console.log(chalk14.blue(`Finished in ${Date.now() - start}ms`));
+    console.log(chalk15.blue(`Finished in ${Date.now() - start}ms`));
   }
 };
 
 // src/xy/lint/deplintCommand.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 var deplintCommand = {
   command: "deplint [package]",
   describe: "Deplint - Run Deplint",
@@ -1138,12 +1299,12 @@ var deplintCommand = {
       peerDeps: !!argv.peerDeps,
       verbose: !!argv.verbose
     });
-    console.log(chalk15.blue(`Finished in ${Date.now() - start}ms`));
+    console.log(chalk16.blue(`Finished in ${Date.now() - start}ms`));
   }
 };
 
 // src/xy/lint/fixCommand.ts
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 var fixCommand = {
   command: "fix [package]",
   describe: "Fix - Run Eslint w/fix",
@@ -1154,12 +1315,12 @@ var fixCommand = {
     const start = Date.now();
     if (argv.verbose) console.log("Fix");
     process.exitCode = fix();
-    console.log(chalk16.blue(`Finished in ${Date.now() - start}ms`));
+    console.log(chalk17.blue(`Finished in ${Date.now() - start}ms`));
   }
 };
 
 // src/xy/lint/knipCommand.ts
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 var knipCommand = {
   command: "knip",
   describe: "Knip - Run Knip",
@@ -1170,12 +1331,12 @@ var knipCommand = {
     if (argv.verbose) console.log("Knip");
     const start = Date.now();
     process.exitCode = knip();
-    console.log(chalk17.blue(`Knip finished in ${Date.now() - start}ms`));
+    console.log(chalk18.blue(`Knip finished in ${Date.now() - start}ms`));
   }
 };
 
 // src/xy/lint/lintCommand.ts
-import chalk18 from "chalk";
+import chalk19 from "chalk";
 var lintCommand = {
   command: "lint [package]",
   describe: "Lint - Run Eslint",
@@ -1204,12 +1365,29 @@ var lintCommand = {
       cache: argv.cache,
       verbose: !!argv.verbose
     });
-    console.log(chalk18.blue(`Finished in ${Date.now() - start}ms`));
+    console.log(chalk19.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// 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 chalk19 from "chalk";
+import chalk20 from "chalk";
 var publintCommand = {
   command: "publint [package]",
   describe: "Publint - Run Publint",
@@ -1220,12 +1398,12 @@ var publintCommand = {
     if (argv.verbose) console.log("Publint");
     const start = Date.now();
     process.exitCode = await publint({ pkg: argv.package, verbose: !!argv.verbose });
-    console.log(chalk19.blue(`Finished in ${Date.now() - start}ms`));
+    console.log(chalk20.blue(`Finished in ${Date.now() - start}ms`));
   }
 };
 
 // src/xy/lint/relintCommand.ts
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 var relintCommand = {
   command: "relint [package]",
   describe: "Relint - Clean & Lint",
@@ -1236,12 +1414,12 @@ var relintCommand = {
     if (argv.verbose) console.log("Relinting");
     const start = Date.now();
     process.exitCode = relint();
-    console.log(chalk20.blue(`Finished in ${Date.now() - start}ms`));
+    console.log(chalk21.blue(`Finished in ${Date.now() - start}ms`));
   }
 };
 
 // src/xy/lint/sonarCommand.ts
-import chalk21 from "chalk";
+import chalk22 from "chalk";
 var sonarCommand = {
   command: "sonar",
   describe: "Sonar - Run Sonar Check",
@@ -1252,13 +1430,13 @@ var sonarCommand = {
     const start = Date.now();
     if (argv.verbose) console.log("Sonar Check");
     process.exitCode = sonar();
-    console.log(chalk21.blue(`Finished in ${Date.now() - start}ms`));
+    console.log(chalk22.blue(`Finished in ${Date.now() - start}ms`));
   }
 };
 
 // src/xy/lint/index.ts
 var xyLintCommands = (args) => {
-  return args.command(cycleCommand).command(lintCommand).command(deplintCommand).command(fixCommand).command(relintCommand).command(publintCommand).command(knipCommand).command(sonarCommand);
+  return args.command(cycleCommand).command(lintCommand).command(deplintCommand).command(fixCommand).command(relintCommand).command(publintCommand).command(knipCommand).command(packageLintCommand).command(sonarCommand);
 };
 export {
   xyLintCommands