vite-plugin-build-version-file 0.1.10 → 0.1.11

package/README.md

@@ -78,6 +78,8 @@ export default defineConfig({
 
 注意：这里必须复用同一个 `buildVersion` 实例。不要分别调用两次 `buildVersionPlugin()`，否则 `transformHtml` 拿不到 Vite 插件阶段生成的 payload。
 
+VitePress 构建会包含 client bundle 和 SSR bundle。插件只在最终静态产物 bundle 输出 `version.json`，避免同一次 VitePress build 出现重复日志或重复 emit。
+
 ## 默认行为
 
 默认配置下，插件会做这些事：
@@ -387,6 +389,23 @@ pnpm build:fixture
 pnpm build:vitepress
 ```
 
+完整检查打包流程：
+
+```bash
+pnpm build
+pnpm build:fixture
+pnpm build:vitepress
+npm pack --dry-run
+```
+
+建议检查：
+
+- `debug/fixture-app/dist/version.json` 包含 `time`、`env`、`pkgName`、`pkgVersion`
+- `debug/fixture-app/dist/index.html` 只注入一次 `window["__VERSION__"]`
+- `debug/vitepress-app/.vitepress/dist/meta/version.json` 包含 `fixture`、`time`、`env`
+- VitePress 每个 HTML 只注入一次 `window["__VERSION__"]`
+- VitePress build 日志只输出一次插件 payload
+
 ## 发布
 
 ```bash
@@ -406,6 +425,7 @@ npm publish --access public
 - `version.json` 输出正常
 - 普通 Vite HTML 注入正常
 - VitePress `transformHtml` 接入后注入正常
+- VitePress build 没有重复输出插件 payload 日志
 
 查看最终发包内容：
 
@@ -502,6 +522,8 @@ export default defineConfig({
 
 Use the same `buildVersion` instance in both places. Calling `buildVersionPlugin()` twice creates two isolated instances, and the VitePress `transformHtml` helper will not receive the payload created during the Vite plugin lifecycle.
 
+VitePress build includes a client bundle and an SSR bundle. The plugin emits `version.json` only from the final static bundle, so one VitePress build does not print duplicate payload logs or emit the same asset twice.
+
 ## Default Behavior
 
 With default options, the plugin:
@@ -809,6 +831,23 @@ pnpm build:fixture
 pnpm build:vitepress
 ```
 
+Full local package check:
+
+```bash
+pnpm build
+pnpm build:fixture
+pnpm build:vitepress
+npm pack --dry-run
+```
+
+Check:
+
+- `debug/fixture-app/dist/version.json` contains `time`, `env`, `pkgName`, and `pkgVersion`
+- `debug/fixture-app/dist/index.html` injects `window["__VERSION__"]` once
+- `debug/vitepress-app/.vitepress/dist/meta/version.json` contains `fixture`, `time`, and `env`
+- each VitePress HTML file injects `window["__VERSION__"]` once
+- VitePress build prints the plugin payload log once
+
 ## Publishing
 
 ```bash
@@ -828,6 +867,7 @@ Before publishing, check:
 - `version.json` output
 - normal Vite HTML injection
 - VitePress `transformHtml` injection
+- no duplicate plugin payload logs during VitePress build
 
 Inspect the publish package:
 

package/dist/index.cjs

@@ -184,6 +184,7 @@ function buildVersionPlugin(options = {}) {
   const timeZone = normalizeTimeZone(options.timeZone ?? DEFAULT_TIME_ZONE);
   const data = normalizeData(options.data);
   let payload;
+  let skipBundleEmit = false;
   const transformHtml = (code, ..._args) => {
     if (!injectToHtml || !payload) {
       return void 0;
@@ -193,6 +194,7 @@ function buildVersionPlugin(options = {}) {
   const plugin = {
     name: PLUGIN_NAME,
     configResolved(config) {
+      skipBundleEmit = Boolean(config.build.ssr) && !config.build.ssrEmitAssets;
       if (payload) {
         return;
       }
@@ -235,7 +237,7 @@ function buildVersionPlugin(options = {}) {
       return tags;
     },
     generateBundle() {
-      if (!payload) {
+      if (!payload || skipBundleEmit) {
         return;
       }
       this.emitFile({

package/dist/index.mjs

@@ -159,6 +159,7 @@ function buildVersionPlugin(options = {}) {
   const timeZone = normalizeTimeZone(options.timeZone ?? DEFAULT_TIME_ZONE);
   const data = normalizeData(options.data);
   let payload;
+  let skipBundleEmit = false;
   const transformHtml = (code, ..._args) => {
     if (!injectToHtml || !payload) {
       return void 0;
@@ -168,6 +169,7 @@ function buildVersionPlugin(options = {}) {
   const plugin = {
     name: PLUGIN_NAME,
     configResolved(config) {
+      skipBundleEmit = Boolean(config.build.ssr) && !config.build.ssrEmitAssets;
       if (payload) {
         return;
       }
@@ -210,7 +212,7 @@ function buildVersionPlugin(options = {}) {
       return tags;
     },
     generateBundle() {
-      if (!payload) {
+      if (!payload || skipBundleEmit) {
         return;
       }
       this.emitFile({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-build-version-file",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "A Vite plugin that emits version.json and injects version metadata into HTML.",
   "license": "MIT",
   "type": "module",