bojuvue 0.4.1 → 0.4.3

package/README.md

@@ -16,6 +16,13 @@ npm install bojuvue
 
 ## Usage
 
+Import the stylesheet once, anywhere in your app's entry point — components render
+with no button skin, no dropdown panel background, and raw-size icons without it:
+
+```ts
+import 'bojuvue/style.css'
+```
+
 ```vue
 <script setup>
 import { BVPlatformButton } from 'bojuvue'
@@ -37,6 +44,7 @@ Works as-is in any Vue 3 app. Building a VitePress site instead? Swap the import
 // .vitepress/theme/index.ts
 import DefaultTheme from 'vitepress/theme'
 import { BVPlatformButton, BVMoreButton, BVButton, BVIconButton } from 'bojuvue/vitepress'
+import 'bojuvue/style.css'
 
 export default {
   extends: DefaultTheme,
@@ -49,6 +57,34 @@ 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.1",
+  "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.",
@@ -26,10 +26,17 @@
     "./vitepress": {
       "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": {