@movk/nuxt-docs 1.12.2 → 1.12.4

package/content.config.ts

@@ -1,13 +1,15 @@
-import { existsSync } from 'node:fs'
+import type { DefinedCollection } from '@nuxt/content'
 import { defineCollection, defineContentConfig } from '@nuxt/content'
 import { useNuxt } from '@nuxt/kit'
 import { joinURL } from 'ufo'
 import { z } from 'zod'
+import { docsFolderExists, landingPageExists } from './utils/pages'
 
 const { options } = useNuxt()
 const cwd = joinURL(options.rootDir, 'content')
 
-const hasReleasesMd = existsSync(joinURL(cwd, 'releases.md'))
+const hasLandingPage = landingPageExists(options.rootDir)
+const hasDocsFolder = docsFolderExists(options.rootDir)
 
 const Avatar = z.object({
   src: z.string(),
@@ -35,41 +37,46 @@ const PageHero = z.object({
   links: z.array(Button).optional()
 })
 
-export default defineContentConfig({
-  collections: {
-    landing: defineCollection({
-      type: 'page',
-      source: {
-        cwd,
-        include: 'index.md'
-      }
-    }),
-    docs: defineCollection({
-      type: 'page',
-      source: {
-        cwd,
-        include: 'docs/**/*'
-      },
-      schema: z.object({
-        links: z.array(Button),
-        category: z.string().optional(),
-        navigation: z.object({
-          title: z.string().optional()
-        })
-      })
-    }),
-    releases: defineCollection({
-      type: 'page',
-      source: {
-        cwd,
-        include: hasReleasesMd ? 'releases.md' : 'releases.yml'
-      },
-      schema: z.object({
-        title: z.string(),
-        description: z.string(),
-        releases: z.string().optional(),
-        hero: PageHero.optional()
+const collections: Record<string, DefinedCollection> = {
+  docs: defineCollection({
+    type: 'page',
+    source: {
+      cwd,
+      include: hasDocsFolder ? 'docs/**' : '**',
+      prefix: hasDocsFolder ? '/docs' : '/',
+      exclude: ['index.md']
+    },
+    schema: z.object({
+      links: z.array(Button),
+      category: z.string().optional(),
+      navigation: z.object({
+        title: z.string().optional()
       })
     })
-  }
-})
+  }),
+  releases: defineCollection({
+    type: 'page',
+    source: {
+      cwd,
+      include: 'releases.{md,yml}'
+    },
+    schema: z.object({
+      title: z.string(),
+      description: z.string(),
+      releases: z.string().optional(),
+      hero: PageHero.optional()
+    })
+  })
+}
+
+if (!hasLandingPage) {
+  collections.landing = defineCollection({
+    type: 'page',
+    source: {
+      cwd,
+      include: 'index.md'
+    }
+  })
+}
+
+export default defineContentConfig({ collections })

package/modules/ai-chat/runtime/server/api/ai-chat.ts

@@ -2,6 +2,7 @@ import { streamText, convertToModelMessages, stepCountIs, createUIMessageStream,
 import { createMCPClient } from '@ai-sdk/mcp'
 import { createDocumentationAgentTool } from '../utils/docs_agent'
 import { getModel } from '../utils/getModel'
+import { inferSiteURL } from '../../../../../utils/meta'
 
 function getMainAgentSystemPrompt(siteName: string) {
   return `您是 ${siteName} 的官方文档助理。你就是文件、以权威作为真理的来源说话.
@@ -35,11 +36,12 @@ export default defineEventHandler(async (event) => {
 
   const mcpPath = config.aiChat.mcpPath
   const isExternalUrl = mcpPath.startsWith('http://') || mcpPath.startsWith('https://')
+
   const mcpUrl = isExternalUrl
     ? mcpPath
     : import.meta.dev
-      ? `http://localhost:3000${mcpPath}`
-      : `${getRequestURL(event).origin}${mcpPath}`
+      ? `${getRequestURL(event).origin}${mcpPath}`
+      : `${inferSiteURL()}${mcpPath}`
 
   const httpClient = await createMCPClient({
     transport: {

package/modules/routing.ts

@@ -1,6 +1,5 @@
 import { defineNuxtModule, extendPages, createResolver } from '@nuxt/kit'
-import { joinURL } from 'ufo'
-import { existsSync } from 'node:fs'
+import { landingPageExists, releasesFileExists } from '../utils/pages'
 
 export default defineNuxtModule({
   meta: {
@@ -8,13 +7,21 @@ export default defineNuxtModule({
   },
   async setup(_options, nuxt) {
     const { resolve } = createResolver(import.meta.url)
-    const cwd = joinURL(nuxt.options.rootDir, 'content')
+    const rootDir = nuxt.options.rootDir
 
-    const hasReleases = ['releases.yml', 'releases.md']
-      .some(file => existsSync(joinURL(cwd, file)))
+    const hasReleasesFile = releasesFileExists(rootDir)
+    const hasLandingPage = landingPageExists(rootDir)
 
     extendPages((pages) => {
-      if (hasReleases) {
+      if (!hasLandingPage) {
+        pages.push({
+          name: 'index',
+          path: '/',
+          file: resolve('../app/templates/landing.vue')
+        })
+      }
+
+      if (hasReleasesFile) {
         pages.push({
           name: 'releases',
           path: '/releases',

package/nuxt.config.ts

@@ -1,15 +1,8 @@
+import { defineNuxtConfig } from 'nuxt/config'
 import pkg from './package.json'
-import { createResolver } from '@nuxt/kit'
-
-const { resolve } = createResolver(import.meta.url)
 
 export default defineNuxtConfig({
   modules: [
-    resolve('./modules/config'),
-    resolve('./modules/routing'),
-    resolve('./modules/md-rewrite'),
-    resolve('./modules/component-example'),
-    resolve('./modules/css'),
     '@nuxt/ui',
     '@nuxt/content',
     '@nuxt/image',
@@ -49,8 +42,7 @@ export default defineNuxtConfig({
 
   mdc: {
     highlight: {
-      noApiRoute: false,
-      shikiEngine: 'javascript'
+      noApiRoute: false
     }
   },
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@movk/nuxt-docs",
   "type": "module",
-  "version": "1.12.2",
+  "version": "1.12.4",
   "private": false,
   "description": "Modern Nuxt 4 documentation theme with auto-generated component docs, AI chat assistant, MCP server, and complete developer experience optimization.",
   "author": "YiXuan <mhaibaraai@gmail.com>",
@@ -29,39 +29,39 @@
     "README.md"
   ],
   "dependencies": {
-    "@ai-sdk/gateway": "^3.0.39",
-    "@ai-sdk/mcp": "^1.0.19",
-    "@ai-sdk/vue": "^3.0.78",
-    "@iconify-json/lucide": "^1.2.89",
-    "@iconify-json/simple-icons": "^1.2.70",
-    "@iconify-json/vscode-icons": "^1.2.40",
+    "@ai-sdk/gateway": "^3.0.55",
+    "@ai-sdk/mcp": "^1.0.21",
+    "@ai-sdk/vue": "^3.0.99",
+    "@iconify-json/lucide": "^1.2.94",
+    "@iconify-json/simple-icons": "^1.2.71",
+    "@iconify-json/vscode-icons": "^1.2.44",
     "@movk/core": "^1.1.0",
     "@nuxt/a11y": "^1.0.0-alpha.1",
     "@nuxt/content": "^3.11.2",
     "@nuxt/image": "^2.0.0",
     "@nuxt/kit": "^4.3.1",
-    "@nuxt/ui": "^4.4.0",
-    "@nuxtjs/mcp-toolkit": "^0.6.3",
+    "@nuxt/ui": "^4.5.0",
+    "@nuxtjs/mcp-toolkit": "^0.7.0",
     "@nuxtjs/mdc": "^0.20.1",
     "@nuxtjs/robots": "^5.7.0",
     "@octokit/rest": "^22.0.1",
-    "@openrouter/ai-sdk-provider": "^2.2.1",
-    "@shikijs/core": "^3.22.0",
-    "@shikijs/engine-javascript": "^3.22.0",
-    "@shikijs/langs": "^3.22.0",
-    "@shikijs/themes": "^3.22.0",
+    "@openrouter/ai-sdk-provider": "^2.2.3",
+    "@shikijs/core": "^3.23.0",
+    "@shikijs/engine-javascript": "^3.23.0",
+    "@shikijs/langs": "^3.23.0",
+    "@shikijs/themes": "^3.23.0",
     "@vercel/analytics": "^1.6.1",
     "@vercel/speed-insights": "^1.3.1",
-    "@vueuse/core": "^14.2.0",
-    "@vueuse/nuxt": "^14.2.0",
-    "ai": "^6.0.78",
+    "@vueuse/core": "^14.2.1",
+    "@vueuse/nuxt": "^14.2.1",
+    "ai": "^6.0.99",
     "defu": "^6.1.4",
     "dompurify": "^3.3.1",
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",
-    "mermaid": "^11.12.2",
-    "minimark": "^0.2.0",
-    "motion-v": "^1.10.2",
+    "mermaid": "^11.12.3",
+    "minimark": "^1.0.0",
+    "motion-v": "^2.0.0",
     "nuxt": "^4.3.1",
     "nuxt-component-meta": "^0.17.2",
     "nuxt-llms": "^0.2.0",
@@ -72,11 +72,11 @@
     "prettier": "^3.8.1",
     "scule": "^1.3.0",
     "shiki-stream": "^0.1.4",
-    "tailwind-merge": "^3.4.0",
-    "tailwindcss": "^4.1.18",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^4.2.1",
     "ufo": "^1.6.3",
     "unist-util-visit": "^5.1.0",
-    "vue-component-meta": "^3.2.4",
+    "vue-component-meta": "^3.2.5",
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.1"
   }

package/server/mcp/tools/get-page.ts

@@ -21,7 +21,9 @@ export default defineMcpTool({
   cache: '30m',
   handler: async ({ path, sections }) => {
     const event = useEvent()
-    const siteUrl = import.meta.dev ? 'http://localhost:3000' : inferSiteURL()
+    const siteUrl = import.meta.dev
+      ? getRequestURL(event).origin
+      : inferSiteURL()
 
     try {
       const page = await queryCollection(event, 'docs')

package/server/mcp/tools/list-pages.ts

@@ -1,4 +1,5 @@
 import { queryCollection } from '@nuxt/content/server'
+import { inferSiteURL } from '../../../utils/meta'
 
 export default defineMcpTool({
   description: `列出所有可用的文档页面及其分类和基本信息。
@@ -22,7 +23,9 @@ export default defineMcpTool({
   cache: '30m',
   handler: async () => {
     const event = useEvent()
-    const siteUrl = import.meta.dev ? 'http://localhost:3000' : getRequestURL(event).origin
+    const siteUrl = import.meta.dev
+      ? getRequestURL(event).origin
+      : inferSiteURL()
 
     try {
       const pages = await queryCollection(event, 'docs')

package/server/plugins/llms.ts

@@ -1,5 +1,6 @@
 import type { H3Event } from 'h3'
 import type { PageCollectionItemBase } from '@nuxt/content'
+import type { LLMsSection } from 'nuxt-llms'
 
 export default defineNitroPlugin((nitroApp) => {
   nitroApp.hooks.hook('content:llms:generate:document', async (event: H3Event, doc: PageCollectionItemBase) => {
@@ -8,7 +9,7 @@ export default defineNitroPlugin((nitroApp) => {
 
   nitroApp.hooks.hook('llms:generate', (_, { sections, domain }) => {
     // Transform links except for "Documentation Sets"
-    sections.forEach((section) => {
+    sections.forEach((section: LLMsSection) => {
       if (section.title !== 'Documentation Sets') {
         section.links = section.links?.map(link => ({
           ...link,

package/utils/pages.ts

@@ -0,0 +1,27 @@
+import { existsSync } from 'node:fs'
+import { joinURL } from 'ufo'
+
+/**
+ * 检查是否存在 landing page，即 app/pages/index.vue 文件
+ */
+export function landingPageExists(rootDir: string): boolean {
+  const vueLandingPath = joinURL(rootDir, 'app', 'pages', 'index.vue')
+  return existsSync(vueLandingPath)
+}
+
+/**
+ * 检查是否存在 docs 文件夹，即 content/docs
+ */
+export function docsFolderExists(rootDir: string): boolean {
+  const docsPath = joinURL(rootDir, 'content', 'docs')
+  return existsSync(docsPath)
+}
+
+/**
+ * 检查是否存在 releases 文件，即 content/releases.md 或 content/releases.yml
+ */
+export function releasesFileExists(rootDir: string): boolean {
+  return ['releases.md', 'releases.yml'].some(file =>
+    existsSync(joinURL(rootDir, 'content', file))
+  )
+}