docus 5.5.0 → 5.5.1

package/app/app.vue

@@ -81,8 +81,8 @@ provide('navigation', navigation)
         :navigation="navigation"
       />
       <template v-if="isAssistantEnabled">
-        <LazyAssistantFloatingInput />
         <LazyAssistantPanel />
+        <LazyAssistantFloatingInput />
       </template>
     </ClientOnly>
   </UApp>

package/app/composables/useSeo.ts

@@ -0,0 +1,207 @@
+import type { MaybeRefOrGetter } from 'vue'
+import type { BreadcrumbItem } from '../utils/navigation'
+import { joinURL, withoutTrailingSlash } from 'ufo'
+
+export interface UseSeoOptions {
+  /**
+   * Page title
+   */
+  title: MaybeRefOrGetter<string | undefined>
+  /**
+   * Page description
+   */
+  description: MaybeRefOrGetter<string | undefined>
+  /**
+   * Page type for og:type (default: 'article' for docs, 'website' for landing)
+   */
+  type?: MaybeRefOrGetter<'website' | 'article'>
+  /**
+   * Custom OG image URL (absolute)
+   */
+  ogImage?: MaybeRefOrGetter<string | undefined>
+  /**
+   * Published date for article schema
+   */
+  publishedAt?: MaybeRefOrGetter<string | undefined>
+  /**
+   * Modified date for article schema
+   */
+  modifiedAt?: MaybeRefOrGetter<string | undefined>
+  /**
+   * Breadcrumb items for BreadcrumbList schema
+   */
+  breadcrumbs?: MaybeRefOrGetter<BreadcrumbItem[] | undefined>
+}
+
+/**
+ * Composable for comprehensive SEO setup including:
+ * - Meta tags (title, description, og:*, twitter:*)
+ * - Canonical URLs
+ * - Hreflang tags for i18n
+ * - JSON-LD structured data
+ */
+export function useSeo(options: UseSeoOptions) {
+  const route = useRoute()
+  const site = useSiteConfig()
+  const { locale, locales, isEnabled: isI18nEnabled, switchLocalePath } = useDocusI18n()
+
+  const title = computed(() => toValue(options.title))
+  const description = computed(() => toValue(options.description))
+  const type = computed(() => toValue(options.type) || 'article')
+  const ogImage = computed(() => toValue(options.ogImage))
+  const publishedAt = computed(() => toValue(options.publishedAt))
+  const modifiedAt = computed(() => toValue(options.modifiedAt))
+  const breadcrumbs = computed(() => toValue(options.breadcrumbs))
+
+  // Build canonical URL
+  const canonicalUrl = computed(() => {
+    if (!site.url) return undefined
+    return joinURL(site.url, route.path)
+  })
+
+  // Base URL for building other URLs
+  const baseUrl = computed(() => site.url ? withoutTrailingSlash(site.url) : '')
+
+  // Set meta tags
+  useSeoMeta({
+    title,
+    description,
+    ogTitle: title,
+    ogDescription: description,
+    ogType: type,
+    ogUrl: canonicalUrl,
+    ogLocale: computed(() => isI18nEnabled.value ? locale.value : undefined),
+  })
+
+  // Set canonical link
+  useHead({
+    link: computed(() => {
+      const links: Array<{ rel: string, href?: string, hreflang?: string }> = []
+
+      // Canonical URL
+      if (canonicalUrl.value) {
+        links.push({
+          rel: 'canonical',
+          href: canonicalUrl.value,
+        })
+      }
+
+      // Hreflang tags for i18n
+      if (isI18nEnabled.value && baseUrl.value) {
+        for (const loc of locales) {
+          const localePath = switchLocalePath(loc.code)
+          if (localePath) {
+            links.push({
+              rel: 'alternate',
+              hreflang: loc.code,
+              href: joinURL(baseUrl.value, localePath),
+            })
+          }
+        }
+
+        // x-default hreflang (points to default locale)
+        const defaultLocalePath = switchLocalePath(locales[0]?.code || 'en')
+        if (defaultLocalePath) {
+          links.push({
+            rel: 'alternate',
+            hreflang: 'x-default',
+            href: joinURL(baseUrl.value, defaultLocalePath),
+          })
+        }
+      }
+
+      return links
+    }),
+  })
+
+  // Custom OG image handling
+  if (ogImage.value) {
+    useSeoMeta({
+      ogImage: ogImage.value,
+      twitterImage: ogImage.value,
+    })
+  }
+
+  // JSON-LD structured data
+  useHead({
+    script: computed(() => {
+      const scripts: Array<{ type: string, innerHTML: string }> = []
+
+      if (!baseUrl.value || !title.value) return scripts
+
+      const pageUrl = joinURL(baseUrl.value, route.path)
+
+      // Article schema for documentation pages
+      if (type.value === 'article') {
+        const articleSchema: Record<string, unknown> = {
+          '@context': 'https://schema.org',
+          '@type': 'Article',
+          'headline': title.value,
+          'description': description.value,
+          'url': pageUrl,
+          'mainEntityOfPage': {
+            '@type': 'WebPage',
+            '@id': pageUrl,
+          },
+        }
+
+        if (publishedAt.value) {
+          articleSchema.datePublished = publishedAt.value
+        }
+
+        if (modifiedAt.value) {
+          articleSchema.dateModified = modifiedAt.value
+        }
+
+        if (site.name) {
+          articleSchema.publisher = {
+            '@type': 'Organization',
+            'name': site.name,
+          }
+        }
+
+        scripts.push({
+          type: 'application/ld+json',
+          innerHTML: JSON.stringify(articleSchema),
+        })
+      }
+
+      // WebSite schema for landing pages
+      if (type.value === 'website') {
+        const websiteSchema: Record<string, unknown> = {
+          '@context': 'https://schema.org',
+          '@type': 'WebSite',
+          'name': site.name || title.value,
+          'description': description.value,
+          'url': baseUrl.value,
+        }
+
+        scripts.push({
+          type: 'application/ld+json',
+          innerHTML: JSON.stringify(websiteSchema),
+        })
+      }
+
+      // BreadcrumbList schema for navigation
+      if (breadcrumbs.value && breadcrumbs.value.length > 0) {
+        const breadcrumbSchema = {
+          '@context': 'https://schema.org',
+          '@type': 'BreadcrumbList',
+          'itemListElement': breadcrumbs.value.map((item, index) => ({
+            '@type': 'ListItem',
+            'position': index + 1,
+            'name': item.title,
+            'item': joinURL(baseUrl.value, item.path),
+          })),
+        }
+
+        scripts.push({
+          type: 'application/ld+json',
+          innerHTML: JSON.stringify(breadcrumbSchema),
+        })
+      }
+
+      return scripts
+    }),
+  })
+}

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

@@ -31,14 +31,16 @@ if (!page.value) {
 const title = page.value.seo?.title || page.value.title
 const description = page.value.seo?.description || page.value.description
 
-useSeoMeta({
+const headline = ref(findPageHeadline(navigation?.value, page.value?.path))
+const breadcrumbs = computed(() => findPageBreadcrumbs(navigation?.value, page.value?.path || ''))
+
+useSeo({
   title,
-  ogTitle: title,
   description,
-  ogDescription: description,
+  type: 'article',
+  modifiedAt: (page.value as unknown as Record<string, unknown>).modifiedAt as string | undefined,
+  breadcrumbs,
 })
-
-const headline = ref(findPageHeadline(navigation?.value, page.value?.path))
 watch(() => navigation?.value, () => {
   headline.value = findPageHeadline(navigation?.value, page.value?.path) || headline.value
 })
@@ -99,9 +101,8 @@ addPrerenderPath(`/raw${route.path}.md`)
         :value="page"
       />
 
-      <USeparator>
+      <USeparator v-if="github">
         <div
-          v-if="github"
           class="flex items-center gap-2 text-sm text-muted"
         >
           <UButton

package/app/templates/landing.vue

@@ -15,20 +15,14 @@ if (!page.value) {
 const title = page.value.seo?.title || page.value.title
 const description = page.value.seo?.description || page.value.description
 
-useSeoMeta({
+useSeo({
   title,
   description,
-  ogTitle: title,
-  ogDescription: description,
+  type: 'website',
+  ogImage: page.value?.seo?.ogImage as string | undefined,
 })
 
-if (page.value?.seo?.ogImage) {
-  useSeoMeta({
-    ogImage: page.value.seo.ogImage,
-    twitterImage: page.value.seo.ogImage,
-  })
-}
-else {
+if (!page.value?.seo?.ogImage) {
   defineOgImageComponent('Landing', {
     title,
     description,

package/app/utils/navigation.ts

@@ -5,3 +5,34 @@ export const flattenNavigation = (items?: ContentNavigationItem[]): ContentNavig
     ? flattenNavigation(item.children)
     : [item],
 ) || []
+
+export interface BreadcrumbItem {
+  title: string
+  path: string
+}
+
+/**
+ * Find breadcrumb path to a page in the navigation tree
+ */
+export function findPageBreadcrumbs(
+  navigation: ContentNavigationItem[] | undefined,
+  path: string,
+  currentPath: BreadcrumbItem[] = [],
+): BreadcrumbItem[] | undefined {
+  if (!navigation) return undefined
+
+  for (const item of navigation) {
+    const itemPath = [...currentPath, { title: item.title, path: item.path }]
+
+    if (item.path === path) {
+      return itemPath
+    }
+
+    if (item.children) {
+      const found = findPageBreadcrumbs(item.children, path, itemPath)
+      if (found) return found
+    }
+  }
+
+  return undefined
+}

package/modules/assistant/index.ts

@@ -67,7 +67,7 @@ export default defineNuxtModule<AssistantModuleOptions>({
     )
 
     if (!hasApiKey) {
-      log.warn('[Docus] AI assistant disabled: AI_GATEWAY_API_KEY not found')
+      log.warn('AI assistant disabled: AI_GATEWAY_API_KEY not found')
       return
     }
 

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

@@ -62,43 +62,48 @@ defineShortcuts(shortcuts)
       :animate="{ y: 0, opacity: 1 }"
       :exit="{ y: 100, opacity: 0 }"
       :transition="{ duration: 0.2, ease: 'easeOut' }"
-      class="fixed bottom-6 left-1/2 -translate-x-1/2 z-50 px-4"
+      class="fixed inset-x-0 z-10 px-4 sm:px-80 bottom-[max(1.5rem,env(safe-area-inset-bottom))]"
       style="will-change: transform"
     >
-      <form @submit.prevent="handleSubmit">
-        <UInput
-          ref="inputRef"
-          v-model="input"
-          :placeholder="placeholder"
-          size="lg"
-          maxlength="1000"
-          :ui="{
-            root: 'group w-72 focus-within:w-96 transition-all duration-300 ease-out hover:scale-105 focus-within:scale-105',
-            base: 'bg-default shadow-lg rounded-xl',
-            trailing: 'pe-2',
-          }"
-          @keydown.enter.exact.prevent="handleSubmit"
-        >
-          <template #trailing>
-            <div class="flex items-center gap-2">
-              <div class="hidden sm:flex group-focus-within:hidden items-center gap-1">
-                <UKbd
-                  v-for="key in shortcutDisplayKeys"
-                  :key="key"
-                  :value="key"
+      <form
+        class="flex w-full justify-center"
+        @submit.prevent="handleSubmit"
+      >
+        <div class="w-full max-w-96">
+          <UInput
+            ref="inputRef"
+            v-model="input"
+            :placeholder="placeholder"
+            size="lg"
+            maxlength="1000"
+            :ui="{
+              root: 'group w-full! min-w-0 sm:max-w-96 transition-all duration-300 ease-out [@media(hover:hover)]:hover:scale-105 [@media(hover:hover)]:focus-within:scale-105',
+              base: 'bg-default shadow-lg rounded-xl text-base',
+              trailing: 'pe-2',
+            }"
+            @keydown.enter.exact.prevent="handleSubmit"
+          >
+            <template #trailing>
+              <div class="flex items-center gap-2">
+                <div class="hidden sm:flex group-focus-within:hidden items-center gap-1">
+                  <UKbd
+                    v-for="key in shortcutDisplayKeys"
+                    :key="key"
+                    :value="key"
+                  />
+                </div>
+
+                <UButton
+                  type="submit"
+                  icon="i-lucide-arrow-up"
+                  color="primary"
+                  size="xs"
+                  :disabled="!input.trim()"
                 />
               </div>
-
-              <UButton
-                type="submit"
-                icon="i-lucide-arrow-up"
-                color="primary"
-                size="xs"
-                :disabled="!input.trim()"
-              />
-            </div>
-          </template>
-        </UInput>
+            </template>
+          </UInput>
+        </div>
       </form>
     </motion.div>
   </AnimatePresence>

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

@@ -263,7 +263,7 @@ onMounted(() => {
           maxlength="1000"
           :ui="{
             root: 'shadow-none!',
-            body: '*:p-0! *:rounded-none! *:text-sm!',
+            body: '*:p-0! *:rounded-none! *:text-base!',
           }"
           @submit="handleSubmit"
         >

package/modules/config.ts

@@ -16,7 +16,7 @@ export default defineNuxtModule({
     const url = inferSiteURL()
     const meta = await getPackageJsonMetadata(dir)
     const gitInfo = await getLocalGitInfo(dir) || getGitEnv()
-    const siteName = nuxt.options?.site?.name || meta.name || gitInfo?.name || ''
+    const siteName = (typeof nuxt.options.site === 'object' && nuxt.options.site?.name) || meta.name || gitInfo?.name || ''
 
     nuxt.options.llms = defu(nuxt.options.llms, {
       domain: url,

package/modules/css.ts

@@ -29,6 +29,8 @@ export default defineNuxtModule({
       },
     })
 
-    nuxt.options.css.unshift(cssTemplate.dst)
+    if (Array.isArray(nuxt.options.css)) {
+      nuxt.options.css.unshift(cssTemplate.dst)
+    }
   },
 })

package/nuxt.config.ts

@@ -93,4 +93,13 @@ export default defineNuxtConfig({
   icon: {
     provider: 'iconify',
   },
+  robots: {
+    groups: [
+      {
+        userAgent: '*',
+        allow: '/',
+      },
+    ],
+    sitemap: '/sitemap.xml',
+  },
 })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.5.0",
+  "version": "5.5.1",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -22,27 +22,27 @@
     "README.md"
   ],
   "dependencies": {
-    "@ai-sdk/gateway": "^3.0.32",
-    "@ai-sdk/mcp": "^1.0.18",
-    "@ai-sdk/vue": "3.0.69",
-    "@iconify-json/lucide": "^1.2.88",
-    "@iconify-json/simple-icons": "^1.2.69",
-    "@iconify-json/vscode-icons": "^1.2.40",
-    "@nuxt/content": "^3.11.0",
+    "@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",
+    "@nuxt/content": "^3.11.2",
     "@nuxt/image": "^2.0.0",
-    "@nuxt/kit": "^4.3.0",
+    "@nuxt/kit": "^4.3.1",
     "@nuxt/ui": "^4.4.0",
-    "@nuxtjs/i18n": "^10.2.1",
-    "@nuxtjs/mcp-toolkit": "^0.6.2",
-    "@nuxtjs/mdc": "^0.20.0",
+    "@nuxtjs/i18n": "^10.2.3",
+    "@nuxtjs/mcp-toolkit": "^0.6.3",
+    "@nuxtjs/mdc": "^0.20.1",
     "@nuxtjs/robots": "^5.7.0",
-    "@vueuse/core": "^14.2.0",
-    "ai": "6.0.69",
+    "@vueuse/core": "^14.2.1",
+    "ai": "6.0.78",
     "defu": "^6.1.4",
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",
-    "minimark": "^0.2.0",
-    "motion-v": "^1.10.2",
+    "minimark": "^1.0.0",
+    "motion-v": "^1.10.3",
     "nuxt-llms": "^0.2.0",
     "nuxt-og-image": "^5.1.13",
     "pkg-types": "^2.3.0",

package/server/routes/sitemap.xml.ts

@@ -2,6 +2,11 @@ import { queryCollection } from '@nuxt/content/server'
 import { getAvailableLocales, getCollectionsToQuery } from '../utils/content'
 import { inferSiteURL } from '../../utils/meta'
 
+interface SitemapUrl {
+  loc: string
+  lastmod?: string
+}
+
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig(event)
   const siteUrl = inferSiteURL() || ''
@@ -18,7 +23,7 @@ export default defineEventHandler(async (event) => {
     collections.push('landing')
   }
 
-  const urls: Array<{ loc: string }> = []
+  const urls: SitemapUrl[] = []
 
   for (const collection of collections) {
     try {
@@ -34,9 +39,16 @@ export default defineEventHandler(async (event) => {
         // Skip .navigation files (used for navigation configuration)
         if (pagePath.endsWith('.navigation') || pagePath.includes('/.navigation')) continue
 
-        urls.push({
+        const urlEntry: SitemapUrl = {
           loc: pagePath,
-        })
+        }
+
+        // Add lastmod if available (modifiedAt from content)
+        if (meta.modifiedAt && typeof meta.modifiedAt === 'string') {
+          urlEntry.lastmod = meta.modifiedAt.split('T')[0] // Use date part only (YYYY-MM-DD)
+        }
+
+        urls.push(urlEntry)
       }
     }
     catch {
@@ -50,11 +62,18 @@ export default defineEventHandler(async (event) => {
   return sitemap
 })
 
-function generateSitemap(urls: Array<{ loc: string }>, siteUrl: string): string {
+function generateSitemap(urls: SitemapUrl[], siteUrl: string): string {
   const urlEntries = urls
     .map((url) => {
       const loc = siteUrl ? `${siteUrl}${url.loc}` : url.loc
-      return `  <url>\n    <loc>${escapeXml(loc)}</loc>\n  </url>`
+      let entry = `  <url>\n    <loc>${escapeXml(loc)}</loc>`
+
+      if (url.lastmod) {
+        entry += `\n    <lastmod>${escapeXml(url.lastmod)}</lastmod>`
+      }
+
+      entry += `\n  </url>`
+      return entry
     })
     .join('\n')