@ruan-cat/vitepress-preset-config 0.7.2 → 0.9.0

package/dist/theme.d.mts

@@ -2,23 +2,18 @@ import * as vue from 'vue';
 import { EnhanceAppContext } from 'vitepress';
 
 /**
- * 一个回调函数 用来暴露变量 实现注册\
- * @deprecated
+ * 一个回调函数 用来暴露变量 实现注册
  */
 interface EnhanceAppCallBack {
     ({ app, router, siteData }: EnhanceAppContext): void;
 }
 /**
- * @deprecated
  */
 interface DefineRuancatPresetThemeParams {
     enhanceAppCallBack?: EnhanceAppCallBack;
 }
-/**
- * 定义默认主题预设
- * @deprecated
- */
-declare function defineRuancatPresetTheme(params?: DefineRuancatPresetThemeParams): {
+/** 默认主题配置 */
+declare const defaultTheme: {
     extends: {
         Layout: vue.DefineComponent;
         enhanceApp: (ctx: EnhanceAppContext) => void;
@@ -29,32 +24,10 @@ declare function defineRuancatPresetTheme(params?: DefineRuancatPresetThemeParam
     enhanceApp({ app, router, siteData }: EnhanceAppContext): void;
 };
 /**
- * 默认布局配置
- * @description
- * 有疑惑 经过测试 该写法会导致找不到主题文件
- */
-declare const defaultLayoutConfig: {
-    "doc-before": () => vue.VNode<vue.RendererNode, vue.RendererElement, {
-        [key: string]: any;
-    }>;
-    "nav-bar-content-after": () => vue.VNode<vue.RendererNode, vue.RendererElement, {
-        [key: string]: any;
-    }>;
-    "nav-screen-content-after": () => vue.VNode<vue.RendererNode, vue.RendererElement, {
-        [key: string]: any;
-    }>;
-    "layout-top": () => vue.VNode<vue.RendererNode, vue.RendererElement, {
-        [key: string]: any;
-    }>[];
-};
-/**
- * 默认 enhanceApp 预设
- * @description
- * 有疑惑 经过测试 该写法会导致找不到主题文件
+ * 定义默认主题预设
  */
-declare function defaultEnhanceAppPreset({ app, router, siteData }: EnhanceAppContext): void;
-/** 默认主题配置 */
-declare const defaultTheme: {
+declare function defineRuancatPresetTheme(params?: DefineRuancatPresetThemeParams): {
+    enhanceApp({ app, router, siteData }: EnhanceAppContext): void;
     extends: {
         Layout: vue.DefineComponent;
         enhanceApp: (ctx: EnhanceAppContext) => void;
@@ -62,18 +35,6 @@ declare const defaultTheme: {
     Layout: () => vue.VNode<vue.RendererNode, vue.RendererElement, {
         [key: string]: any;
     }>;
-    enhanceApp({ app, router, siteData }: EnhanceAppContext): void;
-};
-/**
- * 默认主题配置2
- * @description
- * 从 @sugarat/theme 内学习的配置写法
- */
-declare const defaultTheme2: {
-    Layout: () => vue.VNode<vue.RendererNode, vue.RendererElement, {
-        [key: string]: any;
-    }>;
-    enhanceApp(ctx: EnhanceAppContext): void;
 };
 
-export { type DefineRuancatPresetThemeParams, type EnhanceAppCallBack, defaultEnhanceAppPreset, defaultLayoutConfig, defaultTheme, defaultTheme2, defineRuancatPresetTheme };
+export { type DefineRuancatPresetThemeParams, type EnhanceAppCallBack, defaultTheme, defineRuancatPresetTheme };

package/dist/theme.mjs

@@ -8,41 +8,13 @@ import {
   InjectionKey,
   LayoutMode
 } from "@nolebase/vitepress-plugin-enhanced-readabilities/client";
+import "@nolebase/vitepress-plugin-enhanced-readabilities/client/style.css";
 import { NolebaseHighlightTargetedHeading } from "@nolebase/vitepress-plugin-highlight-targeted-heading/client";
+import "@nolebase/vitepress-plugin-highlight-targeted-heading/client/style.css";
 import { NolebaseGitChangelogPlugin } from "@nolebase/vitepress-plugin-git-changelog/client";
+import "@nolebase/vitepress-plugin-git-changelog/client/style.css";
 import TwoslashFloatingVue from "@shikijs/vitepress-twoslash/client";
-function defineRuancatPresetTheme(params) {
-  return {
-    extends: DefaultTheme,
-    Layout: () => {
-      return h(DefaultTheme.Layout, null, {
-        // https://vitepress.dev/guide/extending-default-theme#layout-slots
-        "doc-before": () => h(NolebaseBreadcrumbs),
-        "nav-bar-content-after": () => h(NolebaseEnhancedReadabilitiesMenu),
-        // 为较窄的屏幕（通常是小于 iPad Mini）添加阅读增强菜单
-        "nav-screen-content-after": () => h(NolebaseEnhancedReadabilitiesScreenMenu),
-        "layout-top": () => [h(NolebaseHighlightTargetedHeading)]
-      });
-    },
-    enhanceApp({ app, router, siteData }) {
-      var _a;
-      app.use(NolebaseGitChangelogPlugin);
-      app.use(TwoslashFloatingVue);
-      app.provide(InjectionKey, {
-        layoutSwitch: {
-          defaultMode: LayoutMode["BothWidthAdjustable"],
-          pageLayoutMaxWidth: {
-            defaultMaxWidth: 85
-          },
-          contentLayoutMaxWidth: {
-            defaultMaxWidth: 95
-          }
-        }
-      });
-      (_a = params == null ? void 0 : params.enhanceAppCallBack) == null ? void 0 : _a.call(params, { app, router, siteData });
-    }
-  };
-}
+import "@shikijs/vitepress-twoslash/style.css";
 var defaultLayoutConfig = {
   // https://vitepress.dev/guide/extending-default-theme#layout-slots
   "doc-before": () => h(NolebaseBreadcrumbs),
@@ -75,39 +47,17 @@ var defaultTheme = {
     defaultEnhanceAppPreset({ app, router, siteData });
   }
 };
-var defaultTheme2 = {
-  ...DefaultTheme,
-  Layout: () => {
-    return h(DefaultTheme.Layout, null, {
-      // https://vitepress.dev/guide/extending-default-theme#layout-slots
-      "doc-before": () => h(NolebaseBreadcrumbs),
-      "nav-bar-content-after": () => h(NolebaseEnhancedReadabilitiesMenu),
-      // 为较窄的屏幕（通常是小于 iPad Mini）添加阅读增强菜单
-      "nav-screen-content-after": () => h(NolebaseEnhancedReadabilitiesScreenMenu),
-      "layout-top": () => [h(NolebaseHighlightTargetedHeading)]
-    });
-  },
-  enhanceApp(ctx) {
-    DefaultTheme.enhanceApp(ctx);
-    ctx.app.use(NolebaseGitChangelogPlugin);
-    ctx.app.use(TwoslashFloatingVue);
-    ctx.app.provide(InjectionKey, {
-      layoutSwitch: {
-        defaultMode: LayoutMode["BothWidthAdjustable"],
-        pageLayoutMaxWidth: {
-          defaultMaxWidth: 85
-        },
-        contentLayoutMaxWidth: {
-          defaultMaxWidth: 95
-        }
-      }
-    });
-  }
-};
+function defineRuancatPresetTheme(params) {
+  return {
+    ...defaultTheme,
+    enhanceApp({ app, router, siteData }) {
+      var _a;
+      defaultTheme.enhanceApp({ app, router, siteData });
+      (_a = params == null ? void 0 : params.enhanceAppCallBack) == null ? void 0 : _a.call(params, { app, router, siteData });
+    }
+  };
+}
 export {
-  defaultEnhanceAppPreset,
-  defaultLayoutConfig,
   defaultTheme,
-  defaultTheme2,
   defineRuancatPresetTheme
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruan-cat/vitepress-preset-config",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "用于给大多数的vitepress项目提供一个预设的配置文件。",
   "homepage": "https://vitepress-preset.ruancat6312.top",
   "types": "./src/config.mts",
@@ -54,10 +54,9 @@
       "types": "./src/config.mts"
     },
     "./theme": {
-      "import": "./dist/theme.mjs",
+      "import": "./src/theme.ts",
       "types": "./src/theme.ts"
     },
-    "./theme.css": "./dist/theme.css",
     "./src/*": "./src/*"
   },
   "keywords": [

package/src/.vitepress/config.mts

@@ -1,7 +1,7 @@
 // 避免直接使用自己的包
 // import { setUserConfig, setGenerateSidebar, addChangelog2doc } from "@ruan-cat/vitepress-preset-config/config";
 // @ts-ignore
-import { setUserConfig, setGenerateSidebar, addChangelog2doc } from "../../src/config.mts";
+import { setUserConfig, setGenerateSidebar, addChangelog2doc } from "../config.mts";
 import { description } from "../../package.json";
 
 addChangelog2doc({

package/src/.vitepress/theme/index.ts

@@ -1,18 +1,6 @@
-// https://vitepress.dev/guide/custom-theme
-import { h } from "vue";
-import type { Theme, EnhanceAppContext } from "vitepress";
-import DefaultTheme from "vitepress/theme";
-import { defaultLayoutConfig, defaultEnhanceAppPreset } from "@ruan-cat/vitepress-preset-config/theme";
+import { defineRuancatPresetTheme } from "@ruan-cat/vitepress-preset-config/theme";
 
-// 导入全部的主题样式
-import "@ruan-cat/vitepress-preset-config/theme.css";
+// 增加用户自定义样式
 import "./style.css";
-export default {
-	extends: DefaultTheme,
-	Layout: () => {
-		return h(DefaultTheme.Layout, null, defaultLayoutConfig);
-	},
-	enhanceApp({ app, router, siteData }: EnhanceAppContext) {
-		defaultEnhanceAppPreset({ app, router, siteData });
-	},
-} satisfies Theme;
+
+export default defineRuancatPresetTheme();

package/src/theme.ts

@@ -3,8 +3,11 @@ import { h } from "vue";
 import type { Theme, EnhanceAppContext } from "vitepress";
 import DefaultTheme from "vitepress/theme";
 
-// 将全部的样式集中在专门的文件内 在tsup内被打包出去
-import "./index.css";
+/**
+ * 警告 将全部的样式集中在专门的文件内 在tsup内被打包出去
+ * 不再对外提供专门的样式
+ */
+// import "./index.css";
 
 // 警告 放弃内部处理该库 直接使用peer对等依赖 不再考虑包装封装该库
 // import { VitepressDemoBox, VitepressDemoPlaceholder } from "@ruan-cat/vitepress-demo-plugin";
@@ -15,88 +18,41 @@ import { NolebaseBreadcrumbs } from "@nolebase/vitepress-plugin-breadcrumbs/clie
 import {
 	NolebaseEnhancedReadabilitiesMenu,
 	NolebaseEnhancedReadabilitiesScreenMenu,
-
 	// https://nolebase-integrations.ayaka.io/pages/zh-CN/integrations/vitepress-plugin-enhanced-readabilities/#如何在-vitepress-中进行配置
 	InjectionKey,
 	type Options,
 	LayoutMode,
 } from "@nolebase/vitepress-plugin-enhanced-readabilities/client";
-// import "@nolebase/vitepress-plugin-enhanced-readabilities/client/style.css";
+import "@nolebase/vitepress-plugin-enhanced-readabilities/client/style.css";
 
 import { NolebaseHighlightTargetedHeading } from "@nolebase/vitepress-plugin-highlight-targeted-heading/client";
-// import "@nolebase/vitepress-plugin-highlight-targeted-heading/client/style.css";
+import "@nolebase/vitepress-plugin-highlight-targeted-heading/client/style.css";
 
 import { NolebaseGitChangelogPlugin } from "@nolebase/vitepress-plugin-git-changelog/client";
-// import "@nolebase/vitepress-plugin-git-changelog/client/style.css";
+import "@nolebase/vitepress-plugin-git-changelog/client/style.css";
 
 import TwoslashFloatingVue from "@shikijs/vitepress-twoslash/client";
-// import "@shikijs/vitepress-twoslash/style.css";
+import "@shikijs/vitepress-twoslash/style.css";
 
 /**
- * 一个回调函数 用来暴露变量 实现注册\
- * @deprecated
+ * 一个回调函数 用来暴露变量 实现注册
  */
 export interface EnhanceAppCallBack {
 	({ app, router, siteData }: EnhanceAppContext): void;
 }
 
 /**
- * @deprecated
  */
 export interface DefineRuancatPresetThemeParams {
 	enhanceAppCallBack?: EnhanceAppCallBack;
 }
 
-/**
- * 定义默认主题预设
- * @deprecated
- */
-export function defineRuancatPresetTheme(params?: DefineRuancatPresetThemeParams) {
-	return {
-		extends: DefaultTheme,
-		Layout: () => {
-			return h(DefaultTheme.Layout, null, {
-				// https://vitepress.dev/guide/extending-default-theme#layout-slots
-				"doc-before": () => h(NolebaseBreadcrumbs),
-				"nav-bar-content-after": () => h(NolebaseEnhancedReadabilitiesMenu),
-				// 为较窄的屏幕（通常是小于 iPad Mini）添加阅读增强菜单
-				"nav-screen-content-after": () => h(NolebaseEnhancedReadabilitiesScreenMenu),
-				"layout-top": () => [h(NolebaseHighlightTargetedHeading)],
-			});
-		},
-		enhanceApp({ app, router, siteData }: EnhanceAppContext) {
-			app.use(NolebaseGitChangelogPlugin);
-			app.use(TwoslashFloatingVue);
-			app.provide(InjectionKey, {
-				layoutSwitch: {
-					defaultMode: LayoutMode["BothWidthAdjustable"],
-					pageLayoutMaxWidth: {
-						defaultMaxWidth: 85,
-					},
-					contentLayoutMaxWidth: {
-						defaultMaxWidth: 95,
-					},
-				},
-			} as Options);
-
-			/**
-			 * 放弃全局注册demo展示组件
-			 * 在生产环境内使用peer对等依赖
-			 */
-			// app.component("VitepressDemoBox", VitepressDemoBox);
-			// app.component("VitepressDemoPlaceholder", VitepressDemoPlaceholder);
-
-			params?.enhanceAppCallBack?.({ app, router, siteData });
-		},
-	} satisfies Theme;
-}
-
 /**
  * 默认布局配置
  * @description
- * 有疑惑 经过测试 该写法会导致找不到主题文件
+ * @private
  */
-export const defaultLayoutConfig = {
+const defaultLayoutConfig = {
 	// https://vitepress.dev/guide/extending-default-theme#layout-slots
 	"doc-before": () => h(NolebaseBreadcrumbs),
 	"nav-bar-content-after": () => h(NolebaseEnhancedReadabilitiesMenu),
@@ -108,9 +64,10 @@ export const defaultLayoutConfig = {
 /**
  * 默认 enhanceApp 预设
  * @description
- * 有疑惑 经过测试 该写法会导致找不到主题文件
+ * 这个函数预期应该作为一个内部函数 不应该对外暴露使用
+ * @private
  */
-export function defaultEnhanceAppPreset({ app, router, siteData }: EnhanceAppContext) {
+function defaultEnhanceAppPreset({ app, router, siteData }: EnhanceAppContext) {
 	app.use(NolebaseGitChangelogPlugin);
 	app.use(TwoslashFloatingVue);
 	app.provide(InjectionKey, {
@@ -124,6 +81,12 @@ export function defaultEnhanceAppPreset({ app, router, siteData }: EnhanceAppCon
 			},
 		},
 	} as Options);
+	/**
+	 * 放弃全局注册demo展示组件
+	 * 在生产环境内使用peer对等依赖
+	 */
+	// app.component("VitepressDemoBox", VitepressDemoBox);
+	// app.component("VitepressDemoPlaceholder", VitepressDemoPlaceholder);
 }
 
 /** 默认主题配置 */
@@ -134,47 +97,20 @@ export const defaultTheme = {
 	},
 	enhanceApp({ app, router, siteData }: EnhanceAppContext) {
 		defaultEnhanceAppPreset({ app, router, siteData });
-		/**
-		 * 放弃全局注册demo展示组件
-		 * 在生产环境内使用peer对等依赖
-		 */
-		// app.component("VitepressDemoBox", VitepressDemoBox);
-		// app.component("VitepressDemoPlaceholder", VitepressDemoPlaceholder);
 	},
 } satisfies Theme;
 
 /**
- * 默认主题配置2
- * @description
- * 从 @sugarat/theme 内学习的配置写法
+ * 定义默认主题预设
  */
-export const defaultTheme2 = {
-	...DefaultTheme,
-	Layout: () => {
-		return h(DefaultTheme.Layout, null, {
-			// https://vitepress.dev/guide/extending-default-theme#layout-slots
-			"doc-before": () => h(NolebaseBreadcrumbs),
-			"nav-bar-content-after": () => h(NolebaseEnhancedReadabilitiesMenu),
-			// 为较窄的屏幕（通常是小于 iPad Mini）添加阅读增强菜单
-			"nav-screen-content-after": () => h(NolebaseEnhancedReadabilitiesScreenMenu),
-			"layout-top": () => [h(NolebaseHighlightTargetedHeading)],
-		});
-	},
-	enhanceApp(ctx: EnhanceAppContext) {
-		DefaultTheme.enhanceApp(ctx);
-
-		ctx.app.use(NolebaseGitChangelogPlugin);
-		ctx.app.use(TwoslashFloatingVue);
-		ctx.app.provide(InjectionKey, {
-			layoutSwitch: {
-				defaultMode: LayoutMode["BothWidthAdjustable"],
-				pageLayoutMaxWidth: {
-					defaultMaxWidth: 85,
-				},
-				contentLayoutMaxWidth: {
-					defaultMaxWidth: 95,
-				},
-			},
-		} as Options);
-	},
-} satisfies Theme;
+export function defineRuancatPresetTheme(params?: DefineRuancatPresetThemeParams) {
+	return {
+		...defaultTheme,
+		enhanceApp({ app, router, siteData }: EnhanceAppContext) {
+			// 回调默认主题内的函数
+			defaultTheme.enhanceApp({ app, router, siteData });
+			// 执行用户传入的回调函数
+			params?.enhanceAppCallBack?.({ app, router, siteData });
+		},
+	} satisfies Theme;
+}

package/dist/theme.css

@@ -1,6 +0,0 @@
-@import "@nolebase/vitepress-plugin-enhanced-readabilities/client/style.css";
-@import "@nolebase/vitepress-plugin-highlight-targeted-heading/client/style.css";
-@import "@nolebase/vitepress-plugin-git-changelog/client/style.css";
-@import "@shikijs/vitepress-twoslash/style.css";
-
-/* src/index.css */