docus 5.10.1 → 5.12.0

package/modules/assistant/runtime/composables/useAssistant.ts

@@ -1,7 +1,7 @@
 import type { UIMessage } from 'ai'
-import { useAppConfig, useRuntimeConfig, useState } from '#imports'
-import { useMediaQuery } from '@vueuse/core'
-import { computed } from 'vue'
+import { useAppConfig, useRuntimeConfig } from '#imports'
+import { createSharedComposable, useLocalStorage } from '@vueuse/core'
+import { computed, ref, watch } from 'vue'
 import type { FaqCategory, FaqQuestions, LocalizedFaqQuestions } from '../types'
 
 function normalizeFaqQuestions(questions: FaqQuestions): FaqCategory[] {
@@ -19,10 +19,7 @@ function normalizeFaqQuestions(questions: FaqQuestions): FaqCategory[] {
   return questions as FaqCategory[]
 }
 
-const PANEL_WIDTH_COMPACT = 360
-const PANEL_WIDTH_EXPANDED = 520
-
-export function useAssistant() {
+export const useAssistant = createSharedComposable(() => {
   const config = useRuntimeConfig()
   const appConfig = useAppConfig()
   const assistantRuntimeConfig = config.public.assistant as { enabled?: boolean } | undefined
@@ -30,26 +27,37 @@ export function useAssistant() {
   const docusRuntimeConfig = appConfig.docus as { locale?: string } | undefined
   const isEnabled = computed(() => assistantRuntimeConfig?.enabled ?? false)
 
-  const isOpen = useState('assistant-open', () => false)
-  const isExpanded = useState('assistant-expanded', () => false)
-  const messages = useState<UIMessage[]>('assistant-messages', () => [])
-  const pendingMessage = useState<string | undefined>('assistant-pending', () => undefined)
+  const storageOpen = useLocalStorage('assistant-open', false)
+  const messages = useLocalStorage<UIMessage[]>('assistant-messages', [])
+
+  const isOpen = ref(false)
+  const isStudioExpanded = ref(false)
 
-  const isMobile = useMediaQuery('(max-width: 767px)')
-  const panelWidth = computed(() => isExpanded.value ? PANEL_WIDTH_EXPANDED : PANEL_WIDTH_COMPACT)
-  const shouldPushContent = computed(() => !isMobile.value && isOpen.value)
+  onNuxtReady(() => {
+    nextTick(() => {
+      isOpen.value = storageOpen.value
+    })
+
+    isStudioExpanded.value = document.body.hasAttribute('data-expand-sidebar')
+    const observer = new MutationObserver(() => {
+      isStudioExpanded.value = document.body.hasAttribute('data-expand-sidebar')
+    })
+    observer.observe(document.body, { attributes: true, attributeFilter: ['data-expand-sidebar'] })
+  })
+
+  watch(isOpen, (value) => {
+    storageOpen.value = value
+  })
 
   const faqQuestions = computed<FaqCategory[]>(() => {
     const faqConfig = assistantConfig?.faqQuestions
     if (!faqConfig) return []
 
-    // Check if it's a localized object (has locale keys like 'en', 'fr')
     if (!Array.isArray(faqConfig)) {
       const localizedConfig = faqConfig as LocalizedFaqQuestions
       const currentLocale = docusRuntimeConfig?.locale || 'en'
       const defaultLocale = config.public.i18n?.defaultLocale || 'en'
 
-      // Try current locale, then default locale, then first available
       const questions = localizedConfig[currentLocale]
         || localizedConfig[defaultLocale]
         || Object.values(localizedConfig)[0]
@@ -61,51 +69,39 @@ export function useAssistant() {
   })
 
   function open(initialMessage?: string, clearPrevious = false) {
+    if (isStudioExpanded.value) return
+
     if (clearPrevious) {
       messages.value = []
     }
 
     if (initialMessage) {
-      pendingMessage.value = initialMessage
+      messages.value = [...messages.value, {
+        id: String(Date.now()),
+        role: 'user' as const,
+        parts: [{ type: 'text' as const, text: initialMessage }],
+      }]
     }
     isOpen.value = true
   }
 
-  function clearPending() {
-    pendingMessage.value = undefined
-  }
-
   function close() {
     isOpen.value = false
   }
 
   function toggle() {
+    if (isStudioExpanded.value) return
     isOpen.value = !isOpen.value
   }
 
-  function clearMessages() {
-    messages.value = []
-  }
-
-  function toggleExpanded() {
-    isExpanded.value = !isExpanded.value
-  }
-
   return {
     isEnabled,
     isOpen,
-    isExpanded,
-    isMobile,
-    panelWidth,
-    shouldPushContent,
+    isStudioExpanded,
     messages,
-    pendingMessage,
     faqQuestions,
     open,
-    clearPending,
     close,
     toggle,
-    toggleExpanded,
-    clearMessages,
   }
-}
+})

package/modules/assistant/runtime/server/api/search.ts

@@ -1,5 +1,5 @@
-import { streamText, convertToModelMessages, createUIMessageStream, createUIMessageStreamResponse } from 'ai'
-import type { UIMessageStreamWriter, ToolCallPart, ToolSet } from 'ai'
+import { streamText, convertToModelMessages } from 'ai'
+import type { ToolSet } from 'ai'
 import { createMCPClient } from '@ai-sdk/mcp'
 import type { H3Event } from 'h3'
 
@@ -23,11 +23,10 @@ function createLocalFetch(event: H3Event): typeof fetch {
 }
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-function stopWhenResponseComplete({ steps }: { steps: any[] }): boolean {
+function stopWhenResponseComplete({ steps }: { steps: { text?: string, toolCalls?: unknown[] }[] }): boolean {
   const lastStep = steps.at(-1)
   if (!lastStep) return false
 
-  // Primary condition: stop when model gives a text response without tool calls
   const hasText = Boolean(lastStep.text && lastStep.text.trim().length > 0)
   const hasNoToolCalls = !lastStep.toolCalls || lastStep.toolCalls.length === 0
 
@@ -57,7 +56,7 @@ function getSystemPrompt(siteName: string) {
 
 **Links and exploration:**
 - Tool results include a \`url\` for each page — prefer markdown links \`[label](url)\` so users can open the doc in one click
-- When it helps, add extra links (related pages, “read more”, side topics) — make the answer easy to dig into, not a wall of text
+- When it helps, add extra links (related pages, "read more", side topics) — make the answer easy to dig into, not a wall of text
 - Stick to URLs from tool results (\`url\` / \`path\`) so links stay valid
 
 **FORMATTING RULES (CRITICAL):**
@@ -85,6 +84,9 @@ export default defineEventHandler(async (event) => {
   const isExternalUrl = mcpServer.startsWith('http://') || mcpServer.startsWith('https://')
   const baseURL = config.app?.baseURL?.replace(/\/$/, '') || ''
 
+  const abortController = new AbortController()
+  event.node.req.on('close', () => abortController.abort())
+
   let transport: Parameters<typeof createMCPClient>[0]['transport']
   if (isExternalUrl) {
     transport = {
@@ -109,41 +111,19 @@ export default defineEventHandler(async (event) => {
   const httpClient = await createMCPClient({ transport })
   const mcpTools = await httpClient.tools()
 
-  const stream = createUIMessageStream({
-    execute: async ({ writer }: { writer: UIMessageStreamWriter }) => {
-      const modelMessages = await convertToModelMessages(messages)
-      const result = streamText({
-        model: config.assistant.model,
-        maxOutputTokens: 4000,
-        maxRetries: 2,
-        stopWhen: stopWhenResponseComplete,
-        system: getSystemPrompt(siteName),
-        messages: modelMessages,
-        tools: mcpTools as ToolSet,
-        onStepFinish: ({ toolCalls }: { toolCalls: ToolCallPart[] }) => {
-          if (toolCalls.length === 0) return
-          writer.write({
-            id: toolCalls[0]?.toolCallId,
-            type: 'data-tool-calls',
-            data: {
-              tools: toolCalls.map((tc: ToolCallPart) => {
-                const args = 'args' in tc ? tc.args : 'input' in tc ? tc.input : {}
-                return {
-                  toolName: tc.toolName,
-                  toolCallId: tc.toolCallId,
-                  args,
-                }
-              }),
-            },
-          })
-        },
-      })
-      writer.merge(result.toUIMessageStream())
-    },
-    onFinish: async () => {
-      await httpClient.close()
-    },
-  })
-
-  return createUIMessageStreamResponse({ stream })
+  const closeMcp = () => event.waitUntil(httpClient.close())
+
+  return streamText({
+    model: config.assistant.model,
+    maxOutputTokens: 4000,
+    maxRetries: 2,
+    abortSignal: abortController.signal,
+    stopWhen: stopWhenResponseComplete,
+    system: getSystemPrompt(siteName),
+    messages: await convertToModelMessages(messages),
+    tools: mcpTools as ToolSet,
+    onFinish: closeMcp,
+    onAbort: closeMcp,
+    onError: closeMcp,
+  }).toUIMessageStreamResponse()
 })

package/modules/config.ts

@@ -5,10 +5,11 @@ import { join } from 'node:path'
 import { inferSiteURL, getPackageJsonMetadata } from '../utils/meta'
 import { getGitBranch, getGitEnv, getLocalGitInfo } from '../utils/git'
 
-const log = logger.withTag('Docus')
+const log = logger.withTag('docus')
 
 type I18nLocale = string | { code: string, name?: string }
 type DocusI18nOptions = { locales?: I18nLocale[], strategy?: string }
+type DocusMcpOptions = { route?: string, enabled?: boolean }
 type RegisterModuleOptions = {
   langDir: string
   locales: Array<{ code: string, name: string, file: string }>
@@ -58,6 +59,16 @@ export default defineNuxtModule({
       branch: getGitBranch(),
     })
 
+    /*
+    ** MCP route (expose to client so the page header dropdown stays in sync
+    ** with the user-configured `mcp.route` from @nuxtjs/mcp-toolkit)
+    */
+    const mcpOptions = (nuxt.options as typeof nuxt.options & { mcp?: DocusMcpOptions }).mcp
+    nuxt.options.runtimeConfig.public.mcp = defu(
+      nuxt.options.runtimeConfig.public.mcp as DocusMcpOptions | undefined,
+      { route: mcpOptions?.route || '/mcp' },
+    )
+
     const forcedColorMode = (nuxt.options.appConfig.docus as Record<string, unknown>)?.colorMode as string | undefined
     if (forcedColorMode === 'light' || forcedColorMode === 'dark') {
       nuxt.options.colorMode = defu({ preference: forcedColorMode, fallback: forcedColorMode }, nuxt.options.colorMode || {}) as typeof nuxt.options.colorMode

package/modules/css.ts

@@ -1,21 +1,37 @@
-import { defineNuxtModule, addTemplate, createResolver } from '@nuxt/kit'
-import { joinURL } from 'ufo'
+import { defineNuxtModule, addTemplate, createResolver, logger } from '@nuxt/kit'
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { resolve } from 'pathe'
 import { resolveModulePath } from 'exsolve'
 
+const log = logger.withTag('docus')
+
 export default defineNuxtModule({
   meta: {
-    name: 'css',
+    name: 'docus-css',
   },
   async setup(_options, nuxt) {
-    const dir = nuxt.options.rootDir
     const resolver = createResolver(import.meta.url)
 
-    const contentDir = joinURL(dir, 'content')
+    const contentDir = resolve(nuxt.options.rootDir, 'content')
     const uiPath = resolveModulePath('@nuxt/ui', { from: import.meta.url, conditions: ['style'] })
     const tailwindPath = resolveModulePath('tailwindcss', { from: import.meta.url, conditions: ['style'] })
     const layerDir = resolver.resolve('../app')
     const assistantDir = resolver.resolve('../modules/assistant')
 
+    let userDocusPath: string | null = resolve(nuxt.options.srcDir, 'app.css')
+    if (existsSync(userDocusPath)) {
+      const userDocusCss = await readFile(userDocusPath, 'utf-8')
+      if (userDocusCss.includes('@import "tailwindcss"')) {
+        nuxt.hook('modules:done', () => {
+          log.warn('`app.css` contains `@import "tailwindcss";` consider removing it to avoid duplicate css.')
+        })
+      }
+    }
+    else {
+      userDocusPath = null
+    }
+
     const cssTemplate = addTemplate({
       filename: 'docus.css',
       getContents: () => {
@@ -25,7 +41,20 @@ export default defineNuxtModule({
 @source "${contentDir.replace(/\\/g, '/')}/**/*";
 @source "${layerDir.replace(/\\/g, '/')}/**/*";
 @source "../../app.config.ts";
-@source "${assistantDir.replace(/\\/g, '/')}/**/*";`
+@source "${assistantDir.replace(/\\/g, '/')}/**/*";
+
+html.dark .shiki span {
+  color: var(--shiki-dark) !important;
+  background-color: var(--shiki-dark-bg) !important;
+  font-style: var(--shiki-dark-font-style) !important;
+  font-weight: var(--shiki-dark-font-weight) !important;
+  text-decoration: var(--shiki-dark-text-decoration) !important;
+}
+
+:root {
+  --ui-container: 90rem;
+}
+` + (userDocusPath ? `\n@import ${JSON.stringify(userDocusPath)};` : '')
       },
     })
 

package/modules/markdown-rewrite.ts

@@ -2,7 +2,7 @@ import { defineNuxtModule, logger } from '@nuxt/kit'
 import { resolve } from 'node:path'
 import { readFile, writeFile } from 'node:fs/promises'
 
-const log = logger.withTag('Docus')
+const log = logger.withTag('docus')
 
 type I18nLocale = string | { code: string }
 type DocusI18nOptions = { locales?: I18nLocale[] }

package/modules/skills/index.ts

@@ -19,7 +19,7 @@ export interface SkillsModuleOptions {
 const SKILL_NAME_REGEX = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/
 const MAX_NAME_LENGTH = 64
 
-const log = logger.withTag('Docus')
+const log = logger.withTag('docus')
 
 const defaults: Required<SkillsModuleOptions> = {
   dir: 'skills',
@@ -38,7 +38,9 @@ export default defineNuxtModule<SkillsModuleOptions>({
     const catalog = await scanSkills(skillsDir)
     if (!catalog.length) return
 
-    log.info(`Found ${catalog.length} agent skill${catalog.length > 1 ? 's' : ''}: ${catalog.map(s => s.name).join(', ')}`)
+    nuxt.hook('modules:done', () => {
+      log.info(`Found ${catalog.length} agent skill${catalog.length > 1 ? 's' : ''}: ${catalog.map(s => s.name).join(', ')}`)
+    })
 
     nuxt.options.runtimeConfig.skills = { catalog }
 

package/nuxt.schema.ts

@@ -297,6 +297,34 @@ export default defineNuxtSchema({
           default: '',
           required: ['', 'light', 'dark'],
         }),
+        shortcuts: group({
+          title: 'Shortcuts',
+          description: 'Keyboard shortcuts configuration.',
+          icon: 'i-lucide-keyboard',
+          fields: {
+            toggleColorMode: field({
+              type: 'string',
+              title: 'Toggle Color Mode',
+              description: 'Shortcut to toggle light and dark mode (e.g., d, meta_d). Leave empty to disable.',
+              icon: 'i-lucide-keyboard',
+              default: 'd',
+            }),
+          },
+        }),
+      },
+    }),
+    search: group({
+      title: 'Search',
+      description: 'Search configuration.',
+      icon: 'i-lucide-search',
+      fields: {
+        fts: field({
+          type: 'boolean',
+          title: 'Full-Text Search',
+          description: 'Use SQLite FTS5 full-text search instead of Fuse.js. Requires @nuxt/content v3.14+.',
+          icon: 'i-lucide-database',
+          default: false,
+        }),
       },
     }),
     assistant: group({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.10.1",
+  "version": "5.12.0",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -23,44 +23,63 @@
     "README.md"
   ],
   "dependencies": {
-    "@ai-sdk/gateway": "^3.0.104",
-    "@ai-sdk/mcp": "^1.0.36",
-    "@ai-sdk/vue": "3.0.168",
-    "@iconify-json/lucide": "^1.2.102",
-    "@iconify-json/simple-icons": "^1.2.79",
-    "@iconify-json/vscode-icons": "^1.2.45",
-    "@nuxt/content": "^3.13.0",
+    "@iconify-json/lucide": "^1.2.111",
+    "@iconify-json/simple-icons": "^1.2.85",
+    "@iconify-json/vscode-icons": "^1.2.53",
+    "@nuxt/content": "^3.14.0",
     "@nuxt/image": "^2.0.0",
-    "@nuxt/kit": "^4.4.2",
-    "@nuxt/ui": "^4.7.1",
-    "@nuxtjs/i18n": "^10.2.4",
-    "@nuxtjs/mcp-toolkit": "^0.13.4",
-    "@nuxtjs/mdc": "^0.21.1",
-    "@nuxtjs/robots": "^6.0.7",
-    "@shikijs/core": "^4.0.2",
-    "@shikijs/engine-javascript": "^4.0.2",
-    "@shikijs/langs": "^4.0.2",
-    "@shikijs/themes": "^4.0.2",
-    "@takumi-rs/core": "^1.0.15",
-    "@vueuse/core": "^14.2.1",
-    "ai": "6.0.168",
+    "@nuxt/kit": "^4.4.7",
+    "@nuxt/ui": "^4.8.1",
+    "@nuxtjs/i18n": "^10.4.0",
+    "@nuxtjs/mcp-toolkit": "^0.17.2",
+    "@nuxtjs/mdc": "^0.22.0",
+    "@nuxtjs/robots": "^6.0.9",
+    "@shikijs/core": "^4.2.0",
+    "@shikijs/engine-javascript": "^4.2.0",
+    "@shikijs/langs": "^4.2.0",
+    "@shikijs/stream": "^4.2.0",
+    "@shikijs/themes": "^4.2.0",
+    "@takumi-rs/core": "^1.6.0",
+    "@vueuse/core": "^14.3.0",
     "defu": "^6.1.7",
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",
     "motion-v": "^2.2.1",
     "nuxt-llms": "^0.2.0",
-    "nuxt-og-image": "^6.4.5",
-    "pkg-types": "^2.3.0",
+    "nuxt-og-image": "^6.5.1",
+    "pathe": "^2.0.3",
+    "pkg-types": "^2.3.1",
     "scule": "^1.3.0",
-    "shiki-stream": "^0.1.4",
-    "tailwindcss": "^4.2.3",
-    "ufo": "^1.6.3",
-    "yaml": "^2.8.3",
-    "zod": "^4.3.6",
+    "tailwindcss": "^4.3.0",
+    "ufo": "^1.6.4",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3",
     "zod-to-json-schema": "^3.25.2"
   },
   "peerDependencies": {
+    "@ai-sdk/gateway": "^3.0.120",
+    "@ai-sdk/mcp": "^1.0.43",
+    "@ai-sdk/vue": "^3.0.191",
+    "@comark/nuxt": "^0.3.1",
+    "ai": "^6.0.191",
     "better-sqlite3": "12.x",
     "nuxt": "4.x"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/gateway": {
+      "optional": true
+    },
+    "@ai-sdk/mcp": {
+      "optional": true
+    },
+    "@ai-sdk/vue": {
+      "optional": true
+    },
+    "@comark/nuxt": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    }
   }
 }

package/server/mcp/tools/get-page.ts

@@ -1,8 +1,9 @@
-import { z } from 'zod'
-import { queryCollection } from '@nuxt/content/server'
 import type { Collections } from '@nuxt/content'
-import { getAvailableLocales, getCollectionFromPath } from '../../utils/content'
+import { queryCollection } from '@nuxt/content/server'
+import { joinURL } from 'ufo'
+import { z } from 'zod'
 import { inferSiteURL } from '../../../utils/meta'
+import { getAvailableLocales, getCollectionFromPath, isNavigationPath } from '../../utils/content'
 
 export default defineMcpTool({
   description: `Retrieves the full content and details of a specific documentation page.
@@ -24,7 +25,9 @@ WORKFLOW: This tool returns the complete page content including title, descripti
     openWorldHint: false,
   },
   inputSchema: {
-    path: z.string().describe('The page path from list-pages or provided by the user (e.g., /en/getting-started/installation)'),
+    path: z.string().describe(
+      'The page path from list-pages or provided by the user (e.g., /en/getting-started/installation)',
+    ),
   },
   inputExamples: [
     { path: '/en/getting-started/installation' },
@@ -32,12 +35,18 @@ WORKFLOW: This tool returns the complete page content including title, descripti
   ],
   cache: '1h',
   handler: async ({ path }) => {
+    if (isNavigationPath(path)) {
+      throw createError({ statusCode: 404, message: 'Page not found' })
+    }
+
     const event = useEvent()
-    const config = useRuntimeConfig(event).public
+    const config = useRuntimeConfig(event)
+    const publicConfig = config.public
     const siteUrl = getRequestURL(event).origin || inferSiteURL()
+    const baseURL = config.app?.baseURL || '/'
 
-    const availableLocales = getAvailableLocales(config)
-    const collectionName = config.i18n?.locales
+    const availableLocales = getAvailableLocales(publicConfig)
+    const collectionName = publicConfig.i18n?.locales
       ? getCollectionFromPath(path, availableLocales)
       : 'docs'
 
@@ -58,7 +67,7 @@ WORKFLOW: This tool returns the complete page content including title, descripti
         path: page.path,
         description: page.description,
         content,
-        url: `${siteUrl}${page.path}`,
+        url: siteUrl ? joinURL(siteUrl, baseURL, page.path) : joinURL(baseURL, page.path),
       }
     }
     catch (error) {

package/server/mcp/tools/list-pages.ts

@@ -1,8 +1,9 @@
-import { z } from 'zod'
-import { queryCollection } from '@nuxt/content/server'
 import type { Collections } from '@nuxt/content'
-import { getCollectionsToQuery, getAvailableLocales } from '../../utils/content'
+import { queryCollection } from '@nuxt/content/server'
+import { joinURL } from 'ufo'
+import { z } from 'zod'
 import { inferSiteURL } from '../../../utils/meta'
+import { getAvailableLocales, getCollectionsToQuery } from '../../utils/content'
 
 export default defineMcpTool({
   description: `Lists all available documentation pages with their categories and basic information.
@@ -39,16 +40,19 @@ OUTPUT: Returns a structured list with:
   cache: '1h',
   handler: async ({ locale }) => {
     const event = useEvent()
-    const config = useRuntimeConfig(event).public
+    const config = useRuntimeConfig(event)
+    const publicConfig = config.public
 
     const siteUrl = getRequestURL(event).origin || inferSiteURL()
-    const availableLocales = getAvailableLocales(config)
+    const baseURL = config.app?.baseURL || '/'
+    const availableLocales = getAvailableLocales(publicConfig)
     const collections = getCollectionsToQuery(locale, availableLocales)
 
     try {
       const allPages = await Promise.all(
         collections.map(async (collectionName) => {
           const pages = await queryCollection(event, collectionName as keyof Collections)
+            .where('path', 'NOT LIKE', '%.navigation')
             .select('title', 'path', 'description')
             .all()
 
@@ -57,7 +61,7 @@ OUTPUT: Returns a structured list with:
             path: page.path,
             description: page.description,
             locale: collectionName.replace('docs_', ''),
-            url: `${siteUrl}${page.path}`,
+            url: siteUrl ? joinURL(siteUrl, baseURL, page.path) : joinURL(baseURL, page.path),
           }))
         }),
       )

package/server/routes/sitemap.xml.ts

@@ -1,6 +1,6 @@
 import { queryCollection } from '@nuxt/content/server'
-import { getAvailableLocales, getCollectionsToQuery } from '../utils/content'
 import { inferSiteURL } from '../../utils/meta'
+import { getAvailableLocales, getCollectionsToQuery, isNavigationPath } from '../utils/content'
 
 interface SitemapUrl {
   loc: string
@@ -27,17 +27,20 @@ export default defineEventHandler(async (event) => {
 
   for (const collection of collections) {
     try {
-      const pages = await (queryCollection as unknown as (event: unknown, collection: string) => { all: () => Promise<Array<Record<string, unknown> & { path?: string }>> })(event, collection).all()
+      const pages = await (queryCollection as unknown as (
+        event: unknown,
+        collection: string,
+      ) => { all: () => Promise<Array<Record<string, unknown> & { path?: string }>> })(event, collection).all()
 
       for (const page of pages) {
-        const meta = page as Record<string, unknown>
+        const meta = page.meta as Record<string, unknown>
         const pagePath = page.path || '/'
 
         // Skip pages with sitemap: false in frontmatter
         if (meta.sitemap === false) continue
 
         // Skip .navigation files (used for navigation configuration)
-        if (pagePath.endsWith('.navigation') || pagePath.includes('/.navigation')) continue
+        if (isNavigationPath(pagePath)) continue
 
         const urlEntry: SitemapUrl = {
           loc: pagePath,

package/server/utils/content.ts

@@ -25,6 +25,10 @@ export function getCollectionsToQuery(locale: string | undefined, availableLocal
     : ['docs']
 }
 
+export function isNavigationPath(path: string): boolean {
+  return path.endsWith('.navigation') || path.includes('/.navigation/')
+}
+
 export function getCollectionFromPath(path: string, availableLocales: string[]): string {
   const pathSegments = path.split('/').filter(Boolean)
   const firstSegment = pathSegments[0]