@movk/nuxt-docs 1.4.1 → 1.5.0

package/app/app.config.ts

@@ -34,7 +34,10 @@ export default defineAppConfig({
       }
     }
   },
-  vercelAnalytics: false,
+  vercelAnalytics: {
+    enable: false,
+    debug: false
+  },
   header: {
     avatar: 'https://docs.mhaibaraai.cn/avatar.png',
     title: 'Movk Nuxt Docs',

package/app/app.vue

@@ -45,8 +45,8 @@ provide('navigation', rootNavigation)
 <template>
   <UApp :toaster="appConfig.toaster">
     <NuxtLoadingIndicator color="var(--ui-primary)" :height="2" />
-    <Analytics v-if="appConfig.vercelAnalytics" />
-    <SpeedInsights v-if="appConfig.vercelAnalytics" />
+    <Analytics v-if="appConfig.vercelAnalytics" :debug="appConfig.vercelAnalytics?.debug" />
+    <SpeedInsights v-if="appConfig.vercelAnalytics" :debug="appConfig.vercelAnalytics?.debug" />
 
     <div :class="{ root: route.path.startsWith('/docs/') }">
       <template v-if="!route.path.startsWith('/examples')">

package/app/components/PageHeaderLinks.vue

@@ -13,7 +13,7 @@ const items = [
     label: 'Copy Markdown link',
     icon: 'i-lucide-link',
     onSelect() {
-      if (vercelAnalytics) track ('Page Action', { action: 'Copy Markdown Link' })
+      if (vercelAnalytics?.debug) track ('Page Action', { action: 'Copy Markdown Link' })
       copy(mdPath.value)
       toast.add({
         title: 'Copied to clipboard',
@@ -27,7 +27,7 @@ const items = [
     target: '_blank',
     to: `/raw${route.path}.md`,
     onSelect() {
-      if (vercelAnalytics) track('Page Action', { action: 'View as Markdown' })
+      if (vercelAnalytics?.debug) track('Page Action', { action: 'View as Markdown' })
     }
   },
   {
@@ -36,7 +36,7 @@ const items = [
     target: '_blank',
     to: `https://chatgpt.com/?hints=search&q=${encodeURIComponent(`Read ${mdPath.value} so I can ask questions about it.`)}`,
     onSelect() {
-      if (vercelAnalytics) track('Page Action', { action: 'Open in ChatGPT' })
+      if (vercelAnalytics?.debug) track('Page Action', { action: 'Open in ChatGPT' })
     }
   },
   {
@@ -45,13 +45,13 @@ const items = [
     target: '_blank',
     to: `https://claude.ai/new?q=${encodeURIComponent(`Read ${mdPath.value} so I can ask questions about it.`)}`,
     onSelect() {
-      if (vercelAnalytics) track('Page Action', { action: 'Open in Claude' })
+      if (vercelAnalytics?.debug) track('Page Action', { action: 'Open in Claude' })
     }
   }
 ]
 
 async function copyPage() {
-  if (vercelAnalytics) track('Page Action', { action: 'Copy Page Content' })
+  if (vercelAnalytics?.debug) track('Page Action', { action: 'Copy Page Content' })
   copy(await $fetch<string>(`/raw${route.path}.md`))
 }
 </script>

package/app/components/content/HeaderToggleButton.vue

@@ -0,0 +1,82 @@
+<script setup lang="ts">
+import { motion } from 'motion-v'
+import type { VariantType } from 'motion-v'
+
+const props = defineProps<{
+  open: boolean
+}>()
+
+const variants: { [k: string]: VariantType | ((custom: unknown) => VariantType) } = {
+  normal: {
+    rotate: 0,
+    y: 0,
+    opacity: 1
+  },
+  close: (custom: unknown) => {
+    const c = custom as number
+    return {
+      rotate: c === 1 ? 45 : c === 3 ? -45 : 0,
+      y: c === 1 ? 6 : c === 3 ? -6 : 0,
+      opacity: c === 2 ? 0 : 1,
+      transition: {
+        type: 'spring',
+        stiffness: 260,
+        damping: 20
+      }
+    }
+  }
+}
+
+const state = computed(() => props.open ? 'close' : 'normal')
+</script>
+
+<template>
+  <UButton
+    size="sm"
+    variant="ghost"
+    color="neutral"
+    square
+  >
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      class="size-5"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      stroke-width="2"
+      stroke-linecap="round"
+      stroke-linejoin="round"
+    >
+      <motion.line
+        x1="4"
+        y1="6"
+        x2="20"
+        y2="6"
+        :variants="variants"
+        :animate="state"
+        :custom="1"
+        class="outline-none"
+      />
+      <motion.line
+        x1="4"
+        y1="12"
+        x2="20"
+        y2="12"
+        :variants="variants"
+        :animate="state"
+        :custom="2"
+        class="outline-none"
+      />
+      <motion.line
+        x1="4"
+        y1="18"
+        x2="20"
+        y2="18"
+        :variants="variants"
+        :animate="state"
+        :custom="3"
+        class="outline-none"
+      />
+    </svg>
+  </UButton>
+</template>

package/app/components/header/Header.vue

@@ -49,6 +49,14 @@ const links = computed<ButtonProps[]>(() => github && github.url
       </template>
     </template>
 
+    <template #toggle="{ open, toggle, ui }">
+      <HeaderToggleButton
+        :open="open"
+        :class="ui.toggle({ toggleSide: 'right' })"
+        @click="toggle"
+      />
+    </template>
+
     <template #body>
       <HeaderBody />
     </template>

package/app/components/theme-picker/ThemePicker.vue

@@ -13,7 +13,7 @@ const { track } = useAnalytics()
 const open = ref(false)
 
 watch(open, (isOpen) => {
-  if (isOpen && appConfig.vercelAnalytics) {
+  if (isOpen && appConfig.vercelAnalytics?.debug) {
     track('Theme Picker Opened')
   }
 })
@@ -29,7 +29,7 @@ const neutral = computed({
   set(option) {
     appConfig.ui.colors.neutral = option
     window.localStorage.setItem(`${site.name}-ui-neutral`, appConfig.ui.colors.neutral)
-    if (appConfig.vercelAnalytics) track('Theme Changed', { setting: 'neutral', value: option })
+    if (appConfig.vercelAnalytics?.debug) track('Theme Changed', { setting: 'neutral', value: option })
   }
 })
 
@@ -43,7 +43,7 @@ const primary = computed({
     appConfig.ui.colors.primary = option
     window.localStorage.setItem(`${site.name}-ui-primary`, appConfig.ui.colors.primary)
     setBlackAsPrimary(false)
-    if (appConfig.vercelAnalytics) track('Theme Changed', { setting: 'primary', value: option })
+    if (appConfig.vercelAnalytics?.debug) track('Theme Changed', { setting: 'primary', value: option })
   }
 })
 
@@ -55,7 +55,7 @@ const radius = computed({
   set(option) {
     appConfig.theme.radius = option
     window.localStorage.setItem(`${site.name}-ui-radius`, String(appConfig.theme.radius))
-    if (appConfig.vercelAnalytics) track('Theme Changed', { setting: 'radius', value: option })
+    if (appConfig.vercelAnalytics?.debug) track('Theme Changed', { setting: 'radius', value: option })
   }
 })
 
@@ -70,14 +70,14 @@ const mode = computed({
   },
   set(option) {
     colorMode.preference = option
-    if (appConfig.vercelAnalytics) track('Theme Changed', { setting: 'color mode', value: option })
+    if (appConfig.vercelAnalytics?.debug) track('Theme Changed', { setting: 'color mode', value: option })
   }
 })
 
 function setBlackAsPrimary(value: boolean) {
   appConfig.theme.blackAsPrimary = value
   window.localStorage.setItem(`${site.name}-ui-black-as-primary`, String(value))
-  if (appConfig.vercelAnalytics) track('Theme Changed', { setting: 'black as primary', value })
+  if (appConfig.vercelAnalytics?.debug) track('Theme Changed', { setting: 'black as primary', value })
 }
 
 const fonts = ['Public Sans', 'DM Sans', 'Geist', 'Inter', 'Poppins', 'Outfit', 'Raleway']
@@ -88,7 +88,7 @@ const font = computed({
   set(option) {
     appConfig.theme.font = option
     window.localStorage.setItem(`${site.name}-ui-font`, appConfig.theme.font)
-    if (appConfig.vercelAnalytics) track('Theme Changed', { setting: 'font', value: option })
+    if (appConfig.vercelAnalytics?.debug) track('Theme Changed', { setting: 'font', value: option })
   }
 })
 
@@ -113,7 +113,7 @@ const icon = computed({
     appConfig.theme.icons = option
     appConfig.ui.icons = themeIcons[option as keyof typeof themeIcons] as any
     window.localStorage.setItem(`${site.name}-ui-icons`, appConfig.theme.icons)
-    if (appConfig.vercelAnalytics) track('Theme Changed', { setting: 'icons', value: option })
+    if (appConfig.vercelAnalytics?.debug) track('Theme Changed', { setting: 'icons', value: option })
   }
 })
 
@@ -130,7 +130,7 @@ const hasAppConfigChanges = computed(() => {
 })
 
 function exportCSS() {
-  if (appConfig.vercelAnalytics) track('Theme Exported', { type: 'css' })
+  if (appConfig.vercelAnalytics?.debug) track('Theme Exported', { type: 'css' })
 
   const lines = [
     '@import "tailwindcss";',
@@ -161,7 +161,7 @@ function exportCSS() {
 }
 
 function exportAppConfig() {
-  if (appConfig.vercelAnalytics) track('Theme Exported', { type: 'appConfig' })
+  if (appConfig.vercelAnalytics?.debug) track('Theme Exported', { type: 'appConfig' })
 
   const config: Record<string, any> = {}
 
@@ -192,7 +192,7 @@ function exportAppConfig() {
 }
 
 function resetTheme() {
-  if (appConfig.vercelAnalytics) track('Theme Reset')
+  if (appConfig.vercelAnalytics?.debug) track('Theme Reset')
 
   // Reset without triggering individual tracking events
   appConfig.ui.colors.primary = 'green'

package/app/mdc.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from '@nuxtjs/mdc/config'
+import { transformerColorHighlight } from 'shiki-transformer-color-highlight'
+import { transformerIconHighlight } from './utils/shiki-transformer-icon-highlight'
+
+export default defineConfig({
+  shiki: {
+    transformers: [
+      transformerColorHighlight(),
+      transformerIconHighlight()
+    ]
+  }
+})

package/app/types/index.d.ts

@@ -2,7 +2,10 @@ import type { ButtonProps } from '@nuxt/ui'
 
 declare module 'nuxt/schema' {
   interface AppConfig {
-    vercelAnalytics: boolean
+    vercelAnalytics: {
+      enable: boolean
+      debug: boolean
+    }
     seo: {
       titleTemplate: string
       title: string
@@ -38,12 +41,12 @@ declare module 'nuxt/schema' {
       suffix: string
       per_page: number
       until: string
-      author?: string
+      author: string
       /**
        * 日期格式化配置
        * @example { locale: 'zh-CN', options: { year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' } }
        */
-      dateFormat?: {
+      dateFormat: {
         locale?: string
         options?: Intl.DateTimeFormatOptions
       }

package/app/utils/shiki-transformer-icon-highlight.ts

@@ -0,0 +1,90 @@
+/** copy from https://github.com/nuxt/ui/blob/v4/docs/app/utils/shiki-transformer-icon-highlight.ts */
+import type { ShikiTransformer } from 'shiki'
+
+export interface TransformerIconHighlightOptions {
+  /**
+   * Custom function to render the icon HTML
+   * @default Uses Iconify API with mask mode
+   */
+  htmlIcon?: (icon: string) => string
+}
+
+// Common icon collections to validate against (sorted by length descending for proper matching)
+const ICON_COLLECTIONS = [
+  'simple-icons',
+  'vscode-icons',
+  'tabler',
+  'lucide',
+  'logos',
+  'ph'
+]
+
+function parseIconName(text: string): { collection: string, name: string, format: 'i' | 'colon' } | null {
+  // Strip quotes if present (single, double, or backticks)
+  let cleanText = text
+  if (/^['"`].*['"`]$/.test(text)) {
+    cleanText = text.slice(1, -1)
+  }
+
+  // Try i-{collection}-{name} format
+  if (cleanText.startsWith('i-')) {
+    const rest = cleanText.slice(2)
+    for (const collection of ICON_COLLECTIONS) {
+      if (rest.startsWith(`${collection}-`)) {
+        const name = rest.slice(collection.length + 1)
+        if (name && /^[a-z0-9]+(?:-[a-z0-9]+)*$/i.test(name)) {
+          return { collection, name, format: 'i' }
+        }
+      }
+    }
+  }
+
+  // Try {collection}:{name} format
+  const colonIndex = cleanText.indexOf(':')
+  if (colonIndex > 0) {
+    const collection = cleanText.slice(0, colonIndex)
+    const name = cleanText.slice(colonIndex + 1)
+    if (ICON_COLLECTIONS.includes(collection) && name && /^[a-z0-9]+(?:-[a-z0-9]+)*$/i.test(name)) {
+      return { collection, name, format: 'colon' }
+    }
+  }
+
+  return null
+}
+
+export function transformerIconHighlight(options: TransformerIconHighlightOptions = {}): ShikiTransformer {
+  const { htmlIcon } = options
+
+  return {
+    name: 'shiki-transformer-icon-highlight',
+    span(hast, _line, _col, _lineElement, token) {
+      const text = token.content
+
+      // Try to parse as an icon
+      const parsed = parseIconName(text)
+      if (!parsed) return
+
+      const iconIdentifier = `${parsed.collection}:${parsed.name}`
+      // Add color=black for mask-image to work properly (mask uses luminance)
+      const iconUrl = `https://api.iconify.design/${iconIdentifier}.svg?color=%23000`
+
+      // Create the icon element as a proper HAST element
+      const iconElement = htmlIcon
+        ? { type: 'raw' as const, value: htmlIcon(iconIdentifier) }
+        : {
+            type: 'element' as const,
+            tagName: 'i',
+            properties: {
+              class: 'shiki-icon-highlight',
+              style: `--shiki-icon-url: url('${iconUrl}')`
+            },
+            children: []
+          }
+
+      // Prepend the icon to the span content
+      if (hast.children) {
+        hast.children.unshift(iconElement)
+      }
+    }
+  }
+}

package/content.config.ts

@@ -1,4 +1,4 @@
-import { defineCollection, defineContentConfig, property, z } from '@nuxt/content'
+import { defineCollection, defineContentConfig, z } from '@nuxt/content'
 import { useNuxt } from '@nuxt/kit'
 import { asSeoCollection } from '@nuxtjs/seo/content'
 import { joinURL } from 'ufo'
@@ -6,6 +6,26 @@ import { joinURL } from 'ufo'
 const { options } = useNuxt()
 const cwd = joinURL(options.rootDir, 'content')
 
+const Avatar = z.object({
+  src: z.string(),
+  alt: z.string().optional()
+})
+
+const Button = z.object({
+  label: z.string(),
+  icon: z.string().optional(),
+  avatar: Avatar.optional(),
+  leadingIcon: z.string().optional(),
+  trailingIcon: z.string().optional(),
+  to: z.string().optional(),
+  target: z.enum(['_blank', '_self']).optional(),
+  color: z.enum(['primary', 'neutral', 'success', 'warning', 'error', 'info']).optional(),
+  size: z.enum(['xs', 'sm', 'md', 'lg', 'xl']).optional(),
+  variant: z.enum(['solid', 'outline', 'subtle', 'soft', 'ghost', 'link']).optional(),
+  id: z.string().optional(),
+  class: z.string().optional()
+})
+
 export default defineContentConfig({
   collections: {
     landing: defineCollection(asSeoCollection({
@@ -22,7 +42,7 @@ export default defineContentConfig({
         include: 'docs/**/*'
       }],
       schema: z.object({
-        links: z.array(property(z.object({})).inherit('@nuxt/ui/components/Button.vue')),
+        links: z.array(Button),
         category: z.string().optional(),
         navigation: z.object({
           title: z.string().optional()

package/modules/css.ts

@@ -21,7 +21,23 @@ export default defineNuxtModule({
 
 @source "${contentDir.replace(/\\/g, '/')}/**/*";
 @source "${layerDir.replace(/\\/g, '/')}/**/*";
-@source "../../app.config.ts";`
+@source "../../app.config.ts";
+
+/* Shiki icon highlight transformer styles */
+.shiki-icon-highlight {
+  display: inline-block;
+  width: 1.25em;
+  height: 1.25em;
+  vertical-align: -0.25em;
+  margin-right: 0.125em;
+  background-color: var(--ui-text-highlighted);
+  -webkit-mask-repeat: no-repeat;
+  mask-repeat: no-repeat;
+  -webkit-mask-size: 100% 100%;
+  mask-size: 100% 100%;
+  -webkit-mask-image: var(--shiki-icon-url);
+  mask-image: var(--shiki-icon-url);
+}`
       }
     })
 

package/nuxt.config.ts

@@ -1,4 +1,5 @@
 import { createResolver } from '@nuxt/kit'
+import { defineNuxtConfig } from 'nuxt/config'
 import pkg from './package.json'
 
 const { resolve } = createResolver(import.meta.url)
@@ -18,6 +19,13 @@ export default defineNuxtConfig({
     'motion-v/nuxt',
     'nuxt-llms'
   ],
+  app: {
+    rootAttrs: {
+      'data-vaul-drawer-wrapper': '',
+      'class': 'bg-default'
+    }
+  },
+  // @ts-ignore - content 配置的类型定义在运行时才能正确解析
   content: {
     build: {
       markdown: {
@@ -32,6 +40,11 @@ export default defineNuxtConfig({
       noApiRoute: false
     }
   },
+  ui: {
+    experimental: {
+      componentDetection: true
+    }
+  },
   runtimeConfig: {
     public: {
       version: pkg.version
@@ -45,7 +58,13 @@ export default defineNuxtConfig({
       : {}
   },
   experimental: {
-    typescriptPlugin: true
+    typescriptPlugin: true,
+    asyncContext: true,
+    defaults: {
+      nuxtLink: {
+        externalRelAttribute: 'noopener'
+      }
+    }
   },
   compatibilityDate: 'latest',
   nitro: {
@@ -65,12 +84,6 @@ export default defineNuxtConfig({
         'tailwind-variants',
         'tailwindcss/colors'
       ]
-    },
-    resolve: {
-      alias: {
-        extend: 'extend/index.js',
-        debug: 'debug/src/browser.js'
-      }
     }
   },
   fonts: {
@@ -87,6 +100,10 @@ export default defineNuxtConfig({
   icon: {
     provider: 'iconify'
   },
+  image: {
+    format: ['webp', 'jpeg', 'jpg', 'png', 'svg'],
+    provider: 'ipx'
+  },
   linkChecker: {
     report: {
       publish: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@movk/nuxt-docs",
   "type": "module",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "private": false,
   "description": "An elegant documentation theme for Nuxt, powered by Nuxt UI and Nuxt Content.",
   "author": "YiXuan <mhaibaraai@gmail.com>",
@@ -27,11 +27,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@iconify-json/lucide": "^1.2.81",
+    "@iconify-json/lucide": "^1.2.82",
     "@iconify-json/simple-icons": "^1.2.63",
     "@iconify-json/vscode-icons": "^1.2.37",
-    "@movk/core": "^1.0.2",
-    "@nuxt/content": "^3.9.0",
+    "@movk/core": "^1.0.3",
+    "@nuxt/content": "^3.10.0",
     "@nuxt/image": "^2.0.0",
     "@nuxt/kit": "^4.2.2",
     "@nuxt/ui": "^4.3.0",
@@ -45,13 +45,14 @@
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",
     "motion-v": "^1.7.4",
-    "nuxt-component-meta": "^0.15.0",
+    "nuxt-component-meta": "^0.16.0",
     "nuxt-llms": "^0.1.3",
     "ohash": "^2.0.11",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.0",
     "prettier": "^3.7.4",
     "scule": "^1.3.0",
+    "shiki-transformer-color-highlight": "^1.0.0",
     "tailwindcss": "^4.1.18",
     "ufo": "^1.6.1"
   }

package/server/api/github/commits.get.ts

@@ -16,6 +16,14 @@ export default defineCachedEventHandler(async (event) => {
   }
 
   const { github } = useAppConfig()
+
+  if (!github || typeof github === 'boolean') {
+    throw createError({
+      statusCode: 500,
+      statusMessage: 'GitHub configuration is not available'
+    })
+  }
+
   const octokit = new Octokit({ auth: process.env.NUXT_GITHUB_TOKEN })
 
   const allCommits = await Promise.all(

package/server/api/github/last-commit.get.ts

@@ -14,6 +14,14 @@ export default defineCachedEventHandler(async (event) => {
   }
 
   const { github } = useAppConfig()
+
+  if (!github || typeof github === 'boolean') {
+    throw createError({
+      statusCode: 500,
+      statusMessage: 'GitHub configuration is not available'
+    })
+  }
+
   const octokit = new Octokit({ auth: process.env.NUXT_GITHUB_TOKEN })
 
   try {
@@ -30,6 +38,9 @@ export default defineCachedEventHandler(async (event) => {
     }
 
     const commit = commits[0]
+    if (!commit) {
+      return null
+    }
 
     // 获取提交者信息，处理 web-flow 场景（PR squash merge）
     let authorName = commit.commit.author?.name ?? ''
@@ -63,14 +74,13 @@ export default defineCachedEventHandler(async (event) => {
     const date = commit.commit.author?.date ?? ''
     const dateFormat = github.dateFormat ?? {}
     const locale = dateFormat.locale ?? 'zh-CN'
-    const timeZone = dateFormat.timeZone ?? 'Asia/Shanghai'
     const formatOptions: Intl.DateTimeFormatOptions = dateFormat.options ?? {
       year: 'numeric',
       month: 'numeric',
       day: 'numeric',
       hour: '2-digit',
       minute: '2-digit',
-      timeZone
+      timeZone: 'Asia/Shanghai'
     }
     const dateFormatted = date
       ? new Date(date).toLocaleDateString(locale, formatOptions)