@xylabs/ts-scripts-yarn3 7.4.10 → 7.4.12

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/actions/build.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 
 // src/lib/checkResult.ts
 import chalk from "chalk";
@@ -379,8 +379,138 @@ var generateIgnoreFiles = (filename3, pkg) => {
   return succeeded ? 0 : 1;
 };
 
-// src/lib/loadConfig.ts
+// src/lib/generateReadmeFiles.ts
+import { execSync as execSync2 } from "child_process";
+import FS from "fs";
+import { readFile, writeFile } from "fs/promises";
+import PATH2 from "path";
 import chalk5 from "chalk";
+function fillTemplate(template, data) {
+  const additionalData = { ...data, safeName: data.name.replaceAll("/", "__").replaceAll("@", "") };
+  return template.replaceAll(/\{\{(.*?)\}\}/g, (_, key) => additionalData[key.trim()] ?? "");
+}
+function generateTypedoc(packageLocation, entryPoints) {
+  const tempDir = PATH2.join(packageLocation, ".temp-typedoc");
+  try {
+    if (!FS.existsSync(tempDir)) {
+      FS.mkdirSync(tempDir, { recursive: true });
+    }
+    const typedocConfig = {
+      disableSources: true,
+      entryPointStrategy: "expand",
+      entryPoints: entryPoints.map((ep) => PATH2.resolve(packageLocation, ep)),
+      excludeExternals: true,
+      excludeInternal: true,
+      excludePrivate: true,
+      githubPages: false,
+      hideBreadcrumbs: true,
+      hideGenerator: true,
+      hidePageTitle: true,
+      out: tempDir,
+      plugin: ["typedoc-plugin-markdown"],
+      readme: "none",
+      skipErrorChecking: true,
+      sort: ["source-order"],
+      theme: "markdown",
+      useCodeBlocks: true
+    };
+    const typedocJsonPath = PATH2.join(tempDir, "typedoc.json");
+    FS.writeFileSync(typedocJsonPath, JSON.stringify(typedocConfig, null, 2));
+    try {
+      execSync2(`npx typedoc --options ${typedocJsonPath}`, {
+        cwd: process.cwd(),
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+    } catch {
+      return "";
+    }
+    return consolidateMarkdown(tempDir);
+  } catch {
+    return "";
+  } finally {
+    try {
+      FS.rmSync(tempDir, { force: true, recursive: true });
+    } catch {
+    }
+  }
+}
+function consolidateMarkdown(tempDir) {
+  let consolidated = "## Reference\n\n";
+  const mainReadmePath = PATH2.join(tempDir, "README.md");
+  if (FS.existsSync(mainReadmePath)) {
+    const mainContent = FS.readFileSync(mainReadmePath, "utf8").replace(/^---(.|\n)*?---\n/, "").replace(/^# .+\n/, "").replaceAll(/\]\((.+?)\.md\)/g, "](#$1)");
+    consolidated += mainContent + "\n\n";
+  }
+  consolidated += processDirectory(tempDir);
+  return consolidated.replaceAll(/\n\n\n+/g, "\n\n").replaceAll(/^#### /gm, "### ").replaceAll(/^##### /gm, "#### ").replaceAll(/^###### /gm, "##### ");
+}
+function processDirectory(dir, level = 0) {
+  const indent = "  ".repeat(level);
+  let content = "";
+  try {
+    const items = FS.readdirSync(dir, { withFileTypes: true });
+    for (const item of items) {
+      if (item.isDirectory()) continue;
+      if (item.name === "README.md" || !item.name.endsWith(".md")) continue;
+      const fileContent = FS.readFileSync(PATH2.join(dir, item.name), "utf8").replace(/^---(.|\n)*?---\n/, "");
+      const moduleName = item.name.replace(".md", "");
+      content += `
+
+${indent}### <a id="${moduleName}"></a>${moduleName}
+
+`;
+      content += fileContent.replace(/^# .+\n/, "").replaceAll(/\]\((.+?)\.md\)/g, "](#$1)");
+    }
+    for (const item of items) {
+      if (!item.isDirectory()) continue;
+      if (item.name === "spec" || item.name.includes(".spec")) continue;
+      content += `
+
+${indent}### ${item.name}
+`;
+      content += processDirectory(PATH2.join(dir, item.name), level + 1);
+    }
+  } catch {
+  }
+  return content;
+}
+async function generateReadmeFiles({
+  pkg,
+  templatePath,
+  typedoc = false,
+  verbose
+}) {
+  console.log(chalk5.green("Generate README Files"));
+  const cwd5 = INIT_CWD() ?? ".";
+  const resolvedTemplatePath = templatePath ?? PATH2.join(cwd5, "scripts", "README.template.md");
+  let template;
+  try {
+    template = await readFile(resolvedTemplatePath, "utf8");
+  } catch {
+    console.error(chalk5.red(`Template not found: ${resolvedTemplatePath}`));
+    return 1;
+  }
+  const workspaces = pkg ? [yarnWorkspace(pkg)] : yarnWorkspaces();
+  let failed = false;
+  for (const { location, name } of workspaces) {
+    try {
+      const pkgJsonPath = PATH2.join(location, "package.json");
+      const pkgJson = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+      const typedocContent = typedoc ? generateTypedoc(location, ["src/index*.ts"]) : "";
+      const readmeContent = fillTemplate(template, { ...pkgJson, typedoc: typedocContent });
+      await writeFile(PATH2.join(location, "README.md"), readmeContent);
+      if (verbose) console.log(chalk5.green(`  ${name}`));
+    } catch (ex) {
+      const error = ex;
+      console.warn(chalk5.yellow(`  Skipped ${location}: ${error.message}`));
+      failed = true;
+    }
+  }
+  return failed ? 1 : 0;
+}
+
+// src/lib/loadConfig.ts
+import chalk6 from "chalk";
 import { cosmiconfig } from "cosmiconfig";
 import { TypeScriptLoader } from "cosmiconfig-typescript-loader";
 import deepmerge from "deepmerge";
@@ -391,9 +521,9 @@ var loadConfig = async (params) => {
     config = cosmicConfigResult?.config;
     const configFilePath = cosmicConfigResult?.filepath;
     if (configFilePath !== void 0) {
-      console.log(chalk5.green(`Loaded config from ${configFilePath}`));
+      console.log(chalk6.green(`Loaded config from ${configFilePath}`));
       if (config.verbose) {
-        console.log(chalk5.gray(`${JSON.stringify(config, null, 2)}`));
+        console.log(chalk6.gray(`${JSON.stringify(config, null, 2)}`));
       }
     }
   }
@@ -402,8 +532,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);
 };
@@ -411,15 +541,15 @@ var parsedPackageJSON = (path13) => {
 // src/lib/runSteps.ts
 import { spawnSync as spawnSync3 } from "child_process";
 import { existsSync as existsSync3 } from "fs";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 var runSteps = (name, steps, exitOnFail = true, messages) => {
   return safeExit(() => {
     const pkgName = process.env.npm_package_name;
-    console.log(chalk6.green(`${name} [${pkgName}]`));
+    console.log(chalk7.green(`${name} [${pkgName}]`));
     let totalStatus = 0;
     for (const [i, [command, args, config2]] of steps.entries()) {
       if (messages?.[i]) {
-        console.log(chalk6.gray(messages?.[i]));
+        console.log(chalk7.gray(messages?.[i]));
       }
       const argList = Array.isArray(args) ? args : args.split(" ");
       if (command === "node" && !existsSync3(argList[0])) {
@@ -442,12 +572,12 @@ var runSteps = (name, steps, exitOnFail = true, messages) => {
 // src/lib/runStepsAsync.ts
 import { spawn } from "child_process";
 import { existsSync as existsSync4 } from "fs";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 var runStepAsync = (name, step, exitOnFail = true, message) => {
   return new Promise((resolve) => {
     const [command, args, config2] = step;
     if (message) {
-      console.log(chalk7.gray(message));
+      console.log(chalk8.gray(message));
     }
     const argList = Array.isArray(args) ? args : args.split(" ");
     if (command === "node" && !existsSync4(argList[0])) {
@@ -461,8 +591,8 @@ var runStepAsync = (name, step, exitOnFail = true, message) => {
     }).on("close", (code) => {
       if (code) {
         console.error(
-          chalk7.red(
-            `Command Exited With Non-Zero Result [${chalk7.gray(code)}] | ${chalk7.yellow(command)} ${chalk7.white(
+          chalk8.red(
+            `Command Exited With Non-Zero Result [${chalk8.gray(code)}] | ${chalk8.yellow(command)} ${chalk8.white(
               Array.isArray(args) ? args.join(" ") : args
             )}`
           )
@@ -478,7 +608,7 @@ var runStepAsync = (name, step, exitOnFail = true, message) => {
 var runStepsAsync = async (name, steps, exitOnFail = true, messages) => {
   return await safeExitAsync(async () => {
     const pkgName = process.env.npm_package_name;
-    console.log(chalk7.green(`${name} [${pkgName}]`));
+    console.log(chalk8.green(`${name} [${pkgName}]`));
     let result = 0;
     for (const [i, step] of steps.entries()) {
       result += await runStepAsync(name, step, exitOnFail, messages?.[i]);
@@ -496,12 +626,12 @@ var runXy = (command) => {
 };
 
 // src/lib/runXyWithWarning.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 var runXyWithWarning = (command) => {
   const commandString = `yarn ${command}`;
   const commandXyString = `yarn xy ${command}`;
-  console.warn(chalk8.yellow(`WARNING: [${chalk8.white(commandString)}] is deprecated for XY Labs Scripts.`));
-  console.warn(chalk8.gray(`Did you mean [${chalk8.magenta(commandXyString)}]?`));
+  console.warn(chalk9.yellow(`WARNING: [${chalk9.white(commandString)}] is deprecated for XY Labs Scripts.`));
+  console.warn(chalk9.gray(`Did you mean [${chalk9.magenta(commandXyString)}]?`));
   return 1;
 };
 
@@ -520,7 +650,7 @@ var build = async ({
   const targetOptions = target === void 0 ? [] : ["-t", target];
   const jobsOptions = jobs === void 0 ? [] : ["-j", `${jobs}`];
   if (jobs !== void 0) {
-    console.log(chalk9.blue(`Jobs set to [${jobs}]`));
+    console.log(chalk10.blue(`Jobs set to [${jobs}]`));
   }
   const result = await runStepsAsync(`Build${incremental ? "-Incremental" : ""} [${pkg ?? "All"}]`, [
     ["yarn", ["xy", "compile", ...pkgOptions, ...targetOptions, ...verboseOptions, ...jobsOptions, ...incrementalOptions, "--types", "tsup"]],
@@ -528,7 +658,7 @@ var build = async ({
     ["yarn", ["xy", "deplint", ...pkgOptions, ...verboseOptions, ...jobsOptions, ...incrementalOptions]],
     ["yarn", ["xy", "lint", ...pkgOptions, ...verboseOptions, ...incrementalOptions]]
   ]);
-  console.log(`${chalk9.gray("Built in")} [${chalk9.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk9.gray("seconds")}`);
+  console.log(`${chalk10.gray("Built in")} [${chalk10.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk10.gray("seconds")}`);
   return result;
 };
 
@@ -541,15 +671,15 @@ import {
   unlinkSync,
   writeFileSync as writeFileSync2
 } from "fs";
-import PATH2 from "path";
-import chalk10 from "chalk";
+import PATH3 from "path";
+import chalk11 from "chalk";
 var syncCommandFiles = (commandsDir) => {
   const templates = claudeCommandTemplates();
   const templateNames = new Set(Object.keys(templates));
   let updated = 0;
   let created = 0;
   for (const [filename3, content] of Object.entries(templates)) {
-    const targetPath = PATH2.resolve(commandsDir, filename3);
+    const targetPath = PATH3.resolve(commandsDir, filename3);
     const existing = existsSync5(targetPath) ? readFileSync6(targetPath, "utf8") : void 0;
     if (existing === content) continue;
     writeFileSync2(targetPath, content, "utf8");
@@ -570,7 +700,7 @@ var removeStaleCommands = (commandsDir, templateNames) => {
   let removed = 0;
   for (const file of existingCommands) {
     if (!templateNames.has(file)) {
-      unlinkSync(PATH2.resolve(commandsDir, file));
+      unlinkSync(PATH3.resolve(commandsDir, file));
       removed++;
     }
   }
@@ -583,14 +713,14 @@ var logCommandsResult = (created, updated, removed) => {
       updated ? `${updated} updated` : "",
       removed ? `${removed} removed` : ""
     ].filter(Boolean);
-    console.log(chalk10.green(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: ${parts.join(", ")}`));
+    console.log(chalk11.green(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: ${parts.join(", ")}`));
   } else {
-    console.log(chalk10.gray(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: already up to date`));
+    console.log(chalk11.gray(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: already up to date`));
   }
 };
 var claudeCommands = () => {
   const cwd5 = INIT_CWD() ?? process.cwd();
-  const commandsDir = PATH2.resolve(cwd5, ".claude", "commands");
+  const commandsDir = PATH3.resolve(cwd5, ".claude", "commands");
   mkdirSync(commandsDir, { recursive: true });
   const {
     created,
@@ -611,15 +741,15 @@ import {
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync3
 } from "fs";
-import PATH3 from "path";
-import chalk11 from "chalk";
+import PATH4 from "path";
+import chalk12 from "chalk";
 var syncRuleFiles = (rulesDir) => {
   const templates = claudeMdRuleTemplates();
   const templateNames = new Set(Object.keys(templates));
   let updated = 0;
   let created = 0;
   for (const [filename3, content] of Object.entries(templates)) {
-    const targetPath = PATH3.resolve(rulesDir, filename3);
+    const targetPath = PATH4.resolve(rulesDir, filename3);
     const existing = existsSync6(targetPath) ? readFileSync7(targetPath, "utf8") : void 0;
     if (existing === content) continue;
     writeFileSync3(targetPath, content, "utf8");
@@ -640,7 +770,7 @@ var removeStaleRules = (rulesDir, templateNames) => {
   let removed = 0;
   for (const file of existingRules) {
     if (!templateNames.has(file)) {
-      unlinkSync2(PATH3.resolve(rulesDir, file));
+      unlinkSync2(PATH4.resolve(rulesDir, file));
       removed++;
     }
   }
@@ -653,26 +783,26 @@ var logRulesResult = (created, updated, removed) => {
       updated ? `${updated} updated` : "",
       removed ? `${removed} removed` : ""
     ].filter(Boolean);
-    console.log(chalk11.green(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: ${parts.join(", ")}`));
+    console.log(chalk12.green(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: ${parts.join(", ")}`));
   } else {
-    console.log(chalk11.gray(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: already up to date`));
+    console.log(chalk12.gray(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: already up to date`));
   }
 };
 var ensureProjectClaudeMd = (cwd5, force) => {
-  const projectPath = PATH3.resolve(cwd5, "CLAUDE.md");
+  const projectPath = PATH4.resolve(cwd5, "CLAUDE.md");
   if (!existsSync6(projectPath) || force) {
     if (force && existsSync6(projectPath)) {
-      console.log(chalk11.yellow("Overwriting existing CLAUDE.md"));
+      console.log(chalk12.yellow("Overwriting existing CLAUDE.md"));
     }
     writeFileSync3(projectPath, claudeMdProjectTemplate(), "utf8");
-    console.log(chalk11.green("Generated CLAUDE.md"));
+    console.log(chalk12.green("Generated CLAUDE.md"));
   } else {
-    console.log(chalk11.gray("CLAUDE.md already exists (skipped)"));
+    console.log(chalk12.gray("CLAUDE.md already exists (skipped)"));
   }
 };
 var claudeRules = ({ force } = {}) => {
   const cwd5 = INIT_CWD() ?? process.cwd();
-  const rulesDir = PATH3.resolve(cwd5, ".claude", "rules");
+  const rulesDir = PATH4.resolve(cwd5, ".claude", "rules");
   mkdirSync2(rulesDir, { recursive: true });
   const {
     created,
@@ -699,16 +829,16 @@ var cleanAll = ({ verbose }) => {
 
 // src/actions/clean-docs.ts
 import path from "path";
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 var cleanDocs = () => {
   const pkgName = process.env.npm_package_name;
-  console.log(chalk12.green(`Cleaning Docs [${pkgName}]`));
+  console.log(chalk13.green(`Cleaning Docs [${pkgName}]`));
   for (const { location } of yarnWorkspaces()) deleteGlob(path.join(location, "docs"));
   return 0;
 };
 
 // src/actions/compile.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 var compile = ({
   verbose,
   target,
@@ -749,7 +879,7 @@ var compileAll = ({
   const incrementalOptions = incremental ? ["--since", "-Ap", "--topological-dev"] : ["--parallel", "-Ap", "--topological-dev"];
   const jobsOptions = jobs ? ["-j", `${jobs}`] : [];
   if (jobs) {
-    console.log(chalk13.blue(`Jobs set to [${jobs}]`));
+    console.log(chalk14.blue(`Jobs set to [${jobs}]`));
   }
   const result = runSteps(`Compile${incremental ? "-Incremental" : ""} [All]`, [
     ["yarn", [
@@ -763,13 +893,13 @@ var compileAll = ({
       ...targetOptions
     ]]
   ]);
-  console.log(`${chalk13.gray("Compiled in")} [${chalk13.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk13.gray("seconds")}`);
+  console.log(`${chalk14.gray("Compiled in")} [${chalk14.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk14.gray("seconds")}`);
   return result;
 };
 
 // src/actions/copy-assets.ts
 import path2 from "path/posix";
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 import cpy from "cpy";
 var copyPackageTargetAssets = async (target, name, location) => {
   try {
@@ -792,7 +922,7 @@ var copyPackageTargetAssets = async (target, name, location) => {
 };
 var copyTargetAssets = async (target, pkg) => {
   const workspaces = yarnWorkspaces();
-  console.log(chalk14.green(`Copying Assets [${target.toUpperCase()}]`));
+  console.log(chalk15.green(`Copying Assets [${target.toUpperCase()}]`));
   const workspaceList = workspaces.filter(({ name }) => {
     return pkg === void 0 || name === pkg;
   });
@@ -876,7 +1006,7 @@ var dead = () => {
 };
 
 // src/actions/deplint/deplint.ts
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 
 // src/actions/deplint/findFiles.ts
 import fs2 from "fs";
@@ -1052,11 +1182,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);
@@ -1078,12 +1208,12 @@ function getExternalImportsFromFiles({
 
 // src/actions/deplint/checkPackage/getUnlistedDependencies.ts
 import { builtinModules } from "module";
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 function isListedOrBuiltin(imp, name, dependencies, peerDependencies) {
   return dependencies.includes(imp) || imp === name || dependencies.includes(`@types/${imp}`) || peerDependencies.includes(imp) || peerDependencies.includes(`@types/${imp}`) || builtinModules.includes(imp) || builtinModules.includes(`@types/${imp}`);
 }
 function logMissing(name, imp, importPaths) {
-  console.log(`[${chalk15.blue(name)}] Missing dependency in package.json: ${chalk15.red(imp)}`);
+  console.log(`[${chalk16.blue(name)}] Missing dependency in package.json: ${chalk16.red(imp)}`);
   if (importPaths[imp]) {
     console.log(`  ${importPaths[imp].join("\n ")}`);
   }
@@ -1108,7 +1238,7 @@ function getUnlistedDependencies({ name, location }, { dependencies, peerDepende
   }
   if (unlistedDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk15.yellow(packageLocation)}
+    console.log(`  ${chalk16.yellow(packageLocation)}
 `);
   }
   return unlistedDependencies;
@@ -1116,7 +1246,7 @@ function getUnlistedDependencies({ name, location }, { dependencies, peerDepende
 
 // src/actions/deplint/checkPackage/getUnlistedDevDependencies.ts
 import { builtinModules as builtinModules2 } from "module";
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 function getUnlistedDevDependencies({ name, location }, {
   devDependencies,
   dependencies,
@@ -1130,7 +1260,7 @@ function getUnlistedDevDependencies({ name, location }, {
   for (const imp of externalAllImports) {
     if (!distImports.includes(imp) && imp !== name && !dependencies.includes(imp) && !dependencies.includes(`@types/${imp}`) && !peerDependencies.includes(imp) && !peerDependencies.includes(`@types/${imp}`) && !devDependencies.includes(imp) && !devDependencies.includes(`@types/${imp}`) && !builtinModules2.includes(imp)) {
       unlistedDevDependencies++;
-      console.log(`[${chalk16.blue(name)}] Missing devDependency in package.json: ${chalk16.red(imp)}`);
+      console.log(`[${chalk17.blue(name)}] Missing devDependency in package.json: ${chalk17.red(imp)}`);
       if (allImportPaths[imp]) {
         console.log(`  ${allImportPaths[imp].join("\n ")}`);
       }
@@ -1138,40 +1268,50 @@ function getUnlistedDevDependencies({ name, location }, {
   }
   if (unlistedDevDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk16.yellow(packageLocation)}
+    console.log(`  ${chalk17.yellow(packageLocation)}
 `);
   }
   return unlistedDevDependencies;
 }
 
 // src/actions/deplint/checkPackage/getUnusedDependencies.ts
-import chalk17 from "chalk";
+import chalk18 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(`[${chalk17.blue(name)}] dependency should be devDependency in package.json: ${chalk17.red(dep)}`);
+        console.log(`[${chalk18.blue(name)}] dependency should be devDependency in package.json: ${chalk18.red(dep)}`);
       } else {
-        console.log(`[${chalk17.blue(name)}] Unused dependency in package.json: ${chalk17.red(dep)}`);
+        console.log(`[${chalk18.blue(name)}] Unused dependency in package.json: ${chalk18.red(dep)}`);
       }
     }
   }
   if (unusedDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk17.yellow(packageLocation)}
+    console.log(`  ${chalk18.yellow(packageLocation)}
 `);
   }
   return unusedDependencies;
 }
 
 // src/actions/deplint/checkPackage/getUnusedDevDependencies.ts
-import chalk18 from "chalk";
+import chalk19 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";
@@ -1206,8 +1346,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 +1395,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 +1502,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 +1554,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 +1569,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,39 +1579,42 @@ function getUnusedDevDependencies({ name, location }, {
   });
   const requiredPeers = getRequiredPeerDependencies(location, allDeps);
   const scriptRefs = getScriptReferencedPackages(location, allDeps);
+  const cliRefs = getCliReferencedPackagesFromFiles(fileContext.allFiles, location, allDeps);
   let unusedDevDependencies = 0;
   for (const dep of devDependencies) {
+    if (exclude?.has(dep)) continue;
     if (dependencies.includes(dep) || peerDependencies.includes(dep)) continue;
-    if (!isDevDepUsed(dep, allImports, implicitDeps, requiredPeers, scriptRefs)) {
+    if (!isDevDepUsed(dep, allImports, implicitDeps, requiredPeers, scriptRefs, cliRefs)) {
       unusedDevDependencies++;
-      console.log(`[${chalk18.blue(name)}] Unused devDependency in package.json: ${chalk18.red(dep)}`);
+      console.log(`[${chalk19.blue(name)}] Unused devDependency in package.json: ${chalk19.red(dep)}`);
     }
   }
   if (unusedDevDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk18.yellow(packageLocation)}
+    console.log(`  ${chalk19.yellow(packageLocation)}
 `);
   }
   return unusedDevDependencies;
 }
 
 // src/actions/deplint/checkPackage/getUnusedPeerDependencies.ts
-import chalk19 from "chalk";
-function getUnusedPeerDependencies({ name, location }, { peerDependencies, dependencies }, { externalDistImports, externalDistTypeImports }) {
+import chalk20 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(`[${chalk19.blue(name)}] Unused peerDependency [already a dependency] in package.json: ${chalk19.red(dep)}`);
+        console.log(`[${chalk20.blue(name)}] Unused peerDependency [already a dependency] in package.json: ${chalk20.red(dep)}`);
       } else {
-        console.log(`[${chalk19.blue(name)}] Unused peerDependency in package.json: ${chalk19.red(dep)}`);
+        console.log(`[${chalk20.blue(name)}] Unused peerDependency in package.json: ${chalk20.red(dep)}`);
       }
     }
   }
   if (unusedDependencies > 0) {
     const packageLocation = `${location}/package.json`;
-    console.log(`  ${chalk19.yellow(packageLocation)}
+    console.log(`  ${chalk20.yellow(packageLocation)}
 `);
   }
   return unusedDependencies;
@@ -1411,6 +1639,7 @@ function checkPackage({
   location,
   deps = false,
   devDeps = false,
+  exclude,
   peerDeps = false,
   verbose = false
 }) {
@@ -1429,23 +1658,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 +1690,7 @@ var deplint = ({
         ...workspace,
         deps,
         devDeps,
+        exclude,
         peerDeps,
         verbose
       });
@@ -1467,14 +1703,15 @@ var deplint = ({
       location,
       devDeps,
       deps,
+      exclude,
       peerDeps,
       verbose
     });
   }
   if (totalErrors > 0) {
-    console.warn(`Deplint: Found ${chalk20.red(totalErrors)} dependency problems. ${chalk20.red("\u2716")}`);
+    console.warn(`Deplint: Found ${chalk21.red(totalErrors)} dependency problems. ${chalk21.red("\u2716")}`);
   } else {
-    console.info(`Deplint: Found no dependency problems. ${chalk20.green("\u2714")}`);
+    console.info(`Deplint: Found no dependency problems. ${chalk21.green("\u2714")}`);
   }
   return 0;
 };
@@ -1576,22 +1813,22 @@ var deployNext = () => {
 };
 
 // src/actions/dupdeps.ts
-import chalk21 from "chalk";
+import chalk22 from "chalk";
 var dupdeps = () => {
-  console.log(chalk21.green("Checking all Dependencies for Duplicates"));
+  console.log(chalk22.green("Checking all Dependencies for Duplicates"));
   const allDependencies = parsedPackageJSON()?.dependencies;
   const dependencies = Object.entries(allDependencies).map(([k]) => k);
   return detectDuplicateDependencies(dependencies);
 };
 
 // src/actions/lint.ts
-import chalk22 from "chalk";
+import chalk23 from "chalk";
 var lintPackage = ({
   pkg,
   fix: fix2,
   verbose
 }) => {
-  console.log(chalk22.gray(`${fix2 ? "Fix" : "Lint"} [${pkg}]`));
+  console.log(chalk23.gray(`${fix2 ? "Fix" : "Lint"} [${pkg}]`));
   const start = Date.now();
   const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [${pkg}]`, [
     ["yarn", [
@@ -1601,7 +1838,7 @@ var lintPackage = ({
       fix2 ? "package-fix" : verbose ? "package-lint-verbose" : "package-lint"
     ]]
   ]);
-  console.log(chalk22.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk22.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk22.gray("seconds")}`));
+  console.log(chalk23.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk23.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk23.gray("seconds")}`));
   return result;
 };
 var lint = ({
@@ -1621,13 +1858,13 @@ var lint = ({
   });
 };
 var lintAllPackages = ({ fix: fix2 = false } = {}) => {
-  console.log(chalk22.gray(`${fix2 ? "Fix" : "Lint"} [All-Packages]`));
+  console.log(chalk23.gray(`${fix2 ? "Fix" : "Lint"} [All-Packages]`));
   const start = Date.now();
   const fixOptions = fix2 ? ["--fix"] : [];
   const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [All-Packages]`, [
     ["yarn", ["eslint", "--cache", "--cache-location", ".eslintcache", "--cache-strategy", "content", ...fixOptions]]
   ]);
-  console.log(chalk22.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk22.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk22.gray("seconds")}`));
+  console.log(chalk23.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk23.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk23.gray("seconds")}`));
   return result;
 };
 
@@ -1655,7 +1892,7 @@ var filename = ".gitignore";
 var gitignoreGen = (pkg) => generateIgnoreFiles(filename, pkg);
 
 // src/actions/gitlint.ts
-import chalk23 from "chalk";
+import chalk24 from "chalk";
 import ParseGitConfig from "parse-git-config";
 var gitlint = () => {
   console.log(`
@@ -1666,7 +1903,7 @@ Gitlint Start [${process.cwd()}]
   const errors = 0;
   const gitConfig = ParseGitConfig.sync();
   const warn = (message) => {
-    console.warn(chalk23.yellow(`Warning: ${message}`));
+    console.warn(chalk24.yellow(`Warning: ${message}`));
     warnings++;
   };
   if (gitConfig.core.ignorecase) {
@@ -1686,13 +1923,13 @@ Gitlint Start [${process.cwd()}]
   }
   const resultMessages = [];
   if (valid > 0) {
-    resultMessages.push(chalk23.green(`Passed: ${valid}`));
+    resultMessages.push(chalk24.green(`Passed: ${valid}`));
   }
   if (warnings > 0) {
-    resultMessages.push(chalk23.yellow(`Warnings: ${warnings}`));
+    resultMessages.push(chalk24.yellow(`Warnings: ${warnings}`));
   }
   if (errors > 0) {
-    resultMessages.push(chalk23.red(` Errors: ${errors}`));
+    resultMessages.push(chalk24.red(` Errors: ${errors}`));
   }
   console.warn(`Gitlint Finish [ ${resultMessages.join(" | ")} ]
 `);
@@ -1700,8 +1937,8 @@ Gitlint Start [${process.cwd()}]
 };
 
 // src/actions/gitlint-fix.ts
-import { execSync as execSync2 } from "child_process";
-import chalk24 from "chalk";
+import { execSync as execSync3 } from "child_process";
+import chalk25 from "chalk";
 import ParseGitConfig2 from "parse-git-config";
 var gitlintFix = () => {
   console.log(`
@@ -1709,16 +1946,16 @@ Gitlint Fix Start [${process.cwd()}]
 `);
   const gitConfig = ParseGitConfig2.sync();
   if (gitConfig.core.ignorecase) {
-    execSync2("git config core.ignorecase false", { stdio: "inherit" });
-    console.warn(chalk24.yellow("\nGitlint Fix: Updated core.ignorecase to be false\n"));
+    execSync3("git config core.ignorecase false", { stdio: "inherit" });
+    console.warn(chalk25.yellow("\nGitlint Fix: Updated core.ignorecase to be false\n"));
   }
   if (gitConfig.core.autocrlf !== false) {
-    execSync2("git config core.autocrlf false", { stdio: "inherit" });
-    console.warn(chalk24.yellow("\nGitlint Fix: Updated core.autocrlf to be false\n"));
+    execSync3("git config core.autocrlf false", { stdio: "inherit" });
+    console.warn(chalk25.yellow("\nGitlint Fix: Updated core.autocrlf to be false\n"));
   }
   if (gitConfig.core.eol !== "lf") {
-    execSync2("git config core.eol lf", { stdio: "inherit" });
-    console.warn(chalk24.yellow('\nGitlint Fix: Updated core.eol to be "lf"\n'));
+    execSync3("git config core.eol lf", { stdio: "inherit" });
+    console.warn(chalk25.yellow('\nGitlint Fix: Updated core.eol to be "lf"\n'));
   }
   return 1;
 };
@@ -1729,7 +1966,7 @@ var knip = () => {
 };
 
 // src/actions/license.ts
-import chalk25 from "chalk";
+import chalk26 from "chalk";
 import { init } from "license-checker";
 var license = async (pkg) => {
   const workspaces = yarnWorkspaces();
@@ -1754,18 +1991,18 @@ var license = async (pkg) => {
     "LGPL-3.0-or-later",
     "Python-2.0"
   ]);
-  console.log(chalk25.green("License Checker"));
+  console.log(chalk26.green("License Checker"));
   return (await Promise.all(
     workspaceList.map(({ location, name }) => {
       return new Promise((resolve) => {
         init({ production: true, start: location }, (error, packages) => {
           if (error) {
-            console.error(chalk25.red(`License Checker [${name}] Error`));
-            console.error(chalk25.gray(error));
+            console.error(chalk26.red(`License Checker [${name}] Error`));
+            console.error(chalk26.gray(error));
             console.log("\n");
             resolve(1);
           } else {
-            console.log(chalk25.green(`License Checker [${name}]`));
+            console.log(chalk26.green(`License Checker [${name}]`));
             let count = 0;
             for (const [name2, info] of Object.entries(packages)) {
               const licenses = Array.isArray(info.licenses) ? info.licenses : [info.licenses];
@@ -1781,7 +2018,7 @@ var license = async (pkg) => {
                   }
                   if (!orLicenseFound) {
                     count++;
-                    console.warn(chalk25.yellow(`${name2}: Package License not allowed [${license2}]`));
+                    console.warn(chalk26.yellow(`${name2}: Package License not allowed [${license2}]`));
                   }
                 }
               }
@@ -1800,13 +2037,13 @@ var filename2 = ".npmignore";
 var npmignoreGen = (pkg) => generateIgnoreFiles(filename2, pkg);
 
 // src/actions/package/clean-outputs.ts
-import path7 from "path";
-import chalk26 from "chalk";
+import path8 from "path";
+import chalk27 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")];
-  console.log(chalk26.green(`Cleaning Outputs [${pkgName}]`));
+  const folders = [path8.join(pkg, "dist"), path8.join(pkg, "build"), path8.join(pkg, "docs")];
+  console.log(chalk27.green(`Cleaning Outputs [${pkgName}]`));
   for (let folder of folders) {
     deleteGlob(folder);
   }
@@ -1814,13 +2051,13 @@ var packageCleanOutputs = () => {
 };
 
 // src/actions/package/clean-typescript.ts
-import path8 from "path";
-import chalk27 from "chalk";
+import path9 from "path";
+import chalk28 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")];
+  console.log(chalk28.green(`Cleaning Typescript [${pkgName}]`));
+  const files = [path9.join(pkg, "*.tsbuildinfo"), path9.join(pkg, ".tsconfig.*"), path9.join(pkg, ".eslintcache")];
   for (let file of files) {
     deleteGlob(file);
   }
@@ -1833,26 +2070,26 @@ var packageClean = async () => {
 };
 
 // src/actions/package/compile/compile.ts
-import chalk32 from "chalk";
+import chalk33 from "chalk";
 
 // src/actions/package/compile/packageCompileTsup.ts
-import chalk31 from "chalk";
+import chalk32 from "chalk";
 import { build as build2, defineConfig } from "tsup";
 
 // src/actions/package/compile/inputs.ts
-import chalk28 from "chalk";
+import chalk29 from "chalk";
 import { glob as glob2 } from "glob";
 var getAllInputs = (srcDir, verbose = false) => {
   return [...glob2.sync(`${srcDir}/**/*.ts`, { posix: true }).map((file) => {
     const result = file.slice(Math.max(0, srcDir.length + 1));
     if (verbose) {
-      console.log(chalk28.gray(`getAllInputs: ${JSON.stringify(result, null, 2)}`));
+      console.log(chalk29.gray(`getAllInputs: ${JSON.stringify(result, null, 2)}`));
     }
     return result;
   }), ...glob2.sync(`${srcDir}/**/*.tsx`, { posix: true }).map((file) => {
     const result = file.slice(Math.max(0, srcDir.length + 1));
     if (verbose) {
-      console.log(chalk28.gray(`getAllInputs: ${JSON.stringify(result, null, 2)}`));
+      console.log(chalk29.gray(`getAllInputs: ${JSON.stringify(result, null, 2)}`));
     }
     return result;
   })];
@@ -1911,9 +2148,9 @@ function deepMergeObjects(objects) {
 
 // src/actions/package/compile/packageCompileTsc.ts
 import { cwd as cwd2 } from "process";
-import chalk29 from "chalk";
+import chalk30 from "chalk";
 import { createProgramFromConfig } from "tsc-prog";
-import ts2, {
+import ts3, {
   DiagnosticCategory,
   formatDiagnosticsWithColorAndContext,
   getPreEmitDiagnostics,
@@ -1933,12 +2170,12 @@ var getCompilerOptions = (options = {}, fileName = "tsconfig.json") => {
 var packageCompileTsc = (platform, entries, srcDir = "src", outDir = "dist", compilerOptionsParam, verbose = false) => {
   const pkg = process.env.INIT_CWD ?? cwd2();
   if (verbose) {
-    console.log(chalk29.cyan(`Validating code START: ${entries.length} files to ${outDir} from ${srcDir}`));
+    console.log(chalk30.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) {
@@ -1956,10 +2193,10 @@ var packageCompileTsc = (platform, entries, srcDir = "src", outDir = "dist", com
     emitDeclarationOnly: true,
     noEmit: false
   };
-  console.log(chalk29.cyan(`Validating Files: ${entries.length}`));
+  console.log(chalk30.cyan(`Validating Files: ${entries.length}`));
   if (verbose) {
     for (const entry of entries) {
-      console.log(chalk29.grey(`Validating: ${entry}`));
+      console.log(chalk30.grey(`Validating: ${entry}`));
     }
   }
   try {
@@ -1988,29 +2225,29 @@ 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);
     }
     return 0;
   } finally {
     if (verbose) {
-      console.log(chalk29.cyan(`Validating code FINISH: ${entries.length} files to ${outDir} from ${srcDir}`));
+      console.log(chalk30.cyan(`Validating code FINISH: ${entries.length} files to ${outDir} from ${srcDir}`));
     }
   }
 };
 
 // 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 chalk31 from "chalk";
 import { rollup } from "rollup";
 import dts from "rollup-plugin-dts";
 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({
@@ -2028,8 +2265,8 @@ async function bundleDts(inputPath, outputPath, platform, options, verbose = fal
         if (ignoredWarningCodes.has(warning.code ?? "")) {
           return;
         }
-        console.warn(chalk30.yellow(`[${warning.code}] ${warning.message}`));
-        console.warn(chalk30.gray(inputPath));
+        console.warn(chalk31.yellow(`[${warning.code}] ${warning.message}`));
+        console.warn(chalk31.gray(inputPath));
         warn(warning);
       }
     });
@@ -2039,8 +2276,8 @@ async function bundleDts(inputPath, outputPath, platform, options, verbose = fal
     });
   } catch (ex) {
     const error = ex;
-    console.warn(chalk30.red(error));
-    console.warn(chalk30.gray(inputPath));
+    console.warn(chalk31.red(error));
+    console.warn(chalk31.gray(inputPath));
   }
   if (verbose) {
     console.log(`Bundled declarations written to ${outputPath}`);
@@ -2048,7 +2285,7 @@ async function bundleDts(inputPath, outputPath, platform, options, verbose = fal
 }
 var packageCompileTscTypes = async (entries, outDir, platform, srcDir = "build", verbose = false) => {
   if (verbose) {
-    console.log(chalk30.cyan(`Compiling Types START [${platform}]: ${entries.length} files to ${outDir} from ${srcDir}`));
+    console.log(chalk31.cyan(`Compiling Types START [${platform}]: ${entries.length} files to ${outDir} from ${srcDir}`));
     console.log(`Entries: ${entries.join(", ")}`);
   }
   const pkg = process.env.INIT_CWD ?? cwd3();
@@ -2072,7 +2309,7 @@ var packageCompileTscTypes = async (entries, outDir, platform, srcDir = "build",
     await bundleDts(`${srcRoot}/${entryTypeName}`, `${outDir}/${entryTypeName}`, platform, { compilerOptions }, verbose);
   }));
   if (verbose) {
-    console.log(chalk30.cyan(`Compiling Types FINISH: ${entries.length} files to ${outDir} from ${srcDir}`));
+    console.log(chalk31.cyan(`Compiling Types FINISH: ${entries.length} files to ${outDir} from ${srcDir}`));
   }
   return 0;
 };
@@ -2084,15 +2321,15 @@ var compileFolder = async (srcDir, entries, buildDir, options, bundleTypes = fal
     console.log(`compileFolder [${srcDir}, ${options?.outDir}]`);
   }
   if (entries.length === 0) {
-    console.warn(chalk31.yellow(`No entries found in ${srcDir} to compile`));
+    console.warn(chalk32.yellow(`No entries found in ${srcDir} to compile`));
     return 0;
   }
   if (verbose) {
-    console.log(chalk31.gray(`buildDir [${buildDir}]`));
+    console.log(chalk32.gray(`buildDir [${buildDir}]`));
   }
   const validationResult = packageCompileTsc(options?.platform ?? "neutral", entries, srcDir, buildDir, void 0, verbose);
   if (validationResult !== 0) {
-    console.error(chalk31.red(`Compile:Validation had ${validationResult} errors`));
+    console.error(chalk32.red(`Compile:Validation had ${validationResult} errors`));
     return validationResult;
   }
   const optionsParams = tsupOptions([{
@@ -2117,12 +2354,12 @@ var compileFolder = async (srcDir, entries, buildDir, options, bundleTypes = fal
     })
   )).flat();
   if (verbose) {
-    console.log(chalk31.cyan(`TSUP:build:start [${srcDir}]`));
-    console.log(chalk31.gray(`TSUP:build:options [${JSON.stringify(optionsList, null, 2)}]`));
+    console.log(chalk32.cyan(`TSUP:build:start [${srcDir}]`));
+    console.log(chalk32.gray(`TSUP:build:options [${JSON.stringify(optionsList, null, 2)}]`));
   }
   await Promise.all(optionsList.map((options2) => build2(options2)));
   if (verbose) {
-    console.log(chalk31.cyan(`TSUP:build:stop [${srcDir}]`));
+    console.log(chalk32.cyan(`TSUP:build:stop [${srcDir}]`));
   }
   if (bundleTypes) {
     await packageCompileTscTypes(entries, outDir, options?.platform ?? "neutral", buildDir, verbose);
@@ -2233,14 +2470,14 @@ var packageCompileTsup = async (config2) => {
 // src/actions/package/compile/compile.ts
 var packageCompile = async (inConfig = {}) => {
   const pkg = process.env.INIT_CWD;
-  console.log(chalk32.green(`Compiling ${pkg}`));
+  console.log(chalk33.green(`Compiling ${pkg}`));
   const config2 = await loadConfig(inConfig);
   return await packageCompileTsup(config2);
 };
 
 // src/actions/package/copy-assets.ts
-import path10 from "path/posix";
-import chalk33 from "chalk";
+import path11 from "path/posix";
+import chalk34 from "chalk";
 import cpy2 from "cpy";
 var copyTargetAssets2 = async (target, name, location) => {
   try {
@@ -2248,12 +2485,12 @@ 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
       }
     );
     if (values.length > 0) {
-      console.log(chalk33.green(`Copying Assets [${target.toUpperCase()}] - ${name} - ${location}`));
+      console.log(chalk34.green(`Copying Assets [${target.toUpperCase()}] - ${name} - ${location}`));
     }
     for (const value of values) {
       console.log(`${value.split("/").pop()} => ./dist/${target}`);
@@ -2319,8 +2556,8 @@ var packageCycle = async () => {
 
 // src/actions/package/gen-docs.ts
 import { existsSync as existsSync7 } from "fs";
-import path11 from "path";
-import chalk34 from "chalk";
+import path12 from "path";
+import chalk35 from "chalk";
 import {
   Application,
   ArgumentsReader,
@@ -2338,7 +2575,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({
@@ -2424,16 +2661,16 @@ var runTypeDoc = async (app) => {
       return ExitCodes.OutputError;
     }
   }
-  console.log(chalk34.green(`${pkgName} - Ok`));
+  console.log(chalk35.green(`${pkgName} - Ok`));
   return ExitCodes.Ok;
 };
 
 // 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";
+import chalk36 from "chalk";
 import { ESLint } from "eslint";
 import { findUp } from "find-up";
 import picomatch from "picomatch";
@@ -2442,14 +2679,14 @@ var dumpMessages = (lintResults) => {
   const severity = ["none", "warning", "error"];
   for (const lintResult of lintResults) {
     if (lintResult.messages.length > 0) {
-      console.log(chalk35.gray(`
+      console.log(chalk36.gray(`
 ${lintResult.filePath}`));
       for (const message of lintResult.messages) {
         console.log(
-          chalk35.gray(`	${message.line}:${message.column}`),
-          chalk35[colors[message.severity]](`	${severity[message.severity]}`),
-          chalk35.white(`	${message.message}`),
-          chalk35.gray(`	${message.ruleId}`)
+          chalk36.gray(`	${message.line}:${message.column}`),
+          chalk36[colors[message.severity]](`	${severity[message.severity]}`),
+          chalk36.white(`	${message.message}`),
+          chalk36.gray(`	${message.ruleId}`)
         );
       }
     }
@@ -2467,7 +2704,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 [];
@@ -2487,10 +2724,10 @@ var packageLint = async (fix2 = false, verbose = false, cache = true) => {
     cache
   });
   const files = getFiles(cwd4(), ignoreFolders);
-  console.log(chalk35.green(`Linting ${pkg} [files = ${files.length}]`));
+  console.log(chalk36.green(`Linting ${pkg} [files = ${files.length}]`));
   if (verbose) {
     for (const file of files) {
-      console.log(chalk35.gray(`	${file}`));
+      console.log(chalk36.gray(`	${file}`));
     }
   }
   const lintResults = await engine.lintFiles(files);
@@ -2501,43 +2738,43 @@ var packageLint = async (fix2 = false, verbose = false, cache = true) => {
   const filesCountColor = files.length < 100 ? "green" : files.length < 1e3 ? "yellow" : "red";
   const lintTime = Date.now() - start;
   const lintTimeColor = lintTime < 1e3 ? "green" : lintTime < 3e3 ? "yellow" : "red";
-  console.log(chalk35.white(`Linted ${chalk35[filesCountColor](files.length)} files in ${chalk35[lintTimeColor](lintTime)}ms`));
+  console.log(chalk36.white(`Linted ${chalk36[filesCountColor](files.length)} files in ${chalk36[lintTimeColor](lintTime)}ms`));
   return lintResults.reduce((prev, lintResult) => prev + lintResult.errorCount, 0);
 };
 
 // src/actions/package/publint.ts
-import { promises as fs9 } from "fs";
-import chalk36 from "chalk";
+import { promises as fs10 } from "fs";
+import chalk37 from "chalk";
 import sortPackageJson from "sort-package-json";
 var customPubLint = (pkg) => {
   let errorCount = 0;
   let warningCount = 0;
   if (pkg.files === void 0) {
-    console.warn(chalk36.yellow('Publint [custom]: "files" field is missing'));
+    console.warn(chalk37.yellow('Publint [custom]: "files" field is missing'));
     warningCount++;
   }
   if (pkg.main !== void 0) {
-    console.warn(chalk36.yellow('Publint [custom]: "main" field is deprecated, use "exports" instead'));
+    console.warn(chalk37.yellow('Publint [custom]: "main" field is deprecated, use "exports" instead'));
     warningCount++;
   }
   if (pkg.sideEffects !== false) {
-    console.warn(chalk36.yellow('Publint [custom]: "sideEffects" field should be set to false'));
+    console.warn(chalk37.yellow('Publint [custom]: "sideEffects" field should be set to false'));
     warningCount++;
   }
   if (pkg.resolutions !== void 0) {
-    console.warn(chalk36.yellow('Publint [custom]: "resolutions" in use'));
-    console.warn(chalk36.gray(JSON.stringify(pkg.resolutions, null, 2)));
+    console.warn(chalk37.yellow('Publint [custom]: "resolutions" in use'));
+    console.warn(chalk37.gray(JSON.stringify(pkg.resolutions, null, 2)));
     warningCount++;
   }
   return [errorCount, warningCount];
 };
 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"));
-  console.log(chalk36.green(`Publint: ${pkg.name}`));
-  console.log(chalk36.gray(pkgDir));
+  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(chalk37.green(`Publint: ${pkg.name}`));
+  console.log(chalk37.gray(pkgDir));
   const { publint: publint2 } = await import("publint");
   const { messages } = await publint2({
     level: "suggestion",
@@ -2548,22 +2785,22 @@ var packagePublint = async ({ strict = true, verbose = false } = {}) => {
   for (const message of messages) {
     switch (message.type) {
       case "error": {
-        console.error(chalk36.red(`[${message.code}] ${formatMessage(message, pkg)}`));
+        console.error(chalk37.red(`[${message.code}] ${formatMessage(message, pkg)}`));
         break;
       }
       case "warning": {
-        console.warn(chalk36.yellow(`[${message.code}] ${formatMessage(message, pkg)}`));
+        console.warn(chalk37.yellow(`[${message.code}] ${formatMessage(message, pkg)}`));
         break;
       }
       default: {
-        console.log(chalk36.white(`[${message.code}] ${formatMessage(message, pkg)}`));
+        console.log(chalk37.white(`[${message.code}] ${formatMessage(message, pkg)}`));
         break;
       }
     }
   }
   const [errorCount, warningCount] = customPubLint(pkg);
   if (verbose) {
-    console.log(chalk36.gray(`Publint [Finish]: ${pkgDir} [${messages.length + errorCount + warningCount} messages]`));
+    console.log(chalk37.gray(`Publint [Finish]: ${pkgDir} [${messages.length + errorCount + warningCount} messages]`));
   }
   return messages.filter((message) => message.type === "error").length + errorCount;
 };
@@ -2590,6 +2827,21 @@ var publish = () => {
   return runSteps("Publish", [["npm", ["publish", "--workspaces"]]]);
 };
 
+// src/actions/readme-gen.ts
+async function readmeGen({
+  pkg,
+  templatePath,
+  typedoc,
+  verbose
+}) {
+  return await generateReadmeFiles({
+    pkg,
+    templatePath,
+    typedoc,
+    verbose
+  });
+}
+
 // src/actions/rebuild.ts
 var rebuild = ({ target }) => {
   return runSteps("Rebuild", [
@@ -2599,7 +2851,7 @@ var rebuild = ({ target }) => {
 };
 
 // src/actions/recompile.ts
-import chalk37 from "chalk";
+import chalk38 from "chalk";
 var recompile = async ({
   verbose,
   target,
@@ -2635,7 +2887,7 @@ var recompileAll = async ({
   const incrementalOptions = incremental ? ["--since", "-Apt", "--topological-dev"] : ["--parallel", "-Apt", "--topological-dev"];
   const jobsOptions = jobs ? ["-j", `${jobs}`] : [];
   if (jobs) {
-    console.log(chalk37.blue(`Jobs set to [${jobs}]`));
+    console.log(chalk38.blue(`Jobs set to [${jobs}]`));
   }
   const result = await runStepsAsync(`Recompile${incremental ? "-Incremental" : ""} [All]`, [
     [
@@ -2666,7 +2918,7 @@ var recompileAll = async ({
     ]
   ]);
   console.log(
-    `${chalk37.gray("Recompiled in")} [${chalk37.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk37.gray("seconds")}`
+    `${chalk38.gray("Recompiled in")} [${chalk38.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk38.gray("seconds")}`
   );
   return result;
 };
@@ -2697,13 +2949,13 @@ var reinstall = () => {
 };
 
 // src/actions/relint.ts
-import chalk38 from "chalk";
+import chalk39 from "chalk";
 var relintPackage = ({
   pkg,
   fix: fix2,
   verbose
 }) => {
-  console.log(chalk38.gray(`${fix2 ? "Fix" : "Lint"} [${pkg}]`));
+  console.log(chalk39.gray(`${fix2 ? "Fix" : "Lint"} [${pkg}]`));
   const start = Date.now();
   const result = runSteps(`${fix2 ? "Fix" : "Lint"}  [${pkg}]`, [
     ["yarn", [
@@ -2713,7 +2965,7 @@ var relintPackage = ({
       fix2 ? "package-fix" : verbose ? "package-lint-verbose" : "package-lint"
     ]]
   ]);
-  console.log(chalk38.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk38.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk38.gray("seconds")}`));
+  console.log(chalk39.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk39.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk39.gray("seconds")}`));
   return result;
 };
 var relint = ({
@@ -2733,13 +2985,13 @@ var relint = ({
   });
 };
 var relintAllPackages = ({ fix: fix2 = false } = {}) => {
-  console.log(chalk38.gray(`${fix2 ? "Fix" : "Lint"} [All-Packages]`));
+  console.log(chalk39.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(chalk38.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk38.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk38.gray("seconds")}`));
+  console.log(chalk39.gray(`${fix2 ? "Fixed in" : "Linted in"} [${chalk39.magenta(((Date.now() - start) / 1e3).toFixed(2))}] ${chalk39.gray("seconds")}`));
   return result;
 };
 
@@ -2757,10 +3009,10 @@ var sonar = () => {
 };
 
 // src/actions/statics.ts
-import chalk39 from "chalk";
+import chalk40 from "chalk";
 var DefaultDependencies = ["axios", "@xylabs/pixel", "react", "graphql", "react-router", "@mui/material", "@mui/system"];
 var statics = () => {
-  console.log(chalk39.green("Check Required Static Dependencies"));
+  console.log(chalk40.green("Check Required Static Dependencies"));
   const statics2 = parsedPackageJSON()?.xy?.deps?.statics;
   return detectDuplicateDependencies(statics2, DefaultDependencies);
 };
@@ -2809,15 +3061,15 @@ var yarn3Only = () => {
 };
 
 // src/loadPackageConfig.ts
-import { readFile } from "fs/promises";
+import { readFile as readFile2 } from "fs/promises";
 var loadPackageConfig = async () => {
   const pkg = process.env.INIT_CWD;
-  const pkgConfig = await readFile(`${pkg}/package.json`, { encoding: "utf8" });
+  const pkgConfig = await readFile2(`${pkg}/package.json`, { encoding: "utf8" });
   return JSON.parse(pkgConfig);
 };
 
 // src/xy/xy.ts
-import chalk41 from "chalk";
+import chalk42 from "chalk";
 
 // src/xy/xyBuildCommands.ts
 var xyBuildCommands = (args) => {
@@ -3015,6 +3267,29 @@ var xyCommonCommands = (args) => {
       if (argv.verbose) console.log("NpmIgnore Gen");
       process.exitCode = npmignoreGen();
     }
+  ).command(
+    "readme-gen [package]",
+    "Readme Gen - Generate README.md files from template",
+    (yargs2) => {
+      return packagePositionalParam(yargs2).option("template", {
+        alias: "t",
+        description: "Path to README.template.md",
+        type: "string"
+      }).option("typedoc", {
+        default: false,
+        description: "Generate TypeDoc reference sections",
+        type: "boolean"
+      });
+    },
+    async (argv) => {
+      if (argv.verbose) console.log("Readme Gen");
+      process.exitCode = await readmeGen({
+        pkg: argv.package,
+        templatePath: argv.template,
+        typedoc: argv.typedoc,
+        verbose: !!argv.verbose
+      });
+    }
   ).command(
     "retest",
     "Re-Test - Run Jest Tests with cleaned cache",
@@ -3194,7 +3469,7 @@ var xyInstallCommands = (args) => {
 };
 
 // src/xy/xyLintCommands.ts
-import chalk40 from "chalk";
+import chalk41 from "chalk";
 var xyLintCommands = (args) => {
   return args.command(
     "cycle [package]",
@@ -3206,7 +3481,7 @@ var xyLintCommands = (args) => {
       const start = Date.now();
       if (argv.verbose) console.log("Cycle");
       process.exitCode = await cycle({ pkg: argv.package });
-      console.log(chalk40.blue(`Finished in ${Date.now() - start}ms`));
+      console.log(chalk41.blue(`Finished in ${Date.now() - start}ms`));
     }
   ).command(
     "lint [package]",
@@ -3236,7 +3511,7 @@ var xyLintCommands = (args) => {
         cache: argv.cache,
         verbose: !!argv.verbose
       });
-      console.log(chalk40.blue(`Finished in ${Date.now() - start}ms`));
+      console.log(chalk41.blue(`Finished in ${Date.now() - start}ms`));
     }
   ).command(
     "deplint [package]",
@@ -3257,19 +3532,25 @@ 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,
         peerDeps: !!argv.peerDeps,
         verbose: !!argv.verbose
       });
-      console.log(chalk40.blue(`Finished in ${Date.now() - start}ms`));
+      console.log(chalk41.blue(`Finished in ${Date.now() - start}ms`));
     }
   ).command(
     "fix [package]",
@@ -3281,7 +3562,7 @@ var xyLintCommands = (args) => {
       const start = Date.now();
       if (argv.verbose) console.log("Fix");
       process.exitCode = fix();
-      console.log(chalk40.blue(`Finished in ${Date.now() - start}ms`));
+      console.log(chalk41.blue(`Finished in ${Date.now() - start}ms`));
     }
   ).command(
     "relint [package]",
@@ -3293,7 +3574,7 @@ var xyLintCommands = (args) => {
       if (argv.verbose) console.log("Relinting");
       const start = Date.now();
       process.exitCode = relint();
-      console.log(chalk40.blue(`Finished in ${Date.now() - start}ms`));
+      console.log(chalk41.blue(`Finished in ${Date.now() - start}ms`));
     }
   ).command(
     "publint [package]",
@@ -3305,7 +3586,7 @@ var xyLintCommands = (args) => {
       if (argv.verbose) console.log("Publint");
       const start = Date.now();
       process.exitCode = await publint({ pkg: argv.package, verbose: !!argv.verbose });
-      console.log(chalk40.blue(`Finished in ${Date.now() - start}ms`));
+      console.log(chalk41.blue(`Finished in ${Date.now() - start}ms`));
     }
   ).command(
     "knip",
@@ -3317,7 +3598,7 @@ var xyLintCommands = (args) => {
       if (argv.verbose) console.log("Knip");
       const start = Date.now();
       process.exitCode = knip();
-      console.log(chalk40.blue(`Knip finished in ${Date.now() - start}ms`));
+      console.log(chalk41.blue(`Knip finished in ${Date.now() - start}ms`));
     }
   ).command(
     "sonar",
@@ -3329,7 +3610,7 @@ var xyLintCommands = (args) => {
       const start = Date.now();
       if (argv.verbose) console.log("Sonar Check");
       process.exitCode = sonar();
-      console.log(chalk40.blue(`Finished in ${Date.now() - start}ms`));
+      console.log(chalk41.blue(`Finished in ${Date.now() - start}ms`));
     }
   );
 };
@@ -3365,8 +3646,8 @@ var xyParseOptions = () => {
 var xy = async () => {
   const options = xyParseOptions();
   return await xyBuildCommands(xyCommonCommands(xyInstallCommands(xyDeployCommands(xyLintCommands(options))))).demandCommand(1).command("*", "", () => {
-    console.error(chalk41.yellow(`Command not found [${chalk41.magenta(process.argv[2])}]`));
-    console.log(chalk41.gray("Try 'yarn xy --help' for list of commands"));
+    console.error(chalk42.yellow(`Command not found [${chalk42.magenta(process.argv[2])}]`));
+    console.log(chalk42.gray("Try 'yarn xy --help' for list of commands"));
   }).version().help().argv;
 };
 export {
@@ -3413,6 +3694,7 @@ export {
   genDocsAll,
   genDocsPackage,
   generateIgnoreFiles,
+  generateReadmeFiles,
   gitignoreGen,
   gitlint,
   gitlintFix,
@@ -3448,6 +3730,7 @@ export {
   publish,
   readLines,
   readNonEmptyLines,
+  readmeGen,
   rebuild,
   recompile,
   recompileAll,