@sugarat/theme 0.5.16 → 0.5.18

package/node.d.ts

@@ -1,4 +1,5 @@
 import { DefaultTheme, UserConfig } from 'vitepress';
+import { BackToTopPluginOptions } from 'vitepress-plugin-back2top';
 import { RSSOptions } from 'vitepress-plugin-rss';
 import { Repo, Mapping } from '@giscus/vue';
 import { Options } from 'oh-my-live2d';
@@ -106,6 +107,7 @@ declare namespace Theme {
         inputPosition?: 'top' | 'bottom';
         lang?: string;
         loading?: 'lazy' | 'eager';
+        showCommentBtn?: boolean;
     }
     interface ArtalkOption {
         site: string;
@@ -498,17 +500,7 @@ declare namespace Theme {
          */
         weeksAgo?: string;
     } | ((date: Date | string) => string);
-    interface BackToTop {
-        /**
-         * 距离顶部多少距离出现
-         * @default 450
-         */
-        top?: number;
-        /**
-         * 设置展示图标，svg
-         * @recommend https://iconbuddy.app/search?q=fire
-         */
-        icon?: string;
+    interface BackToTop extends BackToTopPluginOptions {
     }
     interface TaskCheckbox {
         disabled?: boolean;

package/node.js

@@ -40,7 +40,7 @@ module.exports = __toCommonJS(node_exports);
 // src/utils/node/mdPlugins.ts
 var import_module = require("module");
 
-// ../../node_modules/.pnpm/vitepress-plugin-tabs@0.7.3_vitepress@2.0.0-alpha.16_@types+node@24.5.2_async-validator@4.2.5_wszfouv2xxx6bizfwwcmbwut3e/node_modules/vitepress-plugin-tabs/dist/node/index.js
+// ../../node_modules/.pnpm/vitepress-plugin-tabs@0.7.3_vitepress@2.0.0-alpha.17_@types+node@24.5.2_async-validator_91c0bbe99a18f826c198452196112f9a/node_modules/vitepress-plugin-tabs/dist/node/index.js
 function container_plugin(md, name, options) {
   function validateDefault(params) {
     return params.trim().split(" ", 2)[0] === name;
@@ -463,13 +463,6 @@ async function getArticles(cfg, vpConfig) {
 }
 function patchVPConfig(vpConfig, cfg) {
   vpConfig.head = vpConfig.head || [];
-  if (cfg?.comment && "type" in cfg.comment && cfg?.comment?.type === "artalk") {
-    const server = cfg.comment?.options?.server;
-    if (server) {
-      vpConfig.head.push(["link", { href: `${server} /dist/Artalk.css`, rel: "stylesheet" }]);
-      vpConfig.head.push(["script", { src: `${server} /dist/Artalk.js`, id: "artalk-script" }]);
-    }
-  }
 }
 function patchVPThemeConfig(cfg, vpThemeConfig = {}) {
   vpThemeConfig.sidebar = patchDefaultThemeSideBar(cfg)?.sidebar;
@@ -487,6 +480,9 @@ var import_vitepress_plugin_pagefind = require("vitepress-plugin-pagefind");
 var import_vitepress_plugin_rss = require("vitepress-plugin-rss");
 var import_theme_shared4 = require("@sugarat/theme-shared");
 var import_vitepress_plugin_announcement = require("vitepress-plugin-announcement");
+var import_vitepress_plugin_artalk = require("vitepress-plugin-artalk");
+var import_vitepress_plugin_back2top = require("vitepress-plugin-back2top");
+var import_vitepress_plugin_giscus = require("vitepress-plugin-giscus");
 var import_vitepress_plugin_group_icons2 = require("vitepress-plugin-group-icons");
 var import_vitepress_plugin_image_preview = require("vitepress-plugin-image-preview");
 
@@ -595,6 +591,25 @@ function getVitePlugins(cfg = {}) {
     ;
     [cfg?.RSS].flat().forEach((rssConfig) => plugins.push((0, import_vitepress_plugin_rss.RssPlugin)(rssConfig)));
   }
+  if (cfg?.comment && typeof cfg.comment !== "boolean") {
+    const commentConfig = cfg.comment;
+    const isArtalk = commentConfig.type === "artalk";
+    if (isArtalk) {
+      plugins.push((0, import_vitepress_plugin_artalk.artalkPlugin)(commentConfig.options));
+    }
+    const isGiscus = commentConfig.type === "giscus" || commentConfig.repo;
+    if (isGiscus) {
+      const { mobileMinify, label, icon } = commentConfig;
+      const options = {
+        ...commentConfig.options,
+        ...commentConfig,
+        mobileMinify,
+        label,
+        icon
+      };
+      plugins.push((0, import_vitepress_plugin_giscus.giscusPlugin)(options));
+    }
+  }
   if (cfg?.popover) {
     plugins.push((0, import_vitepress_plugin_announcement.AnnouncementPlugin)(cfg.popover));
   }
@@ -608,6 +623,10 @@ function getVitePlugins(cfg = {}) {
   if (cfg?.timeline !== false) {
     plugins.push(patchTimelinePlugin());
   }
+  if (cfg?.backToTop !== false) {
+    const options = typeof cfg.backToTop === "object" ? cfg.backToTop : {};
+    plugins.push((0, import_vitepress_plugin_back2top.back2topPlugin)(options));
+  }
   return plugins;
 }
 function patchGroupIconPlugin() {
@@ -618,6 +637,27 @@ function patchGroupIconPlugin() {
     }
   });
 }
+function extractDefaultExportString(info) {
+  const ast = info.ast;
+  try {
+    if (ast && Array.isArray(ast.body)) {
+      for (const node of ast.body) {
+        if (node.type === "ExportDefaultDeclaration") {
+          const decl = node.declaration;
+          if (decl?.type === "Literal" && typeof decl.value === "string") {
+            return decl.value;
+          }
+          if (decl?.type === "TemplateLiteral" && (decl.expressions?.length ?? 0) === 0) {
+            return decl.quasis?.[0]?.value?.cooked;
+          }
+        }
+      }
+    }
+  } catch (_) {
+  }
+  const m = info.code?.match(/export\s+default\s+(['"`])([\s\S]*?)\1/);
+  return m?.[2];
+}
 function patchTabsPlugin() {
   return createPatchPlugin({
     name: "@sugarat/theme-plugin-patch-tabs",
@@ -703,8 +743,9 @@ function coverImgTransform() {
       if (!relativePathMap[info.id]) {
         return;
       }
-      const asset = info.code?.match(/export default "(.*)"/)?.[1];
+      const asset = extractDefaultExportString(info);
       if (!asset) {
+        console.warn(`[coverImgTransform] \u89E3\u6790\u9ED8\u8BA4\u5BFC\u51FA\u5931\u8D25: ${info.id}`);
         return;
       }
       viteAssetsMap[info.id] = asset;

package/node.mjs

@@ -9,7 +9,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 // src/utils/node/mdPlugins.ts
 import { createRequire } from "module";
 
-// ../../node_modules/.pnpm/vitepress-plugin-tabs@0.7.3_vitepress@2.0.0-alpha.16_@types+node@24.5.2_async-validator@4.2.5_wszfouv2xxx6bizfwwcmbwut3e/node_modules/vitepress-plugin-tabs/dist/node/index.js
+// ../../node_modules/.pnpm/vitepress-plugin-tabs@0.7.3_vitepress@2.0.0-alpha.17_@types+node@24.5.2_async-validator_91c0bbe99a18f826c198452196112f9a/node_modules/vitepress-plugin-tabs/dist/node/index.js
 function container_plugin(md, name, options) {
   function validateDefault(params) {
     return params.trim().split(" ", 2)[0] === name;
@@ -430,13 +430,6 @@ async function getArticles(cfg, vpConfig) {
 }
 function patchVPConfig(vpConfig, cfg) {
   vpConfig.head = vpConfig.head || [];
-  if (cfg?.comment && "type" in cfg.comment && cfg?.comment?.type === "artalk") {
-    const server = cfg.comment?.options?.server;
-    if (server) {
-      vpConfig.head.push(["link", { href: `${server} /dist/Artalk.css`, rel: "stylesheet" }]);
-      vpConfig.head.push(["script", { src: `${server} /dist/Artalk.js`, id: "artalk-script" }]);
-    }
-  }
 }
 function patchVPThemeConfig(cfg, vpThemeConfig = {}) {
   vpThemeConfig.sidebar = patchDefaultThemeSideBar(cfg)?.sidebar;
@@ -456,6 +449,9 @@ import {
 import { RssPlugin } from "vitepress-plugin-rss";
 import { cacheAllGitTimestamps, joinPath as joinPath2 } from "@sugarat/theme-shared";
 import { AnnouncementPlugin } from "vitepress-plugin-announcement";
+import { artalkPlugin } from "vitepress-plugin-artalk";
+import { back2topPlugin } from "vitepress-plugin-back2top";
+import { giscusPlugin } from "vitepress-plugin-giscus";
 import { groupIconVitePlugin } from "vitepress-plugin-group-icons";
 import { ImagePreviewPlugin } from "vitepress-plugin-image-preview";
 
@@ -564,6 +560,25 @@ function getVitePlugins(cfg = {}) {
     ;
     [cfg?.RSS].flat().forEach((rssConfig) => plugins.push(RssPlugin(rssConfig)));
   }
+  if (cfg?.comment && typeof cfg.comment !== "boolean") {
+    const commentConfig = cfg.comment;
+    const isArtalk = commentConfig.type === "artalk";
+    if (isArtalk) {
+      plugins.push(artalkPlugin(commentConfig.options));
+    }
+    const isGiscus = commentConfig.type === "giscus" || commentConfig.repo;
+    if (isGiscus) {
+      const { mobileMinify, label, icon } = commentConfig;
+      const options = {
+        ...commentConfig.options,
+        ...commentConfig,
+        mobileMinify,
+        label,
+        icon
+      };
+      plugins.push(giscusPlugin(options));
+    }
+  }
   if (cfg?.popover) {
     plugins.push(AnnouncementPlugin(cfg.popover));
   }
@@ -577,6 +592,10 @@ function getVitePlugins(cfg = {}) {
   if (cfg?.timeline !== false) {
     plugins.push(patchTimelinePlugin());
   }
+  if (cfg?.backToTop !== false) {
+    const options = typeof cfg.backToTop === "object" ? cfg.backToTop : {};
+    plugins.push(back2topPlugin(options));
+  }
   return plugins;
 }
 function patchGroupIconPlugin() {
@@ -587,6 +606,27 @@ function patchGroupIconPlugin() {
     }
   });
 }
+function extractDefaultExportString(info) {
+  const ast = info.ast;
+  try {
+    if (ast && Array.isArray(ast.body)) {
+      for (const node of ast.body) {
+        if (node.type === "ExportDefaultDeclaration") {
+          const decl = node.declaration;
+          if (decl?.type === "Literal" && typeof decl.value === "string") {
+            return decl.value;
+          }
+          if (decl?.type === "TemplateLiteral" && (decl.expressions?.length ?? 0) === 0) {
+            return decl.quasis?.[0]?.value?.cooked;
+          }
+        }
+      }
+    }
+  } catch (_) {
+  }
+  const m = info.code?.match(/export\s+default\s+(['"`])([\s\S]*?)\1/);
+  return m?.[2];
+}
 function patchTabsPlugin() {
   return createPatchPlugin({
     name: "@sugarat/theme-plugin-patch-tabs",
@@ -672,8 +712,9 @@ function coverImgTransform() {
       if (!relativePathMap[info.id]) {
         return;
       }
-      const asset = info.code?.match(/export default "(.*)"/)?.[1];
+      const asset = extractDefaultExportString(info);
       if (!asset) {
+        console.warn(`[coverImgTransform] \u89E3\u6790\u9ED8\u8BA4\u5BFC\u51FA\u5931\u8D25: ${info.id}`);
         return;
       }
       viteAssetsMap[info.id] = asset;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sugarat/theme",
-  "version": "0.5.16",
+  "version": "0.5.18",
   "description": "简约风的 Vitepress 博客主题，sugarat vitepress blog theme",
   "author": "sugar",
   "license": "MIT",
@@ -52,10 +52,13 @@
     "vitepress-plugin-mermaid": "2.0.13",
     "vitepress-plugin-tabs": "0.7.3",
     "@sugarat/theme-shared": "0.0.7",
-    "vitepress-plugin-image-preview": "0.1.1",
+    "vitepress-plugin-back2top": "0.1.0",
+    "vitepress-plugin-announcement": "0.1.7",
+    "vitepress-plugin-giscus": "0.1.0",
+    "vitepress-plugin-artalk": "0.1.0",
+    "vitepress-plugin-image-preview": "0.1.2",
     "vitepress-plugin-rss": "0.4.3",
-    "vitepress-plugin-pagefind": "0.4.19",
-    "vitepress-plugin-announcement": "0.1.7"
+    "vitepress-plugin-pagefind": "0.4.19"
   },
   "devDependencies": {
     "artalk": "^2.8.5",
@@ -63,7 +66,7 @@
     "pagefind": "^1.3.0",
     "typescript": "^5.4.5",
     "vite": "^5.4.9",
-    "vitepress": "2.0.0-alpha.16",
+    "vitepress": "2.0.0-alpha.17",
     "vue": "^3.5.24",
     "vitepress-plugin-51la": "0.1.1"
   },

package/src/components/BlogApp.vue

@@ -13,13 +13,8 @@ import BlogArticleAnalyze from './BlogArticleAnalyze.vue'
 import BlogAlert from './BlogAlert.vue'
 import BlogFooter from './BlogFooter.vue'
 import BlogHomeHeaderAvatar from './BlogHomeHeaderAvatar.vue'
-import BlogBackToTop from './BlogBackToTop.vue'
-import CommentGiscus from './CommentGiscus.vue'
 import BlogOml2d from './BlogOml2d.vue'
-
-import CommentArtalk from './CommentArtalk.vue'
 import BlogButtonAfterArticle from './BlogButtonAfterArticle.vue'
-import BlogCommentWrapper from './BlogCommentWrapper.vue'
 
 const { frontmatter } = useData()
 const layout = computed(() => frontmatter.value.layout)
@@ -86,11 +81,6 @@ const openTransition = useDarkTransitionConfig()
       <!-- 评论 -->
       <ClientOnly>
         <BlogButtonAfterArticle />
-        <BlogBackToTop />
-        <BlogCommentWrapper>
-          <CommentArtalk />
-          <CommentGiscus />
-        </BlogCommentWrapper>
       </ClientOnly>
     </template>
     <template #layout-bottom>

package/src/composables/config/index.ts

@@ -1,5 +1,6 @@
 /* eslint-disable ts/no-namespace */
 import type { DefaultTheme } from 'vitepress'
+import type { BackToTopPluginOptions } from 'vitepress-plugin-back2top'
 import type { RSSOptions } from 'vitepress-plugin-rss'
 import type { Mapping, Repo } from '@giscus/vue'
 import type { Options as Oml2dOptions } from 'oh-my-live2d'
@@ -109,6 +110,7 @@ export namespace Theme {
     inputPosition?: 'top' | 'bottom'
     lang?: string
     loading?: 'lazy' | 'eager'
+    showCommentBtn?: boolean
   }
   export interface ArtalkOption {
     site: string
@@ -528,18 +530,7 @@ export namespace Theme {
      */
     weeksAgo?: string
   } | ((date: Date | string) => string)
-  export interface BackToTop {
-    /**
-     * 距离顶部多少距离出现
-     * @default 450
-     */
-    top?: number
-
-    /**
-     * 设置展示图标，svg
-     * @recommend https://iconbuddy.app/search?q=fire
-     */
-    icon?: string
+  export interface BackToTop extends BackToTopPluginOptions {
   }
 
   export interface TaskCheckbox {

package/src/utils/node/theme.ts

@@ -128,14 +128,14 @@ export async function getArticles(cfg: Partial<Theme.BlogConfig>, vpConfig: Site
 
 export function patchVPConfig(vpConfig: any, cfg?: Partial<Theme.BlogConfig>) {
   vpConfig.head = vpConfig.head || []
-  // Artalk 资源地址
-  if (cfg?.comment && 'type' in cfg.comment && cfg?.comment?.type === 'artalk') {
-    const server = cfg.comment?.options?.server
-    if (server) {
-      vpConfig.head.push(['link', { href: `${server} /dist/Artalk.css`, rel: 'stylesheet' }])
-      vpConfig.head.push(['script', { src: `${server} /dist/Artalk.js`, id: 'artalk-script' }])
-    }
-  }
+  // // Artalk 资源地址
+  // if (cfg?.comment && 'type' in cfg.comment && cfg?.comment?.type === 'artalk') {
+  //   const server = cfg.comment?.options?.server
+  //   if (server) {
+  //     vpConfig.head.push(['link', { href: `${server}/dist/Artalk.css`, rel: 'stylesheet' }])
+  //     vpConfig.head.push(['script', { src: `${server}/dist/Artalk.js`, id: 'artalk-script' }])
+  //   }
+  // }
 }
 
 export function patchVPThemeConfig(

package/src/utils/node/vitePlugins.ts

@@ -6,6 +6,9 @@ import { RssPlugin } from 'vitepress-plugin-rss'
 import type { PluginOption } from 'vite'
 import { cacheAllGitTimestamps, joinPath } from '@sugarat/theme-shared'
 import { AnnouncementPlugin } from 'vitepress-plugin-announcement'
+import { artalkPlugin } from 'vitepress-plugin-artalk'
+import { back2topPlugin } from 'vitepress-plugin-back2top'
+import { giscusPlugin } from 'vitepress-plugin-giscus'
 import { groupIconVitePlugin } from 'vitepress-plugin-group-icons'
 import { ImagePreviewPlugin } from 'vitepress-plugin-image-preview'
 import type { Theme } from '../../composables/config/index'
@@ -56,6 +59,27 @@ export function getVitePlugins(cfg: Partial<Theme.BlogConfig> = {}) {
     ;[cfg?.RSS].flat().forEach(rssConfig => plugins.push(RssPlugin(rssConfig)))
   }
 
+  // 内置支持 giscus 评论
+  if (cfg?.comment && typeof cfg.comment !== 'boolean') {
+    const commentConfig = cfg.comment
+    const isArtalk = (commentConfig as any).type === 'artalk'
+    if (isArtalk) {
+      plugins.push(artalkPlugin((commentConfig as any).options))
+    }
+    const isGiscus = (commentConfig as any).type === 'giscus' || (commentConfig as any).repo
+    if (isGiscus) {
+      const { mobileMinify, label, icon } = commentConfig
+      const options = {
+        ...(commentConfig as any).options,
+        ...commentConfig,
+        mobileMinify,
+        label,
+        icon
+      }
+      plugins.push(giscusPlugin(options))
+    }
+  }
+
   // 内置支持 全局公告
   if (cfg?.popover) {
     plugins.push(AnnouncementPlugin(cfg.popover))
@@ -76,6 +100,11 @@ export function getVitePlugins(cfg: Partial<Theme.BlogConfig> = {}) {
   if (cfg?.timeline !== false) {
     plugins.push(patchTimelinePlugin())
   }
+  // 内置支持 back-to-top
+  if (cfg?.backToTop !== false) {
+    const options = typeof cfg.backToTop === 'object' ? cfg.backToTop : {}
+    plugins.push(back2topPlugin(options))
+  }
   return plugins
 }
 
@@ -88,6 +117,32 @@ export function patchGroupIconPlugin() {
   })
 }
 
+export function extractDefaultExportString(info: any): string | undefined {
+  // AST 优先：兼容 Literal 与无表达式的 TemplateLiteral
+  const ast: any = info.ast
+  try {
+    if (ast && Array.isArray(ast.body)) {
+      for (const node of ast.body) {
+        if (node.type === 'ExportDefaultDeclaration') {
+          const decl = node.declaration
+          if (decl?.type === 'Literal' && typeof decl.value === 'string') {
+            return decl.value
+          }
+          if (decl?.type === 'TemplateLiteral' && (decl.expressions?.length ?? 0) === 0) {
+            return decl.quasis?.[0]?.value?.cooked
+          }
+        }
+      }
+    }
+  }
+  catch (_) {
+    // 忽略 AST 解析异常，走回退
+  }
+  // 正则回退：兼容 ' " ` 三种引号与空白
+  const m = info.code?.match(/export\s+default\s+(['"`])([\s\S]*?)\1/)
+  return m?.[2]
+}
+
 export function patchTabsPlugin() {
   return createPatchPlugin({
     name: '@sugarat/theme-plugin-patch-tabs',
@@ -214,8 +269,9 @@ export function coverImgTransform() {
       if (!relativePathMap[info.id]) {
         return
       }
-      const asset = info.code?.match(/export default "(.*)"/)?.[1]
+      const asset = extractDefaultExportString(info)
       if (!asset) {
+        console.warn(`[coverImgTransform] 解析默认导出失败: ${info.id}`)
         return
       }