@lark-apaas/fullstack-rspack-preset 1.0.56-alpha.6 → 1.0.56-alpha.7

package/lib/preset.js

@@ -16,6 +16,7 @@ const slardar_performance_monitor_plugin_1 = __importDefault(require("./rspack-p
 const view_context_injection_plugin_1 = __importDefault(require("./rspack-plugins/view-context-injection-plugin"));
 const og_meta_injection_plugin_1 = __importDefault(require("./rspack-plugins/og-meta-injection-plugin"));
 const runtime_injection_plugin_1 = __importDefault(require("./rspack-plugins/runtime-injection-plugin"));
+const basename_injection_plugin_1 = __importDefault(require("./rspack-plugins/basename-injection-plugin"));
 const css_legacy_plugin_1 = __importDefault(require("./rspack-plugins/css-legacy-plugin"));
 const polyfill_plugin_1 = __importDefault(require("./rspack-plugins/polyfill-plugin"));
 const static_assets_plugin_1 = __importDefault(require("./rspack-plugins/static-assets-plugin"));
@@ -222,6 +223,10 @@ function createRecommendRspackConfig(options) {
         plugins: [
             // 运行时注入插件 - 自动将 @lark-apaas/client-toolkit/runtime 注入到所有入口之前
             new runtime_injection_plugin_1.default(),
+            // basename 运行时注入 - 改写入口文件 process.env.CLIENT_BASE_PATH 为运行时读 window.__BASENAME__
+            // 必须在 DefinePlugin 之前生效（plugin 内部 enforce:'pre'）
+            // 匹配 client/src/ 根层级入口文件（index.tsx / main.tsx 等），不影响 SDK 内部代码
+            new basename_injection_plugin_1.default({ envBasePath: clientBasePath }),
             new core_1.default.BannerPlugin({
                 banner: `window.__RELEASE_COMMIT_ID__ = '${releaseId}';`,
                 raw: true,

package/lib/rspack-plugins/basename-injection-loader.d.ts

@@ -0,0 +1,2 @@
+declare function _exports(source: any): any;
+export = _exports;

package/lib/rspack-plugins/basename-injection-loader.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Basename Injection Loader
+ *
+ * 仅由 BasenameInjectionPlugin 在入口文件上挂载，做字符串替换：
+ *   process.env.CLIENT_BASE_PATH
+ *     → ((typeof window !== "undefined" && window.__BASENAME__) || "<envBasePath>")
+ *
+ * loader 阶段天然早于 DefinePlugin 的表达式替换（rspack source-transform → parsing → DefinePlugin 流水线顺序）。
+ * 替换后的字符串里没有 process.env.X 形式，DefinePlugin 不会再二次替换。
+ */
+module.exports = function basenameInjectionLoader(source) {
+    const options = (typeof this.getOptions === 'function' ? this.getOptions() : this.query) || {};
+    const envBasePath = options.envBasePath || '';
+    if (typeof source !== 'string' || !source.includes('process.env.CLIENT_BASE_PATH')) {
+        return source;
+    }
+    const fallback = JSON.stringify(envBasePath);
+    const runtimeExpr = '((typeof window !== "undefined" && window.__BASENAME__) || ' +
+        fallback +
+        ')';
+    return source.replace(/\bprocess\.env\.CLIENT_BASE_PATH\b/g, runtimeExpr);
+};

package/lib/rspack-plugins/basename-injection-plugin.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Basename Injection Plugin for Rspack
+ *
+ * 在 module rules 最前面注入一个 loader，仅匹配应用入口文件，
+ * 把入口里的 process.env.CLIENT_BASE_PATH
+ * 改写为运行时读 window.__BASENAME__（fallback 到构建时常量）。
+ *
+ * 让 BrowserRouter basename 运行时动态化，实现同一份 bundle 跑在不同 basename 下
+ * （默认域名 `/app/<appId>`、自定义域名 `/` 或 `/<alias>`）。
+ *
+ * 入口文件识别：在 entryOption hook（配置已完全解析合并）中从 entry 提取业务入口路径，
+ * 过滤掉 node_modules 包名（runtime 注入、polyfill 等非业务入口）和 Module Federation
+ * 远程模块，生成精确匹配正则。兜底到 client/src/index.{tsx,ts,jsx,js} 正则。
+ *
+ * 关键约束：
+ *   - 只匹配入口文件，不影响 SDK 内部代码（如 client-toolkit-lite 仍读编译期常量）
+ *   - loader 阶段天然早于 DefinePlugin 的表达式替换（rspack 内部 source-transform → parsing → DefinePlugin 流水线顺序）
+ *     enforce:'pre' 是用来跟 babel-loader / swc-loader 等其他 loader 抢先，避免被它们先处理掉表达式
+ *   - 兜底常量来自构建时 process.env.CLIENT_BASE_PATH，保证降级运行
+ */
+import type { Compiler } from '@rspack/core';
+export interface BasenameInjectionPluginOptions {
+    /** 编译时兜底 basename，通常等于 process.env.CLIENT_BASE_PATH */
+    envBasePath?: string;
+}
+export declare class BasenameInjectionPlugin {
+    private readonly envBasePath;
+    constructor(options?: BasenameInjectionPluginOptions);
+    apply(compiler: Compiler): void;
+}
+export default BasenameInjectionPlugin;

package/lib/rspack-plugins/basename-injection-plugin.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Basename Injection Plugin for Rspack
+ *
+ * 在 module rules 最前面注入一个 loader，仅匹配应用入口文件，
+ * 把入口里的 process.env.CLIENT_BASE_PATH
+ * 改写为运行时读 window.__BASENAME__（fallback 到构建时常量）。
+ *
+ * 让 BrowserRouter basename 运行时动态化，实现同一份 bundle 跑在不同 basename 下
+ * （默认域名 `/app/<appId>`、自定义域名 `/` 或 `/<alias>`）。
+ *
+ * 入口文件识别：在 entryOption hook（配置已完全解析合并）中从 entry 提取业务入口路径，
+ * 过滤掉 node_modules 包名（runtime 注入、polyfill 等非业务入口）和 Module Federation
+ * 远程模块，生成精确匹配正则。兜底到 client/src/index.{tsx,ts,jsx,js} 正则。
+ *
+ * 关键约束：
+ *   - 只匹配入口文件，不影响 SDK 内部代码（如 client-toolkit-lite 仍读编译期常量）
+ *   - loader 阶段天然早于 DefinePlugin 的表达式替换（rspack 内部 source-transform → parsing → DefinePlugin 流水线顺序）
+ *     enforce:'pre' 是用来跟 babel-loader / swc-loader 等其他 loader 抢先，避免被它们先处理掉表达式
+ *   - 兜底常量来自构建时 process.env.CLIENT_BASE_PATH，保证降级运行
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasenameInjectionPlugin = void 0;
+const path_1 = __importDefault(require("path"));
+const PLUGIN_NAME = 'BasenameInjectionPlugin';
+const FALLBACK_ENTRY_REGEX = /[/\\]client[/\\]src[/\\]index\.(tsx?|jsx?)$/;
+/**
+ * 判断 import 路径是否为本地业务文件（相对路径或绝对路径），
+ * 排除 node_modules 包名（runtime 注入、polyfill、HMR client 等）。
+ */
+function isLocalFile(imp) {
+    return imp.startsWith('.') || imp.startsWith('/');
+}
+/**
+ * 从 entry 配置中提取所有本地业务入口文件的绝对路径。
+ *
+ * entry 结构（entryOption hook 阶段已规范化）：
+ *   { main: { import: ['@lark-apaas/client-toolkit/runtime', './client/src/index.tsx'] } }
+ *
+ * 过滤规则：
+ *   - 跳过非本地路径（node_modules 包名，如 runtime 注入、polyfill、HMR client）
+ *   - 跳过 node_modules 内的文件（Module Federation 远程模块等）
+ */
+function resolveEntryFiles(entry, context) {
+    const files = [];
+    for (const descriptor of Object.values(entry)) {
+        const imports = descriptor.import;
+        if (!Array.isArray(imports))
+            continue;
+        for (const imp of imports) {
+            if (!isLocalFile(imp))
+                continue;
+            const resolved = path_1.default.resolve(context, imp);
+            if (resolved.includes('node_modules'))
+                continue;
+            files.push(resolved);
+        }
+    }
+    return files;
+}
+/**
+ * 构建入口文件匹配正则：精确匹配 resolved 路径，无路径时兜底默认正则。
+ * 路径分隔符统一用 [/\\] 匹配，避免跨平台问题（rspack 传给 test 的路径分隔符不确定）。
+ */
+function buildEntryTest(entryFiles) {
+    if (entryFiles.length === 0)
+        return FALLBACK_ENTRY_REGEX;
+    const escaped = entryFiles.map(f => {
+        return path_1.default.normalize(f)
+            .split(path_1.default.sep) // 按平台分隔符拆段
+            .map(seg => seg.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')) // 每段转义正则特殊字符
+            .join('[/\\\\]'); // 用 [/\\] 重新拼接
+    });
+    return new RegExp(`(${escaped.join('|')})$`);
+}
+class BasenameInjectionPlugin {
+    constructor(options = {}) {
+        this.envBasePath = options.envBasePath ?? process.env.CLIENT_BASE_PATH ?? '';
+    }
+    apply(compiler) {
+        const loaderPath = path_1.default.resolve(__dirname, './basename-injection-loader.js');
+        const envBasePath = this.envBasePath;
+        // entryOption hook：配置已完全解析合并（包括异步 entry 函数的返回值），
+        // 是读 entry 最安全的时机。参考 RuntimeInjectionPlugin 的做法。
+        compiler.hooks.entryOption.tap(PLUGIN_NAME, (context, entry) => {
+            // 动态 entry（函数形式）无法在此阶段解析，兜底到默认正则
+            const entryFiles = (typeof entry !== 'function')
+                ? resolveEntryFiles(entry, context)
+                : [];
+            const entryTest = buildEntryTest(entryFiles);
+            if (!compiler.options.module) {
+                compiler.options.module = { rules: [] };
+            }
+            const rules = compiler.options.module.rules || [];
+            compiler.options.module.rules = [
+                {
+                    test: entryTest,
+                    enforce: 'pre',
+                    use: [
+                        {
+                            loader: loaderPath,
+                            options: { envBasePath },
+                        },
+                    ],
+                },
+                ...rules,
+            ];
+        });
+    }
+}
+exports.BasenameInjectionPlugin = BasenameInjectionPlugin;
+exports.default = BasenameInjectionPlugin;

package/lib/rspack-plugins/source-map-upload-plugin.js

@@ -68,19 +68,25 @@ class SourceMapUploadPlugin {
                     if (!fs.existsSync(destinationDir)) {
                         fs.mkdirSync(destinationDir, { recursive: true });
                     }
-                    // The asset source may be a Buffer or a string.
-                    const source = sourceMap.source.source();
-                    const sourceBuffer = Buffer.isBuffer(source) ? source : Buffer.from(source, 'utf-8');
-                    fs.writeFileSync(destinationPath, sourceBuffer);
-                    console.log(`SourceMapUploadPlugin: Consolidated ${assetName} to ${destinationPath}`);
-                    // Delete the original sourcemap file.
+                    // Move the file; fallback to copy+delete on cross-filesystem (EXDEV)
                     try {
-                        fs.unlinkSync(originalPath);
-                        console.log(`SourceMapUploadPlugin: Deleted original sourcemap ${originalPath}`);
+                        fs.renameSync(originalPath, destinationPath);
                     }
-                    catch (deleteError) {
-                        console.warn(`SourceMapUploadPlugin: Failed to delete original sourcemap ${originalPath}.`, deleteError);
+                    catch (renameError) {
+                        if (renameError.code === 'EXDEV') {
+                            fs.copyFileSync(originalPath, destinationPath);
+                            try {
+                                fs.unlinkSync(originalPath);
+                            }
+                            catch (deleteError) {
+                                console.warn(`SourceMapUploadPlugin: Failed to delete original sourcemap ${originalPath}.`, deleteError);
+                            }
+                        }
+                        else {
+                            throw renameError;
+                        }
                     }
+                    console.log(`SourceMapUploadPlugin: Consolidated ${assetName} to ${destinationPath}`);
                 }
                 catch (error) {
                     const errorMessage = `SourceMapUploadPlugin: Failed to consolidate ${assetName}.`;

package/lib/rspack-plugins/view-context-injection-plugin.js

@@ -79,5 +79,6 @@ function getViewContextScriptContent() {
         if (appInfo.name) {
           window._appInfo = appInfo;
         }
+        window.__BASENAME__ = "{{basename}}";
     `;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-rspack-preset",
-  "version": "1.0.56-alpha.6",
+  "version": "1.0.56-alpha.7",
   "files": [
     "lib",
     "patches",