apexdocs.config.ts

import { readFileSync, writeFileSync } from "fs";
import { defineMarkdownConfig, skip } from "@cparra/apexdocs";

export default defineMarkdownConfig({
  sourceDir: "expression-src",
  targetDir: "docs/src/app/docs/api",
  scope: ["global"],
  namespace: "expression",
  transformReference: (reference) => {
    return {
      outputDocPath: reference.outputDocPath.replace(".md", "/page.md"),
      referencePath: reference.referencePath.replace(".md", ""),
    };
  },
  transformReferenceGuide: () => {
    return skip();
  },
  transformDocPage: (docPage) => {
    return {
      frontmatter: {
        nextjs: {
          metadata: {
            title: docPage.source.name,
            description: `Api documentation for the ${ docPage.source.name } ${ docPage.source.type }`,
          }
        }
      },
    };
  },
  transformDocs: (docs) => {
    const navFileContents = readFileSync("docs/src/lib/navigation.json", "utf8");
    const navItems = JSON.parse(navFileContents);
    // Find an object whose title is "Api"
    let apiNavObject = navItems.find((navObject: any) => navObject.title === "Api");
    apiNavObject = apiNavObject ?? { title: "Api", links: [] };

    apiNavObject.links = docs.map((doc) => {
      return {
        title: doc.source.name, href: `/docs/api/${ doc.outputDocPath.replace("page.md", "").replace(/\/$/, "") }`
      };
    });

    // replace the Api object with the new one (or add it if it didn't exist)
    const newNavItems = navItems.filter((navObject: any) => navObject.title !== "Api");
    newNavItems.push(apiNavObject);

    // Write the new navigation.json file
    const newNavFileContents = JSON.stringify(newNavItems, null, 2);
    writeFileSync("docs/src/lib/navigation.json", newNavFileContents);

    return docs;
  },
});