@infly/libs 2.0.43 → 2.0.45

package/README.md

@@ -1,35 +1,60 @@
-# npm-package
+# @infly/libs
 
 ## 介绍
 
-基础库
+`@infly/libs` 是不受 Vue、React 等前端框架限制的独立 JavaScript 工具库。包根入口无副作用；HTTP、Token、文件处理、Docker/Compose、通用项目命令等能力可被不同技术栈使用。
+
+Vue 2 专属的 Permission、Vuex store、实例 mixin、Vue CLI 预览和 webpack 配置集中在 `adapters/vue2/`，避免核心入口依赖 Vue 项目约定。
 
 ## 注意事项
 
-如需使用第三方库，推荐使用 webpack 进行打包，放入 lib/中使用
+新代码应显式导入 Vue 2 适配路径。Webpack 适配器仅服务脱离
+admin-monorepo 的子模块独立构建；Monorepo 根构建不会调用该实现。
 
 ## 软件架构
 
-@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/             # 构建产物处理
+├── adapters/vue2/
+│   ├── module/file-export.js  # 注入请求与 Element UI 能力的 Vue2 导出 mixin
+│   ├── module/Permission.js    # Vue Router/Vuex 权限适配
+│   ├── store/                  # Vuex 模块
+│   ├── project-preview.js      # Vue CLI 预览
+│   ├── script-config.js        # Vue CLI 脚本模板
+│   ├── vite/                   # Monorepo Vite 定位与兼容入口
+│   ├── webpack5/               # 独立子仓 Webpack 兼容适配器
+│   └── postinstall.js          # 仅 Vue 2 项目执行初始化
+├── bin/cli.js                  # 命令行入口
+└── dataInit/                   # 公共枚举
+```
+
+Vue2 文件导出适配：
+
+```javascript
+import { fileExportMixin } from "@infly/libs/adapters/vue2/module/file-export.js";
+
+Vue.mixin(fileExportMixin);
+```
+
+适配器只负责从 Vue 实例注入 `$axios`、`$message`、`$msgbox` 和 `$loading`；确认、请求与下载流程由 `@infly/ts-libs` 的 `exportFile` 实现。`@infly/ui` 不公开该 mixin。
+
+根入口加载示例：
+
+```javascript
+const inflyLibs = require('@infly/libs');
+```
+
+根入口继续保留历史 `init()` API，但只在显式调用时懒加载 Vue 2 适配器，不会在 `require('@infly/libs')` 时自动执行：
+
+```javascript
+inflyLibs.init();
+```
 
 ## 安装教程
 
@@ -49,57 +74,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/{module → adapters/vue2/module}/Permission.js

@@ -1,5 +1,5 @@
-import Uts from "./Uts";
-import TokenService from "./TokenService";
+import Uts from "../../../module/Uts";
+import TokenService from "./TokenService.js";
 
 /**
  * 路由拦截器

package/{module → adapters/vue2/module}/REST.js

@@ -1,7 +1,23 @@
+/**
+ * REST HTTP 客户端（Vue 2 / axios 生态）
+ *
+ * ⚠️  本模块是 Vue 2 生态专用 axios 封装（依赖 process.env.VUE_APP_BASE_API、
+ *     window.location、TokenService），与 @infly/ts-libs 的 createHttpClient
+ *     （框架无关 fetch 客户端）是并行实现，非代码重复。
+ *
+ *     新项目（React/非 Vue 生态）请使用 @infly/ts-libs createHttpClient。
+ */
 import axios from "axios";
-import Uts from "./Uts.js";
+import Uts from "../../../module/Uts.js";
 import TokenService from "./TokenService.js";
-import { resolveInternalServiceURL } from "./cjs/request-url-rules.cjs";
+import {
+  matchesConfiguredBaseURL,
+  resolveInternalServiceURL
+} from "../../../module/cjs/request-url-rules.js";
+import {
+  normalizeErrorPayload,
+  resolveStatusErrorMessage
+} from "../../../module/cjs/rest-error-rules.js";
 
 const baseURL = process.env.VUE_APP_BASE_API;
 const { env } = Uts.getEnv() || {};
@@ -28,7 +44,7 @@ function remapLocalhostToCurrentHost(url) {
 
     parsed.hostname = window.location.hostname;
     return parsed.toString();
-  } catch (e) {
+  } catch {
     return normalized;
   }
 }
@@ -66,6 +82,7 @@ export function createNotifyDedup(fn, ttl = 500) {
  * @param {Function} config.onLogout 登出回调
  * @param {Object} config.notify  Message-like 对象（如 ElementUI Message），传入后自动应用去重并构建 onNotify
  * @param {Function} config.onNotify 自定义通知回调；若传入 Message-like 对象也可自动识别
+ * @param {String[]} config.productionBaseURLs 由应用注入的正式 API 基地址；测试环境命中时告警
  * @returns {AxiosInstance}
  */
 export function createService(config) {
@@ -78,11 +95,12 @@ export function createService(config) {
     notify,
     onNotify: rawOnNotify,
     getTokenFunc = "getToken",
-    internalServiceURLRules = []
+    internalServiceURLRules = [],
+    productionBaseURLs = []
   } = config || {};
   // 统一在 REST 内部处理 baseURL，避免业务项目重复实现主机替换逻辑。
   const resolvedBaseURL = resolveServiceBaseURL(customBaseURL);
-  const isProdAPI = Uts.contain(["https://api.sutpay.com"], resolvedBaseURL);
+  const isProdAPI = matchesConfiguredBaseURL(resolvedBaseURL, productionBaseURLs);
   const service = axios.create({ baseURL: resolvedBaseURL });
 
   // 统一处理 notify 与 onNotify：
@@ -165,27 +183,21 @@ export function createService(config) {
     (error) => {
       const { response, request } = error || {};
       const { status, data } = response || {};
-      const { error: bufferError } = Uts.transArrayBufferToObj(data) ?? {};
-      const { error: dataError, detail, message } = data || {};
-      const errorMsg = bufferError || dataError || detail || message || `请求失败(${status})`;
+      const normalizedData = Uts.transArrayBufferToObj(data);
+      const backendErrorMsg = normalizeErrorPayload(normalizedData);
+      const errorMsg = backendErrorMsg || `请求失败(${status})`;
+
+      // 让仍按 data.error 读取错误的旧调用方也能兼容 detail/message/msg 返回。
+      if (response && normalizedData !== undefined) {
+        response.data = normalizedData;
+      }
 
       // 添加标识，表示错误已被拦截器处理
       error.handledByInterceptor = true;
 
-      // HTTP 状态码 → 固定提示语映射（400 直接用后端返回的 errorMsg）
-      const STATUS_MESSAGES = {
-        400: errorMsg,
-        401: "登录信息已过期，请重新登录",
-        403: "您没有权限访问，请联系管理员",
-        500: errorMsg || "服务器内部错误，请联系开发人员",
-        502: "网关错误，请稍后重试或联系开发人员",
-        503: "服务暂时不可用，请稍后重试",
-        504: "网关超时，请稍后重试或联系开发人员"
-      };
-
       // 按优先级确定最终提示语，合并为一次 handleNotify 调用
       const notifyMsg =
-        STATUS_MESSAGES[status] ??
+        resolveStatusErrorMessage(status, normalizedData) ??
         (response ? errorMsg : null) ??
         (request ? "网络请求失败，请检查网络连接" : null) ??
         (error.message || "请求配置错误");

package/{module → adapters/vue2/module}/TokenService.js

@@ -1,5 +1,14 @@
+/**
+ * Token 服务（Vue 2 / localStorage 生态）
+ *
+ * ⚠️  本模块是 Vue 2 生态专用（localStorage + cookie + 多 key 支持），
+ *     与 @infly/ts-libs 的 createStorageTokenStore（框架无关 Token 抽象）
+ *     是并行实现，非代码重复。
+ *
+ *     新项目（React/非 Vue 生态）请使用 @infly/ts-libs createStorageTokenStore。
+ */
 // TokenService.js
-import Uts from "./Uts"; // 假设Uts工具类在同级目录或可访问路径
+import Uts from "../../../module/Uts.js"; // 假设Uts工具类在同级目录或可访问路径
 
 let TOKEN_KEY = "accessToken"; // 默认的token键名
 let CHAT_TOKEN_KEY = "chatAccessToken"; // 默认的聊天token键名

package/adapters/vue2/module/file-export.js

@@ -0,0 +1,18 @@
+import { exportFile } from "@infly/ts-libs";
+
+const fileExportMixin = {
+  methods: {
+    async $exportFile(config = {}) {
+      return exportFile({
+        ...config,
+        message: this.$message || config.message || config.Message || {},
+        messageBox:
+          this.$msgbox || config.messageBox || config.MessageBox || {},
+        loading: this.$loading || config.loading || config.Loading || {},
+        request: config.request || this.$axios,
+      });
+    },
+  },
+};
+
+export { fileExportMixin };

package/adapters/vue2/postinstall.js

@@ -0,0 +1,46 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+function resolveProjectRoot({ cwd = process.cwd(), initCwd = process.env.INIT_CWD } = {}) {
+  return path.resolve(initCwd || cwd);
+}
+
+function isVue2Project(projectRoot = resolveProjectRoot()) {
+  return fs.existsSync(path.join(projectRoot, "vue.config.js"));
+}
+
+function initVue2Project(projectRoot = resolveProjectRoot(), dependencies = {}) {
+  if (!isVue2Project(projectRoot)) {
+    return false;
+  }
+
+  const previousCwd = process.cwd();
+  const resolvedProjectRoot = path.resolve(projectRoot);
+
+  try {
+    if (path.resolve(previousCwd) !== resolvedProjectRoot) {
+      process.chdir(resolvedProjectRoot);
+    }
+    const projectPreview = dependencies.projectPreview || require("./project-preview");
+    const buildDist = dependencies.buildDist || require("../../build/build-dist");
+    projectPreview.scriptInit();
+    buildDist.scriptInit();
+    return true;
+  } finally {
+    if (process.cwd() !== previousCwd) {
+      process.chdir(previousCwd);
+    }
+  }
+}
+
+if (require.main === module) {
+  initVue2Project();
+}
+
+module.exports = {
+  initVue2Project,
+  isVue2Project,
+  resolveProjectRoot,
+};

package/adapters/vue2/project-preview.js

@@ -0,0 +1,152 @@
+const fs = require("fs");
+const path = require("path");
+const net = require("net");
+const { execSync } = require("child_process");
+
+const { scriptWrite } = require("../../tools/file-process.js");
+const { previewList } = require("./script-config.js");
+
+const projectRoot = process.cwd().replace(/\\node_modules.*$/g, "");
+const projectPkgPath = path.resolve(projectRoot, "package.json");
+const projectVueConfigPath = path.resolve(projectRoot, "vue.config.js");
+const projectConfig = fs.existsSync(projectVueConfigPath) ? require(projectVueConfigPath) : {};
+const projectPackage = fs.existsSync(projectPkgPath) ? require(projectPkgPath) : {};
+const rawArgv = process.argv.slice(2);
+const args = rawArgv.join(" ");
+
+function getBuildContext() {
+  try {
+    return JSON.parse(process.env.INFLY_BUILD_CONTEXT || "{}");
+  } catch {
+    return {};
+  }
+}
+
+const buildContext = getBuildContext();
+
+global.logColor = global.logColor || {
+  success: "\n\x1b[32m%s\x1b[0m",
+  error: "\n\x1b[31m%s\x1b[0m",
+  warning: "\n\x1b[33m%s\x1b[0m",
+  link: "\x1b[34m%s\x1b[0m",
+  info: "\n\x1b[36m%s\x1b[0m"
+};
+
+const DEFAULT_CONFIG = {
+  port: 9001,
+  publicPath: "/",
+  outputDir: "dist"
+};
+
+function scriptInit() {
+  if (fs.existsSync(projectVueConfigPath)) {
+    return;
+  }
+  scriptWrite(projectPkgPath, previewList);
+}
+
+function isPortAvailable(port) {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+
+    server.listen(port, () => {
+      server.once("close", () => {
+        resolve(true);
+      });
+      server.close();
+    });
+
+    server.on("error", () => {
+      resolve(false);
+    });
+  });
+}
+
+async function findAvailablePort(startPort, maxTries = 10) {
+  for (let i = 0; i < maxTries; i++) {
+    const port = startPort + i;
+    const available = await isPortAvailable(port);
+
+    if (available) {
+      if (i > 0) {
+        console.log(global.logColor.warning, `⚠️  端口 ${startPort} 被占用，使用端口 ${port}`);
+      }
+      return port;
+    }
+  }
+
+  throw new Error(`无法找到可用端口，已尝试从 ${startPort} 到 ${startPort + maxTries - 1}`);
+}
+
+async function init(skipBuild = false) {
+  try {
+    const connect = require("connect");
+    const serveStatic = require("serve-static");
+    const app = connect();
+    const noBuild = skipBuild || rawArgv.includes("--no-build");
+    // Vite 构建：使用 workspace runner 传入的 target 输出目录
+    const useViteOutput = buildContext.outputDir && fs.existsSync(buildContext.outputDir);
+    const { devServer } = projectConfig || {};
+    const { port: devServerPort } = devServer || {};
+    projectConfig.port = devServerPort || DEFAULT_CONFIG.port;
+    const { publicPath, outputDir, port } = {
+      ...DEFAULT_CONFIG,
+      ...projectConfig
+    };
+    const serveDir = useViteOutput ? buildContext.outputDir : outputDir;
+    const baseListenPort = port - 1000;
+
+    if (!noBuild) {
+      buildProject();
+    }
+
+    const listenPort = await findAvailablePort(baseListenPort);
+
+    app.use(
+      publicPath,
+      serveStatic(serveDir, {
+        index: ["index.html", "/"]
+      })
+    );
+
+    const server = app.listen(listenPort, function () {
+      const previewUrl = `http://localhost:${listenPort}${publicPath}`;
+      const targetSuffix = buildContext.targetLabel ? ` (${buildContext.targetLabel})` : '';
+
+      if (buildContext.batchPreview === true || process.env.INFLY_BATCH_PREVIEW === "1") {
+        console.log(global.logColor.link, `${projectPackage.name || path.basename(projectRoot)}${targetSuffix}: ${previewUrl}`);
+        return;
+      }
+
+      console.log(global.logColor.success, `\x1b[42m\x1b[30m DONE \x1b[0m\x1b[32m  项目构建预览，CTRL + C结束：`);
+      console.log(global.logColor.link, previewUrl);
+    });
+
+    server.on("error", (error) => {
+      if (error.code === "EADDRINUSE") {
+        console.log(global.logColor.error, `❌ 端口 ${listenPort} 仍然被占用`);
+      } else {
+        console.log(global.logColor.error, `❌ 服务器启动失败：${error.message}`);
+      }
+    });
+
+    return server;
+  } catch (error) {
+    console.log(global.logColor.error, `❌ 预览项目失败：${error.message}`);
+    throw error;
+  }
+}
+
+function buildProject() {
+  try {
+    execSync(`vue-cli-service build ${args}`, { stdio: "inherit" });
+  } catch (err) {
+    console.error(global.logColor.error, "❌ 构建失败:", err.message);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  init,
+  scriptInit
+};

package/adapters/vue2/script-config.js

@@ -0,0 +1,26 @@
+module.exports = {
+  previewList: [
+    {
+      key: "preview",
+      value: "infly-libs --preview"
+    },
+    {
+      key: "preview:no-build",
+      value: "infly-libs --preview --no-build"
+    }
+  ],
+  buildList: [
+    {
+      key: "build:prod",
+      value: "infly-libs beforeBuild && vue-cli-service build && infly-libs afterBuild"
+    },
+    {
+      key: "build:stage",
+      value: "infly-libs beforeBuild && vue-cli-service build --mode staging --no-module && infly-libs afterBuild"
+    },
+    {
+      key: "build:test",
+      value: "infly-libs beforeBuild && infly-libs afterBuild"
+    }
+  ]
+};

package/adapters/vue2/store/index.js

@@ -0,0 +1 @@
+export { default as user } from "./modules/user";

package/{store → adapters/vue2/store}/modules/user.js

@@ -1,4 +1,4 @@
-import Uts from "../../module/Uts.js";
+import Uts from "../../../../module/Uts.js";
 import TokenService from "../../module/TokenService.js";
 
 const CONFIG = {

package/adapters/vue2/vite/index.js

@@ -0,0 +1,95 @@
+const fs = require("node:fs");
+const path = require("node:path");
+
+function findAdminMonorepoRoot(startDir = process.cwd()) {
+  let directory = path.resolve(startDir);
+  for (;;) {
+    if (
+      fs.existsSync(path.join(directory, "pnpm-workspace.yaml"))
+      && fs.existsSync(path.join(directory, "configs/vite-configs/registry.js"))
+    ) return directory;
+    const parent = path.dirname(directory);
+    if (parent === directory) return null;
+    directory = parent;
+  }
+}
+
+function resolveAppScssImport(importPath, importer, appRoot) {
+  const cleanImporter = importer.replace(/[?#].*$/, "");
+  if (importPath.startsWith("@/")) {
+    return path.resolve(appRoot, "src", importPath.slice(2));
+  }
+  if (importPath.startsWith("./") || importPath.startsWith("../")) {
+    return path.resolve(path.dirname(cleanImporter), importPath);
+  }
+  if (path.isAbsolute(importPath)) return path.resolve(importPath);
+  return null;
+}
+
+function transformScssExportImports(code, importer, options) {
+  const { appRoot, readFile = (file) => fs.readFileSync(file, "utf8") } = options;
+  return code.replace(
+    /import\s+([\w$]+)\s+from\s+(["'])([^"'?]+\.scss)\2\s*;?/g,
+    (statement, binding, quote, importPath) => {
+      const resolved = resolveAppScssImport(importPath, importer, appRoot);
+      if (!resolved) return statement;
+      let scss;
+      try {
+        scss = readFile(resolved);
+      } catch (_) {
+        return statement;
+      }
+      if (typeof scss !== "string") return statement;
+      const exportBlock = scss.match(/:export\s*\{([\s\S]*?)\}/);
+      if (!exportBlock) return statement;
+
+      const variables = new Map();
+      for (const match of scss.matchAll(/^\s*\$([\w-]+)\s*:\s*([^;]+);/gm)) {
+        variables.set(match[1], match[2].trim());
+      }
+      const exported = {};
+      for (const match of exportBlock[1].matchAll(/([\w-]+)\s*:\s*([^;]+);/g)) {
+        const rawValue = match[2].trim();
+        const variableName = rawValue.match(/^\$([\w-]+)$/);
+        exported[match[1]] = variableName && variables.has(variableName[1])
+          ? variables.get(variableName[1])
+          : rawValue;
+      }
+      return `import ${quote}${importPath}${quote};\nconst ${binding} = ${JSON.stringify(exported)};`;
+    },
+  );
+}
+
+function createScssExportCompatPlugin(appRoot) {
+  return {
+    name: "infly-vue2:scss-export-compat",
+    enforce: "pre",
+    transform(code, id) {
+      if (
+        id.includes("node_modules")
+        || (!id.includes(".vue") && !/\.[cm]?[jt]sx?(?:[?#].*)?$/.test(id))
+        || !/import\s+[\w$]+\s+from\s+["'][^"']+\.scss["']/.test(code)
+      ) return null;
+      const transformed = transformScssExportImports(code, id, { appRoot });
+      return transformed === code ? null : { code: transformed, map: null };
+    },
+  };
+}
+
+function addAppRootSassLoadPath(css, appRoot) {
+  if (!css.preprocessorOptions) css.preprocessorOptions = {};
+  if (!css.preprocessorOptions.scss) css.preprocessorOptions.scss = {};
+  const loadPaths = css.preprocessorOptions.scss.loadPaths || [];
+  const resolvedAppRoot = path.resolve(appRoot);
+  css.preprocessorOptions.scss.loadPaths = loadPaths.includes(resolvedAppRoot)
+    ? loadPaths
+    : [...loadPaths, resolvedAppRoot];
+  return css;
+}
+
+module.exports = {
+  addAppRootSassLoadPath,
+  findAdminMonorepoRoot,
+  transformScssExportImports,
+  createScssExportCompatPlugin,
+};