docus 5.6.1 → 5.8.0

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/AssistantChat.vue

@@ -6,15 +6,15 @@ const { toggle } = useAssistant()
 const { t } = useDocusI18n()
 
 const tooltipText = computed(() => t('assistant.tooltip'))
-const triggerIcon = computed(() => appConfig.assistant?.icons?.trigger || 'i-lucide-sparkles')
+const triggerIcon = computed(() => appConfig.assistant?.icons?.trigger || 'i-custom-ai')
 </script>
 
 <template>
   <UTooltip :text="tooltipText">
     <UButton
       :icon="triggerIcon"
+      color="neutral"
       variant="ghost"
-      class="rounded-full"
       @click="toggle"
     />
   </UTooltip>

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

@@ -1,13 +1,25 @@
+import { join } from 'node:path'
 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'),
     resolve('./modules/routing'),
     resolve('./modules/markdown-rewrite'),
     resolve('./modules/css'),
+    () => {
+      const nuxt = useNuxt()
+      nuxt.options.icon ||= {}
+      nuxt.options.icon.customCollections ||= []
+      nuxt.options.icon.customCollections.push({
+        prefix: 'custom',
+        dir: join(nuxt.options.srcDir, 'assets/icons'),
+      })
+    },
     '@nuxt/ui',
     '@nuxt/content',
     '@nuxt/image',
@@ -77,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 || {}
@@ -94,6 +106,16 @@ export default defineNuxtConfig({
     },
   },
   icon: {
+    customCollections: [
+      {
+        prefix: 'custom',
+        dir: resolve('./app/assets/icons'),
+      },
+    ],
+    clientBundle: {
+      scan: true,
+      includeCustomCollections: true,
+    },
     provider: 'iconify',
   },
   robots: {

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',
@@ -266,7 +280,7 @@ export default defineNuxtSchema({
     assistant: group({
       title: 'Assistant',
       description: 'Assistant configuration.',
-      icon: 'i-lucide-sparkles',
+      icon: 'i-custom-ai',
       fields: {
         floatingInput: field({
           type: 'boolean',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.6.1",
+  "version": "5.8.0",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -22,26 +22,25 @@
     "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",
-    "@nuxt/content": "^3.11.2",
+    "@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.4.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",
-    "minimark": "^1.0.0",
     "motion-v": "^1.10.3",
     "nuxt-llms": "^0.2.0",
     "nuxt-og-image": "^5.1.13",
@@ -52,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"