@movk/nuxt-docs 1.7.2 → 1.7.4

package/app/error.vue

@@ -47,11 +47,11 @@ provide('navigation', rootNavigation)
     <NuxtLoadingIndicator color="var(--ui-primary)" :height="2" />
 
     <div :class="{ root: route.path.startsWith('/docs/') }">
-      <Header />
+      <Header v-if="$route.meta.header !== false" />
 
       <UError :error="error" />
 
-      <Footer />
+      <Footer v-if="$route.meta.footer !== false" />
 
       <ClientOnly>
         <LazyUContentSearch :files="files" :navigation="navigation" />

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

@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { ContentNavigationItem } from '@nuxt/content'
 import { kebabCase } from 'scule'
+import { joinURL } from 'ufo'
 
 definePageMeta({
   layout: 'docs',
@@ -80,6 +81,20 @@ const communityLinks = computed(() => {
   return filterValidLinks([...links, ...(toc?.bottom?.links || [])])
 })
 
+// Pre-render the markdown path + add it to alternate links
+const site = useSiteConfig()
+const path = computed(() => route.path.replace(/\/$/, ''))
+prerenderRoutes([joinURL('/raw', `${path.value}.md`)])
+useHead({
+  link: [
+    {
+      rel: 'alternate',
+      href: joinURL(site.url, 'raw', `${path.value}.md`),
+      type: 'text/markdown'
+    }
+  ]
+})
+
 useSeoMeta({
   title,
   ogTitle: title,

package/app/workers/prettier.js

@@ -16,12 +16,12 @@ function handleMessage(message) {
 async function handleFormatMessage(message) {
   if (!globalThis.prettier) {
     await Promise.all([
-      import('https://cdn.jsdelivr.net/npm/prettier@3.6.2/standalone.js'),
-      import('https://cdn.jsdelivr.net/npm/prettier@3.6.2/plugins/babel.js'),
-      import('https://cdn.jsdelivr.net/npm/prettier@3.6.2/plugins/estree.js'),
-      import('https://cdn.jsdelivr.net/npm/prettier@3.6.2/plugins/html.js'),
-      import('https://cdn.jsdelivr.net/npm/prettier@3.6.2/plugins/markdown.js'),
-      import('https://cdn.jsdelivr.net/npm/prettier@3.6.2/plugins/typescript.js')
+      import('https://cdn.jsdelivr.net/npm/prettier@3.7.4/standalone.js'),
+      import('https://cdn.jsdelivr.net/npm/prettier@3.7.4/plugins/babel.js'),
+      import('https://cdn.jsdelivr.net/npm/prettier@3.7.4/plugins/estree.js'),
+      import('https://cdn.jsdelivr.net/npm/prettier@3.7.4/plugins/html.js'),
+      import('https://cdn.jsdelivr.net/npm/prettier@3.7.4/plugins/markdown.js'),
+      import('https://cdn.jsdelivr.net/npm/prettier@3.7.4/plugins/typescript.js')
     ])
   }
 

package/modules/config.ts

@@ -1,4 +1,5 @@
 import { createResolver, defineNuxtModule } from '@nuxt/kit'
+import { join } from 'pathe'
 import { defu } from 'defu'
 import { getGitBranch, getGitEnv, getLocalGitInfo } from '../utils/git'
 import { getPackageJsonMetadata, inferSiteURL } from '../utils/meta'
@@ -57,40 +58,35 @@ export default defineNuxtModule({
       until: new Date().toISOString()
     })
 
-    const componentsPath = resolve('../app/components')
+    const layerPath = resolve('..')
+    const allowedComponents = [
+      resolve('../app/components/content/CommitChangelog.vue'),
+      resolve('../app/components/content/ComponentEmits.vue'),
+      resolve('../app/components/content/ComponentExample.vue'),
+      resolve('../app/components/content/ComponentProps.vue'),
+      resolve('../app/components/content/ComponentSlots.vue'),
+      resolve('../app/components/content/PageLastCommit.vue'),
+      resolve('./ai-chat/runtime/components/AiChatToolCall.vue'),
+      resolve('./ai-chat/runtime/components/AiChatReasoning.vue'),
+      resolve('./ai-chat/runtime/components/AiChatSlideoverFaq.vue'),
+      resolve('./ai-chat/runtime/components/AiChatPreStream.vue')
+    ]
+    const userComponentPaths = [
+      join(dir, 'app/components'),
+      join(dir, 'components'),
+      join(dir, 'docs/app/components'),
+      join(dir, 'templates/*/app/components')
+    ]
 
-    nuxt.options.componentMeta = defu(nuxt.options.componentMeta, {
-      exclude: [
-        '@nuxt/content',
-        '@nuxt/icon',
-        '@nuxt/image',
-        '@nuxtjs/color-mode',
-        '@nuxtjs/mdc',
-        'nuxt/dist',
-        'nuxt-og-image',
-        '@nuxtjs/plausible',
-        '@nuxt/ui',
-        (component: { filePath: string }) => {
-          const allowedComponents = [
-            'CommitChangelog.vue',
-            'ComponentEmits.vue',
-            'ComponentExample.vue',
-            'ComponentProps.vue',
-            'ComponentSlots.vue',
-            'PageLastCommit.vue',
-            'Motion.vue'
-          ]
-          return component.filePath.startsWith(componentsPath)
-            && !allowedComponents.some(name => component.filePath.endsWith(`/content/${name}`))
-        }
-      ],
-      metaFields: {
-        type: false,
-        props: true,
-        slots: 'no-schema' as const,
-        events: 'no-schema' as const,
-        exposed: false
-      }
+    // @ts-ignore - component-meta 的类型定义在运行时才能正确解析
+    nuxt.hook('component-meta:extend', (options: any) => {
+      options.exclude = [
+        ...(options.exclude || []),
+        ({ filePath }: { filePath: string }) =>
+          filePath.startsWith(layerPath) && !allowedComponents.includes(filePath),
+        ({ filePath }: { filePath: string }) =>
+          userComponentPaths.some(path => filePath.startsWith(path))
+      ]
     })
   }
 })

package/modules/md-rewrite.ts

@@ -0,0 +1,23 @@
+import { defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule((_options, nuxt) => {
+  nuxt.hooks.hook('nitro:init', (nitro) => {
+    if (nitro.options.dev || !nitro.options.preset.includes('vercel')) {
+      return
+    }
+    nitro.hooks.hook('compiled', async () => {
+      const { resolve } = process.getBuiltinModule('node:path')
+      const { readFile, writeFile }
+        = process.getBuiltinModule('node:fs/promises')
+      const vcJSON = resolve(nitro.options.output.dir, 'config.json')
+      const vcConfig = JSON.parse(await readFile(vcJSON, 'utf8'))
+      vcConfig.routes.unshift({
+        src: '^/docs/(.*)$',
+        dest: '/raw/docs/$1.md',
+        has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
+        check: true
+      })
+      await writeFile(vcJSON, JSON.stringify(vcConfig, null, 2), 'utf8')
+    })
+  })
+})

package/nuxt.config.ts

@@ -7,20 +7,16 @@ const { resolve } = createResolver(import.meta.url)
 export default defineNuxtConfig({
   modules: [
     resolve('./modules/config'),
-    resolve('./modules/routing'),
-    resolve('./modules/css'),
-    resolve('./modules/component-example'),
-    resolve('./modules/ai-chat'),
     '@nuxt/ui',
     '@nuxt/content',
     '@nuxt/image',
     '@nuxt/a11y',
-    '@vueuse/nuxt',
     '@nuxtjs/mcp-toolkit',
     '@nuxtjs/seo',
+    '@vueuse/nuxt',
     'nuxt-component-meta',
-    'motion-v/nuxt',
     'nuxt-llms',
+    'motion-v/nuxt',
     () => {
       extendViteConfig((config) => {
         config.optimizeDeps ||= {}
@@ -46,7 +42,7 @@ export default defineNuxtConfig({
     build: {
       markdown: {
         highlight: {
-          langs: ['bash', 'ts', 'typescript', 'diff', 'vue', 'json', 'yml', 'yaml', 'css', 'mdc', 'blade', 'edge']
+          langs: ['bash', 'diff', 'json', 'js', 'ts', 'html', 'css', 'vue', 'shell', 'mdc', 'md', 'yaml']
         },
         remarkPlugins: {
           'remark-mdc': {
@@ -85,9 +81,33 @@ export default defineNuxtConfig({
   nitro: {
     prerender: {
       crawlLinks: true,
+      failOnError: false,
       autoSubfolderIndex: false
     }
   },
+  a11y: {
+    logIssues: false
+  },
+  componentMeta: {
+    metaFields: {
+      type: false,
+      props: true,
+      slots: 'no-schema' as const,
+      events: 'no-schema' as const,
+      exposed: false
+    },
+    exclude: [
+      '@nuxt/ui',
+      '@nuxt/content',
+      '@nuxt/icon',
+      '@nuxt/image',
+      '@nuxtjs/color-mode',
+      '@nuxtjs/mdc',
+      '@nuxtjs/plausible',
+      'nuxt/dist',
+      'nuxt-og-image'
+    ]
+  },
   fonts: {
     families: [
       { name: 'Public Sans', provider: 'google', global: true },
@@ -102,15 +122,16 @@ export default defineNuxtConfig({
   icon: {
     provider: 'iconify'
   },
+  linkChecker: {
+    enabled: false
+  },
   ogImage: {
     zeroRuntime: true,
     googleFontMirror: 'fonts.loli.net',
     fonts: [
-      // 思源黑体 - 支持中文
       'Noto+Sans+SC:400',
       'Noto+Sans+SC:500',
       'Noto+Sans+SC:700',
-      // 如果需要英文字体
       'Inter:400',
       'Inter:700'
     ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@movk/nuxt-docs",
   "type": "module",
-  "version": "1.7.2",
+  "version": "1.7.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>",