@xylabs/ts-scripts-common 7.5.0

package/dist/actions/publint.mjs

@@ -0,0 +1,187 @@
+// 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/runSteps.ts
+import { spawnSync } from "child_process";
+import { existsSync as existsSync2 } from "fs";
+import chalk3 from "chalk";
+var runSteps = (name, steps, exitOnFail = true, messages) => {
+  return safeExit(() => {
+    const pkgName = process.env.npm_package_name;
+    console.log(chalk3.green(`${name} [${pkgName}]`));
+    let totalStatus = 0;
+    for (const [i, [command, args, config]] of steps.entries()) {
+      if (messages?.[i]) {
+        console.log(chalk3.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(" "), {
+        ...config,
+        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 chalk4 from "chalk";
+var runStepAsync = (name, step, exitOnFail = true, message) => {
+  return new Promise((resolve) => {
+    const [command, args, config] = step;
+    if (message) {
+      console.log(chalk4.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(" "), {
+      ...config,
+      env: { FORCE_COLOR: "3", ...process.env },
+      shell: true,
+      stdio: "inherit"
+    }).on("close", (code) => {
+      if (code) {
+        console.error(
+          chalk4.red(
+            `Command Exited With Non-Zero Result [${chalk4.gray(code)}] | ${chalk4.yellow(command)} ${chalk4.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(chalk4.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/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 })]);
+};
+export {
+  publint,
+  publintAll,
+  publintPackage
+};
+//# sourceMappingURL=publint.mjs.map

package/dist/actions/publint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/checkResult.ts","../../src/pm/detectPackageManager.ts","../../src/pm/registry.ts","../../src/lib/processEx.ts","../../src/lib/withError.ts","../../src/lib/withErrnoException.ts","../../src/lib/safeExit.ts","../../src/lib/runSteps.ts","../../src/lib/runStepsAsync.ts","../../src/actions/publint.ts"],"sourcesContent":["import chalk from 'chalk'\n\nexport const checkResult = (name: string, result: number, level: 'error' | 'warn' = 'error', exitOnFail = false) => {\n  if (result) {\n    const exiting = exitOnFail ? '[Exiting Process]' : '[Continuing]'\n    const chalkFunc = level === 'error' ? chalk.red : chalk.yellow\n    console[level](chalkFunc(`${name} had ${result} failures ${exiting}`))\n    if (exitOnFail) {\n      process.exit(result)\n    }\n  }\n}\n","import { existsSync } from 'node:fs'\n\nexport type PackageManagerName = 'pnpm' | 'yarn'\n\nexport function detectPackageManager(): PackageManagerName {\n  if (existsSync('pnpm-lock.yaml') || existsSync('pnpm-workspace.yaml')) return 'pnpm'\n  return 'yarn'\n}\n","import type { PackageManagerName } from './detectPackageManager.ts'\nimport { detectPackageManager } from './detectPackageManager.ts'\nimport type { PackageManager } from './PackageManager.ts'\n\nconst implementations = new Map<PackageManagerName, PackageManager>()\n\nexport function registerPackageManager(pm: PackageManager): void {\n  implementations.set(pm.name, pm)\n}\n\nexport function getPackageManager(name?: PackageManagerName): PackageManager {\n  const pmName = name ?? detectPackageManager()\n  const pm = implementations.get(pmName)\n  if (!pm) {\n    throw new Error(\n      `No package manager implementation registered for \"${pmName}\". `\n      + `Install @xylabs/ts-scripts-${pmName === 'yarn' ? 'yarn3' : pmName} and ensure it is imported.`,\n    )\n  }\n  return pm\n}\n","import chalk from 'chalk'\n\nimport { withErrnoException } from './withErrnoException.ts'\nimport { withError } from './withError.ts'\n\nexport const processEx = (ex: unknown) => {\n  const error = typeof ex === 'string' ? new Error(ex) : ex\n  const exitCode\n    = withErrnoException(error, (error) => {\n      if (error.code === 'ENOENT') {\n        console.error(chalk.red(`'${error.path}' not found.`))\n      } else {\n        console.error(chalk.red(`Errno: ${error.code}`))\n      }\n      return error.errno ?? -1\n    })\n    ?? withError(error, (error) => {\n      console.error(chalk.red(`${error.name}: ${error.message}`))\n      return -1\n    })\n    ?? (() => {\n      console.error(chalk.red(`Unexpected Error: ${JSON.stringify(ex, null, 2)}`))\n      return -1\n    })()\n  // This allows us to use a previously set exit code\n  process.exit(process.exitCode ?? exitCode)\n}\n","export const withError = <T extends Error = Error>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ex: any,\n  closure: (error: T) => number,\n  predicate = (ex: T) => (!!ex.name && !!ex.message),\n) => {\n  return predicate(ex as T) ? closure(ex as T) : undefined\n}\n","import { withError } from './withError.ts'\n\nexport const withErrnoException = <T extends NodeJS.ErrnoException = NodeJS.ErrnoException>(\n  ex: unknown, closure: (error: T) => number,\n) => {\n  return withError<T>(ex, closure, (ex: unknown) => (ex as NodeJS.ErrnoException).errno !== undefined)\n}\n","/** Catch child process a crash and returns the code */\n\nimport { processEx } from './processEx.ts'\n\nconst safeExit = (func: () => number, exitOnFail = true): number => {\n  try {\n    const result = func()\n    if (result && exitOnFail) {\n      process.exit(result)\n    }\n    return result\n  } catch (ex) {\n    return processEx(ex)\n  }\n}\n\nconst safeExitAsync = async (func: () => Promise<number>, exitOnFail = true): Promise<number> => {\n  try {\n    const result = await func()\n    if (result && exitOnFail) {\n      process.exit(result)\n    }\n    return result\n  } catch (ex) {\n    return processEx(ex)\n  }\n}\n\nexport { safeExit, safeExitAsync }\n","import { spawnSync } from 'node:child_process'\nimport { existsSync } from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport type { ScriptStep } from '../pm/index.ts'\nimport { checkResult } from './checkResult.ts'\nimport { safeExit } from './safeExit.ts'\n\nexport type { ScriptStep } from '../pm/index.ts'\n\nexport const runSteps = (name: string, steps: ScriptStep[], exitOnFail = true, messages?: string[]): number => {\n  return safeExit(() => {\n    const pkgName = process.env.npm_package_name\n    console.log(chalk.green(`${name} [${pkgName}]`))\n    let totalStatus = 0\n    for (const [i, [command, args, config]] of steps.entries()) {\n      if (messages?.[i]) {\n        console.log(chalk.gray(messages?.[i]))\n      }\n      const argList = Array.isArray(args) ? args : args.split(' ')\n      if (command === 'node' && !existsSync(argList[0])) {\n        throw new Error(`File not found [${argList[0]}]`)\n      }\n      const status\n        = spawnSync(command, Array.isArray(args) ? args : args.split(' '), {\n          ...config,\n          encoding: 'utf8',\n          env: { FORCE_COLOR: '3', ...process.env },\n          shell: true,\n          stdio: 'inherit',\n        }).status ?? 0\n      checkResult(name, status, 'error', exitOnFail)\n      totalStatus += status ?? 0\n    }\n    return totalStatus\n  }, !!exitOnFail)\n}\n","import { spawn } from 'node:child_process'\nimport { existsSync } from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport { checkResult } from './checkResult.ts'\nimport type { ScriptStep } from './runSteps.ts'\nimport { safeExitAsync } from './safeExit.ts'\n\nexport const runStepAsync = (name: string, step: ScriptStep, exitOnFail = true, message?: string) => {\n  return new Promise<number>((resolve) => {\n    const [command, args, config] = step\n    if (message) {\n      console.log(chalk.gray(message))\n    }\n    const argList = Array.isArray(args) ? args : args.split(' ')\n    if (command === 'node' && !existsSync(argList[0])) {\n      throw new Error(`File not found [${argList[0]}]`)\n    }\n    spawn(command, Array.isArray(args) ? args : args.split(' '), {\n      ...config,\n      env: { FORCE_COLOR: '3', ...process.env },\n      shell: true,\n      stdio: 'inherit',\n    }).on('close', (code) => {\n      if (code) {\n        console.error(\n          chalk.red(\n            `Command Exited With Non-Zero Result [${chalk.gray(code)}] | ${chalk.yellow(command)} ${chalk.white(\n              Array.isArray(args) ? args.join(' ') : args,\n            )}`,\n          ),\n        )\n        checkResult(name, code, 'error', exitOnFail)\n        resolve(code)\n      } else {\n        resolve(0)\n      }\n    })\n  })\n}\n\nexport const runStepsAsync = async (name: string, steps: ScriptStep[], exitOnFail = true, messages?: string[]) => {\n  return await safeExitAsync(async () => {\n    const pkgName = process.env.npm_package_name\n    console.log(chalk.green(`${name} [${pkgName}]`))\n    let result = 0\n    for (const [i, step] of steps.entries()) {\n      result += await runStepAsync(name, step, exitOnFail, messages?.[i])\n    }\n    return result\n  })\n}\n","import { runSteps, runStepsAsync } from '../lib/index.ts'\nimport { getPackageManager } from '../pm/index.ts'\n\nexport interface PublintParams {\n  pkg?: string\n  verbose?: boolean\n}\n\nexport interface PublintPackageParams {\n  pkg: string\n  verbose?: boolean\n}\n\nexport const publint = async ({ verbose, pkg }: PublintParams) => {\n  return pkg === undefined\n    ? publintAll({ verbose })\n    : await publintPackage({ pkg, verbose })\n}\n\nexport const publintPackage = ({ pkg }: PublintPackageParams) => {\n  const pm = getPackageManager()\n  return runStepsAsync(`Publint [${pkg}]`, [pm.runInWorkspace(pkg, 'package-publint')])\n}\n\nexport const publintAll = ({ verbose }: PublintParams) => {\n  const pm = getPackageManager()\n  return runSteps('Publint', [pm.foreachWorkspace('package-publint', [], { verbose })])\n}\n"],"mappings":"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","names":["chalk","ex","ex","error","chalk","existsSync","chalk","chalk","existsSync","existsSync","chalk","chalk","existsSync"]}

package/dist/actions/readme-gen.mjs

@@ -0,0 +1,292 @@
+// 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/initCwd.ts
+function INIT_CWD() {
+  if (!process.env.INIT_CWD) console.error("Missing INIT_CWD");
+  return process.env.INIT_CWD;
+}
+
+// src/lib/generateReadmeFiles.ts
+import { execSync } from "child_process";
+import FS, { readFileSync } from "fs";
+import {
+  mkdir,
+  readFile,
+  writeFile
+} from "fs/promises";
+import { createRequire } from "module";
+import PATH from "path";
+import { createInterface } from "readline";
+import chalk from "chalk";
+var require2 = createRequire(import.meta.url);
+var packageRoot = PATH.dirname(require2.resolve("@xylabs/ts-scripts-common/package.json"));
+var readmeTemplatesDir = PATH.resolve(packageRoot, "templates", "readme");
+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 = PATH.join(packageLocation, ".temp-typedoc");
+  try {
+    if (!FS.existsSync(tempDir)) {
+      FS.mkdirSync(tempDir, { recursive: true });
+    }
+    const typedocConfig = {
+      disableSources: true,
+      entryPointStrategy: "expand",
+      entryPoints: entryPoints.map((ep) => PATH.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 = PATH.join(tempDir, "typedoc.json");
+    FS.writeFileSync(typedocJsonPath, JSON.stringify(typedocConfig, null, 2));
+    try {
+      execSync(`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 = PATH.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(PATH.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(PATH.join(dir, item.name), level + 1);
+    }
+  } catch {
+  }
+  return content;
+}
+function askConfirmation(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+}
+var DEFAULT_README_TEMPLATE = readFileSync(PATH.resolve(readmeTemplatesDir, "README.template.md"), "utf8");
+var DEFAULT_README_BODY = readFileSync(PATH.resolve(readmeTemplatesDir, "README.body.md"), "utf8");
+function applyLogoConfig(template, logoUrl, logoLinkUrl) {
+  let result = template;
+  if (logoUrl) {
+    result = result.replace(/\[logo]: .+/, `[logo]: ${logoUrl}`);
+    if (logoLinkUrl) {
+      result = result.replace(/\[!\[logo]\[]][^)]*\)/, `[![logo][]](${logoLinkUrl})`);
+    }
+  } else {
+    result = result.replace(/\[!\[logo]\[]][^\n]*\n*/, "");
+    result = result.replace(/\[logo]: [^\n]*\n?/, "");
+  }
+  return result;
+}
+function resolveTemplatePath(templatePath) {
+  const cwd = INIT_CWD() ?? ".";
+  return templatePath ?? PATH.join(cwd, ".xy", "README.template.md");
+}
+async function loadOrCreateTemplate(resolvedTemplatePath) {
+  try {
+    const template = await readFile(resolvedTemplatePath, "utf8");
+    return { created: false, template };
+  } catch {
+    console.log(chalk.yellow(`Template not found: ${resolvedTemplatePath}`));
+    const shouldCreate = await askConfirmation("Would you like to create a stock template? (y/N) ");
+    if (!shouldCreate) {
+      throw new Error("Template creation declined");
+    }
+    const template = DEFAULT_README_TEMPLATE;
+    await scaffoldTemplate(resolvedTemplatePath, template);
+    return { created: true, template };
+  }
+}
+async function scaffoldTemplate(resolvedTemplatePath, template) {
+  const xyDir = PATH.dirname(resolvedTemplatePath);
+  await mkdir(xyDir, { recursive: true });
+  await writeFile(resolvedTemplatePath, template);
+  console.log(chalk.green(`Created template: ${resolvedTemplatePath}`));
+  const bodyPath = PATH.join(xyDir, "README.body.md");
+  await writeFile(bodyPath, DEFAULT_README_BODY);
+  console.log(chalk.green(`Created body template: ${bodyPath}`));
+}
+async function resolveBody(location, defaultBody) {
+  const localBodyPath = PATH.join(location, "README.body.md");
+  try {
+    return await readFile(localBodyPath, "utf8");
+  } catch {
+    return defaultBody;
+  }
+}
+async function generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose) {
+  try {
+    const pkgJsonPath = PATH.join(location, "package.json");
+    const pkgJson = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const body = await resolveBody(location, defaultBody);
+    const typedocContent = typedoc ? generateTypedoc(location, ["src/index*.ts"]) : "";
+    const readmeContent = fillTemplate(template, {
+      ...pkgJson,
+      body,
+      typedoc: typedocContent
+    });
+    await writeFile(PATH.join(location, "README.md"), readmeContent);
+    if (verbose) console.log(chalk.green(`  ${name}`));
+    return true;
+  } catch (ex) {
+    const error = ex;
+    console.warn(chalk.yellow(`  Skipped ${location}: ${error.message}`));
+    return false;
+  }
+}
+async function generateReadmeFiles({
+  logoLinkUrl,
+  logoUrl,
+  pkg,
+  templatePath,
+  typedoc = false,
+  verbose = false
+}) {
+  console.log(chalk.green("Generate README Files"));
+  const resolvedTemplatePath = resolveTemplatePath(templatePath);
+  let template;
+  let templateCreated;
+  try {
+    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath));
+  } catch {
+    return 1;
+  }
+  template = applyLogoConfig(template, logoUrl, logoLinkUrl);
+  if (templateCreated) {
+    console.log(chalk.green("Generating README files for all packages..."));
+  }
+  const xyDir = PATH.dirname(resolvedTemplatePath);
+  const xyBodyPath = PATH.join(xyDir, "README.body.md");
+  let defaultBody;
+  try {
+    defaultBody = await readFile(xyBodyPath, "utf8");
+  } catch {
+    defaultBody = DEFAULT_README_BODY;
+  }
+  const pm = getPackageManager();
+  const singleWorkspace = pkg && !templateCreated ? pm.findWorkspace(pkg) : void 0;
+  const workspaces = singleWorkspace ? [singleWorkspace] : pm.listWorkspaces();
+  let failed = false;
+  for (const { location, name } of workspaces) {
+    const success = await generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose);
+    if (!success) failed = true;
+  }
+  return failed ? 1 : 0;
+}
+
+// src/lib/loadConfig.ts
+import chalk2 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(chalk2.green(`Loaded config from ${configFilePath}`));
+      if (config.verbose) {
+        console.log(chalk2.gray(`${JSON.stringify(config, null, 2)}`));
+      }
+    }
+  }
+  return deepmerge(config, params ?? {});
+};
+
+// src/actions/readme-gen.ts
+async function readmeGen({
+  pkg,
+  templatePath,
+  typedoc,
+  verbose
+}) {
+  const config2 = await loadConfig();
+  return await generateReadmeFiles({
+    logoLinkUrl: config2.readme?.logoLinkUrl,
+    logoUrl: config2.readme?.logoUrl,
+    pkg,
+    templatePath,
+    typedoc,
+    verbose
+  });
+}
+export {
+  readmeGen
+};
+//# sourceMappingURL=readme-gen.mjs.map

package/dist/actions/readme-gen.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/pm/detectPackageManager.ts","../../src/pm/registry.ts","../../src/lib/initCwd.ts","../../src/lib/generateReadmeFiles.ts","../../src/lib/loadConfig.ts","../../src/actions/readme-gen.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\n\nexport type PackageManagerName = 'pnpm' | 'yarn'\n\nexport function detectPackageManager(): PackageManagerName {\n  if (existsSync('pnpm-lock.yaml') || existsSync('pnpm-workspace.yaml')) return 'pnpm'\n  return 'yarn'\n}\n","import type { PackageManagerName } from './detectPackageManager.ts'\nimport { detectPackageManager } from './detectPackageManager.ts'\nimport type { PackageManager } from './PackageManager.ts'\n\nconst implementations = new Map<PackageManagerName, PackageManager>()\n\nexport function registerPackageManager(pm: PackageManager): void {\n  implementations.set(pm.name, pm)\n}\n\nexport function getPackageManager(name?: PackageManagerName): PackageManager {\n  const pmName = name ?? detectPackageManager()\n  const pm = implementations.get(pmName)\n  if (!pm) {\n    throw new Error(\n      `No package manager implementation registered for \"${pmName}\". `\n      + `Install @xylabs/ts-scripts-${pmName === 'yarn' ? 'yarn3' : pmName} and ensure it is imported.`,\n    )\n  }\n  return pm\n}\n","export function INIT_CWD(): string | undefined {\n  if (!process.env.INIT_CWD) console.error('Missing INIT_CWD')\n  return process.env.INIT_CWD\n}\n","import { execSync } from 'node:child_process'\nimport FS, { readFileSync } from 'node:fs'\nimport {\n  mkdir, readFile, writeFile,\n} from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport PATH from 'node:path'\nimport { createInterface } from 'node:readline'\n\nimport chalk from 'chalk'\n\nimport { getPackageManager } from '../pm/index.ts'\nimport { INIT_CWD } from './initCwd.ts'\n\nconst require = createRequire(import.meta.url)\nconst packageRoot = PATH.dirname(require.resolve('@xylabs/ts-scripts-common/package.json'))\nconst readmeTemplatesDir = PATH.resolve(packageRoot, 'templates', 'readme')\n\ninterface GenerateReadmeFilesParams {\n  logoLinkUrl?: string\n  logoUrl?: string\n  pkg?: string\n  templatePath?: string\n  typedoc?: boolean\n  verbose?: boolean\n}\n\nfunction fillTemplate(template: string, data: Record<string, string>): string {\n  const additionalData: Record<string, string> = { ...data, safeName: data.name.replaceAll('/', '__').replaceAll('@', '') }\n  return template.replaceAll(/\\{\\{(.*?)\\}\\}/g, (_, key: string) => additionalData[key.trim()] ?? '')\n}\n\nfunction generateTypedoc(packageLocation: string, entryPoints: string[]): string {\n  const tempDir = PATH.join(packageLocation, '.temp-typedoc')\n\n  try {\n    if (!FS.existsSync(tempDir)) {\n      FS.mkdirSync(tempDir, { recursive: true })\n    }\n\n    const typedocConfig = {\n      disableSources: true,\n      entryPointStrategy: 'expand',\n      entryPoints: entryPoints.map(ep => PATH.resolve(packageLocation, ep)),\n      excludeExternals: true,\n      excludeInternal: true,\n      excludePrivate: true,\n      githubPages: false,\n      hideBreadcrumbs: true,\n      hideGenerator: true,\n      hidePageTitle: true,\n      out: tempDir,\n      plugin: ['typedoc-plugin-markdown'],\n      readme: 'none',\n      skipErrorChecking: true,\n      sort: ['source-order'],\n      theme: 'markdown',\n      useCodeBlocks: true,\n    }\n\n    const typedocJsonPath = PATH.join(tempDir, 'typedoc.json')\n    FS.writeFileSync(typedocJsonPath, JSON.stringify(typedocConfig, null, 2))\n\n    try {\n      execSync(`npx typedoc --options ${typedocJsonPath}`, {\n        cwd: process.cwd(),\n        stdio: ['ignore', 'pipe', 'pipe'],\n      })\n    } catch {\n      return ''\n    }\n\n    return consolidateMarkdown(tempDir)\n  } catch {\n    return ''\n  } finally {\n    try {\n      FS.rmSync(tempDir, { force: true, recursive: true })\n    } catch {\n      // ignore cleanup errors\n    }\n  }\n}\n\nfunction consolidateMarkdown(tempDir: string): string {\n  let consolidated = '## Reference\\n\\n'\n\n  const mainReadmePath = PATH.join(tempDir, 'README.md')\n  if (FS.existsSync(mainReadmePath)) {\n    const mainContent = FS.readFileSync(mainReadmePath, 'utf8')\n      .replace(/^---(.|\\n)*?---\\n/, '')\n      .replace(/^# .+\\n/, '')\n      .replaceAll(/\\]\\((.+?)\\.md\\)/g, '](#$1)')\n\n    consolidated += mainContent + '\\n\\n'\n  }\n\n  consolidated += processDirectory(tempDir)\n\n  return consolidated\n    .replaceAll(/\\n\\n\\n+/g, '\\n\\n')\n    .replaceAll(/^#### /gm, '### ')\n    .replaceAll(/^##### /gm, '#### ')\n    .replaceAll(/^###### /gm, '##### ')\n}\n\nfunction processDirectory(dir: string, level = 0): string {\n  const indent = '  '.repeat(level)\n  let content = ''\n\n  try {\n    const items = FS.readdirSync(dir, { withFileTypes: true })\n\n    for (const item of items) {\n      if (item.isDirectory()) continue\n      if (item.name === 'README.md' || !item.name.endsWith('.md')) continue\n\n      const fileContent = FS.readFileSync(PATH.join(dir, item.name), 'utf8')\n        .replace(/^---(.|\\n)*?---\\n/, '')\n      const moduleName = item.name.replace('.md', '')\n\n      content += `\\n\\n${indent}### <a id=\"${moduleName}\"></a>${moduleName}\\n\\n`\n      content += fileContent\n        .replace(/^# .+\\n/, '')\n        .replaceAll(/\\]\\((.+?)\\.md\\)/g, '](#$1)')\n    }\n\n    for (const item of items) {\n      if (!item.isDirectory()) continue\n      if (item.name === 'spec' || item.name.includes('.spec')) continue\n\n      content += `\\n\\n${indent}### ${item.name}\\n`\n      content += processDirectory(PATH.join(dir, item.name), level + 1)\n    }\n  } catch {\n    // skip unreadable directories\n  }\n\n  return content\n}\n\nfunction askConfirmation(question: string): Promise<boolean> {\n  const rl = createInterface({ input: process.stdin, output: process.stdout })\n  return new Promise((resolve) => {\n    rl.question(question, (answer) => {\n      rl.close()\n      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes')\n    })\n  })\n}\n\nexport const DEFAULT_README_TEMPLATE = readFileSync(PATH.resolve(readmeTemplatesDir, 'README.template.md'), 'utf8')\nexport const DEFAULT_README_BODY = readFileSync(PATH.resolve(readmeTemplatesDir, 'README.body.md'), 'utf8')\n\nexport function applyLogoConfig(template: string, logoUrl?: string, logoLinkUrl?: string): string {\n  let result = template\n  if (logoUrl) {\n    result = result.replace(/\\[logo]: .+/, `[logo]: ${logoUrl}`)\n    if (logoLinkUrl) {\n      result = result.replace(/\\[!\\[logo]\\[]][^)]*\\)/, `[![logo][]](${logoLinkUrl})`)\n    }\n  } else {\n    result = result.replace(/\\[!\\[logo]\\[]][^\\n]*\\n*/, '')\n    result = result.replace(/\\[logo]: [^\\n]*\\n?/, '')\n  }\n  return result\n}\n\nexport function resolveTemplatePath(templatePath: string | undefined): string {\n  const cwd = INIT_CWD() ?? '.'\n  return templatePath ?? PATH.join(cwd, '.xy', 'README.template.md')\n}\n\nasync function loadOrCreateTemplate(resolvedTemplatePath: string): Promise<{\n  created: boolean\n  template: string\n}> {\n  try {\n    const template = await readFile(resolvedTemplatePath, 'utf8')\n    return { created: false, template }\n  } catch {\n    console.log(chalk.yellow(`Template not found: ${resolvedTemplatePath}`))\n    const shouldCreate = await askConfirmation('Would you like to create a stock template? (y/N) ')\n    if (!shouldCreate) {\n      throw new Error('Template creation declined')\n    }\n    const template = DEFAULT_README_TEMPLATE\n    await scaffoldTemplate(resolvedTemplatePath, template)\n    return { created: true, template }\n  }\n}\n\nexport async function scaffoldTemplate(resolvedTemplatePath: string, template: string): Promise<void> {\n  const xyDir = PATH.dirname(resolvedTemplatePath)\n  await mkdir(xyDir, { recursive: true })\n  await writeFile(resolvedTemplatePath, template)\n  console.log(chalk.green(`Created template: ${resolvedTemplatePath}`))\n  const bodyPath = PATH.join(xyDir, 'README.body.md')\n  await writeFile(bodyPath, DEFAULT_README_BODY)\n  console.log(chalk.green(`Created body template: ${bodyPath}`))\n}\n\nasync function resolveBody(location: string, defaultBody: string): Promise<string> {\n  const localBodyPath = PATH.join(location, 'README.body.md')\n  try {\n    return await readFile(localBodyPath, 'utf8')\n  } catch {\n    return defaultBody\n  }\n}\n\nasync function generateReadmeForWorkspace(\n  location: string,\n  name: string,\n  template: string,\n  defaultBody: string,\n  typedoc: boolean,\n  verbose: boolean,\n): Promise<boolean> {\n  try {\n    const pkgJsonPath = PATH.join(location, 'package.json')\n    const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf8'))\n    const body = await resolveBody(location, defaultBody)\n    const typedocContent = typedoc ? generateTypedoc(location, ['src/index*.ts']) : ''\n    const readmeContent = fillTemplate(template, {\n      ...pkgJson, body, typedoc: typedocContent,\n    })\n    await writeFile(PATH.join(location, 'README.md'), readmeContent)\n    if (verbose) console.log(chalk.green(`  ${name}`))\n    return true\n  } catch (ex) {\n    const error = ex as Error\n    console.warn(chalk.yellow(`  Skipped ${location}: ${error.message}`))\n    return false\n  }\n}\n\nexport async function generateReadmeFiles({\n  logoLinkUrl, logoUrl, pkg, templatePath, typedoc = false, verbose = false,\n}: GenerateReadmeFilesParams): Promise<number> {\n  console.log(chalk.green('Generate README Files'))\n  const resolvedTemplatePath = resolveTemplatePath(templatePath)\n\n  let template: string\n  let templateCreated: boolean\n  try {\n    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath))\n  } catch {\n    return 1\n  }\n\n  template = applyLogoConfig(template, logoUrl, logoLinkUrl)\n\n  if (templateCreated) {\n    console.log(chalk.green('Generating README files for all packages...'))\n  }\n\n  const xyDir = PATH.dirname(resolvedTemplatePath)\n  const xyBodyPath = PATH.join(xyDir, 'README.body.md')\n  let defaultBody: string\n  try {\n    defaultBody = await readFile(xyBodyPath, 'utf8')\n  } catch {\n    defaultBody = DEFAULT_README_BODY\n  }\n\n  const pm = getPackageManager()\n  const singleWorkspace = pkg && !templateCreated ? pm.findWorkspace(pkg) : undefined\n  const workspaces = singleWorkspace ? [singleWorkspace] : pm.listWorkspaces()\n  let failed = false\n\n  for (const { location, name } of workspaces) {\n    const success = await generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose)\n    if (!success) failed = true\n  }\n\n  return failed ? 1 : 0\n}\n","import chalk from 'chalk'\nimport { cosmiconfig } from 'cosmiconfig'\nimport { TypeScriptLoader } from 'cosmiconfig-typescript-loader'\nimport deepmerge from 'deepmerge'\n\nlet config: Record<string, unknown>\n\nexport const loadConfig = async <T extends object>(params?: T): Promise<T> => {\n  if (config === undefined) {\n    const cosmicConfigResult = await cosmiconfig('xy', { cache: true, loaders: { '.ts': TypeScriptLoader() } }).search()\n    config = cosmicConfigResult?.config\n    const configFilePath = cosmicConfigResult?.filepath\n    if (configFilePath !== undefined) {\n      console.log(chalk.green(`Loaded config from ${configFilePath}`))\n      if (config.verbose) {\n        console.log(chalk.gray(`${JSON.stringify(config, null, 2)}`))\n      }\n    }\n  }\n  return deepmerge(config, params ?? {}) as T\n}\n","import { generateReadmeFiles, loadConfig } from '../lib/index.ts'\nimport type { XyConfig } from './package/index.ts'\n\nexport interface ReadmeGenParams {\n  pkg?: string\n  templatePath?: string\n  typedoc?: boolean\n  verbose?: boolean\n}\n\nexport async function readmeGen({\n  pkg, templatePath, typedoc, verbose,\n}: ReadmeGenParams): Promise<number> {\n  const config = await loadConfig<XyConfig>()\n  return await generateReadmeFiles({\n    logoLinkUrl: config.readme?.logoLinkUrl,\n    logoUrl: config.readme?.logoUrl,\n    pkg,\n    templatePath,\n    typedoc,\n    verbose,\n  })\n}\n"],"mappings":"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","names":["require","chalk","config"]}

package/dist/actions/readme-init.mjs

@@ -0,0 +1,83 @@
+// src/lib/initCwd.ts
+function INIT_CWD() {
+  if (!process.env.INIT_CWD) console.error("Missing INIT_CWD");
+  return process.env.INIT_CWD;
+}
+
+// src/lib/generateReadmeFiles.ts
+import { execSync } from "child_process";
+import FS, { readFileSync } from "fs";
+import {
+  mkdir,
+  readFile,
+  writeFile
+} from "fs/promises";
+import { createRequire } from "module";
+import PATH from "path";
+import { createInterface } from "readline";
+import chalk from "chalk";
+var require2 = createRequire(import.meta.url);
+var packageRoot = PATH.dirname(require2.resolve("@xylabs/ts-scripts-common/package.json"));
+var readmeTemplatesDir = PATH.resolve(packageRoot, "templates", "readme");
+var DEFAULT_README_TEMPLATE = readFileSync(PATH.resolve(readmeTemplatesDir, "README.template.md"), "utf8");
+var DEFAULT_README_BODY = readFileSync(PATH.resolve(readmeTemplatesDir, "README.body.md"), "utf8");
+function applyLogoConfig(template, logoUrl, logoLinkUrl) {
+  let result = template;
+  if (logoUrl) {
+    result = result.replace(/\[logo]: .+/, `[logo]: ${logoUrl}`);
+    if (logoLinkUrl) {
+      result = result.replace(/\[!\[logo]\[]][^)]*\)/, `[![logo][]](${logoLinkUrl})`);
+    }
+  } else {
+    result = result.replace(/\[!\[logo]\[]][^\n]*\n*/, "");
+    result = result.replace(/\[logo]: [^\n]*\n?/, "");
+  }
+  return result;
+}
+function resolveTemplatePath(templatePath) {
+  const cwd = INIT_CWD() ?? ".";
+  return templatePath ?? PATH.join(cwd, ".xy", "README.template.md");
+}
+async function scaffoldTemplate(resolvedTemplatePath, template) {
+  const xyDir = PATH.dirname(resolvedTemplatePath);
+  await mkdir(xyDir, { recursive: true });
+  await writeFile(resolvedTemplatePath, template);
+  console.log(chalk.green(`Created template: ${resolvedTemplatePath}`));
+  const bodyPath = PATH.join(xyDir, "README.body.md");
+  await writeFile(bodyPath, DEFAULT_README_BODY);
+  console.log(chalk.green(`Created body template: ${bodyPath}`));
+}
+
+// src/lib/loadConfig.ts
+import chalk2 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(chalk2.green(`Loaded config from ${configFilePath}`));
+      if (config.verbose) {
+        console.log(chalk2.gray(`${JSON.stringify(config, null, 2)}`));
+      }
+    }
+  }
+  return deepmerge(config, params ?? {});
+};
+
+// src/actions/readme-init.ts
+async function readmeInit({ templatePath }) {
+  const config2 = await loadConfig();
+  const template = applyLogoConfig(DEFAULT_README_TEMPLATE, config2.readme?.logoUrl, config2.readme?.logoLinkUrl);
+  const resolvedTemplatePath = resolveTemplatePath(templatePath);
+  await scaffoldTemplate(resolvedTemplatePath, template);
+  return 0;
+}
+export {
+  readmeInit
+};
+//# sourceMappingURL=readme-init.mjs.map

package/dist/actions/readme-init.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/initCwd.ts","../../src/lib/generateReadmeFiles.ts","../../src/lib/loadConfig.ts","../../src/actions/readme-init.ts"],"sourcesContent":["export function INIT_CWD(): string | undefined {\n  if (!process.env.INIT_CWD) console.error('Missing INIT_CWD')\n  return process.env.INIT_CWD\n}\n","import { execSync } from 'node:child_process'\nimport FS, { readFileSync } from 'node:fs'\nimport {\n  mkdir, readFile, writeFile,\n} from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport PATH from 'node:path'\nimport { createInterface } from 'node:readline'\n\nimport chalk from 'chalk'\n\nimport { getPackageManager } from '../pm/index.ts'\nimport { INIT_CWD } from './initCwd.ts'\n\nconst require = createRequire(import.meta.url)\nconst packageRoot = PATH.dirname(require.resolve('@xylabs/ts-scripts-common/package.json'))\nconst readmeTemplatesDir = PATH.resolve(packageRoot, 'templates', 'readme')\n\ninterface GenerateReadmeFilesParams {\n  logoLinkUrl?: string\n  logoUrl?: string\n  pkg?: string\n  templatePath?: string\n  typedoc?: boolean\n  verbose?: boolean\n}\n\nfunction fillTemplate(template: string, data: Record<string, string>): string {\n  const additionalData: Record<string, string> = { ...data, safeName: data.name.replaceAll('/', '__').replaceAll('@', '') }\n  return template.replaceAll(/\\{\\{(.*?)\\}\\}/g, (_, key: string) => additionalData[key.trim()] ?? '')\n}\n\nfunction generateTypedoc(packageLocation: string, entryPoints: string[]): string {\n  const tempDir = PATH.join(packageLocation, '.temp-typedoc')\n\n  try {\n    if (!FS.existsSync(tempDir)) {\n      FS.mkdirSync(tempDir, { recursive: true })\n    }\n\n    const typedocConfig = {\n      disableSources: true,\n      entryPointStrategy: 'expand',\n      entryPoints: entryPoints.map(ep => PATH.resolve(packageLocation, ep)),\n      excludeExternals: true,\n      excludeInternal: true,\n      excludePrivate: true,\n      githubPages: false,\n      hideBreadcrumbs: true,\n      hideGenerator: true,\n      hidePageTitle: true,\n      out: tempDir,\n      plugin: ['typedoc-plugin-markdown'],\n      readme: 'none',\n      skipErrorChecking: true,\n      sort: ['source-order'],\n      theme: 'markdown',\n      useCodeBlocks: true,\n    }\n\n    const typedocJsonPath = PATH.join(tempDir, 'typedoc.json')\n    FS.writeFileSync(typedocJsonPath, JSON.stringify(typedocConfig, null, 2))\n\n    try {\n      execSync(`npx typedoc --options ${typedocJsonPath}`, {\n        cwd: process.cwd(),\n        stdio: ['ignore', 'pipe', 'pipe'],\n      })\n    } catch {\n      return ''\n    }\n\n    return consolidateMarkdown(tempDir)\n  } catch {\n    return ''\n  } finally {\n    try {\n      FS.rmSync(tempDir, { force: true, recursive: true })\n    } catch {\n      // ignore cleanup errors\n    }\n  }\n}\n\nfunction consolidateMarkdown(tempDir: string): string {\n  let consolidated = '## Reference\\n\\n'\n\n  const mainReadmePath = PATH.join(tempDir, 'README.md')\n  if (FS.existsSync(mainReadmePath)) {\n    const mainContent = FS.readFileSync(mainReadmePath, 'utf8')\n      .replace(/^---(.|\\n)*?---\\n/, '')\n      .replace(/^# .+\\n/, '')\n      .replaceAll(/\\]\\((.+?)\\.md\\)/g, '](#$1)')\n\n    consolidated += mainContent + '\\n\\n'\n  }\n\n  consolidated += processDirectory(tempDir)\n\n  return consolidated\n    .replaceAll(/\\n\\n\\n+/g, '\\n\\n')\n    .replaceAll(/^#### /gm, '### ')\n    .replaceAll(/^##### /gm, '#### ')\n    .replaceAll(/^###### /gm, '##### ')\n}\n\nfunction processDirectory(dir: string, level = 0): string {\n  const indent = '  '.repeat(level)\n  let content = ''\n\n  try {\n    const items = FS.readdirSync(dir, { withFileTypes: true })\n\n    for (const item of items) {\n      if (item.isDirectory()) continue\n      if (item.name === 'README.md' || !item.name.endsWith('.md')) continue\n\n      const fileContent = FS.readFileSync(PATH.join(dir, item.name), 'utf8')\n        .replace(/^---(.|\\n)*?---\\n/, '')\n      const moduleName = item.name.replace('.md', '')\n\n      content += `\\n\\n${indent}### <a id=\"${moduleName}\"></a>${moduleName}\\n\\n`\n      content += fileContent\n        .replace(/^# .+\\n/, '')\n        .replaceAll(/\\]\\((.+?)\\.md\\)/g, '](#$1)')\n    }\n\n    for (const item of items) {\n      if (!item.isDirectory()) continue\n      if (item.name === 'spec' || item.name.includes('.spec')) continue\n\n      content += `\\n\\n${indent}### ${item.name}\\n`\n      content += processDirectory(PATH.join(dir, item.name), level + 1)\n    }\n  } catch {\n    // skip unreadable directories\n  }\n\n  return content\n}\n\nfunction askConfirmation(question: string): Promise<boolean> {\n  const rl = createInterface({ input: process.stdin, output: process.stdout })\n  return new Promise((resolve) => {\n    rl.question(question, (answer) => {\n      rl.close()\n      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes')\n    })\n  })\n}\n\nexport const DEFAULT_README_TEMPLATE = readFileSync(PATH.resolve(readmeTemplatesDir, 'README.template.md'), 'utf8')\nexport const DEFAULT_README_BODY = readFileSync(PATH.resolve(readmeTemplatesDir, 'README.body.md'), 'utf8')\n\nexport function applyLogoConfig(template: string, logoUrl?: string, logoLinkUrl?: string): string {\n  let result = template\n  if (logoUrl) {\n    result = result.replace(/\\[logo]: .+/, `[logo]: ${logoUrl}`)\n    if (logoLinkUrl) {\n      result = result.replace(/\\[!\\[logo]\\[]][^)]*\\)/, `[![logo][]](${logoLinkUrl})`)\n    }\n  } else {\n    result = result.replace(/\\[!\\[logo]\\[]][^\\n]*\\n*/, '')\n    result = result.replace(/\\[logo]: [^\\n]*\\n?/, '')\n  }\n  return result\n}\n\nexport function resolveTemplatePath(templatePath: string | undefined): string {\n  const cwd = INIT_CWD() ?? '.'\n  return templatePath ?? PATH.join(cwd, '.xy', 'README.template.md')\n}\n\nasync function loadOrCreateTemplate(resolvedTemplatePath: string): Promise<{\n  created: boolean\n  template: string\n}> {\n  try {\n    const template = await readFile(resolvedTemplatePath, 'utf8')\n    return { created: false, template }\n  } catch {\n    console.log(chalk.yellow(`Template not found: ${resolvedTemplatePath}`))\n    const shouldCreate = await askConfirmation('Would you like to create a stock template? (y/N) ')\n    if (!shouldCreate) {\n      throw new Error('Template creation declined')\n    }\n    const template = DEFAULT_README_TEMPLATE\n    await scaffoldTemplate(resolvedTemplatePath, template)\n    return { created: true, template }\n  }\n}\n\nexport async function scaffoldTemplate(resolvedTemplatePath: string, template: string): Promise<void> {\n  const xyDir = PATH.dirname(resolvedTemplatePath)\n  await mkdir(xyDir, { recursive: true })\n  await writeFile(resolvedTemplatePath, template)\n  console.log(chalk.green(`Created template: ${resolvedTemplatePath}`))\n  const bodyPath = PATH.join(xyDir, 'README.body.md')\n  await writeFile(bodyPath, DEFAULT_README_BODY)\n  console.log(chalk.green(`Created body template: ${bodyPath}`))\n}\n\nasync function resolveBody(location: string, defaultBody: string): Promise<string> {\n  const localBodyPath = PATH.join(location, 'README.body.md')\n  try {\n    return await readFile(localBodyPath, 'utf8')\n  } catch {\n    return defaultBody\n  }\n}\n\nasync function generateReadmeForWorkspace(\n  location: string,\n  name: string,\n  template: string,\n  defaultBody: string,\n  typedoc: boolean,\n  verbose: boolean,\n): Promise<boolean> {\n  try {\n    const pkgJsonPath = PATH.join(location, 'package.json')\n    const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf8'))\n    const body = await resolveBody(location, defaultBody)\n    const typedocContent = typedoc ? generateTypedoc(location, ['src/index*.ts']) : ''\n    const readmeContent = fillTemplate(template, {\n      ...pkgJson, body, typedoc: typedocContent,\n    })\n    await writeFile(PATH.join(location, 'README.md'), readmeContent)\n    if (verbose) console.log(chalk.green(`  ${name}`))\n    return true\n  } catch (ex) {\n    const error = ex as Error\n    console.warn(chalk.yellow(`  Skipped ${location}: ${error.message}`))\n    return false\n  }\n}\n\nexport async function generateReadmeFiles({\n  logoLinkUrl, logoUrl, pkg, templatePath, typedoc = false, verbose = false,\n}: GenerateReadmeFilesParams): Promise<number> {\n  console.log(chalk.green('Generate README Files'))\n  const resolvedTemplatePath = resolveTemplatePath(templatePath)\n\n  let template: string\n  let templateCreated: boolean\n  try {\n    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath))\n  } catch {\n    return 1\n  }\n\n  template = applyLogoConfig(template, logoUrl, logoLinkUrl)\n\n  if (templateCreated) {\n    console.log(chalk.green('Generating README files for all packages...'))\n  }\n\n  const xyDir = PATH.dirname(resolvedTemplatePath)\n  const xyBodyPath = PATH.join(xyDir, 'README.body.md')\n  let defaultBody: string\n  try {\n    defaultBody = await readFile(xyBodyPath, 'utf8')\n  } catch {\n    defaultBody = DEFAULT_README_BODY\n  }\n\n  const pm = getPackageManager()\n  const singleWorkspace = pkg && !templateCreated ? pm.findWorkspace(pkg) : undefined\n  const workspaces = singleWorkspace ? [singleWorkspace] : pm.listWorkspaces()\n  let failed = false\n\n  for (const { location, name } of workspaces) {\n    const success = await generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose)\n    if (!success) failed = true\n  }\n\n  return failed ? 1 : 0\n}\n","import chalk from 'chalk'\nimport { cosmiconfig } from 'cosmiconfig'\nimport { TypeScriptLoader } from 'cosmiconfig-typescript-loader'\nimport deepmerge from 'deepmerge'\n\nlet config: Record<string, unknown>\n\nexport const loadConfig = async <T extends object>(params?: T): Promise<T> => {\n  if (config === undefined) {\n    const cosmicConfigResult = await cosmiconfig('xy', { cache: true, loaders: { '.ts': TypeScriptLoader() } }).search()\n    config = cosmicConfigResult?.config\n    const configFilePath = cosmicConfigResult?.filepath\n    if (configFilePath !== undefined) {\n      console.log(chalk.green(`Loaded config from ${configFilePath}`))\n      if (config.verbose) {\n        console.log(chalk.gray(`${JSON.stringify(config, null, 2)}`))\n      }\n    }\n  }\n  return deepmerge(config, params ?? {}) as T\n}\n","import {\n  applyLogoConfig, DEFAULT_README_TEMPLATE, loadConfig, resolveTemplatePath, scaffoldTemplate,\n} from '../lib/index.ts'\nimport type { XyConfig } from './package/index.ts'\n\nexport interface ReadmeInitParams {\n  templatePath?: string\n  verbose?: boolean\n}\n\nexport async function readmeInit({ templatePath }: ReadmeInitParams): Promise<number> {\n  const config = await loadConfig<XyConfig>()\n  const template = applyLogoConfig(DEFAULT_README_TEMPLATE, config.readme?.logoUrl, config.readme?.logoLinkUrl)\n  const resolvedTemplatePath = resolveTemplatePath(templatePath)\n  await scaffoldTemplate(resolvedTemplatePath, template)\n  return 0\n}\n"],"mappings":";AAAO,SAAS,WAA+B;AAC7C,MAAI,CAAC,QAAQ,IAAI,SAAU,SAAQ,MAAM,kBAAkB;AAC3D,SAAO,QAAQ,IAAI;AACrB;;;ACHA,SAAS,gBAAgB;AACzB,OAAO,MAAM,oBAAoB;AACjC;AAAA,EACE;AAAA,EAAO;AAAA,EAAU;AAAA,OACZ;AACP,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AACjB,SAAS,uBAAuB;AAEhC,OAAO,WAAW;AAKlB,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,cAAc,KAAK,QAAQA,SAAQ,QAAQ,wCAAwC,CAAC;AAC1F,IAAM,qBAAqB,KAAK,QAAQ,aAAa,aAAa,QAAQ;AAuInE,IAAM,0BAA0B,aAAa,KAAK,QAAQ,oBAAoB,oBAAoB,GAAG,MAAM;AAC3G,IAAM,sBAAsB,aAAa,KAAK,QAAQ,oBAAoB,gBAAgB,GAAG,MAAM;AAEnG,SAAS,gBAAgB,UAAkB,SAAkB,aAA8B;AAChG,MAAI,SAAS;AACb,MAAI,SAAS;AACX,aAAS,OAAO,QAAQ,eAAe,WAAW,OAAO,EAAE;AAC3D,QAAI,aAAa;AACf,eAAS,OAAO,QAAQ,yBAAyB,eAAe,WAAW,GAAG;AAAA,IAChF;AAAA,EACF,OAAO;AACL,aAAS,OAAO,QAAQ,2BAA2B,EAAE;AACrD,aAAS,OAAO,QAAQ,sBAAsB,EAAE;AAAA,EAClD;AACA,SAAO;AACT;AAEO,SAAS,oBAAoB,cAA0C;AAC5E,QAAM,MAAM,SAAS,KAAK;AAC1B,SAAO,gBAAgB,KAAK,KAAK,KAAK,OAAO,oBAAoB;AACnE;AAqBA,eAAsB,iBAAiB,sBAA8B,UAAiC;AACpG,QAAM,QAAQ,KAAK,QAAQ,oBAAoB;AAC/C,QAAM,MAAM,OAAO,EAAE,WAAW,KAAK,CAAC;AACtC,QAAM,UAAU,sBAAsB,QAAQ;AAC9C,UAAQ,IAAI,MAAM,MAAM,qBAAqB,oBAAoB,EAAE,CAAC;AACpE,QAAM,WAAW,KAAK,KAAK,OAAO,gBAAgB;AAClD,QAAM,UAAU,UAAU,mBAAmB;AAC7C,UAAQ,IAAI,MAAM,MAAM,0BAA0B,QAAQ,EAAE,CAAC;AAC/D;;;ACxMA,OAAOC,YAAW;AAClB,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AACjC,OAAO,eAAe;AAEtB,IAAI;AAEG,IAAM,aAAa,OAAyB,WAA2B;AAC5E,MAAI,WAAW,QAAW;AACxB,UAAM,qBAAqB,MAAM,YAAY,MAAM,EAAE,OAAO,MAAM,SAAS,EAAE,OAAO,iBAAiB,EAAE,EAAE,CAAC,EAAE,OAAO;AACnH,aAAS,oBAAoB;AAC7B,UAAM,iBAAiB,oBAAoB;AAC3C,QAAI,mBAAmB,QAAW;AAChC,cAAQ,IAAIA,OAAM,MAAM,sBAAsB,cAAc,EAAE,CAAC;AAC/D,UAAI,OAAO,SAAS;AAClB,gBAAQ,IAAIA,OAAM,KAAK,GAAG,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AACA,SAAO,UAAU,QAAQ,UAAU,CAAC,CAAC;AACvC;;;ACVA,eAAsB,WAAW,EAAE,aAAa,GAAsC;AACpF,QAAMC,UAAS,MAAM,WAAqB;AAC1C,QAAM,WAAW,gBAAgB,yBAAyBA,QAAO,QAAQ,SAASA,QAAO,QAAQ,WAAW;AAC5G,QAAM,uBAAuB,oBAAoB,YAAY;AAC7D,QAAM,iBAAiB,sBAAsB,QAAQ;AACrD,SAAO;AACT;","names":["require","chalk","config"]}