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

package/README.md

@@ -7,6 +7,7 @@
 - 开发态通过 dev server 提供 `version.json`
 - 构建后在输出目录生成 `version.json`
 - 普通 Vite HTML 自动注入 `window["__VERSION__"]`
+- 可选通过 `define` 将同一份 payload 编译进 JS 产物
 - VitePress 可通过顶层 `transformHtml` 注入同一份版本信息
 - 支持自定义版本号、输出文件名、全局变量名、时区和额外字段
 
@@ -127,6 +128,7 @@ type BuildVersionContext = {
 type BuildVersionPluginOptions = {
   filename?: string
   globalName?: string
+  defineName?: string | false
   injectToHtml?: boolean
   timeZone?: string
   version?: string | number | ((ctx: BuildVersionContext) => string | number)
@@ -180,6 +182,36 @@ dist/meta/version.json
 
 这里注入的是完整 payload 对象，不是单独版本字符串。
 
+### `defineName`
+
+- 类型：`string | false`
+- 默认值：`"__VERSION__"`
+- 作用：控制是否通过 Vite `define` 将完整 payload 编译进 JS 产物
+
+示例：
+
+```ts
+buildVersionPlugin({
+  defineName: '__APP_VERSION__'
+})
+```
+
+业务代码可直接读取：
+
+```ts
+console.log(__APP_VERSION__)
+```
+
+打包后会在编译阶段被替换成字面量对象，因此适合给 Vue、TS、JS 模块直接消费。
+
+默认情况下会注入 `__VERSION__`。如果你不需要编译期常量，可显式传 `defineName: false` 关闭。
+
+如果同时开启 `defineName` 和 `globalName`，两者会共用同一份 payload：
+
+- `defineName` 写入编译后的 JS
+- `globalName` 注入运行时 HTML
+- `version.json` 仍照常输出
+
 ### `injectToHtml`
 
 - 类型：`boolean`

package/dist/index.cjs

@@ -29,6 +29,7 @@ var import_node_path = require("path");
 var PLUGIN_NAME = "vite-plugin-build-version-file";
 var DEFAULT_FILENAME = "version.json";
 var DEFAULT_GLOBAL_NAME = "__VERSION__";
+var DEFAULT_DEFINE_NAME = "__VERSION__";
 var DEFAULT_TIME_ZONE = "Asia/Shanghai";
 function createDefaultVersion(command, timeZone) {
   if (command === "serve") {
@@ -70,6 +71,15 @@ function normalizeGlobalName(globalName) {
   }
   return globalName;
 }
+function normalizeDefineName(defineName) {
+  if (defineName === false || defineName === void 0) {
+    return defineName ?? false;
+  }
+  if (!defineName.trim()) {
+    throw new Error(`[${PLUGIN_NAME}] "defineName" cannot be empty.`);
+  }
+  return defineName;
+}
 function normalizeTimeZone(timeZone) {
   const normalized = timeZone.trim();
   if (!normalized) {
@@ -154,6 +164,9 @@ function toRequestPath(base, fileName) {
   const baseWithoutTrailingSlash = withLeadingSlash.endsWith("/") ? withLeadingSlash.slice(0, -1) : withLeadingSlash;
   return `${baseWithoutTrailingSlash}/${fileName}`.replace(/\/{2,}/g, "/");
 }
+function resolveProjectRoot(root) {
+  return root ? (0, import_node_path.resolve)(process.cwd(), root) : process.cwd();
+}
 function resolveVersion(options, context, timeZone) {
   if (typeof options.version === "function") {
     return options.version(context);
@@ -180,6 +193,9 @@ function buildVersionPlugin(options = {}) {
   const globalName = normalizeGlobalName(
     options.globalName ?? DEFAULT_GLOBAL_NAME
   );
+  const defineName = normalizeDefineName(
+    options.defineName ?? DEFAULT_DEFINE_NAME
+  );
   const injectToHtml = options.injectToHtml ?? true;
   const timeZone = normalizeTimeZone(options.timeZone ?? DEFAULT_TIME_ZONE);
   const data = normalizeData(options.data);
@@ -193,6 +209,24 @@ function buildVersionPlugin(options = {}) {
   };
   const plugin = {
     name: PLUGIN_NAME,
+    config(userConfig, env) {
+      if (!payload) {
+        const context = {
+          command: env.command,
+          mode: env.mode
+        };
+        const packageInfo = readPackageInfo(resolveProjectRoot(userConfig.root));
+        payload = createPayload(options, context, data, timeZone, packageInfo);
+      }
+      if (!defineName || !payload) {
+        return void 0;
+      }
+      return {
+        define: {
+          [defineName]: JSON.stringify(payload)
+        }
+      };
+    },
     configResolved(config) {
       skipBundleEmit = Boolean(config.build.ssr) && !config.build.ssrEmitAssets;
       if (payload) {

package/dist/index.d.cts

@@ -12,6 +12,7 @@ interface BuildVersionPayload {
 interface BuildVersionPluginOptions {
     filename?: string;
     globalName?: string;
+    defineName?: string | false;
     injectToHtml?: boolean;
     timeZone?: string;
     version?: string | number | ((ctx: BuildVersionContext) => string | number);

package/dist/index.d.ts

@@ -12,6 +12,7 @@ interface BuildVersionPayload {
 interface BuildVersionPluginOptions {
     filename?: string;
     globalName?: string;
+    defineName?: string | false;
     injectToHtml?: boolean;
     timeZone?: string;
     version?: string | number | ((ctx: BuildVersionContext) => string | number);

package/dist/index.mjs

@@ -1,9 +1,10 @@
 // src/index.ts
 import { existsSync, readFileSync } from "fs";
-import { dirname, join } from "path";
+import { dirname, join, resolve } from "path";
 var PLUGIN_NAME = "vite-plugin-build-version-file";
 var DEFAULT_FILENAME = "version.json";
 var DEFAULT_GLOBAL_NAME = "__VERSION__";
+var DEFAULT_DEFINE_NAME = "__VERSION__";
 var DEFAULT_TIME_ZONE = "Asia/Shanghai";
 function createDefaultVersion(command, timeZone) {
   if (command === "serve") {
@@ -45,6 +46,15 @@ function normalizeGlobalName(globalName) {
   }
   return globalName;
 }
+function normalizeDefineName(defineName) {
+  if (defineName === false || defineName === void 0) {
+    return defineName ?? false;
+  }
+  if (!defineName.trim()) {
+    throw new Error(`[${PLUGIN_NAME}] "defineName" cannot be empty.`);
+  }
+  return defineName;
+}
 function normalizeTimeZone(timeZone) {
   const normalized = timeZone.trim();
   if (!normalized) {
@@ -129,6 +139,9 @@ function toRequestPath(base, fileName) {
   const baseWithoutTrailingSlash = withLeadingSlash.endsWith("/") ? withLeadingSlash.slice(0, -1) : withLeadingSlash;
   return `${baseWithoutTrailingSlash}/${fileName}`.replace(/\/{2,}/g, "/");
 }
+function resolveProjectRoot(root) {
+  return root ? resolve(process.cwd(), root) : process.cwd();
+}
 function resolveVersion(options, context, timeZone) {
   if (typeof options.version === "function") {
     return options.version(context);
@@ -155,6 +168,9 @@ function buildVersionPlugin(options = {}) {
   const globalName = normalizeGlobalName(
     options.globalName ?? DEFAULT_GLOBAL_NAME
   );
+  const defineName = normalizeDefineName(
+    options.defineName ?? DEFAULT_DEFINE_NAME
+  );
   const injectToHtml = options.injectToHtml ?? true;
   const timeZone = normalizeTimeZone(options.timeZone ?? DEFAULT_TIME_ZONE);
   const data = normalizeData(options.data);
@@ -168,6 +184,24 @@ function buildVersionPlugin(options = {}) {
   };
   const plugin = {
     name: PLUGIN_NAME,
+    config(userConfig, env) {
+      if (!payload) {
+        const context = {
+          command: env.command,
+          mode: env.mode
+        };
+        const packageInfo = readPackageInfo(resolveProjectRoot(userConfig.root));
+        payload = createPayload(options, context, data, timeZone, packageInfo);
+      }
+      if (!defineName || !payload) {
+        return void 0;
+      }
+      return {
+        define: {
+          [defineName]: JSON.stringify(payload)
+        }
+      };
+    },
     configResolved(config) {
       skipBundleEmit = Boolean(config.build.ssr) && !config.build.ssrEmitAssets;
       if (payload) {

package/package.json

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