copilotkit__copilotkit/docs/lib/snippet-toc.ts

import { getTableOfContents } from "fumadocs-core/content/toc";
import fs from "fs";
import path from "path";

/**
 * Extracts table of contents from snippet files referenced in page content
 * Handles nested imports and excludes frontmatter
 */
async function extractSnippetTOC(
  content: string,
  processed = new Set<string>(),
): Promise<any[]> {
  const toc: any[] = [];
  const importPattern =
    /import\s+\w+\s+from\s+["']@\/snippets\/([^"']+)\.mdx["']/g;

  for (const match of content.matchAll(importPattern)) {
    const snippetPath = path.join(process.cwd(), "snippets", `${match[1]}.mdx`);

    if (processed.has(snippetPath)) continue;
    processed.add(snippetPath);

    try {
      const snippetContent = fs.readFileSync(snippetPath, "utf-8");
      const contentOnly = snippetContent.replace(/^---\n[\s\S]*?\n---\n/, "");

      // Extract headers from this snippet
      const snippetTOC = await getTableOfContents(contentOnly);
      toc.push(...snippetTOC);

      // Process nested imports
      const nestedTOC = await extractSnippetTOC(snippetContent, processed);
      toc.push(...nestedTOC);
    } catch {
      // Silently skip missing files
    }
  }

  return toc;
}

/**
 * Gets snippet TOC for a specific page by reading its source file
 */
export async function getSnippetTOCForPage(slug?: string[]): Promise<any[]> {
  if (!slug) return [];

  const possiblePaths = [
    // Standard locations
    path.join(process.cwd(), "content/docs", ...slug, "index.mdx"),
    path.join(process.cwd(), "content/docs", ...slug) + ".mdx",
    // Root-collection locations (e.g. content/docs/(root)/page.mdx)
    path.join(process.cwd(), "content/docs", "(root)", ...slug, "index.mdx"),
    path.join(process.cwd(), "content/docs", "(root)", ...slug) + ".mdx",
  ];

  for (const filePath of possiblePaths) {
    try {
      const content = fs.readFileSync(filePath, "utf-8");
      return await extractSnippetTOC(content);
    } catch {
      continue;
    }
  }

  return [];
}