@rsbuild/core 1.2.11 → 1.2.13

package/dist-types/server/devServer.d.ts

@@ -11,7 +11,8 @@ export type RsbuildDevServer = {
     middlewares: Connect.Server;
     /**
      * The Node.js HTTP server instance.
-     * Will be `Http2SecureServer` if `server.https` config is used.
+     * - Will be `Http2SecureServer` if `server.https` config is used.
+     * - Will be `null` if `server.middlewareMode` is enabled.
      */
     httpServer: import('node:http').Server | import('node:http2').Http2SecureServer | null;
     /**

package/dist-types/server/socketServer.d.ts

@@ -12,14 +12,16 @@ export declare class SocketServer {
     private readonly options;
     private stats;
     private initialChunks;
-    private timer;
+    private heartbeatTimer;
     constructor(options: DevConfig);
     upgrade(req: IncomingMessage, sock: Socket, head: any): void;
+    private checkSockets;
+    private clearHeartbeatTimer;
     prepare(): Promise<void>;
     updateStats(stats: Rspack.Stats): void;
     sockWrite({ type, compilationId, data }: SocketMessage): void;
     private singleWrite;
-    close(): void;
+    close(): Promise<void>;
     private onConnect;
     private getStats;
     private sendStats;

package/dist-types/types/config.d.ts

@@ -115,17 +115,31 @@ export interface SourceConfig {
      */
     assetsInclude?: Rspack.RuleSetCondition;
     /**
-     * Specify directories or modules that need additional compilation.
-     * In order to maintain faster compilation speed, Rsbuild will not compile files under node_modules through
-     * `babel-loader` or `ts-loader` by default, as will as the files outside the current project directory.
+     * Specify additional JavaScript files that need to be compiled by SWC.
+     * Through the `source.include` config, you can specify directories or modules
+     * that need to be compiled by Rsbuild. The usage of `source.include` is
+     * consistent with [Rule.include](https://rspack.dev/config/module#ruleinclude)
+     * in Rspack, which supports passing in strings or regular expressions to match
+     * the module path.
+     * @default
+     * [
+     *   { and: [rootPath, { not: /[\\/]node_modules[\\/]/ }], },
+     *   /\.(?:ts|tsx|jsx|mts|cts)$/,
+     * ];
      */
     include?: RuleSetCondition[];
     /**
      * Set the entry modules.
+     * @default
+     * {
+     *   // Rsbuild also supports other suffixes by default, such as ts,
+     *   // tsx, jsx, mts, cts, mjs, cjs
+     *   index: './src/index.js',
+     * }
      */
     entry?: RsbuildEntry;
     /**
-     * Specifies that certain files that will be excluded from compilation.
+     * Exclude JavaScript or TypeScript files that do not need to be compiled by SWC.
      */
     exclude?: RuleSetCondition[];
     /**
@@ -238,12 +252,12 @@ export type PublicDir = false | PublicDirOptions | PublicDirOptions[];
 export interface ServerConfig {
     /**
      * Configure the base path of the server.
-     *
      * @default '/'
      */
     base?: string;
     /**
-     * Whether to enable gzip compression
+     * Whether to enable gzip compression for served static assets.
+     * @default true
      */
     compress?: boolean;
     /**
@@ -251,15 +265,19 @@ export interface ServerConfig {
      */
     publicDir?: PublicDir;
     /**
-     * Specify a port number for Rsbuild Server to listen.
+     * Specify a port number for Rsbuild server to listen.
+     * @default 3000
      */
     port?: number;
     /**
-     * After configuring this option, you can enable HTTPS Server, and disabling the HTTP Server.
+     * Configure HTTPS options to enable HTTPS server.
+     * When enabled, HTTP server will be disabled.
+     * @default undefined
      */
     https?: HttpsServerOptions | SecureServerSessionOptions;
     /**
-     * Used to set the host of Rsbuild Server.
+     * Specify the host that the Rsbuild server listens to.
+     * @default '0.0.0.0'
      */
     host?: string;
     /**
@@ -267,7 +285,8 @@ export interface ServerConfig {
      */
     headers?: Record<string, string | string[]>;
     /**
-     * Whether to support html fallback.
+     * Whether to enable HTML fallback.
+     * @default 'index'
      */
     htmlFallback?: HtmlFallback;
     /**
@@ -277,6 +296,7 @@ export interface ServerConfig {
     historyApiFallback?: boolean | HistoryApiFallbackOptions;
     /**
      * Set the page URL to open when the server starts.
+     * @default false
      */
     open?: boolean | string | string[] | {
         target?: string | string[];
@@ -292,19 +312,28 @@ export interface ServerConfig {
      */
     cors?: boolean | cors.CorsOptions;
     /**
-     * Configure proxy rules for the dev server or preview server to proxy requests to the specified service.
+     * Configure proxy rules for the dev server or preview server to proxy requests to
+     * the specified service.
      */
     proxy?: ProxyConfig;
     /**
      * Whether to throw an error when the port is occupied.
+     * @default false
      */
     strictPort?: boolean;
     /**
-     * Whether to print the server urls when the server is started.
+     * Controls whether and how server URLs are printed when the server starts.
+     * @default true
      */
     printUrls?: PrintUrls;
+    /**
+     * Whether to create Rsbuild's server in middleware mode, which is useful for
+     * integrating with other servers.
+     * @default false
+     */
+    middlewareMode?: boolean;
 }
-export type NormalizedServerConfig = ServerConfig & Required<Pick<ServerConfig, 'htmlFallback' | 'port' | 'host' | 'compress' | 'strictPort' | 'printUrls' | 'open' | 'base' | 'cors'>>;
+export type NormalizedServerConfig = ServerConfig & Required<Pick<ServerConfig, 'htmlFallback' | 'port' | 'host' | 'compress' | 'strictPort' | 'printUrls' | 'open' | 'base' | 'cors' | 'middlewareMode'>>;
 export type SriAlgorithm = 'sha256' | 'sha384' | 'sha512';
 export type SriOptions = {
     algorithm?: SriAlgorithm;
@@ -317,8 +346,9 @@ export interface SecurityConfig {
      */
     nonce?: string;
     /**
-     * Adding an integrity attribute (`integrity`) to sub-resources introduced by HTML allows the browser to
-     * verify the integrity of the introduced resource, thus preventing tampering with the downloaded resource.
+     * Adding an integrity attribute (`integrity`) to sub-resources introduced by HTML
+     * allows the browser to verify the integrity of the introduced resource, thus preventing
+     * tampering with the downloaded resource.
      */
     sri?: SriOptions;
 }
@@ -441,13 +471,15 @@ export interface PerformanceConfig {
     /**
      * Used to control resource `DnsPrefetch`.
      *
-     * Specifies that the user agent should preemptively perform DNS resolution for the target resource's origin.
+     * Specifies that the user agent should preemptively perform DNS resolution for the target
+     * resource's origin.
      */
     dnsPrefetch?: DnsPrefetch;
     /**
      * Used to control resource `Preload`.
      *
-     * Specifies that the user agent must preemptively fetch and cache the target resource for current navigation.
+     * Specifies that the user agent must preemptively fetch and cache the target resource for
+     * current navigation.
      */
     preload?: true | PreloadOption;
     /**
@@ -459,7 +491,7 @@ export interface PerformanceConfig {
     prefetch?: true | PrefetchOption;
     /**
      * Whether capture timing information for each module,
-     * same as the [profile](https://webpack.js.org/configuration/other-options/#profile) config of webpack.
+     * same as the [profile](https://rspack.dev/config/other-options#profile) config of Rspack.
      */
     profile?: boolean;
 }
@@ -554,50 +586,50 @@ export type DistPathConfig = {
     assets?: string;
 };
 export type FilenameConfig = {
+    /**
+     * The name of HTML files.
+     * @default `[name].html`
+     */
+    html?: string;
     /**
      * The name of the JavaScript files.
      * @default
      * - dev: '[name].js'
      * - prod: '[name].[contenthash:8].js'
      */
-    js?: NonNullable<Rspack.Configuration['output']>['filename'];
+    js?: Rspack.Filename;
     /**
      * The name of the CSS files.
      * @default
      * - dev: '[name].css'
      * - prod: '[name].[contenthash:8].css'
      */
-    css?: NonNullable<Rspack.Configuration['output']>['cssFilename'];
+    css?: Rspack.CssFilename;
     /**
      * The name of the SVG images.
      * @default '[name].[contenthash:8].svg'
      */
-    svg?: string;
-    /**
-     * The name of HTML files.
-     * @default `[name].html`
-     */
-    html?: string;
+    svg?: Rspack.AssetModuleFilename;
     /**
      * The name of the font files.
      * @default '[name].[contenthash:8][ext]'
      */
-    font?: string;
+    font?: Rspack.AssetModuleFilename;
     /**
      * The name of non-SVG images.
      * @default '[name].[contenthash:8][ext]'
      */
-    image?: string;
+    image?: Rspack.AssetModuleFilename;
     /**
      * The name of media assets, such as video.
      * @default '[name].[contenthash:8][ext]'
      */
-    media?: string;
+    media?: Rspack.AssetModuleFilename;
     /**
      * the name of other assets, except for above (image, svg, font, html, wasm...)
      * @default '[name].[contenthash:8][ext]'
      */
-    assets?: string;
+    assets?: Rspack.AssetModuleFilename;
 };
 export type DataUriLimit = {
     /**
@@ -739,7 +771,8 @@ export type ManifestObjectConfig = {
     }) => Record<string, unknown>;
     /**
      * Allows you to filter the files included in the manifest.
-     * The function receives a `file` parameter and returns `true` to keep the file, or `false` to exclude it.
+     * The function receives a `file` parameter and returns `true` to keep the file,
+     * or `false` to exclude it.
      * @default (file: FileDescriptor) => !file.name.endsWith('.LICENSE.txt')
      */
     filter?: (file: FileDescriptor) => boolean;
@@ -753,7 +786,8 @@ export type CleanDistPathObject = {
     enable?: boolean | 'auto';
     /**
      * Specify the files to keep in the output directory.
-     * If the file's absolute path matches the regular expression in `keep`, the file will not be removed.
+     * If the file's absolute path matches the regular expression in `keep`, the file
+     * will not be removed.
      * @default undefined
      */
     keep?: RegExp[];
@@ -773,12 +807,12 @@ export interface OutputConfig {
      */
     externals?: Externals;
     /**
-     * Set the directory of the dist files.
-     * Rsbuild will output files to the corresponding subdirectory according to the file type.
+     * Set the directory of the output files.
+     * Rsbuild will emit files to the specified subdirectory according to the file type.
      */
     distPath?: DistPathConfig;
     /**
-     * Sets the filename of dist files.
+     * Sets the filename of output files.
      */
     filename?: FilenameConfig;
     /**
@@ -795,13 +829,14 @@ export interface OutputConfig {
     /**
      * When using CDN in the production,
      * you can use this option to set the URL prefix of static assets,
-     * similar to the output.publicPath config of webpack.
+     * similar to the `output.publicPath` config of Rspack.
      * @default `server.base`
      */
     assetPrefix?: string;
     /**
      * Set the size threshold to inline static assets such as images and fonts.
-     * By default, static assets will be Base64 encoded and inline into the page if the size is less than 4KiB.
+     * By default, static assets will be Base64 encoded and inline into the page if
+     * the size is less than 4KiB.
      */
     dataUriLimit?: number | DataUriLimit;
     /**
@@ -871,8 +906,9 @@ export interface OutputConfig {
     /**
      * Specifies the range of target browsers that the project is compatible with.
      * This value will be used by [SWC](https://github.com/swc-project/swc) and
-     * [Lightning CSS](https://github.com/parcel-bundler/lightningcss) to identify the JavaScript syntax that
-     * need to be transformed and the CSS browser prefixes that need to be added.
+     * [Lightning CSS](https://github.com/parcel-bundler/lightningcss) to identify
+     * the JavaScript syntax that need to be transformed and the CSS browser prefixes
+     * that need to be added.
      * @default undefined
      */
     overrideBrowserslist?: string[];
@@ -1183,7 +1219,7 @@ export interface DevConfig {
     liveReload?: boolean;
     /**
      * Set the URL prefix of static assets in development mode,
-     * similar to the [output.publicPath](https://rspack.dev/config/output#outputpublicpath) config of webpack.
+     * similar to the [output.publicPath](https://rspack.dev/config/output#outputpublicpath) config of Rspack.
      */
     assetPrefix?: string | boolean;
     /**
@@ -1239,8 +1275,8 @@ export interface ResolveConfig {
      */
     dedupe?: string[];
     /**
-     * Create aliases to import or require certain modules,
-     * same as the [resolve.alias](https://rspack.dev/config/resolve) config of Rspack.
+     * Set the alias for the module path, which is used to simplify the import path or redirect the module reference.
+     * Similar to the [resolve.alias](https://rspack.dev/config/resolve) config of Rspack.
      */
     alias?: ConfigChain<Alias>;
     /**
@@ -1330,7 +1366,7 @@ export interface RsbuildConfig extends EnvironmentConfig {
      */
     dev?: DevConfig;
     /**
-     * Options for the Rsbuild Server,
+     * Options for the Rsbuild server,
      * will take effect during local development and preview.
      */
     server?: ServerConfig;

package/dist-types/types/rspack.d.ts

@@ -13,4 +13,4 @@ export interface BundlerPluginInstance {
 }
 /** T[] => T */
 type GetElementType<T extends any[]> = T extends (infer U)[] ? U : never;
-export type RspackRule = GetElementType<NonNullable<NonNullable<Rspack.Configuration['module']>['rules']>>;
+export type RspackRule = GetElementType<Rspack.RuleSetRules>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.2.11",
+  "version": "1.2.13",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.dev",
   "bugs": {
@@ -46,15 +46,16 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@rspack/core": "1.2.3",
+    "@rspack/core": "1.2.6",
     "@rspack/lite-tapable": "~1.0.1",
     "@swc/helpers": "^0.5.15",
-    "core-js": "~3.40.0"
+    "core-js": "~3.40.0",
+    "jiti": "^2.4.2"
   },
   "devDependencies": {
-    "@rslib/core": "0.4.1",
+    "@rslib/core": "0.5.1",
     "@types/connect": "3.4.38",
-    "@types/node": "^22.13.4",
+    "@types/node": "^22.13.5",
     "@types/on-finished": "2.3.4",
     "@types/webpack-bundle-analyzer": "4.7.0",
     "@types/ws": "^8.5.14",
@@ -70,29 +71,28 @@
     "dotenv-expand": "12.0.1",
     "html-rspack-plugin": "6.0.2",
     "http-proxy-middleware": "^2.0.6",
-    "jiti": "^1.21.7",
     "launch-editor-middleware": "^2.10.0",
-    "mrmime": "^2.0.0",
+    "mrmime": "^2.0.1",
     "on-finished": "2.4.1",
     "open": "^8.4.0",
     "picocolors": "^1.1.1",
-    "postcss": "^8.5.2",
+    "postcss": "^8.5.3",
     "postcss-load-config": "6.0.1",
     "postcss-loader": "8.1.1",
     "prebundle": "1.2.7",
     "reduce-configs": "^1.1.0",
-    "rsbuild-dev-middleware": "0.1.2",
+    "rsbuild-dev-middleware": "0.2.0",
     "rslog": "^1.2.3",
     "rspack-chain": "^1.2.1",
     "rspack-manifest-plugin": "5.0.3",
-    "sirv": "^3.0.0",
+    "sirv": "^3.0.1",
     "style-loader": "3.3.4",
-    "tinyglobby": "^0.2.10",
+    "tinyglobby": "^0.2.12",
     "typescript": "^5.7.3",
     "webpack": "^5.98.0",
     "webpack-bundle-analyzer": "^4.10.2",
     "webpack-merge": "6.0.1",
-    "ws": "^8.18.0"
+    "ws": "^8.18.1"
   },
   "engines": {
     "node": ">=16.7.0"

package/compiled/jiti/index.d.ts

@@ -1 +0,0 @@
-export = any;