Merge branch 'main' into docs/azion-deployment

Author: egermano

docs/.vitepress/config.ts

@@ -1,6 +1,7 @@
 import {
   defineConfig,
   resolveSiteDataByRoute,
+  type ConfigEnv,
   type HeadConfig
 } from 'vitepress'
 import {
@@ -12,137 +13,160 @@ import llmstxt from 'vitepress-plugin-llms'
 
 const prod = !!process.env.NETLIFY
 
-export default defineConfig({
-  title: 'VitePress',
+export default (ctx: ConfigEnv) =>
+  defineConfig({
+    title: 'VitePress',
 
-  rewrites: {
-    'en/:rest*': ':rest*'
-  },
+    rewrites: {
+      'en/:rest*': ':rest*'
+    },
 
-  lastUpdated: true,
-  cleanUrls: true,
-  metaChunk: true,
+    lastUpdated: true,
+    cleanUrls: true,
+    metaChunk: true,
 
-  markdown: {
-    math: true,
-    codeTransformers: [
-      // We use `[!!code` in demo to prevent transformation, here we revert it back.
-      {
-        postprocess(code) {
-          return code.replace(/\[\!\!code/g, '[!code')
+    markdown: {
+      math: true,
+      codeTransformers: [
+        // We use `[!!code` in demo to prevent transformation, here we revert it back.
+        {
+          postprocess(code) {
+            return code.replace(/\[\!\!code/g, '[!code')
+          }
+        }
+      ],
+      config(md) {
+        // TODO: remove when https://github.com/vuejs/vitepress/issues/4431 is fixed
+        const fence = md.renderer.rules.fence!
+        md.renderer.rules.fence = function (tokens, idx, options, env, self) {
+          const { localeIndex = 'root' } = env
+          const codeCopyButtonTitle = (() => {
+            switch (localeIndex) {
+              case 'es':
+                return 'Copiar código'
+              case 'fa':
+                return 'کپی کد'
+              case 'ko':
+                return '코드 복사'
+              case 'pt':
+                return 'Copiar código'
+              case 'ru':
+                return 'Скопировать код'
+              case 'zh':
+                return '复制代码'
+              default:
+                return 'Copy code'
+            }
+          })()
+          return fence(tokens, idx, options, env, self).replace(
+            '<button title="Copy Code" class="copy"></button>',
+            `<button title="${codeCopyButtonTitle}" class="copy"></button>`
+          )
         }
+        md.use(groupIconMdPlugin)
       }
-    ],
-    config(md) {
-      // TODO: remove when https://github.com/vuejs/vitepress/issues/4431 is fixed
-      const fence = md.renderer.rules.fence!
-      md.renderer.rules.fence = function (tokens, idx, options, env, self) {
-        const { localeIndex = 'root' } = env
-        const codeCopyButtonTitle = (() => {
-          switch (localeIndex) {
-            case 'es':
-              return 'Copiar código'
-            case 'fa':
-              return 'کپی کد'
-            case 'ko':
-              return '코드 복사'
-            case 'pt':
-              return 'Copiar código'
-            case 'ru':
-              return 'Скопировать код'
-            case 'zh':
-              return '复制代码'
-            default:
-              return 'Copy code'
-          }
-        })()
-        return fence(tokens, idx, options, env, self).replace(
-          '<button title="Copy Code" class="copy"></button>',
-          `<button title="${codeCopyButtonTitle}" class="copy"></button>`
-        )
+    },
+
+    sitemap: {
+      hostname: 'https://vitepress.dev',
+      transformItems(items) {
+        return items.filter((item) => !item.url.includes('migration'))
       }
-      md.use(groupIconMdPlugin)
-    }
-  },
+    },
 
-  sitemap: {
-    hostname: 'https://vitepress.dev',
-    transformItems(items) {
-      return items.filter((item) => !item.url.includes('migration'))
-    }
-  },
+    head: [
+      [
+        'link',
+        { rel: 'icon', type: 'image/svg+xml', href: '/vitepress-logo-mini.svg' }
+      ],
+      [
+        'link',
+        { rel: 'icon', type: 'image/png', href: '/vitepress-logo-mini.png' }
+      ],
+      ['meta', { name: 'theme-color', content: '#5f67ee' }],
+      ['meta', { property: 'og:type', content: 'website' }],
+      ['meta', { property: 'og:site_name', content: 'VitePress' }],
+      [
+        'meta',
+        {
+          property: 'og:image',
+          content: 'https://vitepress.dev/vitepress-og.jpg'
+        }
+      ],
+      ['meta', { property: 'og:url', content: 'https://vitepress.dev/' }],
+      [
+        'script',
+        {
+          src: 'https://cdn.usefathom.com/script.js',
+          'data-site': 'AZBRSFGG',
+          'data-spa': 'auto',
+          defer: ''
+        }
+      ]
+    ],
 
-  /* prettier-ignore */
-  head: [
-    ['link', { rel: 'icon', type: 'image/svg+xml', href: '/vitepress-logo-mini.svg' }],
-    ['link', { rel: 'icon', type: 'image/png', href: '/vitepress-logo-mini.png' }],
-    ['meta', { name: 'theme-color', content: '#5f67ee' }],
-    ['meta', { property: 'og:type', content: 'website' }],
-    ['meta', { property: 'og:site_name', content: 'VitePress' }],
-    ['meta', { property: 'og:image', content: 'https://vitepress.dev/vitepress-og.jpg' }],
-    ['meta', { property: 'og:url', content: 'https://vitepress.dev/' }],
-    ['script', { src: 'https://cdn.usefathom.com/script.js', 'data-site': 'AZBRSFGG', 'data-spa': 'auto', defer: '' }]
-  ],
+    themeConfig: {
+      logo: { src: '/vitepress-logo-mini.svg', width: 24, height: 24 },
 
-  themeConfig: {
-    logo: { src: '/vitepress-logo-mini.svg', width: 24, height: 24 },
+      socialLinks: [
+        { icon: 'github', link: 'https://github.com/vuejs/vitepress' }
+      ],
 
-    socialLinks: [
-      { icon: 'github', link: 'https://github.com/vuejs/vitepress' }
-    ],
+      search: {
+        provider: 'algolia',
+        options: {
+          appId: '8J64VVRP8K',
+          apiKey: '52f578a92b88ad6abde815aae2b0ad7c',
+          indexName: 'vitepress'
+        }
+      },
 
-    search: {
-      provider: 'algolia',
-      options: {
-        appId: '8J64VVRP8K',
-        apiKey: '52f578a92b88ad6abde815aae2b0ad7c',
-        indexName: 'vitepress'
-      }
+      carbonAds: { code: 'CEBDT27Y', placement: 'vuejsorg' }
     },
 
-    carbonAds: { code: 'CEBDT27Y', placement: 'vuejsorg' }
-  },
+    locales: {
+      root: { label: 'English' },
+      zh: { label: '简体中文' },
+      pt: { label: 'Português' },
+      ru: { label: 'Русский' },
+      es: { label: 'Español' },
+      ko: { label: '한국어' },
+      fa: { label: 'فارسی' }
+    },
 
-  locales: {
-    root: { label: 'English' },
-    zh: { label: '简体中文' },
-    pt: { label: 'Português' },
-    ru: { label: 'Русский' },
-    es: { label: 'Español' },
-    ko: { label: '한국어' },
-    fa: { label: 'فارسی' }
-  },
+    vite: {
+      plugins: [
+        groupIconVitePlugin({
+          customIcon: {
+            vitepress: localIconLoader(
+              import.meta.url,
+              '../public/vitepress-logo-mini.svg'
+            ),
+            firebase: 'logos:firebase'
+          }
+        }),
+        prod &&
+          llmstxt({
+            workDir: 'en',
+            ignoreFiles: ['index.md']
+          })
+      ],
+      experimental: {
+        enableNativePlugin: ctx.command === 'build'
+      }
+    },
 
-  vite: {
-    plugins: [
-      groupIconVitePlugin({
-        customIcon: {
-          vitepress: localIconLoader(
-            import.meta.url,
-            '../public/vitepress-logo-mini.svg'
-          ),
-          firebase: 'logos:firebase'
+    transformPageData: prod
+      ? (pageData, ctx) => {
+          const site = resolveSiteDataByRoute(
+            ctx.siteConfig.site,
+            pageData.relativePath
+          )
+          const title = `${pageData.title || site.title} | ${pageData.description || site.description}`
+          ;((pageData.frontmatter.head ??= []) as HeadConfig[]).push(
+            ['meta', { property: 'og:locale', content: site.lang }],
+            ['meta', { property: 'og:title', content: title }]
+          )
         }
-      }),
-      prod &&
-        llmstxt({
-          workDir: 'en',
-          ignoreFiles: ['index.md']
-        })
-    ]
-  },
-
-  transformPageData: prod
-    ? (pageData, ctx) => {
-        const site = resolveSiteDataByRoute(
-          ctx.siteConfig.site,
-          pageData.relativePath
-        )
-        const title = `${pageData.title || site.title} | ${pageData.description || site.description}`
-        ;((pageData.frontmatter.head ??= []) as HeadConfig[]).push(
-          ['meta', { property: 'og:locale', content: site.lang }],
-          ['meta', { property: 'og:title', content: title }]
-        )
-      }
-    : undefined
-})
+      : undefined
+  })

docs/en/reference/cli.md

@@ -43,7 +43,6 @@ vitepress build [root]
 | `--base <path>`                | Public base path (default: `/`) (`string`)                                                                          |
 | `--target <target>`            | Transpile target (default: `"modules"`) (`string`)                                                                  |
 | `--outDir <dir>`               | Output directory relative to **cwd** (default: `<root>/.vitepress/dist`) (`string`)                                 |
-| `--minify [minifier]`          | Enable/disable minification, or specify minifier to use (default: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
 | `--assetsInlineLimit <number>` | Static asset base64 inline threshold in bytes (default: `4096`) (`number`)                                          |
 
 ## `vitepress preview`

docs/en/reference/default-theme-last-updated.md

@@ -2,8 +2,27 @@
 
 The update time of the last content will be displayed in the lower right corner of the page. To enable it, add `lastUpdated` options to your config.
 
-::: tip
-You need to commit the markdown file to see the updated time.
+::: info
+VitePress displays the "last updated" time using the timestamp of the most recent Git commit for each file. To enable this, the Markdown file must be committed to Git.
+
+Internally, VitePress runs `git log -1 --pretty="%ai"` on each file to retrieve its timestamp. If all pages show the same update time, it's likely due to shallow cloning (common in CI environments), which limits Git history.
+
+To fix this in **GitHub Actions**, use the following in your workflow:
+
+```yaml{4}
+- name: Checkout
+  uses: actions/checkout@v4
+  with:
+    fetch-depth: 0
+```
+
+Other CI/CD platforms have similar settings.
+
+If such options aren't available, you can prepend the `docs:build` command in your `package.json` with a manual fetch:
+
+```json
+"docs:build": "git fetch --unshallow && vitepress build docs"
+```
 :::
 
 ## Site-Level Config

docs/es/reference/cli.md

@@ -43,7 +43,6 @@ vitepress build [root]
 | `--base <path>`                | Ruta de base pública (por defecto: `/`) (`string`)                                                                          |
 | `--target <target>`            | Transpilar objetivo (por defecto: `"modules"`) (`string`)                                                                  |
 | `--outDir <dir>`               | Directorio de salida relativo a **cwd** (por defecto: `<root>/.vitepress/dist`) (`string`)                                 |
-| `--minify [minifier]`          | Habilitar/desabilitar la minificación, o especifica un minero para usar (por defecto: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
 | `--assetsInlineLimit <number>` | Limitar los bytes para alinear los activos en base 64 (por defecto: `4096`) (`number`)                                      |
 
 ## `vitepress preview`

docs/fa/reference/cli.md

@@ -43,7 +43,6 @@ vitepress build [root]
 | `--base <path>`                | مسیر پایه عمومی (پیش‌فرض: `/`) (`string`)                                                                       |
 | `--target <target>`            | هدف ترنسپایل (پیش‌فرض: `"modules"`) (`string`)                                                                 |
 | `--outDir <dir>`               | دایرکتوری خروجی نسبت به **cwd** (پیش‌فرض: `<root>/.vitepress/dist`) (`string`)                                |
-| `--minify [minifier]`          | فعال یا غیرفعال کردن فشرده‌سازی، یا تعیین فشرده‌سازی برای استفاده (پیش‌فرض: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
 | `--assetsInlineLimit <number>` | آستانه تبدیل پایه ۶۴ استاتیک به بایت (پیش‌فرض: `4096`) (`number`)                                             |
 
 ## `vitepress preview` {#vitepress-preview}

docs/ko/reference/cli.md

@@ -43,7 +43,6 @@ vitepress build [root]
 | `--base <path>`               | Public 기본 경로 (기본값: `/`) (`string`)                                                              |
 | `--target <target>`           | 트랜스파일 대상 (기본값: `"modules"`) (`string`)                                                      |
 | `--outDir <dir>`              | **cwd** 기준 출력 디렉터리 (기본값: `<root>/.vitepress/dist`) (`string`)                               |
-| `--minify [minifier]`         | minify 활성화/비활성화 또는 사용할 minify 도구 지정 (기본값: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
 | `--assetsInlineLimit <number>`| 바이트 단위의 정적 에셋 base64 인라인 임계값 (기본값: `4096`) (`number`)                                       |
 
 ## `vitepress preview`

docs/package.json

@@ -13,9 +13,9 @@
     "@lunariajs/core": "^0.1.1",
     "markdown-it-mathjax3": "^4.3.2",
     "open-cli": "^8.0.0",
-    "postcss-rtlcss": "^5.7.0",
+    "postcss-rtlcss": "^5.7.1",
     "vitepress": "workspace:*",
-    "vitepress-plugin-group-icons": "^1.5.2",
-    "vitepress-plugin-llms": "^1.1.0"
+    "vitepress-plugin-group-icons": "^1.5.5",
+    "vitepress-plugin-llms": "^1.3.4"
   }
 }

docs/pt/reference/cli.md

@@ -43,7 +43,6 @@ vitepress build [root]
 | `--base <path>`                | Caminho base público (padrão: `/`) (`string`)                                                                          |
 | `--target <target>`            | Transpila o alvo (padrão: `"modules"`) (`string`)                                                                  |
 | `--outDir <dir>`               | Diretório de saída relativo ao **cwd** (padrão: `<root>/.vitepress/dist`) (`string`)                                 |
-| `--minify [minifier]`          | Habilita/desabilita minificação, ou especifica um minificador para usar (padrão: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
 | `--assetsInlineLimit <number>` | Limite em bytes para alinhar ativos em  base64 (padrão: `4096`) (`number`)                                          |
 
 ## `vitepress preview`

docs/ru/reference/cli.md

@@ -43,7 +43,6 @@ vitepress build [root]
 | `--base <path>`                | Публичный базовый путь (по умолчанию: `/`) (`string`)                                                                               |
 | `--target <target>`            | Транспилировать цель (по умолчанию: `"modules"`) (`string`)                                                                         |
 | `--outDir <dir>`               | Выходной каталог относительно **cwd** (по умолчанию: `<root>/.vitepress/dist`) (`string`)                                           |
-| `--minify [minifier]`          | Включить/выключить минификацию или задать используемый минификатор (по умолчанию: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
 | `--assetsInlineLimit <number>` | Статический встроенный порог ресурса base64 в байтах (по умолчанию: `4096`) (`number`)                                              |
 
 ## `vitepress preview` {#vitepress-preview}

docs/zh/reference/cli.md

@@ -43,7 +43,6 @@ vitepress build [root]
 | `--base <path>`                | public base URL (默认值: `/`)  (`string`)                                                            |
 | `--target <target>`            | 转译目标 (默认值：`"modules"`) (`string`)                                                        |
 | `--outDir <dir>`               | 输出目录 (默认值：`.vitepress/dist`) (`string`)                                                  |
-| `--minify [minifier]`          | 启用/禁用压缩，或指定要使用的压缩程序 (默认值：`"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
 | `--assetsInlineLimit <number>` | 静态资源 base64 内联阈值（以字节为单位）(默认值：`4096`) (`number`)                             |
 
 ## `vitepress preview`