valaxy 0.28.0-beta.6 → 0.28.0

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 { D as DefaultTheme, R as RuntimeConfig, a as RedirectItem, V as ValaxyConfig, P as PartialDeep, b as ValaxyAddon, S as SiteConfig, U as UserSiteConfig } from '../shared/valaxy.JIuR8V4d.mjs';
+import { D as DefaultTheme, R as RuntimeConfig, a as RedirectItem, V as ValaxyConfig, P as PartialDeep, b as ValaxyAddon, S as SiteConfig, U as UserSiteConfig } from '../shared/valaxy.6MW2qn5T.mjs';
 import Vue from '@vitejs/plugin-vue';
 import { Hookable } from 'hookable';
 import { PluginVisualizerOptions } from 'rollup-plugin-visualizer';
@@ -694,6 +694,30 @@ interface ValaxyExtendConfig {
              */
             maxDuration?: number;
         };
+        /**
+         * @en Taxonomy i18n validation during `valaxy dev` / `valaxy build`.
+         * Checks whether translated `tag.*` / `category.*` keys are consistently
+         * defined across configured languages.
+         *
+         * @zh `valaxy dev` / `valaxy build` 期间的 taxonomy i18n 校验。
+         * 用于检查 `tag.*` / `category.*` 翻译 key 是否在已配置语言中保持一致。
+         */
+        taxonomyI18n?: {
+            /**
+             * @en Validation level for taxonomy i18n checks.
+             * - `'off'`: disable checks
+             * - `'warn'`: print warnings and continue
+             * - `'error'`: fail validation after reporting all issues
+             *
+             * @zh taxonomy i18n 校验级别。
+             * - `'off'`：关闭检查
+             * - `'warn'`：输出 warning 并继续流程
+             * - `'error'`：输出所有问题后以错误结束
+             *
+             * @default 'warn'
+             */
+            level?: 'off' | 'warn' | 'error';
+        };
     };
     /**
      * @experimental
@@ -744,6 +768,12 @@ interface ValaxyExtendConfig {
          * @default true
          */
         katex: boolean;
+        /**
+         * @description:en-US Auto-extract the first image from markdown content for Open Graph fallback
+         * @description:zh-CN 自动从 Markdown 内容中提取第一张图片，作为 Open Graph 的回退图片
+         * @default true
+         */
+        extractFirstImage: boolean;
     };
     /**
      * Enable MathJax3 math rendering (aligned with VitePress `markdown.math`).

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-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.BVsZMcdc.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 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.DQ6HsU2J.mjs';
 import 'node:path';
 import 'fs-extra';
 import 'consola/utils';

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

@@ -167,6 +167,18 @@ interface PageFrontMatter extends BaseFrontMatter {
      * @description 封面图片
      */
     cover: string;
+    /**
+     * @description:en-US Open Graph image for SEO
+     * @description:zh-CN Open Graph 图片，用于 SEO
+     */
+    ogImage: string;
+    /**
+     * @protected
+     * @tutorial ⚠️ DO NOT SET MANUALLY (auto-extracted from markdown content)
+     * @description:en-US First image URL extracted from markdown content
+     * @description:zh-CN 从 Markdown 内容中自动提取的第一张图片 URL
+     */
+    firstImage: string;
     /**
      * display toc
      * @description 是否显示目录
@@ -638,10 +650,6 @@ interface SiteConfig {
          * @zh 是否启用
          */
         enable: boolean;
-        /**
-         * @deprecated will be deprecated, use search.provider instead
-         */
-        type?: SiteConfig['search']['provider'];
         /**
          * Search Type
          * - algolia: Algolia Search

package/dist/shared/{valaxy.BVsZMcdc.mjs → valaxy.DQ6HsU2J.mjs}

@@ -28,7 +28,7 @@ import { Feed } from 'feed';
 import MarkdownIt from 'markdown-it';
 import { table, getBorderCharacters } from 'table';
 import { createHooks } from 'hookable';
-import { execFileSync, exec } from 'node:child_process';
+import { execFileSync, execSync, exec } from 'node:child_process';
 import v8 from 'node:v8';
 import generateSitemap from 'vite-ssg-sitemap';
 import { createMarkdownItAsync, MarkdownItAsync } from 'markdown-it-async';
@@ -854,6 +854,9 @@ const defaultValaxyConfig = {
     foucGuard: {
       enabled: true,
       maxDuration: 5e3
+    },
+    taxonomyI18n: {
+      level: "warn"
     }
   },
   deploy: {},
@@ -875,7 +878,8 @@ const defaultValaxyConfig = {
     }
   },
   features: {
-    katex: true
+    katex: true,
+    extractFirstImage: true
   },
   math: false,
   cdn: {
@@ -928,8 +932,9 @@ async function resolveValaxyConfigFromRoot(root, options) {
 }
 const mergeValaxyConfig = createDefu((obj, key, value) => {
   if (isFunction(obj[key]) && isFunction(value)) {
+    const original = obj[key];
     obj[key] = function(...args) {
-      obj[key].call(this, ...args);
+      original.call(this, ...args);
       value.call(this, ...args);
     };
     return true;
@@ -985,6 +990,30 @@ function tObject(data, lang) {
   }
   return data;
 }
+function isLocaleKey(value) {
+  return value.startsWith(LOCALE_PREFIX);
+}
+function stripLocalePrefix(value) {
+  return isLocaleKey(value) ? value.slice(LOCALE_PREFIX.length) : value;
+}
+function getLocaleMessageValue(messages, key) {
+  return key.split(".").reduce((result, part) => result?.[part], messages);
+}
+function hasLocaleMessage(messages, key) {
+  return getLocaleMessageValue(messages, key) !== void 0;
+}
+function resolveTaxonomyLocaleKey(namespace, rawValue) {
+  if (isLocaleKey(rawValue)) {
+    return {
+      localeKey: stripLocalePrefix(rawValue),
+      isExplicitLocaleKey: true
+    };
+  }
+  return {
+    localeKey: `${namespace}.${rawValue}`,
+    isExplicitLocaleKey: false
+  };
+}
 
 const indexRE = /(^|.*\/)index.md(.*)$/i;
 function linkPlugin(md, externalAttrs, base) {
@@ -1692,7 +1721,7 @@ async function setupMarkdownPlugins(md, options, base = "/") {
   return md;
 }
 
-const version = "0.28.0-beta.6";
+const version = "0.28.0";
 
 const GLOBAL_STATE = {
   valaxyApp: void 0,
@@ -2482,9 +2511,8 @@ function loadLocalesYml(localesPath, force = false) {
   return locales;
 }
 function nodeT(key, lang) {
-  if (key.startsWith(LOCALE_PREFIX)) {
-    key = key.slice(LOCALE_PREFIX.length);
-  }
+  if (isLocaleKey(key))
+    key = stripLocalePrefix(key);
   const data = NODE_I18N.locales[lang] || {};
   const keys = key.split(".");
   let result = data;
@@ -2529,7 +2557,7 @@ function getSiteUrl(options) {
 }
 
 function resolveText(value, lang) {
-  if (typeof value === "string" && value.startsWith(LOCALE_PREFIX))
+  if (typeof value === "string" && isLocaleKey(value))
     return nodeT(value, lang);
   return tObject(value, lang);
 }
@@ -3368,10 +3396,24 @@ function inferDescription(frontmatter) {
     return description;
   return head && getHeadMetaContent(head, "description") || "";
 }
+function extractFirstImage(code) {
+  const mdImageMatch = code.match(/!\[.*?\]\((.+?)\)/);
+  if (mdImageMatch)
+    return mdImageMatch[1];
+  const htmlImageMatch = code.match(/<img\s[^>]*?src=["'](.+?)["']/);
+  if (htmlImageMatch)
+    return htmlImageMatch[1];
+  return void 0;
+}
 async function generatePageData(code, id, options) {
   const fileInfo = Valaxy.state.idMap.get(id);
   const relativePath = path.relative(options.userRoot, id);
   const fm = JSON.parse(JSON.stringify(fileInfo?.frontmatter));
+  if (options.config.features?.extractFirstImage !== false && !fm.ogImage && !fm.cover) {
+    const firstImage = extractFirstImage(code);
+    if (firstImage)
+      fm.firstImage = firstImage;
+  }
   const pageData = {
     title: fm.title || fileInfo?.title || "",
     titleTemplate: fm.titleTemplate,
@@ -3382,7 +3424,8 @@ async function generatePageData(code, id, options) {
     relativePath,
     filePath: id
   };
-  pageData.lastUpdated = await getGitTimestamp(id);
+  if (options.config.siteConfig.lastUpdated)
+    pageData.lastUpdated = await getGitTimestamp(id);
   return pageData;
 }
 
@@ -5375,17 +5418,21 @@ async function getPosts(params, options) {
     return { data, content, excerpt, path: i };
   });
   const rawPosts = await Promise.all(readFilePromises);
+  const draftPosts = [];
   const filteredPosts = rawPosts.filter((p) => {
     const { data } = p;
     if (data.password)
       return false;
     if (data.draft) {
+      draftPosts.push(p.path);
       return false;
     }
     if (data.hide)
       return false;
     return true;
   });
+  if (draftPosts.length)
+    consola.log(`[rss] Skipped ${draftPosts.length} draft post(s): ${draftPosts.join(", ")}`);
   const posts = [];
   for (const rawPost of filteredPosts) {
     const { data, path, content, excerpt } = rawPost;
@@ -5650,6 +5697,162 @@ const content = {
   loadAllContent: loadAllContent
 };
 
+function getConfiguredLanguages(options) {
+  const configured = options.config.siteConfig.languages?.length ? options.config.siteConfig.languages : [options.config.siteConfig.lang || "en"];
+  return [...new Set(configured.filter(Boolean))];
+}
+function normalizeToStringArray(value) {
+  if (typeof value === "string")
+    return value.trim() ? [value] : [];
+  if (Array.isArray(value)) {
+    return value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
+  }
+  return [];
+}
+async function collectPageFiles(options) {
+  const userPages = await scanPageFiles(options.userRoot, ["**/*.md"]);
+  const userPageFiles = userPages.map((file) => resolve(options.userRoot, "pages", file));
+  const contentDir = resolve(options.tempDir, "content", "pages");
+  if (!await fs.pathExists(contentDir))
+    return userPageFiles;
+  const contentPages = await fg(["**/*.md"], {
+    cwd: contentDir,
+    ignore: ["**/node_modules"]
+  });
+  return [.../* @__PURE__ */ new Set([
+    ...userPageFiles,
+    ...contentPages.map((file) => resolve(contentDir, file))
+  ])];
+}
+async function loadMergedLocaleMessages(options) {
+  const languages = getConfiguredLanguages(options);
+  const messages = Object.fromEntries(languages.map((lang) => [lang, {}]));
+  for (const root of options.roots) {
+    for (const lang of languages) {
+      const localeFiles = [
+        resolve(root, "locales", `${lang}.yml`),
+        resolve(root, "locales", `${lang}.yaml`)
+      ];
+      for (const localeFile of localeFiles) {
+        if (!await fs.pathExists(localeFile))
+          continue;
+        const content = await fs.readFile(localeFile, "utf-8");
+        if (!content.trim())
+          continue;
+        const data = yaml.load(content);
+        messages[lang] = replaceArrMerge(data || {}, messages[lang]);
+      }
+    }
+  }
+  return messages;
+}
+async function collectTaxonomyUsages(options) {
+  const files = await collectPageFiles(options);
+  const posts = await readPostFiles(files);
+  const usageMap = /* @__PURE__ */ new Map();
+  const addUsage = (namespace, rawValue, file) => {
+    const key = `${namespace}:${rawValue}`;
+    if (!usageMap.has(key)) {
+      usageMap.set(key, {
+        namespace,
+        rawValue,
+        files: /* @__PURE__ */ new Set()
+      });
+    }
+    usageMap.get(key).files.add(file);
+  };
+  for (const post of posts) {
+    const file = relative(options.userRoot, post.filePath);
+    for (const tag of normalizeToStringArray(post.data.tags))
+      addUsage("tag", tag, file);
+    for (const category of normalizeToStringArray(post.data.categories))
+      addUsage("category", category, file);
+  }
+  return Array.from(usageMap.values(), (item) => ({
+    namespace: item.namespace,
+    rawValue: item.rawValue,
+    files: [...item.files].sort()
+  })).sort((a, b) => `${a.namespace}:${a.rawValue}`.localeCompare(`${b.namespace}:${b.rawValue}`));
+}
+function findTaxonomyI18nIssues(usages, messages, languages) {
+  const issues = [];
+  for (const usage of usages) {
+    const { namespace, rawValue, files } = usage;
+    const { localeKey, isExplicitLocaleKey } = resolveTaxonomyLocaleKey(namespace, rawValue);
+    const presentLanguages = languages.filter((lang) => hasLocaleMessage(messages[lang], localeKey));
+    const missingLanguages = languages.filter((lang) => !hasLocaleMessage(messages[lang], localeKey));
+    if (isExplicitLocaleKey) {
+      if (missingLanguages.length) {
+        issues.push({
+          type: "explicit-locale-key-missing",
+          namespace,
+          rawValue,
+          localeKey,
+          presentLanguages,
+          missingLanguages,
+          files
+        });
+      }
+      continue;
+    }
+    if (presentLanguages.length === 0 || presentLanguages.length === languages.length)
+      continue;
+    issues.push({
+      type: "partial-locale-coverage",
+      namespace,
+      rawValue,
+      localeKey,
+      presentLanguages,
+      missingLanguages,
+      files
+    });
+  }
+  return issues;
+}
+function formatFiles(files) {
+  const preview = files.slice(0, 3).map((file) => colors.dim(file)).join(", ");
+  if (files.length <= 3)
+    return preview;
+  return `${preview}${colors.dim(` and ${files.length - 3} more`)}`;
+}
+function logTaxonomyI18nIssues(issues, level) {
+  if (!issues.length)
+    return;
+  const log = level === "error" ? consola.error : consola.warn;
+  const count = level === "error" ? colors.red(String(issues.length)) : colors.yellow(String(issues.length));
+  log(`Detected ${count} taxonomy i18n issue(s).`);
+  for (const issue of issues) {
+    const where = formatFiles(issue.files);
+    if (issue.type === "explicit-locale-key-missing") {
+      log(
+        `[taxonomy-i18n] ${colors.cyan(issue.rawValue)} is an explicit locale key but ${colors.red(`missing in: ${issue.missingLanguages.join(", ")}`)}. Files: ${where}`
+      );
+      continue;
+    }
+    log(
+      `[taxonomy-i18n] ${colors.cyan(issue.rawValue)} resolves to ${colors.cyan(issue.localeKey)} in ${colors.green(issue.presentLanguages.join(", "))}, but is ${colors.red(`missing in: ${issue.missingLanguages.join(", ")}`)}. Files: ${where}`
+    );
+  }
+}
+function resolveTaxonomyI18nValidationLevel(options) {
+  return options.config.build.taxonomyI18n?.level || "warn";
+}
+async function validateTaxonomyI18n(options) {
+  const level = resolveTaxonomyI18nValidationLevel(options);
+  if (level === "off")
+    return [];
+  const languages = getConfiguredLanguages(options);
+  const [messages, usages] = await Promise.all([
+    loadMergedLocaleMessages(options),
+    collectTaxonomyUsages(options)
+  ]);
+  const issues = findTaxonomyI18nIssues(usages, messages, languages);
+  logTaxonomyI18nIssues(issues, level);
+  if (level === "error" && issues.length)
+    throw new Error(`Taxonomy i18n validation failed with ${issues.length} issue(s).`);
+  return issues;
+}
+
 function getServerInfoText(msg) {
   return `${valaxyPrefix} ${colors.gray(msg)}`;
 }
@@ -5790,6 +5993,7 @@ async function execBuild({ ssg, ssgEngine, root, output, log }) {
   );
   await callHookWithLog("config:init", valaxyApp);
   await callHookWithLog("build:before", valaxyApp);
+  await validateTaxonomyI18n(options);
   consola.box("\u{1F320} Start building...");
   try {
     if (ssg) {
@@ -5897,14 +6101,108 @@ function registerCleanCommand(cli) {
   );
 }
 
-function registerDebugCommand(cli) {
-  cli.command("debug", "Debug your blog", async () => {
-    console.log();
-    consola.log("  Operating System:", colors.green(os.platform()));
-    consola.log("  Node.JS Version:", colors.green(process.version));
-    consola.log("  Valaxy Version:", colors.cyan(`v${version}`));
+function getPnpmVersion() {
+  try {
+    return execSync("pnpm --version", { encoding: "utf-8" }).trim();
+  } catch {
+    return "not found";
+  }
+}
+async function collectDebugInfo() {
+  const info = {
+    os: os.platform(),
+    arch: os.arch(),
+    node: process.version,
+    pnpm: getPnpmVersion(),
+    valaxy: version
+  };
+  try {
+    const options = await resolveOptions({ userRoot: process.cwd() });
+    info.userRoot = options.userRoot;
+    info.theme = options.theme;
+    info.themeVersion = options.config.themeConfig?.pkg?.version;
+    info.addons = options.addons.filter((a) => a.enable).map((a) => ({
+      name: a.name,
+      version: a.pkg?.version || "unknown",
+      global: a.global
+    }));
+    info.pages = options.pages.length;
+  } catch {
+  }
+  return info;
+}
+function printFancy(info) {
+  const lines = [];
+  lines.push(`${colors.bold(colors.cyan("Environment"))}`);
+  lines.push(`  OS:              ${colors.green(`${info.os} ${info.arch}`)}`);
+  lines.push(`  Node.js:         ${colors.green(info.node)}`);
+  lines.push(`  Package Manager: ${colors.green(`pnpm ${info.pnpm}`)}`);
+  lines.push(`  Valaxy:          ${colors.cyan(`v${info.valaxy}`)}`);
+  if (info.theme) {
+    lines.push("");
+    lines.push(`${colors.bold(colors.cyan("Project"))}`);
+    lines.push(`  Root:   ${colors.dim(info.userRoot)}`);
+    lines.push(`  Theme:  ${colors.green(info.theme)} ${colors.blue(`v${info.themeVersion || "unknown"}`)}`);
+    if (info.addons && info.addons.length > 0) {
+      lines.push(`  Addons:`);
+      info.addons.forEach((addon, i) => {
+        const prefix = i === info.addons.length - 1 ? "\u2514\u2500" : "\u251C\u2500";
+        const globalTag = addon.global ? colors.cyan(" (global)") : "";
+        lines.push(`    ${prefix} ${colors.yellow(addon.name)} ${colors.blue(`v${addon.version}`)}${globalTag}`);
+      });
+    } else {
+      lines.push(`  Addons:  ${colors.dim("none")}`);
+    }
+    lines.push(`  Pages:  ${colors.green(String(info.pages))}`);
+  }
+  consola.box({
+    title: "\u{1F30C} Valaxy Debug Info",
+    message: lines.join("\n"),
+    style: {
+      borderColor: "cyan"
+    }
   });
 }
+function printPlain(info) {
+  const lines = [];
+  lines.push("## Environment");
+  lines.push(`- OS: ${info.os} ${info.arch}`);
+  lines.push(`- Node: ${info.node}`);
+  lines.push(`- Package Manager: pnpm ${info.pnpm}`);
+  lines.push(`- Valaxy: v${info.valaxy}`);
+  if (info.theme) {
+    lines.push("");
+    lines.push("## Project");
+    lines.push(`- Root: ${info.userRoot}`);
+    lines.push(`- Theme: ${info.theme} (v${info.themeVersion || "unknown"})`);
+    if (info.addons && info.addons.length > 0) {
+      const addonStr = info.addons.map((a) => `${a.name} (v${a.version})${a.global ? " [global]" : ""}`).join(", ");
+      lines.push(`- Addons: ${addonStr}`);
+    } else {
+      lines.push("- Addons: none");
+    }
+    lines.push(`- Pages: ${info.pages}`);
+  }
+  console.log(lines.join("\n"));
+}
+function registerDebugCommand(cli) {
+  cli.command(
+    "debug",
+    "Display debug information for your Valaxy project",
+    (args) => args.option("plain", {
+      type: "boolean",
+      default: false,
+      describe: "Output plain text without colors (for pasting into issues)"
+    }),
+    async (args) => {
+      const info = await collectDebugInfo();
+      if (args.plain)
+        printPlain(info);
+      else
+        printFancy(info);
+    }
+  );
+}
 
 function registerDeployCommand(cli) {
   cli.command("deploy", "deploy your blog to the cloud", async () => {
@@ -6075,6 +6373,7 @@ async function startValaxyDev({
     await valaxyApp.hooks.callHook("content:before-load");
     await loadAllContent(loaders, ctx);
     await valaxyApp.hooks.callHook("content:loaded");
+    await validateTaxonomyI18n(resolvedOptions);
     for (const loader of loaders) {
       if (loader.devPollInterval) {
         const poll = async () => {
@@ -6082,6 +6381,7 @@ async function startValaxyDev({
             await valaxyApp.hooks.callHook("content:before-load");
             await loadAllContent([loader], ctx);
             await valaxyApp.hooks.callHook("content:loaded");
+            await validateTaxonomyI18n(resolvedOptions);
           } catch (error) {
             consola.error("[content-loader] Error while polling:", error);
           } finally {
@@ -6092,6 +6392,8 @@ async function startValaxyDev({
         setTimeout(poll, loader.devPollInterval);
       }
     }
+  } else {
+    await validateTaxonomyI18n(resolvedOptions);
   }
   const viteConfig = mergeConfig({
     // initial vite config

package/dist/types/index.d.mts

@@ -1,5 +1,5 @@
-import { c as Post } from '../shared/valaxy.JIuR8V4d.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.JIuR8V4d.mjs';
+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 { 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.0-beta.6",
+  "version": "0.28.0",
   "description": "📄 Vite & Vue powered static blog generator.",
   "author": {
     "email": "me@yunyoujun.cn",
@@ -57,7 +57,7 @@
     "types"
   ],
   "engines": {
-    "node": "^14.18.0 || >=16.0.0"
+    "node": "^18.0.0 || >=20.0.0"
   },
   "dependencies": {
     "@antfu/install-pkg": "^1.1.0",
@@ -95,7 +95,7 @@
     "jiti": "^2.6.1",
     "js-base64": "^3.7.8",
     "js-yaml": "^4.1.1",
-    "katex": "^0.16.38",
+    "katex": "^0.16.42",
     "lru-cache": "^11.2.7",
     "markdown-it": "^14.1.1",
     "markdown-it-anchor": "^9.2.0",
@@ -105,12 +105,12 @@
     "markdown-it-emoji": "^3.0.0",
     "markdown-it-footnote": "^4.0.0",
     "markdown-it-image-figures": "^2.1.1",
-    "markdown-it-table-of-contents": "^1.1.0",
+    "markdown-it-table-of-contents": "^1.2.0",
     "markdown-it-task-lists": "^2.1.1",
     "medium-zoom": "^1.1.0",
     "mermaid": "^11.13.0",
     "minisearch": "^7.2.0",
-    "mlly": "^1.8.1",
+    "mlly": "^1.8.2",
     "nprogress": "^0.2.0",
     "open": "10.1.0",
     "ora": "^9.3.0",
@@ -129,19 +129,18 @@
     "unplugin-vue-components": "28.0.0",
     "unplugin-vue-markdown": "^30.0.0",
     "vanilla-lazyload": "^19.1.3",
-    "vite": "^8.0.0",
-    "vite-dev-rpc": "^1.1.0",
-    "vite-plugin-vue-devtools": "^8.1.0",
-    "vite-plugin-vue-layouts-next": "^2.0.1",
+    "vite": "^8.0.2",
+    "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",
     "vue": "3.5.22",
     "vue-i18n": "^11.3.0",
-    "vue-router": "^5.0.3",
+    "vue-router": "^5.0.4",
     "yargs": "^18.0.0",
-    "@valaxyjs/devtools": "0.28.0-beta.6",
-    "@valaxyjs/utils": "0.28.0-beta.6"
+    "@valaxyjs/devtools": "0.28.0",
+    "@valaxyjs/utils": "0.28.0"
   },
   "devDependencies": {
     "@mdit-vue/plugin-component": "^3.0.2",

package/shared/node/i18n.ts

@@ -1,6 +1,6 @@
 import fs from 'fs-extra'
 import yaml from 'js-yaml'
-import { LOCALE_PREFIX } from '../constants'
+import { isLocaleKey, stripLocalePrefix } from '../utils/i18n'
 
 export const NODE_I18N: {
   locales: Record<string, any>
@@ -64,9 +64,9 @@ export function loadLocalesYml(localesPath: string, force = false): Record<strin
  * ```
  */
 export function nodeT(key: string, lang: string): string {
-  if (key.startsWith(LOCALE_PREFIX)) {
-    key = key.slice(LOCALE_PREFIX.length)
-  }
+  if (isLocaleKey(key))
+    key = stripLocalePrefix(key)
+
   const data = NODE_I18N.locales[lang] || {}
   const keys = key.split('.')
   let result: any = data