docus 5.2.3 → 5.3.0

package/app/app.config.ts

@@ -1,4 +1,7 @@
 export default defineAppConfig({
+  docus: {
+    locale: 'en',
+  },
   ui: {
     colors: {
       primary: 'emerald',
@@ -6,6 +9,7 @@ export default defineAppConfig({
     },
     commandPalette: {
       slots: {
+        item: 'items-center',
         input: '[&_.iconify]:size-4 [&_.iconify]:mx-0.5',
         itemLeadingIcon: 'size-4 mx-0.5',
       },

package/app/app.vue

@@ -1,13 +1,14 @@
 <script setup lang="ts">
-import type { PageCollections } from '@nuxt/content'
+import type { ContentNavigationItem, PageCollections } from '@nuxt/content'
 import * as nuxtUiLocales from '@nuxt/ui/locale'
 
 const { seo } = useAppConfig()
 const site = useSiteConfig()
 const { locale, locales, isEnabled, switchLocalePath } = useDocusI18n()
 
-const lang = computed(() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales]?.code || 'en')
-const dir = computed(() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales]?.dir || 'ltr')
+const nuxtUiLocale = computed(() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales] || nuxtUiLocales.en)
+const lang = computed(() => nuxtUiLocale.value.code)
+const dir = computed(() => nuxtUiLocale.value.dir)
 const collectionName = computed(() => isEnabled.value ? `docs_${locale.value}` : 'docs')
 
 useHead({
@@ -43,7 +44,7 @@ if (isEnabled.value) {
 }
 
 const { data: navigation } = await useAsyncData(() => `navigation_${collectionName.value}`, () => queryCollectionNavigation(collectionName.value as keyof PageCollections), {
-  transform: (data) => {
+  transform: (data: ContentNavigationItem[]) => {
     const rootResult = data.find(item => item.path === '/docs')?.children || data || []
 
     return rootResult.find(item => item.path === `/${locale.value}`)?.children || rootResult
@@ -58,7 +59,7 @@ provide('navigation', navigation)
 </script>
 
 <template>
-  <UApp :locale="nuxtUiLocales[locale as keyof typeof nuxtUiLocales]">
+  <UApp :locale="nuxtUiLocale">
     <NuxtLoadingIndicator color="var(--ui-primary)" />
 
     <AppHeader v-if="$route.meta.header !== false" />

package/app/components/LanguageSelect.vue

@@ -28,6 +28,7 @@ function getEmojiFlag(locale: string): string {
     uk: 'ua', // Ukrainian -> Ukraine
     ur: 'pk', // Urdu -> Pakistan
     vi: 'vn', // Vietnamese -> Vietnam
+    es: 'es', // Spanish -> Spain
   }
 
   const baseLanguage = locale.split('-')[0]?.toLowerCase() || locale

package/app/composables/useDocusI18n.ts

@@ -1,20 +1,22 @@
 import type { LocaleObject } from '@nuxtjs/i18n'
-import en from '../../i18n/locales/en.json'
 
 export const useDocusI18n = () => {
   const config = useRuntimeConfig().public
   const isEnabled = ref(!!config.i18n)
 
   if (!isEnabled.value) {
+    const locale = useNuxtApp().$locale as string
+    const localeMessages = useNuxtApp().$localeMessages as Record<string, unknown>
+
     return {
       isEnabled,
-      locale: ref('en'),
+      locale: ref(locale),
       locales: [],
       localePath: (path: string) => path,
       switchLocalePath: () => {},
       t: (key: string): string => {
         const path = key.split('.')
-        return path.reduce((acc: unknown, curr) => (acc as Record<string, unknown>)?.[curr], en) as string
+        return path.reduce((acc: unknown, curr) => (acc as Record<string, unknown>)?.[curr], localeMessages) as string
       },
     }
   }

package/app/error.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import type { NuxtError } from '#app'
-import type { PageCollections } from '@nuxt/content'
+import type { ContentNavigationItem, PageCollections } from '@nuxt/content'
 import * as nuxtUiLocales from '@nuxt/ui/locale'
 
 const props = defineProps<{
@@ -9,8 +9,10 @@ const props = defineProps<{
 
 const { locale, locales, isEnabled, t, switchLocalePath } = useDocusI18n()
 
-const lang = computed(() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales]?.code || 'en')
-const dir = computed(() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales]?.dir || 'ltr')
+const nuxtUiLocale = computed(() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales] || nuxtUiLocales.en)
+const lang = computed(() => nuxtUiLocale.value.code)
+const dir = computed(() => nuxtUiLocale.value.dir)
+
 useHead({
   htmlAttrs: {
     lang,
@@ -22,6 +24,7 @@ const localizedError = computed(() => {
   return {
     ...props.error,
     statusMessage: t('common.error.title'),
+    message: t('common.error.description'),
   }
 })
 
@@ -44,7 +47,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) => {
+  transform: (data: ContentNavigationItem[]) => {
     const rootResult = data.find(item => item.path === '/docs')?.children || data || []
 
     return rootResult.find(item => item.path === `/${locale.value}`)?.children || rootResult
@@ -59,7 +62,7 @@ provide('navigation', navigation)
 </script>
 
 <template>
-  <UApp>
+  <UApp :locale="nuxtUiLocale">
     <AppHeader />
 
     <UError :error="localizedError" />

package/app/plugins/i18n.ts

@@ -1,12 +1,34 @@
-export default defineNuxtPlugin(() => {
+import en from '../../i18n/locales/en.json'
+import type { RouteLocationNormalized } from 'vue-router'
+
+export default defineNuxtPlugin(async () => {
   const nuxtApp = useNuxtApp()
 
   const i18nConfig = nuxtApp.$config.public.i18n
+
+  // If i18n is not enabled, fetch and provide the configured locale in app config
   if (!i18nConfig) {
-    return
+    let locale = 'en'
+    let resolvedMessages: Record<string, unknown> = en
+
+    const appConfig = useAppConfig()
+    const configuredLocale = appConfig.docus.locale
+    if (configuredLocale !== 'en') {
+      const localeMessages = await import(`../../i18n/locales/${configuredLocale}.json`)
+      if (!localeMessages) {
+        console.warn(`[Docus] Missing locale file for "${configuredLocale}". Falling back to "en".`)
+      }
+      else {
+        locale = configuredLocale
+        resolvedMessages = localeMessages
+      }
+    }
+
+    nuxtApp.provide('locale', locale)
+    nuxtApp.provide('localeMessages', resolvedMessages)
   }
 
-  addRouteMiddleware((to) => {
+  addRouteMiddleware((to: RouteLocationNormalized) => {
     if (to.path === '/') {
       const cookieLocale = useCookie('i18n_redirected').value || i18nConfig.defaultLocale || 'en'
 

package/app/types/index.d.ts

@@ -1,5 +1,8 @@
 declare module 'nuxt/schema' {
   interface AppConfig {
+    docus: {
+      locale: string
+    }
     seo: {
       titleTemplate: string
       title: string

package/i18n/locales/bg.json

@@ -0,0 +1,22 @@
+{
+  "common": {
+    "or": "или",
+    "error": {
+      "title": "Страницата не е намерена",
+      "description": "Съжаляваме, но тази страница не може да бъде намерена."
+    }
+  },
+  "docs": {
+    "copy": {
+      "page": "Копиране на Markdown кода на страницата",
+      "link": "Копиране на връзка към Markdown файла на страницата",
+      "view": "Отваряне на Markdown файла на страницата",
+      "gpt": "Отваряне в ChatGPT",
+      "claude": "Отваряне в Claude"
+    },
+    "links": "Общност",
+    "toc": "На тази страница",
+    "report": "Докладване на проблем",
+    "edit": "Редактиране на тази страница"
+  }
+}

package/i18n/locales/ro.json

@@ -0,0 +1,22 @@
+{
+  "common": {
+    "or": "sau",
+    "error": {
+      "title": "Pagina nu a fost găsită",
+      "description": "Ne pare rău, dar această pagină nu a putut fi găsită."
+    }
+  },
+  "docs": {
+    "copy": {
+      "page": "Copiază pagina",
+      "link": "Copiază pagina în Markdown",
+      "view": "Vezi ca Markdown",
+      "gpt": "Deschide în ChatGPT",
+      "claude": "Deschide în Claude"
+    },
+    "links": "Comunitate",
+    "toc": "Pe această pagină",
+    "report": "Raportează o problemă",
+    "edit": "Editează această pagină"
+  }
+}

package/nuxt.config.ts

@@ -50,6 +50,10 @@ export default defineNuxtConfig({
       failOnError: false,
       autoSubfolderIndex: false,
     },
+    compatibilityDate: {
+      // Don't generate observability routes for now
+      vercel: '2025-07-14',
+    },
   },
   hooks: {
     'nitro:config'(nitroConfig) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.2.3",
+  "version": "5.3.0",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -22,15 +22,15 @@
     "README.md"
   ],
   "dependencies": {
-    "@iconify-json/lucide": "^1.2.73",
-    "@iconify-json/simple-icons": "^1.2.59",
-    "@iconify-json/vscode-icons": "^1.2.35",
-    "@nuxt/content": "https://pkg.pr.new/@nuxt/content@dd854d5",
-    "@nuxt/image": "^1.11.0",
+    "@iconify-json/lucide": "^1.2.75",
+    "@iconify-json/simple-icons": "^1.2.60",
+    "@iconify-json/vscode-icons": "^1.2.36",
+    "@nuxt/content": "^3.8.2",
+    "@nuxt/image": "^2.0.0",
     "@nuxt/kit": "^4.2.1",
-    "@nuxt/ui": "^4.1.0",
+    "@nuxt/ui": "^4.2.1",
     "@nuxtjs/i18n": "^10.2.1",
-    "@nuxtjs/mdc": "^0.18.3",
+    "@nuxtjs/mdc": "^0.18.4",
     "@nuxtjs/robots": "^5.5.6",
     "@vueuse/core": "^13.9.0",
     "defu": "^6.1.4",