Function buildRef

docs/scripts/generate-docs.ts:103–140

(ref: string, labelForOutDir: string)

}

function buildRef(ref: string, labelForOutDir: string) {
  const tmpBase = mkdtempSync(resolve(os.tmpdir(), "docs-wt-"));
  const safeLabel = labelForOutDir.replace(/[^\w.-]+/g, "_");
  const worktreePath = resolve(tmpBase, safeLabel);

  run(`git worktree add --detach "${worktreePath}" "${ref}"`, {
    cwd: currentDocsWorkspace,
    inherit: true,
  });

  try {
    const docsWorkspace = docsRelative ? resolve(worktreePath, docsRelative) : worktreePath;

    const rootPkg = existsSync(resolve(worktreePath, "package.json"));
    const rootLock = existsSync(resolve(worktreePath, "pnpm-lock.yaml"));
    if (rootPkg) {
      run(`pnpm install ${rootLock ? "--frozen-lockfile" : "--no-frozen-lockfile"}`, {
        cwd: worktreePath,
        inherit: true,
      });
    }

    const docsPkg = existsSync(resolve(docsWorkspace, "package.json"));
    const docsLock = existsSync(resolve(docsWorkspace, "pnpm-lock.yaml"));
    if (docsPkg && docsLock) {
      run("pnpm install --frozen-lockfile", { cwd: docsWorkspace, inherit: true });
    }

    const outDir = resolve(outputDir, labelForOutDir);
    buildDocs(docsWorkspace, outDir);
  } finally {
    run(`git worktree remove "${worktreePath}" --force`, {
      cwd: currentDocsWorkspace,
      inherit: true,
    });
    rmSync(tmpBase, { recursive: true, force: true });
  }
}

function buildBranch(branch: string, labelForOutDir: string) {
  run(`git fetch --tags --prune origin ${branch}`, {