@lark-apaas/fullstack-rspack-preset 1.0.32-alpha.3 → 1.0.32-alpha.30

package/lib/index.js

@@ -70,5 +70,6 @@ function createFullstackRspackConfig(overrides = {}) {
         publicPath,
     });
     // 5. 深度合并用户配置
+    // 注意：runtime 注入由 RuntimeInjectionPlugin 在编译时自动处理
     return (0, webpack_merge_1.merge)(baseConfig, overrides);
 }

package/lib/module-alias/echarts-for-react.d.ts

@@ -0,0 +1,14 @@
+/**
+ * EChartsReact wrapper component
+ * - Automatically converts HSL colors to hex in option
+ * - Removes label.color from funnel series
+ */
+export class EChartsReact extends React.Component<any, any, any> {
+    constructor(props: any);
+    constructor(props: any, context: any);
+    render(): React.CElement<import("echarts-for-react").EChartsReactProps, OriginalReactECharts>;
+}
+export * from "echarts-for-react";
+export default EChartsReact;
+import React from 'react';
+import OriginalReactECharts from 'echarts-for-react';

package/lib/module-alias/echarts-for-react.js

@@ -0,0 +1,137 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EChartsReact = void 0;
+const react_1 = __importDefault(require("react"));
+const echarts_for_react_1 = __importDefault(require("echarts-for-react"));
+const colorjs_io_1 = __importDefault(require("colorjs.io"));
+/**
+ * Convert HSL/HSLA color to hex or rgba
+ */
+function convertColorToHex(color) {
+    if (typeof color !== 'string')
+        return color;
+    const trimmed = color.trim();
+    if (!trimmed.startsWith('hsl')) {
+        return color;
+    }
+    try {
+        const colorObj = new colorjs_io_1.default(trimmed);
+        if (colorObj.alpha < 1) {
+            return colorObj.to('srgb').toString({ format: 'rgba' });
+        }
+        else {
+            return colorObj.to('srgb').toString({ format: 'hex' });
+        }
+    }
+    catch (error) {
+        console.warn(`Failed to convert color: ${color}`, error);
+        return color;
+    }
+}
+function convertColorValue(propValue, visited) {
+    if (typeof propValue === 'string') {
+        return convertColorToHex(propValue);
+    }
+    if (Array.isArray(propValue)) {
+        return propValue.map((item) => typeof item === 'string' ? convertColorToHex(item) : transformColors(item, visited));
+    }
+    return transformColors(propValue, visited);
+}
+/**
+ * Deep traverse object to transform all HSL colors in 'color' property
+ */
+function transformColors(value, visited = new WeakSet()) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value !== 'object')
+        return value;
+    if (visited.has(value))
+        return value;
+    if (value instanceof Date || value instanceof RegExp)
+        return value;
+    visited.add(value);
+    if (Array.isArray(value)) {
+        return value.map((item) => transformColors(item, visited));
+    }
+    const result = {};
+    for (const key in value) {
+        if (!Object.prototype.hasOwnProperty.call(value, key))
+            continue;
+        const propValue = value[key];
+        if (key === 'color') {
+            if (typeof propValue === 'function') {
+                result[key] = (...args) => convertColorValue(propValue(...args), visited);
+            }
+            else {
+                result[key] = convertColorValue(propValue, visited);
+            }
+        }
+        else {
+            result[key] = transformColors(propValue, visited);
+        }
+    }
+    return result;
+}
+/**
+ * Remove label.color and emphasis.label.color from funnel series
+ * to let ECharts use default contrast colors
+ */
+function removeFunnelLabelColor(option) {
+    if (!Array.isArray(option.series))
+        return option;
+    const series = option.series.map((item) => {
+        if (item?.type !== 'funnel')
+            return item;
+        let result = { ...item };
+        // remove label.color
+        if (result.label && typeof result.label === 'object') {
+            const { color: _, ...labelRest } = result.label;
+            result = { ...result, label: labelRest };
+        }
+        // remove emphasis.label.color
+        const emphasis = result.emphasis;
+        if (emphasis?.label && typeof emphasis.label === 'object') {
+            const { color: _, ...emphasisLabelRest } = emphasis.label;
+            result = { ...result, emphasis: { ...emphasis, label: emphasisLabelRest } };
+        }
+        return result;
+    });
+    return { ...option, series };
+}
+/**
+ * EChartsReact wrapper component
+ * - Automatically converts HSL colors to hex in option
+ * - Removes label.color from funnel series
+ */
+class EChartsReact extends react_1.default.Component {
+    render() {
+        const { option, ...rest } = this.props;
+        const transformedOption = option
+            ? removeFunnelLabelColor(transformColors(option))
+            : option;
+        return react_1.default.createElement(echarts_for_react_1.default, {
+            option: transformedOption,
+            ...rest,
+        });
+    }
+}
+exports.EChartsReact = EChartsReact;
+__exportStar(require("echarts-for-react"), exports);
+exports.default = EChartsReact;

package/lib/module-alias/echarts.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Mount echarts to window for debugging
+ */
+export function registerEchartsToWindow(): void;
 export function resgisterEchartsTheme(): void;
 export { default as echarts } from "echarts";
 export * from "echarts";

package/lib/module-alias/echarts.js

@@ -10,21 +10,56 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.echarts = void 0;
+exports.registerEchartsToWindow = registerEchartsToWindow;
 exports.resgisterEchartsTheme = resgisterEchartsTheme;
 var echarts_1 = require("echarts");
 Object.defineProperty(exports, "echarts", { enumerable: true, get: function () { return __importDefault(echarts_1).default; } });
 __exportStar(require("echarts"), exports);
+const echarts = __importStar(require("echarts"));
 const echarts_2 = require("echarts");
 const registry_echarts_theme_1 = require("./registry_echarts_theme");
 let isRegistered = false;
+let isWindowMounted = false;
+/**
+ * Mount echarts to window for debugging
+ */
+function registerEchartsToWindow() {
+    if (isWindowMounted || typeof globalThis.window === 'undefined') {
+        return;
+    }
+    isWindowMounted = true;
+    globalThis.echarts = echarts;
+}
 function resgisterEchartsTheme() {
     // 注册 ud 主题，全局仅注册一次
     if (isRegistered) {
@@ -45,4 +80,5 @@ function resgisterEchartsTheme() {
         }
     }
 }
+registerEchartsToWindow();
 resgisterEchartsTheme();

package/lib/module-alias/registry_echarts_theme.d.ts

@@ -8,9 +8,7 @@ export declare function getCssVariable(varName: string, element?: HTMLElement):
 export declare function generateEChartsTheme(element?: HTMLElement): {
     color: string[];
     backgroundColor: string;
-    textStyle: {
-        color: string;
-    };
+    textStyle: {};
     title: {
         textStyle: {
             color: string;
@@ -352,9 +350,7 @@ export declare function generateEChartsTheme(element?: HTMLElement): {
 export declare function getShadcnEChartsTheme(): {
     color: string[];
     backgroundColor: string;
-    textStyle: {
-        color: string;
-    };
+    textStyle: {};
     title: {
         textStyle: {
             color: string;

package/lib/module-alias/registry_echarts_theme.js

@@ -44,7 +44,7 @@ function generateEChartsTheme(element = document.body) {
         color: chartColors,
         backgroundColor: 'transparent',
         textStyle: {
-            color: foreground,
+        // color: foreground,
         },
         title: {
             textStyle: {

package/lib/overlay/index.js

@@ -129,6 +129,25 @@ function removeAllChildren(element, skip) {
         element.removeChild(childList[i]);
     }
 }
+function getParentOriginFromParams() {
+    try {
+        var params = new URLSearchParams(window.location.search);
+        var origin = params.get('__parentOrigin');
+        if (origin) {
+            sessionStorage.setItem('__parentOrigin', origin);
+            return origin;
+        }
+    }
+    catch (e) {
+        // ignore
+    }
+    try {
+        return sessionStorage.getItem('__parentOrigin') || '';
+    }
+    catch (e) {
+        return '';
+    }
+}
 function getLegacyParentOrigin() {
     const currentOrigin = window.location?.origin || '';
     if (currentOrigin.includes('force.feishuapp.net')) {
@@ -150,7 +169,7 @@ function getLegacyParentOrigin() {
 }
 function sendPostMessage(message, targetOrigin) {
     try {
-        const parentOrigin = process?.env?.FORCE_FRAMEWORK_DOMAIN_MAIN || getLegacyParentOrigin();
+        const parentOrigin = getParentOriginFromParams() || process?.env?.FORCE_FRAMEWORK_DOMAIN_MAIN || getLegacyParentOrigin();
         const origin = targetOrigin || parentOrigin;
         window.parent.postMessage(message, origin);
     }

package/lib/polyfills/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * iOS 兼容性 Polyfills
+ *
+ * 使用 core-js 提供 iOS 15.4 以下版本需要的 polyfill
+ * 此文件会被单独打包成 polyfills.js，按需加载
+ */
+import 'core-js/actual/array/at';
+import 'core-js/actual/string/at';
+import 'core-js/actual/array/find-last';
+import 'core-js/actual/array/find-last-index';
+import 'core-js/actual/object/has-own';
+import 'core-js/actual/promise/any';
+import 'core-js/actual/aggregate-error';
+import 'core-js/actual/structured-clone';

package/lib/polyfills/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * iOS 兼容性 Polyfills
+ *
+ * 使用 core-js 提供 iOS 15.4 以下版本需要的 polyfill
+ * 此文件会被单独打包成 polyfills.js，按需加载
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// ECMAScript polyfills (core-js)
+require("core-js/actual/array/at");
+require("core-js/actual/string/at");
+require("core-js/actual/array/find-last");
+require("core-js/actual/array/find-last-index");
+require("core-js/actual/object/has-own");
+require("core-js/actual/promise/any");
+require("core-js/actual/aggregate-error");
+require("core-js/actual/structured-clone");
+// Web Crypto API polyfill (不在 core-js 范围内)
+if (typeof crypto !== 'undefined' && typeof crypto.randomUUID !== 'function') {
+    Object.defineProperty(crypto, 'randomUUID', {
+        value: function randomUUID() {
+            const bytes = new Uint8Array(16);
+            crypto.getRandomValues(bytes);
+            bytes[6] = (bytes[6] & 0x0f) | 0x40;
+            bytes[8] = (bytes[8] & 0x3f) | 0x80;
+            let hex = '';
+            for (let i = 0; i < 16; i++) {
+                hex += (bytes[i] < 16 ? '0' : '') + bytes[i].toString(16);
+            }
+            return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+        },
+        writable: true,
+        configurable: true,
+    });
+}

package/lib/preset.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createRecommendRspackConfig = createRecommendRspackConfig;
+const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const core_1 = __importDefault(require("@rspack/core"));
 const devtool_kits_1 = require("@lark-apaas/devtool-kits");
@@ -13,6 +14,10 @@ const route_parser_plugin_1 = __importDefault(require("./rspack-plugins/route-pa
 const slardar_performance_monitor_plugin_1 = __importDefault(require("./rspack-plugins/slardar-performance-monitor-plugin"));
 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 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"));
 const source_map_upload_plugin_1 = __importDefault(require("./rspack-plugins/source-map-upload-plugin"));
 const dev_server_snapdom_proxy_1 = require("./utils/dev-server-snapdom-proxy");
 function sendBackendUnavailable502(_err, _req, res) {
@@ -26,14 +31,51 @@ function sendBackendUnavailable502(_err, _req, res) {
 }
 // 检查是否启用宽松 build 模式
 const isLooseMode = process.env.FORCE_FRAMEWORK_BUILD_LOOSE_MODE === 'true';
+function readAppFlags(rootDir) {
+    try {
+        return JSON.parse(fs_1.default.readFileSync(path_1.default.resolve(rootDir, 'package.json'), 'utf-8')).flags || {};
+    }
+    catch {
+        return {};
+    }
+}
 function createRecommendRspackConfig(options) {
     const { isDev = true, enableReactRefresh = isDev, needRoutes = true, clientBasePath = '', publicPath = '', // 静态资源路径
      } = options;
     const assetsCDNPath = publicPath + '/';
     const rootDir = process.cwd();
     const serverPort = process.env.SERVER_PORT || '3000';
+    const appFlags = readAppFlags(rootDir);
+    // 从 clientBasePath（如 /app/app123）中提取 appId，用于构造旧路径代理规则
+    // 仅在新路径格式（/app/:appId）下启用旧路径兼容
+    const isNewPathFormat = /^\/app\/[^/]/.test(clientBasePath);
+    const appId = isNewPathFormat
+        ? clientBasePath.replace(/\/+$/, '').split('/').pop()
+        : '';
+    // 提前创建实例，以便在 plugins 和 setupMiddlewares 中复用
+    const staticAssetsPlugin = new static_assets_plugin_1.default({ clientBasePath, rootDir });
     // 优先从环境变量获取 RELEASE_ID，否则使用时间戳作为兜底
     const releaseId = process.env.RELEASE_ID || new Date().toISOString();
+    // 读取构建前生成的路由定义 JSON，供 DefinePlugin 注入到 bundle
+    // build.sh 在 client 构建之前已将 page-routes.json / api-routes.json 写入 dist/
+    let pageRouteDefinitions = [];
+    let apiRouteDefinitions = [];
+    if (needRoutes) {
+        try {
+            const pageRoutesPath = path_1.default.resolve(rootDir, 'dist/page-routes.json');
+            if (fs_1.default.existsSync(pageRoutesPath)) {
+                pageRouteDefinitions = JSON.parse(fs_1.default.readFileSync(pageRoutesPath, 'utf-8'));
+            }
+        }
+        catch { /* ignore */ }
+        try {
+            const apiRoutesPath = path_1.default.resolve(rootDir, 'dist/api-routes.json');
+            if (fs_1.default.existsSync(apiRoutesPath)) {
+                apiRouteDefinitions = JSON.parse(fs_1.default.readFileSync(apiRoutesPath, 'utf-8'));
+            }
+        }
+        catch { /* ignore */ }
+    }
     return {
         mode: isDev ? 'development' : 'production',
         cache: false,
@@ -43,9 +85,20 @@ function createRecommendRspackConfig(options) {
         resolve: {
             mainFields: ['module', 'browser', 'main'],
             extensions: ['.js', '.jsx', '.ts', '.tsx', '.json'],
+            alias: {
+                // 确保所有 echarts 子路径导入（如 echarts/core, echarts/lib/...）
+                // 都解析到 preset 自带的 echarts，避免第三方扩展（如 echarts-wordcloud）
+                // 安装了独立的 echarts 副本导致注册不到同一个实例上
+                echarts: path_1.default.dirname(require.resolve('echarts/package.json')),
+            },
         },
         module: {
             rules: [
+                // Support ?raw query to import file content as string (like Vite's ?raw)
+                {
+                    resourceQuery: /\?raw$/,
+                    type: 'asset/source',
+                },
                 {
                     test: /\.svg$/,
                     type: 'asset',
@@ -120,11 +173,6 @@ function createRecommendRspackConfig(options) {
                                     transform: {
                                         react: {
                                             runtime: 'automatic',
-                                            ...(isDev
-                                                ? {
-                                                    importSource: path_1.default.dirname(require.resolve('@lark-apaas/miaoda-inspector-jsx-runtime')),
-                                                }
-                                                : {}),
                                             development: isDev,
                                             refresh: enableReactRefresh,
                                         },
@@ -146,14 +194,19 @@ function createRecommendRspackConfig(options) {
             ],
         },
         plugins: [
+            // 运行时注入插件 - 自动将 @lark-apaas/client-toolkit/runtime 注入到所有入口之前
+            new runtime_injection_plugin_1.default(),
             new core_1.default.BannerPlugin({
                 banner: `window.__RELEASE_COMMIT_ID__ = '${releaseId}';`,
                 raw: true,
             }),
-            // 针对 clsx/echarts 等包，让其默认好用
-            new core_1.default.NormalModuleReplacementPlugin(/^(clsx|echarts)$/, function (resource) {
+            // 针对 clsx/echarts/echarts-for-react 等包，让其默认好用
+            new core_1.default.NormalModuleReplacementPlugin(/^(clsx|echarts|echarts-for-react)$/, function (resource) {
                 if (!resource.context.endsWith('module-alias')) {
-                    if (resource.request.endsWith('echarts')) {
+                    if (resource.request === 'echarts-for-react') {
+                        resource.request = require.resolve('./module-alias/echarts-for-react');
+                    }
+                    else if (resource.request === 'echarts') {
                         resource.request = require.resolve('./module-alias/echarts');
                     }
                     else {
@@ -167,6 +220,15 @@ function createRecommendRspackConfig(options) {
                 'process.env.CLIENT_BASE_PATH': JSON.stringify(clientBasePath),
                 'process.env.FORCE_FRAMEWORK_DOMAIN_MAIN': JSON.stringify(process.env.FORCE_FRAMEWORK_DOMAIN_MAIN ?? ''),
                 'process.env.CWD': JSON.stringify(''),
+                // runtime 注入标志位，用于 client-toolkit 兼容性判断
+                'process.env.__RUNTIME_INJECTED__': JSON.stringify('true'),
+                // 构建工具标识，用于 source map 处理逻辑判断
+                'process.env.BUILD_TOOL': JSON.stringify('rspack'),
+                // 模板 flags 配置
+                'process.env.APP_FLAGS': JSON.stringify(appFlags),
+                // 路由定义，供客户端匹配 referer_path 和 api
+                'process.env.__PAGE_ROUTE_DEFINITIONS__': JSON.stringify(JSON.stringify(pageRouteDefinitions)),
+                'process.env.__API_ROUTE_DEFINITIONS__': JSON.stringify(JSON.stringify(apiRouteDefinitions)),
                 // 解决 window 未定义问题
                 'typeof window': JSON.stringify('object'),
                 window: 'globalThis',
@@ -189,17 +251,24 @@ function createRecommendRspackConfig(options) {
                 },
                 minify: false, // 关闭 html 压缩，导致数据注入异常
             }),
+            // 视图上下文注入插件（必须在 slardar 之前，确保 HTML 中 viewContext 先于 slardar）
+            new view_context_injection_plugin_1.default(),
             // 性能监控&tea埋点sdk插件
             new slardar_performance_monitor_plugin_1.default(),
-            // 视图上下文注入插件
-            new view_context_injection_plugin_1.default(),
             // OG Meta 标签注入插件
             new og_meta_injection_plugin_1.default(),
-            // 开发环境下，解析路由
-            isDev && needRoutes &&
+            // 生产环境：生成 legacy CSS 并注入检测脚本
+            !isDev && new css_legacy_plugin_1.default(),
+            // 生产环境：为旧浏览器提供 polyfill（仅在需要时加载）
+            !isDev && new polyfill_plugin_1.default(),
+            // 静态资源插件 - 支持 @shared/static/* 导入
+            staticAssetsPlugin,
+            // 解析路由（dev + prod 均生成 routes.json 和 page-routes.json）
+            needRoutes &&
                 new route_parser_plugin_1.default({
                     appPath: './client/src/app.tsx',
                     outputPath: path_1.default.resolve(rootDir, 'dist/client/routes.json'),
+                    ...(isDev ? { basePath: '' } : {}),
                 }),
             // 热更新
             enableReactRefresh && new plugin_react_refresh_1.default({
@@ -223,10 +292,14 @@ function createRecommendRspackConfig(options) {
                         minimizerOptions: {
                             // 保持不压缩
                             minify: !isDev,
-                            mangle: !isDev,
+                            // mangle 配置：启用 Safari 10 兼容性
+                            mangle: !isDev ? {
+                                safari10: true, // 避免 Safari 严格模式的重复参数问题
+                            } : false,
                             format: {
                                 beautify: isDev,
                                 comments: false,
+                                safari10: true, // Safari 10/11 兼容性修复
                             },
                             compress: {
                                 keep_classnames: true,
@@ -313,6 +386,23 @@ function createRecommendRspackConfig(options) {
                     changeOrigin: true,
                     onError: sendBackendUnavailable502,
                 },
+                // 旧路径（/af/p/:appId）兼容代理，转发到 Node Server 由 legacy-path-redirect 中间件处理
+                ...(appId
+                    ? [
+                        {
+                            context: [`/af/p/${appId}/api`],
+                            target: `http://localhost:${serverPort}`,
+                            changeOrigin: true,
+                            onError: sendBackendUnavailable502,
+                        },
+                        {
+                            context: [`/af/p/${appId}/__innerapi__`],
+                            target: `http://localhost:${serverPort}`,
+                            changeOrigin: true,
+                            onError: sendBackendUnavailable502,
+                        },
+                    ]
+                    : []),
                 {
                     context: (pathname, req) => {
                         // 代理所有请求 HTML 响应的请求（页面路由）
@@ -325,9 +415,7 @@ function createRecommendRspackConfig(options) {
                     changeOrigin: true,
                     logLevel: 'debug',
                     onError: (err, req, res) => (0, devtool_kits_1.handleDevProxyError)(err, req, res, {
-                        logDir: process.env.LOG_DIR || './logs',
-                        logFileName: 'server.std.log',
-                        maxErrorLogs: 100,
+                        target: `http://localhost:${serverPort}`,
                     }),
                 },
             ],
@@ -337,6 +425,8 @@ function createRecommendRspackConfig(options) {
             },
             setupMiddlewares: (middlewares, devServer) => {
                 if (devServer.app) {
+                    // 开发环境下提供 shared/static 文件服务，对齐 Vite preset 的 configureServer 中间件
+                    devServer.app.use(staticAssetsPlugin.createDevMiddleware());
                     (0, dev_server_snapdom_proxy_1.registerSnapDomProxyMiddleware)(devServer.app, { baseUrl: clientBasePath });
                     (0, devtool_kits_1.registerMiddlewares)(devServer.app, [
                         (0, devtool_kits_1.createDevLogsMiddleware)({ logDir: process.env.LOG_DIR || './logs' }),

package/lib/rspack-plugins/css-legacy-plugin.d.ts

@@ -0,0 +1,30 @@
+import type { Compiler } from '@rspack/core';
+/**
+ * CSS Legacy Plugin
+ *
+ * 在构建完成后生成一份兼容旧浏览器的 CSS 文件（.legacy.css）
+ * 并在 HTML 中注入检测脚本，根据浏览器版本加载对应的 CSS
+ */
+export declare class CssLegacyPlugin {
+    static pluginName: string;
+    apply(compiler: Compiler): void;
+    /**
+     * 预处理 CSS：移除/转换 LightningCSS 不支持降级的特性
+     */
+    private preprocessCss;
+    /**
+     * 后处理 CSS：清理可能残留的不支持特性
+     */
+    private postprocessCss;
+    /**
+     * 展开 @layer 规则，保留内部样式
+     */
+    private unwrapAtLayer;
+    /**
+     * 移除 @supports (color: color-mix(...)) 块
+     * 这些是渐进增强代码，旧浏览器可以使用 fallback
+     */
+    private removeColorMixSupports;
+    private generateDetectionScript;
+}
+export default CssLegacyPlugin;