bojuvue 0.4.2 → 0.4.3

package/README.md

@@ -60,6 +60,31 @@ export default {
 The same stylesheet covers every component from both import paths — one import is
 enough regardless of which paths you use.
 
+### VitePress SSR builds
+
+If your site does a production SSR build (VitePress's default `vitepress build`), add
+this package's Vite plugin to your own `.vitepress/config.mts` so the build doesn't
+break:
+
+```ts
+// .vitepress/config.mts
+import { defineConfig } from 'vitepress'
+import { bojuvue } from 'bojuvue/vite'
+
+export default defineConfig({
+  vite: { plugins: [bojuvue()] },
+})
+```
+
+Without it, importing anything from `bojuvue/vitepress` can break your SSR build,
+because Vite externalizes `node_modules` dependencies by default during an SSR build —
+which means this package's own internal `vitepress/theme` import gets resolved by
+Node's raw module loader instead of Vite's, and that fails. The plugin tells Vite to
+bundle this package through its own resolver instead, the same way your site's own
+theme code already resolves an identical import successfully. See
+[#70](https://github.com/ScottKirvan/BojuVue/issues/70) for the full failure mode.
+No component API changes — this is the only thing that changes.
+
 Then in any .md page, no import needed:
 
 ```md

package/dist/vite-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Plugin } from 'vite';
+export declare function bojuvue(): Plugin;

package/dist/vite-plugin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/vite.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(){return{name:`bojuvue`,config:()=>({ssr:{noExternal:[`bojuvue`]}})}}exports.bojuvue=e;

package/dist/vite.js

@@ -0,0 +1,9 @@
+//#region src/vite-plugin.ts
+function e() {
+	return {
+		name: "bojuvue",
+		config: () => ({ ssr: { noExternal: ["bojuvue"] } })
+	};
+}
+//#endregion
+export { e as bojuvue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bojuvue",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "license": "MIT",
   "description": "Vue 3 components including a download button that serves each visitor the right build for their OS. Works in any Vue 3 app; VitePress-aware variants included.",
@@ -27,11 +27,16 @@
       "types": "./dist/vitepress.d.ts",
       "import": "./dist/vitepress.js"
     },
+    "./vite": {
+      "types": "./dist/vite-plugin.d.ts",
+      "import": "./dist/vite.js",
+      "require": "./dist/vite.cjs"
+    },
     "./style.css": "./dist/bojuvue.css",
     "./dist/bojuvue.css": "./dist/bojuvue.css"
   },
   "scripts": {
-    "build": "vue-tsc -b && vite build",
+    "build": "vue-tsc -b && vite build && vite build --config vite.plugin-cjs.config.ts",
     "test": "vitest run"
   },
   "devDependencies": {