@life-and-dev/mdsite 0.0.12 → 0.0.15

package/mdsite-nuxt/app/components/AppFooter.vue

@@ -8,6 +8,7 @@
     <v-container class="d-flex justify-center align-center">
       <div class="footer-links">
         <v-btn
+          v-if="hasAboutPage"
           :href="aboutLink"
           variant="text"
           color="on-surface-appbar"
@@ -16,9 +17,10 @@
           About
         </v-btn>
 
-        <v-divider vertical class="mx-2" />
+        <v-divider v-if="hasAboutPage && hasDisclaimerPage" vertical class="mx-2" />
 
         <v-btn
+          v-if="hasDisclaimerPage"
           :href="disclaimerLink"
           variant="text"
           color="on-surface-appbar"
@@ -27,7 +29,7 @@
           Disclaimer
         </v-btn>
 
-        <v-divider v-if="editUrl" vertical class="mx-2" />
+        <v-divider v-if="showEditDivider" vertical class="mx-2" />
 
         <v-btn
           v-if="editUrl"
@@ -47,15 +49,26 @@
 
 <script setup lang="ts">
 import { useSourceEdit } from '~/composables/useSourceEdit';
+import { useSearchIndex } from '~/composables/useSearchIndex'
 import { withBasePath } from '../../utils/base-url'
 
 const appBaseURL = useRuntimeConfig().app.baseURL
 const { getEditUrl } = useSourceEdit()
+const { loadSearchIndex } = useSearchIndex()
+const footerPagePaths = ref<string[]>([])
 
 // Generate links to root content files
 const aboutLink = computed(() => withBasePath('/about', appBaseURL))
 const disclaimerLink = computed(() => withBasePath('/disclaimer', appBaseURL))
 const editUrl = computed(() => getEditUrl())
+const hasAboutPage = computed(() => footerPagePaths.value.includes('/about'))
+const hasDisclaimerPage = computed(() => footerPagePaths.value.includes('/disclaimer'))
+const showEditDivider = computed(() => editUrl.value && (hasAboutPage.value || hasDisclaimerPage.value))
+
+onMounted(async () => {
+  const searchIndex = await loadSearchIndex()
+  footerPagePaths.value = searchIndex.map(entry => entry.path)
+})
 </script>
 
 <style scoped>

package/mdsite-nuxt/example.config.yml

@@ -8,7 +8,7 @@ features:
   bibleTooltips: true
   sourceEdit: false
 site:
-  canonical: 'https://life-and-dev.github.io/md-site'
+  canonical: 'https://life-and-dev.github.io/mdsite/'
   name: 'Example Site'
 themes:
   light:

package/mdsite-nuxt/nuxt.config.ts

@@ -48,6 +48,8 @@ export default defineNuxtConfig({
 
   vite: {
     build: {
+      // Disable esbuild CSS minify because it drops semicolons from nested Vuetify @layer rules, causing noisy warnings.
+      cssMinify: false,
       rollupOptions: {
         external: ['fs/promises', 'path']
       }

package/mdsite-nuxt/scripts/generate-indices.test.ts

@@ -0,0 +1,57 @@
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+
+import { generateNavigationJson, generateSearchIndexJson } from './generate-indices.js'
+
+describe('generated content indices', () => {
+  const originalEnv = { ...process.env }
+  let tempDir: string
+  let contentDir: string
+  let publicDir: string
+
+  beforeEach(async () => {
+    process.env = { ...originalEnv }
+    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'mdsite-indices-'))
+    contentDir = path.join(tempDir, 'content')
+    publicDir = path.join(tempDir, 'public')
+    await fs.mkdir(contentDir, { recursive: true })
+    process.env.CONTENT_DIR = contentDir
+    process.env.MDSITE_PUBLIC_DIR = publicDir
+  })
+
+  afterEach(async () => {
+    process.env = { ...originalEnv }
+    await fs.rm(tempDir, { force: true, recursive: true })
+  })
+
+  it('falls back to markdown files when no menu exists', async () => {
+    await fs.writeFile(path.join(contentDir, 'index.md'), '# Home\n\nWelcome home.', 'utf8')
+    await fs.writeFile(path.join(contentDir, 'guide.md'), '# Guide\n\nUseful guide.', 'utf8')
+
+    await generateNavigationJson()
+
+    const navigation = JSON.parse(await fs.readFile(path.join(publicDir, '_navigation.json'), 'utf8'))
+    expect(navigation).toEqual(expect.arrayContaining([
+      expect.objectContaining({ path: '/', title: 'Home' }),
+      expect.objectContaining({ path: '/guide', title: 'Guide' }),
+    ]))
+  })
+
+  it('writes searchable markdown pages with excerpts', async () => {
+    await fs.writeFile(path.join(contentDir, 'guide.md'), '# Guide\n\nUseful guide content for search.', 'utf8')
+
+    await generateSearchIndexJson()
+
+    const searchIndex = JSON.parse(await fs.readFile(path.join(publicDir, '_search-index.json'), 'utf8'))
+    expect(searchIndex).toEqual([
+      expect.objectContaining({
+        excerpt: 'Useful guide content for search.',
+        path: '/guide',
+        title: 'Guide',
+      }),
+    ])
+  })
+})

package/mdsite-nuxt/scripts/generate-indices.ts

@@ -31,6 +31,7 @@ function getSourceDir(): string {
  * Get target public directory
  */
 function getTargetDir(): string {
+    if (process.env.MDSITE_PUBLIC_DIR) return process.env.MDSITE_PUBLIC_DIR
     return path.resolve(__dirname, '..', 'public')
 }
 
@@ -325,6 +326,29 @@ function countNodes(nodes: MinimalTreeNode[]): number {
     return count
 }
 
+async function buildFallbackNavigationTree(sourceDir: string): Promise<MinimalTreeNode[]> {
+    const markdownFiles = await getAllMarkdownFiles(sourceDir)
+    const nodes: MinimalTreeNode[] = []
+
+    for (const [order, filePath] of markdownFiles.sort().entries()) {
+        const content = await fs.readFile(filePath, 'utf-8')
+        const metadata = extractMarkdownMetadata(content)
+        const urlPath = filePathToUrlPath(filePath, sourceDir)
+        const title = metadata.title ?? path.basename(filePath, '.md')
+
+        nodes.push({
+            id: `${urlPath.split('/').filter(Boolean).pop() || 'home'}-${order}`,
+            title,
+            path: urlPath,
+            type: 'link',
+            description: metadata.description,
+            isPrimary: true
+        })
+    }
+
+    return nodes
+}
+
 /**
  * Generate navigation JSON file
  */
@@ -343,9 +367,11 @@ export async function generateNavigationJson() {
     try {
         if (await fs.pathExists(menuPath)) {
             const menuContent = await fs.readFile(menuPath, 'utf-8')
-            const menuItems = parseYaml(menuContent) as MenuItemType[]
-            const result = await processMenuItems(menuItems, '/')
-            tree = result.nodes
+            const menuItems = parseYaml(menuContent) as MenuItemType[] | null
+            if (Array.isArray(menuItems) && menuItems.length > 0) {
+                const result = await processMenuItems(menuItems, '/')
+                tree = result.nodes
+            }
         } else {
             console.warn('⚠️ No _menu.yml or _menu.yaml found at:', menuPath)
         }
@@ -353,6 +379,10 @@ export async function generateNavigationJson() {
         console.error('Error building navigation tree:', error)
     }
 
+    if (tree.length === 0) {
+        tree = await buildFallbackNavigationTree(sourceDir)
+    }
+
     const targetDir = getTargetDir()
     const outputPath = path.join(targetDir, '_navigation.json')
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@life-and-dev/mdsite",
-  "version": "0.0.12",
+  "version": "0.0.15",
   "type": "module",
   "private": false,
   "description": "Local-first CLI that orchestrates mdsite-nuxt",