@movk/nuxt-docs 1.3.10 → 1.3.12

package/app/components/content/PageLastCommit.vue

@@ -0,0 +1,124 @@
+<script setup lang="ts">
+interface LastCommit {
+  sha: string
+  date: string
+  dateFormatted: string
+  message: string
+  url: string
+  author: {
+    name: string
+    login: string
+    avatar: string
+  }
+}
+
+const props = withDefaults(defineProps<{
+  /**
+   * 文件路径（不含扩展名），通常由页面自动传入
+   */
+  stem: string
+  /**
+   * 文件扩展名，通常由页面自动传入
+   */
+  extension: string
+  /**
+   * 是否显示提交信息。
+   * @defaultValue true
+   */
+  showMessage?: boolean
+  /**
+   * 是否显示作者头像。
+   * @defaultValue true
+   */
+  showAvatar?: boolean
+}>(), {
+  showMessage: true,
+  showAvatar: true
+})
+
+const { github } = useAppConfig()
+
+const filePath = computed(() => {
+  if (!props.stem || !props.extension) return ''
+
+  const rootDir = github && typeof github === 'object' ? github.rootDir : ''
+  return [rootDir, 'content', `${props.stem}.${props.extension}`].filter(Boolean).join('/')
+})
+
+const { data: commit } = await useFetch<LastCommit | null>('/api/github/last-commit', {
+  key: `last-commit-${filePath.value}`,
+  query: { path: filePath },
+  default: () => null,
+  lazy: true,
+  server: false
+})
+
+const commitUrl = computed(() => commit.value?.url ?? '')
+
+const authorUrl = computed(() => {
+  const login = commit.value?.author.login
+  return login ? `https://github.com/${login}` : ''
+})
+</script>
+
+<template>
+  <div v-if="commit" class="flex items-center flex-wrap gap-1.5 text-sm text-muted mt-2">
+    <span class="text-dimmed">最后更新于</span>
+    <time class="font-medium text-default" :datetime="commit.date">{{ commit.dateFormatted }}</time>
+    <span class="text-dimmed">由</span>
+    <ULink
+      v-if="authorUrl"
+      :to="authorUrl"
+      target="_blank"
+      class="inline-flex items-center gap-1.5 hover:opacity-80 transition-opacity"
+    >
+      <UAvatar
+        v-if="showAvatar && commit.author.avatar"
+        :src="commit.author.avatar"
+        :alt="commit.author.name"
+        size="2xs"
+      />
+      <UBadge color="neutral" variant="outline" size="sm">
+        {{ commit.author.name || commit.author.login }}
+      </UBadge>
+    </ULink>
+    <span v-else class="inline-flex items-center gap-1.5">
+      <UAvatar
+        v-if="showAvatar && commit.author.avatar"
+        :src="commit.author.avatar"
+        :alt="commit.author.name"
+        size="2xs"
+      />
+      <UBadge color="neutral" variant="outline" size="sm">
+        {{ commit.author.name || commit.author.login }}
+      </UBadge>
+    </span>
+    <template v-if="showMessage && commit.message">
+      <span class="text-dimmed">提交</span>
+      <ULink
+        v-if="commitUrl"
+        :to="commitUrl"
+        target="_blank"
+        class="hover:opacity-80 transition-opacity max-w-[250px]"
+      >
+        <UBadge
+          color="neutral"
+          variant="outline"
+          size="sm"
+          class="font-mono text-xs"
+        >
+          <span class="truncate">{{ commit.message }}</span>
+        </UBadge>
+      </ULink>
+      <UBadge
+        v-else
+        color="neutral"
+        variant="outline"
+        size="sm"
+        class="max-w-[250px] font-mono text-xs"
+      >
+        <span class="truncate">{{ commit.message }}</span>
+      </UBadge>
+    </template>
+  </div>
+</template>

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

@@ -106,6 +106,8 @@ defineOgImageComponent('Nuxt', {
           unwrap="p"
           :cache-key="`${kebabCase(route.path)}-description`"
         />
+
+        <PageLastCommit v-if="github && page?.stem && page?.extension" :stem="page.stem" :extension="page.extension" />
       </template>
 
       <template #links>

package/app/types/index.d.ts

@@ -37,6 +37,14 @@ declare module 'nuxt/schema' {
       per_page: number
       until: string
       author?: string
+      /**
+       * 日期格式化配置
+       * @example { locale: 'zh-CN', options: { year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' } }
+       */
+      dateFormat?: {
+        locale?: string
+        options?: Intl.DateTimeFormatOptions
+      }
     } | false
   }
 }

package/content.config.ts

@@ -22,7 +22,7 @@ export default defineContentConfig({
         include: 'docs/**/*'
       }],
       schema: z.object({
-        links: property(z.object({})).inherit('@nuxt/ui/components/Button.vue'),
+        links: z.array(property(z.object({})).inherit('@nuxt/ui/components/Button.vue')),
         category: z.string().optional(),
         navigation: z.object({
           title: z.string().optional()

package/modules/config.ts

@@ -70,7 +70,7 @@ export default defineNuxtModule({
         'nuxt-og-image',
         '@nuxtjs/plausible',
         '@nuxt/ui',
-        new RegExp(`${componentsPath.replace(/[/\\]/g, '[/\\\\]')}/(?!content/(ComponentEmits|ComponentProps|ComponentSlots|ComponentExample|CommitChangelog)\\.vue$)`)
+        new RegExp(`${componentsPath.replace(/[/\\]/g, '[/\\\\]')}/(?!content/(ComponentEmits|ComponentProps|ComponentSlots|ComponentExample|CommitChangelog|PageLastCommit)\\.vue$)`)
       ],
       metaFields: {
         type: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@movk/nuxt-docs",
   "type": "module",
-  "version": "1.3.10",
+  "version": "1.3.12",
   "private": false,
   "description": "An elegant documentation theme for Nuxt, powered by Nuxt UI and Nuxt Content.",
   "author": "YiXuan <mhaibaraai@gmail.com>",
@@ -27,13 +27,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@iconify-json/lucide": "^1.2.76",
-    "@iconify-json/simple-icons": "^1.2.60",
+    "@iconify-json/lucide": "^1.2.79",
+    "@iconify-json/simple-icons": "^1.2.62",
     "@iconify-json/vscode-icons": "^1.2.37",
     "@movk/core": "^1.0.2",
-    "@nuxt/content": "^3.8.2",
+    "@nuxt/content": "^3.9.0",
     "@nuxt/image": "^2.0.0",
-    "@nuxt/kit": "^4.2.1",
+    "@nuxt/kit": "^4.2.2",
     "@nuxt/ui": "^4.2.1",
     "@nuxtjs/seo": "^3.2.2",
     "@octokit/rest": "^22.0.1",
@@ -48,7 +48,7 @@
     "ohash": "^2.0.11",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.0",
-    "prettier": "^3.7.1",
+    "prettier": "^3.7.4",
     "scule": "^1.3.0",
     "tailwindcss": "^4.1.17",
     "ufo": "^1.6.1"

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

@@ -0,0 +1,100 @@
+import { Octokit } from '@octokit/rest'
+
+export default defineCachedEventHandler(async (event) => {
+  if (!process.env.NUXT_GITHUB_TOKEN) {
+    return null
+  }
+
+  const { path } = getQuery(event) as { path: string }
+  if (!path) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: 'Path is required'
+    })
+  }
+
+  const { github } = useAppConfig()
+  const octokit = new Octokit({ auth: process.env.NUXT_GITHUB_TOKEN })
+
+  try {
+    const { data: commits } = await octokit.rest.repos.listCommits({
+      sha: github.branch,
+      owner: github.owner,
+      repo: github.name,
+      path,
+      per_page: 1
+    })
+
+    if (!commits.length) {
+      return null
+    }
+
+    const commit = commits[0]
+
+    // 获取提交者信息，处理 web-flow 场景（PR squash merge）
+    let authorName = commit.commit.author?.name ?? ''
+    let authorLogin = commit.author?.login ?? ''
+    let authorAvatar = commit.author?.avatar_url ?? ''
+    let commitUrl = commit.html_url
+
+    // 如果提交者是 web-flow，尝试获取实际的 PR 作者
+    if (authorLogin === 'web-flow') {
+      try {
+        // 从 squash commit message 中提取 PR 编号 (#166)
+        const prMatch = commit.commit.message.match(/#(\d+)/)
+        if (prMatch?.[1]) {
+          const { data: prData } = await octokit.rest.pulls.get({
+            owner: github.owner,
+            repo: github.name,
+            pull_number: Number.parseInt(prMatch[1])
+          })
+
+          authorLogin = prData.user?.login ?? authorLogin
+          authorAvatar = prData.user?.avatar_url ?? authorAvatar
+          authorName = prData.user?.name || authorLogin
+          commitUrl = prData.html_url
+        }
+      } catch {
+        // 获取 PR 信息失败时忽略，使用原始提交者信息
+      }
+    }
+
+    // 格式化日期
+    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
+    }
+    const dateFormatted = date
+      ? new Date(date).toLocaleDateString(locale, formatOptions)
+      : ''
+
+    return {
+      sha: commit.sha,
+      date,
+      dateFormatted,
+      message: commit.commit.message?.split('\n')[0] ?? '',
+      url: commitUrl,
+      author: {
+        name: authorName,
+        login: authorLogin,
+        avatar: authorAvatar
+      }
+    }
+  } catch {
+    return null
+  }
+}, {
+  maxAge: 60 * 60, // 缓存 1 小时
+  getKey: (event) => {
+    const { path } = getQuery(event)
+    return `last-commit-${path}`
+  }
+})