@rsbuild/core 1.4.13 → 1.4.15

package/dist-types/cli/index.d.ts

@@ -1 +1 @@
-export declare function runCLI(): Promise<void>;
+export declare function runCLI(): void;

package/dist-types/createContext.d.ts

@@ -1,6 +1,6 @@
 import type { InternalContext, NormalizedEnvironmentConfig, ResolvedCreateRsbuildOptions, RsbuildConfig, RsbuildContext } from './types';
-export declare function getBrowserslist(path: string): Promise<string[] | null>;
-export declare function getBrowserslistByEnvironment(path: string, config: NormalizedEnvironmentConfig): Promise<string[]>;
+export declare function getBrowserslist(path: string): string[] | null;
+export declare function getBrowserslistByEnvironment(path: string, config: NormalizedEnvironmentConfig): string[];
 export declare function updateEnvironmentContext(context: InternalContext, configs: Record<string, NormalizedEnvironmentConfig>): Promise<void>;
 export declare function updateContextByNormalizedConfig(context: InternalContext): void;
 export declare function createPublicContext(context: RsbuildContext): Readonly<RsbuildContext>;

package/dist-types/helpers/index.d.ts

@@ -19,7 +19,7 @@ export declare const cloneDeep: <T>(value: T) => T;
  * we should check that the Rspack version is greater than the minimum
  * supported version.
  */
-export declare const isSatisfyRspackVersion: (originalVersion: string) => Promise<boolean>;
+export declare const isSatisfyRspackVersion: (originalVersion: string) => boolean;
 export declare const removeLeadingSlash: (s: string) => string;
 export declare const removeTailingSlash: (s: string) => string;
 export declare const addTrailingSlash: (s: string) => string;
@@ -40,7 +40,7 @@ export declare const isURL: (str: string) => boolean;
 export declare const createVirtualModule: (content: string) => string;
 export declare function isWebTarget(target: RsbuildTarget | RsbuildTarget[]): boolean;
 export declare const isMultiCompiler: (compiler: Rspack.Compiler | Rspack.MultiCompiler) => compiler is Rspack.MultiCompiler;
-export declare function pick<T, U extends keyof T>(obj: T, keys: ReadonlyArray<U>): Pick<T, U>;
+export declare function pick<T, U extends keyof T>(obj: T, keys: readonly U[]): Pick<T, U>;
 export declare const camelCase: (input: string) => string;
 export declare const prettyTime: (seconds: number) => string;
 /**

package/dist-types/index.d.ts

@@ -19,4 +19,4 @@ export { type Logger, logger } from './logger';
 export { mergeRsbuildConfig } from './mergeConfig';
 export type { RsbuildDevServer } from './server/devServer';
 export type { StartServerResult } from './server/helper';
-export type { AliasStrategy, AppIcon, AppIconItem, Build, BuildOptions, BundlerPluginInstance, Charset, CleanDistPath, CleanDistPathObject, ClientConfig, CliShortcut, CompressOptions, ConfigChain, ConfigChainWithContext, Connect, ConsoleType, CreateCompiler, CreateRsbuildOptions, CrossOrigin, CSSLoaderOptions, CSSModules, CSSModulesLocalsConvention, DataUriLimit, Decorators, DevConfig, DistPathConfig, EnvironmentConfig, EnvironmentContext, FilenameConfig, HistoryApiFallbackContext, HistoryApiFallbackOptions, HtmlBasicTag, HtmlConfig, HtmlFallback, HtmlRspackPlugin, HtmlTag, HtmlTagContext, HtmlTagDescriptor, HtmlTagHandler, InlineChunkConfig, InlineChunkTest, InlineChunkTestFunction, InspectConfigOptions, InspectConfigResult, InternalContext, LegalComments, LogLevel, ManifestConfig, ManifestData, ManifestObjectConfig, MergedEnvironmentConfig, MetaAttrs, MetaOptions, Minify, ModifyBundlerChainFn, ModifyBundlerChainUtils, ModifyChainUtils, ModifyEnvironmentConfigFn, ModifyEnvironmentConfigUtils, ModifyHTMLContext, ModifyHTMLFn, ModifyHTMLTagsContext, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, ModifyRsbuildConfigUtils, ModifyRspackConfigFn, ModifyRspackConfigUtils, ModifyWebpackChainFn, ModifyWebpackChainUtils, ModifyWebpackConfigFn, ModifyWebpackConfigUtils, ModuleFederationConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedToolsConfig, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, OutputConfig, OutputStructure, PerformanceConfig, PluginManager, Polyfill, PostCSSLoaderOptions, PostCSSOptions, PostCSSPlugin, PreconnectOption, PreviewOptions, PrintUrls, ProcessAssetsDescriptor, ProcessAssetsHandler, ProcessAssetsHook, ProgressBarConfig, ProxyBypass, ProxyConfig, ProxyFilter, ProxyOptions, PublicDir, PublicDirOptions, RequestHandler, ResolvedCreateRsbuildOptions, ResolveHandler, ResolveHook, ResourceHintsIncludeType, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildEntryDescription, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildProvider, RsbuildProviderHelpers, RsbuildTarget, RspackChain, RspackRule, ScriptInject, ScriptLoading, SecurityConfig, ServerConfig, SetupMiddlewaresContext, SetupMiddlewaresFn, SourceConfig, SourceMap, SplitChunks, SriAlgorithm, SriOptions, StartDevServerOptions, StyleLoaderOptions, ToolsConfig, TransformContext, TransformDescriptor, TransformHandler, TransformHook, TransformImport, WatchFiles, } from './types';
+export type { AliasStrategy, AppIcon, AppIconItem, Build, BuildOptions, BundlerPluginInstance, Charset, CleanDistPath, CleanDistPathObject, ClientConfig, CliShortcut, CompressOptions, ConfigChain, ConfigChainWithContext, Connect, ConsoleType, CreateCompiler, CreateRsbuildOptions, CrossOrigin, CSSLoaderOptions, CSSModules, CSSModulesLocalsConvention, DataUriLimit, Decorators, DevConfig, DistPathConfig, EnvironmentConfig, EnvironmentContext, FilenameConfig, HistoryApiFallbackContext, HistoryApiFallbackOptions, HtmlBasicTag, HtmlConfig, HtmlFallback, HtmlRspackPlugin, HtmlTag, HtmlTagContext, HtmlTagDescriptor, HtmlTagHandler, InitConfigsOptions, InlineChunkConfig, InlineChunkTest, InlineChunkTestFunction, InspectConfigOptions, InspectConfigResult, InternalContext, LegalComments, LogLevel, ManifestConfig, ManifestData, ManifestObjectConfig, MergedEnvironmentConfig, MetaAttrs, MetaOptions, Minify, ModifyBundlerChainFn, ModifyBundlerChainUtils, ModifyChainUtils, ModifyEnvironmentConfigFn, ModifyEnvironmentConfigUtils, ModifyHTMLContext, ModifyHTMLFn, ModifyHTMLTagsContext, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, ModifyRsbuildConfigUtils, ModifyRspackConfigFn, ModifyRspackConfigUtils, ModifyWebpackChainFn, ModifyWebpackChainUtils, ModifyWebpackConfigFn, ModifyWebpackConfigUtils, ModuleFederationConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedToolsConfig, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, OutputConfig, OutputStructure, PerformanceConfig, PluginManager, Polyfill, PostCSSLoaderOptions, PostCSSOptions, PostCSSPlugin, PreconnectOption, PreviewOptions, PrintUrls, ProcessAssetsDescriptor, ProcessAssetsHandler, ProcessAssetsHook, ProgressBarConfig, ProxyBypass, ProxyConfig, ProxyFilter, ProxyOptions, PublicDir, PublicDirOptions, RequestHandler, ResolvedCreateRsbuildOptions, ResolveHandler, ResolveHook, ResourceHintsIncludeType, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildEntryDescription, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildProvider, RsbuildProviderHelpers, RsbuildTarget, RspackChain, RspackRule, ScriptInject, ScriptLoading, SecurityConfig, ServerConfig, SetupMiddlewaresContext, SetupMiddlewaresFn, SourceConfig, SourceMap, SplitChunks, SriAlgorithm, SriOptions, StartDevServerOptions, StyleLoaderOptions, ToolsConfig, TransformContext, TransformDescriptor, TransformHandler, TransformHook, TransformImport, WatchFiles, } from './types';

package/dist-types/inspectConfig.d.ts

@@ -7,10 +7,10 @@ export declare const getRsbuildInspectConfig: ({ normalizedConfig, inspectOption
 }) => {
     rawRsbuildConfig: string;
     rsbuildConfig: InspectConfigResult["origin"]["rsbuildConfig"];
-    rawEnvironmentConfigs: Array<{
+    rawEnvironmentConfigs: {
         name: string;
         content: string;
-    }>;
+    }[];
     environmentConfigs: InspectConfigResult["origin"]["environmentConfigs"];
 };
 type RawConfig = {

package/dist-types/provider/rspackConfig.d.ts

@@ -1,5 +1,5 @@
 import type { EnvironmentContext, InternalContext, ModifyChainUtils, ModifyRspackConfigUtils, RsbuildTarget, Rspack } from '../types';
-export declare function getConfigUtils(config: Rspack.Configuration, chainUtils: ModifyChainUtils): Promise<ModifyRspackConfigUtils>;
+export declare function getConfigUtils(getCurrentConfig: () => Rspack.Configuration, chainUtils: ModifyChainUtils): ModifyRspackConfigUtils;
 export declare function getChainUtils(target: RsbuildTarget, environment: EnvironmentContext): ModifyChainUtils;
 export declare function generateRspackConfig({ target, context, environment, }: {
     environment: string;

package/dist-types/restart.d.ts

@@ -1,6 +1,6 @@
 import type { ChokidarOptions } from '../compiled/chokidar/index.js';
 import type { RsbuildInstance } from './types';
-type Cleaner = () => Promise<unknown> | unknown;
+type Cleaner = () => unknown;
 /**
  * Add a cleaner to handle side effects
  */

package/dist-types/rspack-plugins/resource-hints/extractChunks.d.ts

@@ -17,7 +17,7 @@
  */
 import type { Chunk, Compilation } from '@rspack/core';
 import type { ResourceHintsIncludeType } from '../../types';
-export declare function extractChunks(compilation: Compilation, includeType?: ResourceHintsIncludeType): Chunk[] | Array<{
+export declare function extractChunks(compilation: Compilation, includeType?: ResourceHintsIncludeType): Chunk[] | {
     files: string[];
     auxiliaryFiles?: string[];
-}>;
+}[];

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

@@ -1,5 +1,5 @@
-import type { CliShortcut, NormalizedDevConfig } from '../types/config';
-export declare const isCliShortcutsEnabled: (devConfig: NormalizedDevConfig) => boolean;
+import type { CliShortcut, NormalizedConfig } from '../types/config';
+export declare const isCliShortcutsEnabled: (config: NormalizedConfig) => boolean;
 export declare function setupCliShortcuts({ help, openPage, closeServer, printUrls, restartServer, customShortcuts, }: {
     help?: boolean | string;
     openPage: () => Promise<void>;

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

@@ -1,12 +1,12 @@
-import type { EnvironmentContext, NormalizedDevConfig, NormalizedServerConfig, Rspack } from '../types';
+import type { EnvironmentContext, NormalizedConfig, Rspack } from '../types';
 import { type CompilationMiddleware } from './compilationMiddleware';
 import { SocketServer } from './socketServer';
 type Options = {
+    config: NormalizedConfig;
+    compiler: Rspack.Compiler | Rspack.MultiCompiler;
     publicPaths: string[];
+    resolvedPort: number;
     environments: Record<string, EnvironmentContext>;
-    dev: NormalizedDevConfig;
-    server: NormalizedServerConfig;
-    compiler: Rspack.Compiler | Rspack.MultiCompiler;
 };
 /**
  * Setup compiler-related logic:
@@ -16,13 +16,13 @@ type Options = {
 export declare class CompilationManager {
     middleware: CompilationMiddleware;
     outputFileSystem: Rspack.OutputFileSystem;
-    private devConfig;
-    private serverConfig;
+    private config;
     compiler: Rspack.Compiler | Rspack.MultiCompiler;
     private environments;
     private publicPaths;
     socketServer: SocketServer;
-    constructor({ dev, server, compiler, publicPaths, environments }: Options);
+    private resolvedPort;
+    constructor({ config, compiler, publicPaths, resolvedPort, environments, }: Options);
     init(): Promise<void>;
     /**
      * Call `compiler.watch()` to start compiling.

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

@@ -1,5 +1,5 @@
 import type { Compiler, MultiCompiler, Stats } from '@rspack/core';
-import type { Connect, DevConfig, EnvironmentContext, ServerConfig } from '../types';
+import type { Connect, EnvironmentContext, NormalizedConfig } from '../types';
 export declare const isClientCompiler: (compiler: {
     options: {
         target?: Compiler["options"]["target"];
@@ -14,15 +14,6 @@ export declare const setupServerHooks: ({ compiler, token, callbacks: { onDone,
     token: string;
     callbacks: ServerCallbacks;
 }) => void;
-export type CompilationMiddlewareOptions = {
-    /**
-     * Should trigger when compiler hook called
-     */
-    callbacks: ServerCallbacks;
-    devConfig: DevConfig;
-    serverConfig: ServerConfig;
-    environments: Record<string, EnvironmentContext>;
-};
 export type CompilationMiddleware = Connect.NextHandleFunction & {
     close: (callback: (err: Error | null | undefined) => void) => any;
     watch: () => void;
@@ -33,4 +24,13 @@ export type CompilationMiddleware = Connect.NextHandleFunction & {
  * - Inject the HMR client path into page
  * - Notify server when compiler hooks are triggered
  */
-export declare const getCompilationMiddleware: (compiler: Compiler | MultiCompiler, options: CompilationMiddlewareOptions) => Promise<CompilationMiddleware>;
+export declare const getCompilationMiddleware: ({ config, compiler, callbacks, environments, resolvedPort, }: {
+    config: NormalizedConfig;
+    compiler: Compiler | MultiCompiler;
+    /**
+     * Should trigger when compiler hook called
+     */
+    callbacks: ServerCallbacks;
+    environments: Record<string, EnvironmentContext>;
+    resolvedPort: number;
+}) => Promise<CompilationMiddleware>;

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

@@ -1,20 +1,19 @@
-import type { DevConfig, InternalContext, RequestHandler, ServerConfig } from '../types';
+import type { InternalContext, NormalizedConfig, RequestHandler } from '../types';
 import type { CompilationManager } from './compilationManager';
 import type { RsbuildDevServer } from './devServer';
 import type { UpgradeEvent } from './helper';
 export type RsbuildDevMiddlewareOptions = {
-    pwd: string;
-    dev: DevConfig;
-    devServerAPI: RsbuildDevServer;
-    server: ServerConfig;
+    config: NormalizedConfig;
     context: InternalContext;
     compilationManager?: CompilationManager;
+    devServerAPI: RsbuildDevServer;
     /**
      * Callbacks returned by the `onBeforeStartDevServer` hook.
      */
     postCallbacks: (() => void)[];
+    pwd: string;
 };
-export type Middlewares = Array<RequestHandler | [string, RequestHandler]>;
+export type Middlewares = (RequestHandler | [string, RequestHandler])[];
 export type GetDevMiddlewaresResult = {
     close: () => Promise<void>;
     onUpgrade: UpgradeEvent;

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

@@ -4,5 +4,5 @@ export type ServerUtils = {
     environment: EnvironmentContext;
 };
 export declare const loadBundle: <T>(stats: Rspack.Stats, entryName: string, utils: ServerUtils) => Promise<T>;
-export declare const getTransformedHtml: (entryName: string, utils: ServerUtils) => Promise<string>;
-export declare const createCacheableFunction: <T>(getter: (stats: Rspack.Stats, entryName: string, utils: ServerUtils) => Promise<T>) => (stats: Rspack.Stats, entryName: string, utils: ServerUtils) => Promise<T>;
+export declare const getTransformedHtml: (entryName: string, utils: ServerUtils) => string;
+export declare const createCacheableFunction: <T>(getter: (stats: Rspack.Stats, entryName: string, utils: ServerUtils) => Promise<T> | T) => (stats: Rspack.Stats, entryName: string, utils: ServerUtils) => Promise<T>;

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

@@ -29,10 +29,10 @@ export declare const stripBase: (path: string, base: string) => string;
 export declare const getRoutes: (context: InternalContext) => Routes;
 export declare const formatRoutes: (entry: RsbuildEntry, base: string, distPathPrefix: string | undefined, outputStructure: OutputStructure | undefined) => Routes;
 export declare function printServerURLs({ urls: originalUrls, port, routes, protocol, printUrls, trailingLineBreak, }: {
-    urls: Array<{
+    urls: {
         url: string;
         label: string;
-    }>;
+    }[];
     port: number;
     routes: Routes;
     protocol: string;

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

@@ -1,4 +1,3 @@
-import type { DevConfig, ServerConfig } from '../types/config';
 /**
  * Checks if localhost resolves differently between node's default DNS lookup
  * and explicit DNS lookup.
@@ -7,4 +6,4 @@ import type { DevConfig, ServerConfig } from '../types/config';
  * This helps detect cases where IPv4/IPv6 resolution might vary.
  */
 export declare function getLocalhostResolvedAddress(): Promise<string | undefined>;
-export declare function getResolvedClientConfig(clientConfig: DevConfig['client'], serverConfig: ServerConfig): Promise<DevConfig['client']>;
+export declare function resolveHostname(host?: string | undefined): Promise<string>;

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

@@ -1,10 +1,9 @@
 import type { FSWatcher } from '../../compiled/chokidar/index.js';
-import type { ChokidarOptions, DevConfig, ServerConfig } from '../types';
+import type { ChokidarOptions, NormalizedConfig } from '../types';
 import type { CompilationManager } from './compilationManager';
 type WatchFilesOptions = {
-    dev: DevConfig;
-    server: ServerConfig;
     root: string;
+    config: NormalizedConfig;
     compilationManager?: CompilationManager;
 };
 export type WatchFilesResult = {

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

@@ -214,7 +214,7 @@ export interface SourceConfig {
     /**
      * Used to import the code and style of the component library on demand.
      */
-    transformImport?: TransformImportFn | Array<TransformImport | TransformImportFn>;
+    transformImport?: TransformImportFn | (TransformImport | TransformImportFn)[];
     /**
      * Configure a custom tsconfig.json file path to use, can be a relative or absolute path.
      * @default 'tsconfig.json'
@@ -266,10 +266,10 @@ export type HistoryApiFallbackOptions = {
     index?: string;
     htmlAcceptHeaders?: string[];
     disableDotRule?: true;
-    rewrites?: Array<{
+    rewrites?: {
         from: RegExp;
         to: HistoryApiFallbackTo;
-    }>;
+    }[];
 };
 export type PrintUrls = boolean | ((params: {
     urls: string[];
@@ -447,7 +447,7 @@ export type BuildCacheOptions = {
      * when any value in the array changes.
      * @default undefined
      */
-    cacheDigest?: Array<string | undefined>;
+    cacheDigest?: (string | undefined)[];
     /**
      * An array of files containing build dependencies.
      * Rspack will use the hash of each of these files to invalidate the persistent cache.
@@ -506,7 +506,7 @@ export interface PreconnectOption {
      */
     crossorigin?: boolean;
 }
-export type Preconnect = Array<string | PreconnectOption>;
+export type Preconnect = (string | PreconnectOption)[];
 export type DnsPrefetch = string[];
 export type ResourceHintsIncludeType = 'async-chunks' | 'initial' | 'all-assets' | 'all-chunks';
 export type ResourceHintsFilterFn = (filename: string) => boolean;
@@ -1421,6 +1421,7 @@ export type CliShortcut = {
      */
     action: () => void | Promise<void>;
 };
+export type WriteToDisk = boolean | ((filename: string) => boolean);
 export interface DevConfig {
     /**
      * Whether to enable Hot Module Replacement.
@@ -1472,7 +1473,7 @@ export interface DevConfig {
      * Controls whether the build output from development mode is written to disk.
      * @default false
      */
-    writeToDisk?: boolean | ((filename: string) => boolean);
+    writeToDisk?: WriteToDisk;
     /**
      * This option allows you to configure a list of globs/directories/files to watch for
      * file changes.
@@ -1531,7 +1532,7 @@ export type RsbuildConfigMeta = {
 /**
  * Only some dev options can be defined in the environment config
  */
-export type AllowedEnvironmentDevKeys = 'hmr' | 'liveReload' | 'assetPrefix' | 'progressBar' | 'lazyCompilation' | 'writeToDisk';
+export type AllowedEnvironmentDevKeys = 'hmr' | 'client' | 'liveReload' | 'assetPrefix' | 'progressBar' | 'lazyCompilation' | 'writeToDisk';
 /**
  * The Rsbuild config to run in the specified environment.
  * */

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

@@ -45,10 +45,10 @@ export type OnBeforeStartDevServerFn = (params: {
     environments: Record<string, EnvironmentContext>;
 }) => MaybePromise<(() => void) | void>;
 export type OnBeforeStartProdServerFn = () => MaybePromise<void>;
-export type Routes = Array<{
+export type Routes = {
     entryName: string;
     pathname: string;
-}>;
+}[];
 export type OnAfterStartDevServerFn = (params: {
     port: number;
     routes: Routes;
@@ -106,7 +106,7 @@ export type ModifyRsbuildConfigUtils = {
     /** Merge multiple Rsbuild config objects into one. */
     mergeRsbuildConfig: (...configs: RsbuildConfig[]) => RsbuildConfig;
 };
-type ArrayAtLeastOne<A, B> = [A, ...Array<A | B>] | [...Array<A | B>, A];
+type ArrayAtLeastOne<A, B> = [A, ...(A | B)[]] | [...(A | B)[], A];
 export type ModifyEnvironmentConfigUtils = {
     /** environment name. */
     name: string;

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

@@ -51,6 +51,10 @@ export type EnvironmentAsyncHook<Callback extends (...args: any[]) => T, T = any
          * The parameters to pass to each callback
          */
         args: Parameters<Callback>;
+        /**
+         * The callback function to be executed after each callback
+         */
+        afterEach?: (args: Parameters<Callback>) => void;
     }) => Promise<Parameters<Callback>>;
     /**
      * Executes callbacks in sequence independently and collects all their results into an array.

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

@@ -4,7 +4,7 @@ import type * as providerHelpers from '../provider/helpers';
 import type { RsbuildDevServer } from '../server/devServer';
 import type { StartServerResult } from '../server/helper';
 import type { NormalizedConfig, NormalizedEnvironmentConfig, RsbuildConfig } from './config';
-import type { InternalContext } from './context';
+import type { InternalContext, RsbuildContext } from './context';
 import type { PluginManager, RsbuildPlugin, RsbuildPluginAPI } from './plugin';
 import type { Rspack } from './rspack';
 import type { WebpackConfig } from './thirdParty';
@@ -62,6 +62,7 @@ export type Build = (options?: BuildOptions) => Promise<{
      */
     stats?: Rspack.Stats | Rspack.MultiStats;
 }>;
+export type InitConfigsOptions = Pick<RsbuildContext, 'action'>;
 export type InspectConfigOptions = {
     /**
      * Inspect the config in the specified mode.
@@ -148,7 +149,7 @@ export type CreateDevServer = (options?: CreateDevServerOptions) => Promise<Rsbu
 export type StartDevServer = (options?: StartDevServerOptions) => Promise<StartServerResult>;
 export type ProviderInstance<B extends 'rspack' | 'webpack' = 'rspack'> = Pick<RsbuildInstance, 'build' | 'createCompiler' | 'createDevServer' | 'startDevServer'> & {
     readonly bundler: Bundler;
-    initConfigs: () => Promise<B extends 'rspack' ? Rspack.Configuration[] : WebpackConfig[]>;
+    initConfigs: (options?: InitConfigsOptions) => Promise<B extends 'rspack' ? Rspack.Configuration[] : WebpackConfig[]>;
     inspectConfig: (options?: InspectConfigOptions) => Promise<InspectConfigResult<B>>;
 };
 export type RsbuildProviderHelpers = typeof providerHelpers;
@@ -157,7 +158,7 @@ export type RsbuildProvider<B extends 'rspack' | 'webpack' = 'rspack'> = (option
     pluginManager: PluginManager;
     rsbuildOptions: ResolvedCreateRsbuildOptions;
     helpers: RsbuildProviderHelpers;
-}) => Promise<ProviderInstance<B>>;
+}) => Promise<ProviderInstance<B>> | ProviderInstance<B>;
 export type AddPluginsOptions = {
     /**
      * Insert before the specified plugin.
@@ -170,7 +171,7 @@ export type AddPluginsOptions = {
      */
     environment?: string;
 };
-export type AddPlugins = (plugins: Array<RsbuildPlugin | Falsy>, options?: AddPluginsOptions) => void;
+export type AddPlugins = (plugins: (RsbuildPlugin | Falsy)[], options?: AddPluginsOptions) => void;
 export type RsbuildInstance = {
     /**
      * Register one or more Rsbuild plugins, which can be called multiple times.
@@ -217,7 +218,7 @@ export type RsbuildInstance = {
      * since it's automatically invoked by methods like `rsbuild.build` and
      * `rsbuild.startDevServer`.
      */
-    initConfigs: () => Promise<Rspack.Configuration[]>;
+    initConfigs: (options?: InitConfigsOptions) => Promise<Rspack.Configuration[]>;
     /**
      * Inspect and debug Rsbuild's internal configurations. It provides access to:
      * - The resolved Rsbuild configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.4.13",
+  "version": "1.4.15",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.rs",
   "bugs": {
@@ -49,18 +49,18 @@
     "@rspack/core": "1.4.11",
     "@rspack/lite-tapable": "~1.0.1",
     "@swc/helpers": "^0.5.17",
-    "core-js": "~3.44.0",
+    "core-js": "~3.45.0",
     "jiti": "^2.5.1"
   },
   "devDependencies": {
-    "@rslib/core": "0.11.0",
+    "@rslib/core": "0.11.2",
     "@types/connect": "3.4.38",
     "@types/cors": "^2.8.19",
     "@types/node": "^22.17.0",
     "@types/on-finished": "2.3.5",
     "@types/webpack-bundle-analyzer": "4.7.0",
     "@types/ws": "^8.18.1",
-    "browserslist-load-config": "1.0.0",
+    "browserslist-load-config": "1.0.1",
     "cac": "^6.7.14",
     "chokidar": "^4.0.3",
     "connect": "3.7.0",
@@ -78,11 +78,11 @@
     "postcss": "^8.5.6",
     "postcss-load-config": "6.0.1",
     "postcss-loader": "8.1.1",
-    "prebundle": "1.4.0",
-    "reduce-configs": "^1.1.0",
+    "prebundle": "1.4.1",
+    "reduce-configs": "^1.1.1",
     "rsbuild-dev-middleware": "0.3.0",
-    "rslog": "^1.2.9",
-    "rspack-chain": "^1.3.1",
+    "rslog": "^1.2.11",
+    "rspack-chain": "^1.3.2",
     "rspack-manifest-plugin": "5.0.3",
     "sirv": "^3.0.1",
     "style-loader": "3.3.4",
@@ -98,7 +98,6 @@
   },
   "publishConfig": {
     "access": "public",
-    "provenance": true,
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {