docus 5.5.1 → 5.6.0

package/app/app.vue

@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { ContentNavigationItem, PageCollections } from '@nuxt/content'
 import * as nuxtUiLocales from '@nuxt/ui/locale'
+import { transformNavigation } from './utils/navigation'
 
 const { seo } = useAppConfig()
 const site = useSiteConfig()
@@ -45,11 +46,7 @@ if (isEnabled.value) {
 }
 
 const { data: navigation } = await useAsyncData(() => `navigation_${collectionName.value}`, () => queryCollectionNavigation(collectionName.value as keyof PageCollections), {
-  transform: (data: ContentNavigationItem[]) => {
-    const rootResult = data.find(item => item.path === '/docs')?.children || data || []
-
-    return rootResult.find((item: ContentNavigationItem) => item.path === `/${locale.value}`)?.children || rootResult
-  },
+  transform: (data: ContentNavigationItem[]) => transformNavigation(data, isEnabled.value, locale.value),
   watch: [locale],
 })
 const { data: files } = useLazyAsyncData(`search_${collectionName.value}`, () => queryCollectionSearchSections(collectionName.value as keyof PageCollections), {

package/app/error.vue

@@ -2,6 +2,7 @@
 import type { NuxtError } from '#app'
 import type { ContentNavigationItem, PageCollections } from '@nuxt/content'
 import * as nuxtUiLocales from '@nuxt/ui/locale'
+import { transformNavigation } from './utils/navigation'
 
 const props = defineProps<{
   error: NuxtError
@@ -47,11 +48,7 @@ if (isEnabled.value) {
 const collectionName = computed(() => isEnabled.value ? `docs_${locale.value}` : 'docs')
 
 const { data: navigation } = await useAsyncData(`navigation_${collectionName.value}`, () => queryCollectionNavigation(collectionName.value as keyof PageCollections), {
-  transform: (data: ContentNavigationItem[]) => {
-    const rootResult = data.find(item => item.path === '/docs')?.children || data || []
-
-    return rootResult.find(item => item.path === `/${locale.value}`)?.children || rootResult
-  },
+  transform: (data: ContentNavigationItem[]) => transformNavigation(data, isEnabled.value, locale.value),
   watch: [locale],
 })
 const { data: files } = useLazyAsyncData(`search_${collectionName.value}`, () => queryCollectionSearchSections(collectionName.value as keyof PageCollections), {

package/app/utils/navigation.ts

@@ -6,6 +6,25 @@ export const flattenNavigation = (items?: ContentNavigationItem[]): ContentNavig
     : [item],
 ) || []
 
+/**
+ * Transform navigation data by stripping locale and docs levels
+ */
+export function transformNavigation(
+  data: ContentNavigationItem[],
+  isI18nEnabled: boolean,
+  locale?: string,
+): ContentNavigationItem[] {
+  if (isI18nEnabled && locale) {
+    // i18n: first strip locale level, then check for docs level
+    const localeResult = data.find(item => item.path === `/${locale}`)?.children || data
+    return localeResult.find(item => item.path === `/${locale}/docs`)?.children || localeResult
+  }
+  else {
+    // non-i18n: strip docs level if exists
+    return data.find(item => item.path === '/docs')?.children || data
+  }
+}
+
 export interface BreadcrumbItem {
   title: string
   path: string

package/content.config.ts

@@ -2,11 +2,15 @@ import type { DefinedCollection } from '@nuxt/content'
 import { defineContentConfig, defineCollection, z } from '@nuxt/content'
 import { useNuxt } from '@nuxt/kit'
 import { joinURL } from 'ufo'
+import { landingPageExists, docsFolderExists } from './utils/pages'
 
 const { options } = useNuxt()
 const cwd = joinURL(options.rootDir, 'content')
 const locales = options.i18n?.locales
 
+const hasLandingPage = landingPageExists(options.rootDir)
+const hasDocsFolder = docsFolderExists(options.rootDir)
+
 const createDocsSchema = () => z.object({
   links: z.array(z.object({
     label: z.string(),
@@ -22,21 +26,24 @@ if (locales && Array.isArray(locales)) {
   collections = {}
   for (const locale of locales) {
     const code = (typeof locale === 'string' ? locale : locale.code).replace('-', '_')
+    const hasLocaleDocs = docsFolderExists(options.rootDir, code)
 
-    collections[`landing_${code}`] = defineCollection({
-      type: 'page',
-      source: {
-        cwd,
-        include: `${code}/index.md`,
-      },
-    })
+    if (!hasLandingPage) {
+      collections[`landing_${code}`] = defineCollection({
+        type: 'page',
+        source: {
+          cwd,
+          include: `${code}/index.md`,
+        },
+      })
+    }
 
     collections[`docs_${code}`] = defineCollection({
       type: 'page',
       source: {
         cwd,
-        include: `${code}/**/*`,
-        prefix: `/${code}`,
+        include: hasLocaleDocs ? `${code}/docs/**` : `${code}/**/*`,
+        prefix: hasLocaleDocs ? `/${code}/docs` : `/${code}`,
         exclude: [`${code}/index.md`],
       },
       schema: createDocsSchema(),
@@ -45,22 +52,27 @@ if (locales && Array.isArray(locales)) {
 }
 else {
   collections = {
-    landing: defineCollection({
+    docs: defineCollection({
       type: 'page',
       source: {
         cwd,
-        include: 'index.md',
+        include: hasDocsFolder ? 'docs/**' : '**',
+        prefix: hasDocsFolder ? '/docs' : undefined,
+        exclude: ['index.md'],
       },
+      schema: createDocsSchema(),
     }),
-    docs: defineCollection({
+  }
+
+  // Only define landing collection if user doesn't have their own index.vue
+  if (!hasLandingPage) {
+    collections.landing = defineCollection({
       type: 'page',
       source: {
         cwd,
-        include: '**',
-        exclude: ['index.md'],
+        include: 'index.md',
       },
-      schema: createDocsSchema(),
-    }),
+    })
   }
 }
 

package/modules/assistant/runtime/components/AssistantFloatingInput.vue

@@ -18,7 +18,7 @@ const placeholder = computed(() => t('assistant.placeholder'))
 const shortcutDisplayKeys = computed(() => {
   const shortcut = focusInputShortcut.value
   const parts = shortcut.split('_')
-  return parts.map(part => part === 'meta' ? 'meta' : part.toUpperCase())
+  return parts.map((part: string) => part === 'meta' ? 'meta' : part.toUpperCase())
 })
 
 function handleSubmit() {
@@ -62,14 +62,14 @@ defineShortcuts(shortcuts)
       :animate="{ y: 0, opacity: 1 }"
       :exit="{ y: 100, opacity: 0 }"
       :transition="{ duration: 0.2, ease: 'easeOut' }"
-      class="fixed inset-x-0 z-10 px-4 sm:px-80 bottom-[max(1.5rem,env(safe-area-inset-bottom))]"
+      class="pointer-events-none fixed inset-x-0 z-10 bottom-[max(1.5rem,env(safe-area-inset-bottom))] px-4 sm:px-80"
       style="will-change: transform"
     >
       <form
-        class="flex w-full justify-center"
+        class="pointer-events-none flex w-full justify-center"
         @submit.prevent="handleSubmit"
       >
-        <div class="w-full max-w-96">
+        <div class="pointer-events-auto w-full max-w-96">
           <UInput
             ref="inputRef"
             v-model="input"

package/modules/routing.ts

@@ -1,4 +1,5 @@
 import { defineNuxtModule, extendPages, createResolver } from '@nuxt/kit'
+import { landingPageExists } from '../utils/pages'
 
 export default defineNuxtModule({
   meta: {
@@ -19,23 +20,26 @@ export default defineNuxtModule({
       })
     })
 
-    extendPages((pages) => {
-      const landingTemplate = resolve('../app/templates/landing.vue')
+    // Only add landing if index.vue is not already defined
+    if (!landingPageExists(nuxt.options.rootDir)) {
+      extendPages((pages) => {
+        const landingTemplate = resolve('../app/templates/landing.vue')
 
-      if (isI18nEnabled) {
-        pages.push({
-          name: 'lang-index',
-          path: '/:lang?',
-          file: landingTemplate,
-        })
-      }
-      else {
-        pages.push({
-          name: 'index',
-          path: '/',
-          file: landingTemplate,
-        })
-      }
-    })
+        if (isI18nEnabled) {
+          pages.push({
+            name: 'lang-index',
+            path: '/:lang?',
+            file: landingTemplate,
+          })
+        }
+        else {
+          pages.push({
+            name: 'index',
+            path: '/',
+            file: landingTemplate,
+          })
+        }
+      })
+    }
   },
 })

package/nuxt.config.ts

@@ -20,14 +20,16 @@ export default defineNuxtConfig({
       extendViteConfig((config) => {
         config.optimizeDeps ||= {}
         config.optimizeDeps.include ||= []
-        config.optimizeDeps.include.push(
-          '@nuxt/content > slugify',
-          // Fix @vercel/oidc ESM export issue (transitive dep of @ai-sdk/gateway)
-          '@vercel/oidc',
-        )
+        config.optimizeDeps.include.push('@nuxt/content > slugify')
         config.optimizeDeps.include = config.optimizeDeps.include
           .map(id => id.replace(/^@nuxt\/content > /, 'docus > @nuxt/content > '))
-          .map(id => id.replace(/^@vercel\/oidc$/, 'docus > @vercel/oidc'))
+
+        // Fix @vercel/oidc ESM export issue (transitive dep of @ai-sdk/gateway)
+        // Only needed when AI assistant is enabled.
+        if (process.env.AI_GATEWAY_API_KEY) {
+          config.optimizeDeps.include.push('@vercel/oidc')
+          config.optimizeDeps.include.map(id => id.replace(/^@vercel\/oidc$/, 'docus > @vercel/oidc'))
+        }
       })
     },
   ],
@@ -35,6 +37,7 @@ export default defineNuxtConfig({
     enabled: true,
   },
   content: {
+    experimental: { sqliteConnector: 'native' },
     build: {
       markdown: {
         highlight: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.5.1",
+  "version": "5.6.0",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -22,22 +22,22 @@
     "README.md"
   ],
   "dependencies": {
-    "@ai-sdk/gateway": "^3.0.39",
-    "@ai-sdk/mcp": "^1.0.19",
-    "@ai-sdk/vue": "3.0.78",
-    "@iconify-json/lucide": "^1.2.90",
-    "@iconify-json/simple-icons": "^1.2.70",
-    "@iconify-json/vscode-icons": "^1.2.41",
+    "@ai-sdk/gateway": "^3.0.46",
+    "@ai-sdk/mcp": "^1.0.21",
+    "@ai-sdk/vue": "3.0.86",
+    "@iconify-json/lucide": "^1.2.91",
+    "@iconify-json/simple-icons": "^1.2.71",
+    "@iconify-json/vscode-icons": "^1.2.43",
     "@nuxt/content": "^3.11.2",
     "@nuxt/image": "^2.0.0",
     "@nuxt/kit": "^4.3.1",
     "@nuxt/ui": "^4.4.0",
     "@nuxtjs/i18n": "^10.2.3",
-    "@nuxtjs/mcp-toolkit": "^0.6.3",
+    "@nuxtjs/mcp-toolkit": "^0.7.0",
     "@nuxtjs/mdc": "^0.20.1",
     "@nuxtjs/robots": "^5.7.0",
     "@vueuse/core": "^14.2.1",
-    "ai": "6.0.78",
+    "ai": "6.0.86",
     "defu": "^6.1.4",
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",

package/utils/pages.ts

@@ -0,0 +1,22 @@
+import { existsSync } from 'node:fs'
+import { joinURL } from 'ufo'
+
+/**
+ * Checks if the user has their own index.vue file in the pages folder.
+ * When true, the layer should not define the landing collection and / route.
+ */
+export function landingPageExists(rootDir: string): boolean {
+  const vueLandingPath = joinURL(rootDir, 'app', 'pages', 'index.vue')
+  return existsSync(vueLandingPath)
+}
+
+/**
+ * Checks if a docs folder exists in the content directory.
+ * When true, docs should be prefixed with /docs and only include files from the docs folder.
+ */
+export function docsFolderExists(rootDir: string, locale?: string): boolean {
+  const docsPath = locale
+    ? joinURL(rootDir, 'content', locale, 'docs')
+    : joinURL(rootDir, 'content', 'docs')
+  return existsSync(docsPath)
+}