valaxy 0.26.13 → 0.28.0-beta.1

package/dist/shared/{valaxy.gqLhCu14.d.mts → valaxy.Dgja0_Y0.d.mts}

@@ -1,3 +1,4 @@
+import { Header } from '@valaxyjs/utils';
 import { FuseOptions } from '@vueuse/integrations/useFuse';
 import { ZoomOptions } from 'medium-zoom';
 import { ILazyLoadOptions } from 'vanilla-lazyload';
@@ -5,62 +6,6 @@ import { RouteRecordRaw } from 'vue-router';
 import { UseDarkOptions } from '@vueuse/core';
 import { NodeRelations, ImageObject } from '@unhead/schema-org';
 
-interface ValaxyAddon<AddonOptions = Record<string, any>> {
-    name: string;
-    /**
-     * be global component
-     */
-    global?: boolean;
-    props?: Record<string, any>;
-    options?: AddonOptions;
-}
-
-declare namespace DefaultTheme {
-    interface Config {
-        valaxyDarkOptions?: {
-            /**
-             * Options for `useDark`
-             * disableTransition default is `true`
-             * Its options are not computed, init when loaded.
-             * @see https://vueuse.org/core/useDark
-             * @url https://paco.me/writing/disable-theme-transitions
-             *
-             * @zh `useDark` 的选项
-             * disableTransition 默认为 `true`，不会进行渐变过渡，这是 VueUse 的默认行为
-             */
-            useDarkOptions?: UseDarkOptions;
-            /**
-             * Enable circle transition when toggling dark mode
-             * Then use `toggleDarkWithTransition` instead of `toggleDark`
-             * @zh 启用圆形过渡切换暗黑模式
-             */
-            circleTransition?: boolean;
-            /**
-             * Theme color
-             * @zh 主题色
-             */
-            themeColor?: {
-                /**
-                 * Theme color for light mode
-                 * @zh 亮色主题色
-                 */
-                light?: string;
-                /**
-                 * Theme color for dark mode
-                 * @zh 暗色主题色
-                 */
-                dark?: string;
-            };
-        };
-        /**
-         * Custom header levels of outline in the aside component.
-         *
-         * @default 2
-         */
-        outline?: number | [number, number] | 'deep' | false;
-    }
-}
-
 interface CollectionConfig {
     title?: string;
     key?: string;
@@ -242,7 +187,12 @@ interface PageFrontMatter extends BaseFrontMatter {
      */
     end: boolean;
     /**
-     * use katex
+     * Enable/disable KaTeX math rendering for this page.
+     * Overrides the global `features.katex` setting.
+     *
+     * - When `features.katex: true` (default), set `katex: false` to disable KaTeX for this page.
+     * - When `features.katex: false`, set `katex: true` to enable KaTeX for this page.
+     *
      * @url https://katex.org/
      */
     katex: boolean;
@@ -407,6 +357,92 @@ interface PostFrontMatter extends PageFrontMatter {
     wordCount: string;
 }
 
+type Page = Partial<PageFrontMatter>;
+type Post = Partial<PostFrontMatter>;
+
+/**
+ * Extend vue-router's RouteMeta interface
+ * @see https://router.vuejs.org/guide/advanced/meta.html#TypeScript
+ */
+
+
+declare module 'vue-router' {
+  interface RouteMeta {
+    /**
+     * Headers extracted from markdown
+     */
+    headers: Header[]
+    /**
+     * Frontmatter data from markdown files
+     */
+    frontmatter: Post
+    /**
+     * Excerpt from markdown content
+     */
+    excerpt?: string
+    /**
+     * Layout name
+     */
+    layout?: string
+  }
+}
+
+interface ValaxyAddon<AddonOptions = Record<string, any>> {
+    name: string;
+    /**
+     * be global component
+     */
+    global?: boolean;
+    props?: Record<string, any>;
+    options?: AddonOptions;
+}
+
+declare namespace DefaultTheme {
+    interface Config {
+        valaxyDarkOptions?: {
+            /**
+             * Options for `useDark`
+             * disableTransition default is `true`
+             * Its options are not computed, init when loaded.
+             * @see https://vueuse.org/core/useDark
+             * @url https://paco.me/writing/disable-theme-transitions
+             *
+             * @zh `useDark` 的选项
+             * disableTransition 默认为 `true`，不会进行渐变过渡，这是 VueUse 的默认行为
+             */
+            useDarkOptions?: UseDarkOptions;
+            /**
+             * Enable circle transition when toggling dark mode
+             * Then use `toggleDarkWithTransition` instead of `toggleDark`
+             * @zh 启用圆形过渡切换暗黑模式
+             */
+            circleTransition?: boolean;
+            /**
+             * Theme color
+             * @zh 主题色
+             */
+            themeColor?: {
+                /**
+                 * Theme color for light mode
+                 * @zh 亮色主题色
+                 */
+                light?: string;
+                /**
+                 * Theme color for dark mode
+                 * @zh 暗色主题色
+                 */
+                dark?: string;
+            };
+        };
+        /**
+         * Custom header levels of outline in the aside component.
+         *
+         * @default 2
+         */
+        outline?: number | [number, number] | 'deep' | false;
+    }
+}
+
 interface FuseListItem extends Record<string, any> {
     title: string | Record<string, string>;
     excerpt?: string;
@@ -618,6 +654,34 @@ interface SiteConfig {
             keys: FuseOptions<FuseListItem>['keys'];
         };
     };
+    /**
+     * Excerpt configuration
+     * @description:en-US Global excerpt settings for posts
+     * @description:zh-CN 全局摘要配置
+     */
+    excerpt: {
+        /**
+         * @description:en-US Default excerpt render type for `<!-- more -->` and auto-generated excerpts.
+         * Can be overridden per-post via frontmatter `excerpt_type`.
+         * Does not apply when frontmatter `excerpt` is set manually (used as-is).
+         * @description:zh-CN `<!-- more -->` 及自动摘要的默认渲染类型，可通过 frontmatter `excerpt_type` 逐篇覆盖。
+         * 当 frontmatter 手动指定 `excerpt` 时不生效（直接使用原始字符串）。
+         * @default 'html'
+         */
+        type: ExcerptType;
+        /**
+         * @description:en-US Auto-generate excerpt from post content when no manual excerpt is provided
+         * @description:zh-CN 当没有手动指定摘要时，自动从文章内容截取摘要
+         * @default false
+         */
+        auto: boolean;
+        /**
+         * @description:en-US Maximum length of auto-generated excerpt (in characters)
+         * @description:zh-CN 自动摘要的最大长度（字符数）
+         * @default 200
+         */
+        length: number;
+    };
     /**
      * set post default frontmatter
      */
@@ -776,6 +840,49 @@ interface SiteConfig {
      * @description:zh-CN 限制代码块的高度，单位是 px
      */
     codeHeightLimit?: number;
+    /**
+     * @zh llms.txt 及原始 Markdown 文件输出
+     * @en llms.txt and raw Markdown file output
+     * @see https://llmstxt.org/
+     */
+    llms: {
+        /**
+         * @zh 是否开启 llms.txt 和 .md 原始文件输出
+         * @en Enable llms.txt and raw .md file output
+         * @default false
+         */
+        enable: boolean;
+        /**
+         * @zh 是否生成 llms-full.txt（包含所有文章完整内容）
+         * @en Whether to generate llms-full.txt (with all post content inlined)
+         * @default true
+         */
+        fullText: boolean;
+        /**
+         * @zh 是否为每篇文章生成独立的 .md 文件（可通过 /posts/xxx.md 访问）
+         * @en Whether to generate individual .md files for each post (accessible via /posts/xxx.md)
+         * @default true
+         */
+        files: boolean;
+        /**
+         * @zh 自定义提示词（添加到 llms.txt blockquote 部分）
+         * @en Custom prompt text (added to the llms.txt blockquote section)
+         * @default ''
+         */
+        prompt: string;
+        /**
+         * @zh 要包含的 markdown 文件 glob 模式（相对于 pages/ 目录）。
+         * 默认为 `['posts\/**\/*.md']` 仅包含 posts。
+         * 设为 `['**\/*.md']` 可包含所有 pages 下的 markdown 文件。
+         * 也可以指定多个目录，如 `['posts\/**\/*.md', 'guide\/**\/*.md']`。
+         * @en Glob patterns for markdown files to include (relative to pages/ directory).
+         * Defaults to `['posts\/**\/*.md']` to only include posts.
+         * Set to `['**\/*.md']` to include all markdown files under pages/.
+         * You can also specify multiple directories, e.g. `['posts\/**\/*.md', 'guide\/**\/*.md']`.
+         * @default ['posts\/**\/*.md']
+         */
+        include?: string[];
+    };
     /**
      * @description:en-US client redirect rules
      * @description:zh-CN 客户端重定向规则
@@ -846,4 +953,4 @@ type UserSiteConfig = PartialDeep<SiteConfig>;
 type UserValaxyConfig<ThemeConfig = DefaultTheme.Config> = PartialDeep<ValaxyConfig<ThemeConfig>>;
 
 export { DefaultTheme as D };
-export type { Album as A, BaseFrontMatter as B, ExcerptType as E, FuseListItem as F, PartialDeep as P, RuntimeConfig as R, SiteConfig as S, UserSiteConfig as U, ValaxyConfig as V, RedirectItem as a, ValaxyAddon as b, PostFrontMatter as c, PageFrontMatter as d, SocialLink as e, RedirectRule as f, Pkg as g, UserValaxyConfig as h, Photo as i };
+export type { Album as A, BaseFrontMatter as B, ExcerptType as E, FuseListItem as F, PartialDeep as P, RuntimeConfig as R, SiteConfig as S, UserSiteConfig as U, ValaxyConfig as V, RedirectItem as a, ValaxyAddon as b, Post as c, Page as d, PageFrontMatter as e, Photo as f, Pkg as g, PostFrontMatter as h, RedirectRule as i, SocialLink as j, UserValaxyConfig as k };

package/dist/types/index.d.mts

@@ -1,5 +1,5 @@
-import { c as PostFrontMatter, d as PageFrontMatter } from '../shared/valaxy.gqLhCu14.mjs';
-export { A as Album, B as BaseFrontMatter, D as DefaultTheme, E as ExcerptType, F as FuseListItem, P as PartialDeep, i as Photo, g as Pkg, a as RedirectItem, f as RedirectRule, R as RuntimeConfig, S as SiteConfig, e as SocialLink, U as UserSiteConfig, h as UserValaxyConfig, b as ValaxyAddon, V as ValaxyConfig } from '../shared/valaxy.gqLhCu14.mjs';
+import { c as Post } from '../shared/valaxy.Dgja0_Y0.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.Dgja0_Y0.mjs';
 import { Header } from '@valaxyjs/utils';
 import '@vueuse/integrations/useFuse';
 import 'medium-zoom';
@@ -8,9 +8,6 @@ import 'vue-router';
 import '@vueuse/core';
 import '@unhead/schema-org';
 
-type Page = Partial<PageFrontMatter>;
-type Post = Partial<PostFrontMatter>;
-
 type CleanUrlsMode = 'disabled' | 'without-subfolders' | 'with-subfolders';
 interface PageData {
     relativePath: string;
@@ -32,5 +29,5 @@ interface PageDataPayload {
 }
 type HeadConfig = [string, Record<string, string>] | [string, Record<string, string>, string];
 
-export { PageFrontMatter, PostFrontMatter };
-export type { CleanUrlsMode, HeadConfig, Page, PageData, PageDataPayload, Post };
+export { Post };
+export type { CleanUrlsMode, HeadConfig, PageData, PageDataPayload };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "valaxy",
   "type": "module",
-  "version": "0.26.13",
+  "version": "0.28.0-beta.1",
   "description": "📄 Vite & Vue powered static blog generator.",
   "author": {
     "email": "me@yunyoujun.cn",
@@ -62,18 +62,18 @@
   "dependencies": {
     "@antfu/install-pkg": "^1.1.0",
     "@antfu/utils": "^9.3.0",
-    "@clack/prompts": "^0.11.0",
-    "@iconify-json/ri": "^1.2.7",
-    "@intlify/unplugin-vue-i18n": "^11.0.3",
-    "@shikijs/transformers": "^3.21.0",
+    "@clack/prompts": "^1.0.1",
+    "@iconify-json/ri": "^1.2.10",
+    "@intlify/unplugin-vue-i18n": "^11.0.7",
+    "@shikijs/transformers": "^3.22.0",
     "@types/katex": "^0.16.8",
-    "@unhead/addons": "^2.1.2",
-    "@unhead/schema-org": "^2.1.2",
-    "@unhead/vue": "^2.1.2",
-    "@vitejs/plugin-vue": "^6.0.3",
+    "@unhead/addons": "^2.1.6",
+    "@unhead/schema-org": "^2.1.6",
+    "@unhead/vue": "^2.1.6",
+    "@vitejs/plugin-vue": "^6.0.4",
     "@vue/devtools-api": "7.7.2",
-    "@vueuse/core": "^14.1.0",
-    "@vueuse/integrations": "^14.1.0",
+    "@vueuse/core": "^14.2.1",
+    "@vueuse/integrations": "^14.2.1",
     "beasties": "^0.4.1",
     "consola": "^3.4.2",
     "cross-spawn": "^7.0.6",
@@ -95,9 +95,9 @@
     "jiti": "^2.6.1",
     "js-base64": "^3.7.8",
     "js-yaml": "^4.1.1",
-    "katex": "^0.16.27",
-    "lru-cache": "^11.2.4",
-    "markdown-it": "^14.1.0",
+    "katex": "^0.16.33",
+    "lru-cache": "^11.2.6",
+    "markdown-it": "^14.1.1",
     "markdown-it-anchor": "^9.2.0",
     "markdown-it-async": "^2.2.0",
     "markdown-it-attrs": "^4.3.1",
@@ -108,39 +108,40 @@
     "markdown-it-table-of-contents": "^1.1.0",
     "markdown-it-task-lists": "^2.1.1",
     "medium-zoom": "^1.1.0",
-    "mermaid": "^11.12.2",
+    "mermaid": "^11.12.3",
+    "minisearch": "^7.2.0",
     "mlly": "^1.8.0",
     "nprogress": "^0.2.0",
     "open": "10.1.0",
-    "ora": "^9.1.0",
+    "ora": "^9.3.0",
+    "p-map": "^7.0.4",
     "pascalcase": "^2.0.0",
     "pathe": "^2.0.3",
     "pinia": "^3.0.4",
     "qrcode": "^1.5.4",
     "resolve-global": "^2.0.0",
     "sass": "^1.97.3",
-    "shiki": "^3.21.0",
+    "shiki": "^3.22.0",
     "star-markdown-css": "^0.5.3",
     "table": "^6.9.0",
-    "unhead": "^2.1.2",
+    "unhead": "^2.1.6",
     "unocss": "66.5.10",
     "unplugin-vue-components": "28.0.0",
     "unplugin-vue-markdown": "^29.2.0",
-    "unplugin-vue-router": "^0.19.2",
     "vanilla-lazyload": "^19.1.3",
     "vite": "^7.3.1",
     "vite-dev-rpc": "^1.1.0",
-    "vite-plugin-vue-devtools": "^8.0.5",
+    "vite-plugin-vue-devtools": "^8.0.6",
     "vite-plugin-vue-layouts": "^0.11.0",
-    "vite-ssg": "^28.2.2",
+    "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.2.8",
-    "vue-router": "^4.6.4",
+    "vue-router": "^5.0.3",
     "yargs": "^18.0.0",
-    "@valaxyjs/devtools": "0.26.13",
-    "@valaxyjs/utils": "0.26.13"
+    "@valaxyjs/utils": "0.28.0-beta.1",
+    "@valaxyjs/devtools": "0.28.0-beta.1"
   },
   "devDependencies": {
     "@mdit-vue/plugin-component": "^3.0.2",
@@ -161,12 +162,10 @@
     "@types/pascalcase": "^1.0.3",
     "@types/qrcode": "^1.5.6",
     "@types/yargs": "^17.0.35",
-    "cilicili": "^0.1.1",
-    "diacritics": "^1.3.0",
     "gh-pages": "^6.3.0",
     "https-localhost": "^4.7.1",
-    "p-map": "^7.0.4",
-    "rollup-plugin-visualizer": "^6.0.5",
+    "nanoid": "^5.1.6",
+    "rollup-plugin-visualizer": "^7.0.0",
     "unbuild": "^3.6.1"
   },
   "scripts": {

package/shared/node/i18n.ts

@@ -11,10 +11,23 @@ export const NODE_I18N: {
   locales: {},
 }
 
+/**
+ * Track which paths have already been loaded to avoid redundant I/O.
+ */
+const _loadedPaths = new Set<string>()
+
 /**
  * 读取翻译 yml 文件
+ *
+ * Results are cached by resolved path — subsequent calls with the same
+ * `localesPath` return the existing `NODE_I18N.locales` without re-reading
+ * the filesystem.  Pass `force = true` to bypass the cache (e.g. after
+ * the user edits a locale file).
  */
-export function loadLocalesYml(localesPath: string): Record<string, any> {
+export function loadLocalesYml(localesPath: string, force = false): Record<string, any> {
+  if (!force && _loadedPaths.has(localesPath))
+    return NODE_I18N.locales
+
   /**
    * read locales dir *.yml
    */
@@ -39,6 +52,7 @@ export function loadLocalesYml(localesPath: string): Record<string, any> {
 
   // cache
   NODE_I18N.locales = locales
+  _loadedPaths.add(localesPath)
   return locales
 }
 

package/types/config.ts

@@ -5,6 +5,7 @@ import type { RouteRecordRaw } from 'vue-router'
 import type { ValaxyAddon } from './addon'
 import type { DefaultTheme } from './default-theme'
 import type { PostFrontMatter } from './frontmatter'
+import type { ExcerptType } from './frontmatter/post'
 import type { FuseListItem } from './node'
 
 import './default-theme'
@@ -222,6 +223,35 @@ export interface SiteConfig {
     }
   }
 
+  /**
+   * Excerpt configuration
+   * @description:en-US Global excerpt settings for posts
+   * @description:zh-CN 全局摘要配置
+   */
+  excerpt: {
+    /**
+     * @description:en-US Default excerpt render type for `<!-- more -->` and auto-generated excerpts.
+     * Can be overridden per-post via frontmatter `excerpt_type`.
+     * Does not apply when frontmatter `excerpt` is set manually (used as-is).
+     * @description:zh-CN `<!-- more -->` 及自动摘要的默认渲染类型，可通过 frontmatter `excerpt_type` 逐篇覆盖。
+     * 当 frontmatter 手动指定 `excerpt` 时不生效（直接使用原始字符串）。
+     * @default 'html'
+     */
+    type: ExcerptType
+    /**
+     * @description:en-US Auto-generate excerpt from post content when no manual excerpt is provided
+     * @description:zh-CN 当没有手动指定摘要时，自动从文章内容截取摘要
+     * @default false
+     */
+    auto: boolean
+    /**
+     * @description:en-US Maximum length of auto-generated excerpt (in characters)
+     * @description:zh-CN 自动摘要的最大长度（字符数）
+     * @default 200
+     */
+    length: number
+  }
+
   /**
    * set post default frontmatter
    */
@@ -396,6 +426,50 @@ export interface SiteConfig {
    */
   codeHeightLimit?: number
 
+  /**
+   * @zh llms.txt 及原始 Markdown 文件输出
+   * @en llms.txt and raw Markdown file output
+   * @see https://llmstxt.org/
+   */
+  llms: {
+    /**
+     * @zh 是否开启 llms.txt 和 .md 原始文件输出
+     * @en Enable llms.txt and raw .md file output
+     * @default false
+     */
+    enable: boolean
+    /**
+     * @zh 是否生成 llms-full.txt（包含所有文章完整内容）
+     * @en Whether to generate llms-full.txt (with all post content inlined)
+     * @default true
+     */
+    fullText: boolean
+    /**
+     * @zh 是否为每篇文章生成独立的 .md 文件（可通过 /posts/xxx.md 访问）
+     * @en Whether to generate individual .md files for each post (accessible via /posts/xxx.md)
+     * @default true
+     */
+    files: boolean
+    /**
+     * @zh 自定义提示词（添加到 llms.txt blockquote 部分）
+     * @en Custom prompt text (added to the llms.txt blockquote section)
+     * @default ''
+     */
+    prompt: string
+    /**
+     * @zh 要包含的 markdown 文件 glob 模式（相对于 pages/ 目录）。
+     * 默认为 `['posts\/**\/*.md']` 仅包含 posts。
+     * 设为 `['**\/*.md']` 可包含所有 pages 下的 markdown 文件。
+     * 也可以指定多个目录，如 `['posts\/**\/*.md', 'guide\/**\/*.md']`。
+     * @en Glob patterns for markdown files to include (relative to pages/ directory).
+     * Defaults to `['posts\/**\/*.md']` to only include posts.
+     * Set to `['**\/*.md']` to include all markdown files under pages/.
+     * You can also specify multiple directories, e.g. `['posts\/**\/*.md', 'guide\/**\/*.md']`.
+     * @default ['posts\/**\/*.md']
+     */
+    include?: string[]
+  }
+
   /**
    * @description:en-US client redirect rules
    * @description:zh-CN 客户端重定向规则

package/types/frontmatter/page.ts

@@ -159,7 +159,12 @@ export interface PageFrontMatter extends BaseFrontMatter {
   end: boolean
 
   /**
-   * use katex
+   * Enable/disable KaTeX math rendering for this page.
+   * Overrides the global `features.katex` setting.
+   *
+   * - When `features.katex: true` (default), set `katex: false` to disable KaTeX for this page.
+   * - When `features.katex: false`, set `katex: true` to enable KaTeX for this page.
+   *
    * @url https://katex.org/
    */
   katex: boolean

package/types/index.ts

@@ -1,4 +1,7 @@
 // do not export node type here
+// vue-router RouteMeta augmentation
+import './vue-router.d'
+
 export * from './addon'
 export * from './config'
 export * from './data'

package/types/vue-router.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Extend vue-router's RouteMeta interface
+ * @see https://router.vuejs.org/guide/advanced/meta.html#TypeScript
+ */
+import type { Header } from '@valaxyjs/utils'
+import type { Post } from './posts'
+
+export {}
+
+declare module 'vue-router' {
+  interface RouteMeta {
+    /**
+     * Headers extracted from markdown
+     */
+    headers: Header[]
+    /**
+     * Frontmatter data from markdown files
+     */
+    frontmatter: Post
+    /**
+     * Excerpt from markdown content
+     */
+    excerpt?: string
+    /**
+     * Layout name
+     */
+    layout?: string
+  }
+}

package/client/templates/loader.vue

@@ -1,10 +0,0 @@
-<script>
-import { defineBasicLoader } from 'unplugin-vue-router/data-loaders/basic'
-
-export const usePageData = defineBasicLoader('/relativePath', async (_to) => {
-  // custom basic loader
-}, {
-  // @see https://uvr.esm.is/data-loaders/defining-loaders.html#non-blocking-loaders-with-lazy
-  lazy: (to, from) => to.name === from.name,
-})
-</script>