@lark-apaas/fullstack-rspack-preset 0.1.2-alpha.1 → 0.1.2-alpha.2

package/lib/index.d.ts

@@ -1,2 +1,37 @@
-export { createRecommendRspackConfig } from './preset';
-export type { CreateRecommendRspackConfigOptions } from './preset';
+import type { Configuration } from '@rspack/core';
+/**
+ * 创建 Fullstack Rspack 配置（简化版）
+ *
+ * 自动从环境变量读取配置，用户只需提供覆盖配置
+ *
+ * @param overrides - 用户自定义的 Rspack 配置，会与默认配置深度合并
+ * @returns 完整的 Rspack 配置对象
+ *
+ * @example
+ * ```javascript
+ * const { createFullstackRspackConfig } = require('@lark-apaas/fullstack-rspack-preset');
+ *
+ * module.exports = createFullstackRspackConfig({
+ *   entry: {
+ *     main: './client/src/index.tsx',
+ *   },
+ *   resolve: {
+ *     alias: {
+ *       '@': path.resolve(__dirname, 'client/src'),
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * 支持的环境变量：
+ * - NODE_ENV: development | production (默认: development)
+ * - ENABLE_REACT_REFRESH: true | false (默认: false)
+ * - ENABLE_INSPECTOR: true | false (默认: false)
+ * - NEED_ROUTES: true | false (默认: true)
+ * - CLIENT_BASE_PATH: 客户端基础路径 (默认: /)
+ * - ASSETS_CDN_PATH: 生产环境 CDN 路径 (默认: /)
+ * - SERVER_PORT: 服务器端口 (默认: 3000)
+ * - CLIENT_DEV_PORT: 客户端开发端口 (默认: 8080)
+ */
+export declare function createFullstackRspackConfig(overrides?: Partial<Configuration>): Configuration;
+export default createFullstackRspackConfig;

package/lib/index.js

@@ -1,5 +1,106 @@
 "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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createRecommendRspackConfig = void 0;
-var preset_1 = require("./preset");
-Object.defineProperty(exports, "createRecommendRspackConfig", { enumerable: true, get: function () { return preset_1.createRecommendRspackConfig; } });
+exports.createFullstackRspackConfig = createFullstackRspackConfig;
+const webpack_merge_1 = require("webpack-merge");
+const devtool_kits_1 = require("@lark-apaas/devtool-kits");
+const preset_1 = require("./preset");
+/**
+ * 创建 Fullstack Rspack 配置（简化版）
+ *
+ * 自动从环境变量读取配置，用户只需提供覆盖配置
+ *
+ * @param overrides - 用户自定义的 Rspack 配置，会与默认配置深度合并
+ * @returns 完整的 Rspack 配置对象
+ *
+ * @example
+ * ```javascript
+ * const { createFullstackRspackConfig } = require('@lark-apaas/fullstack-rspack-preset');
+ *
+ * module.exports = createFullstackRspackConfig({
+ *   entry: {
+ *     main: './client/src/index.tsx',
+ *   },
+ *   resolve: {
+ *     alias: {
+ *       '@': path.resolve(__dirname, 'client/src'),
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * 支持的环境变量：
+ * - NODE_ENV: development | production (默认: development)
+ * - ENABLE_REACT_REFRESH: true | false (默认: false)
+ * - ENABLE_INSPECTOR: true | false (默认: false)
+ * - NEED_ROUTES: true | false (默认: true)
+ * - CLIENT_BASE_PATH: 客户端基础路径 (默认: /)
+ * - ASSETS_CDN_PATH: 生产环境 CDN 路径 (默认: /)
+ * - SERVER_PORT: 服务器端口 (默认: 3000)
+ * - CLIENT_DEV_PORT: 客户端开发端口 (默认: 8080)
+ */
+function createFullstackRspackConfig(overrides = {}) {
+    // 1. 自动加载 .env 文件
+    try {
+        Promise.resolve().then(() => __importStar(require('dotenv'))).then((dotenv) => dotenv.config());
+    }
+    catch (e) {
+        // dotenv 是可选依赖，如果没有安装也不影响使用
+    }
+    // 2. 从环境变量读取配置
+    const isDev = process.env.NODE_ENV !== 'production';
+    const enableReactRefresh = process.env.ENABLE_REACT_REFRESH === 'true';
+    // enableInspector 目前在 preset 内部由 isDev 控制，保留环境变量以备后续扩展
+    // const enableInspector = process.env.ENABLE_INSPECTOR === 'true';
+    const needRoutes = process.env.NEED_ROUTES !== 'false'; // 默认 true
+    // 3. 处理路径配置
+    const clientBasePath = (0, devtool_kits_1.normalizeBasePath)(process.env.CLIENT_BASE_PATH || '/');
+    const publicPath = isDev
+        ? (process.env.CLIENT_BASE_PATH || '/')
+        : (process.env.ASSETS_CDN_PATH || '/');
+    // 4. 调用原有的 preset 函数生成基础配置
+    // 注意：enableInspector 目前在 preset 中由 isDev 控制，暂不暴露为独立参数
+    const baseConfig = (0, preset_1.createRecommendRspackConfig)({
+        isDev,
+        enableReactRefresh,
+        needRoutes,
+        clientBasePath,
+        publicPath,
+    });
+    // 5. 深度合并用户配置
+    return (0, webpack_merge_1.merge)(baseConfig, overrides);
+}
+// 默认导出简化版 API
+exports.default = createFullstackRspackConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-rspack-preset",
-  "version": "0.1.2-alpha.1",
+  "version": "0.1.2-alpha.2",
   "files": [
     "lib"
   ],
@@ -30,10 +30,12 @@
     "@lark-apaas/miaoda-inspector-jsx-runtime": "^1.0.0",
     "@rspack/plugin-react-refresh": "^1.5.1",
     "clsx": "^2.1.1",
+    "dotenv": "^16.4.5",
     "echarts": "^6.0.0",
     "postcss-import": "^16.1.1",
     "react-refresh": "^0.17.0",
-    "tailwind-merge": "^2.5.5"
+    "tailwind-merge": "^2.5.5",
+    "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
     "@lark-apaas/devtool-kits": "^1.0.0",