@lark-apaas/fullstack-rspack-preset 1.0.55-alpha.2 → 1.0.55-alpha.20

package/lib/preset.js

@@ -15,6 +15,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"));
@@ -193,6 +194,9 @@ 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'）
+            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,27 @@
+/**
+ * Basename Injection Plugin for Rspack
+ *
+ * 在 module rules 最前面注入一个 loader，仅匹配应用入口文件
+ * （client/src/index.{ts,tsx,js,jsx}），把入口里的 process.env.CLIENT_BASE_PATH
+ * 改写为运行时读 window.__BASENAME__（fallback 到构建时常量）。
+ *
+ * 让 BrowserRouter basename 运行时动态化，实现同一份 bundle 跑在不同 basename 下
+ * （默认域名 `/app/<appId>`、自定义域名 `/` 或 `/<alias>`）。
+ *
+ * 关键约束：
+ *   - 只匹配入口文件，不影响 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,56 @@
+"use strict";
+/**
+ * Basename Injection Plugin for Rspack
+ *
+ * 在 module rules 最前面注入一个 loader，仅匹配应用入口文件
+ * （client/src/index.{ts,tsx,js,jsx}），把入口里的 process.env.CLIENT_BASE_PATH
+ * 改写为运行时读 window.__BASENAME__（fallback 到构建时常量）。
+ *
+ * 让 BrowserRouter basename 运行时动态化，实现同一份 bundle 跑在不同 basename 下
+ * （默认域名 `/app/<appId>`、自定义域名 `/` 或 `/<alias>`）。
+ *
+ * 关键约束：
+ *   - 只匹配入口文件，不影响 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 ENTRY_FILE_REGEX = /[/\\]client[/\\]src[/\\]index\.(tsx?|jsx?)$/;
+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;
+        compiler.hooks.afterEnvironment.tap(PLUGIN_NAME, () => {
+            if (!compiler.options.module) {
+                // 极端兜底：rspack 必定提供 module，这里只是 narrow type
+                compiler.options.module = { rules: [] };
+            }
+            const rules = compiler.options.module.rules || [];
+            compiler.options.module.rules = [
+                {
+                    test: ENTRY_FILE_REGEX,
+                    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.55-alpha.2",
+  "version": "1.0.55-alpha.20",
   "files": [
     "lib",
     "patches",
@@ -31,7 +31,7 @@
     "@babel/parser": "^7.28.0",
     "@babel/traverse": "^7.28.0",
     "@babel/types": "^7.28.2",
-    "@lark-apaas/devtool-kits": "1.2.24-alpha.2",
+    "@lark-apaas/devtool-kits": "^1.2.23",
     "@lark-apaas/miaoda-inspector-babel-plugin": "^1.0.2",
     "@lark-apaas/styled-jsx": "^1.0.1",
     "@rspack/plugin-react-refresh": "^1.5.1",