docus 5.7.0 → 5.8.0

package/app/app.vue

@@ -2,6 +2,7 @@
 import type { ContentNavigationItem, PageCollections } from '@nuxt/content'
 import * as nuxtUiLocales from '@nuxt/ui/locale'
 import { transformNavigation } from './utils/navigation'
+import { useSubNavigation } from './composables/useSubNavigation'
 
 const { seo } = useAppConfig()
 const site = useSiteConfig()
@@ -55,6 +56,8 @@ const { data: files } = useLazyAsyncData(`search_${collectionName.value}`, () =>
 })
 
 provide('navigation', navigation)
+
+const { subNavigationMode } = useSubNavigation(navigation)
 </script>
 
 <template>
@@ -62,7 +65,7 @@ provide('navigation', navigation)
     <NuxtLoadingIndicator color="var(--ui-primary)" />
 
     <div
-      class="transition-[margin-right] duration-200 ease-linear will-change-[margin-right]"
+      :class="['transition-[margin-right] duration-200 ease-linear will-change-[margin-right]', { 'docus-sub-header': subNavigationMode === 'header' }]"
       :style="{ marginRight: shouldPushContent ? `${assistantPanelWidth}px` : '0' }"
     >
       <AppHeader v-if="$route.meta.header !== false" />
@@ -84,3 +87,12 @@ provide('navigation', navigation)
     </ClientOnly>
   </UApp>
 </template>
+
+<style>
+@media (min-width: 1024px) {
+  .docus-sub-header {
+    /* 64px base header + 48px sub-navigation bar */
+    --ui-header-height: 112px;
+  }
+}
+</style>

package/app/components/LanguageSelect.vue

@@ -43,10 +43,7 @@ function getEmojiFlag(locale: string): string {
 </script>
 
 <template>
-  <UPopover
-    mode="hover"
-    :content="{ align: 'end' }"
-  >
+  <UPopover :content="{ align: 'end' }">
     <UButton
       color="neutral"
       variant="ghost"

package/app/components/app/AppFooterRight.vue

@@ -1,20 +1,38 @@
 <script setup lang="ts">
 const appConfig = useAppConfig()
 
-const links = computed(() => [
-  ...Object.entries(appConfig.socials || {}).map(([key, url]) => ({
-    'icon': `i-simple-icons-${key}`,
-    'to': url,
-    'target': '_blank',
-    'aria-label': `${key} social link`,
-  })),
-  appConfig.github && appConfig.github.url && {
-    'icon': 'i-simple-icons-github',
-    'to': appConfig.github.url,
-    'target': '_blank',
-    'aria-label': 'GitHub repository',
-  },
-].filter(Boolean))
+interface FooterLink {
+  'icon': string
+  'to': string
+  'target': '_blank'
+  'aria-label': string
+}
+
+const links = computed<FooterLink[]>(() => {
+  const socialLinks = Object.entries(appConfig.socials || {}).flatMap(([key, url]) => {
+    if (typeof url !== 'string' || !url) {
+      return []
+    }
+
+    return [{
+      'icon': `i-simple-icons-${key}`,
+      'to': url,
+      'target': '_blank' as const,
+      'aria-label': `${key} social link`,
+    }]
+  })
+
+  const githubLink = appConfig.github && appConfig.github.url
+    ? [{
+        'icon': 'i-simple-icons-github',
+        'to': appConfig.github.url,
+        'target': '_blank' as const,
+        'aria-label': 'GitHub repository',
+      }]
+    : []
+
+  return [...socialLinks, ...githubLink]
+})
 </script>
 
 <template>

package/app/components/app/AppHeader.vue

@@ -1,11 +1,13 @@
 <script setup lang="ts">
 import { useDocusI18n } from '../../composables/useDocusI18n'
+import { useSubNavigation } from '~/composables/useSubNavigation'
 
 const appConfig = useAppConfig()
 const site = useSiteConfig()
 
 const { isEnabled: isAssistantEnabled } = useAssistant()
 const { localePath, isEnabled, locales } = useDocusI18n()
+const { subNavigationMode } = useSubNavigation()
 
 const links = computed(() => appConfig.github && appConfig.github.url
   ? [
@@ -22,6 +24,7 @@ const links = computed(() => appConfig.github && appConfig.github.url
 <template>
   <UHeader
     :ui="{ center: 'flex-1' }"
+    :class="{ 'flex flex-col': subNavigationMode === 'header' }"
     :to="localePath('/')"
     :title="appConfig.header?.title || site.name"
   >
@@ -83,5 +86,12 @@ const links = computed(() => appConfig.github && appConfig.github.url
     <template #body>
       <AppHeaderBody />
     </template>
+
+    <template
+      v-if="subNavigationMode === 'header'"
+      #bottom
+    >
+      <AppHeaderBottom />
+    </template>
   </UHeader>
 </template>

package/app/components/app/AppHeaderBottom.vue

@@ -0,0 +1,20 @@
+<script setup lang="ts">
+import { useSubNavigation } from '~/composables/useSubNavigation'
+
+const { sections } = useSubNavigation()
+</script>
+
+<template>
+  <USeparator class="hidden lg:flex" />
+
+  <UContainer class="hidden lg:flex items-center justify-between">
+    <UNavigationMenu
+      :items="sections"
+      variant="pill"
+      highlight
+      class="-mx-2.5 -mb-px"
+    />
+
+    <AppHeaderBottomRight />
+  </UContainer>
+</template>

package/app/components/app/AppHeaderBottomRight.vue

@@ -0,0 +1,3 @@
+<template>
+  <div />
+</template>

package/app/components/docs/DocsAsideLeftBody.vue

@@ -1,12 +1,10 @@
 <script setup lang="ts">
-import type { ContentNavigationItem } from '@nuxt/content'
-
-const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
+const { sidebarNavigation } = useSubNavigation()
 </script>
 
 <template>
   <UContentNavigation
     highlight
-    :navigation="navigation"
+    :navigation="sidebarNavigation"
   />
 </template>

package/app/components/docs/DocsAsideLeftTop.vue

@@ -1,3 +1,20 @@
+<script setup lang="ts">
+import { useSubNavigation } from '~/composables/useSubNavigation'
+
+const { subNavigationMode, sections } = useSubNavigation()
+</script>
+
 <template>
-  <div />
+  <div
+    v-if="subNavigationMode === 'aside'"
+    class="mb-2"
+  >
+    <UPageAnchors :links="sections" />
+    <USeparator
+      type="dashed"
+      class="my-4"
+    />
+  </div>
+
+  <div v-else />
 </template>

package/app/components/docs/DocsAsideMobileBar.vue

@@ -0,0 +1,88 @@
+<script setup lang="ts">
+import { useSubNavigation } from '~/composables/useSubNavigation'
+import type { ContentTocLink } from '@nuxt/ui'
+
+defineProps<{
+  links?: ContentTocLink[]
+}>()
+
+const { subNavigationMode, sidebarNavigation, currentSection } = useSubNavigation()
+const { t } = useDocusI18n()
+
+const menuDrawerOpen = ref(false)
+const tocDrawerOpen = ref(false)
+</script>
+
+<template>
+  <div
+    v-if="subNavigationMode"
+    class="lg:hidden sticky top-(--ui-header-height) z-10 bg-default/75 backdrop-blur -mx-4 p-2 border-b border-dashed border-default flex justify-between"
+  >
+    <UDrawer
+      v-model:open="menuDrawerOpen"
+      direction="left"
+      :title="currentSection?.title"
+      :handle="false"
+      inset
+      side="left"
+      :ui="{ content: 'w-full max-w-2/3' }"
+    >
+      <UButton
+        :label="t('docs.menu')"
+        icon="i-lucide-text-align-start"
+        color="neutral"
+        variant="link"
+        size="xs"
+        :aria-label="t('docs.menu')"
+      />
+
+      <template #body>
+        <UContentNavigation
+          :navigation="sidebarNavigation"
+          default-open
+          trailing-icon="i-lucide-chevron-right"
+          :ui="{ linkTrailingIcon: 'group-data-[state=open]:rotate-90' }"
+          highlight
+        />
+      </template>
+    </UDrawer>
+
+    <UDrawer
+      v-model:open="tocDrawerOpen"
+      direction="right"
+      :handle="false"
+      inset
+      side="right"
+      no-body-styles
+      :ui="{ content: 'w-full max-w-2/3' }"
+    >
+      <UButton
+        :label="t('docs.toc')"
+        trailing-icon="i-lucide-chevron-right"
+        color="neutral"
+        variant="link"
+        size="xs"
+        :aria-label="t('docs.toc')"
+      />
+
+      <template #body>
+        <UContentToc
+          v-if="links?.length"
+          :links="links"
+          :open="true"
+          default-open
+          :ui="{
+            root: '!mx-0 !px-1 top-0 overflow-visible',
+            container: '!pt-0 border-b-0',
+            trailingIcon: 'hidden',
+            bottom: 'flex flex-col',
+          }"
+        >
+          <template #bottom>
+            <DocsAsideRightBottom />
+          </template>
+        </UContentToc>
+      </template>
+    </UDrawer>
+  </div>
+</template>

package/app/components/docs/DocsAsideRight.vue

@@ -0,0 +1,33 @@
+<script setup lang="ts">
+import { useSubNavigation } from '~/composables/useSubNavigation'
+import type { DocsCollectionItem } from '@nuxt/content'
+
+const props = defineProps<{
+  page?: DocsCollectionItem | null
+}>()
+
+const links = computed(() => props.page?.body?.toc?.links || [])
+
+const { shouldPushContent: shouldHideToc } = useAssistant()
+const { subNavigationMode } = useSubNavigation()
+const appConfig = useAppConfig()
+const { t } = useDocusI18n()
+</script>
+
+<template>
+  <div>
+    <UContentToc
+      v-if="links.length && !shouldHideToc"
+      highlight
+      :title="appConfig.toc?.title || t('docs.toc')"
+      :links="links"
+      :class="{ 'hidden lg:block': subNavigationMode }"
+    >
+      <template #bottom>
+        <DocsAsideRightBottom />
+      </template>
+    </UContentToc>
+
+    <DocsAsideMobileBar :links="links" />
+  </div>
+</template>

package/app/components/docs/DocsAsideRightBottom.vue

@@ -16,7 +16,7 @@ const explainIcon = computed(() => appConfig.assistant?.icons?.explain || 'i-luc
 <template>
   <div
     v-if="appConfig.toc?.bottom?.links?.length || showExplainWithAi"
-    class="hidden lg:block space-y-6"
+    class="space-y-6"
   >
     <USeparator type="dashed" />
 

package/app/composables/useDocusI18n.ts

@@ -1,12 +1,27 @@
+import { useNuxtApp, useRuntimeConfig } from '#imports'
 import type { LocaleObject } from '@nuxtjs/i18n'
+import type { Ref } from 'vue'
+import { ref } from 'vue'
+
+type DocusNuxtApp = ReturnType<typeof useNuxtApp> & {
+  $i18n?: {
+    locale: Ref<string>
+    t: (key: string) => string
+  }
+  $locale?: string
+  $localeMessages?: Record<string, unknown>
+  $localePath?: (path: string) => string
+  $switchLocalePath?: (locale?: string) => string
+}
 
 export const useDocusI18n = () => {
   const config = useRuntimeConfig().public
+  const nuxtApp = useNuxtApp() as DocusNuxtApp
   const isEnabled = ref(!!config.i18n)
 
   if (!isEnabled.value) {
-    const locale = useNuxtApp().$locale as string
-    const localeMessages = useNuxtApp().$localeMessages as Record<string, unknown>
+    const locale = nuxtApp.$locale || 'en'
+    const localeMessages = nuxtApp.$localeMessages || {}
 
     return {
       isEnabled,
@@ -21,7 +36,8 @@ export const useDocusI18n = () => {
     }
   }
 
-  const { locale, t } = useI18n()
+  const locale = nuxtApp.$i18n?.locale || ref('en')
+  const t = nuxtApp.$i18n?.t || ((key: string) => key)
   const filteredLocales = (config.docus as { filteredLocales: LocaleObject<string>[] })?.filteredLocales || []
 
   return {
@@ -29,7 +45,7 @@ export const useDocusI18n = () => {
     locale,
     locales: filteredLocales,
     t,
-    localePath: useLocalePath(),
-    switchLocalePath: useSwitchLocalePath(),
+    localePath: nuxtApp.$localePath || ((path: string) => path),
+    switchLocalePath: nuxtApp.$switchLocalePath || (() => ''),
   }
 }

package/app/composables/useLogoAssets.ts

@@ -65,7 +65,7 @@ function triggerLinkDownload(url: string, filename: string) {
 
 export const useLogoAssets = () => {
   const appConfig = useAppConfig()
-  const colorMode = useColorMode()
+  const colorMode = useColorMode() as { value: string, forced?: boolean }
   const toast = useToast()
   const { t } = useDocusI18n()
 

package/app/composables/useSubNavigation.ts

@@ -0,0 +1,55 @@
+import type { ContentNavigationItem } from '@nuxt/content'
+
+function getFirstPagePath(item: ContentNavigationItem): string {
+  let current = item
+  while (current.children?.length) {
+    current = current.children[0]!
+  }
+  return current.path
+}
+
+export function useSubNavigation(providedNavigation?: Ref<ContentNavigationItem[] | null | undefined>) {
+  const route = useRoute()
+  const appConfig = useAppConfig()
+  const navigation = providedNavigation ?? inject<Ref<ContentNavigationItem[]>>('navigation')
+
+  const isDocsPage = computed(() => route.meta.layout === 'docs')
+
+  const subNavigationMode = computed(() => {
+    if (!isDocsPage.value) return undefined
+    return (appConfig.navigation as { sub?: 'header' | 'aside' } | undefined)?.sub
+  })
+
+  const currentSection = computed(() => {
+    if (!subNavigationMode.value || !navigation?.value) return undefined
+    return navigation.value.find(item =>
+      route.path === item.path || route.path.startsWith(item.path + '/'),
+    )
+  })
+
+  const sections = computed(() => {
+    if (!subNavigationMode.value || !navigation?.value) return []
+    return navigation.value
+      .filter(item => item.children?.length)
+      .map(item => ({
+        label: item.title,
+        icon: item.icon as string | undefined,
+        to: getFirstPagePath(item),
+        active: route.path === item.path || route.path.startsWith(item.path + '/'),
+      }))
+  })
+
+  const sidebarNavigation = computed(() => {
+    if (subNavigationMode.value && currentSection.value) {
+      return currentSection.value.children || []
+    }
+    return navigation?.value || []
+  })
+
+  return {
+    subNavigationMode,
+    sections,
+    currentSection,
+    sidebarNavigation,
+  }
+}

package/app/pages/[[lang]]/[...slug].vue

@@ -131,19 +131,10 @@ addPrerenderPath(`/raw${route.path}.md`)
       <UContentSurround :surround="surround" />
     </UPageBody>
 
-    <template
-      v-if="page?.body?.toc?.links?.length && !shouldHideToc"
-      #right
-    >
-      <UContentToc
-        highlight
-        :title="appConfig.toc?.title || t('docs.toc')"
-        :links="page.body?.toc?.links"
-      >
-        <template #bottom>
-          <DocsAsideRightBottom />
-        </template>
-      </UContentToc>
+    <template #right>
+      <DocsAsideRight
+        :page="page"
+      />
     </template>
   </UPage>
 </template>

package/i18n/locales/ar.json

@@ -16,6 +16,7 @@
     },
     "links": "المجتمع",
     "toc": "في هذه الصفحة",
+    "menu": "قائمة",
     "report": "الإبلاغ عن مشكلة",
     "edit": "تحرير هذه الصفحة"
   },

package/i18n/locales/be.json

@@ -16,6 +16,7 @@
     },
     "links": "Супольнасць",
     "toc": "На гэтай старонцы",
+    "menu": "Меню",
     "report": "Паведаміць пра праблему",
     "edit": "Рэдагаваць гэтую старонку"
   },

package/i18n/locales/bg.json

@@ -16,6 +16,7 @@
     },
     "links": "Общност",
     "toc": "На тази страница",
+    "menu": "Меню",
     "report": "Докладване на проблем",
     "edit": "Редактиране на тази страница"
   },

package/i18n/locales/bn.json

@@ -16,6 +16,7 @@
     },
     "links": "কমিউনিটি",
     "toc": "এই পেজে",
+    "menu": "মেনু",
     "report": "সমস্যা রিপোর্ট করুন",
     "edit": "এই পেজ সম্পাদনা করুন"
   },

package/i18n/locales/ca.json

@@ -16,6 +16,7 @@
     },
     "links": "Comunitat",
     "toc": "En aquesta pàgina",
+    "menu": "Menú",
     "report": "Informar d'un problema",
     "edit": "Editar aquesta pàgina"
   },

package/i18n/locales/ckb.json

@@ -12,6 +12,7 @@
     },
     "links": "کۆمەڵگا",
     "toc": "لەم پەڕەدا",
+    "menu": "مینیو",
     "report": "ڕاپۆرتکردنی کێشە",
     "edit": "دەستکاریکردنی ئەم پەڕەیە"
   },

package/i18n/locales/cs.json

@@ -16,6 +16,7 @@
     },
     "links": "Komunita",
     "toc": "Na této stránce",
+    "menu": "Nabídka",
     "report": "Nahlásit problém",
     "edit": "Upravit tuto stránku"
   },

package/i18n/locales/da.json

@@ -16,6 +16,7 @@
     },
     "links": "Fællesskab",
     "toc": "På denne side",
+    "menu": "Menu",
     "report": "Rapporter et problem",
     "edit": "Rediger denne side"
   },

package/i18n/locales/de.json

@@ -16,6 +16,7 @@
     },
     "links": "Community",
     "toc": "Auf dieser Seite",
+    "menu": "Menü",
     "report": "Problem melden",
     "edit": "Diese Seite bearbeiten"
   },

package/i18n/locales/el.json

@@ -16,6 +16,7 @@
     },
     "links": "Κοινότητα",
     "toc": "Σε αυτή τη σελίδα",
+    "menu": "Μενού",
     "report": "Αναφορά προβλήματος",
     "edit": "Επεξεργασία αυτής της σελίδας"
   },

package/i18n/locales/en.json

@@ -16,6 +16,7 @@
     },
     "links": "Community",
     "toc": "On this page",
+    "menu": "Menu",
     "report": "Report an issue",
     "edit": "Edit this page"
   },

package/i18n/locales/es.json

@@ -16,6 +16,7 @@
     },
     "links": "Comunidad",
     "toc": "En esta página",
+    "menu": "Menú",
     "report": "Reportar un problema",
     "edit": "Editar esta página"
   },

package/i18n/locales/et.json

@@ -16,6 +16,7 @@
     },
     "links": "Kogukond",
     "toc": "Sellel lehel",
+    "menu": "Menüü",
     "report": "Teata probleemist",
     "edit": "Muuda seda lehekülge"
   },

package/i18n/locales/fi.json

@@ -16,6 +16,7 @@
     },
     "links": "Yhteisö",
     "toc": "Tällä sivulla",
+    "menu": "Valikko",
     "report": "Ilmoita ongelmasta",
     "edit": "Muokkaa tätä sivua"
   },

package/i18n/locales/fr.json

@@ -16,6 +16,7 @@
     },
     "links": "Communauté",
     "toc": "Sur cette page",
+    "menu": "Menu",
     "report": "Signaler un problème",
     "edit": "Éditer cette page"
   },

package/i18n/locales/he.json

@@ -16,6 +16,7 @@
     },
     "links": "קהילה",
     "toc": "בעמוד זה",
+    "menu": "תפריט",
     "report": "דווח על בעיה",
     "edit": "ערוך עמוד זה"
   },

package/i18n/locales/hi.json

@@ -16,6 +16,7 @@
     },
     "links": "समुदाय",
     "toc": "इस पृष्ठ पर",
+    "menu": "मेनू",
     "report": "समस्या की रिपोर्ट करें",
     "edit": "इस पृष्ठ को संपादित करें"
   },

package/i18n/locales/hy.json

@@ -16,6 +16,7 @@
     },
     "links": "Համայնք",
     "toc": "Այս էջում",
+    "menu": "Ընտրացանկ",
     "report": "Հաղորդել խնդրի մասին",
     "edit": "Խմբագրել այս էջը"
   },

package/i18n/locales/id.json

@@ -19,6 +19,7 @@
     },
     "links": "Komunitas",
     "toc": "Pada halaman ini",
+    "menu": "Menu",
     "report": "Laporkan masalah",
     "edit": "Ubah halaman ini"
   },

package/i18n/locales/it.json

@@ -16,6 +16,7 @@
     },
     "links": "Comunità",
     "toc": "In questa pagina",
+    "menu": "Menu",
     "report": "Segnala un problema",
     "edit": "Modifica questa pagina"
   },

package/i18n/locales/ja.json

@@ -16,6 +16,7 @@
     },
     "links": "コミュニティ",
     "toc": "このページの内容",
+    "menu": "メニュー",
     "report": "問題を報告",
     "edit": "このページを編集"
   },

package/i18n/locales/kk.json

@@ -16,6 +16,7 @@
     },
     "links": "Қауымдастық",
     "toc": "Осы бетте",
+    "menu": "Мәзір",
     "report": "Мәселе туралы хабарлау",
     "edit": "Осы бетті өңдеу"
   },

package/i18n/locales/km.json

@@ -16,6 +16,7 @@
     },
     "links": "សហគមន៍",
     "toc": "នៅលើទំព័រនេះ",
+    "menu": "ម៉ឺនុយ",
     "report": "រាយការណ៍បញ្ហា",
     "edit": "កែសម្រួលទំព័រនេះ"
   },

package/i18n/locales/ko.json

@@ -16,6 +16,7 @@
     },
     "links": "커뮤니티",
     "toc": "이 페이지에서",
+    "menu": "메뉴",
     "report": "문제 신고",
     "edit": "이 페이지 편집"
   },

package/i18n/locales/ky.json

@@ -16,6 +16,7 @@
     },
     "links": "Коом",
     "toc": "Бул барактта",
+    "menu": "Меню",
     "report": "Көйгөй туурасында кабарлоо",
     "edit": "Бул баракты түзөтүү"
   },

package/i18n/locales/lb.json

@@ -16,6 +16,7 @@
     },
     "links": "Gemeinschaft",
     "toc": "Op dëser Säit",
+    "menu": "Menü",
     "report": "Problem mellen",
     "edit": "Dës Säit änneren"
   },

package/i18n/locales/ms.json

@@ -16,6 +16,7 @@
     },
     "links": "Komuniti",
     "toc": "Dalam halaman ini",
+    "menu": "Menu",
     "report": "Laporkan masalah",
     "edit": "Edit halaman ini"
   },

package/i18n/locales/nb.json

@@ -16,6 +16,7 @@
     },
     "links": "Fellesskap",
     "toc": "På denne siden",
+    "menu": "Meny",
     "report": "Rapporter et problem",
     "edit": "Rediger denne siden"
   },

package/i18n/locales/nl.json

@@ -16,6 +16,7 @@
     },
     "links": "Community",
     "toc": "Op deze pagina",
+    "menu": "Menu",
     "report": "Rapporteer een probleem",
     "edit": "Bewerk deze pagina"
   },

package/i18n/locales/pl.json

@@ -16,6 +16,7 @@
     },
     "links": "Społeczność",
     "toc": "Na tej stronie",
+    "menu": "Menu",
     "report": "Zgłoś problem",
     "edit": "Edytuj tę stronę"
   },

package/i18n/locales/pt-BR.json

@@ -16,6 +16,7 @@
     },
     "links": "Comunidade",
     "toc": "Nesta página",
+    "menu": "Menu",
     "report": "Reportar um erro",
     "edit": "Editar esta página"
   },

package/i18n/locales/ro.json

@@ -16,6 +16,7 @@
     },
     "links": "Comunitate",
     "toc": "Pe această pagină",
+    "menu": "Meniu",
     "report": "Raportează o problemă",
     "edit": "Editează această pagină"
   },

package/i18n/locales/ru.json

@@ -16,6 +16,7 @@
     },
     "links": "Сообщество",
     "toc": "На этой странице",
+    "menu": "Меню",
     "report": "Сообщить о проблеме",
     "edit": "Редактировать эту страницу"
   },

package/i18n/locales/si.json

@@ -16,6 +16,7 @@
     },
     "links": "Community",
     "toc": "මෙම පිටුවේ",
+    "menu": "මෙනුව",
     "report": "ගැටලුවක් වාර්තා කරන්න",
     "edit": "මෙම පිටුව සංස්කරණය කරන්න"
   },

package/i18n/locales/sl.json

@@ -16,6 +16,7 @@
     },
     "links": "Skupnost",
     "toc": "Na tej strani",
+    "menu": "Meni",
     "report": "Prijavi težavo",
     "edit": "Uredi to stran"
   },

package/i18n/locales/sv.json

@@ -16,6 +16,7 @@
     },
     "links": "Gemenskap",
     "toc": "På denna sida",
+    "menu": "Meny",
     "report": "Rapportera ett problem",
     "edit": "Redigera denna sida"
   },

package/i18n/locales/tr.json

@@ -16,6 +16,7 @@
     },
     "links": "Topluluk",
     "toc": "Bu sayfada",
+    "menu": "Menü",
     "report": "Sorun bildir",
     "edit": "Bu sayfayı düzenle"
   },

package/i18n/locales/uk.json

@@ -16,6 +16,7 @@
     },
     "links": "Спільнота",
     "toc": "На цій сторінці",
+    "menu": "Меню",
     "report": "Повідомити про проблему",
     "edit": "Редагувати цю сторінку"
   },

package/i18n/locales/ur.json

@@ -16,6 +16,7 @@
     },
     "links": "کمیونٹی",
     "toc": "اس صفحے پر",
+    "menu": "مینو",
     "report": "مسئلہ کی اطلاع دیں",
     "edit": "اس صفحے کو ترمیم کریں"
   },

package/i18n/locales/vi.json

@@ -16,6 +16,7 @@
     },
     "links": "Cộng đồng",
     "toc": "Trên trang này",
+    "menu": "Menu",
     "report": "Báo cáo sự cố",
     "edit": "Chỉnh sửa trang này"
   },

package/i18n/locales/zh-CN.json

@@ -16,6 +16,7 @@
     },
     "links": "社区",
     "toc": "在此页面上",
+    "menu": "菜单",
     "report": "提交问题报告",
     "edit": "编辑此页面"
   },

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

@@ -25,7 +25,7 @@ const displayPlaceholder = computed(() => t('assistant.placeholder'))
 const chat = new Chat({
   messages: messages.value,
   transport: new DefaultChatTransport({
-    api: config.public.assistant.apiPath,
+    api: (config.app?.baseURL.replace(/\/$/, '') || '') + config.public.assistant.apiPath,
   }),
   onError: (error: Error) => {
     const message = (() => {

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

@@ -3,7 +3,7 @@ import { ShikiCachedRenderer } from 'shiki-stream/vue'
 import { useColorMode } from '#imports'
 import { useHighlighter } from '../composables/useHighlighter'
 
-const colorMode = useColorMode()
+const colorMode = useColorMode() as { value: string, forced?: boolean }
 const highlighter = await useHighlighter()
 const props = defineProps<{
   code: string

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

@@ -1,5 +1,7 @@
 import type { UIMessage } from 'ai'
+import { useAppConfig, useRuntimeConfig, useState } from '#imports'
 import { useMediaQuery } from '@vueuse/core'
+import { computed } from 'vue'
 import type { FaqCategory, FaqQuestions, LocalizedFaqQuestions } from '../types'
 
 function normalizeFaqQuestions(questions: FaqQuestions): FaqCategory[] {
@@ -23,7 +25,10 @@ const PANEL_WIDTH_EXPANDED = 520
 export function useAssistant() {
   const config = useRuntimeConfig()
   const appConfig = useAppConfig()
-  const isEnabled = computed(() => config.public.assistant?.enabled ?? false)
+  const assistantRuntimeConfig = config.public.assistant as { enabled?: boolean } | undefined
+  const assistantConfig = appConfig.assistant as { faqQuestions?: FaqQuestions | LocalizedFaqQuestions } | undefined
+  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)
@@ -35,14 +40,13 @@ export function useAssistant() {
   const shouldPushContent = computed(() => !isMobile.value && isOpen.value)
 
   const faqQuestions = computed<FaqCategory[]>(() => {
-    const assistantConfig = appConfig.assistant
     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 = appConfig.docus?.locale || 'en'
+      const currentLocale = docusRuntimeConfig?.locale || 'en'
       const defaultLocale = config.public.i18n?.defaultLocale || 'en'
 
       // Try current locale, then default locale, then first available

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

@@ -60,11 +60,12 @@ export default defineEventHandler(async (event) => {
 
   const mcpServer = config.assistant.mcpServer
   const isExternalUrl = mcpServer.startsWith('http://') || mcpServer.startsWith('https://')
+  const baseURL = config.app?.baseURL?.replace(/\/$/, '') || ''
   const mcpUrl = isExternalUrl
     ? mcpServer
     : import.meta.dev
-      ? `http://localhost:3000${mcpServer}`
-      : `${getRequestURL(event).origin}${mcpServer}`
+      ? `http://localhost:3000${baseURL}${mcpServer}`
+      : `${getRequestURL(event).origin}${baseURL}${mcpServer}`
 
   const httpClient = await createMCPClient({
     transport: { type: 'http', url: mcpUrl },

package/modules/config.ts

@@ -7,6 +7,13 @@ import { getGitBranch, getGitEnv, getLocalGitInfo } from '../utils/git'
 
 const log = logger.withTag('Docus')
 
+type I18nLocale = string | { code: string, name?: string }
+type DocusI18nOptions = { locales?: I18nLocale[], strategy?: string }
+type RegisterModuleOptions = {
+  langDir: string
+  locales: Array<{ code: string, name: string, file: string }>
+}
+
 export default defineNuxtModule({
   meta: {
     name: 'config',
@@ -54,11 +61,14 @@ export default defineNuxtModule({
     /*
     ** I18N
     */
-    if (nuxt.options.i18n && nuxt.options.i18n.locales) {
+    const typedNuxtOptions = nuxt.options as typeof nuxt.options & { i18n?: DocusI18nOptions }
+    const i18nOptions = typedNuxtOptions.i18n
+
+    if (i18nOptions?.locales) {
       const { resolve } = createResolver(import.meta.url)
 
       // Filter locales to only include existing ones
-      const filteredLocales = nuxt.options.i18n.locales.filter((locale) => {
+      const filteredLocales = i18nOptions.locales.filter((locale: I18nLocale) => {
         const localeCode = typeof locale === 'string' ? locale : locale.code
 
         // Check for JSON locale file
@@ -81,8 +91,8 @@ export default defineNuxtModule({
       })
 
       // Override strategy to prefix
-      nuxt.options.i18n = {
-        ...nuxt.options.i18n,
+      typedNuxtOptions.i18n = {
+        ...i18nOptions,
         strategy: 'prefix',
       }
 
@@ -91,10 +101,12 @@ export default defineNuxtModule({
         filteredLocales,
       }
 
-      nuxt.hook('i18n:registerModule', (register) => {
+      const registerI18nModule = nuxt.hook as unknown as (name: string, callback: (register: (options: RegisterModuleOptions) => void) => void) => void
+
+      registerI18nModule('i18n:registerModule', (register) => {
         const langDir = resolve('../i18n/locales')
 
-        const locales = filteredLocales?.map((locale) => {
+        const locales = filteredLocales.map((locale: I18nLocale) => {
           return typeof locale === 'string'
             ? {
                 code: locale,

package/modules/markdown-rewrite.ts

@@ -4,6 +4,9 @@ import { readFile, writeFile } from 'node:fs/promises'
 
 const log = logger.withTag('Docus')
 
+type I18nLocale = string | { code: string }
+type DocusI18nOptions = { locales?: I18nLocale[] }
+
 export default defineNuxtModule({
   meta: {
     name: 'markdown-rewrite',
@@ -44,13 +47,14 @@ export default defineNuxtModule({
         ]
 
         // Check if i18n is enabled
-        const isI18nEnabled = !!(nuxt.options.i18n && nuxt.options.i18n.locales)
+        const i18nOptions = (nuxt.options as typeof nuxt.options & { i18n?: DocusI18nOptions }).i18n
+        const isI18nEnabled = !!i18nOptions?.locales
         let localeCodes: string[] = []
 
         if (isI18nEnabled) {
           // Get locale codes
-          const locales = nuxt.options.i18n.locales || []
-          localeCodes = locales.map((locale) => {
+          const locales = i18nOptions?.locales || []
+          localeCodes = locales.map((locale: I18nLocale) => {
             return typeof locale === 'string' ? locale : locale.code
           })
 

package/modules/routing.ts

@@ -1,6 +1,8 @@
 import { defineNuxtModule, extendPages, createResolver } from '@nuxt/kit'
 import { landingPageExists } from '../utils/pages'
 
+type DocusI18nOptions = { locales?: Array<string | { code: string }> }
+
 export default defineNuxtModule({
   meta: {
     name: 'routing',
@@ -8,7 +10,8 @@ export default defineNuxtModule({
   async setup(_options, nuxt) {
     const { resolve } = createResolver(import.meta.url)
 
-    const isI18nEnabled = !!(nuxt.options.i18n && nuxt.options.i18n.locales)
+    const i18nOptions = (nuxt.options as typeof nuxt.options & { i18n?: DocusI18nOptions }).i18n
+    const isI18nEnabled = !!i18nOptions?.locales
 
     // Ensure useDocusI18n is available in the app
     nuxt.hook('imports:extend', (imports) => {

package/nuxt.config.ts

@@ -3,6 +3,8 @@ import { extendViteConfig, createResolver, useNuxt } from '@nuxt/kit'
 
 const { resolve } = createResolver(import.meta.url)
 
+type DocusI18nOptions = { locales?: Array<string | { code: string }> }
+
 export default defineNuxtConfig({
   modules: [
     resolve('./modules/config'),
@@ -87,14 +89,14 @@ export default defineNuxtConfig({
     'nitro:config'(nitroConfig) {
       const nuxt = useNuxt()
 
-      const i18nOptions = nuxt.options.i18n
+      const i18nOptions = (nuxt.options as typeof nuxt.options & { i18n?: DocusI18nOptions }).i18n
 
       const routes: string[] = []
       if (!i18nOptions) {
         routes.push('/')
       }
       else {
-        routes.push(...(i18nOptions.locales?.map(locale => typeof locale === 'string' ? `/${locale}` : `/${locale.code}`) || []))
+        routes.push(...(i18nOptions.locales?.map((locale: string | { code: string }) => typeof locale === 'string' ? `/${locale}` : `/${locale.code}`) || []))
       }
 
       nitroConfig.prerender = nitroConfig.prerender || {}

package/nuxt.schema.ts

@@ -193,6 +193,20 @@ export default defineNuxtSchema({
         }),
       },
     }),
+    navigation: group({
+      title: 'Navigation',
+      description: 'Navigation configuration.',
+      icon: 'i-lucide-navigation',
+      fields: {
+        sub: field({
+          type: 'string',
+          title: 'Sub Navigation',
+          description: 'Enable sub-navigation for multi-section docs. Use "header" for a secondary tab bar below the header, or "aside" for section anchors at the top of the sidebar.',
+          icon: 'i-lucide-layout-panel-left',
+          default: '',
+        }),
+      },
+    }),
     socials: field({
       type: 'object',
       title: 'Social Networks',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.7.0",
+  "version": "5.8.0",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -22,22 +22,22 @@
     "README.md"
   ],
   "dependencies": {
-    "@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",
+    "@ai-sdk/gateway": "^3.0.66",
+    "@ai-sdk/mcp": "^1.0.25",
+    "@ai-sdk/vue": "3.0.116",
+    "@iconify-json/lucide": "^1.2.96",
+    "@iconify-json/simple-icons": "^1.2.73",
+    "@iconify-json/vscode-icons": "^1.2.45",
     "@nuxt/content": "^3.12.0",
     "@nuxt/image": "^2.0.0",
     "@nuxt/kit": "^4.3.1",
-    "@nuxt/ui": "^4.5.0",
+    "@nuxt/ui": "^4.5.1",
     "@nuxtjs/i18n": "^10.2.3",
     "@nuxtjs/mcp-toolkit": "^0.7.0",
-    "@nuxtjs/mdc": "^0.20.1",
-    "@nuxtjs/robots": "^5.7.0",
+    "@nuxtjs/mdc": "^0.20.2",
+    "@nuxtjs/robots": "^5.7.1",
     "@vueuse/core": "^14.2.1",
-    "ai": "6.0.86",
+    "ai": "6.0.116",
     "defu": "^6.1.4",
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",
@@ -51,7 +51,7 @@
     "@shikijs/langs": "^3.22.0",
     "@shikijs/themes": "^3.22.0",
     "shiki-stream": "^0.1.4",
-    "tailwindcss": "^4.1.18",
+    "tailwindcss": "^4.2.1",
     "ufo": "^1.6.3",
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.1"

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

@@ -24,7 +24,7 @@ WORKFLOW: This tool returns the complete page content including title, descripti
   handler: async ({ path }) => {
     const event = useEvent()
     const config = useRuntimeConfig(event).public
-    const siteUrl = import.meta.dev ? 'http://localhost:3000' : inferSiteURL()
+    const siteUrl = getRequestURL(event).origin || inferSiteURL()
 
     const availableLocales = getAvailableLocales(config)
     const collectionName = config.i18n?.locales
@@ -41,9 +41,7 @@ WORKFLOW: This tool returns the complete page content including title, descripti
         return errorResult('Page not found')
       }
 
-      const content = await $fetch<string>(`/raw${path}.md`, {
-        baseURL: siteUrl,
-      })
+      const content = await event.$fetch<string>(`/raw${path}.md`)
 
       return jsonResult({
         title: page.title,

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

@@ -2,6 +2,7 @@ import { z } from 'zod'
 import { queryCollection } from '@nuxt/content/server'
 import type { Collections } from '@nuxt/content'
 import { getCollectionsToQuery, getAvailableLocales } from '../../utils/content'
+import { inferSiteURL } from '../../../utils/meta'
 
 export default defineMcpTool({
   description: `Lists all available documentation pages with their categories and basic information.
@@ -30,7 +31,7 @@ OUTPUT: Returns a structured list with:
     const event = useEvent()
     const config = useRuntimeConfig(event).public
 
-    const siteUrl = import.meta.dev ? 'http://localhost:3000' : getRequestURL(event).origin
+    const siteUrl = getRequestURL(event).origin || inferSiteURL()
     const availableLocales = getAvailableLocales(config)
     const collections = getCollectionsToQuery(locale, availableLocales)
 

package/server/routes/sitemap.xml.ts

@@ -27,11 +27,11 @@ export default defineEventHandler(async (event) => {
 
   for (const collection of collections) {
     try {
-      const pages = await queryCollection(event, collection as 'docs').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 unknown as Record<string, unknown>
-        const pagePath = (page.path as string) || '/'
+        const meta = page as Record<string, unknown>
+        const pagePath = page.path || '/'
 
         // Skip pages with sitemap: false in frontmatter
         if (meta.sitemap === false) continue