docus 5.9.0 → 5.10.0

package/i18n/locales/si.json

@@ -32,5 +32,32 @@
     "wordmarkDownloaded": "වචන ලකුණ බාගත කරන ලදී",
     "copyLogoFailed": "ලාංඡනය පිටපත් කිරීමට අසමත් විය",
     "copyWordmarkFailed": "වචන ලකුණ පිටපත් කිරීමට අසමත් විය"
+  },
+  "assistant": {
+    "title": "AI අහන්න",
+    "placeholder": "ප්‍රශ්නයක් අහන්න...",
+    "tooltip": "AI ගෙන් ප්‍රශ්නයක් අසන්න",
+    "tryAsking": "ප්රශ්නයක් ඇසීමට උත්සාහ කරන්න",
+    "askAnything": "ඕන දෙයක් අහන්න...",
+    "clearChat": "කතාබස් පැහැදිලි කරන්න",
+    "close": "වසන්න",
+    "expand": "පුළුල් කරන්න",
+    "collapse": "හකුළන්න",
+    "thinking": "සිතමින්...",
+    "askMeAnything": "ඕන දෙයක් අහන්න",
+    "askMeAnythingDescription": "ලේඛන සැරිසැරීමට, සංකල්ප තේරුම් ගැනීමට සහ පිළිතුරු සෙවීමට උදවු ලබා ගන්න.",
+    "faq": "නිතර අසන පැන",
+    "chatCleared": "නැවුම් කිරීමේදී කතාබස් හිස් වේ",
+    "lineBreak": "රේඛා බිඳීම",
+    "explainWithAi": "AI සමඟ පැහැදිලි කරන්න",
+    "toolListPages": "ලැයිස්තුගත ලේඛන පිටු",
+    "toolReadPage": "කියවන්න",
+    "loading": {
+      "searching": "ලේඛන සෙවීම",
+      "reading": "ලේඛන හරහා කියවීම",
+      "analyzing": "අන්තර්ගතය විශ්ලේෂණය කිරීම",
+      "finding": "හොඳම පිළිතුර සොයා ගැනීම",
+      "finished": "භාවිතා කරන ලද මූලාශ්ර"
+    }
   }
 }

package/i18n/locales/sl.json

@@ -32,5 +32,32 @@
     "wordmarkDownloaded": "Besedna znamka prenesena",
     "copyLogoFailed": "Kopiranje logotipa ni uspelo",
     "copyWordmarkFailed": "Kopiranje besedne znamke ni uspelo"
+  },
+  "assistant": {
+    "title": "Vprašajte AI",
+    "placeholder": "Postavite vprašanje...",
+    "tooltip": "Zastavite vprašanje AI",
+    "tryAsking": "Poskusite postaviti vprašanje",
+    "askAnything": "Vprašajte karkoli...",
+    "clearChat": "Počisti klepet",
+    "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",
+    "chatCleared": "Klepet se ob osvežitvi izbriše",
+    "lineBreak": "Prelom vrstice",
+    "explainWithAi": "Razloži z AI",
+    "toolListPages": "Navedene strani dokumentacije",
+    "toolReadPage": "Preberi",
+    "loading": {
+      "searching": "Iskanje po dokumentaciji",
+      "reading": "Prebiranje dokumentov",
+      "analyzing": "Analiza vsebine",
+      "finding": "Iskanje najboljšega odgovora",
+      "finished": "Uporabljeni viri"
+    }
   }
 }

package/i18n/locales/sv.json

@@ -32,5 +32,32 @@
     "wordmarkDownloaded": "Ordmärke nedladdat",
     "copyLogoFailed": "Kunde inte kopiera logotyp",
     "copyWordmarkFailed": "Kunde inte kopiera ordmärke"
+  },
+  "assistant": {
+    "title": "Fråga AI",
+    "placeholder": "Ställ en fråga...",
+    "tooltip": "Ställ en fråga till AI",
+    "tryAsking": "Försök att ställa en fråga",
+    "askAnything": "Fråga vad som helst...",
+    "clearChat": "Rensa chatten",
+    "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",
+    "chatCleared": "Chatten rensas vid uppdatering",
+    "lineBreak": "Radbrytning",
+    "explainWithAi": "Förklara med AI",
+    "toolListPages": "Listade dokumentationssidor",
+    "toolReadPage": "Läs",
+    "loading": {
+      "searching": "Söker i dokumentationen",
+      "reading": "Läser igenom dokumenten",
+      "analyzing": "Analysera innehållet",
+      "finding": "Att hitta det bästa svaret",
+      "finished": "Använda källor"
+    }
   }
 }

package/i18n/locales/tr.json

@@ -32,5 +32,32 @@
     "wordmarkDownloaded": "Wordmark indirildi",
     "copyLogoFailed": "Logo kopyalanamadı",
     "copyWordmarkFailed": "Wordmark kopyalanamadı"
+  },
+  "assistant": {
+    "title": "Yapay zekaya sor",
+    "placeholder": "Bir soru sorun...",
+    "tooltip": "Yapay zekaya bir soru sorun",
+    "tryAsking": "Bir soru sormayı deneyin",
+    "askAnything": "Her şeyi sor...",
+    "clearChat": "Sohbeti temizle",
+    "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",
+    "chatCleared": "Sohbet yenilendiğinde temizlenir",
+    "lineBreak": "Satır sonu",
+    "explainWithAi": "Yapay zeka ile açıklayın",
+    "toolListPages": "Listelenen dokümantasyon sayfaları",
+    "toolReadPage": "Oku",
+    "loading": {
+      "searching": "Dokümantasyonda arama",
+      "reading": "Dokümanlar okunuyor",
+      "analyzing": "İçerik analiz ediliyor",
+      "finding": "En iyi yanıt bulunuyor",
+      "finished": "Kullanılan kaynaklar"
+    }
   }
 }

package/i18n/locales/uk.json

@@ -32,5 +32,32 @@
     "wordmarkDownloaded": "Словесний знак завантажено",
     "copyLogoFailed": "Не вдалося скопіювати логотип",
     "copyWordmarkFailed": "Не вдалося скопіювати словесний знак"
+  },
+  "assistant": {
+    "title": "Запитайте ШІ",
+    "placeholder": "Задайте питання...",
+    "tooltip": "Задайте питання ШІ",
+    "tryAsking": "Спробуйте задати питання",
+    "askAnything": "Запитайте будь-що...",
+    "clearChat": "Очистити чат",
+    "close": "Закрити",
+    "expand": "Розгорнути",
+    "collapse": "Згорнути",
+    "thinking": "Думаючи...",
+    "askMeAnything": "Запитайте будь-що",
+    "askMeAnythingDescription": "Отримайте допомогу в навігації документацією, розумінні понять і пошуку відповідей.",
+    "faq": "Поширені запитання",
+    "chatCleared": "Чат очищається під час оновлення",
+    "lineBreak": "Розрив рядка",
+    "explainWithAi": "Поясніть за допомогою ШІ",
+    "toolListPages": "Перелічені сторінки документації",
+    "toolReadPage": "Читати",
+    "loading": {
+      "searching": "Пошук документації",
+      "reading": "Читання документів",
+      "analyzing": "Аналіз змісту",
+      "finding": "Пошук найкращої відповіді",
+      "finished": "Використані джерела"
+    }
   }
 }

package/i18n/locales/ur.json

@@ -32,5 +32,32 @@
     "wordmarkDownloaded": "ورڈ مارک ڈاؤن لوڈ ہو گیا",
     "copyLogoFailed": "لوگو کاپی نہیں ہو سکا",
     "copyWordmarkFailed": "ورڈ مارک کاپی نہیں ہو سکا"
+  },
+  "assistant": {
+    "title": "AI سے پوچھیں۔",
+    "placeholder": "ایک سوال پوچھیں...",
+    "tooltip": "AI سے ایک سوال پوچھیں۔",
+    "tryAsking": "ایک سوال پوچھنے کی کوشش کریں۔",
+    "askAnything": "کچھ بھی پوچھو...",
+    "clearChat": "چیٹ صاف کریں۔",
+    "close": "بند",
+    "expand": "پھیلائیں۔",
+    "collapse": "سمٹنا",
+    "thinking": "سوچ رہا ہے...",
+    "askMeAnything": "کچھ بھی پوچھو",
+    "askMeAnythingDescription": "دستاویزات کو نیویگیٹ کرنے، تصورات کو سمجھنے اور جوابات تلاش کرنے میں مدد حاصل کریں۔",
+    "faq": "اکثر پوچھے گئے سوالات",
+    "chatCleared": "ریفریش پر چیٹ صاف ہو جاتی ہے۔",
+    "lineBreak": "لائن بریک",
+    "explainWithAi": "AI کے ساتھ وضاحت کریں۔",
+    "toolListPages": "درج دستاویزات کے صفحات",
+    "toolReadPage": "پڑھیں",
+    "loading": {
+      "searching": "دستاویزات کی تلاش",
+      "reading": "دستاویزات کے ذریعے پڑھنا",
+      "analyzing": "مواد کا تجزیہ",
+      "finding": "بہترین جواب تلاش کرنا",
+      "finished": "ذرائع استعمال کیے گئے۔"
+    }
   }
 }

package/i18n/locales/vi.json

@@ -32,5 +32,32 @@
     "wordmarkDownloaded": "Đã tải wordmark",
     "copyLogoFailed": "Không thể sao chép logo",
     "copyWordmarkFailed": "Không thể sao chép wordmark"
+  },
+  "assistant": {
+    "title": "Hỏi AI",
+    "placeholder": "Đặt một câu hỏi...",
+    "tooltip": "Đặt câu hỏi cho AI",
+    "tryAsking": "Hãy thử đặt một câu hỏi",
+    "askAnything": "Hỏi bất cứ điều gì...",
+    "clearChat": "Xóa cuộc trò chuyện",
+    "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",
+    "chatCleared": "Trò chuyện sẽ bị xóa khi làm mới",
+    "lineBreak": "Ngắt dòng",
+    "explainWithAi": "Giải thích bằng AI",
+    "toolListPages": "Các trang tài liệu được liệt kê",
+    "toolReadPage": "Đọc",
+    "loading": {
+      "searching": "Tìm kiếm tài liệu",
+      "reading": "Đọc qua tài liệu",
+      "analyzing": "Phân tích nội dung",
+      "finding": "Tìm câu trả lời tốt nhất",
+      "finished": "Nguồn được sử dụng"
+    }
   }
 }

package/i18n/locales/zh-CN.json

@@ -32,5 +32,32 @@
     "wordmarkDownloaded": "文字标识已下载",
     "copyLogoFailed": "复制图标失败",
     "copyWordmarkFailed": "复制文字标识失败"
+  },
+  "assistant": {
+    "title": "询问人工智能",
+    "placeholder": "问一个问题...",
+    "tooltip": "问人工智能一个问题",
+    "tryAsking": "尝试提问",
+    "askAnything": "想问什么都可以...",
+    "clearChat": "清除聊天内容",
+    "close": "关闭",
+    "expand": "展开",
+    "collapse": "崩溃",
+    "thinking": "想着……",
+    "askMeAnything": "询问任何事情",
+    "askMeAnythingDescription": "获取浏览文档、理解概念和寻找答案的帮助。",
+    "faq": "常见问题解答",
+    "chatCleared": "刷新时聊天会被清除",
+    "lineBreak": "换行符",
+    "explainWithAi": "用AI解释",
+    "toolListPages": "列出的文档页面",
+    "toolReadPage": "阅读",
+    "loading": {
+      "searching": "搜索文档",
+      "reading": "通读文档",
+      "analyzing": "分析内容",
+      "finding": "寻找最佳答案",
+      "finished": "使用的来源"
+    }
   }
 }

package/index.d.ts

@@ -0,0 +1,33 @@
+import type { AssistantModuleOptions } from './modules/assistant'
+import type { SkillsModuleOptions } from './modules/skills'
+
+export interface DocusNuxtConfig {
+  assistant?: AssistantModuleOptions
+  skills?: SkillsModuleOptions
+}
+
+declare module '@nuxt/schema' {
+  interface NuxtConfig {
+    docus?: DocusNuxtConfig
+    /** @deprecated Use `docus.assistant` instead */
+    assistant?: AssistantModuleOptions
+  }
+  interface NuxtOptions {
+    docus?: DocusNuxtConfig
+    /** @deprecated Use `docus.assistant` instead */
+    assistant?: AssistantModuleOptions
+  }
+}
+
+declare module 'nuxt/schema' {
+  interface NuxtConfig {
+    docus?: DocusNuxtConfig
+    /** @deprecated Use `docus.assistant` instead */
+    assistant?: AssistantModuleOptions
+  }
+  interface NuxtOptions {
+    docus?: DocusNuxtConfig
+    /** @deprecated Use `docus.assistant` instead */
+    assistant?: AssistantModuleOptions
+  }
+}

package/modules/assistant/README.md

@@ -27,11 +27,13 @@ pnpm add @ai-sdk/mcp @ai-sdk/vue @ai-sdk/gateway ai motion-v shiki shiki-stream
 export default defineNuxtConfig({
   modules: ['./modules/assistant'],
 
-  assistant: {
-    apiPath: '/__docus__/assistant',
-    mcpServer: '/mcp',
-    model: 'google/gemini-3-flash',
-  }
+  docus: {
+    assistant: {
+      apiPath: '/__docus__/assistant',
+      mcpServer: '/mcp',
+      model: 'google/gemini-3-flash',
+    },
+  },
 })
 ```
 

package/modules/assistant/index.ts

@@ -1,4 +1,5 @@
 import { addComponent, addImports, addServerHandler, createResolver, defineNuxtModule, logger } from '@nuxt/kit'
+import { defu } from 'defu'
 
 export interface AssistantModuleOptions {
   /**
@@ -22,17 +23,24 @@ export interface AssistantModuleOptions {
 
 const log = logger.withTag('Docus')
 
+const defaults: Required<AssistantModuleOptions> = {
+  apiPath: '/__docus__/assistant',
+  mcpServer: '/mcp',
+  model: 'google/gemini-3-flash',
+}
+
 export default defineNuxtModule<AssistantModuleOptions>({
   meta: {
     name: 'assistant',
-    configKey: 'assistant',
-  },
-  defaults: {
-    apiPath: '/__docus__/assistant',
-    mcpServer: '/mcp',
-    model: 'google/gemini-3-flash',
   },
-  setup(options, nuxt) {
+  setup(_options, nuxt) {
+    const legacyOptions = nuxt.options.assistant
+    if (legacyOptions && Object.keys(legacyOptions).length > 0) {
+      log.warn('`assistant` top-level config is deprecated. Move it under `docus.assistant` in nuxt.config.ts')
+    }
+
+    const options = defu(nuxt.options.docus?.assistant, legacyOptions, defaults) as Required<AssistantModuleOptions>
+
     const hasAiGatewayAuth = !!(
       process.env.AI_GATEWAY_API_KEY || process.env.VERCEL_OIDC_TOKEN
     )
@@ -41,7 +49,7 @@ export default defineNuxtModule<AssistantModuleOptions>({
 
     nuxt.options.runtimeConfig.public.assistant = {
       enabled: hasAiGatewayAuth,
-      apiPath: options.apiPath!,
+      apiPath: options.apiPath,
     }
 
     addImports([
@@ -74,11 +82,11 @@ export default defineNuxtModule<AssistantModuleOptions>({
     }
 
     nuxt.options.runtimeConfig.assistant = {
-      mcpServer: options.mcpServer!,
-      model: options.model!,
+      mcpServer: options.mcpServer,
+      model: options.model,
     }
 
-    const routePath = options.apiPath!.replace(/^\//, '')
+    const routePath = options.apiPath.replace(/^\//, '')
     addServerHandler({
       route: `/${routePath}`,
       handler: resolve('./runtime/server/api/search'),

package/modules/css.ts

@@ -32,5 +32,17 @@ export default defineNuxtModule({
     if (Array.isArray(nuxt.options.css)) {
       nuxt.options.css.unshift(cssTemplate.dst)
     }
+
+    // Noisy Vite warnings
+    const sourcemapWarnIgnore = ['@tailwindcss/vite:generate:build', 'nuxt:module-preload-polyfill']
+    nuxt.hook('vite:extendConfig', (config) => {
+      const logger = config.customLogger
+      if (!logger) return
+      const originalWarn = logger.warn.bind(logger)
+      logger.warn = (msg, options) => {
+        if (sourcemapWarnIgnore.some(p => msg.includes(p))) return
+        originalWarn(msg, options)
+      }
+    })
   },
 })

package/modules/skills/index.ts

@@ -1,7 +1,9 @@
-import { addServerHandler, createResolver, defineNuxtModule, logger } from '@nuxt/kit'
+import { addPrerenderRoutes, addServerHandler, createResolver, defineNuxtModule, logger } from '@nuxt/kit'
+import { defu } from 'defu'
 import { existsSync } from 'node:fs'
 import { readdir, readFile } from 'node:fs/promises'
 import { join } from 'node:path'
+import type { NitroConfig } from 'nitropack'
 import { parse as parseYaml } from 'yaml'
 
 interface SkillEntry {
@@ -10,17 +12,27 @@ interface SkillEntry {
   files: string[]
 }
 
+export interface SkillsModuleOptions {
+  dir?: string
+}
+
 const SKILL_NAME_REGEX = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/
 const MAX_NAME_LENGTH = 64
 
 const log = logger.withTag('Docus')
 
-export default defineNuxtModule({
+const defaults: Required<SkillsModuleOptions> = {
+  dir: 'skills',
+}
+
+export default defineNuxtModule<SkillsModuleOptions>({
   meta: {
     name: 'skills',
   },
-  async setup(_options, nuxt) {
-    const skillsDir = join(nuxt.options.rootDir, 'skills')
+  async setup(_inlineOptions, nuxt) {
+    const options = defu(nuxt.options.docus?.skills, defaults) as Required<SkillsModuleOptions>
+
+    const skillsDir = join(nuxt.options.rootDir, options.dir)
     if (!existsSync(skillsDir)) return
 
     const catalog = await scanSkills(skillsDir)
@@ -32,19 +44,19 @@ export default defineNuxtModule({
 
     const { resolve } = createResolver(import.meta.url)
 
-    nuxt.hook('nitro:config', (nitroConfig) => {
+    const onNitroConfig = nuxt.hook as (name: 'nitro:config', cb: (nitroConfig: NitroConfig) => void) => void
+    onNitroConfig('nitro:config', (nitroConfig) => {
       nitroConfig.serverAssets ||= []
       nitroConfig.serverAssets.push({ baseName: 'skills', dir: skillsDir })
+    })
 
-      nitroConfig.prerender ||= {}
-      nitroConfig.prerender.routes ||= []
-      nitroConfig.prerender.routes.push('/.well-known/skills/index.json')
-      for (const skill of catalog) {
-        for (const file of skill.files) {
-          nitroConfig.prerender.routes.push(`/.well-known/skills/${skill.name}/${file}`)
-        }
+    const prerenderRoutes = ['/.well-known/skills/index.json']
+    for (const skill of catalog) {
+      for (const file of skill.files) {
+        prerenderRoutes.push(`/.well-known/skills/${skill.name}/${file}`)
       }
-    })
+    }
+    addPrerenderRoutes(prerenderRoutes)
 
     addServerHandler({
       route: '/.well-known/skills/index.json',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.9.0",
+  "version": "5.10.0",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -14,6 +14,7 @@
     "app",
     "i18n",
     "content.config.ts",
+    "index.d.ts",
     "modules",
     "nuxt.config.ts",
     "nuxt.schema.ts",