@gct-paas/build 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -7,6 +7,18 @@
 
 ## [Unreleased]
 
+## [0.1.16] - 2026-05-28
+
+### Changed
+
+- vite 编译 injectImportMapPlugin 插件支持禁用配置
+
+## [0.1.15] - 2026-05-13
+
+### Added
+
+- 新增 vite 插件，底包编译时注入 banner 显示包名称和版本号
+
 ## [0.1.14] - 2026-05-13
 
 ### Added

package/dist/vite/index.cjs

@@ -69,9 +69,16 @@ Object.defineProperty(exports, "defineWebPluginViteConfig", {
     return _vitePluginConfig.defineWebPluginViteConfig;
   }
 });
+Object.defineProperty(exports, "injectPkgBannerPlugin", {
+  enumerable: true,
+  get: function () {
+    return _injectPkgBannerPlugin.injectPkgBannerPlugin;
+  }
+});
 var _viteBaseConfig = require("./vite-config/vite-base-config.cjs");
 var _viteConfig = require("./vite-config/vite-config.cjs");
 var _viteDevConfig = require("./vite-config/vite-dev-config.cjs");
 var _vitePkgDevConfig = require("./vite-config/vite-pkg-dev-config.cjs");
 var _vitePluginConfig = require("./vite-config/vite-plugin-config.cjs");
-var _viteProjectConfig = require("./vite-config/vite-project-config.cjs");
+var _viteProjectConfig = require("./vite-config/vite-project-config.cjs");
+var _injectPkgBannerPlugin = require("./vite-plugins/inject-pkg-banner-plugin.cjs");

package/dist/vite/index.d.ts

@@ -4,3 +4,4 @@ export { defineDevViteConfig } from './vite-config/vite-dev-config';
 export { definePkgDevViteConfig } from './vite-config/vite-pkg-dev-config';
 export { definePluginViteConfig, defineDesignPluginViteConfig, defineMobilePluginViteConfig, definePadPluginViteConfig, defineWebPluginViteConfig, } from './vite-config/vite-plugin-config';
 export { defineProjectViteConfig } from './vite-config/vite-project-config';
+export { injectPkgBannerPlugin } from './vite-plugins/inject-pkg-banner-plugin';

package/dist/vite/vite-config/vite-config.cjs

@@ -9,6 +9,7 @@ var _vite = require("vite");
 var _path = _interopRequireDefault(require("path"));
 var _vite2 = _interopRequireDefault(require("unocss/vite"));
 var _viteBaseConfig = require("./vite-base-config.cjs");
+var _injectPkgBannerPlugin = require("../vite-plugins/inject-pkg-banner-plugin.cjs");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function defineViteConfig(opts = {}) {
   const cwd = process.cwd();
@@ -37,7 +38,7 @@ function defineViteConfig(opts = {}) {
         fileName: "[name].[format].min"
       }
     },
-    plugins: [(0, _vite2.default)({
+    plugins: [(0, _injectPkgBannerPlugin.injectPkgBannerPlugin)(), (0, _vite2.default)({
       hmrTopLevelAwait: false
     })]
   })), opts);

package/dist/vite/vite-plugins/inject-importmap-plugin.cjs

@@ -11,6 +11,9 @@ var _util = require("../../util/index.cjs");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const DEV_IMPORT_MAP_PREFIX = ["/plugin-design/@id/", "/plugin-render-mobile/@id/", "/plugin-render-pad/@id/", "/plugin-render-web/@id/"];
 function injectImportMapPlugin(options = {}) {
+  if (options.disabled === true) {
+    return void 0;
+  }
   const {
     repoUrl = "https://git.gct-china.com/paas/frontend/gct-paas-cdn.git",
     filePath = "extras/import-map.json",

package/dist/vite/vite-plugins/inject-importmap-plugin.d.ts

@@ -7,21 +7,27 @@ import type { Plugin } from 'vite';
  */
 export interface InjectImportMapPluginOptions {
     /**
-     * 仓库地址，默认为 https://git.gct-china.com/paas/frontend/gct-paas-cdn.git
+     * 是否禁用注入 import-map 配置的插件，默认为 false，即启用注入 import-map 配置的插件，设置为 true 则禁用注入 import-map 配置的插件
      *
      * @type {boolean}
      */
+    disabled?: boolean;
+    /**
+     * 仓库地址，默认为 https://git.gct-china.com/paas/frontend/gct-paas-cdn.git
+     *
+     * @type {string}
+     */
     repoUrl?: string;
     /**
      * 需要读取的文件路径，默认为 extras/import-map.json
      *
-     * @type {boolean}
+     * @type {string}
      */
     filePath?: string;
     /**
      * 指定分支，若未指定则自动获取当前主工程对应的分支
      *
-     * @type {boolean}
+     * @type {string}
      */
     branch?: string;
     /**
@@ -34,4 +40,4 @@ export interface InjectImportMapPluginOptions {
 /**
  * 编译时读取并注入 import-map 配置的插件
  */
-export declare function injectImportMapPlugin(options?: InjectImportMapPluginOptions): Plugin;
+export declare function injectImportMapPlugin(options?: InjectImportMapPluginOptions): Plugin | undefined;

package/dist/vite/vite-plugins/inject-pkg-banner-plugin.cjs

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.injectPkgBannerPlugin = injectPkgBannerPlugin;
+var _nodeFs = _interopRequireDefault(require("node:fs"));
+var _nodePath = _interopRequireDefault(require("node:path"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function injectPkgBannerPlugin() {
+  let banner = "";
+  return {
+    name: "gct-vite-plugin:inject-pkg-banner",
+    apply: "build",
+    buildStart() {
+      const cwd = process.cwd();
+      const pkgPath = _nodePath.default.resolve(cwd, "package.json");
+      try {
+        const pkg = JSON.parse(_nodeFs.default.readFileSync(pkgPath, "utf-8"));
+        const name = pkg.name ?? "";
+        const version = pkg.version ?? "";
+        if (name || version) {
+          banner = `/*! ${name} v${version} */`;
+        }
+      } catch {
+        this.warn("injectPkgBannerPlugin: \u65E0\u6CD5\u8BFB\u53D6 package.json\uFF0C\u8DF3\u8FC7 banner \u6CE8\u5165");
+      }
+    },
+    renderChunk(code) {
+      if (!banner) return null;
+      return {
+        code: `${banner}
+${code}`,
+        map: null
+      };
+    }
+  };
+}

package/dist/vite/vite-plugins/inject-pkg-banner-plugin.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from 'vite';
+/**
+ * 在构建产物的每个 chunk 顶部注入当前包名称与版本信息注释的 Vite 插件
+ * 注入格式：/* {name} v{version} *\/
+ * 便于在浏览器 DevTools 中快速识别包版本
+ *
+ * @export
+ * @return {*}  {Plugin}
+ */
+export declare function injectPkgBannerPlugin(): Plugin;

package/es/vite/index.d.ts

@@ -4,3 +4,4 @@ export { defineDevViteConfig } from './vite-config/vite-dev-config';
 export { definePkgDevViteConfig } from './vite-config/vite-pkg-dev-config';
 export { definePluginViteConfig, defineDesignPluginViteConfig, defineMobilePluginViteConfig, definePadPluginViteConfig, defineWebPluginViteConfig, } from './vite-config/vite-plugin-config';
 export { defineProjectViteConfig } from './vite-config/vite-project-config';
+export { injectPkgBannerPlugin } from './vite-plugins/inject-pkg-banner-plugin';

package/es/vite/index.mjs

@@ -10,3 +10,4 @@ export {
   defineWebPluginViteConfig
 } from "./vite-config/vite-plugin-config.mjs";
 export { defineProjectViteConfig } from "./vite-config/vite-project-config.mjs";
+export { injectPkgBannerPlugin } from "./vite-plugins/inject-pkg-banner-plugin.mjs";

package/es/vite/vite-config/vite-config.mjs

@@ -2,6 +2,7 @@ import { defineConfig, mergeConfig } from "vite";
 import path from "path";
 import UnoCSS from "unocss/vite";
 import { defineViteBaseConfig } from "./vite-base-config.mjs";
+import { injectPkgBannerPlugin } from "../vite-plugins/inject-pkg-banner-plugin.mjs";
 export function defineViteConfig(opts = {}) {
   const cwd = process.cwd();
   return mergeConfig(
@@ -32,6 +33,7 @@ export function defineViteConfig(opts = {}) {
           }
         },
         plugins: [
+          injectPkgBannerPlugin(),
           UnoCSS({ hmrTopLevelAwait: false })
         ]
       })

package/es/vite/vite-plugins/inject-importmap-plugin.d.ts

@@ -7,21 +7,27 @@ import type { Plugin } from 'vite';
  */
 export interface InjectImportMapPluginOptions {
     /**
-     * 仓库地址，默认为 https://git.gct-china.com/paas/frontend/gct-paas-cdn.git
+     * 是否禁用注入 import-map 配置的插件，默认为 false，即启用注入 import-map 配置的插件，设置为 true 则禁用注入 import-map 配置的插件
      *
      * @type {boolean}
      */
+    disabled?: boolean;
+    /**
+     * 仓库地址，默认为 https://git.gct-china.com/paas/frontend/gct-paas-cdn.git
+     *
+     * @type {string}
+     */
     repoUrl?: string;
     /**
      * 需要读取的文件路径，默认为 extras/import-map.json
      *
-     * @type {boolean}
+     * @type {string}
      */
     filePath?: string;
     /**
      * 指定分支，若未指定则自动获取当前主工程对应的分支
      *
-     * @type {boolean}
+     * @type {string}
      */
     branch?: string;
     /**
@@ -34,4 +40,4 @@ export interface InjectImportMapPluginOptions {
 /**
  * 编译时读取并注入 import-map 配置的插件
  */
-export declare function injectImportMapPlugin(options?: InjectImportMapPluginOptions): Plugin;
+export declare function injectImportMapPlugin(options?: InjectImportMapPluginOptions): Plugin | undefined;

package/es/vite/vite-plugins/inject-importmap-plugin.mjs

@@ -4,6 +4,9 @@ import { simpleGit } from "simple-git";
 import { isBuildPluginEnv } from "../../util/index.mjs";
 const DEV_IMPORT_MAP_PREFIX = ["/plugin-design/@id/", "/plugin-render-mobile/@id/", "/plugin-render-pad/@id/", "/plugin-render-web/@id/"];
 export function injectImportMapPlugin(options = {}) {
+  if (options.disabled === true) {
+    return void 0;
+  }
   const {
     repoUrl = "https://git.gct-china.com/paas/frontend/gct-paas-cdn.git",
     filePath = "extras/import-map.json",

package/es/vite/vite-plugins/inject-pkg-banner-plugin.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from 'vite';
+/**
+ * 在构建产物的每个 chunk 顶部注入当前包名称与版本信息注释的 Vite 插件
+ * 注入格式：/* {name} v{version} *\/
+ * 便于在浏览器 DevTools 中快速识别包版本
+ *
+ * @export
+ * @return {*}  {Plugin}
+ */
+export declare function injectPkgBannerPlugin(): Plugin;

package/es/vite/vite-plugins/inject-pkg-banner-plugin.mjs

@@ -0,0 +1,28 @@
+import fs from "node:fs";
+import path from "node:path";
+export function injectPkgBannerPlugin() {
+  let banner = "";
+  return {
+    name: "gct-vite-plugin:inject-pkg-banner",
+    apply: "build",
+    buildStart() {
+      const cwd = process.cwd();
+      const pkgPath = path.resolve(cwd, "package.json");
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        const name = pkg.name ?? "";
+        const version = pkg.version ?? "";
+        if (name || version) {
+          banner = `/*! ${name} v${version} */`;
+        }
+      } catch {
+        this.warn("injectPkgBannerPlugin: \u65E0\u6CD5\u8BFB\u53D6 package.json\uFF0C\u8DF3\u8FC7 banner \u6CE8\u5165");
+      }
+    },
+    renderChunk(code) {
+      if (!banner) return null;
+      return { code: `${banner}
+${code}`, map: null };
+    }
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gct-paas/build",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "description": "paas 平台核心包",
   "main": "dist/index.cjs",