valaxy 0.18.9 → 0.19.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "valaxy",
   "type": "module",
-  "version": "0.18.9",
+  "version": "0.19.1",
   "description": "📄 Vite & Vue powered static blog generator.",
   "author": {
     "email": "me@yunyoujun.cn",
@@ -57,21 +57,22 @@
     "node": "^14.18.0 || >=16.0.0"
   },
   "dependencies": {
-    "@antfu/utils": "^0.7.8",
+    "@antfu/utils": "^0.7.10",
     "@ctrl/tinycolor": "^4.1.0",
     "@iconify-json/carbon": "^1.1.36",
     "@iconify-json/ri": "^1.1.21",
     "@intlify/unplugin-vue-i18n": "^4.0.0",
+    "@types/js-yaml": "^4.0.9",
     "@types/katex": "^0.16.7",
-    "@unhead/addons": "^1.9.14",
-    "@unhead/schema-org": "^1.9.14",
-    "@unhead/vue": "^1.9.14",
+    "@unhead/addons": "^1.9.15",
+    "@unhead/schema-org": "^1.9.15",
+    "@unhead/vue": "^1.9.15",
     "@vitejs/plugin-vue": "^5.0.5",
-    "@vue/devtools-api": "^7.3.4",
+    "@vue/devtools-api": "^7.3.5",
     "@vueuse/core": "^10.11.0",
     "@vueuse/integrations": "^10.11.0",
     "consola": "^3.2.3",
-    "critters": "^0.0.22",
+    "critters": "^0.0.24",
     "cross-spawn": "^7.0.3",
     "css-i18n": "^0.0.2",
     "date-fns": "^3.6.0",
@@ -89,8 +90,9 @@
     "is-installed-globally": "^1.0.0",
     "jiti": "^1.21.6",
     "js-base64": "^3.7.7",
-    "katex": "^0.16.10",
-    "lru-cache": "^10.2.2",
+    "js-yaml": "^4.1.0",
+    "katex": "^0.16.11",
+    "lru-cache": "^10.4.0",
     "markdown-it": "^14.1.0",
     "markdown-it-anchor": "^9.0.1",
     "markdown-it-attrs": "^4.1.6",
@@ -110,23 +112,23 @@
     "pinia": "^2.1.7",
     "qrcode": "^1.5.3",
     "sass": "^1.77.6",
-    "shiki": "^1.9.0",
-    "star-markdown-css": "^0.4.2",
-    "unocss": "^0.61.0",
-    "unplugin-vue-components": "^0.27.0",
+    "shiki": "^1.10.3",
+    "star-markdown-css": "^0.5.1",
+    "unocss": "^0.61.3",
+    "unplugin-vue-components": "^0.27.2",
     "unplugin-vue-markdown": "^0.26.2",
-    "unplugin-vue-router": "^0.9.1",
+    "unplugin-vue-router": "^0.10.0",
     "vanilla-lazyload": "^19.1.3",
-    "vite": "^5.3.1",
-    "vite-plugin-vue-devtools": "^7.3.4",
+    "vite": "^5.3.3",
+    "vite-plugin-vue-devtools": "^7.3.5",
     "vite-plugin-vue-layouts": "0.11.0",
     "vite-ssg": "0.23.7",
     "vite-ssg-sitemap": "0.6.1",
-    "vue": "^3.4.30",
+    "vue": "^3.4.31",
     "vue-i18n": "^9.13.1",
     "vue-router": "^4.4.0",
     "yargs": "^17.7.2",
-    "@valaxyjs/devtools": "0.18.9"
+    "@valaxyjs/devtools": "0.19.1"
   },
   "devDependencies": {
     "@mdit-vue/plugin-component": "^2.1.3",

package/types/config.ts

@@ -4,7 +4,7 @@ import type { ILazyLoadOptions } from 'vanilla-lazyload'
 import type { RouteRecordRaw } from 'vue-router'
 import type { ValaxyAddon } from '../types'
 import type { DefaultTheme } from './default-theme'
-import type { PostFrontMatter } from './posts'
+import type { PostFrontMatter } from './frontmatter'
 import type { FuseListItem } from './node'
 
 import './default-theme'
@@ -104,6 +104,10 @@ export interface SiteConfig {
      * @description 状态
      */
     status: {
+      /**
+       * Emoji representation of your status like '👨‍💻'
+       * @description 你的状态的 Emoji 表示，如 '👨‍💻'
+       */
       emoji: string
       /**
        * show when hover emoji

package/types/default-theme.ts

@@ -1,6 +1,44 @@
+import type { UseDarkOptions } from '@vueuse/core'
+
 // eslint-disable-next-line ts/no-namespace
 export namespace DefaultTheme {
   export 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.
      *

package/types/frontmatter/index.ts

@@ -0,0 +1,2 @@
+export * from './page'
+export * from './post'

package/types/frontmatter/page.ts

@@ -0,0 +1,191 @@
+import type { ImageObject, NodeRelations } from '@unhead/schema-org'
+
+export interface Album {
+  /**
+   * @description:en-US Album Link
+   */
+  url: string
+  /**
+   * @description:en-US Album cover
+   * url
+   */
+  cover: string
+  /**
+   * @description:en-US Album caption
+   */
+  caption: string
+  /**
+   * @description:en-US Album description
+   */
+  desc: string
+}
+
+export interface Photo {
+  src: string
+  caption: string
+  desc: string
+}
+
+export interface PageFrontMatter 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
+  /**
+   * i18n
+   */
+  lang: string
+
+  /**
+   * @description Author
+   * @description:zh-CN 作者
+   */
+  author: string
+
+  /**
+   * Display sponsor info
+   * @description 是否开启赞助
+   */
+  sponsor: boolean
+  /**
+   * Copyright
+   * @description 是否显示文章底部版权信息
+   */
+  copyright: boolean
+
+  // schema
+  image: NodeRelations<ImageObject | string>
+
+  /**
+   * cover
+   * @description 封面图片
+   */
+  cover: string
+  /**
+   * display toc
+   * @description 是否显示目录
+   */
+  toc: boolean
+  /**
+   * display right sidebar
+   * @description 是否显示右侧侧边栏
+   */
+  aside: boolean
+
+  /**
+   * @description:en-US Custom Markdown class
+   * @description:zh-CN 自定义 Markdown 样式
+   * @default 'markdown-body'
+   */
+  markdownClass: string
+
+  /**
+   * @description:en-US Post title class
+   * @description:zh-CN 文章标题样式
+   */
+  pageTitleClass: string
+
+  /**
+   * icon before title
+   * @description 标题前的图标
+   */
+  icon: string
+  /**
+   * title color
+   * @deprecated Please use `pageTitleClass` | `postTitleClass` instead
+   */
+  color: string
+  /**
+   * display comment
+   */
+  comment: boolean
+  /**
+   * post is end
+   * @description 是否完结，将在末尾添加衬线字体 Q.E.D.
+   */
+  end: boolean
+
+  // third-party features
+  /**
+   * use aplayer
+   * @url https://aplayer.js.org/
+   */
+  aplayer: boolean
+  /**
+   * use katex
+   * @url https://katex.org/
+   */
+  katex: boolean
+  /**
+   * use codepen
+   * @url https://codepen.io/
+   */
+  codepen: boolean
+  /**
+   * use medium-zoom
+   * @url https://github.com/francoischalifour/medium-zoom
+   */
+  medium_zoom: boolean
+
+  /**
+   * @description:en-US Albums
+   * @description:zh-CN 相册
+   */
+  albums: Album[]
+
+  /**
+   * For layout Gallery
+   * @description:en-US Photos
+   */
+  photos: Photo[]
+
+  /**
+   * @description:zh-CN 是否启用加密，password 存在时默认为 true
+   */
+  encrypt: boolean
+  /**
+   * @description:zh-CN 加密密码
+   */
+  password?: string
+  /**
+   * @description:zh-CN 相册密码
+   */
+  gallery_password?: string
+  /**
+   * @en
+   * @description encrypted content
+   *
+   * @description:zh-CN 加密后的内容
+   */
+  encryptedContent?: string
+  /**
+   * @description:zh-CN 部分加密的内容
+   */
+  partiallyEncryptedContents?: string[]
+  /**
+   * @description:zh-CN 加密后的相册
+   */
+  encryptedPhotos?: string
+  /**
+   * @description:en-US Limit the height of the code block in px
+   * @description:zh-CN 限制代码块的高度，单位是 px
+   */
+  codeHeightLimit?: number
+  /**
+   * @description:en-US Source path for client redirection
+   * @description:zh-CN 客户端重定向的源路径
+   */
+  from?: string | string[]
+}

package/types/frontmatter/post.ts

@@ -0,0 +1,103 @@
+import type { PageFrontMatter } from './page'
+
+export type ExcerptType = 'md' | 'html' | 'text' | 'ai'
+
+export interface PostFrontMatter extends PageFrontMatter {
+  /**
+   * @description:en-US Custom post title class in post list
+   * @description:zh-CN 文章列表中 自定义标题样式
+   */
+  postTitleClass: string
+
+  /**
+   * @description:en-US Post Card Type, can be bilibili/yuque/... (need theme support)
+   * @description:zh-CN 卡片类型，可以是 bilibili/yuque/... (需主题支持)
+   */
+  type: 'bilibili' | 'yuque' | string
+  /**
+   * @en override url, and jump directly
+   * @zh 覆盖 post url，直接跳转
+   */
+  url: string
+  /**
+   * @description:en-US custom excerpt, `excerpt_type` will be invalid
+   * @description 手动指定摘要，此时 `excerpt_type` 将会无效
+   */
+  excerpt: string
+  /**
+   * @description 摘要类型
+   * @default 'html'
+   * render type of excerpt
+   * - md: render as raw markdown
+   * - html: render as html
+   * - text: render as text
+   */
+  excerpt_type: 'md' | 'text' | 'html' | 'ai'
+
+  /**
+   * @description:en-US Category, if it is an array, it represents multiple folders in order
+   * @description:zh-CN 分类，若为数组，则按顺序代表多层文件夹
+   */
+  categories: string | string[]
+  /**
+   * @description:en-US Tags, can have multiple
+   * @description:zh-CN 标签，可以有多个
+   */
+  tags: string[]
+
+  /**
+   * @description:en-US Whether to display the previous and next navigation
+   * @description:zh-CN 是否显示前一篇、后一篇导航
+   */
+  nav: boolean
+
+  /**
+   * @description:en-US Pin to top, the larger the number, the closer to the front
+   * @description:zh-CN 置顶，数字越大越靠前
+   */
+  top: number
+
+  /**
+   * @description:en-US Whether it is a draft, it will only be displayed during development
+   * @description:zh-CN 是否为草稿，将仅在开发时被展示
+   */
+  draft: boolean
+  /**
+   * hide in index
+   * - true/`all`: hide in index & archive
+   * - `index`: hide in index
+   * @description 是否隐藏
+   */
+  hide: 'index' | boolean
+
+  /**
+   * @en
+   * when the post is updated more than 30 days ago, show a warning
+   * default 30 days, you can set `time_warning` in frontmatter to change it
+   *
+   * @zh
+   * 当文章更新时间超过 30 天时，显示一个警告
+   * 默认 30 天，你可以在 frontmatter 中设置 `time_warning` （数字）来修改，单位 ms
+   * @example 3600000
+   */
+  time_warning: boolean | number
+
+  /**
+   * @protected
+   * @see https://valaxy.site/guide/config/#%E9%98%85%E8%AF%BB%E7%BB%9F%E8%AE%A1
+   * @tutorial ⚠️ DO NOT SET MANUALLY (generated by `site.config.ts` -> `statistics.enable: true`)
+   * You can use `statistics.readTime.speed` to change the speed of reading time.
+   * @description:en-US Reading time
+   * @description:zh-CN 阅读时间
+   */
+  readingTime: number
+  /**
+   * @protected
+   * @see https://valaxy.site/guide/config/#%E9%98%85%E8%AF%BB%E7%BB%9F%E8%AE%A1
+   * @tutorial ⚠️ DO NOT SET MANUALLY (generated by `site.config.ts` -> `statistics.enable: true`)
+   * You need enable `statistics` in site config to use this feature.
+   * @description:en-US Word count
+   * @description:zh-CN 字数统计
+   */
+  wordCount: string
+}

package/types/index.ts

@@ -2,6 +2,7 @@
 export * from './addon'
 export * from './config'
 export * from './data'
+export * from './frontmatter'
 export * from './posts'
 
 // used in node, but without node deps

package/types/posts.ts

@@ -1,256 +1,4 @@
-import type { ImageObject, NodeRelations } from '@unhead/schema-org'
-
-export interface Album {
-  /**
-   * @description:en-US Album Link
-   */
-  url: string
-  /**
-   * @description:en-US Album cover
-   * url
-   */
-  cover: string
-  /**
-   * @description:en-US Album caption
-   */
-  caption: string
-  /**
-   * @description:en-US Album description
-   */
-  desc: string
-}
-
-export interface Photo {
-  src: string
-  caption: string
-  desc: string
-}
-
-export type ExcerptType = 'md' | 'html' | 'text' | 'ai'
-
-export interface PageFrontMatter 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
-  /**
-   * i18n
-   */
-  lang: string
-  /**
-   * TODO
-   * Read Time
-   * @description 阅读时长
-   */
-  duration: string
-
-  /**
-   * @description Author
-   * @description:zh-CN 作者
-   */
-  author: string
-
-  /**
-   * Display sponsor info
-   * @description 是否开启赞助
-   */
-  sponsor: boolean
-  /**
-   * Copyright
-   * @description 是否显示文章底部版权信息
-   */
-  copyright: boolean
-
-  // schema
-  image: NodeRelations<ImageObject | string>
-
-  /**
-   * cover
-   * @description 封面图片
-   */
-  cover: string
-  /**
-   * display toc
-   * @description 是否显示目录
-   */
-  toc: boolean
-  /**
-   * display right sidebar
-   * @description 是否显示右侧侧边栏
-   */
-  aside: boolean
-
-  /**
-   * enable markdown-body class
-   * @description 是否启用默认的 markdown 样式
-   */
-  markdown: boolean
-
-  /**
-   * icon before title
-   */
-  icon: string
-  /**
-   * title color
-   */
-  color: string
-  /**
-   * display comment
-   */
-  comment: boolean
-  /**
-   * post is end
-   * @description 是否完结，将在末尾添加衬线字体 Q.E.D.
-   */
-  end: boolean
-
-  // third-party features
-  /**
-   * use aplayer
-   */
-  aplayer: boolean
-  /**
-   * use katex
-   */
-  katex: boolean
-  /**
-   * use codepen
-   */
-  codepen: boolean
-  /**
-   * use medium-zoom
-   * @url https://github.com/francoischalifour/medium-zoom
-   */
-  medium_zoom: boolean
-
-  /**
-   * @description:en-US Albums
-   * @description:zh-CN 相册
-   */
-  albums: Album[]
-
-  /**
-   * For layout Gallery
-   * @description:en-US Photos
-   */
-  photos: Photo[]
-
-  /**
-   * @description:zh-CN 是否启用加密，password 存在时默认为 true
-   */
-  encrypt: boolean
-  /**
-   * @description:zh-CN 加密密码
-   */
-  password?: string
-  /**
-   * @description:zh-CN 相册密码
-   */
-  gallery_password?: string
-  /**
-   * @description:zh-CN 加密后的内容
-   */
-  encryptedContent?: string
-  /**
-   * @description:zh-CN 部分加密的内容
-   */
-  partiallyEncryptedContents?: string[]
-  /**
-   * @description:zh-CN 加密后的相册
-   */
-  encryptedPhotos?: string
-  /**
-   * @description:en-US Limit the height of the code block in px
-   * @description:zh-CN 限制代码块的高度，单位是 px
-   */
-  codeHeightLimit?: number
-  /**
-   * @description:en-US Source path for client redirection
-   * @description:zh-CN 客户端重定向的源路径
-   */
-  from?: string | string[]
-}
-
-export interface PostFrontMatter extends PageFrontMatter {
-  /**
-   * post card type, can be bilibili/yuque/...
-   */
-  type: string
-  /**
-   * override url, and jump directly
-   */
-  url: string
-  /**
-   * @description 摘要
-   */
-  excerpt: string
-  /**
-   * @default 'html'
-   * render type of excerpt
-   * - md: render as raw markdown
-   * - html: render as html
-   * - text: render as text
-   */
-  excerpt_type: 'md' | 'text' | 'html' | 'ai'
-
-  /**
-   * Category
-   * @description 分类，若为数组，则按顺序代表多层文件夹
-   */
-  categories: string | string[]
-  /**
-   * Tags
-   * @description 标签，可以有多个
-   */
-  tags: string[]
-
-  /**
-   * display prev next
-   * @description 是否显示前一篇、后一篇导航
-   */
-  nav: boolean
-
-  /**
-   * 置顶
-   */
-  top: number
-
-  /**
-   * is draft
-   * @description 是否为草稿
-   */
-  draft: boolean
-  /**
-   * hide in index
-   * - true/`all`: hide in index & archive
-   * - `index`: hide in index
-   * @description 是否隐藏
-   */
-  hide: 'index' | boolean
-
-  /**
-   * when the post is updated more than 30 days ago, show a warning
-   * default 30 days, you can set `time_warning` in frontmatter to change it
-   *
-   * @zh
-   * 当文章更新时间超过 30 天时，显示一个警告
-   * 默认 30 天，你可以在 frontmatter 中设置 `time_warning` （数字）来修改，单位 ms
-   * @example 3600000
-   */
-  time_warning: boolean | number
-}
+import type { PageFrontMatter, PostFrontMatter } from './frontmatter'
 
 export type Page = Partial<PageFrontMatter>
 export type Post = Partial<PostFrontMatter>