valaxy 0.28.1 → 0.28.3

package/client/components/ValaxyLocalSearch.vue

@@ -0,0 +1,89 @@
+<script lang="ts" setup>
+import type { LocalSearchResult } from '../composables/search/useLocalSearch'
+import { ref, watch } from 'vue'
+import { useRouter } from 'vue-router'
+import { useLocalSearch } from '../composables/search/useLocalSearch'
+
+const props = defineProps<{
+  open: boolean
+}>()
+
+const emit = defineEmits<{
+  (e: 'close'): void
+}>()
+
+const query = ref('')
+const { results, loading, load } = useLocalSearch(query)
+const selectedIndex = ref(0)
+
+const router = useRouter()
+
+watch(() => props.open, (val) => {
+  if (val) {
+    load()
+    selectedIndex.value = 0
+  }
+  else {
+    query.value = ''
+  }
+})
+
+watch(results, () => {
+  selectedIndex.value = 0
+})
+
+function getPageTitle(id: string): string {
+  return id.replace(/#.*$/, '').replace(/\.html$/, '') || '/'
+}
+
+function getSectionTitle(result: LocalSearchResult): string {
+  return [...result.titles, result.title].filter(Boolean).join(' > ')
+}
+
+function navigate(result: LocalSearchResult) {
+  const url = result.id
+  router.push(url)
+  emit('close')
+}
+
+function updateQuery(value: string) {
+  query.value = value
+}
+
+function onKeydown(e: KeyboardEvent) {
+  switch (e.key) {
+    case 'ArrowDown':
+      e.preventDefault()
+      selectedIndex.value = Math.min(selectedIndex.value + 1, results.value.length - 1)
+      break
+    case 'ArrowUp':
+      e.preventDefault()
+      selectedIndex.value = Math.max(selectedIndex.value - 1, 0)
+      break
+    case 'Enter':
+      e.preventDefault()
+      if (results.value[selectedIndex.value]) {
+        navigate(results.value[selectedIndex.value])
+      }
+      break
+    case 'Escape':
+      e.preventDefault()
+      emit('close')
+      break
+  }
+}
+</script>
+
+<template>
+  <slot
+    :query="query"
+    :results="results"
+    :loading="loading"
+    :selected-index="selectedIndex"
+    :update-query="updateQuery"
+    :navigate="navigate"
+    :on-keydown="onKeydown"
+    :get-page-title="getPageTitle"
+    :get-section-title="getSectionTitle"
+  />
+</template>

package/client/components/ValaxyLogo.vue

@@ -28,7 +28,7 @@ import valaxyLogoPng from '../assets/images/valaxy-logo.png'
   max-width: 350px;
   width: 150%;
   height: 150%;
-  background-image: linear-gradient(-45deg, rgb(108, 34, 236) 50%, rgba(59,130,246,var(--un-to-opacity, 1)) 50%);
+  background-image: linear-gradient(-45deg, rgb(108 34 236) 50%, rgb(59 130 246 / var(--un-to-opacity, 1)) 50%);
   opacity: 0.3;
   transition: opacity var(--va-transition-duration-fast);
 }

package/client/components/ValaxyPagination.vue

@@ -74,7 +74,7 @@ function jumpTo(page: number) {
 
 <style lang="scss">
 :root {
-  --page-btn-bg-color: rgba(255, 255, 255, 0.5);
+  --page-btn-bg-color: rgb(255 255 255 / 0.5);
   --page-btn-hover-bg-color: var(--va-c-primary-lighter);
   --page-btn-active-bg-color: var(--va-c-primary-light);
 }

package/client/composables/post/index.ts

@@ -166,7 +166,6 @@ export function mergeCollapsedCollections(
 
 /**
  * get post list in 'pages/posts' folder
- * todo: use vue provide/inject to global
  */
 export function usePostList(params: {
   type?: string

package/client/composables/search/index.ts

@@ -1 +1,2 @@
 export * from './useFuseSearch'
+export * from './useLocalSearch'

package/client/composables/search/useLocalSearch.ts

@@ -0,0 +1,53 @@
+import type MiniSearch from 'minisearch'
+import type { Ref } from 'vue'
+import { ref, shallowRef, watchEffect } from 'vue'
+
+export interface LocalSearchResult {
+  id: string
+  score: number
+  terms: string[]
+  title: string
+  titles: string[]
+}
+
+export function useLocalSearch(query: Ref<string>) {
+  const results = shallowRef<LocalSearchResult[]>([])
+  const loading = ref(false)
+  let miniSearch: MiniSearch | null = null
+
+  async function load(locale = 'root') {
+    loading.value = true
+    try {
+      const searchIndex = (await import('@localSearchIndex')).default
+      const loader = searchIndex[locale] ?? searchIndex[Object.keys(searchIndex)[0]]
+      if (!loader) {
+        loading.value = false
+        return
+      }
+      const mod = await loader()
+      const data: string = JSON.parse(mod.default)
+      const { default: MiniSearchCtor } = await import('minisearch')
+      miniSearch = MiniSearchCtor.loadJSON(data, {
+        fields: ['title', 'titles', 'text'],
+        storeFields: ['title', 'titles'],
+      })
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  watchEffect(() => {
+    if (!miniSearch || !query.value.trim()) {
+      results.value = []
+      return
+    }
+    results.value = miniSearch.search(query.value, {
+      prefix: true,
+      fuzzy: 0.2,
+      boost: { title: 4, text: 2, titles: 1 },
+    }) as unknown as LocalSearchResult[]
+  })
+
+  return { results, loading, load }
+}

package/client/layouts/404.vue

@@ -26,6 +26,6 @@ const { back } = useBack()
 // inspired by https://codepen.io/pgalor/pen/OeRWJQ
 .not-found {
   font-size: 10rem;
-  text-shadow: 0 5px 10px rgba(0,0,0,.25), 0 20px 20px rgba(0,0,0,.15);
+  text-shadow: 0 5px 10px rgb(0 0 0 / .25), 0 20px 20px rgb(0 0 0 / .15);
 }
 </style>

package/client/locales/en.yml

@@ -92,9 +92,12 @@ category:
 
 search:
   placeholder: Searching...
+  loading: Loading...
   empty: 'We could not find any results for the search: {query}.'
   hits_time: '{hits} results found in {time} ms'
   hits: '{count} results found'
+  no_results: No results found
+  no_results_hint: Try adjusting your search terms
 
 symbol:
   comma: ', '

package/client/locales/zh-CN.yml

@@ -91,9 +91,12 @@ category:
 
 search:
   placeholder: 搜索...
+  loading: 加载中...
   empty: '找不到您查询的内容: {query}'
   hits_time: '找到 {hits} 条结果（用时 {time} 毫秒）'
   hits: '找到 {count} 条结果'
+  no_results: 未找到相关结果
+  no_results_hint: 请尝试调整搜索关键词
 
 symbol:
   comma: ，

package/client/modules/components.ts

@@ -1,6 +1,5 @@
 import type { ValaxySSGContext } from '../setups'
 
-import { defineAsyncComponent } from 'vue'
 import AppLink from '../components/AppLink.vue'
 import ValaxyTranslate from '../components/builtin/ValaxyTranslate.vue'
 
@@ -11,10 +10,4 @@ import ValaxyTranslate from '../components/builtin/ValaxyTranslate.vue'
 export function registerGlobalComponents(ctx: ValaxySSGContext) {
   ctx.app.component('AppLink', AppLink)
   ctx.app.component('VT', ValaxyTranslate)
-
-  // DEV-only: register ValaxyDebug component (tree-shaken in production)
-  if (import.meta.env.DEV) {
-    const ValaxyDebug = defineAsyncComponent(() => import('../components/.exclude/ValaxyDebug.vue'))
-    ctx.app.component('ValaxyDebug', ValaxyDebug)
-  }
 }

package/client/shims.d.ts

@@ -37,6 +37,11 @@ declare module '#valaxy/styles' {
   export default styles
 }
 
+declare module '@localSearchIndex' {
+  const index: Record<string, () => Promise<{ default: string }>>
+  export default index
+}
+
 // valaxy features
 declare module '#valaxy/blog/collections' {
   import type { CollectionConfig } from './types'

package/client/styles/common/code.scss

@@ -58,7 +58,7 @@ html:not(.dark) .vp-code-dark {
     white-space: pre;
     word-spacing: normal;
     word-break: normal;
-    word-wrap: normal;
+    overflow-wrap: normal;
     tab-size: 4;
     hyphens: none;
   }

package/client/styles/common/index.scss

@@ -4,4 +4,4 @@
 @use "./transition.scss" as *;
 
 // markdown
-@use "./markdown.scss";
+@use "./markdown";

package/client/styles/common/markdown.scss

@@ -1,7 +1,6 @@
 @use "sass:map";
 
 .markdown-body {
-
   h1,
   h2,
   h3,

package/client/styles/css-vars.scss

@@ -52,27 +52,26 @@ html.dark {
  * - `text-3`: Used for subtle texts, such as "placeholders" or "caret icon".
  * -------------------------------------------------------------------------- */
 :root {
-  --va-c-text-1: rgba(60, 60, 67);
-  --va-c-text-2: rgba(60, 60, 67, 0.78);
-  --va-c-text-3: rgba(60, 60, 67, 0.56);
+  --va-c-text-1: rgb(60 60 67);
+  --va-c-text-2: rgb(60 60 67 / 0.78);
+  --va-c-text-3: rgb(60 60 67 / 0.56);
 }
 
 .dark {
-  --va-c-text-1: rgba(255, 255, 245, 0.86);
-  --va-c-text-2: rgba(235, 235, 245, 0.6);
-  --va-c-text-3: rgba(235, 235, 245, 0.38);
+  --va-c-text-1: rgb(255 255 245 / 0.86);
+  --va-c-text-2: rgb(235 235 245 / 0.6);
+  --va-c-text-3: rgb(235 235 245 / 0.38);
 }
 
 // bg
 :root {
-  --va-c-bg: #ffffff;
-  --va-c-bg-light: #ffffff;
+  --va-c-bg: #fff;
+  --va-c-bg-light: #fff;
   --va-c-bg-dark: #fafafa;
-  --va-c-bg-opacity: rgba(255, 255, 255, 0.8);
+  --va-c-bg-opacity: rgb(255 255 255 / 0.8);
   --va-c-bg-soft: #f9f9f9;
   --va-c-bg-alt: #f9f9f9;
   --va-c-bg-mute: #f1f1f1;
-
   --va-c-bg-elevated: #f9f9f9;
 }
 
@@ -80,11 +79,10 @@ html.dark {
   --va-c-bg: #1a1a1d;
   --va-c-bg-light: #202127;
   --va-c-bg-dark: #1a1a1a;
-  --va-c-bg-opacity: rgba(0, 0, 0, 0.8);
+  --va-c-bg-opacity: rgb(0 0 0 / 0.8);
   --va-c-bg-alt: #161618;
   --va-c-bg-soft: #202127;
   --va-c-bg-mute: #2f2f2f;
-
   --va-c-bg-elevated: #202127;
 }
 

package/client/styles/mixins/index.scss

@@ -1,4 +1,4 @@
-@forward './config.scss';
-@forward './media.scss';
-@forward './size.scss';
-@forward './variable.scss';
+@forward './config';
+@forward './media';
+@forward './size';
+@forward './variable';

package/client/styles/third/katex.scss

@@ -1,6 +1,5 @@
 .katex-display {
-  overflow-x: auto;
-  overflow-y: visible;
+  overflow: auto visible;
   padding: 8px 0;
 }
 

package/dist/node/cli/index.mjs

@@ -1,7 +1,7 @@
 import 'node:process';
 import 'yargs';
 import 'yargs/helpers';
-export { c as cli, I as registerDevCommand, W as run, Z as startValaxyDev } from '../../shared/valaxy.DFTOADvQ.mjs';
+export { c as cli, J as registerDevCommand, X as run, _ as startValaxyDev } from '../../shared/valaxy.DQM5mnja.mjs';
 import 'node:os';
 import 'node:path';
 import 'consola';

package/dist/node/index.d.mts

@@ -1,7 +1,7 @@
 import { ViteSSGOptions } from 'vite-ssg';
 import * as vite from 'vite';
 import { UserConfig, InlineConfig, ViteDevServer, PluginOption, Plugin } from 'vite';
-import { S as SiteConfig, D as DefaultTheme, R as RuntimeConfig, a as RedirectItem, V as ValaxyConfig, P as PartialDeep, b as ValaxyAddon, U as UserSiteConfig } from '../shared/valaxy.6MW2qn5T.mjs';
+import { S as SiteConfig, D as DefaultTheme, R as RuntimeConfig, a as RedirectItem, V as ValaxyConfig, P as PartialDeep, b as ValaxyAddon, U as UserSiteConfig } from '../shared/valaxy.D8f6owDk.mjs';
 import Vue from '@vitejs/plugin-vue';
 import { Hookable } from 'hookable';
 import { PluginVisualizerOptions } from 'rollup-plugin-visualizer';
@@ -983,10 +983,17 @@ declare function build(valaxyApp: ValaxyNode, viteConfig?: InlineConfig): Promis
  */
 declare function ssgBuildLegacy(valaxyApp: ValaxyNode, viteConfig?: InlineConfig): Promise<void>;
 /**
- * post process for ssg fix extra string like `/html>` `ml>` `l>`
- * handle tasks after ssg build
- * todo find why
- * @param options
+ * Fix corrupted HTML produced by vite-ssg's JSDOM serialization under memory
+ * pressure. JSDOM.serialize() can emit truncated trailing fragments
+ * (e.g. `/html>`, `ml>`, `l>`) when heap is constrained during
+ * high-concurrency renders.
+ *
+ * Only needed for the legacy vite-ssg engine; the built-in Valaxy SSG
+ * engine uses pure string rendering and is not affected.
+ */
+declare function fixViteSsgHtml(options: ResolvedValaxyOptions): Promise<void>;
+/**
+ * Shared post-processing after SSG build (both engines).
  */
 declare function postProcessForSSG(options: ResolvedValaxyOptions): Promise<void>;
 declare function generateClientRedirects(options: ResolvedValaxyOptions): Promise<void>;
@@ -1210,5 +1217,5 @@ declare function toAtFS(path: string): string;
 declare function resolveImportPath(importName: string, ensure?: true): Promise<string>;
 declare function resolveImportPath(importName: string, ensure?: boolean): Promise<string | undefined>;
 
-export { $t, ALL_ROUTE, EXCERPT_SEPARATOR, GLOBAL_STATE, PATHNAME_PROTOCOL_RE, ViteValaxyPlugins, build, createServer, createValaxyPlugin, customElements, defaultSiteConfig, defaultValaxyConfig, defaultViteConfig, defineAddon, defineConfig, defineContentLoader, defineSiteConfig, defineTheme, defineUnoSetup, defineValaxyAddon, defineValaxyConfig, defineValaxyTheme, encryptContent, generateClientRedirects, getGitTimestamp, getIndexHtml, getServerInfoText, isExternal, isInstalledGlobally, isKatexEnabled, isKatexPluginNeeded, isMathJaxEnabled, isPath, loadConfigFromFile, mergeValaxyConfig, mergeViteConfigs, postProcessForSSG, processValaxyOptions, resolveAddonsConfig, resolveImportPath, resolveImportUrl, resolveOptions, resolveSiteConfig, resolveSiteConfigFromRoot, resolveThemeConfigFromRoot, resolveThemeValaxyConfig, resolveUserThemeConfig, resolveValaxyConfig, resolveValaxyConfigFromRoot, ssgBuild, ssgBuildLegacy, toAtFS, transformObject, version };
+export { $t, ALL_ROUTE, EXCERPT_SEPARATOR, GLOBAL_STATE, PATHNAME_PROTOCOL_RE, ViteValaxyPlugins, build, createServer, createValaxyPlugin, customElements, defaultSiteConfig, defaultValaxyConfig, defaultViteConfig, defineAddon, defineConfig, defineContentLoader, defineSiteConfig, defineTheme, defineUnoSetup, defineValaxyAddon, defineValaxyConfig, defineValaxyTheme, encryptContent, fixViteSsgHtml, generateClientRedirects, getGitTimestamp, getIndexHtml, getServerInfoText, isExternal, isInstalledGlobally, isKatexEnabled, isKatexPluginNeeded, isMathJaxEnabled, isPath, loadConfigFromFile, mergeValaxyConfig, mergeViteConfigs, postProcessForSSG, processValaxyOptions, resolveAddonsConfig, resolveImportPath, resolveImportUrl, resolveOptions, resolveSiteConfig, resolveSiteConfigFromRoot, resolveThemeConfigFromRoot, resolveThemeValaxyConfig, resolveUserThemeConfig, resolveValaxyConfig, resolveValaxyConfigFromRoot, ssgBuild, ssgBuildLegacy, toAtFS, transformObject, version };
 export type { CdnModule, ContentItem, ContentLoader, ContentLoaderContext, HookResult, LoadConfigFromFileOptions, MdAfterRenderContext, ResolvedConfig, ResolvedValaxyOptions, UnoSetup, UserInputConfig, UserValaxyNodeConfig, ValaxyAddonExport, ValaxyAddonFn, ValaxyAddonLike, ValaxyAddonResolver, ValaxyAddons, ValaxyApp, ValaxyConfigExport, ValaxyConfigExtendKey, ValaxyConfigFn, ValaxyEntryOptions, ValaxyExtendConfig, ValaxyHooks, ValaxyNode, ValaxyNodeConfig, ValaxyPickConfig, ValaxyServerOptions, ValaxyTheme };

package/dist/node/index.mjs

@@ -1,5 +1,6 @@
-export { A as ALL_ROUTE, E as EXCERPT_SEPARATOR, G as GLOBAL_STATE, P as PATHNAME_PROTOCOL_RE, V as ViteValaxyPlugins, b as build, c as cli, a as createServer, d as createValaxyPlugin, e as customElements, f as defaultSiteConfig, g as defaultValaxyConfig, h as defaultViteConfig, i as defineAddon, j as defineConfig, k as defineSiteConfig, l as defineTheme, m as defineValaxyAddon, n as defineValaxyConfig, o as defineValaxyTheme, p as encryptContent, q as generateClientRedirects, r as getGitTimestamp, s as getIndexHtml, t as getServerInfoText, u as isExternal, v as isInstalledGlobally, w as isKatexEnabled, x as isKatexPluginNeeded, y as isMathJaxEnabled, z as isPath, B as loadConfigFromFile, C as mergeValaxyConfig, D as mergeViteConfigs, F as postProcessForSSG, H as processValaxyOptions, I as registerDevCommand, J as resolveAddonsConfig, K as resolveImportPath, L as resolveImportUrl, M as resolveOptions, N as resolveSiteConfig, O as resolveSiteConfigFromRoot, Q as resolveThemeConfigFromRoot, R as resolveThemeValaxyConfig, S as resolveUserThemeConfig, T as resolveValaxyConfig, U as resolveValaxyConfigFromRoot, W as run, X as ssgBuild, Y as ssgBuildLegacy, Z as startValaxyDev, _ as toAtFS, $ as transformObject, a0 as version } from '../shared/valaxy.DFTOADvQ.mjs';
+export { A as ALL_ROUTE, E as EXCERPT_SEPARATOR, G as GLOBAL_STATE, P as PATHNAME_PROTOCOL_RE, V as ViteValaxyPlugins, b as build, c as cli, a as createServer, d as createValaxyPlugin, e as customElements, f as defaultSiteConfig, g as defaultValaxyConfig, h as defaultViteConfig, i as defineAddon, j as defineConfig, k as defineSiteConfig, l as defineTheme, m as defineValaxyAddon, n as defineValaxyConfig, o as defineValaxyTheme, p as encryptContent, q as fixViteSsgHtml, r as generateClientRedirects, s as getGitTimestamp, t as getIndexHtml, u as getServerInfoText, v as isExternal, w as isInstalledGlobally, x as isKatexEnabled, y as isKatexPluginNeeded, z as isMathJaxEnabled, B as isPath, C as loadConfigFromFile, D as mergeValaxyConfig, F as mergeViteConfigs, H as postProcessForSSG, I as processValaxyOptions, J as registerDevCommand, K as resolveAddonsConfig, L as resolveImportPath, M as resolveImportUrl, N as resolveOptions, O as resolveSiteConfig, Q as resolveSiteConfigFromRoot, R as resolveThemeConfigFromRoot, S as resolveThemeValaxyConfig, T as resolveUserThemeConfig, U as resolveValaxyConfig, W as resolveValaxyConfigFromRoot, X as run, Y as ssgBuild, Z as ssgBuildLegacy, _ as startValaxyDev, $ as toAtFS, a0 as transformObject, a1 as version } from '../shared/valaxy.DQM5mnja.mjs';
 import 'node:path';
+import 'consola';
 import 'fs-extra';
 import 'consola/utils';
 import 'node:process';
@@ -7,7 +8,6 @@ import 'define-config-ts';
 import 'yargs';
 import 'yargs/helpers';
 import 'node:os';
-import 'consola';
 import 'fast-glob';
 import 'gray-matter';
 import 'js-yaml';

package/dist/shared/{valaxy.6MW2qn5T.d.mts → valaxy.D8f6owDk.d.mts}

@@ -655,7 +655,7 @@ interface SiteConfig {
          * - algolia: Algolia Search
          * - engine: Engine Search, like Google/Baidu
          * - fuse: Local Search by fuse.js
-         * - local(todo): Local Search by MiniSearch
+         * - local: Local Search by MiniSearch
          */
         provider: 'algolia' | 'engine' | 'fuse' | 'local';
     };

package/dist/shared/{valaxy.DFTOADvQ.mjs → valaxy.DQM5mnja.mjs}

@@ -177,10 +177,15 @@ const customElements = /* @__PURE__ */ new Set([
 const defaultViteConfig = {};
 
 const logger = consola.create({});
+function setLogLevel(level) {
+  consola.level = level;
+  logger.level = level;
+}
 const valaxyPrefix = colors.magenta("[valaxy]");
 const vLogger = {
   success: (...args) => logger.success(valaxyPrefix, ...args),
   info: (...args) => logger.info(valaxyPrefix, ...args),
+  debug: (...args) => logger.debug(valaxyPrefix, ...args),
   ready: (...args) => logger.ready(valaxyPrefix, ...args)
 };
 async function callHookWithLog(hookName, valaxyApp) {
@@ -690,9 +695,16 @@ function countPerformanceTime() {
   return () => {
     const end = performance.now();
     const duration = end - start;
+    let timeStr;
     if (duration > 1e3)
-      return `${(duration / 1e3).toFixed(2)}s`;
-    return `${duration.toFixed(2)}ms`;
+      timeStr = `${(duration / 1e3).toFixed(2)}s`;
+    else
+      timeStr = `${duration.toFixed(2)}ms`;
+    if (duration > 3e3)
+      return colors.red(timeStr);
+    if (duration > 500)
+      return colors.yellow(timeStr);
+    return colors.green(timeStr);
   };
 }
 
@@ -1721,7 +1733,7 @@ async function setupMarkdownPlugins(md, options, base = "/") {
   return md;
 }
 
-const version = "0.28.1";
+const version = "0.28.3";
 
 const GLOBAL_STATE = {
   valaxyApp: void 0,
@@ -2333,9 +2345,6 @@ const EXCLUDE = [
   "@vueuse/shared",
   "@unocss/reset",
   "unocss",
-  // addon, todo add externals for addon
-  // main field error
-  "meting",
   // internal
   "valaxy",
   "virtual:valaxy-addons:empty",
@@ -2352,6 +2361,7 @@ const EXCLUDE = [
   "vue-router/experimental"
 ];
 function createConfigPlugin(options) {
+  const addonNames = options.addons.map((a) => a.name);
   const addonDeps = options.addons.map((i) => Object.keys(i.pkg.dependencies || {})).flat();
   const cdnModuleNames = options.mode === "build" ? (options.config.cdn?.modules || []).map((m) => m.name) : [];
   const katexEnabled = isKatexPluginNeeded(options.config);
@@ -2401,7 +2411,7 @@ function createConfigPlugin(options) {
           entries: [resolve$1(options.clientRoot, "main.ts")],
           // must need it
           include: includedDeps,
-          exclude: EXCLUDE
+          exclude: uniq([...EXCLUDE, ...addonNames])
         },
         server: {
           fs: {
@@ -3271,6 +3281,7 @@ function createScanDeadLinks(options) {
   };
 }
 
+let globalPasswordLoggedOnce = false;
 function createTransformEncrypt(options) {
   const { config: { siteConfig: { encrypt } } } = options;
   return async (code, id, pageData) => {
@@ -3283,9 +3294,17 @@ function createTransformEncrypt(options) {
           "</ClientOnly>"
         ].join("");
       };
+      const globalPassword = process.env.VALAXY_ENCRYPT_PASSWORD;
+      const password = frontmatter.password || frontmatter.encrypt === true && globalPassword || void 0;
+      if (password && !frontmatter.password && globalPassword) {
+        if (!globalPasswordLoggedOnce) {
+          consola.info("Using global encrypt password from env `VALAXY_ENCRYPT_PASSWORD`");
+          globalPasswordLoggedOnce = true;
+        }
+      }
       const encryptRegexp = /<!-- valaxy-encrypt-start:(?<password>\w+) -->(?<content>.*?)<!-- valaxy-encrypt-end -->/gs;
       const encryptCommentRegexp = /((<!-- valaxy-encrypt-start:\w+ -->)|(<!-- valaxy-encrypt-end -->))/g;
-      if (frontmatter.password) {
+      if (password) {
         code = code.replaceAll(encryptCommentRegexp, "");
       } else {
         const partiallyEncryptedContents = [];
@@ -3311,12 +3330,12 @@ function createTransformEncrypt(options) {
           });
         }
       }
-      if (frontmatter.password) {
+      if (password) {
         const templateStart = code.indexOf("<template>");
         const templateEnd = code.lastIndexOf("</template>");
         const content = code.slice(templateStart + 10, templateEnd);
         const encryptedContent = await encryptContent(content, {
-          password: frontmatter.password,
+          password,
           iv: encrypt.iv,
           salt: encrypt.salt
         });
@@ -3765,12 +3784,14 @@ async function resolveAddonsConfig(addons, options) {
   let valaxyConfig = {};
   const results = await Promise.all(
     addons.map(async (addon) => {
+      const addonTimer = countPerformanceTime();
       const addonConfigPath = path$1.resolve(addon.root, "valaxy.config.ts");
       if (!await fs.exists(addonConfigPath))
         return null;
       const { config, configFile } = await resolveValaxyConfigFromRoot(addon.root, options);
       if (!config)
         return null;
+      consola.debug(`    resolveAddonConfig(${addon.name}): ${addonTimer()}`);
       return { addon, config, configFile };
     })
   );
@@ -3831,13 +3852,17 @@ async function parseAddons(addons, userRoot = process.cwd()) {
   if (Array.isArray(addons)) {
     for (const addon of addons) {
       if (typeof addon === "string") {
+        const addonTimer = countPerformanceTime();
         const resolver = await readAddonModule(addon, { cwd: userRoot });
+        consola.debug(`    readAddonModule(${addon}): ${addonTimer()}`);
         if (resolver)
           mergeResolver(resolver);
         continue;
       }
       if (typeof addon === "object") {
+        const addonTimer = countPerformanceTime();
         const resolver = await readAddonModule(addon.name, { cwd: userRoot });
+        consola.debug(`    readAddonModule(${addon.name}): ${addonTimer()}`);
         if (!resolver)
           continue;
         const merged = defu(addon || {}, resolver);
@@ -3943,10 +3968,16 @@ async function processSiteConfig(options) {
 }
 async function processValaxyOptions(valaxyOptions, valaxyConfig) {
   const { clientRoot, themeRoot, userRoot } = valaxyOptions;
+  const parseAddonsTimer = countPerformanceTime();
   const addons = await parseAddons(valaxyConfig.addons || [], valaxyOptions.userRoot);
+  consola.debug(`  \u251C\u2500 parseAddons: ${parseAddonsTimer()}`);
+  const resolveAddonsTimer = countPerformanceTime();
   const addonsValaxyConfig = await resolveAddonsConfig(addons, valaxyOptions);
+  consola.debug(`  \u251C\u2500 resolveAddonsConfig: ${resolveAddonsTimer()}`);
+  const mergeTimer = countPerformanceTime();
   valaxyConfig = mergeValaxyConfig(valaxyConfig, addonsValaxyConfig);
   const rolldownOutputOptions = getRolldownOutputOptions(valaxyOptions);
+  consola.debug(`  \u251C\u2500 mergeValaxyConfig + getRolldownOutputOptions: ${mergeTimer()}`);
   const buildConfig = defaultValaxyConfig.vite.build ??= {};
   buildConfig.rolldownOptions = {
     ...buildConfig.rolldownOptions,
@@ -3978,7 +4009,9 @@ async function processValaxyOptions(valaxyOptions, valaxyConfig) {
     ...resolvedBuild.rolldownOptions,
     external: external.filter((name) => !addonNames.includes(name))
   };
+  const siteConfigTimer = countPerformanceTime();
   await processSiteConfig(valaxyOptions);
+  consola.debug(`  \u2514\u2500 processSiteConfig: ${siteConfigTimer()}`);
   return valaxyOptions;
 }
 async function resolveOptions(options = { userRoot: process.cwd() }, mode = "dev") {
@@ -3986,6 +4019,7 @@ async function resolveOptions(options = { userRoot: process.cwd() }, mode = "dev
   const clientRoot = resolve(pkgRoot, "client");
   const userRoot = resolve(options.userRoot || process.cwd());
   consola.start(`Resolve ${colors.magenta("valaxy")} config ...`);
+  const configTimer = countPerformanceTime();
   const [resolvedValaxy, resolvedSite, resolvedTheme, pages] = await Promise.all([
     resolveValaxyConfig(options),
     resolveSiteConfig(options.userRoot),
@@ -3996,6 +4030,7 @@ async function resolveOptions(options = { userRoot: process.cwd() }, mode = "dev
       ignore: ["**/node_modules"]
     })
   ]);
+  consola.debug(`Parallel config resolve: ${configTimer()}`);
   let { config: userValaxyConfig, configFile, theme } = resolvedValaxy;
   const themeRoot = await getThemeRoot(theme, options.userRoot);
   const { siteConfig, siteConfigFile } = resolvedSite;
@@ -4041,7 +4076,9 @@ async function resolveOptions(options = { userRoot: process.cwd() }, mode = "dev
   debug(valaxyOptions);
   const themeValaxyConfig = await resolveThemeValaxyConfig(valaxyOptions);
   const valaxyConfig = mergeValaxyConfig(userValaxyConfig, themeValaxyConfig);
+  const processTimer = countPerformanceTime();
   valaxyOptions = await processValaxyOptions(valaxyOptions, valaxyConfig);
+  consola.debug(`processValaxyOptions: ${processTimer()}`);
   fs.ensureDirSync(valaxyOptions.tempDir);
   return valaxyOptions;
 }
@@ -4391,6 +4428,10 @@ async function createRouterPlugin(valaxyApp) {
       ...valaxyConfig.loaders?.length ? [resolve(options.tempDir, "content", "pages")] : []
     ],
     dts: resolve(options.tempDir, "route-map.d.ts"),
+    // Disable file watching during build to prevent chokidar from opening
+    // too many file descriptors (EMFILE) in large monorepos.
+    // vue-router defaults to `watch: !process.env.CI`, which is true locally.
+    watch: options.mode !== "build",
     ...valaxyConfig.router,
     /**
      * @experimental See https://github.com/posva/unplugin-vue-router/issues/43 (now part of vue-router)
@@ -4401,7 +4442,7 @@ async function createRouterPlugin(valaxyApp) {
         _lastFrontmatterRef = valaxyConfig.siteConfig.frontmatter;
         _cachedFrontmatter = structuredClone(valaxyConfig.siteConfig.frontmatter);
       }
-      const defaultFrontmatter = structuredClone(_cachedFrontmatter) || {};
+      const defaultFrontmatter = structuredClone(_cachedFrontmatter);
       if (route.meta && route.meta.frontmatter) {
         const { frontmatter: _, otherMeta } = route.meta;
         route.meta = otherMeta;
@@ -4470,6 +4511,8 @@ async function createRouterPlugin(valaxyApp) {
           "links",
           "photos"
           // @TODO defineBasicLoader for page
+          // Waiting for upstream API to stabilize
+          // https://github.com/YunYouJun/valaxy/issues/487
           // 'projects',
         ];
         const routerFM = {
@@ -4521,7 +4564,10 @@ async function createRouterPlugin(valaxyApp) {
           path
         });
       }
+      const extendRouteTimer = countPerformanceTime();
       await valaxyApp.hooks.callHook("vue-router:extendRoute", route);
+      const extendDuration = extendRouteTimer();
+      vLogger.debug(`  extendRoute(${route.fullPath}): ${extendDuration}`);
       return valaxyConfig.router?.extendRoute?.(route);
     },
     async beforeWriteFiles(root) {
@@ -4533,6 +4579,15 @@ async function createRouterPlugin(valaxyApp) {
 async function ViteValaxyPlugins(valaxyApp, serverOptions = {}) {
   const { options } = valaxyApp;
   const { roots, config: valaxyConfig } = options;
+  const timers = {
+    markdown: countPerformanceTime(),
+    valaxy: countPerformanceTime(),
+    vue: countPerformanceTime(),
+    router: countPerformanceTime(),
+    unocss: countPerformanceTime(),
+    localSearch: countPerformanceTime(),
+    scanTitles: countPerformanceTime()
+  };
   const [
     MarkdownPlugin,
     ValaxyPlugin,
@@ -4542,8 +4597,14 @@ async function ViteValaxyPlugins(valaxyApp, serverOptions = {}) {
     LocalSearchPlugin,
     scannedTitles
   ] = await Promise.all([
-    createMarkdownPlugin(options),
-    createValaxyPlugin(options, serverOptions),
+    createMarkdownPlugin(options).then((r) => {
+      vLogger.debug(`  \u251C\u2500 createMarkdownPlugin: ${timers.markdown()}`);
+      return r;
+    }),
+    createValaxyPlugin(options, serverOptions).then((r) => {
+      vLogger.debug(`  \u251C\u2500 createValaxyPlugin: ${timers.valaxy()}`);
+      return r;
+    }),
     import('@vitejs/plugin-vue').then(
       (r) => r.default({
         include: /\.(?:vue|md)$/,
@@ -4563,11 +4624,26 @@ async function ViteValaxyPlugins(valaxyApp, serverOptions = {}) {
           }
         }
       })
-    ),
-    createRouterPlugin(valaxyApp),
-    createUnocssPlugin(options),
-    localSearchPlugin(options),
-    scanCodeBlockTitles(options)
+    ).then((r) => {
+      vLogger.debug(`  \u251C\u2500 plugin-vue: ${timers.vue()}`);
+      return r;
+    }),
+    createRouterPlugin(valaxyApp).then((r) => {
+      vLogger.debug(`  \u251C\u2500 createRouterPlugin: ${timers.router()}`);
+      return r;
+    }),
+    createUnocssPlugin(options).then((r) => {
+      vLogger.debug(`  \u251C\u2500 createUnocssPlugin: ${timers.unocss()}`);
+      return r;
+    }),
+    localSearchPlugin(options).then((r) => {
+      vLogger.debug(`  \u251C\u2500 localSearchPlugin: ${timers.localSearch()}`);
+      return r;
+    }),
+    scanCodeBlockTitles(options).then((r) => {
+      vLogger.debug(`  \u2514\u2500 scanCodeBlockTitles: ${timers.scanTitles()}`);
+      return r;
+    })
   ]);
   const componentsDirs = [...roots.map((root) => `${root}/components`), ...["src/components", "components"]];
   const plugins = [
@@ -4875,7 +4951,10 @@ async function ssgBuild(valaxyApp, viteConfig = {}, userSsgOptions = {}) {
       noExternal: ["workbox-window", /vue-i18n/, "@vue/devtools-api", ...cdnModuleNames]
     },
     build: {
-      sourcemap: false
+      sourcemap: false,
+      // Explicitly disable watch to prevent chokidar from opening too many
+      // file descriptors (EMFILE) on macOS in large monorepos.
+      watch: null
     }
   };
   const inlineConfig = mergeConfig(defaultConfig, viteConfig);
@@ -5040,7 +5119,10 @@ async function ssgBuildLegacy(valaxyApp, viteConfig = {}) {
       noExternal: ["workbox-window", /vue-i18n/, "@vue/devtools-api", ...cdnModuleNames]
     },
     build: {
-      sourcemap: false
+      sourcemap: false,
+      // Explicitly disable watch to prevent chokidar from opening too many
+      // file descriptors (EMFILE) on macOS in large monorepos.
+      watch: null
     }
   };
   const inlineConfig = mergeConfig(defaultConfig, viteConfig);
@@ -5149,19 +5231,19 @@ async function ssgBuildLegacy(valaxyApp, viteConfig = {}) {
   }
   await viteSsgBuild(mergedSsgOptions, inlineConfig);
 }
-async function postProcessForSSG(options) {
-  const { userRoot } = options;
-  const indexPath = resolve$1(userRoot, "dist/index.html");
-  if (fs.existsSync(indexPath)) {
-    consola.info("post process for ssg...");
-    const indexFile = await fs.readFile(indexPath, "utf-8");
-    const htmlTag = "</html>";
-    if (!indexFile.endsWith(htmlTag)) {
-      consola.warn("fix incomplete index.html...");
-      const htmlTagStart = indexFile.lastIndexOf(htmlTag);
-      await fs.writeFile(indexPath, indexFile.slice(0, htmlTagStart + htmlTag.length), "utf-8");
-    }
+async function fixViteSsgHtml(options) {
+  const indexPath = resolve$1(options.userRoot, "dist/index.html");
+  if (!fs.existsSync(indexPath))
+    return;
+  const indexFile = await fs.readFile(indexPath, "utf-8");
+  const htmlTag = "</html>";
+  if (!indexFile.endsWith(htmlTag)) {
+    consola.warn("Fixing incomplete index.html generated by vite-ssg...");
+    const htmlTagStart = indexFile.lastIndexOf(htmlTag);
+    await fs.writeFile(indexPath, indexFile.slice(0, htmlTagStart + htmlTag.length), "utf-8");
   }
+}
+async function postProcessForSSG(options) {
   if (!options.config.siteConfig.redirects?.useVueRouter)
     await generateClientRedirects(options);
 }
@@ -5433,8 +5515,10 @@ async function getPosts(params, options) {
       return false;
     return true;
   });
-  if (draftPosts.length)
-    consola.log(`[rss] Skipped ${draftPosts.length} draft post(s): ${draftPosts.join(", ")}`);
+  if (draftPosts.length) {
+    consola.warn(`[rss] Skipped ${colors.yellow(String(draftPosts.length))} draft post(s):
+${draftPosts.map((p) => `  ${colors.dim("-")} ${colors.dim(p)}`).join("\n")}`);
+  }
   const posts = [];
   for (const rawPost of filteredPosts) {
     const { data, path, content, excerpt } = rawPost;
@@ -5861,12 +5945,15 @@ function getServerInfoText(msg) {
 async function createServer(valaxyApp, viteConfig = {}, serverOptions = {}) {
   process.env.EDITOR = process.env.EDITOR || "code";
   const { options } = valaxyApp;
+  const pluginsTimer = countPerformanceTime();
   const plugins = await ViteValaxyPlugins(valaxyApp, serverOptions);
+  vLogger.debug(`ViteValaxyPlugins: ${pluginsTimer()}`);
   const enableDevtools = options.config.devtools;
   const vitePlugins = [
     ...plugins
   ];
   if (enableDevtools) {
+    const devtoolsTimer = countPerformanceTime();
     const [vueDevtools, valaxyDevtools] = await Promise.all([
       import('vite-plugin-vue-devtools'),
       import('@valaxyjs/devtools')
@@ -5877,6 +5964,7 @@ async function createServer(valaxyApp, viteConfig = {}, serverOptions = {}) {
         userRoot: options.userRoot
       })
     );
+    vLogger.debug(`devtools plugins: ${devtoolsTimer()}`);
   }
   const mergedViteConfig = mergeConfig(
     viteConfig,
@@ -5884,7 +5972,9 @@ async function createServer(valaxyApp, viteConfig = {}, serverOptions = {}) {
       plugins: vitePlugins
     }
   );
+  const viteServerTimer = countPerformanceTime();
   const server = await createServer$1(mergedViteConfig);
+  vLogger.debug(`createViteServer: ${viteServerTimer()}`);
   return server;
 }
 
@@ -5926,10 +6016,12 @@ async function initServer(valaxyApp, viteConfig) {
   }
   const { options } = valaxyApp;
   serverSpinner.start();
+  const mergeTimer = countPerformanceTime();
   const viteConfigs = mergeConfig(
     await mergeViteConfigs(options, "serve"),
     viteConfig
   );
+  vLogger.debug(`mergeViteConfigs: ${mergeTimer()}`);
   try {
     GLOBAL_STATE.server = await createServer(valaxyApp, viteConfigs, {
       async onConfigReload(newConfig, config, force = false) {
@@ -5945,7 +6037,9 @@ async function initServer(valaxyApp, viteConfig) {
       }
     });
     const server = GLOBAL_STATE.server;
+    const listenTimer = countPerformanceTime();
     await server.listen();
+    vLogger.debug(`server.listen: ${listenTimer()}`);
     serverSpinner.succeed(`${valaxyPrefix} ${colors.green("server ready.")}`);
     return server;
   } catch (e) {
@@ -6003,6 +6097,7 @@ async function execBuild({ ssg, ssgEngine, root, output, log }) {
         consola.info(`use ${colors.yellow("vite-ssg")} (legacy) to do ssg build...`);
         try {
           await ssgBuildLegacy(valaxyApp, viteConfig);
+          await fixViteSsgHtml(options);
           await postProcessForSSG(options);
         } catch (e) {
           consola.error("[vite-ssg] An internal error occurred.");
@@ -6387,16 +6482,24 @@ async function startValaxyDev({
   log,
   open
 }) {
+  const totalTimer = countPerformanceTime();
   setEnv();
+  if (log === "debug")
+    setLogLevel(4);
   if (!await isPagesDirExist(root))
     process.exit(0);
   port = port || await findFreePort(4859);
+  const resolveTimer = countPerformanceTime();
   const resolvedOptions = await resolveOptions({ userRoot: root });
+  vLogger.debug(`resolveOptions: ${resolveTimer()}`);
   setTimezone(resolvedOptions.config.siteConfig.timezone);
+  const createNodeTimer = countPerformanceTime();
   const valaxyApp = createValaxyNode(resolvedOptions);
+  vLogger.debug(`createValaxyNode: ${createNodeTimer()}`);
   GLOBAL_STATE.valaxyApp = valaxyApp;
   const loaders = resolvedOptions.config.loaders;
   if (loaders?.length) {
+    const contentTimer = countPerformanceTime();
     const { loadAllContent } = await Promise.resolve().then(function () { return content; });
     const { resolve } = await import('pathe');
     const cacheDir = resolve(resolvedOptions.tempDir, "content");
@@ -6409,6 +6512,7 @@ async function startValaxyDev({
     await loadAllContent(loaders, ctx);
     await valaxyApp.hooks.callHook("content:loaded");
     await validateTaxonomyI18n(resolvedOptions);
+    vLogger.debug(`content loaders: ${contentTimer()}`);
     for (const loader of loaders) {
       if (loader.devPollInterval) {
         const poll = async () => {
@@ -6428,7 +6532,9 @@ async function startValaxyDev({
       }
     }
   } else {
+    const taxonomyTimer = countPerformanceTime();
     await validateTaxonomyI18n(resolvedOptions);
+    vLogger.debug(`validateTaxonomyI18n: ${taxonomyTimer()}`);
   }
   const viteConfig = mergeConfig({
     // initial vite config
@@ -6448,6 +6554,7 @@ async function startValaxyDev({
     logLevel: log
   }, resolvedOptions.config.vite || {});
   const server = await initServer(valaxyApp, viteConfig);
+  vLogger.info(`total startup: ${totalTimer()}`);
   printInfo(resolvedOptions, port, remote);
   return server;
 }
@@ -6471,7 +6578,7 @@ function registerDevCommand(cli) {
     }).option("log", {
       default: "info",
       type: "string",
-      choices: ["error", "warn", "info", "silent"],
+      choices: ["error", "warn", "info", "debug", "silent"],
       describe: "log level"
     }).strict().help(),
     async ({ root, port, open, remote, log }) => {
@@ -6607,4 +6714,4 @@ function run() {
   cli.parse();
 }
 
-export { transformObject as $, ALL_ROUTE as A, loadConfigFromFile as B, mergeValaxyConfig as C, mergeViteConfigs as D, EXCERPT_SEPARATOR as E, postProcessForSSG as F, GLOBAL_STATE as G, processValaxyOptions as H, registerDevCommand as I, resolveAddonsConfig as J, resolveImportPath as K, resolveImportUrl as L, resolveOptions as M, resolveSiteConfig as N, resolveSiteConfigFromRoot as O, PATHNAME_PROTOCOL_RE as P, resolveThemeConfigFromRoot as Q, resolveThemeValaxyConfig as R, resolveUserThemeConfig as S, resolveValaxyConfig as T, resolveValaxyConfigFromRoot as U, ViteValaxyPlugins as V, run as W, ssgBuild as X, ssgBuildLegacy as Y, startValaxyDev as Z, toAtFS as _, createServer as a, version as a0, build$1 as b, cli as c, createValaxyPlugin as d, customElements as e, defaultSiteConfig as f, defaultValaxyConfig as g, defaultViteConfig as h, defineAddon as i, defineConfig as j, defineSiteConfig as k, defineTheme as l, defineValaxyAddon as m, defineValaxyConfig as n, defineValaxyTheme as o, encryptContent as p, generateClientRedirects as q, getGitTimestamp as r, getIndexHtml as s, getServerInfoText as t, isExternal as u, isInstalledGlobally as v, isKatexEnabled as w, isKatexPluginNeeded as x, isMathJaxEnabled as y, isPath as z };
+export { toAtFS as $, ALL_ROUTE as A, isPath as B, loadConfigFromFile as C, mergeValaxyConfig as D, EXCERPT_SEPARATOR as E, mergeViteConfigs as F, GLOBAL_STATE as G, postProcessForSSG as H, processValaxyOptions as I, registerDevCommand as J, resolveAddonsConfig as K, resolveImportPath as L, resolveImportUrl as M, resolveOptions as N, resolveSiteConfig as O, PATHNAME_PROTOCOL_RE as P, resolveSiteConfigFromRoot as Q, resolveThemeConfigFromRoot as R, resolveThemeValaxyConfig as S, resolveUserThemeConfig as T, resolveValaxyConfig as U, ViteValaxyPlugins as V, resolveValaxyConfigFromRoot as W, run as X, ssgBuild as Y, ssgBuildLegacy as Z, startValaxyDev as _, createServer as a, transformObject as a0, version as a1, build$1 as b, cli as c, createValaxyPlugin as d, customElements as e, defaultSiteConfig as f, defaultValaxyConfig as g, defaultViteConfig as h, defineAddon as i, defineConfig as j, defineSiteConfig as k, defineTheme as l, defineValaxyAddon as m, defineValaxyConfig as n, defineValaxyTheme as o, encryptContent as p, fixViteSsgHtml as q, generateClientRedirects as r, getGitTimestamp as s, getIndexHtml as t, getServerInfoText as u, isExternal as v, isInstalledGlobally as w, isKatexEnabled as x, isKatexPluginNeeded as y, isMathJaxEnabled as z };

package/dist/types/index.d.mts

@@ -1,5 +1,5 @@
-import { c as Post } from '../shared/valaxy.6MW2qn5T.mjs';
-export { A as Album, B as BaseFrontMatter, D as DefaultTheme, E as ExcerptType, F as FuseListItem, d as Page, e as PageFrontMatter, P as PartialDeep, f as Photo, g as Pkg, h as PostFrontMatter, a as RedirectItem, i as RedirectRule, R as RuntimeConfig, S as SiteConfig, j as SocialLink, U as UserSiteConfig, k as UserValaxyConfig, b as ValaxyAddon, V as ValaxyConfig } from '../shared/valaxy.6MW2qn5T.mjs';
+import { c as Post } from '../shared/valaxy.D8f6owDk.mjs';
+export { A as Album, B as BaseFrontMatter, D as DefaultTheme, E as ExcerptType, F as FuseListItem, d as Page, e as PageFrontMatter, P as PartialDeep, f as Photo, g as Pkg, h as PostFrontMatter, a as RedirectItem, i as RedirectRule, R as RuntimeConfig, S as SiteConfig, j as SocialLink, U as UserSiteConfig, k as UserValaxyConfig, b as ValaxyAddon, V as ValaxyConfig } from '../shared/valaxy.D8f6owDk.mjs';
 import { Header } from '@valaxyjs/utils';
 import '@vueuse/integrations/useFuse';
 import 'medium-zoom';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "valaxy",
   "type": "module",
-  "version": "0.28.1",
+  "version": "0.28.3",
   "description": "📄 Vite & Vue powered static blog generator.",
   "author": {
     "email": "me@yunyoujun.cn",
@@ -95,7 +95,7 @@
     "jiti": "^2.6.1",
     "js-base64": "^3.7.8",
     "js-yaml": "^4.1.1",
-    "katex": "^0.16.42",
+    "katex": "^0.16.44",
     "lru-cache": "^11.2.7",
     "markdown-it": "^14.1.1",
     "markdown-it-anchor": "^9.2.0",
@@ -129,18 +129,18 @@
     "unplugin-vue-components": "28.0.0",
     "unplugin-vue-markdown": "^30.0.0",
     "vanilla-lazyload": "^19.1.3",
-    "vite": "^8.0.2",
+    "vite": "^8.0.3",
     "vite-plugin-vue-devtools": "^8.1.1",
     "vite-plugin-vue-layouts-next": "^2.1.0",
     "vite-ssg": "^28.3.0",
     "vite-ssg-sitemap": "^0.10.0",
-    "vitepress-plugin-group-icons": "^1.7.1",
+    "vitepress-plugin-group-icons": "^1.7.3",
     "vue": "3.5.22",
     "vue-i18n": "^11.3.0",
     "vue-router": "^5.0.4",
     "yargs": "^18.0.0",
-    "@valaxyjs/devtools": "0.28.1",
-    "@valaxyjs/utils": "0.28.1"
+    "@valaxyjs/utils": "0.28.3",
+    "@valaxyjs/devtools": "0.28.3"
   },
   "devDependencies": {
     "@mdit-vue/plugin-component": "^3.0.2",

package/types/config.ts

@@ -177,7 +177,7 @@ export interface SiteConfig {
      * - algolia: Algolia Search
      * - engine: Engine Search, like Google/Baidu
      * - fuse: Local Search by fuse.js
-     * - local(todo): Local Search by MiniSearch
+     * - local: Local Search by MiniSearch
      */
     provider: 'algolia' | 'engine' | 'fuse' | 'local'
   }
@@ -411,9 +411,14 @@ export interface SiteConfig {
     iv: Uint8Array
     salt: Uint8Array
     /**
-     * @description:zh-CN 全局加密密码 todo
+     * @description:en-US Global encryption password, read from env `VALAXY_ENCRYPT_PASSWORD`.
+     * When a post has `encrypt: true` in frontmatter but no `password`, this is used.
+     * Do NOT put passwords in config files — use `.env` or CI secrets.
+     * @description:zh-CN 全局加密密码，从环境变量 `VALAXY_ENCRYPT_PASSWORD` 读取。
+     * 当文章 frontmatter 设置了 `encrypt: true` 但未指定 `password` 时使用。
+     * 请勿在配置文件中设置密码——请使用 `.env` 文件或 CI secrets。
      */
-    // password: string
+    // password is read from process.env.VALAXY_ENCRYPT_PASSWORD at build time
   }
 
   /**