docus 5.12.1 → 5.12.3

package/i18n/locales/si.json

@@ -43,7 +43,6 @@
     "close": "වසන්න",
     "expand": "පුළුල් කරන්න",
     "collapse": "හකුළන්න",
-    "thinking": "සිතමින්...",
     "askMeAnything": "ඕන දෙයක් අහන්න",
     "askMeAnythingDescription": "ලේඛන සැරිසැරීමට, සංකල්ප තේරුම් ගැනීමට සහ පිළිතුරු සෙවීමට උදවු ලබා ගන්න.",
     "faq": "නිතර අසන පැන",
@@ -52,7 +51,22 @@
     "explainWithAi": "AI සමඟ පැහැදිලි කරන්න",
     "toolListPages": "ලැයිස්තුගත ලේඛන පිටු",
     "toolReadPage": "කියවන්න",
+    "tools": {
+      "searching": "සොයමින්",
+      "searched": "සෙව්වා",
+      "reading": "කියවමින්",
+      "read": "කියෙව්වා",
+      "finding": "සොයමින්",
+      "found": "හමු විය",
+      "opening": "විවෘත කරමින්",
+      "opened": "විවෘත කළා",
+      "generating": "ජනනය කරමින්",
+      "generated": "ජනනය කළා",
+      "creating": "සාදමින්",
+      "created": "සෑදුවා"
+    },
     "loading": {
+      "thinking": "සිතමින්...",
       "searching": "ලේඛන සෙවීම",
       "reading": "ලේඛන හරහා කියවීම",
       "analyzing": "අන්තර්ගතය විශ්ලේෂණය කිරීම",

package/i18n/locales/sl.json

@@ -43,7 +43,6 @@
     "close": "Zapri",
     "expand": "Razširi",
     "collapse": "Strni",
-    "thinking": "Razmišljanje...",
     "askMeAnything": "Vprašaj karkoli",
     "askMeAnythingDescription": "Poiščite pomoč pri krmarjenju po dokumentaciji, razumevanju konceptov in iskanju odgovorov.",
     "faq": "Pogosta vprašanja",
@@ -52,7 +51,22 @@
     "explainWithAi": "Razloži z AI",
     "toolListPages": "Navedene strani dokumentacije",
     "toolReadPage": "Preberi",
+    "tools": {
+      "searching": "Iskanje",
+      "searched": "Najdeno",
+      "reading": "Branje",
+      "read": "Prebrano",
+      "finding": "Iskanje",
+      "found": "Najdeno",
+      "opening": "Odpiranje",
+      "opened": "Odprto",
+      "generating": "Generiranje",
+      "generated": "Generirano",
+      "creating": "Ustvarjanje",
+      "created": "Ustvarjeno"
+    },
     "loading": {
+      "thinking": "Razmišljanje...",
       "searching": "Iskanje po dokumentaciji",
       "reading": "Prebiranje dokumentov",
       "analyzing": "Analiza vsebine",

package/i18n/locales/sv.json

@@ -43,7 +43,6 @@
     "close": "Stäng",
     "expand": "Expandera",
     "collapse": "Kollapsa",
-    "thinking": "Funderar...",
     "askMeAnything": "Fråga vad som helst",
     "askMeAnythingDescription": "Få hjälp med att navigera i dokumentationen, förstå begrepp och hitta svar.",
     "faq": "FAQ",
@@ -52,7 +51,22 @@
     "explainWithAi": "Förklara med AI",
     "toolListPages": "Listade dokumentationssidor",
     "toolReadPage": "Läs",
+    "tools": {
+      "searching": "Söker",
+      "searched": "Sökt",
+      "reading": "Läser",
+      "read": "Läst",
+      "finding": "Söker",
+      "found": "Hittade",
+      "opening": "Öppnar",
+      "opened": "Öppnad",
+      "generating": "Genererar",
+      "generated": "Genererad",
+      "creating": "Skapar",
+      "created": "Skapad"
+    },
     "loading": {
+      "thinking": "Funderar...",
       "searching": "Söker i dokumentationen",
       "reading": "Läser igenom dokumenten",
       "analyzing": "Analysera innehållet",

package/i18n/locales/tr.json

@@ -43,7 +43,6 @@
     "close": "Kapat",
     "expand": "Genişlet",
     "collapse": "Daralt",
-    "thinking": "Düşünüyorum...",
     "askMeAnything": "Her şeyi sor",
     "askMeAnythingDescription": "Belgelerde gezinme, kavramları anlama ve yanıt bulma konusunda yardım alın.",
     "faq": "SSS",
@@ -52,7 +51,22 @@
     "explainWithAi": "Yapay zeka ile açıklayın",
     "toolListPages": "Listelenen dokümantasyon sayfaları",
     "toolReadPage": "Oku",
+    "tools": {
+      "searching": "Aranıyor",
+      "searched": "Arandı",
+      "reading": "Okunuyor",
+      "read": "Okundu",
+      "finding": "Aranıyor",
+      "found": "Bulundu",
+      "opening": "Açılıyor",
+      "opened": "Açıldı",
+      "generating": "Üretiliyor",
+      "generated": "Üretildi",
+      "creating": "Oluşturuluyor",
+      "created": "Oluşturuldu"
+    },
     "loading": {
+      "thinking": "Düşünüyorum...",
       "searching": "Dokümantasyonda arama",
       "reading": "Dokümanlar okunuyor",
       "analyzing": "İçerik analiz ediliyor",

package/i18n/locales/uk.json

@@ -43,7 +43,6 @@
     "close": "Закрити",
     "expand": "Розгорнути",
     "collapse": "Згорнути",
-    "thinking": "Думаючи...",
     "askMeAnything": "Запитайте будь-що",
     "askMeAnythingDescription": "Отримайте допомогу в навігації документацією, розумінні понять і пошуку відповідей.",
     "faq": "Поширені запитання",
@@ -52,7 +51,22 @@
     "explainWithAi": "Поясніть за допомогою ШІ",
     "toolListPages": "Перелічені сторінки документації",
     "toolReadPage": "Читати",
+    "tools": {
+      "searching": "Пошук",
+      "searched": "Знайдено",
+      "reading": "Читання",
+      "read": "Прочитано",
+      "finding": "Пошук",
+      "found": "Знайдено",
+      "opening": "Відкриття",
+      "opened": "Відкрито",
+      "generating": "Генерація",
+      "generated": "Згенеровано",
+      "creating": "Створення",
+      "created": "Створено"
+    },
     "loading": {
+      "thinking": "Думаючи...",
       "searching": "Пошук документації",
       "reading": "Читання документів",
       "analyzing": "Аналіз змісту",

package/i18n/locales/ur.json

@@ -43,7 +43,6 @@
     "close": "بند",
     "expand": "پھیلائیں۔",
     "collapse": "سمٹنا",
-    "thinking": "سوچ رہا ہے...",
     "askMeAnything": "کچھ بھی پوچھو",
     "askMeAnythingDescription": "دستاویزات کو نیویگیٹ کرنے، تصورات کو سمجھنے اور جوابات تلاش کرنے میں مدد حاصل کریں۔",
     "faq": "اکثر پوچھے گئے سوالات",
@@ -52,7 +51,22 @@
     "explainWithAi": "AI کے ساتھ وضاحت کریں۔",
     "toolListPages": "درج دستاویزات کے صفحات",
     "toolReadPage": "پڑھیں",
+    "tools": {
+      "searching": "تلاش جاری",
+      "searched": "تلاش مکمل",
+      "reading": "پڑھ رہے ہیں",
+      "read": "پڑھا",
+      "finding": "تلاش جاری",
+      "found": "مل گیا",
+      "opening": "کھول رہے ہیں",
+      "opened": "کھولا",
+      "generating": "تیار کر رہے ہیں",
+      "generated": "تیار کیا",
+      "creating": "بنا رہے ہیں",
+      "created": "بنایا"
+    },
     "loading": {
+      "thinking": "سوچ رہا ہے...",
       "searching": "دستاویزات کی تلاش",
       "reading": "دستاویزات کے ذریعے پڑھنا",
       "analyzing": "مواد کا تجزیہ",

package/i18n/locales/vi.json

@@ -43,7 +43,6 @@
     "close": "Đóng",
     "expand": "Mở rộng",
     "collapse": "Thu gọn",
-    "thinking": "Đang suy nghĩ...",
     "askMeAnything": "Hỏi bất cứ điều gì",
     "askMeAnythingDescription": "Nhận trợ giúp điều hướng tài liệu, hiểu các khái niệm và tìm câu trả lời.",
     "faq": "Câu hỏi thường gặp",
@@ -52,7 +51,22 @@
     "explainWithAi": "Giải thích bằng AI",
     "toolListPages": "Các trang tài liệu được liệt kê",
     "toolReadPage": "Đọc",
+    "tools": {
+      "searching": "Đang tìm",
+      "searched": "Đã tìm",
+      "reading": "Đang đọc",
+      "read": "Đã đọc",
+      "finding": "Đang tìm",
+      "found": "Đã tìm thấy",
+      "opening": "Đang mở",
+      "opened": "Đã mở",
+      "generating": "Đang tạo",
+      "generated": "Đã tạo",
+      "creating": "Đang tạo",
+      "created": "Đã tạo"
+    },
     "loading": {
+      "thinking": "Đang suy nghĩ...",
       "searching": "Tìm kiếm tài liệu",
       "reading": "Đọc qua tài liệu",
       "analyzing": "Phân tích nội dung",

package/i18n/locales/zh-CN.json

@@ -43,7 +43,6 @@
     "close": "关闭",
     "expand": "展开",
     "collapse": "崩溃",
-    "thinking": "想着……",
     "askMeAnything": "询问任何事情",
     "askMeAnythingDescription": "获取浏览文档、理解概念和寻找答案的帮助。",
     "faq": "常见问题解答",
@@ -52,7 +51,22 @@
     "explainWithAi": "用AI解释",
     "toolListPages": "列出的文档页面",
     "toolReadPage": "阅读",
+    "tools": {
+      "searching": "搜索中",
+      "searched": "已搜索",
+      "reading": "读取中",
+      "read": "已读取",
+      "finding": "搜索中",
+      "found": "已找到",
+      "opening": "打开中",
+      "opened": "已打开",
+      "generating": "生成中",
+      "generated": "已生成",
+      "creating": "创建中",
+      "created": "已创建"
+    },
     "loading": {
+      "thinking": "想着……",
       "searching": "搜索文档",
       "reading": "通读文档",
       "analyzing": "分析内容",

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

@@ -49,6 +49,18 @@ defineShortcuts(shortcuts)
 function onEscape() {
   inputRef.value?.inputRef?.blur()
 }
+
+function onKeydown(event: KeyboardEvent) {
+  if (event.key === 'Enter' && !event.shiftKey && !event.altKey && !event.ctrlKey && !event.metaKey) {
+    event.preventDefault()
+    handleSubmit()
+    return
+  }
+
+  if (event.key === 'Escape') {
+    onEscape()
+  }
+}
 </script>
 
 <template>
@@ -79,8 +91,7 @@ function onEscape() {
               base: 'bg-default shadow-lg rounded-xl text-base',
               trailing: 'pe-2',
             }"
-            @keydown.enter.exact.prevent="handleSubmit"
-            @keydown.escape="onEscape"
+            @keydown="onKeydown"
           >
             <template #trailing>
               <div class="flex items-center gap-2">

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

@@ -1,4 +1,8 @@
 <script setup lang="ts">
+import { useDocusI18n } from '../../../../app/composables/useDocusI18n'
+
+const { t } = useDocusI18n()
+
 const size = 4
 const dotSize = 2
 const gap = 2
@@ -32,9 +36,14 @@ function nextStep() {
   }
 }
 
-const statusMessages = ['Thinking...', 'Searching...', 'Reading...', 'Analyzing...']
+const statusMessages = computed(() => [
+  t('assistant.loading.thinking'),
+  t('assistant.loading.searching'),
+  t('assistant.loading.reading'),
+  t('assistant.loading.analyzing'),
+])
 const currentIndex = ref(0)
-const displayedText = ref(statusMessages[0]!)
+const displayedText = ref(statusMessages.value[0]!)
 const chars = 'abcdefghijklmnopqrstuvwxyz'
 
 function scramble(from: string, to: string) {
@@ -80,8 +89,8 @@ onMounted(() => {
   matrixInterval = setInterval(nextStep, 120)
   textInterval = setInterval(() => {
     const prev = displayedText.value
-    currentIndex.value = (currentIndex.value + 1) % statusMessages.length
-    scramble(prev, statusMessages[currentIndex.value]!)
+    currentIndex.value = (currentIndex.value + 1) % statusMessages.value.length
+    scramble(prev, statusMessages.value[currentIndex.value]!)
   }, 3500)
 })
 
@@ -92,7 +101,7 @@ onUnmounted(() => {
 </script>
 
 <template>
-  <div class="flex items-center text-xs text-muted overflow-hidden">
+  <div class="flex items-center text-sm text-muted overflow-hidden">
     <div
       class="shrink-0 mr-2 grid"
       :style="{
@@ -111,6 +120,6 @@ onUnmounted(() => {
       />
     </div>
 
-    <UChatShimmer :text="displayedText" class="font-mono tracking-tight" />
+    <UChatShimmer :text="displayedText" />
   </div>
 </template>

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

@@ -1,9 +1,10 @@
 <script setup lang="ts">
 import type { ToolUIPart, DynamicToolUIPart } from 'ai'
-import { DefaultChatTransport, isToolUIPart, isReasoningUIPart, isTextUIPart, getToolName } from 'ai'
+import { DefaultChatTransport, isToolUIPart, isReasoningUIPart, isTextUIPart } from 'ai'
 import { Chat } from '@ai-sdk/vue'
 import { isPartStreaming, isToolStreaming } from '@nuxt/ui/utils/ai'
 import { useDocusI18n } from '../../../../app/composables/useDocusI18n'
+import { getToolText, getToolSuffix, getToolIcon } from '../../../../app/utils/assistantTools'
 import AssistantComark from './AssistantComark'
 import AssistantIndicator from './AssistantIndicator.vue'
 
@@ -22,6 +23,12 @@ const open = computed({
   },
 })
 
+const promptRef = ref<{ textareaRef?: HTMLTextAreaElement } | null>(null)
+watch(open, (value) => {
+  if (!value) return
+  nextTick(() => promptRef.value?.textareaRef?.focus({ preventScroll: true }))
+})
+
 const displayTitle = computed(() => t('assistant.title'))
 const displayPlaceholder = computed(() => t('assistant.placeholder'))
 
@@ -71,54 +78,22 @@ watch(messages, (newMessages) => {
 const canClear = computed(() => messages.value.length > 0)
 
 type ToolPart = ToolUIPart | DynamicToolUIPart
-type ToolState = ToolPart['state']
-
-function getToolMessage(state: ToolState, toolName: string, input: Record<string, string | undefined>) {
-  const searchVerb = state === 'output-available' ? 'Searched' : 'Searching'
-  const readVerb = state === 'output-available' ? 'Read' : 'Reading'
-
-  return {
-    'list-pages': `${searchVerb} pages`,
-    'get-page': `${readVerb} ${input.path || '...'}`,
-  }[toolName] || `${searchVerb} ${toolName}`
-}
-
-function getToolText(part: ToolPart) {
-  return getToolMessage(part.state, getToolName(part), (part.input || {}) as Record<string, string | undefined>)
-}
-
-function getToolIcon(part: ToolPart): string {
-  const toolName = getToolName(part)
-
-  return {
-    'get-page': 'i-lucide-file-text',
-  }[toolName] || 'i-lucide-search'
-}
 
 function getToolOutput(part: ToolPart): string | undefined {
   if (part.state !== 'output-available' || !part.output) return undefined
 
   const output = part.output as Record<string, unknown>
+  const content = (output.content ?? output) as Array<{ text?: string }> | string
 
-  if (getToolName(part) === 'list-pages') {
-    const content = (output.content ?? output) as Array<{ text?: string }> | string
-    if (typeof content === 'string') return content
-    return content
-      ?.map(c => c.text)
-      .filter(Boolean)
-      .join('\n') || undefined
+  if (typeof content === 'string') {
+    return content || undefined
   }
 
-  if (getToolName(part) === 'get-page') {
-    const content = (output.content ?? output) as Array<{ text?: string }> | string
-    if (typeof content === 'string') {
-      return content.length > 500 ? `${content.slice(0, 500)}…` : content
-    }
-    const text = content?.map(c => c.text).filter(Boolean).join('\n') || ''
-    return text.length > 500 ? `${text.slice(0, 500)}…` : text || undefined
+  if (Array.isArray(content)) {
+    return content.map(c => c.text).filter(Boolean).join('\n') || undefined
   }
 
-  return JSON.stringify(output, null, 2).slice(0, 500)
+  return JSON.stringify(output, null, 2)
 }
 
 function onSubmit() {
@@ -214,7 +189,7 @@ defineShortcuts({
         :status="chat.status"
         compact
         class="px-0 gap-2"
-        :user="{ ui: { container: 'max-w-full' } }"
+        :user="{ ui: { container: 'max-w-full pb-3' } }"
       >
         <template #indicator>
           <AssistantIndicator />
@@ -230,6 +205,7 @@ defineShortcuts({
               :text="part.text"
               :streaming="isPartStreaming(part)"
               icon="i-lucide-brain"
+              chevron="leading"
             >
               <AssistantComark
                 :markdown="part.text"
@@ -253,14 +229,15 @@ defineShortcuts({
 
             <UChatTool
               v-else-if="isToolUIPart(part)"
-              :text="getToolText(part)"
+              :text="getToolText(part, t)"
+              :suffix="getToolSuffix(part)"
               :icon="getToolIcon(part)"
               :streaming="isToolStreaming(part)"
               chevron="leading"
             >
               <pre
                 v-if="getToolOutput(part)"
-                class="text-xs text-dimmed whitespace-pre-wrap"
+                class="text-xs text-muted whitespace-pre-wrap break-all rounded-md border border-muted bg-muted p-2 max-h-64 overflow-y-auto"
                 v-text="getToolOutput(part)"
               />
             </UChatTool>
@@ -302,6 +279,7 @@ defineShortcuts({
 
     <template #footer>
       <UChatPrompt
+        ref="promptRef"
         v-model="input"
         :error="chat.error"
         :placeholder="displayPlaceholder"

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

@@ -1,4 +1,4 @@
-import { streamText, convertToModelMessages } from 'ai'
+import { streamText, convertToModelMessages, stepCountIs, smoothStream } from 'ai'
 import type { ToolSet } from 'ai'
 import { createMCPClient } from '@ai-sdk/mcp'
 import type { H3Event } from 'h3'
@@ -22,19 +22,6 @@ function createLocalFetch(event: H3Event): typeof fetch {
   }
 }
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function stopWhenResponseComplete({ steps }: { steps: { text?: string, toolCalls?: unknown[] }[] }): boolean {
-  const lastStep = steps.at(-1)
-  if (!lastStep) return false
-
-  const hasText = Boolean(lastStep.text && lastStep.text.trim().length > 0)
-  const hasNoToolCalls = !lastStep.toolCalls || lastStep.toolCalls.length === 0
-
-  if (hasText && hasNoToolCalls) return true
-
-  return steps.length >= MAX_STEPS
-}
-
 function getSystemPrompt(siteName: string) {
   return `You are the documentation assistant for ${siteName}. Help users navigate and understand the project documentation.
 
@@ -115,13 +102,24 @@ export default defineEventHandler(async (event) => {
 
   return streamText({
     model: config.assistant.model,
-    maxOutputTokens: 4000,
+    maxOutputTokens: 8000,
     maxRetries: 2,
     abortSignal: abortController.signal,
-    stopWhen: stopWhenResponseComplete,
+    stopWhen: stepCountIs(MAX_STEPS),
+    // On the last allowed step, disable tools so the model is forced to
+    // produce a final text answer instead of stopping mid tool-calling.
+    prepareStep: ({ stepNumber }) => {
+      return stepNumber >= MAX_STEPS - 1 ? { toolChoice: 'none' } : {}
+    },
+    providerOptions: {
+      gateway: {
+        caching: 'auto',
+      },
+    },
     system: getSystemPrompt(siteName),
     messages: await convertToModelMessages(messages),
     tools: mcpTools as ToolSet,
+    experimental_transform: smoothStream(),
     onFinish: closeMcp,
     onAbort: closeMcp,
     onError: closeMcp,

package/modules/css.ts

@@ -14,6 +14,7 @@ export default defineNuxtModule({
     const resolver = createResolver(import.meta.url)
 
     const contentDir = resolve(nuxt.options.rootDir, 'content')
+    const appConfigPath = resolve(nuxt.options.srcDir, 'app.config.ts')
     const uiPath = resolveModulePath('@nuxt/ui', { from: import.meta.url, conditions: ['style'] })
     const tailwindPath = resolveModulePath('tailwindcss', { from: import.meta.url, conditions: ['style'] })
     const layerDir = resolver.resolve('../app')
@@ -34,13 +35,14 @@ export default defineNuxtModule({
 
     const cssTemplate = addTemplate({
       filename: 'docus.css',
+      write: true,
       getContents: () => {
         return `@import ${JSON.stringify(tailwindPath)};
 @import ${JSON.stringify(uiPath)};
 
 @source "${contentDir.replace(/\\/g, '/')}/**/*";
 @source "${layerDir.replace(/\\/g, '/')}/**/*";
-@source "../../app.config.ts";
+@source "${appConfigPath.replace(/\\/g, '/')}";
 @source "${assistantDir.replace(/\\/g, '/')}/**/*";
 
 html.dark .shiki span {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.12.1",
+  "version": "5.12.3",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -23,39 +23,39 @@
     "README.md"
   ],
   "dependencies": {
-    "@ai-sdk/gateway": "^3.0.120",
-    "@ai-sdk/mcp": "^1.0.43",
-    "@ai-sdk/vue": "^3.0.191",
+    "@ai-sdk/gateway": "^3.0.133",
+    "@ai-sdk/mcp": "^1.0.52",
+    "@ai-sdk/vue": "^3.0.208",
     "@comark/vue": "^0.4.0",
-    "@iconify-json/lucide": "^1.2.111",
-    "@iconify-json/simple-icons": "^1.2.85",
-    "@iconify-json/vscode-icons": "^1.2.53",
+    "@iconify-json/lucide": "^1.2.114",
+    "@iconify-json/simple-icons": "^1.2.87",
+    "@iconify-json/vscode-icons": "^1.2.59",
     "@nuxt/content": "^3.14.0",
     "@nuxt/image": "^2.0.0",
-    "@nuxt/kit": "^4.4.7",
-    "@nuxt/ui": "^4.8.1",
+    "@nuxt/kit": "^4.4.8",
+    "@nuxt/ui": "^4.9.0",
     "@nuxtjs/i18n": "^10.4.0",
     "@nuxtjs/mcp-toolkit": "^0.17.2",
     "@nuxtjs/mdc": "^0.22.0",
-    "@nuxtjs/robots": "^6.0.9",
+    "@nuxtjs/robots": "^6.1.1",
     "@shikijs/core": "^4.2.0",
     "@shikijs/engine-javascript": "^4.2.0",
     "@shikijs/langs": "^4.2.0",
     "@shikijs/stream": "^4.2.0",
     "@shikijs/themes": "^4.2.0",
-    "@takumi-rs/core": "^1.6.0",
+    "@takumi-rs/core": "^1.8.7",
     "@vueuse/core": "^14.3.0",
-    "ai": "^6.0.191",
+    "ai": "^6.0.208",
     "defu": "^6.1.7",
-    "exsolve": "^1.0.8",
+    "exsolve": "^1.1.0",
     "git-url-parse": "^16.1.0",
-    "motion-v": "^2.2.1",
+    "motion-v": "^2.3.0",
     "nuxt-llms": "^0.2.0",
-    "nuxt-og-image": "^6.5.1",
+    "nuxt-og-image": "~6.6.0",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.1",
     "scule": "^1.3.0",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "ufo": "^1.6.4",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",