@esmx/rspack 3.0.0-rc.11 → 3.0.0-rc.111

package/dist/app.d.ts

@@ -1,160 +0,0 @@
-import { type App, type Esmx } from '@esmx/core';
-import type { RspackOptions } from '@rspack/core';
-import type { BuildTarget } from './build-target';
-/**
- * Rspack 应用配置上下文接口。
- *
- * 该接口提供了在配置钩子函数中可以访问的上下文信息，允许你：
- * - 访问 Esmx 框架实例
- * - 获取当前的构建目标（client/server/node）
- * - 修改 Rspack 配置
- * - 访问应用选项
- *
- * @example
- * ```ts
- * // entry.node.ts
- * export default {
- *   async devApp(esmx) {
- *     return import('@esmx/rspack').then((m) =>
- *       m.createRspackApp(esmx, {
- *         // 配置钩子函数
- *         config(context) {
- *           // 访问构建目标
- *           if (context.buildTarget === 'client') {
- *             // 修改客户端构建配置
- *             context.config.optimization = {
- *               ...context.config.optimization,
- *               splitChunks: {
- *                 chunks: 'all'
- *               }
- *             };
- *           }
- *         }
- *       })
- *     );
- *   }
- * };
- * ```
- */
-export interface RspackAppConfigContext {
-    /**
-     * Esmx 框架实例。
-     * 可用于访问框架提供的 API 和工具函数。
-     */
-    esmx: Esmx;
-    /**
-     * 当前的构建目标。
-     * - 'client': 客户端构建，生成浏览器可执行的代码
-     * - 'server': 服务端构建，生成 SSR 渲染代码
-     * - 'node': Node.js 构建，生成服务器入口代码
-     */
-    buildTarget: BuildTarget;
-    /**
-     * Rspack 编译配置对象。
-     * 你可以在配置钩子中修改这个对象来自定义构建行为。
-     */
-    config: RspackOptions;
-    /**
-     * 创建应用时传入的选项对象。
-     */
-    options: RspackAppOptions;
-}
-/**
- * Rspack 应用配置选项接口。
- *
- * 该接口提供了创建 Rspack 应用时可以使用的配置选项，包括：
- * - 代码压缩选项
- * - Rspack 配置钩子函数
- *
- * @example
- * ```ts
- * // entry.node.ts
- * export default {
- *   async devApp(esmx) {
- *     return import('@esmx/rspack').then((m) =>
- *       m.createRspackApp(esmx, {
- *         // 禁用代码压缩
- *         minimize: false,
- *         // 自定义 Rspack 配置
- *         config(context) {
- *           if (context.buildTarget === 'client') {
- *             context.config.optimization.splitChunks = {
- *               chunks: 'all'
- *             };
- *           }
- *         }
- *       })
- *     );
- *   }
- * };
- * ```
- */
-export interface RspackAppOptions {
-    /**
-     * 是否启用代码压缩。
-     *
-     * - true: 启用代码压缩
-     * - false: 禁用代码压缩
-     * - undefined: 根据环境自动判断（生产环境启用，开发环境禁用）
-     *
-     * @default undefined
-     */
-    minimize?: boolean;
-    /**
-     * Rspack 配置钩子函数。
-     *
-     * 在构建开始前调用，可以通过该函数修改 Rspack 的编译配置。
-     * 支持针对不同的构建目标（client/server/node）进行差异化配置。
-     *
-     * @param context - 配置上下文，包含框架实例、构建目标和配置对象
-     */
-    config?: (context: RspackAppConfigContext) => void;
-}
-/**
- * 创建 Rspack 应用实例。
- *
- * 该函数根据运行环境（开发/生产）创建不同的应用实例：
- * - 开发环境：配置热更新中间件和实时渲染
- * - 生产环境：配置构建任务
- *
- * @param esmx - Esmx 框架实例
- * @param options - Rspack 应用配置选项
- * @returns 返回应用实例
- *
- * @example
- * ```ts
- * // entry.node.ts
- * export default {
- *   async devApp(esmx) {
- *     return import('@esmx/rspack').then((m) =>
- *       m.createRspackApp(esmx, {
- *         config(context) {
- *           // 配置 loader 处理不同类型的文件
- *           context.config.module = {
- *             rules: [
- *               {
- *                 test: /\.ts$/,
- *                 exclude: [/node_modules/],
- *                 loader: 'builtin:swc-loader',
- *                 options: {
- *                   jsc: {
- *                     parser: {
- *                       syntax: 'typescript'
- *                     }
- *                   }
- *                 }
- *               },
- *               {
- *                 test: /\.css$/,
- *                 use: ['style-loader', 'css-loader']
- *               }
- *             ]
- *           };
- *         }
- *       })
- *     );
- *   }
- * };
- * ```
- */
-export declare function createRspackApp(esmx: Esmx, options?: RspackAppOptions): Promise<App>;

package/dist/build-target.d.ts

@@ -1,8 +0,0 @@
-/**
- * 构建目标环境类型
- * @description 定义了应用程序的构建目标环境，用于配置构建过程中的特定优化和功能
- * - node: 构建为 Node.js 环境运行的代码
- * - client: 构建为浏览器环境运行的代码
- * - server: 构建为服务端环境运行的代码
- */
-export type BuildTarget = 'node' | 'client' | 'server';

package/dist/config.mjs

@@ -1,142 +0,0 @@
-import { moduleLinkPlugin } from "@esmx/rspack-module-link-plugin";
-import {
-  rspack
-} from "@rspack/core";
-import nodeExternals from "webpack-node-externals";
-export function createRspackConfig(esmx, buildTarget, options) {
-  const isWebApp = buildTarget === "client" || buildTarget === "server";
-  const isHot = buildTarget === "client" && !esmx.isProd;
-  return {
-    /**
-     * 项目根目录，不可修改
-     */
-    context: esmx.root,
-    entry: (() => {
-      const importPaths = [];
-      switch (buildTarget) {
-        case "client":
-          importPaths.push(esmx.resolvePath("src/entry.client.ts"));
-          isHot && importPaths.push(
-            `${resolve("webpack-hot-middleware/client")}?path=${esmx.basePath}hot-middleware&timeout=5000&overlay=false`
-          );
-          break;
-        case "server":
-          importPaths.push(esmx.resolvePath("src/entry.server.ts"));
-          break;
-        case "node":
-          importPaths.push(esmx.resolvePath("src/entry.node.ts"));
-          break;
-      }
-      return {
-        [`./src/entry.${buildTarget}`]: {
-          import: importPaths
-        }
-      };
-    })(),
-    output: {
-      clean: esmx.isProd,
-      module: true,
-      chunkFormat: esmx.isProd ? "module" : void 0,
-      chunkLoading: esmx.isProd ? "import" : void 0,
-      chunkFilename: esmx.isProd ? "chunks/[name].[contenthash:8].final.js" : "chunks/[name].js",
-      library: {
-        type: esmx.isProd ? "modern-module" : "module"
-      },
-      filename: buildTarget !== "node" && esmx.isProd ? "[name].[contenthash:8].final.js" : "[name].js",
-      cssFilename: esmx.isProd ? "[name].[contenthash:8].final.css" : "[name].css",
-      cssChunkFilename: esmx.isProd ? "chunks/[name].[contenthash:8].final.css" : "chunks/[name].css",
-      publicPath: buildTarget === "client" ? "auto" : `${esmx.basePathPlaceholder}${esmx.basePath}`,
-      uniqueName: esmx.varName,
-      hotUpdateChunkFilename: "__hot__/[id].[fullhash].hot-update.js",
-      hotUpdateMainFilename: "__hot__/[runtime].[fullhash].hot-update.json",
-      path: (() => {
-        switch (buildTarget) {
-          case "client":
-            return esmx.resolvePath("dist/client");
-          case "server":
-            return esmx.resolvePath("dist/server");
-          case "node":
-            return esmx.resolvePath("dist/node");
-        }
-      })(),
-      environment: {
-        nodePrefixForCoreModules: true
-      }
-    },
-    // 默认插件，不可修改
-    plugins: (() => {
-      return [
-        // 进度条插件
-        new rspack.ProgressPlugin({
-          prefix: buildTarget
-        }),
-        // 模块链接插件
-        isWebApp ? moduleLinkPlugin(esmx.moduleConfig) : false,
-        // 热更新插件
-        isHot ? new rspack.HotModuleReplacementPlugin() : false
-      ];
-    })(),
-    module: {
-      parser: {
-        javascript: {
-          url: buildTarget === "client" ? true : "relative",
-          importMeta: false,
-          strictExportPresence: true
-        }
-      },
-      generator: {
-        asset: {
-          emit: buildTarget === "client"
-        },
-        "asset/resource": {
-          emit: buildTarget === "client"
-        }
-      },
-      rules: []
-    },
-    resolve: {
-      alias: {
-        [esmx.name]: esmx.root
-      }
-    },
-    optimization: {
-      minimize: options.minimize ?? esmx.isProd,
-      avoidEntryIife: esmx.isProd,
-      concatenateModules: esmx.isProd,
-      emitOnErrors: true,
-      splitChunks: {
-        chunks: "async"
-      }
-    },
-    externalsPresets: {
-      web: buildTarget === "client",
-      node: buildTarget === "server" || buildTarget === "node"
-    },
-    externalsType: "module-import",
-    externals: (() => {
-      if (buildTarget === "node") {
-        return [
-          // @ts-ignore
-          nodeExternals({
-            // @ts-ignore
-            importType: "module-import"
-          })
-        ];
-      }
-      return [];
-    })(),
-    experiments: {
-      outputModule: true,
-      parallelCodeSplitting: true,
-      rspackFuture: {
-        bundlerInfo: { force: false }
-      }
-    },
-    target: buildTarget === "client" ? "web" : "node22.6",
-    mode: esmx.isProd ? "production" : "development",
-    cache: !esmx.isProd
-  };
-}
-function resolve(name) {
-  return new URL(import.meta.resolve(name)).pathname;
-}

package/dist/html-app.d.ts

@@ -1,299 +0,0 @@
-import type { Esmx } from '@esmx/core';
-import { type SwcLoaderOptions } from '@rspack/core';
-import { type RspackAppOptions } from './app';
-import type { BuildTarget } from './build-target';
-import { RSPACK_LOADER } from './loader';
-/**
- * Rspack HTML 应用配置选项接口
- *
- * @example
- * ```ts
- * // entry.node.ts
- * export default {
- *   async devApp(esmx) {
- *     return import('@esmx/rspack').then((m) =>
- *       m.createRspackHtmlApp(esmx, {
- *         // 将 CSS 输出到独立的 CSS 文件中
- *         css: 'css',
- *         // 自定义 loader
- *         loaders: {
- *           styleLoader: 'vue-style-loader'
- *         },
- *         // 配置 CSS 相关 loader
- *         styleLoader: {
- *           injectType: 'singletonStyleTag'
- *         },
- *         cssLoader: {
- *           modules: true
- *         },
- *         // 配置构建目标
- *         target: {
- *           web: ['chrome>=87'],
- *           node: ['node>=16']
- *         },
- *         // 定义全局常量
- *         definePlugin: {
- *           'process.env.APP_ENV': JSON.stringify('production')
- *         }
- *       })
- *     );
- *   }
- * };
- * ```
- */
-export interface RspackHtmlAppOptions extends RspackAppOptions {
-    /**
-     * CSS 输出模式配置
-     *
-     * @default 根据环境自动选择：
-     * - 生产环境: 'css'，将CSS输出到独立文件中，有利于缓存和并行加载
-     * - 开发环境: 'js'，将CSS打包到JS中以支持热更新(HMR)，实现样式的即时更新
-     *
-     * - 'css': 将 CSS 输出到独立的 CSS 文件中
-     * - 'js': 将 CSS 打包到 JS 文件中，运行时动态插入样式
-     * - false: 关闭默认的 CSS 处理配置，需要手动配置 loader 规则
-     *
-     * @example
-     * ```ts
-     * // 使用环境默认配置
-     * css: undefined
-     *
-     * // 强制输出到独立的 CSS 文件
-     * css: 'css'
-     *
-     * // 强制打包到 JS 中
-     * css: 'js'
-     *
-     * // 自定义 CSS 处理
-     * css: false
-     * ```
-     */
-    css?: 'css' | 'js' | false;
-    /**
-     * 自定义 loader 配置
-     *
-     * 允许替换默认的 loader 实现，可用于切换到特定框架的 loader
-     *
-     * @example
-     * ```ts
-     * // 使用 Vue 的 style-loader
-     * loaders: {
-     *   styleLoader: 'vue-style-loader'
-     * }
-     * ```
-     */
-    loaders?: Partial<Record<keyof typeof RSPACK_LOADER, string>>;
-    /**
-     * style-loader 配置项
-     *
-     * 用于配置样式注入方式，完整选项参考:
-     * https://github.com/webpack-contrib/style-loader
-     *
-     * @example
-     * ```ts
-     * styleLoader: {
-     *   injectType: 'singletonStyleTag',
-     *   attributes: { id: 'app-styles' }
-     * }
-     * ```
-     */
-    styleLoader?: Record<string, any>;
-    /**
-     * css-loader 配置项
-     *
-     * 用于配置 CSS 模块化、URL 解析等，完整选项参考:
-     * https://github.com/webpack-contrib/css-loader
-     *
-     * @example
-     * ```ts
-     * cssLoader: {
-     *   modules: true,
-     *   url: false
-     * }
-     * ```
-     */
-    cssLoader?: Record<string, any>;
-    /**
-     * less-loader 配置项
-     *
-     * 用于配置 Less 编译选项，完整选项参考:
-     * https://github.com/webpack-contrib/less-loader
-     *
-     * @example
-     * ```ts
-     * lessLoader: {
-     *   lessOptions: {
-     *     javascriptEnabled: true,
-     *     modifyVars: { '@primary-color': '#1DA57A' }
-     *   }
-     * }
-     * ```
-     */
-    lessLoader?: Record<string, any>;
-    /**
-     * style-resources-loader 配置项
-     *
-     * 用于自动注入全局的样式资源，完整选项参考:
-     * https://github.com/yenshih/style-resources-loader
-     *
-     * @example
-     * ```ts
-     * styleResourcesLoader: {
-     *   patterns: [
-     *     './src/styles/variables.less',
-     *     './src/styles/mixins.less'
-     *   ]
-     * }
-     * ```
-     */
-    styleResourcesLoader?: Record<string, any>;
-    /**
-     * SWC loader 配置项
-     *
-     * 用于配置 TypeScript/JavaScript 编译选项，完整选项参考:
-     * https://rspack.dev/guide/features/builtin-swc-loader
-     *
-     * @example
-     * ```ts
-     * swcLoader: {
-     *   jsc: {
-     *     parser: {
-     *       syntax: 'typescript',
-     *       decorators: true
-     *     },
-     *     transform: {
-     *       legacyDecorator: true
-     *     }
-     *   }
-     * }
-     * ```
-     */
-    swcLoader?: SwcLoaderOptions;
-    /**
-     * DefinePlugin 配置项
-     *
-     * 用于定义编译时的全局常量，支持针对不同构建目标设置不同的值
-     * 完整说明参考: https://rspack.dev/plugins/webpack/define-plugin
-     *
-     * @example
-     * ```ts
-     * // 统一的值
-     * definePlugin: {
-     *   'process.env.APP_ENV': JSON.stringify('production')
-     * }
-     *
-     * // 针对不同构建目标的值
-     * definePlugin: {
-     *   'process.env.IS_SERVER': {
-     *     server: 'true',
-     *     client: 'false'
-     *   }
-     * }
-     * ```
-     */
-    definePlugin?: Record<string, string | Partial<Record<BuildTarget, string>>>;
-    /**
-     * 构建目标配置
-     *
-     * 用于设置代码的目标运行环境，影响代码的编译降级和 polyfill 注入
-     *
-     * @example
-     * ```ts
-     * target: {
-     *   // 浏览器构建目标
-     *   web: ['chrome>=87', 'firefox>=78', 'safari>=14'],
-     *   // Node.js 构建目标
-     *   node: ['node>=16']
-     * }
-     * ```
-     */
-    target?: {
-        /**
-         * 浏览器构建目标
-         *
-         * @default ['chrome>=87', 'edge>=88', 'firefox>=78', 'safari>=14']
-         */
-        web?: string[];
-        /**
-         * Node.js 构建目标
-         *
-         * @default ['node>=22.6']
-         */
-        node?: string[];
-    };
-}
-/**
- * 创建 Rspack HTML 应用实例。
- *
- * 该函数提供了完整的 Web 应用构建配置，支持以下资源类型的处理：
- * - TypeScript/JavaScript
- * - Web Worker
- * - JSON
- * - CSS/Less
- * - 视频/图片
- * - 字体文件
- *
- * @param esmx - Esmx 框架实例
- * @param options - Rspack HTML 应用配置选项
- * @returns 返回应用实例，包含中间件、渲染函数和构建函数
- *
- * @example
- * ```ts
- * // 开发环境配置
- * // entry.node.ts
- * export default {
- *   async devApp(esmx) {
- *     return import('@esmx/rspack').then((m) =>
- *       m.createRspackHtmlApp(esmx, {
- *         // 配置 CSS 输出模式
- *         css: 'css',
- *         // 配置 TypeScript 编译选项
- *         swcLoader: {
- *           jsc: {
- *             parser: {
- *               syntax: 'typescript',
- *               decorators: true
- *             }
- *           }
- *         },
- *         // 配置构建目标
- *         target: {
- *           web: ['chrome>=87'],
- *           node: ['node>=16']
- *         },
- *         // 自定义 Rspack 配置
- *         config({ config }) {
- *           // 添加自定义 loader
- *           config.module.rules.push({
- *             test: /\.vue$/,
- *             loader: 'vue-loader'
- *           });
- *         }
- *       })
- *     );
- *   }
- * };
- *
- * // 生产环境配置
- * // entry.node.ts
- * export default {
- *   async buildApp(esmx) {
- *     return import('@esmx/rspack').then((m) =>
- *       m.createRspackHtmlApp(esmx, {
- *         // 启用代码压缩
- *         minimize: true,
- *         // 配置全局常量
- *         definePlugin: {
- *           'process.env.NODE_ENV': JSON.stringify('production'),
- *           'process.env.IS_SERVER': {
- *             server: 'true',
- *             client: 'false'
- *           }
- *         }
- *       })
- *     );
- *   }
- * };
- * ```
- */
-export declare function createRspackHtmlApp(esmx: Esmx, options?: RspackHtmlAppOptions): Promise<import("@esmx/core").App>;