Add error logging to docs loader for runtime diagnostics

Surfaces parseFrontmatter failures (gray-matter browser compat),
empty glob results, and missing slugs to the console so the real
cause of 'No documentation pages found' is visible in DevTools.

Each doc's title now falls back to slug-derived when frontmatter
fails, so at worst the sidebar still populates with slug-cased
names.

Author: boudydegeer

site/src/lib/docs-content.ts

@@ -81,20 +81,41 @@ export async function buildNavSections(): Promise<NavSection[]> {
 
   navPromise = (async () => {
     const docs = listDocs()
+
+    if (docs.length === 0) {
+      console.warn(
+        '[proofread/docs] import.meta.glob returned no markdown files. ' +
+        'Module keys:',
+        Object.keys(modules),
+      )
+    }
+
     const sources = await Promise.all(
       docs.map(async (doc) => {
-        const source = await doc.load()
-        const { data, content } = parseFrontmatter(source)
-        const slugFallback = doc.slug
-          .split('/')
-          .pop()!
-          .replace(/-/g, ' ')
-          .replace(/\b\w/g, (c) => c.toUpperCase())
-        const title = data.title ?? titleFromSource(content, slugFallback)
+        let title: string
+        let section = ''
+        try {
+          const source = await doc.load()
+          const { data, content } = parseFrontmatter(source)
+          section = data.section ?? ''
+          const slugFallback = doc.slug
+            .split('/')
+            .pop()!
+            .replace(/-/g, ' ')
+            .replace(/\b\w/g, (c) => c.toUpperCase())
+          title = data.title ?? titleFromSource(content, slugFallback)
+        } catch (err) {
+          console.error(`[proofread/docs] Failed to load ${doc.path}:`, err)
+          title = doc.slug
+            .split('/')
+            .pop()!
+            .replace(/-/g, ' ')
+            .replace(/\b\w/g, (c) => c.toUpperCase())
+        }
         return {
           slug: doc.slug,
           title,
-          section: data.section ?? '',
+          section,
         }
       }),
     )

site/src/pages/DocsPage.vue

@@ -61,30 +61,37 @@ async function load(): Promise<void> {
     return
   }
 
-  const source = await loadDoc(current)
-  if (!source) {
+  try {
+    const source = await loadDoc(current)
+    if (!source) {
+      console.warn(`[proofread/docs] No doc matches slug "${current}".`)
+      notFound.value = true
+      title.value = 'Page not found'
+      description.value = SITE_DESCRIPTION
+      return
+    }
+
+    const rendered = await renderMarkdown(source)
+    html.value = rendered.html
+    toc.value = rendered.toc
+    title.value = rendered.title || current
+    description.value = extractDescription(source) || SITE_DESCRIPTION
+
+    const sections = await buildNavSections()
+    const items: NavItem[] = sections.flatMap((s) => s.items)
+    const index = items.findIndex((i) => i.slug === current)
+    if (index > 0) prev.value = items[index - 1]
+    if (index >= 0 && index < items.length - 1) next.value = items[index + 1]
+
+    await nextTick()
+    if (route.hash) {
+      const el = document.querySelector(route.hash)
+      if (el) el.scrollIntoView({ behavior: 'smooth', block: 'start' })
+    }
+  } catch (err) {
+    console.error(`[proofread/docs] Failed to load doc "${current}":`, err)
     notFound.value = true
     title.value = 'Page not found'
-    description.value = SITE_DESCRIPTION
-    return
-  }
-
-  const rendered = await renderMarkdown(source)
-  html.value = rendered.html
-  toc.value = rendered.toc
-  title.value = rendered.title || current
-  description.value = extractDescription(source) || SITE_DESCRIPTION
-
-  const sections = await buildNavSections()
-  const items: NavItem[] = sections.flatMap((s) => s.items)
-  const index = items.findIndex((i) => i.slug === current)
-  if (index > 0) prev.value = items[index - 1]
-  if (index >= 0 && index < items.length - 1) next.value = items[index + 1]
-
-  await nextTick()
-  if (route.hash) {
-    const el = document.querySelector(route.hash)
-    if (el) el.scrollIntoView({ behavior: 'smooth', block: 'start' })
   }
 }