@xylabs/ts-scripts-yarn3 7.4.17 → 7.4.19

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/checkResult.ts","../../src/lib/processEx.ts","../../src/lib/withError.ts","../../src/lib/withErrnoException.ts","../../src/lib/safeExit.ts","../../src/lib/runSteps.ts","../../src/actions/gen-docs.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 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 type { SpawnSyncOptionsWithBufferEncoding } from 'node:child_process'\nimport { spawnSync } from 'node:child_process'\nimport { existsSync } from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport { checkResult } from './checkResult.ts'\nimport { safeExit } from './safeExit.ts'\n\nexport type ScriptStep\n  = | [/* command */ 'yarn' | 'node' | 'ts-node-script' | 'tsc' | 'jest' | 'npm', /* arg */ string | string[]]\n    | [/* command */ string, /* arg */ string | string[], /* config */ SpawnSyncOptionsWithBufferEncoding]\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 type { ScriptStep } from '../lib/index.ts'\nimport { runSteps } from '../lib/index.ts'\n\nexport interface GenDocsParams {\n  incremental?: boolean\n  pkg?: string\n}\n\nexport interface GenDocsPackageParams { pkg: string }\n\nexport const genDocs = ({ pkg, incremental }: GenDocsParams) => {\n  return pkg ? genDocsPackage({ pkg }) : genDocsAll({ incremental })\n}\n\nexport const genDocsPackage = ({ pkg }: GenDocsPackageParams) => {\n  const steps: ScriptStep[] = [['yarn', ['workspace', pkg, 'run', 'package-gen-docs']]]\n\n  return runSteps(`GenDocs [${pkg}]`, [...steps])\n}\n\nexport const genDocsAll = ({ incremental }: GenDocsParams) => {\n  const incrementalOptions = incremental ? ['--since', '-pA'] : ['-pA']\n  const steps: ScriptStep[] = [['yarn', ['workspaces', 'foreach', ...incrementalOptions, 'run', 'package-gen-docs']]]\n\n  return runSteps(`GenDocs [All${incremental ? '-Incremental' : ''}]`, [...steps])\n}\n"],"mappings":"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","names":["chalk","ex","ex","error","chalk","chalk","chalk"]}
+{"version":3,"sources":["../../src/lib/checkResult.ts","../../src/lib/processEx.ts","../../src/lib/withError.ts","../../src/lib/withErrnoException.ts","../../src/lib/safeExit.ts","../../src/lib/runSteps.ts","../../src/actions/gen-docs.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 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 type { SpawnSyncOptionsWithBufferEncoding } from 'node:child_process'\nimport { spawnSync } from 'node:child_process'\nimport { existsSync } from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport { checkResult } from './checkResult.ts'\nimport { safeExit } from './safeExit.ts'\n\nexport type ScriptStep\n  = | [/* command */ 'yarn' | 'node' | 'ts-node-script' | 'tsc' | 'npm' | 'vitest', /* arg */ string | string[]]\n    | [/* command */ string, /* arg */ string | string[], /* config */ SpawnSyncOptionsWithBufferEncoding]\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 type { ScriptStep } from '../lib/index.ts'\nimport { runSteps } from '../lib/index.ts'\n\nexport interface GenDocsParams {\n  incremental?: boolean\n  pkg?: string\n}\n\nexport interface GenDocsPackageParams { pkg: string }\n\nexport const genDocs = ({ pkg, incremental }: GenDocsParams) => {\n  return pkg ? genDocsPackage({ pkg }) : genDocsAll({ incremental })\n}\n\nexport const genDocsPackage = ({ pkg }: GenDocsPackageParams) => {\n  const steps: ScriptStep[] = [['yarn', ['workspace', pkg, 'run', 'package-gen-docs']]]\n\n  return runSteps(`GenDocs [${pkg}]`, [...steps])\n}\n\nexport const genDocsAll = ({ incremental }: GenDocsParams) => {\n  const incrementalOptions = incremental ? ['--since', '-pA'] : ['-pA']\n  const steps: ScriptStep[] = [['yarn', ['workspaces', 'foreach', ...incrementalOptions, 'run', 'package-gen-docs']]]\n\n  return runSteps(`GenDocs [All${incremental ? '-Incremental' : ''}]`, [...steps])\n}\n"],"mappings":"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","names":["chalk","ex","ex","error","chalk","chalk","chalk"]}

package/dist/actions/index.mjs

@@ -20,7 +20,7 @@ import { createRequire } from "module";
 import PATH from "path";
 var require2 = createRequire(import.meta.url);
 var packageRoot = PATH.dirname(require2.resolve("@xylabs/ts-scripts-yarn3/package.json"));
-var templatesDir = PATH.resolve(packageRoot, "templates");
+var templatesDir = PATH.resolve(packageRoot, "templates", "claude");
 var XYLABS_RULES_PREFIX = "xylabs-";
 var XYLABS_COMMANDS_PREFIX = "xylabs-";
 var claudeMdRuleTemplates = () => {
@@ -323,10 +323,19 @@ var generateIgnoreFiles = (filename3, pkg) => {
 
 // src/lib/generateReadmeFiles.ts
 import { execSync as execSync2 } from "child_process";
-import FS from "fs";
-import { readFile, writeFile } from "fs/promises";
+import FS, { readFileSync as readFileSync3 } from "fs";
+import {
+  mkdir,
+  readFile,
+  writeFile
+} from "fs/promises";
+import { createRequire as createRequire2 } from "module";
 import PATH2 from "path";
+import { createInterface } from "readline";
 import chalk5 from "chalk";
+var require3 = createRequire2(import.meta.url);
+var packageRoot2 = PATH2.dirname(require3.resolve("@xylabs/ts-scripts-yarn3/package.json"));
+var readmeTemplatesDir = PATH2.resolve(packageRoot2, "templates", "readme");
 function fillTemplate(template, data) {
   const additionalData = { ...data, safeName: data.name.replaceAll("/", "__").replaceAll("@", "") };
   return template.replaceAll(/\{\{(.*?)\}\}/g, (_, key) => additionalData[key.trim()] ?? "");
@@ -416,37 +425,120 @@ ${indent}### ${item.name}
   }
   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 = readFileSync3(PATH2.resolve(readmeTemplatesDir, "README.template.md"), "utf8");
+var DEFAULT_README_BODY = readFileSync3(PATH2.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 cwd5 = INIT_CWD() ?? ".";
+  return templatePath ?? PATH2.join(cwd5, ".xy", "README.template.md");
+}
+async function loadOrCreateTemplate(resolvedTemplatePath) {
+  try {
+    const template = await readFile(resolvedTemplatePath, "utf8");
+    return { created: false, template };
+  } catch {
+    console.log(chalk5.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 = PATH2.dirname(resolvedTemplatePath);
+  await mkdir(xyDir, { recursive: true });
+  await writeFile(resolvedTemplatePath, template);
+  console.log(chalk5.green(`Created template: ${resolvedTemplatePath}`));
+  const bodyPath = PATH2.join(xyDir, "README.body.md");
+  await writeFile(bodyPath, DEFAULT_README_BODY);
+  console.log(chalk5.green(`Created body template: ${bodyPath}`));
+}
+async function resolveBody(location, defaultBody) {
+  const localBodyPath = PATH2.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 = PATH2.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(PATH2.join(location, "README.md"), readmeContent);
+    if (verbose) console.log(chalk5.green(`  ${name}`));
+    return true;
+  } catch (ex) {
+    const error = ex;
+    console.warn(chalk5.yellow(`  Skipped ${location}: ${error.message}`));
+    return false;
+  }
+}
 async function generateReadmeFiles({
+  logoLinkUrl,
+  logoUrl,
   pkg,
   templatePath,
   typedoc = false,
-  verbose
+  verbose = false
 }) {
   console.log(chalk5.green("Generate README Files"));
-  const cwd5 = INIT_CWD() ?? ".";
-  const resolvedTemplatePath = templatePath ?? PATH2.join(cwd5, "scripts", "README.template.md");
+  const resolvedTemplatePath = resolveTemplatePath(templatePath);
   let template;
+  let templateCreated;
   try {
-    template = await readFile(resolvedTemplatePath, "utf8");
+    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath));
   } catch {
-    console.error(chalk5.red(`Template not found: ${resolvedTemplatePath}`));
     return 1;
   }
-  const workspaces = pkg ? [yarnWorkspace(pkg)] : yarnWorkspaces();
+  template = applyLogoConfig(template, logoUrl, logoLinkUrl);
+  if (templateCreated) {
+    console.log(chalk5.green("Generating README files for all packages..."));
+  }
+  const xyDir = PATH2.dirname(resolvedTemplatePath);
+  const xyBodyPath = PATH2.join(xyDir, "README.body.md");
+  let defaultBody;
+  try {
+    defaultBody = await readFile(xyBodyPath, "utf8");
+  } catch {
+    defaultBody = DEFAULT_README_BODY;
+  }
+  const workspaces = pkg && !templateCreated ? [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;
-    }
+    const success = await generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose);
+    if (!success) failed = true;
   }
   return failed ? 1 : 0;
 }
@@ -473,10 +565,10 @@ var loadConfig = async (params) => {
 };
 
 // src/lib/parsedPackageJSON.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 var parsedPackageJSON = (path14) => {
   const pathToPackageJSON = path14 ?? process.env.npm_package_json ?? "";
-  const packageJSON = readFileSync3(pathToPackageJSON).toString();
+  const packageJSON = readFileSync4(pathToPackageJSON).toString();
   return JSON.parse(packageJSON);
 };
 
@@ -591,7 +683,7 @@ import {
   existsSync as existsSync4,
   mkdirSync,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync4,
+  readFileSync as readFileSync5,
   unlinkSync,
   writeFileSync as writeFileSync2
 } from "fs";
@@ -604,7 +696,7 @@ var syncCommandFiles = (commandsDir) => {
   let created = 0;
   for (const [filename3, content] of Object.entries(templates)) {
     const targetPath = PATH3.resolve(commandsDir, filename3);
-    const existing = existsSync4(targetPath) ? readFileSync4(targetPath, "utf8") : void 0;
+    const existing = existsSync4(targetPath) ? readFileSync5(targetPath, "utf8") : void 0;
     if (existing === content) continue;
     writeFileSync2(targetPath, content, "utf8");
     if (existing) {
@@ -661,7 +753,7 @@ import {
   existsSync as existsSync5,
   mkdirSync as mkdirSync2,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync3
 } from "fs";
@@ -674,7 +766,7 @@ var syncRuleFiles = (rulesDir) => {
   let created = 0;
   for (const [filename3, content] of Object.entries(templates)) {
     const targetPath = PATH4.resolve(rulesDir, filename3);
-    const existing = existsSync5(targetPath) ? readFileSync5(targetPath, "utf8") : void 0;
+    const existing = existsSync5(targetPath) ? readFileSync6(targetPath, "utf8") : void 0;
     if (existing === content) continue;
     writeFileSync3(targetPath, content, "utf8");
     if (existing) {
@@ -746,7 +838,7 @@ import {
   writeFileSync as writeFileSync4
 } from "fs";
 import PATH5 from "path";
-import { createInterface } from "readline";
+import { createInterface as createInterface2 } from "readline";
 import chalk12 from "chalk";
 var DEFAULT_SETTINGS = {
   permissions: {
@@ -781,8 +873,8 @@ var DEFAULT_SETTINGS = {
     ]
   }
 };
-function askConfirmation(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
+function askConfirmation2(question) {
+  const rl = createInterface2({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
     rl.question(question, (answer) => {
       rl.close();
@@ -796,7 +888,7 @@ async function claudeSettings() {
   const settingsPath = PATH5.resolve(claudeDir, "settings.local.json");
   mkdirSync3(claudeDir, { recursive: true });
   if (existsSync6(settingsPath)) {
-    const confirmed = await askConfirmation(
+    const confirmed = await askConfirmation2(
       chalk12.yellow(`${settingsPath} already exists. Replace it? (y/N) `)
     );
     if (!confirmed) {
@@ -1148,6 +1240,9 @@ function getImportsFromFile(filePath, importPaths, typeImportPaths) {
     ts.forEachChild(node, visit);
   }
   visit(sourceFile);
+  for (const ref of sourceFile.typeReferenceDirectives) {
+    typeImports.push(ref.fileName);
+  }
   const importsStartsWithExcludes = [".", "#", "node:"];
   const isValidImport = (imp) => !importsStartsWithExcludes.some((exc) => imp.startsWith(exc)) && !imp.includes("*") && !imp.includes("!");
   const cleanedImports = imports.filter(isValidImport).map(getBasePackageName);
@@ -1719,11 +1814,11 @@ var deplint = async ({
 };
 
 // src/actions/deploy.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
 var privatePackageExcludeList = () => {
   const possibleDeployablePackages = yarnWorkspaces().map((workspace) => [
     workspace,
-    JSON.parse(readFileSync6(`${workspace.location}/package.json`, { encoding: "utf8" }))
+    JSON.parse(readFileSync7(`${workspace.location}/package.json`, { encoding: "utf8" }))
   ]);
   const privatePackages = possibleDeployablePackages.filter(([_, pkg]) => pkg.private).map(([workspace]) => workspace);
   const excludeList = privatePackages.map((workspace) => `--exclude ${workspace.name}`);
@@ -1743,11 +1838,11 @@ var deploy = () => {
 };
 
 // src/actions/deploy-major.ts
-import { readFileSync as readFileSync7 } from "fs";
+import { readFileSync as readFileSync8 } from "fs";
 var privatePackageExcludeList2 = () => {
   const possibleDeployablePackages = yarnWorkspaces().map((workspace) => [
     workspace,
-    JSON.parse(readFileSync7(`${workspace.location}/package.json`, { encoding: "utf8" }))
+    JSON.parse(readFileSync8(`${workspace.location}/package.json`, { encoding: "utf8" }))
   ]);
   const privatePackages = possibleDeployablePackages.filter(([_, pkg]) => pkg.private).map(([workspace]) => workspace);
   const excludeList = privatePackages.map((workspace) => `--exclude ${workspace.name}`);
@@ -1767,11 +1862,11 @@ var deployMajor = () => {
 };
 
 // src/actions/deploy-minor.ts
-import { readFileSync as readFileSync8 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 var privatePackageExcludeList3 = () => {
   const possibleDeployablePackages = yarnWorkspaces().map((workspace) => [
     workspace,
-    JSON.parse(readFileSync8(`${workspace.location}/package.json`, { encoding: "utf8" }))
+    JSON.parse(readFileSync9(`${workspace.location}/package.json`, { encoding: "utf8" }))
   ]);
   const privatePackages = possibleDeployablePackages.filter(([_, pkg]) => pkg.private).map(([workspace]) => workspace);
   const excludeList = privatePackages.map((workspace) => `--exclude ${workspace.name}`);
@@ -1791,11 +1886,11 @@ var deployMinor = () => {
 };
 
 // src/actions/deploy-next.ts
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 var privatePackageExcludeList4 = () => {
   const possibleDeployablePackages = yarnWorkspaces().map((workspace) => [
     workspace,
-    JSON.parse(readFileSync9(`${workspace.location}/package.json`, { encoding: "utf8" }))
+    JSON.parse(readFileSync10(`${workspace.location}/package.json`, { encoding: "utf8" }))
   ]);
   const privatePackages = possibleDeployablePackages.filter(([_, pkg]) => pkg.private).map(([workspace]) => workspace);
   const excludeList = privatePackages.map((workspace) => `--exclude ${workspace.name}`);
@@ -2839,7 +2934,10 @@ async function readmeGen({
   typedoc,
   verbose
 }) {
+  const config2 = await loadConfig();
   return await generateReadmeFiles({
+    logoLinkUrl: config2.readme?.logoLinkUrl,
+    logoUrl: config2.readme?.logoUrl,
     pkg,
     templatePath,
     typedoc,
@@ -2847,6 +2945,15 @@ async function readmeGen({
   });
 }
 
+// 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;
+}
+
 // src/actions/rebuild.ts
 var rebuild = ({ target }) => {
   return runSteps("Rebuild", [
@@ -3003,8 +3110,8 @@ var relintAllPackages = ({ fix: fix2 = false } = {}) => {
 // src/actions/retest.ts
 var retest = () => {
   return runSteps("Test", [
-    ["yarn", ["jest", "--clearCache"]],
-    ["yarn", ["jest", "."]]
+    ["yarn", ["vitest", "--clearCache"]],
+    ["yarn", ["vitest", "."]]
   ]);
 };
 
@@ -3119,6 +3226,7 @@ export {
   publintPackage,
   publish,
   readmeGen,
+  readmeInit,
   rebuild,
   recompile,
   recompileAll,