Add initial type modules

Author: nojaf

astro.config.mjs

@@ -7,10 +7,24 @@ const rescriptTM = JSON.parse(
   readFileSync("./docs/assets/rescript.tmLanguage.json", "utf-8"),
 );
 
-const apiSidebarItems = apiModules.map(({ moduleName, link }) => ({
-  label: moduleName,
-  link,
-}));
+const apiSidebarItems = apiModules.map(({ moduleName, link, items }) => {
+  const nestedItems = Object.values(items).map(({ moduleName, link }) => ({
+    label: moduleName,
+    link
+  }));
+
+  return ({
+    label: moduleName,
+    collapsed: true,
+    items: [
+      {
+        label: `Overview`,
+        link
+      },
+      ...nestedItems
+    ]
+  });
+});
 
 export default defineConfig({
   srcDir: "docs",

docs/pages/apidocs/[API].astro

@@ -9,7 +9,7 @@ export async function getStaticPaths() {
   return apiModules.map((apiModule) => {
     return {
       params: {
-        API: apiModule.apiRoute,
+        API: apiModule.apiRouteParameter,
       },
       props: apiModule,
     };

docs/pages/apidocs/[API]/[Module].astro

@@ -0,0 +1,25 @@
+---
+import { apiModules, getDoc } from "../utils";
+// import StarlightPage from "@astrojs/starlight/components/StarlightPage.astro";
+// import { Code } from "@astrojs/starlight/components";
+// import { micromark } from "micromark";
+// import Record from "../../components/record.astro";
+
+export async function getStaticPaths() {
+  return apiModules.flatMap((apiModule) => {
+    return Object.values(apiModule.items).map((typeModule) => {
+      return {
+        params: {
+          API: apiModule.apiRouteParameter,
+          Module: typeModule.apiRouteParameter,
+        },
+        props: { parentModule: apiModule, currentModule: typeModule },
+      };
+    });
+  });
+}
+
+const name = Astro.props.currentModule.moduleName;
+---
+
+<h1>Yupla {name}</h1>

docs/pages/apidocs/utils.js

@@ -1,6 +1,7 @@
 import * as path from "node:path";
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
+import { readdirSync, existsSync } from "fs";
 
 const execAsync = promisify(exec);
 
@@ -15,17 +16,54 @@ export function createModuleLink(moduleName) {
   return `/apidocs/${toKebabCase(moduleName)}`;
 }
 
+function mapTypeModules(parentModuleLink, file) {
+  const folder = file.replace(".res", "");
+
+  if (!existsSync(folder)) {
+    return [];
+  }
+
+  const files = readdirSync(folder);
+  return files
+    .filter((f) => f.endsWith(".res"))
+    .map((file) => {
+      const fullPath = path.join(folder, file);
+
+      const moduleName = file
+        .replace("$", "")
+        .replace(folder, "")
+        .replace(".res", "");
+      const apiRouteParameter = toKebabCase(moduleName);
+      const link = `${parentModuleLink}/${apiRouteParameter}`;
+      const typeName = moduleName[0].toLocaleLowerCase() + moduleName.slice(1);
+
+      return [
+        typeName,
+        {
+          fullPath,
+          moduleName,
+          link,
+          apiRouteParameter,
+        },
+      ];
+    });
+}
+
 function mapRescriptFile(file) {
   const moduleName = path
     .basename(file, ".res")
     .replace("$", "")
     .replace("API", " API");
+  const filePath = path.join(import.meta.dirname, file);
   const link = createModuleLink(moduleName);
+  const items = Object.fromEntries(mapTypeModules(link, filePath));
+
   return {
-    filePath: path.join(import.meta.dirname, file),
+    filePath,
     moduleName,
     link,
-    apiRoute: toKebabCase(moduleName),
+    apiRouteParameter: toKebabCase(moduleName),
+    items,
   };
 }
 

docs/styles/theme.css

@@ -1,6 +1,7 @@
 :root,
 ::backdrop {
   --sl-font: "Inter", "Roboto Mono";
+  --sl-sidebar-width: 23rem;
 }
 
 /*