valaxy 0.27.0 → 0.28.0-beta.2

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

@@ -27,6 +27,18 @@ interface CollectionConfig {
     description?: string;
     categories?: string[];
     tags?: string[];
+    /**
+     * @en Whether to show collection as a single collapsed entry in homepage/archive lists.
+     * When true (default), a synthetic collection card is added to the post list,
+     * representing all articles in the collection as one entry.
+     * When false, no synthetic entry is added.
+     * @zh 是否在首页/归档列表中以单个条目展示合集。
+     * 为 true（默认）时，合集以一张卡片出现在文章列表中，
+     * 代表合集内的所有文章。
+     * 为 false 时，不添加合集条目。
+     * @default true
+     */
+    collapse?: boolean;
     /**
      * items
      */
@@ -38,6 +50,20 @@ interface CollectionConfig {
          * 对应路径为 `/collections/${key}/${item.key}`
          */
         key?: string;
+        /**
+         * @en
+         * Link to an existing page or external URL.
+         * Internal links (starting with `/`) use `<RouterLink>`.
+         * External links (e.g. `https://...`) open in a new tab.
+         * Mutually exclusive with `key` — if both are set, `link` takes precedence.
+         *
+         * @zh
+         * 链接到已有页面或外部 URL。
+         * 内部链接（以 `/` 开头）使用 `<RouterLink>`。
+         * 外部链接（如 `https://...`）在新标签页中打开。
+         * 与 `key` 互斥——若同时设置，`link` 优先。
+         */
+        link?: string;
     }[];
 }
 
@@ -187,7 +213,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;
@@ -353,7 +384,14 @@ interface PostFrontMatter extends PageFrontMatter {
 }
 
 type Page = Partial<PageFrontMatter>;
-type Post = Partial<PostFrontMatter>;
+type Post = Partial<PostFrontMatter> & {
+    /**
+     * Runtime-only field set by `mergeCollapsedCollections`.
+     * Present when this post entry represents a collapsed collection.
+     * @internal
+     */
+    _collection?: CollectionConfig;
+};
 
 /**
  * Extend vue-router's RouteMeta interface
@@ -649,6 +687,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
      */
@@ -807,6 +873,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 客户端重定向规则

package/dist/types/index.d.mts

@@ -1,5 +1,5 @@
-import { c as Post } from '../shared/valaxy._i636HSR.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._i636HSR.mjs';
+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 { Header } from '@valaxyjs/utils';
 import '@vueuse/integrations/useFuse';
 import 'medium-zoom';

package/index.d.ts

@@ -1,6 +1,7 @@
 // re-export @vueuse/shared types. with strict installers like pnpm, user won't
 // be able to reference @vueuse/shared in project root.
 /// <reference types="@vueuse/shared" />
+/// <reference types="vite/client" />
 
 export * from './client/index'
 export * from './dist/node/index.mjs'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "valaxy",
   "type": "module",
-  "version": "0.27.0",
+  "version": "0.28.0-beta.2",
   "description": "📄 Vite & Vue powered static blog generator.",
   "author": {
     "email": "me@yunyoujun.cn",
@@ -62,32 +62,32 @@
   "dependencies": {
     "@antfu/install-pkg": "^1.1.0",
     "@antfu/utils": "^9.3.0",
-    "@clack/prompts": "^1.0.0",
-    "@iconify-json/ri": "^1.2.9",
-    "@intlify/unplugin-vue-i18n": "^11.0.3",
-    "@shikijs/transformers": "^3.22.0",
+    "@clack/prompts": "^1.1.0",
+    "@iconify-json/ri": "^1.2.10",
+    "@intlify/unplugin-vue-i18n": "^11.0.7",
+    "@shikijs/transformers": "^3.23.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.4",
+    "@unhead/addons": "^2.1.12",
+    "@unhead/schema-org": "^2.1.12",
+    "@unhead/vue": "^2.1.12",
+    "@vitejs/plugin-vue": "^6.0.5",
     "@vue/devtools-api": "7.7.2",
-    "@vueuse/core": "^14.2.0",
-    "@vueuse/integrations": "^14.2.0",
+    "@vueuse/core": "^14.2.1",
+    "@vueuse/integrations": "^14.2.1",
     "beasties": "^0.4.1",
     "consola": "^3.4.2",
     "cross-spawn": "^7.0.6",
     "css-i18n": "^0.0.5",
-    "dayjs": "^1.11.19",
+    "dayjs": "^1.11.20",
     "debug": "^4.4.3",
     "define-config-ts": "^0.1.3",
     "defu": "^6.1.4",
-    "ejs": "^4.0.1",
+    "ejs": "^5.0.1",
     "escape-html": "^1.0.3",
     "fast-glob": "^3.3.3",
     "feed": "^5.2.0",
     "floating-vue": "^5.2.2",
-    "fs-extra": "^11.3.3",
+    "fs-extra": "^11.3.4",
     "fuse.js": "^7.1.0",
     "gray-matter": "^4.0.3",
     "hookable": "^6.0.1",
@@ -95,9 +95,9 @@
     "jiti": "^2.6.1",
     "js-base64": "^3.7.8",
     "js-yaml": "^4.1.1",
-    "katex": "^0.16.28",
-    "lru-cache": "^11.2.5",
-    "markdown-it": "^14.1.0",
+    "katex": "^0.16.38",
+    "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,38 +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",
-    "mlly": "^1.8.0",
+    "mermaid": "^11.13.0",
+    "minisearch": "^7.2.0",
+    "mlly": "^1.8.1",
     "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.22.0",
+    "sass": "^1.98.0",
+    "shiki": "^3.23.0",
     "star-markdown-css": "^0.5.3",
     "table": "^6.9.0",
-    "unhead": "^2.1.2",
+    "unhead": "^2.1.12",
     "unocss": "66.5.10",
     "unplugin-vue-components": "28.0.0",
-    "unplugin-vue-markdown": "^29.2.0",
+    "unplugin-vue-markdown": "^30.0.0",
     "vanilla-lazyload": "^19.1.3",
-    "vite": "^7.3.1",
+    "vite": "^8.0.0",
     "vite-dev-rpc": "^1.1.0",
-    "vite-plugin-vue-devtools": "^8.0.5",
-    "vite-plugin-vue-layouts": "^0.11.0",
-    "vite-ssg": "^28.2.2",
+    "vite-plugin-vue-devtools": "^8.1.0",
+    "vite-plugin-vue-layouts-next": "^2.0.1",
+    "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": "^5.0.2",
+    "vue-i18n": "^11.3.0",
+    "vue-router": "^5.0.3",
     "yargs": "^18.0.0",
-    "@valaxyjs/utils": "0.27.0",
-    "@valaxyjs/devtools": "0.27.0"
+    "@valaxyjs/devtools": "0.28.0-beta.2",
+    "@valaxyjs/utils": "0.28.0-beta.2"
   },
   "devDependencies": {
     "@mdit-vue/plugin-component": "^3.0.2",
@@ -160,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.1",
     "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/posts.ts

@@ -1,4 +1,12 @@
+import type { CollectionConfig } from '../client/types'
 import type { PageFrontMatter, PostFrontMatter } from './frontmatter'
 
 export type Page = Partial<PageFrontMatter>
-export type Post = Partial<PostFrontMatter>
+export type Post = Partial<PostFrontMatter> & {
+  /**
+   * Runtime-only field set by `mergeCollapsedCollections`.
+   * Present when this post entry represents a collapsed collection.
+   * @internal
+   */
+  _collection?: CollectionConfig
+}