valaxy 0.20.0 → 0.20.2

package/dist/node/cli/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkJ3KURXZZcjs = require('../../chunk-J3KURXZZ.cjs');require('../../chunk-D6FLLKWU.cjs');exports.cli = _chunkJ3KURXZZcjs.U; exports.run = _chunkJ3KURXZZcjs.V;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkLFH2U2WQcjs = require('../../chunk-LFH2U2WQ.cjs');require('../../chunk-7EKNBB3E.cjs');exports.cli = _chunkLFH2U2WQcjs.V; exports.run = _chunkLFH2U2WQcjs.W;

package/dist/node/cli/index.mjs

@@ -1,2 +1,2 @@
 import {createRequire as __createRequire} from 'module';var require=__createRequire(import.meta.url);
-import{U as a,V as b}from"../../chunk-WLSTHI6Y.mjs";import"../../chunk-KCYZWGKZ.mjs";export{a as cli,b as run};
+import{V as a,W as b}from"../../chunk-N5526RM3.mjs";import"../../chunk-AUDFAOQV.mjs";export{a as cli,b as run};

package/dist/node/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkJ3KURXZZcjs = require('../chunk-J3KURXZZ.cjs');require('../chunk-D6FLLKWU.cjs');exports.ALL_ROUTE = _chunkJ3KURXZZcjs.e; exports.EXCERPT_SEPARATOR = _chunkJ3KURXZZcjs.b; exports.EXTERNAL_URL_RE = _chunkJ3KURXZZcjs.c; exports.PATHNAME_PROTOCOL_RE = _chunkJ3KURXZZcjs.d; exports.ViteValaxyPlugins = _chunkJ3KURXZZcjs.O; exports.build = _chunkJ3KURXZZcjs.P; exports.cli = _chunkJ3KURXZZcjs.U; exports.createServer = _chunkJ3KURXZZcjs.T; exports.createValaxyLoader = _chunkJ3KURXZZcjs.N; exports.customElements = _chunkJ3KURXZZcjs.f; exports.defaultSiteConfig = _chunkJ3KURXZZcjs.q; exports.defaultValaxyConfig = _chunkJ3KURXZZcjs.u; exports.defaultViteConfig = _chunkJ3KURXZZcjs.g; exports.defineAddon = _chunkJ3KURXZZcjs.B; exports.defineConfig = _chunkJ3KURXZZcjs.w; exports.defineSiteConfig = _chunkJ3KURXZZcjs.r; exports.defineTheme = _chunkJ3KURXZZcjs.G; exports.defineUnoSetup = _chunkJ3KURXZZcjs.H; exports.defineValaxyAddon = _chunkJ3KURXZZcjs.A; exports.defineValaxyConfig = _chunkJ3KURXZZcjs.v; exports.defineValaxyTheme = _chunkJ3KURXZZcjs.F; exports.ensurePrefix = _chunkJ3KURXZZcjs.k; exports.generateClientRedirects = _chunkJ3KURXZZcjs.S; exports.getGitTimestamp = _chunkJ3KURXZZcjs.a; exports.getIndexHtml = _chunkJ3KURXZZcjs.M; exports.isExternal = _chunkJ3KURXZZcjs.i; exports.isPath = _chunkJ3KURXZZcjs.m; exports.loadConfig = _chunkJ3KURXZZcjs.o; exports.loadConfigFromFile = _chunkJ3KURXZZcjs.p; exports.mergeValaxyConfig = _chunkJ3KURXZZcjs.y; exports.mergeViteConfigs = _chunkJ3KURXZZcjs.L; exports.postProcessForSSG = _chunkJ3KURXZZcjs.R; exports.processValaxyOptions = _chunkJ3KURXZZcjs.I; exports.resolveAddonsConfig = _chunkJ3KURXZZcjs.C; exports.resolveImportPath = _chunkJ3KURXZZcjs.h; exports.resolveOptions = _chunkJ3KURXZZcjs.J; exports.resolveSiteConfig = _chunkJ3KURXZZcjs.t; exports.resolveSiteConfigFromRoot = _chunkJ3KURXZZcjs.s; exports.resolveThemeConfigFromRoot = _chunkJ3KURXZZcjs.D; exports.resolveThemeValaxyConfig = _chunkJ3KURXZZcjs.K; exports.resolveUserThemeConfig = _chunkJ3KURXZZcjs.E; exports.resolveValaxyConfig = _chunkJ3KURXZZcjs.z; exports.resolveValaxyConfigFromRoot = _chunkJ3KURXZZcjs.x; exports.run = _chunkJ3KURXZZcjs.V; exports.slash = _chunkJ3KURXZZcjs.j; exports.ssgBuild = _chunkJ3KURXZZcjs.Q; exports.toAtFS = _chunkJ3KURXZZcjs.l; exports.transformObject = _chunkJ3KURXZZcjs.n;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkLFH2U2WQcjs = require('../chunk-LFH2U2WQ.cjs');require('../chunk-7EKNBB3E.cjs');exports.ALL_ROUTE = _chunkLFH2U2WQcjs.e; exports.EXCERPT_SEPARATOR = _chunkLFH2U2WQcjs.b; exports.EXTERNAL_URL_RE = _chunkLFH2U2WQcjs.c; exports.PATHNAME_PROTOCOL_RE = _chunkLFH2U2WQcjs.d; exports.ViteValaxyPlugins = _chunkLFH2U2WQcjs.P; exports.build = _chunkLFH2U2WQcjs.Q; exports.cli = _chunkLFH2U2WQcjs.V; exports.createServer = _chunkLFH2U2WQcjs.U; exports.createValaxyLoader = _chunkLFH2U2WQcjs.O; exports.customElements = _chunkLFH2U2WQcjs.f; exports.defaultSiteConfig = _chunkLFH2U2WQcjs.r; exports.defaultValaxyConfig = _chunkLFH2U2WQcjs.v; exports.defaultViteConfig = _chunkLFH2U2WQcjs.g; exports.defineAddon = _chunkLFH2U2WQcjs.C; exports.defineConfig = _chunkLFH2U2WQcjs.x; exports.defineSiteConfig = _chunkLFH2U2WQcjs.s; exports.defineTheme = _chunkLFH2U2WQcjs.H; exports.defineUnoSetup = _chunkLFH2U2WQcjs.I; exports.defineValaxyAddon = _chunkLFH2U2WQcjs.B; exports.defineValaxyConfig = _chunkLFH2U2WQcjs.w; exports.defineValaxyTheme = _chunkLFH2U2WQcjs.G; exports.ensurePrefix = _chunkLFH2U2WQcjs.l; exports.generateClientRedirects = _chunkLFH2U2WQcjs.T; exports.getGitTimestamp = _chunkLFH2U2WQcjs.a; exports.getIndexHtml = _chunkLFH2U2WQcjs.N; exports.isExternal = _chunkLFH2U2WQcjs.j; exports.isInstalledGlobally = _chunkLFH2U2WQcjs.h; exports.isPath = _chunkLFH2U2WQcjs.n; exports.loadConfig = _chunkLFH2U2WQcjs.p; exports.loadConfigFromFile = _chunkLFH2U2WQcjs.q; exports.mergeValaxyConfig = _chunkLFH2U2WQcjs.z; exports.mergeViteConfigs = _chunkLFH2U2WQcjs.M; exports.postProcessForSSG = _chunkLFH2U2WQcjs.S; exports.processValaxyOptions = _chunkLFH2U2WQcjs.J; exports.resolveAddonsConfig = _chunkLFH2U2WQcjs.D; exports.resolveImportPath = _chunkLFH2U2WQcjs.i; exports.resolveOptions = _chunkLFH2U2WQcjs.K; exports.resolveSiteConfig = _chunkLFH2U2WQcjs.u; exports.resolveSiteConfigFromRoot = _chunkLFH2U2WQcjs.t; exports.resolveThemeConfigFromRoot = _chunkLFH2U2WQcjs.E; exports.resolveThemeValaxyConfig = _chunkLFH2U2WQcjs.L; exports.resolveUserThemeConfig = _chunkLFH2U2WQcjs.F; exports.resolveValaxyConfig = _chunkLFH2U2WQcjs.A; exports.resolveValaxyConfigFromRoot = _chunkLFH2U2WQcjs.y; exports.run = _chunkLFH2U2WQcjs.W; exports.slash = _chunkLFH2U2WQcjs.k; exports.ssgBuild = _chunkLFH2U2WQcjs.R; exports.toAtFS = _chunkLFH2U2WQcjs.m; exports.transformObject = _chunkLFH2U2WQcjs.o;

package/dist/node/index.d.cts

@@ -24,7 +24,7 @@ import { SfcPluginOptions } from '@mdit-vue/plugin-sfc';
 import { TocPluginOptions } from '@mdit-vue/plugin-toc';
 import { Awaitable } from '@antfu/utils';
 import * as defu from 'defu';
-import { P as PartialDeep$1 } from '../config-DRImYfNf.cjs';
+import { P as PartialDeep$1 } from '../config-BXn7sQx8.cjs';
 import 'yargs';
 import 'medium-zoom';
 import '@vueuse/integrations/useFuse';
@@ -98,13 +98,14 @@ interface MarkdownOptions {
      *
      * You can also pass an object with `light` and `dark` themes to support dual themes.
      *
-     * @example { theme: 'github-dark' }
-     * @example { theme: { light: 'github-light', dark: 'github-dark' } }
+     * @see You can use an existing theme. https://shiki.style/themes
+     * @see Or add your own theme. https://shiki.style/guide/load-theme
      *
-     * You can use an existing theme.
-     * @see https://shiki.style/themes
-     * Or add your own theme.
-     * @see https://shiki.style/guide/load-theme
+     * @example { theme: 'github-dark' }
+     * @example light and dark themes
+     * ```js
+     * { theme: { light: 'github-light', dark: 'github-dark' } }
+     * ```
      */
     theme?: ThemeOptions;
     /**
@@ -209,18 +210,21 @@ interface ValaxyExtendConfig {
      * @deprecated use `build.ignoreDeadLinks` instead
      */
     ignoreDeadLinks?: boolean | 'localhostLinks' | (string | RegExp | ((link: string) => boolean))[];
+    /**
+     * options for `valaxy build`
+     */
     build: {
         /**
          * Don't fail builds due to dead links.
-         *
+         * @zh 忽略死链
          * @default false
          */
         ignoreDeadLinks?: boolean | 'localhostLinks' | (string | RegExp | ((link: string) => boolean))[];
         /**
          * Enable SSG for pagination
+         * @en When enabled, it will generate pagination pages for you. `/page/1`, `/page/2`, ...
+         * @zh 启用 SSG 分页，将单独构建分页页面 `/page/1`, `/page/2`, ...
          * @default false
-         * When enabled, it will generate pagination pages for you.
-         * `/page/1`, `/page/2`, ...
          */
         ssgForPagination: boolean;
     };
@@ -258,9 +262,15 @@ interface ValaxyExtendConfig {
     features: {
         /**
          * enable katex for global
+         * @see [Example | Valaxy](https://valaxy.site/examples/katex)
+         * @see https://katex.org/
          */
         katex: boolean;
     };
+    /**
+     * vite.config.ts options
+     * @see https://vite.dev/
+     */
     vite?: UserConfig;
     /**
      * @vitejs/plugin-vue options
@@ -269,9 +279,21 @@ interface ValaxyExtendConfig {
     vue?: Parameters<typeof Vue>[0] & {
         isCustomElement?: ((tag: string) => boolean)[];
     };
+    /**
+     * @see https://github.com/unplugin/unplugin-vue-components
+     */
     components?: Parameters<typeof Components>[0];
+    /**
+     * @see https://github.com/JohnCampionJr/vite-plugin-vue-layouts
+     */
     layouts?: Parameters<typeof Layouts>[0];
+    /**
+     * @see https://github.com/posva/unplugin-vue-router
+     */
     router?: Parameters<typeof Router>[0];
+    /**
+     * @see https://unocss.dev/config/
+     */
     unocss?: VitePluginConfig;
     /**
      * rollup-plugin-visualizer
@@ -280,6 +302,7 @@ interface ValaxyExtendConfig {
     visualizer?: PluginVisualizerOptions;
     /**
      * unocss presets
+     * @see https://unocss.dev/guide/presets
      */
     unocssPresets?: {
         uno?: Parameters<typeof presetUno>[0];
@@ -294,9 +317,15 @@ interface ValaxyExtendConfig {
      */
     devtools?: boolean;
     /**
-     * for markdown
+     * @en config for markdown (include markdown-it plugins)
+     * @zh markdown 相关配置
+     * {@link MarkdownOptions}
      */
     markdown?: MarkdownOptions & Parameters<typeof Markdown>[0];
+    /**
+     * @en Extend markdown, you can modify the markdown content/excerpt
+     * @zh 扩展 markdown
+     */
     extendMd?: (ctx: {
         route: EditableTreeNode;
         data: Readonly<Record<string, any>>;
@@ -304,7 +333,30 @@ interface ValaxyExtendConfig {
         excerpt?: string;
         path: string;
     }) => void;
+    /**
+     * @en Addons system
+     * @zh 插件系统
+     * @see 为什么需要插件？ [Why Addon? | Valaxy](https://valaxy.site/addons/why)
+     * @see 插件橱窗 [Addons Gallery | Valaxy](https://valaxy.site/addons/gallery)
+     * @example
+     * ```ts
+     * import { defineValaxyConfig } from 'valaxy'
+     * import { addonTest } from 'valaxy-addon-test'
+     *
+     * export default defineValaxyConfig({
+     *   addons: [
+     *     // we always recommend to use function, so that you can pass options
+     *     addonTest(),
+     *   ]
+     * })
+     * ```
+     */
     addons?: ValaxyAddons;
+    /**
+     * @en Hooks system, you can customize each stage of the lifecycle.
+     * @zh 钩子系统，你可以对生命周期的各个阶段进行定制。
+     * @see https://valaxy.site/guide/custom/hooks
+     */
     hooks?: Partial<ValaxyHooks>;
 }
 type ValaxyAddonLike = ValaxyAddon | false | null | undefined;
@@ -555,7 +607,15 @@ declare function createServer(valaxyApp: ValaxyNode, viteConfig?: InlineConfig,
 
 declare function getGitTimestamp(file: string, type?: 'created' | 'updated'): Promise<number>;
 
-declare function resolveImportPath(importName: string, ensure?: true): string;
+declare const isInstalledGlobally: {
+    value?: boolean;
+};
+/**
+ * Before is CJS: use 'resolve'
+ * ESM: use 'mlly'
+ */
+declare function resolveImportPath(importName: string, ensure?: true): Promise<string>;
+declare function resolveImportPath(importName: string, ensure?: boolean): Promise<string | undefined>;
 
 /**
  * is url external (http/https:)
@@ -576,4 +636,4 @@ declare function isPath(name: string): boolean;
  */
 declare function transformObject(obj: any): string;
 
-export { ALL_ROUTE, EXCERPT_SEPARATOR, EXTERNAL_URL_RE, type HookResult, type LoadConfigFromFileOptions, PATHNAME_PROTOCOL_RE, type ResolvedConfig, type ResolvedValaxyOptions, type UnoSetup, type UserInputConfig, type UserValaxyNodeConfig, type ValaxyAddonExport, type ValaxyAddonFn, type ValaxyAddonLike, type ValaxyAddonResolver, type ValaxyAddons, type ValaxyConfigExport, type ValaxyConfigExtendKey, type ValaxyConfigFn, type ValaxyEntryOptions, type ValaxyExtendConfig, type ValaxyHooks, type ValaxyNode, type ValaxyNodeConfig, type ValaxyPickConfig, type ValaxyServerOptions, type ValaxyTheme, ViteValaxyPlugins, build, createServer, createValaxyLoader, customElements, defaultSiteConfig, defaultValaxyConfig, defaultViteConfig, defineAddon, defineConfig, defineSiteConfig, defineTheme, defineUnoSetup, defineValaxyAddon, defineValaxyConfig, defineValaxyTheme, ensurePrefix, generateClientRedirects, getGitTimestamp, getIndexHtml, isExternal, isPath, loadConfig, loadConfigFromFile, mergeValaxyConfig, mergeViteConfigs, postProcessForSSG, processValaxyOptions, resolveAddonsConfig, resolveImportPath, resolveOptions, resolveSiteConfig, resolveSiteConfigFromRoot, resolveThemeConfigFromRoot, resolveThemeValaxyConfig, resolveUserThemeConfig, resolveValaxyConfig, resolveValaxyConfigFromRoot, slash, ssgBuild, toAtFS, transformObject };
+export { ALL_ROUTE, EXCERPT_SEPARATOR, EXTERNAL_URL_RE, type HookResult, type LoadConfigFromFileOptions, PATHNAME_PROTOCOL_RE, type ResolvedConfig, type ResolvedValaxyOptions, type UnoSetup, type UserInputConfig, type UserValaxyNodeConfig, type ValaxyAddonExport, type ValaxyAddonFn, type ValaxyAddonLike, type ValaxyAddonResolver, type ValaxyAddons, type ValaxyConfigExport, type ValaxyConfigExtendKey, type ValaxyConfigFn, type ValaxyEntryOptions, type ValaxyExtendConfig, type ValaxyHooks, type ValaxyNode, type ValaxyNodeConfig, type ValaxyPickConfig, type ValaxyServerOptions, type ValaxyTheme, ViteValaxyPlugins, build, createServer, createValaxyLoader, customElements, defaultSiteConfig, defaultValaxyConfig, defaultViteConfig, defineAddon, defineConfig, defineSiteConfig, defineTheme, defineUnoSetup, defineValaxyAddon, defineValaxyConfig, defineValaxyTheme, ensurePrefix, generateClientRedirects, getGitTimestamp, getIndexHtml, isExternal, isInstalledGlobally, isPath, loadConfig, loadConfigFromFile, mergeValaxyConfig, mergeViteConfigs, postProcessForSSG, processValaxyOptions, resolveAddonsConfig, resolveImportPath, resolveOptions, resolveSiteConfig, resolveSiteConfigFromRoot, resolveThemeConfigFromRoot, resolveThemeValaxyConfig, resolveUserThemeConfig, resolveValaxyConfig, resolveValaxyConfigFromRoot, slash, ssgBuild, toAtFS, transformObject };

package/dist/node/index.d.ts

@@ -24,7 +24,7 @@ import { SfcPluginOptions } from '@mdit-vue/plugin-sfc';
 import { TocPluginOptions } from '@mdit-vue/plugin-toc';
 import { Awaitable } from '@antfu/utils';
 import * as defu from 'defu';
-import { P as PartialDeep$1 } from '../config-DRImYfNf.js';
+import { P as PartialDeep$1 } from '../config-BXn7sQx8.js';
 import 'yargs';
 import 'medium-zoom';
 import '@vueuse/integrations/useFuse';
@@ -98,13 +98,14 @@ interface MarkdownOptions {
      *
      * You can also pass an object with `light` and `dark` themes to support dual themes.
      *
-     * @example { theme: 'github-dark' }
-     * @example { theme: { light: 'github-light', dark: 'github-dark' } }
+     * @see You can use an existing theme. https://shiki.style/themes
+     * @see Or add your own theme. https://shiki.style/guide/load-theme
      *
-     * You can use an existing theme.
-     * @see https://shiki.style/themes
-     * Or add your own theme.
-     * @see https://shiki.style/guide/load-theme
+     * @example { theme: 'github-dark' }
+     * @example light and dark themes
+     * ```js
+     * { theme: { light: 'github-light', dark: 'github-dark' } }
+     * ```
      */
     theme?: ThemeOptions;
     /**
@@ -209,18 +210,21 @@ interface ValaxyExtendConfig {
      * @deprecated use `build.ignoreDeadLinks` instead
      */
     ignoreDeadLinks?: boolean | 'localhostLinks' | (string | RegExp | ((link: string) => boolean))[];
+    /**
+     * options for `valaxy build`
+     */
     build: {
         /**
          * Don't fail builds due to dead links.
-         *
+         * @zh 忽略死链
          * @default false
          */
         ignoreDeadLinks?: boolean | 'localhostLinks' | (string | RegExp | ((link: string) => boolean))[];
         /**
          * Enable SSG for pagination
+         * @en When enabled, it will generate pagination pages for you. `/page/1`, `/page/2`, ...
+         * @zh 启用 SSG 分页，将单独构建分页页面 `/page/1`, `/page/2`, ...
          * @default false
-         * When enabled, it will generate pagination pages for you.
-         * `/page/1`, `/page/2`, ...
          */
         ssgForPagination: boolean;
     };
@@ -258,9 +262,15 @@ interface ValaxyExtendConfig {
     features: {
         /**
          * enable katex for global
+         * @see [Example | Valaxy](https://valaxy.site/examples/katex)
+         * @see https://katex.org/
          */
         katex: boolean;
     };
+    /**
+     * vite.config.ts options
+     * @see https://vite.dev/
+     */
     vite?: UserConfig;
     /**
      * @vitejs/plugin-vue options
@@ -269,9 +279,21 @@ interface ValaxyExtendConfig {
     vue?: Parameters<typeof Vue>[0] & {
         isCustomElement?: ((tag: string) => boolean)[];
     };
+    /**
+     * @see https://github.com/unplugin/unplugin-vue-components
+     */
     components?: Parameters<typeof Components>[0];
+    /**
+     * @see https://github.com/JohnCampionJr/vite-plugin-vue-layouts
+     */
     layouts?: Parameters<typeof Layouts>[0];
+    /**
+     * @see https://github.com/posva/unplugin-vue-router
+     */
     router?: Parameters<typeof Router>[0];
+    /**
+     * @see https://unocss.dev/config/
+     */
     unocss?: VitePluginConfig;
     /**
      * rollup-plugin-visualizer
@@ -280,6 +302,7 @@ interface ValaxyExtendConfig {
     visualizer?: PluginVisualizerOptions;
     /**
      * unocss presets
+     * @see https://unocss.dev/guide/presets
      */
     unocssPresets?: {
         uno?: Parameters<typeof presetUno>[0];
@@ -294,9 +317,15 @@ interface ValaxyExtendConfig {
      */
     devtools?: boolean;
     /**
-     * for markdown
+     * @en config for markdown (include markdown-it plugins)
+     * @zh markdown 相关配置
+     * {@link MarkdownOptions}
      */
     markdown?: MarkdownOptions & Parameters<typeof Markdown>[0];
+    /**
+     * @en Extend markdown, you can modify the markdown content/excerpt
+     * @zh 扩展 markdown
+     */
     extendMd?: (ctx: {
         route: EditableTreeNode;
         data: Readonly<Record<string, any>>;
@@ -304,7 +333,30 @@ interface ValaxyExtendConfig {
         excerpt?: string;
         path: string;
     }) => void;
+    /**
+     * @en Addons system
+     * @zh 插件系统
+     * @see 为什么需要插件？ [Why Addon? | Valaxy](https://valaxy.site/addons/why)
+     * @see 插件橱窗 [Addons Gallery | Valaxy](https://valaxy.site/addons/gallery)
+     * @example
+     * ```ts
+     * import { defineValaxyConfig } from 'valaxy'
+     * import { addonTest } from 'valaxy-addon-test'
+     *
+     * export default defineValaxyConfig({
+     *   addons: [
+     *     // we always recommend to use function, so that you can pass options
+     *     addonTest(),
+     *   ]
+     * })
+     * ```
+     */
     addons?: ValaxyAddons;
+    /**
+     * @en Hooks system, you can customize each stage of the lifecycle.
+     * @zh 钩子系统，你可以对生命周期的各个阶段进行定制。
+     * @see https://valaxy.site/guide/custom/hooks
+     */
     hooks?: Partial<ValaxyHooks>;
 }
 type ValaxyAddonLike = ValaxyAddon | false | null | undefined;
@@ -555,7 +607,15 @@ declare function createServer(valaxyApp: ValaxyNode, viteConfig?: InlineConfig,
 
 declare function getGitTimestamp(file: string, type?: 'created' | 'updated'): Promise<number>;
 
-declare function resolveImportPath(importName: string, ensure?: true): string;
+declare const isInstalledGlobally: {
+    value?: boolean;
+};
+/**
+ * Before is CJS: use 'resolve'
+ * ESM: use 'mlly'
+ */
+declare function resolveImportPath(importName: string, ensure?: true): Promise<string>;
+declare function resolveImportPath(importName: string, ensure?: boolean): Promise<string | undefined>;
 
 /**
  * is url external (http/https:)
@@ -576,4 +636,4 @@ declare function isPath(name: string): boolean;
  */
 declare function transformObject(obj: any): string;
 
-export { ALL_ROUTE, EXCERPT_SEPARATOR, EXTERNAL_URL_RE, type HookResult, type LoadConfigFromFileOptions, PATHNAME_PROTOCOL_RE, type ResolvedConfig, type ResolvedValaxyOptions, type UnoSetup, type UserInputConfig, type UserValaxyNodeConfig, type ValaxyAddonExport, type ValaxyAddonFn, type ValaxyAddonLike, type ValaxyAddonResolver, type ValaxyAddons, type ValaxyConfigExport, type ValaxyConfigExtendKey, type ValaxyConfigFn, type ValaxyEntryOptions, type ValaxyExtendConfig, type ValaxyHooks, type ValaxyNode, type ValaxyNodeConfig, type ValaxyPickConfig, type ValaxyServerOptions, type ValaxyTheme, ViteValaxyPlugins, build, createServer, createValaxyLoader, customElements, defaultSiteConfig, defaultValaxyConfig, defaultViteConfig, defineAddon, defineConfig, defineSiteConfig, defineTheme, defineUnoSetup, defineValaxyAddon, defineValaxyConfig, defineValaxyTheme, ensurePrefix, generateClientRedirects, getGitTimestamp, getIndexHtml, isExternal, isPath, loadConfig, loadConfigFromFile, mergeValaxyConfig, mergeViteConfigs, postProcessForSSG, processValaxyOptions, resolveAddonsConfig, resolveImportPath, resolveOptions, resolveSiteConfig, resolveSiteConfigFromRoot, resolveThemeConfigFromRoot, resolveThemeValaxyConfig, resolveUserThemeConfig, resolveValaxyConfig, resolveValaxyConfigFromRoot, slash, ssgBuild, toAtFS, transformObject };
+export { ALL_ROUTE, EXCERPT_SEPARATOR, EXTERNAL_URL_RE, type HookResult, type LoadConfigFromFileOptions, PATHNAME_PROTOCOL_RE, type ResolvedConfig, type ResolvedValaxyOptions, type UnoSetup, type UserInputConfig, type UserValaxyNodeConfig, type ValaxyAddonExport, type ValaxyAddonFn, type ValaxyAddonLike, type ValaxyAddonResolver, type ValaxyAddons, type ValaxyConfigExport, type ValaxyConfigExtendKey, type ValaxyConfigFn, type ValaxyEntryOptions, type ValaxyExtendConfig, type ValaxyHooks, type ValaxyNode, type ValaxyNodeConfig, type ValaxyPickConfig, type ValaxyServerOptions, type ValaxyTheme, ViteValaxyPlugins, build, createServer, createValaxyLoader, customElements, defaultSiteConfig, defaultValaxyConfig, defaultViteConfig, defineAddon, defineConfig, defineSiteConfig, defineTheme, defineUnoSetup, defineValaxyAddon, defineValaxyConfig, defineValaxyTheme, ensurePrefix, generateClientRedirects, getGitTimestamp, getIndexHtml, isExternal, isInstalledGlobally, isPath, loadConfig, loadConfigFromFile, mergeValaxyConfig, mergeViteConfigs, postProcessForSSG, processValaxyOptions, resolveAddonsConfig, resolveImportPath, resolveOptions, resolveSiteConfig, resolveSiteConfigFromRoot, resolveThemeConfigFromRoot, resolveThemeValaxyConfig, resolveUserThemeConfig, resolveValaxyConfig, resolveValaxyConfigFromRoot, slash, ssgBuild, toAtFS, transformObject };

package/dist/node/index.mjs

@@ -1,2 +1,2 @@
 import {createRequire as __createRequire} from 'module';var require=__createRequire(import.meta.url);
-import{A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"../chunk-WLSTHI6Y.mjs";import"../chunk-KCYZWGKZ.mjs";export{e as ALL_ROUTE,b as EXCERPT_SEPARATOR,c as EXTERNAL_URL_RE,d as PATHNAME_PROTOCOL_RE,O as ViteValaxyPlugins,P as build,U as cli,T as createServer,N as createValaxyLoader,f as customElements,q as defaultSiteConfig,u as defaultValaxyConfig,g as defaultViteConfig,B as defineAddon,w as defineConfig,r as defineSiteConfig,G as defineTheme,H as defineUnoSetup,A as defineValaxyAddon,v as defineValaxyConfig,F as defineValaxyTheme,k as ensurePrefix,S as generateClientRedirects,a as getGitTimestamp,M as getIndexHtml,i as isExternal,m as isPath,o as loadConfig,p as loadConfigFromFile,y as mergeValaxyConfig,L as mergeViteConfigs,R as postProcessForSSG,I as processValaxyOptions,C as resolveAddonsConfig,h as resolveImportPath,J as resolveOptions,t as resolveSiteConfig,s as resolveSiteConfigFromRoot,D as resolveThemeConfigFromRoot,K as resolveThemeValaxyConfig,E as resolveUserThemeConfig,z as resolveValaxyConfig,x as resolveValaxyConfigFromRoot,V as run,j as slash,Q as ssgBuild,l as toAtFS,n as transformObject};
+import{A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"../chunk-N5526RM3.mjs";import"../chunk-AUDFAOQV.mjs";export{e as ALL_ROUTE,b as EXCERPT_SEPARATOR,c as EXTERNAL_URL_RE,d as PATHNAME_PROTOCOL_RE,P as ViteValaxyPlugins,Q as build,V as cli,U as createServer,O as createValaxyLoader,f as customElements,r as defaultSiteConfig,v as defaultValaxyConfig,g as defaultViteConfig,C as defineAddon,x as defineConfig,s as defineSiteConfig,H as defineTheme,I as defineUnoSetup,B as defineValaxyAddon,w as defineValaxyConfig,G as defineValaxyTheme,l as ensurePrefix,T as generateClientRedirects,a as getGitTimestamp,N as getIndexHtml,j as isExternal,h as isInstalledGlobally,n as isPath,p as loadConfig,q as loadConfigFromFile,z as mergeValaxyConfig,M as mergeViteConfigs,S as postProcessForSSG,J as processValaxyOptions,D as resolveAddonsConfig,i as resolveImportPath,K as resolveOptions,u as resolveSiteConfig,t as resolveSiteConfigFromRoot,E as resolveThemeConfigFromRoot,L as resolveThemeValaxyConfig,F as resolveUserThemeConfig,A as resolveValaxyConfig,y as resolveValaxyConfigFromRoot,W as run,k as slash,R as ssgBuild,m as toAtFS,o as transformObject};

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";var _chunkD6FLLKWUcjs = require('../chunk-D6FLLKWU.cjs');_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );_chunkD6FLLKWUcjs.e.call(void 0, );
+"use strict";var _chunk7EKNBB3Ecjs = require('../chunk-7EKNBB3E.cjs');_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );_chunk7EKNBB3Ecjs.e.call(void 0, );

package/dist/types/index.d.cts

@@ -1,5 +1,5 @@
-import { a as PageFrontMatter, b as PostFrontMatter } from '../config-DRImYfNf.cjs';
-export { A as Album, D as DefaultTheme, E as ExcerptType, F as FuseListItem, P as PartialDeep, i as Photo, f as Pkg, c as RedirectItem, R as RedirectRule, e as RuntimeConfig, d as SiteConfig, S as SocialLink, U as UserSiteConfig, h as UserValaxyConfig, V as ValaxyAddon, g as ValaxyConfig } from '../config-DRImYfNf.cjs';
+import { a as PageFrontMatter, b as PostFrontMatter } from '../config-BXn7sQx8.cjs';
+export { A as Album, D as DefaultTheme, E as ExcerptType, F as FuseListItem, P as PartialDeep, i as Photo, f as Pkg, c as RedirectItem, R as RedirectRule, e as RuntimeConfig, d as SiteConfig, S as SocialLink, U as UserSiteConfig, h as UserValaxyConfig, V as ValaxyAddon, g as ValaxyConfig } from '../config-BXn7sQx8.cjs';
 import { Header } from '@valaxyjs/utils';
 import 'medium-zoom';
 import '@vueuse/integrations/useFuse';

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
-import { a as PageFrontMatter, b as PostFrontMatter } from '../config-DRImYfNf.js';
-export { A as Album, D as DefaultTheme, E as ExcerptType, F as FuseListItem, P as PartialDeep, i as Photo, f as Pkg, c as RedirectItem, R as RedirectRule, e as RuntimeConfig, d as SiteConfig, S as SocialLink, U as UserSiteConfig, h as UserValaxyConfig, V as ValaxyAddon, g as ValaxyConfig } from '../config-DRImYfNf.js';
+import { a as PageFrontMatter, b as PostFrontMatter } from '../config-BXn7sQx8.js';
+export { A as Album, D as DefaultTheme, E as ExcerptType, F as FuseListItem, P as PartialDeep, i as Photo, f as Pkg, c as RedirectItem, R as RedirectRule, e as RuntimeConfig, d as SiteConfig, S as SocialLink, U as UserSiteConfig, h as UserValaxyConfig, V as ValaxyAddon, g as ValaxyConfig } from '../config-BXn7sQx8.js';
 import { Header } from '@valaxyjs/utils';
 import 'medium-zoom';
 import '@vueuse/integrations/useFuse';

package/dist/types/index.mjs

@@ -1,2 +1,2 @@
 import {createRequire as __createRequire} from 'module';var require=__createRequire(import.meta.url);
-import{d as e}from"../chunk-KCYZWGKZ.mjs";e();e();e();e();e();e();e();e();e();e();
+import{d as e}from"../chunk-AUDFAOQV.mjs";e();e();e();e();e();e();e();e();e();e();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "valaxy",
   "type": "module",
-  "version": "0.20.0",
+  "version": "0.20.2",
   "description": "📄 Vite & Vue powered static blog generator.",
   "author": {
     "email": "me@yunyoujun.cn",
@@ -59,20 +59,20 @@
     "@antfu/install-pkg": "^0.4.1",
     "@antfu/utils": "^0.7.10",
     "@clack/prompts": "^0.7.0",
-    "@iconify-json/ri": "^1.2.1",
+    "@iconify-json/ri": "^1.2.3",
     "@intlify/unplugin-vue-i18n": "4",
     "@types/katex": "^0.16.7",
     "@types/luxon": "^3.4.2",
-    "@unhead/addons": "^1.11.7",
-    "@unhead/schema-org": "^1.11.7",
-    "@unhead/vue": "^1.11.7",
+    "@unhead/addons": "^1.11.11",
+    "@unhead/schema-org": "^1.11.11",
+    "@unhead/vue": "^1.11.11",
     "@vitejs/plugin-vue": "^5.1.4",
-    "@vue/devtools-api": "^7.4.6",
-    "@vueuse/core": "^11.1.0",
-    "@vueuse/integrations": "^11.1.0",
+    "@vue/devtools-api": "^7.6.3",
+    "@vueuse/core": "^11.2.0",
+    "@vueuse/integrations": "^11.2.0",
     "consola": "^3.2.3",
     "critters": "^0.0.25",
-    "cross-spawn": "^7.0.3",
+    "cross-spawn": "^7.0.5",
     "css-i18n": "^0.0.5",
     "date-fns": "^4.1.0",
     "date-fns-tz": "^3.2.0",
@@ -87,12 +87,11 @@
     "gray-matter": "^4.0.3",
     "hookable": "^5.5.3",
     "html-to-text": "^9.0.5",
-    "is-installed-globally": "^1.0.0",
-    "jiti": "^2.3.3",
+    "jiti": "^2.4.0",
     "js-base64": "^3.7.7",
     "js-yaml": "^4.1.0",
     "katex": "^0.16.11",
-    "lru-cache": "^11.0.1",
+    "lru-cache": "^11.0.2",
     "luxon": "^3.5.0",
     "markdown-it": "^14.1.0",
     "markdown-it-anchor": "^9.2.0",
@@ -104,33 +103,35 @@
     "markdown-it-table-of-contents": "^0.8.0",
     "markdown-it-task-lists": "^2.1.1",
     "medium-zoom": "^1.1.0",
-    "mermaid": "^11.3.0",
+    "mermaid": "^11.4.0",
+    "mlly": "^1.7.2",
     "nprogress": "^0.2.0",
     "open": "10.1.0",
-    "ora": "^8.1.0",
+    "ora": "^8.1.1",
     "pascalcase": "^2.0.0",
     "pathe": "^1.1.2",
-    "pinia": "^2.2.4",
+    "pinia": "^2.2.6",
     "qrcode": "^1.5.4",
-    "sass": "^1.79.4",
-    "shiki": "^1.22.0",
-    "star-markdown-css": "^0.5.2",
-    "unocss": "^0.63.4",
+    "resolve-global": "^2.0.0",
+    "sass": "^1.80.6",
+    "shiki": "^1.22.2",
+    "star-markdown-css": "^0.5.3",
+    "unocss": "^0.64.0",
     "unplugin-vue-components": "^0.27.4",
     "unplugin-vue-markdown": "^0.26.2",
     "unplugin-vue-router": "^0.10.8",
     "vanilla-lazyload": "^19.1.3",
-    "vite": "^5.4.8",
-    "vite-plugin-vue-devtools": "^7.4.6",
-    "vite-plugin-vue-layouts": "0.11.0",
-    "vite-ssg": "0.23.7",
-    "vite-ssg-sitemap": "0.6.1",
-    "vue": "^3.5.11",
+    "vite": "^5.4.10",
+    "vite-plugin-vue-devtools": "^7.6.3",
+    "vite-plugin-vue-layouts": "^0.11.0",
+    "vite-ssg": "^0.24.1",
+    "vite-ssg-sitemap": "^0.8.1",
+    "vue": "^3.5.12",
     "vue-i18n": "^10.0.4",
     "vue-router": "^4.4.5",
     "yargs": "^17.7.2",
-    "@valaxyjs/devtools": "0.20.0",
-    "@valaxyjs/utils": "0.20.0"
+    "@valaxyjs/devtools": "0.20.2",
+    "@valaxyjs/utils": "0.20.2"
   },
   "devDependencies": {
     "@mdit-vue/plugin-component": "^2.1.3",

package/types/config.ts

@@ -55,6 +55,8 @@ export interface SiteConfig {
   /**
    * alternative languages
    * @description 可选语言
+   * @en If you want to disable multi-language support for your site, you can set this to only include one language (e.g. `['en']`)
+   * @zh 如果你想要禁言站点的多语言支持，可以将此项设置为仅包含一个语言 (例如 `['zh-CN']`)
    * @default ['en', 'zh-CN']
    * @see https://ogp.me/#optional
    */
@@ -391,6 +393,8 @@ export interface ValaxyConfig<ThemeConfig = DefaultTheme.Config> {
   /**
    * The name of theme
    * @description 主题名称
+   * @see 主题橱窗 [Valaxy Themes Gallery](https://valaxy.site/themes/gallery)
+   * @see 如何编写主题？ [How to write a theme? | Valaxy](https://valaxy.site/themes/write)
    */
   theme: string
   /**
@@ -401,7 +405,8 @@ export interface ValaxyConfig<ThemeConfig = DefaultTheme.Config> {
     pkg: Pkg
   }
   /**
-   * generated by runtime
+   * @en Generated in runtime, do not modify manually
+   * @zh 在运行时生成，请勿手动修改
    */
   runtimeConfig: RuntimeConfig
 }