site: add toggle support to docs navLink

site/src/routes/docs/+layout.svelte

@@ -6,12 +6,14 @@
 {#snippet navLinkSnippet(navLink: NormalizedNavLink)}
   {#if "items" in navLink}
     <li>
-      <span class="label group">{navLink.label}</span>
+      <details open={!navLink.collapsed}>
-      <ul>
+        <summary><span class="label group">{navLink.label}</span></summary>
-        {#each navLink.items as item}
+        <ul>
-          {@render navLinkSnippet(item)}
+          {#each navLink.items as item}
-        {/each}
+            {@render navLinkSnippet(item)}
-      </ul>
+          {/each}
+        </ul>
+      </details>
     </li>
   {:else}
     <li>
@@ -41,4 +43,9 @@
     width: 300px;
     flex: none;
   }
+
+  summary {
+    list-style: none;
+    cursor: pointer;
+  }
 </style>

site/src/routes/docs/+layout.ts

@@ -1,8 +1,8 @@
 import { navLinks } from "./settings";
 import { normalizeNavLinks } from "./utils";
 
-export function load() {
+export async function load() {
   return {
-    navLinks: normalizeNavLinks(navLinks),
+    navLinks: await normalizeNavLinks(navLinks),
   };
 }

site/src/routes/docs/utils.ts

@@ -4,7 +4,7 @@ export const articles = Object.fromEntries(
       content: string;
       frontmatter: Record<string, any>;
       toc: string;
-    }>("./**/*.md", { eager: true }),
+    }>("./**/*.md"),
   ).map(([key, fn]) => [key.slice("./".length, -".md".length), fn]),
 );
 
@@ -13,6 +13,7 @@ export type NavLink =
   | {
       label: string;
       items: NavLink[];
+      collapsed?: boolean;
       badge?: Badge;
     }
   | {
@@ -25,6 +26,7 @@ export type NormalizedNavLink =
   | {
       label: string;
       items: NormalizedNavLink[];
+      collapsed: boolean;
       badge?: NormalizedBadge;
     }
   | {
@@ -40,18 +42,22 @@ export type NormalizedBadge = {
   variant: "caution" | "normal";
 };
 
-export function normalizeNavLinks(navLinks: NavLink[]): NormalizedNavLink[] {
+export async function normalizeNavLinks(
-  return navLinks.map(normalizeNavLink);
+  navLinks: NavLink[],
+): Promise<NormalizedNavLink[]> {
+  return await Promise.all(navLinks.map(normalizeNavLink));
 }
 
-export function normalizeNavLink(navLink: NavLink): NormalizedNavLink {
+export async function normalizeNavLink(
+  navLink: NavLink,
+): Promise<NormalizedNavLink> {
   if (typeof navLink === "string") {
     const article = articles[navLink];
     if (!article) {
       throw new Error(`Doc not found: ${navLink}`);
     }
     return {
-      label: article.frontmatter.title,
+      label: (await article()).frontmatter.title,
       slug: `/docs/${navLink}`,
     };
   }
@@ -63,15 +69,16 @@ export function normalizeNavLink(navLink: NavLink): NormalizedNavLink {
     }
     return {
       ...navLink,
-      label: navLink.label ?? article.frontmatter.title,
+      label: navLink.label ?? (await article()).frontmatter.title,
       badge: normalizeBadge(navLink.badge),
     };
   }
 
   return {
     ...navLink,
+    collapsed: !!navLink.collapsed,
     badge: normalizeBadge(navLink.badge),
-    items: navLink.items.map(normalizeNavLink),
+    items: await Promise.all(navLink.items.map(normalizeNavLink)),
   };
 }