@rsbuild/core 2.0.0-beta.0 → 2.0.0-beta.10

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

@@ -3,12 +3,14 @@ import type { SecureServerSessionOptions } from 'node:http2';
 import type { ServerOptions as HttpsServerOptions } from 'node:https';
 import type { URL } from 'node:url';
 import type { CopyRspackPluginOptions, DefinePluginOptions, Externals, LightningCssMinimizerRspackPluginOptions, ModuleFederationPluginOptions, RuleSetCondition, SwcJsMinimizerRspackPluginOptions, SwcLoaderOptions } from '@rspack/core';
-import type { CorsOptions } from 'cors';
+import type { ChokidarOptions } from '../../compiled/chokidar';
+import type Cors from '../../compiled/cors';
+import type { Options as HttpProxyOptions, Filter as ProxyFilter } from '../../compiled/http-proxy-middleware';
 import type RspackChain from '../../compiled/rspack-chain/types';
-import type { FileDescriptor } from 'rspack-manifest-plugin';
-import type { ChokidarOptions } from '../../compiled/chokidar/index.js';
-import type { Options as HttpProxyOptions, Filter as ProxyFilter } from '../../compiled/http-proxy-middleware/index.js';
+import type { FileDescriptor } from '../../compiled/rspack-manifest-plugin';
 import type { RsbuildDevServer } from '../server/devServer';
+import type { RsbuildPreviewServer } from '../server/previewServer';
+import type { Logger } from '../logger';
 import type { EnvironmentContext, ModifyBundlerChainUtils, ModifyChainUtils, Routes } from './hooks';
 import type { RsbuildPlugins } from './plugin';
 import type { RsbuildEntry, RsbuildMode, RsbuildTarget } from './rsbuild';
@@ -230,20 +232,17 @@ export type ProxyBypass = (req: IncomingMessage, res: ServerResponse, proxyOptio
 export type { ProxyFilter };
 export type ProxyOptions = HttpProxyOptions & {
     /**
-     * Bypass the proxy based on the return value of a function.
+     * Use the `bypass` function to skip the proxy.
+     * Inside the function, you have access to the request, response, and proxy options.
      * - Return `null` or `undefined` to continue processing the request with proxy.
-     * - Return `true` to continue processing the request without proxy.
+     * - Return `true` to skip the proxy and continue processing the request.
      * - Return `false` to produce a 404 error for the request.
-     * - Return a path to serve from, instead of continuing to proxy the request.
+     * - Return a specific path to replace the original request path.
      * - Return a Promise to handle the request asynchronously.
      */
     bypass?: ProxyBypass;
-    /**
-     * Used to proxy multiple specified paths to the same target.
-     */
-    context?: ProxyFilter;
 };
-export type ProxyConfig = Record<string, string | ProxyOptions> | ProxyOptions[] | ProxyOptions;
+export type ProxyConfig = Record<string, string | ProxyOptions> | ProxyOptions[];
 export type HistoryApiFallbackContext = {
     match: RegExpMatchArray;
     parsedUrl: URL;
@@ -312,8 +311,9 @@ export type PublicDirOptions = {
      */
     watch?: boolean;
     /**
-     * Glob patterns of files to ignore when copying from the public directory.
-     * @default undefined
+     * Glob patterns for files or directories to ignore when copying the public directory
+     * during production builds.
+     * @default []
      */
     ignore?: string[];
 };
@@ -416,7 +416,7 @@ export interface ServerConfig {
      *
      * @link https://github.com/expressjs/cors
      */
-    cors?: boolean | CorsOptions;
+    cors?: boolean | Cors.CorsOptions;
     /**
      * Configure proxy rules for the dev server or preview server to proxy requests to
      * the specified service.
@@ -438,11 +438,53 @@ export interface ServerConfig {
      * @default false
      */
     middlewareMode?: boolean;
+    /**
+     * Run setup logic when the Rsbuild dev server or preview server starts,
+     * such as registering custom middleware or running pre-start tasks.
+     *
+     * When `server.setup` is called, Rsbuild built-in middlewares are not registered yet,
+     * so middlewares you add run earlier than built-ins.
+     *
+     * `server.setup` can return a callback function. After built-in middlewares are registered,
+     * Rsbuild will execute that callback. Middlewares registered in the callback run later than built-ins.
+     *
+     * @default undefined
+     */
+    setup?: ServerSetupFn | ServerSetupFn[];
 }
 export type NormalizedServerConfig = {
     host: string;
     publicDir: Required<PublicDirOptions>[];
-} & Omit<Optional<Required<ServerConfig>, 'headers' | 'https' | 'historyApiFallback' | 'proxy'>, 'host' | 'publicDir'>;
+} & Omit<Optional<Required<ServerConfig>, 'headers' | 'https' | 'historyApiFallback' | 'proxy' | 'setup'>, 'host' | 'publicDir'>;
+export type ServerSetupContext = {
+    /**
+     * Environment contexts of all environments.
+     */
+    environments: Record<string, EnvironmentContext>;
+} & ({
+    /**
+     * Action type of current server.
+     */
+    action: 'dev';
+    /**
+     * Dev server instance, only available in dev mode.
+     */
+    server: RsbuildDevServer;
+} | {
+    /**
+     * Action type of current server.
+     */
+    action: 'preview';
+    /**
+     * Preview server instance, only available in preview mode.
+     */
+    server: RsbuildPreviewServer;
+});
+/**
+ * Server setup function.
+ * Return a callback to run after built-in middlewares are registered.
+ */
+export type ServerSetupFn = (context: ServerSetupContext) => MaybePromise<(() => MaybePromise<void>) | void>;
 export type SriAlgorithm = 'sha256' | 'sha384' | 'sha512';
 export type SriOptions = {
     /**
@@ -665,7 +707,15 @@ export interface NormalizedPerformanceConfig extends PerformanceConfig {
     printFileSize: PrintFileSizeOptions | boolean;
 }
 export type SplitChunks = Rspack.OptimizationSplitChunksOptions | false;
-export type SplitChunksPreset = 'default' | 'single-vendor' | 'per-package';
+/**
+ * Split chunks preset rules.
+ * - `default`: splits polyfills when enabled and applies extra groups when using
+ * framework plugins.
+ * - `per-package`: splits dependencies in `node_modules` by npm package.
+ * - `single-vendor`: splits all `node_modules` dependencies into one vendor chunk.
+ * - `none`: disables Rsbuild preset rules.
+ */
+export type SplitChunksPreset = 'default' | 'single-vendor' | 'per-package' | 'none';
 export type SplitChunksConfig = Rspack.OptimizationSplitChunksOptions & {
     preset?: SplitChunksPreset;
 };
@@ -766,34 +816,34 @@ export type FilenameConfig = {
      * The name of the JavaScript files.
      * @default
      * - dev: '[name].js'
-     * - prod: '[name].[contenthash:8].js'
+     * - prod: '[name].[contenthash:10].js'
      */
     js?: Rspack.Filename;
     /**
      * The name of the CSS files.
      * @default
      * - dev: '[name].css'
-     * - prod: '[name].[contenthash:8].css'
+     * - prod: '[name].[contenthash:10].css'
      */
     css?: Rspack.CssFilename;
     /**
      * The name of the SVG images.
-     * @default '[name].[contenthash:8].svg'
+     * @default '[name].[contenthash:10].svg'
      */
     svg?: Rspack.AssetModuleFilename;
     /**
      * The name of the font files.
-     * @default '[name].[contenthash:8][ext]'
+     * @default '[name].[contenthash:10][ext]'
      */
     font?: Rspack.AssetModuleFilename;
     /**
      * The name of non-SVG images.
-     * @default '[name].[contenthash:8][ext]'
+     * @default '[name].[contenthash:10][ext]'
      */
     image?: Rspack.AssetModuleFilename;
     /**
      * The name of media assets, such as video.
-     * @default '[name].[contenthash:8][ext]'
+     * @default '[name].[contenthash:10][ext]'
      */
     media?: Rspack.AssetModuleFilename;
     /**
@@ -803,7 +853,7 @@ export type FilenameConfig = {
     wasm?: Rspack.WebassemblyModuleFilename;
     /**
      * The name of other assets, except for above (image, svg, font, html, wasm...)
-     * @default '[name].[contenthash:8][ext]'
+     * @default '[name].[contenthash:10][ext]'
      */
     assets?: Rspack.AssetModuleFilename;
 };
@@ -838,6 +888,33 @@ export type Charset = 'ascii' | 'utf8';
 export type LegalComments = 'none' | 'inline' | 'linked';
 export type NormalizedDataUriLimit = Required<DataUriLimit>;
 export type Polyfill = 'usage' | 'entry' | 'off';
+export type SourceMapExtractTarget = {
+    /**
+     * Include matched JavaScript files whose existing source maps should be
+     * extracted.
+     */
+    include?: RuleSetCondition[];
+    /**
+     * Exclude matched JavaScript files whose existing source maps should not be
+     * extracted.
+     */
+    exclude?: RuleSetCondition[];
+};
+export type SourceMapExtract = boolean | {
+    /**
+     * Whether to extract existing source maps from matching JavaScript files.
+     * This is useful when a third-party package already ships both `.js` and
+     * `.js.map` files.
+     *
+     * `true` means extract from all JavaScript files. You can also use `include`
+     * or `exclude` to limit extraction to specific files.
+     *
+     * This option is implemented based on Rspack's
+     * `module.rules[].extractSourceMap` and can replace `source-map-loader`.
+     * @default false
+     */
+    js?: boolean | SourceMapExtractTarget;
+};
 export type SourceMap = {
     /**
      * The source map type for JavaScript files.
@@ -849,6 +926,12 @@ export type SourceMap = {
      * @default false
      */
     css?: boolean;
+    /**
+     * Whether to extract existing source maps from matching input files.
+     * Currently only JavaScript files are supported.
+     * @default false
+     */
+    extract?: SourceMapExtract;
 };
 export type CSSModulesLocalsConvention = 'asIs' | 'camelCase' | 'camelCaseOnly' | 'dashes' | 'dashesOnly';
 export type CSSModules = {
@@ -1104,6 +1187,7 @@ export interface OutputConfig {
      * const defaultSourceMap = {
      *   js: isDev ? 'cheap-module-source-map' : false,
      *   css: false,
+     *   extract: false,
      * };
      * ```
      */
@@ -1164,6 +1248,7 @@ export interface NormalizedOutputConfig extends OutputConfig {
     sourceMap: boolean | {
         js?: Rspack.Configuration['devtool'];
         css: boolean;
+        extract: SourceMapExtract;
     };
     cleanDistPath: CleanDistPath;
     filenameHash: boolean | string;
@@ -1571,6 +1656,13 @@ export type CliShortcut = {
 };
 export type WriteToDisk = boolean | ((filename: string) => boolean);
 export type BrowserLogsStackTrace = 'summary' | 'full' | 'none';
+export type LiveReload = boolean | {
+    /**
+     * Whether to trigger a full page reload when the HTML template changes.
+     * @default true
+     */
+    html?: boolean;
+};
 export interface DevConfig {
     /**
      * Controls whether to forward browser runtime errors to the terminal. When `true`, the dev
@@ -1599,7 +1691,7 @@ export interface DevConfig {
      * Whether to reload the page when file changes are detected.
      * @default true
      */
-    liveReload?: boolean;
+    liveReload?: LiveReload;
     /**
      * Set the URL prefix of static assets in development mode,
      * similar to the [output.publicPath](https://rspack.rs/config/output#outputpublicpath)
@@ -1638,6 +1730,7 @@ export interface DevConfig {
     };
     /**
      * Used to add custom middleware to the dev server.
+     * @deprecated Use `server.setup` instead
      * @default undefined
      */
     setupMiddlewares?: SetupMiddlewaresFn | SetupMiddlewaresFn[];
@@ -1798,6 +1891,11 @@ export interface RsbuildConfig extends EnvironmentConfig {
      * @default 'info'
      */
     logLevel?: LogLevel;
+    /**
+     * Use a custom logger instance for the current Rsbuild instance.
+     * You can create one via `createLogger()`.
+     */
+    customLogger?: Logger;
     /**
      * Options for local development.
      */

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

@@ -1,4 +1,5 @@
 import type { Hooks } from '../hooks';
+import type { Logger } from '../logger';
 import type { SocketServer } from '../server/socketServer';
 import type { NormalizedConfig, RsbuildConfig } from './config';
 import type { EnvironmentContext } from './hooks';
@@ -79,6 +80,8 @@ export type BuildState = {
 };
 /** The inner context. */
 export type InternalContext = RsbuildContext & {
+    /** The logger associated with current Rsbuild instance. */
+    logger: Logger;
     /** All hooks. */
     hooks: Readonly<Hooks>;
     /** Current Rsbuild config. */

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

@@ -1,6 +1,7 @@
 import type { rspack } from '@rspack/core';
 import type { ChainIdentifier, ManifestData } from '..';
 import type { RsbuildDevServer } from '../server/devServer';
+import type { RsbuildPreviewServer } from '../server/previewServer';
 import type { RspackChain } from '../types';
 import type { EnvironmentConfig, HtmlBasicTag, MergedEnvironmentConfig, NormalizedEnvironmentConfig, RsbuildConfig } from './config';
 import type { RsbuildEntry, RsbuildTarget } from './rsbuild';
@@ -67,8 +68,17 @@ export type OnBeforeStartDevServerFn = (params: {
      * Context information for all environments.
      */
     environments: Record<string, EnvironmentContext>;
-}) => MaybePromise<(() => void) | void>;
-export type OnBeforeStartProdServerFn = () => MaybePromise<void>;
+}) => MaybePromise<(() => MaybePromise<void>) | void>;
+export type OnBeforeStartPreviewServerFn = (params: {
+    /**
+     * The preview server instance.
+     */
+    server: RsbuildPreviewServer;
+    /**
+     * Context information for all environments.
+     */
+    environments: Record<string, EnvironmentContext>;
+}) => MaybePromise<void>;
 export type Routes = {
     entryName: string;
     pathname: string;
@@ -81,7 +91,7 @@ export type OnAfterStartDevServerFn = (params: {
      */
     environments: Record<string, EnvironmentContext>;
 }) => MaybePromise<void>;
-export type OnAfterStartProdServerFn = (params: {
+export type OnAfterStartPreviewServerFn = (params: {
     port: number;
     routes: Routes;
     /**
@@ -253,19 +263,11 @@ export type ModifyChainUtils = {
      */
     HtmlPlugin: typeof HtmlRspackPlugin;
 };
-interface PluginInstance {
-    apply: (compiler: any) => void;
-    [k: string]: any;
-}
 export type ModifyBundlerChainUtils = ModifyChainUtils & {
-    bundler: {
-        BannerPlugin: PluginInstance;
-        DefinePlugin: PluginInstance;
-        IgnorePlugin: PluginInstance;
-        ProvidePlugin: PluginInstance;
-        SourceMapDevToolPlugin: PluginInstance;
-        HotModuleReplacementPlugin: PluginInstance;
-    };
+    /**
+     * @deprecated Use `rspack` instead.
+     */
+    bundler: typeof rspack;
 };
 export type ModifyBundlerChainFn = (chain: RspackChain, utils: ModifyBundlerChainUtils) => MaybePromise<void>;
 export type CreateAsyncHook<Callback extends (...args: any[]) => any> = {

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

@@ -1,7 +1,7 @@
 import type { Logger } from '../logger';
 import type { ModifyRspackConfigUtils, NarrowedRspackConfig, NormalizedConfig, NormalizedEnvironmentConfig, RsbuildConfig } from './config';
 import type { RsbuildContext } from './context';
-import type { EnvironmentContext, ModifyBundlerChainFn, ModifyEnvironmentConfigFn, ModifyHTMLFn, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterDevCompileFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeDevCompileFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnExitFn } from './hooks';
+import type { EnvironmentContext, ModifyBundlerChainFn, ModifyEnvironmentConfigFn, ModifyHTMLFn, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterDevCompileFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartPreviewServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeDevCompileFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartPreviewServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnExitFn } from './hooks';
 import type { AddPluginsOptions, RsbuildInstance, RsbuildTarget } from './rsbuild';
 import type { Rspack } from './rspack';
 import type { Falsy, MaybePromise } from './utils';
@@ -365,10 +365,12 @@ export type ResolveHandler = (context: {
 }) => Promise<void> | void;
 export type ResolveHook = (handler: ResolveHandler) => void;
 export type ProcessAssetsHook = (descriptor: ProcessAssetsDescriptor, handler: ProcessAssetsHandler) => void;
-declare function getNormalizedConfig(): NormalizedConfig;
-declare function getNormalizedConfig(options: {
-    environment: string;
-}): NormalizedEnvironmentConfig;
+export type GetNormalizedConfig = {
+    (): NormalizedConfig;
+    (options: {
+        environment: string;
+    }): NormalizedEnvironmentConfig;
+};
 /**
  * The API interface provided to Rsbuild plugins through the `setup` function.
  * It allows plugins to interact with the build process, modify configurations,
@@ -394,11 +396,12 @@ export type RsbuildPluginAPI = Readonly<{
      * environment, this method must be called after the
      * `modifyRsbuildConfig` hook is executed.
      */
-    getNormalizedConfig: typeof getNormalizedConfig;
+    getNormalizedConfig: GetNormalizedConfig;
     /**
      * A logger instance used to output log information in a unified format.
      * Use this instead of `console.log` to maintain consistent logging with Rsbuild.
-     * Equivalent to `import { logger } from '@rsbuild/core'`.
+     * It is associated with the current Rsbuild instance and reflects
+     * `config.customLogger` when provided.
      */
     logger: Logger;
     /**
@@ -471,11 +474,11 @@ export type RsbuildPluginAPI = Readonly<{
      */
     onAfterStartDevServer: PluginHook<OnAfterStartDevServerFn>;
     /**
-     * Called after starting the production preview server, you can get the port
+     * Called after starting the preview server, you can get the port
      * number with the `port` parameter, and the page routes info with the
      * `routes` parameter.
      */
-    onAfterStartProdServer: PluginHook<OnAfterStartProdServerFn>;
+    onAfterStartPreviewServer: PluginHook<OnAfterStartPreviewServerFn>;
     /**
      * A callback function that is triggered before the production build is executed.
      */
@@ -499,9 +502,9 @@ export type RsbuildPluginAPI = Readonly<{
      */
     onBeforeStartDevServer: PluginHook<OnBeforeStartDevServerFn>;
     /**
-     * Called before starting the production preview server.
+     * Called before starting the preview server.
      */
-    onBeforeStartProdServer: PluginHook<OnBeforeStartProdServerFn>;
+    onBeforeStartPreviewServer: PluginHook<OnBeforeStartPreviewServerFn>;
     /**
      * Called when closing the build instance. Can be used to perform cleanup
      * operations when the building is closed.

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

@@ -1,7 +1,8 @@
 import type { Compiler, MultiCompiler } from '@rspack/core';
 import type { LoadEnvOptions } from '../loadEnv';
+import type { Logger } from '../logger';
 import type { RsbuildDevServer } from '../server/devServer';
-import type { StartServerResult } from '../server/helper';
+import type { StartDevServerResult, StartPreviewServerResult } from '../server/helper';
 import type { NormalizedConfig, NormalizedEnvironmentConfig, RsbuildConfig } from './config';
 import type { RsbuildContext } from './context';
 import type { RsbuildPlugin, RsbuildPluginAPI } from './plugin';
@@ -141,7 +142,7 @@ export type ResolvedCreateRsbuildOptions = Required<Pick<CreateRsbuildOptions, '
     rsbuildConfig: RsbuildConfig;
 };
 export type CreateDevServer = (options?: CreateDevServerOptions) => Promise<RsbuildDevServer>;
-export type StartDevServer = (options?: StartDevServerOptions) => Promise<StartServerResult>;
+export type StartDevServer = (options?: StartDevServerOptions) => Promise<StartDevServerResult>;
 export type InspectConfig = (options?: InspectConfigOptions) => Promise<InspectConfigResult>;
 export type AddPluginsOptions = {
     /**
@@ -157,6 +158,12 @@ export type AddPluginsOptions = {
 };
 export type AddPlugins = (plugins: (RsbuildPlugin | Falsy)[], options?: AddPluginsOptions) => void;
 export type RsbuildInstance = {
+    /**
+     * The logger associated with the current Rsbuild instance.
+     * It reflects `config.customLogger` when provided, otherwise uses a logger
+     * created specifically for the current Rsbuild instance.
+     */
+    logger: Logger;
     /**
      * Register one or more Rsbuild plugins, which can be called multiple times.
      * This method needs to be called before compiling. If it is called after
@@ -194,7 +201,7 @@ export type RsbuildInstance = {
      * Start a server to preview the production build locally.
      * This method should be executed after `rsbuild.build`.
      */
-    preview: (options?: PreviewOptions) => Promise<StartServerResult>;
+    preview: (options?: PreviewOptions) => Promise<StartPreviewServerResult>;
     /**
      * Initialize and return the internal Rspack configurations used by Rsbuild.
      * This method processes all plugins and configurations to generate the final
@@ -240,7 +247,7 @@ export type RsbuildInstance = {
      * 2. Watch for file changes and trigger recompilation.
      */
     startDevServer: StartDevServer;
-} & Pick<RsbuildPluginAPI, 'context' | 'expose' | 'getNormalizedConfig' | 'getRsbuildConfig' | 'isPluginExists' | 'modifyEnvironmentConfig' | 'modifyRsbuildConfig' | 'onAfterBuild' | 'onAfterCreateCompiler' | 'onAfterDevCompile' | 'onAfterEnvironmentCompile' | 'onAfterStartDevServer' | 'onAfterStartProdServer' | 'onBeforeBuild' | 'onBeforeCreateCompiler' | 'onBeforeDevCompile' | 'onBeforeEnvironmentCompile' | 'onBeforeStartDevServer' | 'onBeforeStartProdServer' | 'onCloseBuild' | 'onCloseDevServer' | 'onDevCompileDone' | 'onExit'>;
+} & Pick<RsbuildPluginAPI, 'context' | 'expose' | 'getNormalizedConfig' | 'getRsbuildConfig' | 'isPluginExists' | 'modifyEnvironmentConfig' | 'modifyRsbuildConfig' | 'onAfterBuild' | 'onAfterCreateCompiler' | 'onAfterDevCompile' | 'onAfterEnvironmentCompile' | 'onAfterStartDevServer' | 'onAfterStartPreviewServer' | 'onBeforeBuild' | 'onBeforeCreateCompiler' | 'onBeforeDevCompile' | 'onBeforeEnvironmentCompile' | 'onBeforeStartDevServer' | 'onBeforeStartPreviewServer' | 'onCloseBuild' | 'onCloseDevServer' | 'onDevCompileDone' | 'onExit'>;
 export type RsbuildTarget = 'web' | 'node' | 'web-worker';
 export type RsbuildEntryDescription = Rspack.EntryDescription & {
     /**

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

@@ -1,6 +1,6 @@
 import type { CssExtractRspackLoaderOptions, CssExtractRspackPluginOptions } from '@rspack/core';
-import type Connect from 'connect';
-import type HtmlRspackPlugin from '../../compiled/html-rspack-plugin/index.js';
+import type * as Connect from '../../compiled/connect-next';
+import type HtmlRspackPlugin from '../../compiled/html-rspack-plugin';
 import type { AcceptedPlugin, ProcessOptions } from '../../compiled/postcss';
 import type { Rspack } from './rspack';
 import type { LiteralUnion } from './utils';
@@ -169,15 +169,24 @@ export interface StyleLoaderOptions {
      */
     attributes?: Record<string, string>;
     /**
-     * By default, the style-loader appends <style>/<link> elements to the end of the style target, which is the <head> tag of the page unless specified by insert.
+     * By default, style-loader appends <style>/<link> elements to the end of the style target,
+     * which is the <head> tag of the page unless specified by insert.
      * This will cause CSS created by the loader to take priority over CSS already present in the target.
      * You can use other values if the standard behavior is not suitable for you, but we do not recommend doing this.
+     * If you target an iframe, make sure you have sufficient access rights.
+     *
+     * Supports:
+     * - a CSS selector where styles are injected
+     * - an absolute path to a custom insert module
      *
      * @default 'head'
      */
-    insert?: LiteralUnion<'head' | 'body', string> | ((element: HTMLElement) => void);
+    insert?: LiteralUnion<'head' | 'body', string>;
     /**
-     * Allows to setup absolute path to custom function that allows to override default behavior styleTagTransform.
+     * Allows to setup an absolute path to a custom module that overrides
+     * the default styleTagTransform behavior.
+     *
+     * @default undefined
      */
-    styleTagTransform?: string | ((css: string, styleElement: HTMLStyleElement, options: Record<string, any>) => void);
+    styleTagTransform?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "2.0.0-beta.0",
+  "version": "2.0.0-beta.10",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.rs",
   "bugs": {
@@ -36,10 +36,8 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@rspack/core": "2.0.0-alpha.1",
-    "@rspack/lite-tapable": "~1.1.0",
-    "@swc/helpers": "^0.5.18",
-    "jiti": "^2.6.1"
+    "@rspack/core": "2.0.0-beta.8",
+    "@swc/helpers": "^0.5.19"
   },
   "peerDependencies": {
     "core-js": ">= 3.0.0"
@@ -52,46 +50,45 @@
   "devDependencies": {
     "@jridgewell/remapping": "^2.3.5",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@rslib/core": "0.19.3",
-    "@types/connect": "3.4.38",
+    "@rslib/core": "0.20.0",
     "@types/cors": "^2.8.19",
-    "@types/node": "^24.10.9",
+    "@types/node": "^24.12.0",
     "@types/on-finished": "2.3.5",
     "@types/range-parser": "^1.2.7",
     "@types/ws": "^8.18.1",
     "browserslist-load-config": "1.0.1",
-    "cac": "^6.7.14",
+    "cac": "^7.0.0",
     "chokidar": "^5.0.0",
-    "connect": "3.7.0",
+    "connect-next": "4.0.0",
     "cors": "^2.8.6",
-    "css-loader": "7.1.2",
+    "css-loader": "7.1.4",
     "deepmerge": "^4.3.1",
     "dotenv-expand": "12.0.3",
-    "html-rspack-plugin": "6.1.6",
-    "http-proxy-middleware": "^2.0.9",
-    "launch-editor-middleware": "^2.12.0",
-    "memfs": "^4.56.10",
+    "html-rspack-plugin": "6.1.7",
+    "http-proxy-middleware": "^3.0.5",
+    "jiti": "^2.6.1",
+    "launch-editor-middleware": "^2.13.2",
+    "memfs": "^4.57.1",
     "mrmime": "^2.0.1",
     "on-finished": "2.4.1",
     "open": "^11.0.0",
-    "picocolors": "^1.1.1",
-    "postcss": "^8.5.6",
+    "postcss": "^8.5.8",
     "postcss-load-config": "6.0.1",
-    "postcss-loader": "8.2.0",
-    "prebundle": "1.6.2",
+    "postcss-loader": "8.2.1",
+    "prebundle": "1.6.4",
     "range-parser": "^1.2.1",
     "reduce-configs": "^1.1.1",
-    "rslog": "^1.3.2",
-    "rspack-chain": "^2.0.0-alpha.0",
+    "rslog": "^2.1.0",
+    "rspack-chain": "^2.0.0-beta.1",
     "rspack-manifest-plugin": "5.2.1",
     "sirv": "^3.0.2",
     "stacktrace-parser": "^0.1.11",
-    "style-loader": "3.3.4",
-    "tinyglobby": "0.2.14",
-    "typescript": "^5.9.3",
-    "webpack": "^5.104.1",
+    "style-loader": "^4.0.0",
+    "supports-color": "^10.2.2",
+    "tinyglobby": "^0.2.15",
+    "typescript": "^6.0.2",
     "webpack-merge": "6.0.1",
-    "ws": "^8.19.0"
+    "ws": "^8.20.0"
   },
   "engines": {
     "node": "^20.19.0 || >=22.12.0"