@infly/libs 2.0.43 → 2.0.44

package/README.md

@@ -1,35 +1,48 @@
-# npm-package
+# @infly/libs
 
 ## 介绍
 
-基础库
+`@infly/libs` 是不受 Vue、React 等前端框架限制的独立 JavaScript 工具库。包根入口无副作用；HTTP、Token、文件处理、Docker/Compose、通用项目命令等能力可被不同技术栈使用。
+
+Vue 2 专属的 Permission、Vuex store、Vue CLI 预览和 webpack 配置集中在 `adapters/vue2/`，避免核心入口依赖 Vue 项目约定。
 
 ## 注意事项
 
-如需使用第三方库，推荐使用 webpack 进行打包，放入 lib/中使用
+新代码应显式导入 Vue 2 适配路径。原有 `module/Permission.js`、`store/`、`tools/project-preview.js`、`script/index.js` 和 `build/webpack5/` 路径继续作为兼容转发保留。
 
 ## 软件架构
 
-@infly/libs  
-├── bin - 脚本文件暴露为可直接调用的命令  
-│ └── cli.js - 命令入口调用方法判断  
-├── build - 构建相关工具库  
-│ └── build-dist - 项目构建  
-│ └───── zip.js - 压缩构建文件  
-│ └───── index.js - 构建入口  
-│ └── webpack5 - 构建配置封装  
-├── dataInit - 公共枚举  
-├── lib - 第三方库  
-├── module - 模块  
-├── script - 脚本模块  
-│ └── git-automation - git自动化  
-│ └── webhook - 机器人推送  
-├── store - 公共 vuex 模块  
-├── tools - 小工具类型方法  
-├── types - ts 类型说明  
-├── index.js - npm 包初始文件  
-├── package.json - npm 包管理配置, 正常无需 npm install 当前项目的依赖  
-├── webpack.config.js - webpack 配置实现打包第三方库减小体积
+```text
+@infly/libs
+├── index.js                    # 框架无关、无副作用的包根入口
+├── module/                     # HTTP、Token、格式化等通用模块
+├── tools/                      # 文件与项目命令等通用工具
+├── build/
+│   ├── docker/                 # Docker/Compose 工具
+│   ├── build-dist/             # 构建产物处理
+│   ├── build/webpack5/          # Vue 2 webpack 真实实现
+│   └── webpack5/               # 原路径兼容转发
+├── adapters/vue2/
+│   ├── module/Permission.js    # Vue Router/Vuex 权限适配
+│   ├── store/                  # Vuex 模块
+│   ├── project-preview.js      # Vue CLI 预览
+│   ├── script-config.js        # Vue CLI 脚本模板
+│   └── postinstall.js          # 仅 Vue 2 项目执行初始化
+├── bin/cli.js                  # 命令行入口
+└── dataInit/                   # 公共枚举
+```
+
+根入口加载示例：
+
+```javascript
+const inflyLibs = require('@infly/libs');
+```
+
+根入口继续保留历史 `init()` API，但只在显式调用时懒加载 Vue 2 适配器，不会在 `require('@infly/libs')` 时自动执行：
+
+```javascript
+inflyLibs.init();
+```
 
 ## 安装教程
 
@@ -49,57 +62,69 @@ infly-libs build:docker --local --env prod
 可通过可选参数 `--cicd-url` 在构建和镜像推送全部成功后输出蓝色发布系统链接。支持等号和空格两种传参形式：
 
 ```bash
-infly-libs build:docker --local --cicd-url="https://cicd.sutpay.com/view/积分商城/"
+infly-libs build:docker --local --cicd-url="https://deploy.example.com/projects/admin/"
 ```
 
 ```bash
-infly-libs build:docker --local --cicd-url "https://cicd.sutpay.com/view/积分商城/"
+infly-libs build:docker --local --cicd-url "https://deploy.example.com/projects/admin/"
 ```
 
 未传 `--cicd-url` 时保持原有输出。参数值必须是合法的 HTTP/HTTPS URL，且不能包含用户名、密码或控制字符。
 
-## 配置驱动的项目命令
-
-`project` 命令将多平台项目的开发和构建目标从 package scripts 移到项目配置：
-
-```bash
-infly-libs project
-infly-libs project dev
-infly-libs project build
-```
-
-命令从当前目录 `package.json` 的 `infly.targets`、`infly.dev` 和 `infly.build` 读取配置。交互选择会追加“退出”选项；选择退出或按取消键时会正常结束，不执行后续命令。项目命令不支持 `--config` 文件入口。
-
-未指定 action、target 或构建环境时，会在 TTY 中显示单选菜单。CI/CD 必须显式传参：
-
-```bash
-infly-libs project dev --target QDXY
-infly-libs project build --env stage --target SQ223
-```
-
-`--dry-run` 只打印带 `VUE_APP_PLATFORM` 的命令计划。`infly.targets` 推荐使用平台代码数组，例如 `["DEFAULT", "MER", "JXEE"]`；同时兼容对象形式，对象值中的 `label` 只用于交互显示。普通 target 就是注入 `VUE_APP_PLATFORM` 的平台代码，批量构建通过 `build.presets` 组合多个 target。
-
-`dev.command` 以及 `build.before/command/after` 同时支持字符串和参数数组。字符串按空白拆分为可执行文件和参数，不经过 shell；参数本身包含空格时应继续使用数组形式。
-
+## HTTP 环境保护配置
+
+`module/REST.js` 不内置任何项目域名。应用如需在测试环境误连正式接口时告警，应由应用显式注入完整的正式 API 基地址：
+
+```javascript
+const service = createService({
+  productionBaseURLs: ["https://api.example.com"]
+});
+```
+
+未传 `productionBaseURLs` 时不启用该项目级域名判断。
+
+## 配置驱动的项目命令
+
+`project` 命令将多平台项目的开发和构建目标从 package scripts 移到项目配置：
+
+```bash
+infly-libs project
+infly-libs project dev
+infly-libs project build
+```
+
+命令从当前目录 `package.json` 的 `infly.targets`、`infly.dev` 和 `infly.build` 读取配置。交互选择会追加“退出”选项；选择退出或按取消键时会正常结束，不执行后续命令。项目命令不支持 `--config` 文件入口。
+
+未指定 action、target 或构建环境时，会在 TTY 中显示单选菜单。CI/CD 必须显式传参：
+
+```bash
+infly-libs project dev --target QDXY
+infly-libs project build --env stage --target SQ223
+```
+
+`--dry-run` 只打印带 `VUE_APP_PLATFORM` 的命令计划。`infly.targets` 推荐使用平台代码数组，例如 `["DEFAULT", "MER", "JXEE"]`；同时兼容对象形式，对象值中的 `label` 只用于交互显示。普通 target 就是注入 `VUE_APP_PLATFORM` 的平台代码，批量构建通过 `build.presets` 组合多个 target。
+
+`dev.command` 以及 `build.before/command/after` 同时支持字符串和参数数组。字符串按空白拆分为可执行文件和参数，不经过 shell；参数本身包含空格时应继续使用数组形式。
+
 `build.environments` 推荐使用 `选择键:实际 mode` 数组，例如 `["prod:production", "stage:staging"]`；CLI 使用冒号前的值进行选择，并把冒号后的值作为 `--mode` 参数。没有冒号时选择键和 mode 同名。对象形式继续兼容，用于自定义 `label`、`mode` 或 `args`。项目如果自行管理构建入口，应设置 `infly.buildConfigs.manageScripts=false`，避免安装阶段重新写入传统 `build:prod/build:stage`。
 
-### Docker Compose 版本发布
-
-`docker:compose` 面向已有 Compose 文件的镜像版本递增、配置校验和构建，与上面的 Dockerfile/commit-tag `build:docker` 流程互不替代：
-
-```bash
-infly-libs docker:compose --target yhqy --bump patch
-```
-
-默认从当前目录 `package.json` 的 `infly.docker.targets` 读取目标，并以该 package 所在目录解析 Compose 相对路径；省略 `--target` 时在 TTY 中交互选择。`--config` 外部 JS 配置和原有 `--project-dir` + `--file` 直传方式继续兼容。
-
-参数约束：
-
-- `--target`：选择 `infly.docker.targets` 或外部配置中的目标；非交互环境必须显式传入。
-- `--config`：可选的外部 JS 配置文件，使用 `targets.<name>.file` 结构。
-- `--project-dir` + `--file`：不使用 target 配置时的兼容直传方式，Compose 文件不能越出 `project-dir`。
-- `--bump patch`：目前只支持 patch 递增，且 Compose 中必须恰好有一个 `x.y.z` 镜像 tag。
-- `--push`：显式推送；未传时只执行 `docker compose config` 和 `build`。
-- `--dry-run`：只打印版本变化和计划命令，不写文件、不调用 Docker。
-
+### Docker Compose 版本发布
+
+`docker:compose` 面向已有 Compose 文件的镜像版本递增、配置校验和构建，与上面的 Dockerfile/commit-tag `build:docker` 流程互不替代：
+
+```bash
+infly-libs docker:compose --target yhqy --bump patch
+```
+
+默认从当前目录 `package.json` 的 `infly.docker.targets` 读取目标，并以该 package 所在目录解析 Compose 相对路径；省略 `--target` 时在 TTY 中交互选择。`--config` 外部 JS 配置和原有 `--project-dir` + `--file` 直传方式继续兼容。
+
+参数约束：
+
+- `--target`：选择 `infly.docker.targets` 或外部配置中的目标；非交互环境必须显式传入。
+- `--config`：可选的外部 JS 配置文件，使用 `targets.<name>.file` 结构。
+- `--project-dir` + `--file`：不使用 target 配置时的兼容直传方式，Compose 文件不能越出 `project-dir`。
+- `--bump patch`：目前只支持 patch 递增，且 Compose 中必须恰好有一个 `x.y.z` 镜像 tag。
+- `--push`：显式推送；未传时只执行 `docker compose config` 和 `build`。
+- `--dry-run`：只打印版本变化和计划命令，不写文件、不调用 Docker。
+
 构建、校验或推送失败时，命令会恢复原 Compose 内容。公共包不内置 yhqy、qdxy 等业务目标映射；目标配置和单一发布 script 应归 Compose 所在项目所有。

package/adapters/vue2/build/webpack5/inline-runtime-plugin.js

@@ -0,0 +1,35 @@
+// build/InlineRuntimePlugin.js
+class InlineRuntimePlugin {
+  apply(compiler) {
+    compiler.hooks.compilation.tap("InlineRuntimePlugin", (compilation) => {
+      const HtmlWebpackPlugin = compiler.options.plugins.find(
+        (plugin) => plugin.constructor && plugin.constructor.name === "HtmlWebpackPlugin"
+      )?.constructor;
+
+      if (!HtmlWebpackPlugin) return;
+
+      HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tap("InlineRuntimePlugin", (assets) => {
+        assets.headTags = this.inlineRuntime(assets.headTags, compilation.assets);
+        assets.bodyTags = this.inlineRuntime(assets.bodyTags, compilation.assets);
+      });
+    });
+  }
+
+  inlineRuntime(tags, assets) {
+    return tags.map((tag) => {
+      if (tag.tagName === "script" && tag.attributes?.src && /runtime\..*\.js$/.test(tag.attributes.src)) {
+        const filename = tag.attributes.src.replace(/^\//, "");
+        if (assets[filename]) {
+          return {
+            tagName: "script",
+            innerHTML: assets[filename].source(),
+            closeTag: true
+          };
+        }
+      }
+      return tag;
+    });
+  }
+}
+
+module.exports = InlineRuntimePlugin;

package/adapters/vue2/build/webpack5/remove-legacy-assets-plugin.js

@@ -0,0 +1,84 @@
+/**
+ * RemoveLegacyAssetsPlugin
+ * 用于处理 Vue CLI Modern Mode 的 legacy 文件问题
+ * 
+ * 功能：
+ * 1. 在构建前创建占位文件，防止 ModernModePlugin 读取时报错
+ * 2. 在构建时删除 legacy 相关的资源
+ * 3. 在构建完成后清理占位文件
+ */
+
+"use strict";
+
+const fs = require('fs');
+const path = require('path');
+
+class RemoveLegacyAssetsPlugin {
+  constructor(options = {}) {
+    this.options = {
+      legacyFiles: [
+        'legacy-assets-index.html.json',
+        'modern-assets-index.html.json'
+      ],
+      ...options
+    };
+  }
+
+  apply(compiler) {
+    const outputPath = compiler.options.output.path;
+    const { legacyFiles } = this.options;
+
+    // 🔥 Hook 1: 构建开始前创建占位文件
+    compiler.hooks.beforeRun.tapAsync('RemoveLegacyAssetsPlugin', (compiler, callback) => {
+      // 确保输出目录存在
+      if (!fs.existsSync(outputPath)) {
+        fs.mkdirSync(outputPath, { recursive: true });
+      }
+
+      // 创建空数组的 JSON 文件（Vue CLI 期望数组格式）
+      legacyFiles.forEach(file => {
+        const filePath = path.join(outputPath, file);
+        try {
+          fs.writeFileSync(filePath, '[]');
+        } catch (err) {
+          // 忽略创建失败的错误
+          console.warn(`⚠ Failed to create placeholder: ${file}`, err.message);
+        }
+      });
+
+      callback();
+    });
+
+    // 🔥 Hook 2: 构建时删除编译产物中的 legacy 资源
+    compiler.hooks.emit.tapAsync('RemoveLegacyAssetsPlugin', (compilation, callback) => {
+      Object.keys(compilation.assets).forEach(filename => {
+        if (filename.includes('-legacy') || filename.includes('legacy-assets')) {
+          delete compilation.assets[filename];
+        }
+      });
+      callback();
+    });
+
+    // 🔥 Hook 3: 构建完成后清理占位文件
+    compiler.hooks.done.tapAsync('RemoveLegacyAssetsPlugin', (stats, callback) => {
+      // 延迟执行，确保所有读取操作完成
+      setTimeout(() => {
+        legacyFiles.forEach(file => {
+          const filePath = path.join(outputPath, file);
+          try {
+            if (fs.existsSync(filePath)) {
+              fs.unlinkSync(filePath);
+              console.log(`\x1b[32m✓ Cleaned up: ${file}\x1b[0m`);
+            }
+          } catch (err) {
+            // 忽略删除失败的错误
+            console.warn(`⚠ Failed to cleanup: ${file}`, err.message);
+          }
+        });
+        callback();
+      }, 100);
+    });
+  }
+}
+
+module.exports = RemoveLegacyAssetsPlugin;