valaxy 0.7.8 → 0.9.0

package/dist/node/index.d.ts

@@ -1,30 +1,163 @@
-import { U as UserConfig, P as PartialDeep, V as ValaxyConfig, a as ValaxyEntryOptions, b as ValaxyThemeConfig, R as ResolvedValaxyOptions, c as ValaxyServerOptions } from '../index-328992a1.js';
-export { R as ResolvedValaxyOptions, a as ValaxyEntryOptions, d as ValaxyPluginOptions, c as ValaxyServerOptions, g as getThemeRoot, i as isPath, r as resolveOptions, e as resolvePluginOptions } from '../index-328992a1.js';
+import { ViteSSGOptions } from 'vite-ssg';
+import Vue from '@vitejs/plugin-vue';
+import Components from 'unplugin-vue-components/vite';
+import { VitePluginConfig } from 'unocss/vite';
+import Pages from 'vite-plugin-pages';
 import * as vite from 'vite';
-import { InlineConfig } from 'vite';
-import 'vite-ssg';
-import '@vitejs/plugin-vue';
-import 'unplugin-vue-components/vite';
-import 'unocss/vite';
-import 'markdown-it';
-import 'shiki';
-import 'markdown-it-anchor';
-import 'katex';
+import { UserConfig, InlineConfig } from 'vite';
+import { V as ValaxyConfig, U as UserConfig$1, P as PartialDeep, a as ValaxyThemeConfig } from '../config-60c840d8.js';
+import MarkdownIt from 'markdown-it';
+import { Theme } from 'shiki';
+import Anchor from 'markdown-it-anchor';
+import { KatexOptions } from 'katex';
+
+interface BlockItem {
+    text?: string;
+    icon?: string;
+    color?: string;
+}
+interface Blocks {
+    tip?: BlockItem;
+    warning?: BlockItem;
+    danger?: BlockItem;
+    info?: BlockItem;
+    details?: BlockItem;
+}
+
+declare type ThemeOptions = Theme | {
+    light: Theme;
+    dark: Theme;
+};
+interface MarkdownOptions {
+    /**
+     * markdown-it options
+     */
+    options?: MarkdownIt.Options;
+    /**
+     * config markdown-it
+     */
+    config?: (md: MarkdownIt) => void;
+    anchor?: {
+        permalink?: Anchor.AnchorOptions['permalink'];
+    };
+    toc?: {
+        includeLevel?: number[];
+        [key: string]: any;
+    };
+    katex?: KatexOptions;
+    /**
+     * shiki
+     */
+    theme?: ThemeOptions;
+    /**
+     * Custom block configurations
+     */
+    blocks?: Blocks;
+}
+
+interface ValaxyEntryOptions {
+    /**
+     * theme name
+     */
+    theme?: string;
+    userRoot?: string;
+}
+interface ValaxyPluginOptions {
+    vue?: Parameters<typeof Vue>[0];
+    components?: Parameters<typeof Components>[0];
+    unocss?: VitePluginConfig;
+    pages?: Parameters<typeof Pages>[0];
+    /**
+     * for markdown
+     */
+    markdown?: MarkdownOptions;
+    extendMd?: (ctx: {
+        route: any;
+        data: Record<string, any>;
+        excerpt?: string;
+        path: string;
+    }) => void;
+}
+interface ValaxyThemePlugin extends ValaxyPluginOptions {
+    vite?: Omit<UserConfig, 'valaxy'>;
+}
+interface ResolvedValaxyOptions {
+    mode: 'dev' | 'build';
+    /**
+     * package.json root
+     */
+    pkgRoot: string;
+    /**
+     * Client root path
+     * @default 'valaxy/client'
+     */
+    clientRoot: string;
+    /**
+     * User root path
+     * @default process.cwd()
+     */
+    userRoot: string;
+    /**
+     * Theme root path
+     */
+    themeRoot: string;
+    /**
+     * Theme name
+     */
+    roots: string[];
+    theme: string;
+    /**
+     * Valaxy Config
+     */
+    config: ValaxyConfig;
+    /**
+     * config file path
+     */
+    configFile: string;
+    pages: string[];
+}
+interface ValaxyServerOptions {
+    onConfigReload?: (newConfig: ValaxyConfig, config: ValaxyConfig) => void;
+}
+declare function isPath(name: string): boolean;
+/**
+ * get theme roots
+ * @param name
+ * @param entry
+ * @returns
+ */
+declare function getThemeRoot(name: string, entry: string): string;
+declare function resolveOptions(options: ValaxyEntryOptions, mode?: ResolvedValaxyOptions['mode']): Promise<ResolvedValaxyOptions>;
+
+declare module 'vite' {
+    interface UserConfig {
+        /**
+         * Custom internal plugin options for Valaxy (advanced)
+         *
+         * @see ./options.ts'
+         */
+        valaxy?: ValaxyPluginOptions;
+        ssgOptions?: ViteSSGOptions;
+    }
+}
 
 /**
  * Type config helper
  */
-declare function defineConfig<ThemeConfig>(config: UserConfig<ThemeConfig>): PartialDeep<ValaxyConfig<ThemeConfig>>;
+declare function defineConfig<ThemeConfig>(config: UserConfig$1<ThemeConfig>): PartialDeep<ValaxyConfig<ThemeConfig>>;
 /**
  * Type config helper for custom theme config
  */
-declare function defineConfigWithTheme<ThemeConfig>(config: UserConfig<ThemeConfig>): PartialDeep<ValaxyConfig<ThemeConfig>>;
+declare function defineConfigWithTheme<ThemeConfig>(config: UserConfig$1<ThemeConfig>): PartialDeep<ValaxyConfig<ThemeConfig>>;
 declare function resolveConfig(options?: ValaxyEntryOptions): Promise<{
     config: ValaxyConfig<ValaxyThemeConfig>;
     configFile: string;
     theme: string;
 }>;
+declare type ThemeConfigExport = ValaxyThemePlugin | Promise<ValaxyThemePlugin> | ThemeConfigFn;
+declare type ThemeConfigFn = (options: ResolvedValaxyOptions) => ValaxyThemePlugin | Promise<ValaxyThemePlugin>;
+declare function defineThemePlugin(config: ThemeConfigExport): Promise<ValaxyThemePlugin | ThemeConfigFn>;
 
 declare function createServer(options: ResolvedValaxyOptions, viteConfig?: InlineConfig, serverOptions?: ValaxyServerOptions): Promise<vite.ViteDevServer>;
 
-export { createServer, defineConfig, defineConfigWithTheme, resolveConfig };
+export { ResolvedValaxyOptions, ThemeConfigExport, ThemeConfigFn, ValaxyEntryOptions, ValaxyPluginOptions, ValaxyServerOptions, ValaxyThemePlugin, createServer, defineConfig, defineConfigWithTheme, defineThemePlugin, getThemeRoot, isPath, resolveConfig, resolveOptions };

package/dist/node/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-KP3MIFG6.js');var _chunkEYC2AAUGjs = require('../chunk-EYC2AAUG.js');exports.createServer = _chunkEYC2AAUGjs.p; exports.defineConfig = _chunkEYC2AAUGjs.e; exports.defineConfigWithTheme = _chunkEYC2AAUGjs.f; exports.getThemeRoot = _chunkEYC2AAUGjs.j; exports.isPath = _chunkEYC2AAUGjs.i; exports.resolveConfig = _chunkEYC2AAUGjs.g; exports.resolveOptions = _chunkEYC2AAUGjs.k; exports.resolvePluginOptions = _chunkEYC2AAUGjs.l;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk6SOT7TNGjs = require('../chunk-6SOT7TNG.js');exports.createServer = _chunk6SOT7TNGjs.p; exports.defineConfig = _chunk6SOT7TNGjs.e; exports.defineConfigWithTheme = _chunk6SOT7TNGjs.f; exports.defineThemePlugin = _chunk6SOT7TNGjs.h; exports.getThemeRoot = _chunk6SOT7TNGjs.k; exports.isPath = _chunk6SOT7TNGjs.j; exports.resolveConfig = _chunk6SOT7TNGjs.g; exports.resolveOptions = _chunk6SOT7TNGjs.l;

package/dist/node/index.mjs

@@ -1 +1 @@
-import"../chunk-4FKSRP5I.mjs";import{e as a,f as b,g as c,i as d,j as e,k as f,l as g,p as h}from"../chunk-EIYDDCHI.mjs";export{h as createServer,a as defineConfig,b as defineConfigWithTheme,e as getThemeRoot,d as isPath,c as resolveConfig,f as resolveOptions,g as resolvePluginOptions};
+import{e as o,f as r,g as m,h as p,j as t,k as e,l as f,p as x}from"../chunk-ORY7PPZG.mjs";export{x as createServer,o as defineConfig,r as defineConfigWithTheme,p as defineThemePlugin,e as getThemeRoot,t as isPath,m as resolveConfig,f as resolveOptions};

package/dist/types/index.d.ts

@@ -1,9 +1,154 @@
-import 'vite-ssg';
-export { A as AlgoliaSearchOptions, k as HeadConfig, H as Header, h as PageData, j as PageDataPayload, P as PartialDeep, f as Post, S as SocialLink, U as UserConfig, V as ValaxyConfig, b as ValaxyThemeConfig } from '../index-328992a1.js';
-import '@vitejs/plugin-vue';
-import 'unplugin-vue-components/vite';
-import 'unocss/vite';
-import 'markdown-it';
-import 'shiki';
-import 'markdown-it-anchor';
-import 'katex';
+export { A as AlgoliaSearchOptions, P as PartialDeep, S as SocialLink, U as UserConfig, V as ValaxyConfig, a as ValaxyThemeConfig } from '../config-60c840d8.js';
+
+interface Post extends Record<string, any> {
+    /**
+     * Path of post
+     * route.path
+     * @description 路径
+     */
+    path?: string;
+    /**
+     * Title
+     * @description 文章标题
+     */
+    title?: string;
+    date?: string | number | Date;
+    /**
+     * Updated Time
+     */
+    updated?: string | number | Date;
+    lang?: string;
+    /**
+     * TODO
+     * Read Time
+     * @description 阅读时长
+     */
+    duration?: string;
+    /**
+     * post card type, can be bilibili/yuque/...
+     */
+    type?: string;
+    /**
+     * override url, and jump directly
+     */
+    url?: string;
+    /**
+     * @description 摘要
+     */
+    excerpt?: string;
+    /**
+     * @description Author
+     * @description:zh-CN 作者
+     */
+    author?: string;
+    /**
+     * Display sponsor info
+     * @description 是否开启赞助
+     */
+    sponsor?: boolean;
+    /**
+     * Copyright
+     * @description 是否显示文章底部版权信息
+     */
+    copyright?: boolean;
+    /**
+     * Category
+     * @description 分类，若为数组，则按顺序代表多层文件夹
+     */
+    categories?: string | string[];
+    /**
+     * Tags
+     * @description 标签，可以有多个
+     */
+    tags?: string[];
+    /**
+     * display prev next
+     * @description 是否显示前一篇、后一篇导航
+     */
+    nav?: boolean;
+    /**
+     * display right sidebar
+     * @description 是否显示右侧侧边栏
+     */
+    aside?: boolean;
+    /**
+     * icon before title
+     */
+    icon?: string;
+    /**
+     * title color
+     */
+    color?: string;
+    /**
+     * display comment
+     */
+    comment?: boolean;
+    /**
+     * post is end
+     * @description 是否完结，将在末尾添加衬线字体 Q.E.D.
+     */
+    end?: boolean;
+    /**
+     * use aplayer
+     */
+    aplayer?: boolean;
+    /**
+     * use katex
+     */
+    katex?: boolean;
+    /**
+     * use codepen
+     */
+    codepen?: boolean;
+    /**
+     * 置顶
+     */
+    top?: number;
+    /**
+     * display toc
+     * @description 是否显示目录
+     */
+    toc?: boolean;
+    /**
+     * is draft
+     * @description 是否为草稿
+     */
+    draft?: boolean;
+    /**
+     * cover
+     * @description 封面图片
+     */
+    cover?: string;
+    /**
+     * enable markdown-body class
+     * @description 是否启用默认的 markdown 样式
+     */
+    markdown?: boolean;
+}
+
+interface Header {
+    level: number;
+    title: string;
+    slug: string;
+    /**
+     * i18n
+     */
+    lang?: string;
+}
+interface PageData {
+    path: string;
+    relativePath: string;
+    title: string;
+    titleTemplate?: string;
+    description: string;
+    headers: Header[];
+    frontmatter: Post;
+    lastUpdated?: number;
+}
+interface PageDataPayload {
+    path: string;
+    pageData: PageData;
+}
+declare type HeadConfig = [string, Record<string, string>] | [string, Record<string, string>, string];
+
+export { HeadConfig, Header, PageData, PageDataPayload, Post };

package/dist/types/index.js

@@ -1 +1 @@
-"use strict";require('../chunk-2QVEQP3K.js');
+"use strict";

package/dist/types/index.mjs

@@ -1 +0,0 @@
-import"../chunk-IMWNMHRD.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valaxy",
-  "version": "0.7.8",
+  "version": "0.9.0",
   "description": "📄 Vite & Vue powered static blog generator.",
   "author": {
     "email": "me@yunyoujun.cn",
@@ -22,7 +22,11 @@
       "import": "./dist/node/index.mjs"
     },
     "./client/*": "./client/*",
-    "./client": "./dist/client/index.d.ts",
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "require": "./dist/client/index.js",
+      "import": "./dist/client/index.mjs"
+    },
     "./node": {
       "types": "./dist/node/index.d.ts",
       "require": "./dist/node/index.js",
@@ -42,7 +46,8 @@
     "index.d.ts",
     "bin",
     "dist",
-    "client"
+    "client",
+    "types"
   ],
   "engines": {
     "node": ">=14.0.0"
@@ -84,10 +89,9 @@
     "shiki": "^0.10.1",
     "star-markdown-css": "^0.4.0",
     "unconfig": "^0.3.5",
-    "unocss": "^0.43.2",
+    "unocss": "^0.44.0",
     "unplugin-vue-components": "^0.21.1",
     "vite": "^2.9.14",
-    "vite-plugin-inspect": "^0.5.1",
     "vite-plugin-pages": "^0.25.0",
     "vite-plugin-vue-layouts": "^0.6.0",
     "vite-ssg": "0.19.2",

package/types/config.ts

@@ -0,0 +1,218 @@
+export type ValaxyThemeConfig = Record<string, any>
+
+export interface SocialLink {
+  /**
+   * The title of your link
+   */
+  name: string
+  link: string
+  /**
+   * 图标名称
+   * https://icones.js.org/
+   */
+  icon: string
+  color: string
+}
+
+export interface AlgoliaSearchOptions {
+  enable: boolean
+  appId: string
+  apiKey: string
+  indexName: string
+  placeholder?: string
+  searchParameters?: any
+  disableUserPersonalization?: boolean
+  initialQuery?: string
+}
+
+// packages/valaxy/node/config.ts
+export interface ValaxyConfig<T = ValaxyThemeConfig> {
+  /**
+   * Default language
+   * @description 默认语言
+   * @default 'en'
+   */
+  lang: string
+  /**
+   * You site url in web, required for ssg & rss
+   * @description 站点的 URL，SSG & RSS 需要（譬如生成版权处文章永久链接）
+   * @default '/'
+   */
+  url: string
+  /**
+   * Site title
+   * @description 站点标题
+   */
+  title: string
+  /**
+   * 副标题
+   */
+  subtitle: string
+  /**
+   * 站点描述
+   */
+  description: string
+  /**
+   * The owner of this blog
+   * @description 博客作者
+   */
+  author: {
+    /**
+     * Your name
+     * @description 你的名字
+     */
+    name: string
+    email: string
+    link: string
+    avatar: string
+    /**
+     * The status of you
+     * @description 状态
+     */
+    status: {
+      emoji: string
+      /**
+       * show when hover emoji
+       * @description 当鼠标悬浮在图标上时显示
+       */
+      message: string
+    }
+  }
+
+  /**
+   * show last updated time by git
+   */
+  lastUpdated: boolean
+
+  /**
+   * icon for your website
+   */
+  favicon: string
+
+  feed: {
+    /**
+     * name: feed -> feed.xml / feed.atom / feed.json
+     * @default '' -> feed.xml / atom.xml / feed.json
+     */
+    name: string
+    favicon: string
+  }
+
+  /**
+   * 社交链接
+   */
+  social: SocialLink[]
+
+  /**
+   * search
+   */
+  search: {
+    enable: boolean
+    algolia: AlgoliaSearchOptions
+  }
+
+  /**
+   * comment: waline/...
+   */
+  comment: {
+    enable: boolean
+    waline: {
+      enable: boolean
+      serverURL: string
+    }
+    twikoo: {
+      enable: boolean
+      envId: string
+    }
+  }
+
+  /**
+   * Markdown Feature
+   */
+  features: {
+    /**
+     * enable katex for global
+     */
+    katex: boolean
+  }
+
+  /**
+   * third-party plugin need cdn
+   * aplayer, twikoo
+   * @default 'https://npm.elemecdn.com/'
+   */
+  cdn: {
+    prefix: string
+  }
+
+  /**
+   * The name of theme
+   * @description 主题名称
+   */
+  theme: string
+  /**
+   * The config of theme
+   * @description 主题配置
+   */
+  themeConfig: T & {
+    pkg: {
+      name: string
+      version: string
+      homepage?: string
+      [key: string]: any
+    }
+  }
+
+  /**
+   * The license of your posts
+   * @description 文章所使用的协议，默认使用 Creative Commons
+   * @default https://creativecommons.org/licenses/
+   */
+  license: {
+    /**
+     * Whether to show at the bottom of the article
+     * @description 是否显示在文章底部
+     * @default true
+     */
+    enabled: boolean
+    /**
+     * Creative License Language, same with your config.lang
+     * when lang === 'zh-CN', use 'zh'
+     * @description 默认与站点语言相同
+     * @default 'en'
+     */
+    language: string
+    /**
+     * Type of license
+     * @description 证书类型
+     * @default 'by-nc-sa'
+     */
+    type: 'zero' | 'by-sa' | 'by-nd' | 'by-nc' | 'by-nc-sa' | 'by-nc-nd'
+  }
+
+  /**
+   * donate for author
+   * @description 打赏/赞助
+   */
+  sponsor: {
+    enable: boolean
+    title: string
+    methods: {
+      name: string
+      url: string
+      color: string
+      icon: string
+    }[]
+  }
+}
+
+export type PartialDeep<T> = {
+  [P in keyof T]?: T[P] extends object ? PartialDeep<T[P]> : T[P]
+}
+
+/**
+ * Valaxy User Config
+ * @description Valaxy 用户配置
+ */
+export type UserConfig<ThemeConfig = ValaxyThemeConfig> = PartialDeep<ValaxyConfig<ThemeConfig>>
+

package/types/data.ts

@@ -0,0 +1,31 @@
+import type { Post } from './posts'
+
+export interface Header {
+  level: number
+  title: string
+  slug: string
+  /**
+   * i18n
+   */
+  lang?: string
+}
+
+export interface PageData {
+  path: string
+  relativePath: string
+  title: string
+  titleTemplate?: string
+  description: string
+  headers: Header[]
+  frontmatter: Post
+  lastUpdated?: number
+}
+
+export interface PageDataPayload {
+  path: string
+  pageData: PageData
+}
+
+export type HeadConfig =
+  | [string, Record<string, string>]
+  | [string, Record<string, string>, string]

package/types/index.ts

@@ -0,0 +1,3 @@
+export * from './config'
+export * from './data'
+export * from './posts'