Function run

docs/scripts/generate-docs.ts:11–26

(cmd: string, opts: RunOpts = {})

type RunOpts = { cwd?: string; inherit?: boolean };
function run(cmd: string, opts: RunOpts = {}) {
  const exOpts: ExecSyncOptions = {
    cwd: opts.cwd,
    stdio: opts.inherit ? "inherit" : "pipe",
    encoding: "utf8",
  };
  try {
    const res = execSync(cmd, exOpts);
    if (opts.inherit) return "";
    if (typeof res === "string") return res.trim();
    return (res?.toString?.("utf8") ?? "").trim();
  } catch (err: unknown) {
    const msg = err instanceof Error ? err.message : String(err);
    throw new Error(`Command failed: ${cmd}\n${msg}`);
  }
}

const ensureDir = (p: string) => mkdirSync(p, { recursive: true });
const resetDir = (p: string) => { if (existsSync(p)) rmSync(p, { recursive: true, force: true }); ensureDir(p); };