@open-press/cli 0.5.0 → 0.7.0

package/template/core/engine/page-renderer.mjs

@@ -1,217 +0,0 @@
-const TOC_ENTRIES_PER_PAGE = 24;
-
-function renderPageShell(sectionClass, bodyHtml, attrs = "", { kind, footer = true } = {}) {
-  const className = footer === false ? addClass(sectionClass, "no-footer") : sectionClass;
-  const attrsPart = pageAttrs(attrs, { kind, footer });
-  const footerHtml = footer === false ? "" : `
-    <footer class="page-footer" aria-hidden="true"></footer>`;
-  return `<section class="${className}"${attrsPart}>
-  <div class="page-frame">
-    <header class="page-header" aria-hidden="true"></header>
-    <main class="page-body">
-${bodyHtml.trim()}
-    </main>${footerHtml}
-  </div>
-</section>`;
-}
-
-export function renderToc({ title, items, className } = {}) {
-  const headingText = typeof title === "string" && title.trim() ? title.trim() : "Contents";
-  const tocItems = Array.isArray(items) ? items : [];
-  const tocChunks = tocItems.length > 0 ? chunkArray(tocItems, TOC_ENTRIES_PER_PAGE) : [[]];
-
-  return tocChunks.map((chunk, pageIndex) => {
-    const isContinuation = pageIndex > 0;
-    const pageId = pageIndex === 0 ? "toc" : `toc-${String(pageIndex + 1).padStart(2, "0")}`;
-    const headingId = pageIndex === 0 ? "toc-title" : `${pageId}-title`;
-    const pageHeadingText = isContinuation ? tocContinuationTitle(headingText) : headingText;
-    const headingClass = isContinuation ? ` class="toc-heading toc-heading--continuation"` : ` class="toc-heading"`;
-    const tocList = chunk.length > 0
-      ? `
-  <ol class="toc-list">
-${chunk.map((item, index) => {
-  const level = item.level === 3 ? 3 : 2;
-  const absoluteIndex = pageIndex * TOC_ENTRIES_PER_PAGE + index;
-  const label = item.label || (level === 2 ? `#${absoluteIndex + 1}` : "");
-  const targetPageIndex = Math.max(0, Number(item.pageNumber || 1) - 1);
-  return `    <li class="toc-level-${level}"><a href="#${escapeAttr(item.id)}" data-openpress-anchor="${escapeAttr(item.id)}" data-openpress-target-page-index="${targetPageIndex}"><span class="toc-index" data-toc-index="${escapeAttr(label)}">${escapeHtml(label)}</span><span class="toc-title">${escapeHtml(item.title)}</span><span class="toc-page">${String(item.pageNumber).padStart(2, "0")}</span></a></li>`;
-}).join("\n")}
-  </ol>
-`
-      : "";
-    return renderPageShell(
-      tocPageClassName(className, isContinuation),
-      `
-  <h2 id="${headingId}"${headingClass}>${escapeHtml(pageHeadingText)}</h2>
-${tocList}
-`,
-      [
-        `id="${pageId}"`,
-        `data-page-title="${escapeAttr(headingText)}"`,
-        `data-toc-continuation="${isContinuation ? "true" : "false"}"`,
-        `aria-labelledby="${headingId}"`,
-      ].filter(Boolean).join(" "),
-      { kind: "toc", footer: false },
-    );
-  }).join("\n\n");
-}
-
-function tocContinuationTitle(title) {
-  return title === "目錄" ? "目錄續" : `${title} continued`;
-}
-
-function pageAttrs(attrs, { kind, footer } = {}) {
-  const parts = [];
-  if (attrs.trim()) parts.push(attrs.trim());
-  if (kind && !hasAttr(attrs, "data-page-kind")) parts.push(`data-page-kind="${escapeAttr(kind)}"`);
-  if (footer === false && !hasAttr(attrs, "data-page-footer")) parts.push('data-page-footer="false"');
-  return parts.length ? ` ${parts.join(" ")}` : "";
-}
-
-function hasAttr(attrs, name) {
-  return new RegExp(`\\b${name}=`).test(attrs);
-}
-
-function addClass(className, extraClass) {
-  const classes = className.split(/\s+/).filter(Boolean);
-  if (!classes.includes(extraClass)) classes.push(extraClass);
-  return classes.join(" ");
-}
-
-export function injectStaticToc(pages) {
-  const tocItems = collectTocItems(pages);
-  if (tocItems.length === 0) return pages;
-  const tocIndex = pages.findIndex((page) => hasPageKind(page.match(/^<section[^>]*>/i)?.[0] ?? "", "toc"));
-  const tocPageCount = Math.max(1, Math.ceil(tocItems.length / TOC_ENTRIES_PER_PAGE));
-  const tocPageNumber = tocIndex + 1;
-  const adjustedTocItems = tocPageCount > 1 && tocIndex >= 0
-    ? tocItems.map((item) => ({
-      ...item,
-      pageNumber: item.pageNumber > tocPageNumber ? item.pageNumber + tocPageCount - 1 : item.pageNumber,
-    }))
-    : tocItems;
-
-  return pages.map((page) => {
-    const openingTag = page.match(/^<section[^>]*>/i)?.[0] ?? "";
-    if (!hasPageKind(openingTag, "toc")) return page;
-    const title = extractAttr(openingTag, "data-page-title");
-    return renderToc({ title, items: adjustedTocItems, className: extractAttr(openingTag, "class") });
-  });
-}
-
-function tocPageClassName(className, isContinuation) {
-  const classes = new Set(String(className || "reader-page reader-page--toc").split(/\s+/).filter(Boolean));
-  classes.delete("toc");
-  classes.add("reader-page");
-  classes.add("reader-page--toc");
-  if (isContinuation) classes.add("toc-continuation");
-  else classes.delete("toc-continuation");
-  return [...classes].join(" ");
-}
-
-function extractAttr(openingTag, name) {
-  const re = new RegExp(`${name}="([^"]*)"`);
-  return openingTag.match(re)?.[1];
-}
-
-function collectTocItems(pages) {
-  const items = [];
-  let chapterIndex = 0;
-  let sectionIndex = 0;
-  let pendingChapterOpener;
-
-  pages.forEach((page, index) => {
-    const openingTag = page.match(/^<section[^>]*>/i)?.[0] ?? "";
-    if (hasPageKind(openingTag, "chapter-opener")) {
-      pendingChapterOpener = extractChapterOpenerTarget(page, index);
-      return;
-    }
-
-    if (!hasContentPageKind(openingTag)) return;
-
-    let pageStartedChapter = false;
-    const headings = [...page.matchAll(/<h([23])\b[^>]*\bid="([^"]+)"[^>]*>([\s\S]*?)<\/h\1>/gi)];
-    headings.forEach((heading) => {
-      const level = Number(heading[1]);
-      if (level === 2) {
-        const opener = pendingChapterOpener;
-        pendingChapterOpener = undefined;
-        pageStartedChapter = true;
-        chapterIndex += 1;
-        sectionIndex = 0;
-        items.push({
-          id: opener?.id ?? heading[2],
-          title: htmlToText(heading[3]),
-          pageNumber: opener?.pageNumber ?? index + 1,
-          level: 2,
-          label: `#${chapterIndex}`,
-        });
-        return;
-      }
-
-      if (level === 3 && chapterIndex > 0) {
-        sectionIndex += 1;
-        items.push({
-          id: heading[2],
-          title: htmlToText(heading[3]),
-          pageNumber: index + 1,
-          level: 3,
-          label: `${chapterIndex}.${sectionIndex}`,
-        });
-      }
-    });
-    if (!pageStartedChapter) pendingChapterOpener = undefined;
-  });
-  return items;
-}
-
-function extractChapterOpenerTarget(page, index) {
-  const heading = page.match(/<h2\b[^>]*\bid="([^"]+)"[^>]*>([\s\S]*?)<\/h2>/i);
-  if (!heading?.[1]) return undefined;
-  return {
-    id: heading[1],
-    pageNumber: index + 1,
-  };
-}
-
-function htmlToText(html) {
-  return html
-    .replace(/<[^>]+>/g, "")
-    .replaceAll("&nbsp;", " ")
-    .replaceAll("&amp;", "&")
-    .replaceAll("&lt;", "<")
-    .replaceAll("&gt;", ">")
-    .replaceAll("&quot;", '"')
-    .trim();
-}
-
-function hasPageKind(openingTag, kind) {
-  return extractAttr(openingTag, "data-page-kind") === kind;
-}
-
-function hasContentPageKind(openingTag) {
-  return extractAttr(openingTag, "data-page-kind") === "content";
-}
-
-function escapeAttr(value) {
-  return String(value)
-    .replaceAll("&", "&amp;")
-    .replaceAll('"', "&quot;")
-    .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;");
-}
-
-function escapeHtml(value) {
-  return String(value)
-    .replaceAll("&", "&amp;")
-    .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;");
-}
-
-function chunkArray(items, size) {
-  const chunks = [];
-  for (let index = 0; index < items.length; index += size) {
-    chunks.push(items.slice(index, index + size));
-  }
-  return chunks;
-}

package/template/core/engine/react/migrate-to-react.mjs

@@ -1,355 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import yaml from "js-yaml";
-
-const SHELL_KINDS = new Set(["cover", "toc", "back-cover"]);
-
-export async function migrateLegacyWorkspaceToReact(root, config, { dryRun = false, force = false } = {}) {
-  const migration = await planLegacyWorkspaceMigration(root, config, { force });
-  if (!dryRun) {
-    await applyMigrationPlan(migration, { force });
-  }
-  return {
-    kind: "migrate-to-react",
-    dryRun,
-    sourceFiles: migration.sourceFiles.length,
-    files: migration.actions.map(({ absolutePath, action }) => ({
-      path: rootRelative(root, absolutePath),
-      action,
-    })),
-  };
-}
-
-async function planLegacyWorkspaceMigration(root, config, { force = false } = {}) {
-  const sourceFiles = await collectLegacyContentFiles(config.paths.sourceDir);
-  const parsedFiles = await Promise.all(sourceFiles.map(async (filePath) => {
-    const text = await fs.readFile(filePath, "utf8");
-    const [meta, body] = parseFrontmatter(text);
-    const fileName = path.basename(filePath);
-    return {
-      filePath,
-      fileName,
-      meta,
-      body,
-      kind: normalizedKind(meta.kind),
-      slug: slugValue(meta.slug) ?? slugFromFileName(fileName),
-      title: stringValue(meta.title),
-      chapter: numberValue(meta.chapter),
-    };
-  }));
-
-  const documentRoot = path.join(path.resolve(root), "document");
-  const chaptersRoot = path.join(documentRoot, "chapters");
-  const shell = Object.fromEntries(SHELL_KINDS.values().map((kind) => [kind, null]));
-  const chapterStates = new Map();
-  let chapterCounter = 0;
-
-  for (const file of parsedFiles) {
-    if (SHELL_KINDS.has(file.kind)) {
-      shell[file.kind] ??= file;
-      continue;
-    }
-
-    const chapter = file.chapter ?? (chapterCounter + 1);
-    if (file.kind !== "chapter-opener") {
-      chapterCounter = Math.max(chapterCounter, chapter);
-    }
-    const slug = file.slug || `chapter-${chapter}`;
-    const key = `${chapter}:${slug}`;
-    const current = chapterStates.get(key) ?? {
-      chapter,
-      slug,
-      title: file.title ?? titleFromSlug(slug),
-      opener: null,
-      contentFiles: [],
-    };
-    current.title = file.title ?? current.title;
-    if (file.kind === "chapter-opener") current.opener = file;
-    else current.contentFiles.push(file);
-    chapterStates.set(key, current);
-  }
-
-  const actions = [];
-  const add = (absolutePath, content, action = "write") => actions.push({ absolutePath, content, action });
-  const addCopy = (source, absolutePath) => {
-    if (samePath(source, absolutePath)) return;
-    actions.push({ source, absolutePath, action: "copy" });
-  };
-  const addDir = (absolutePath) => actions.push({ absolutePath, action: "mkdir" });
-
-  addDir(documentRoot);
-  add(path.join(documentRoot, "index.tsx"), renderDocumentIndex(config, shell));
-  addCopy(config.paths.designDoc, path.join(documentRoot, "design.md"));
-  addCopy(config.paths.themeDir, path.join(documentRoot, "theme"));
-  addCopy(config.paths.mediaDir, path.join(documentRoot, "media"));
-  addCopy(config.paths.componentsDir, path.join(documentRoot, "components"));
-
-  const chapters = Array.from(chapterStates.values()).sort((a, b) => {
-    if (a.chapter !== b.chapter) return a.chapter - b.chapter;
-    return a.slug.localeCompare(b.slug);
-  });
-
-  for (const chapterState of chapters) {
-    const chapterDir = path.join(chaptersRoot, chapterDirectoryName(chapterState.chapter, chapterState.slug));
-    const contentDir = path.join(chapterDir, "content");
-    addDir(contentDir);
-    if (chapterState.opener) {
-      add(path.join(chapterDir, "chapter.tsx"), renderChapterFile(chapterState));
-    }
-    chapterState.contentFiles.forEach((file, index) => {
-      const contentName = `${String(index + 1).padStart(2, "0")}-${file.slug || chapterState.slug}.mdx`;
-      add(path.join(contentDir, contentName), normalizeMdxBody(file.body));
-    });
-  }
-
-  await assertWritable(actions, { force });
-  return { sourceFiles: parsedFiles, actions };
-}
-
-async function applyMigrationPlan(migration, { force = false } = {}) {
-  for (const item of migration.actions) {
-    if (item.action === "mkdir") {
-      await fs.mkdir(item.absolutePath, { recursive: true });
-    } else if (item.action === "write") {
-      await fs.mkdir(path.dirname(item.absolutePath), { recursive: true });
-      if (!force) await assertMissing(item.absolutePath);
-      await fs.writeFile(item.absolutePath, item.content, "utf8");
-    } else if (item.action === "copy") {
-      await copyPathIfExists(item.source, item.absolutePath, { force });
-    }
-  }
-}
-
-async function collectLegacyContentFiles(sourceDir) {
-  let entries;
-  try {
-    entries = await fs.readdir(sourceDir, { withFileTypes: true });
-  } catch (error) {
-    if (error?.code === "ENOENT") return [];
-    throw error;
-  }
-
-  return entries
-    .filter((entry) => entry.isFile() && entry.name.endsWith(".md") && !entry.name.startsWith("_"))
-    .map((entry) => path.join(sourceDir, entry.name))
-    .sort((a, b) => path.basename(a).localeCompare(path.basename(b)));
-}
-
-function renderDocumentIndex(config, shell) {
-  const configLines = [
-    `  title: ${jsString(config.title)},`,
-    config.subtitle ? `  subtitle: ${jsString(config.subtitle)},` : null,
-    config.organization ? `  organization: ${jsString(config.organization)},` : null,
-    config.workspaceLabel ? `  workspaceLabel: ${jsString(config.workspaceLabel)},` : null,
-    `  sourceDir: "chapters",`,
-    `  mediaDir: "media",`,
-    `  themeDir: "theme",`,
-    `  designDoc: "design.md",`,
-    `  componentsDir: "components",`,
-    `  publicDir: ${jsString(config.publicDir)},`,
-    `  outputDir: ${jsString(config.outputDir)},`,
-    `  pdf: { filename: ${jsString(config.pdf.filename)} },`,
-    `  deploy: {`,
-    `    adapter: ${jsString(config.deploy.adapter)},`,
-    `    source: ${jsString(config.deploy.source)},`,
-    `    projectName: ${config.deploy.projectName == null ? "null" : jsString(config.deploy.projectName)},`,
-    `    commitDirty: ${config.deploy.commitDirty ? "true" : "false"},`,
-    `    requiresConfirmation: ${config.deploy.requiresConfirmation ? "true" : "false"},`,
-    `  },`,
-  ].filter(Boolean).join("\n");
-
-  return [
-    'import type { Manifest } from "@openpress/core";',
-    'import { BaseBackCoverPage, BaseCoverPage, BaseTocPage } from "@openpress/core";',
-    "",
-    "export const config: Manifest = {",
-    configLines,
-    "};",
-    "",
-    renderShellExport("cover", shell.cover, "cover", "OpenPress"),
-    "",
-    renderTocExport(shell.toc),
-    "",
-    renderShellExport("backCover", shell["back-cover"], "back-cover", "End"),
-    "",
-  ].join("\n");
-}
-
-function renderShellExport(exportName, file, pageKind, fallbackTitle) {
-  const title = file?.title ?? fallbackTitle;
-  const bodyText = summaryText(file?.body);
-  const Page = pageKind === "back-cover" ? "BaseBackCoverPage" : "BaseCoverPage";
-  const mainClass = pageKind === "back-cover" ? "back-cover-main" : "cover-main";
-  const titleClass = pageKind === "back-cover" ? "back-cover-statement" : "cover-title";
-  const summaryClass = pageKind === "back-cover" ? "back-cover-summary" : "cover-summary";
-
-  return `export const ${exportName} = (
-  <${Page} data-page-title="${jsxAttr(title)}">
-    <div className="${mainClass}">
-      <h1 className="${titleClass}">${jsxText(title)}</h1>
-      ${bodyText ? `<p className="${summaryClass}">${jsxText(bodyText)}</p>` : ""}
-    </div>
-  </${Page}>
-);`;
-}
-
-function renderTocExport(file) {
-  const title = file?.title ?? "Contents";
-  return `export const toc = (
-  <BaseTocPage data-page-title="${jsxAttr(title)}" id="toc">
-    <div className="page-frame">
-      <header className="page-header" aria-hidden="true"></header>
-      <main className="page-body">
-        <h2 id="toc-title" className="toc-heading">${jsxText(title)}</h2>
-      </main>
-    </div>
-  </BaseTocPage>
-);`;
-}
-
-function renderChapterFile(chapterState) {
-  const title = chapterState.opener?.title ?? chapterState.title;
-  const label = `Chapter ${chapterState.chapter}`;
-  const summary = summaryText(chapterState.opener?.body);
-  return [
-    "export const meta = {",
-    `  slug: ${jsString(chapterState.slug)},`,
-    `  title: ${jsString(title)},`,
-    `  chapter: ${chapterState.chapter},`,
-    "};",
-    "",
-    "export const opener = (",
-    `  <section className="reader-page reader-page--chapter-opener no-footer" data-page-kind="chapter-opener" data-page-footer="false" data-page-title="${jsxAttr(title)}">`,
-    '    <div className="page-frame">',
-    '      <header className="page-header" aria-hidden="true"></header>',
-    '      <main className="page-body">',
-    `        <p className="chapter-opener-kicker">${jsxText(label)}</p>`,
-    `        <h2 className="chapter-opener-title">${jsxText(title)}</h2>`,
-    summary ? `        <p className="chapter-opener-summary">${jsxText(summary)}</p>` : null,
-    "      </main>",
-    "    </div>",
-    "  </section>",
-    ");",
-    "",
-  ].filter(Boolean).join("\n");
-}
-
-function parseFrontmatter(text) {
-  const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
-  if (!match) return [{}, text];
-  return [yaml.load(match[1]) ?? {}, text.slice(match[0].length)];
-}
-
-function normalizeMdxBody(body) {
-  const normalized = String(body ?? "").replace(/^\s+/, "").replace(/\s+$/, "");
-  return `${normalized}\n`;
-}
-
-function normalizedKind(value) {
-  if (typeof value !== "string" || !value.trim()) return "chapter";
-  return value.trim();
-}
-
-function stringValue(value) {
-  return typeof value === "string" && value.trim() ? value.trim() : null;
-}
-
-function slugValue(value) {
-  return typeof value === "string" && value.trim() ? safeSlug(value.trim()) : null;
-}
-
-function numberValue(value) {
-  return Number.isFinite(value) ? Number(value) : null;
-}
-
-function slugFromFileName(fileName) {
-  return safeSlug(fileName.replace(/\.md$/i, "").replace(/^\d+[-_]?/, "").replace(/-opener$/, ""));
-}
-
-function safeSlug(value) {
-  const slug = value
-    .normalize("NFKD")
-    .replace(/[^\p{Letter}\p{Number}]+/gu, "-")
-    .replace(/^-+|-+$/g, "")
-    .toLowerCase();
-  return slug || "chapter";
-}
-
-function titleFromSlug(slug) {
-  return slug.replace(/[-_]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
-}
-
-function chapterDirectoryName(chapter, slug) {
-  return `${String(chapter).padStart(2, "0")}-${safeSlug(slug)}`;
-}
-
-function summaryText(markdown = "") {
-  const text = String(markdown)
-    .replace(/<[^>]+>/g, " ")
-    .replace(/```[\s\S]*?```/g, " ")
-    .replace(/`([^`]+)`/g, "$1")
-    .replace(/!\[[^\]]*\]\([^)]*\)/g, " ")
-    .replace(/\[([^\]]+)\]\([^)]*\)/g, "$1")
-    .replace(/^#{1,6}\s+/gm, "")
-    .replace(/^[-*+]\s+/gm, "")
-    .replace(/\s+/g, " ")
-    .trim();
-  return text.length > 160 ? `${text.slice(0, 157)}...` : text;
-}
-
-function jsString(value) {
-  return JSON.stringify(String(value ?? ""));
-}
-
-function jsxText(value) {
-  return String(value ?? "")
-    .replaceAll("&", "&amp;")
-    .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;")
-    .replaceAll("{", "&#123;")
-    .replaceAll("}", "&#125;");
-}
-
-function jsxAttr(value) {
-  return jsxText(value).replaceAll('"', "&quot;");
-}
-
-async function assertWritable(actions, { force = false } = {}) {
-  if (force) return;
-  const writeTargets = actions.filter((item) => item.action === "write" || item.action === "copy");
-  for (const item of writeTargets) {
-    await assertMissing(item.absolutePath);
-  }
-}
-
-async function assertMissing(filePath) {
-  try {
-    await fs.access(filePath);
-    throw new Error(`Refusing to overwrite existing path: ${filePath}. Re-run with --force if this is intentional.`);
-  } catch (error) {
-    if (error?.code === "ENOENT") return;
-    throw error;
-  }
-}
-
-async function copyPathIfExists(source, destination, { force = false } = {}) {
-  let stat;
-  try {
-    stat = await fs.stat(source);
-  } catch (error) {
-    if (error?.code === "ENOENT") return;
-    throw error;
-  }
-  await fs.mkdir(path.dirname(destination), { recursive: true });
-  if (force) await fs.rm(destination, { recursive: true, force: true });
-  else await assertMissing(destination);
-  await fs.cp(source, destination, { recursive: stat.isDirectory(), force: true });
-}
-
-function rootRelative(root, absolutePath) {
-  return path.relative(root, absolutePath).replaceAll("\\", "/");
-}
-
-function samePath(left, right) {
-  return path.resolve(left) === path.resolve(right);
-}

package/template/core/engine/source-workspace.mjs

@@ -1,76 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { loadReactDocumentEntry } from "./react/document-entry.mjs";
-
-export const REACT_MDX_CONTENT_EXTENSIONS = new Set([".mdx"]);
-
-export async function resolveActiveSourceWorkspace(config) {
-  const reactEntry = await loadReactDocumentEntry(config.root);
-  if (!reactEntry) {
-    throw new Error(
-      "React/MDX document entry not found. Expected document/index.tsx; run `node engine/cli.mjs migrate-to-react .` before using workspace source tools.",
-    );
-  }
-
-  return {
-    kind: "react-mdx",
-    checkedName: "react-source",
-    config: reactEntry.config,
-    entryPath: reactEntry.entryPath,
-    sourceDir: reactEntry.config.paths.sourceDir,
-    contentExtensions: REACT_MDX_CONTENT_EXTENSIONS,
-    contentLabel: "React MDX chapter source",
-    missingCode: "react-source.missing",
-    emptyCode: "react-source.empty",
-    missingMessage: `React chapter source directory does not exist yet; create ${reactEntry.config.sourceDir}/ before running export.`,
-    emptyMessage: "React chapter source directory has no `*.mdx` files; the document will export with zero chapter pages.",
-  };
-}
-
-export async function collectActiveContentFiles(sourceWorkspace, { skipUnderscoreFiles = false } = {}) {
-  const files = [];
-  await walkFiles(sourceWorkspace.sourceDir, async (absolutePath) => {
-    if (!sourceWorkspace.contentExtensions.has(path.extname(absolutePath))) return;
-    const name = path.basename(absolutePath);
-    if (skipUnderscoreFiles && name.startsWith("_")) return;
-    files.push({
-      absolutePath,
-      name,
-      relativePath: rootRelativePath(sourceWorkspace.config, absolutePath),
-      sourceRelativePath: path.relative(sourceWorkspace.sourceDir, absolutePath).replaceAll("\\", "/"),
-      text: await fs.readFile(absolutePath, "utf8"),
-    });
-  });
-  files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
-  return files;
-}
-
-export async function sourceDirectoryExists(sourceWorkspace) {
-  try {
-    const stat = await fs.stat(sourceWorkspace.sourceDir);
-    return stat.isDirectory();
-  } catch (error) {
-    if (error?.code === "ENOENT") return false;
-    throw error;
-  }
-}
-
-export function rootRelativePath(config, absolutePath) {
-  return path.relative(config.root, absolutePath).replaceAll("\\", "/");
-}
-
-async function walkFiles(directory, visit) {
-  let entries;
-  try {
-    entries = await fs.readdir(directory, { withFileTypes: true });
-  } catch (error) {
-    if (error?.code === "ENOENT") return;
-    throw error;
-  }
-  for (const entry of entries) {
-    if (entry.name.startsWith(".")) continue;
-    const absolutePath = path.join(directory, entry.name);
-    if (entry.isDirectory()) await walkFiles(absolutePath, visit);
-    else if (entry.isFile()) await visit(absolutePath);
-  }
-}