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

package/dist-types/createContext.d.ts

@@ -1,11 +1,12 @@
+import type { Logger } from './logger';
 import type { InternalContext, NormalizedEnvironmentConfig, ResolvedCreateRsbuildOptions, RsbuildConfig, RsbuildContext } from './types';
 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>;
+export declare function createPublicContext(context: InternalContext): Readonly<RsbuildContext>;
 /**
  * Generate the actual context used in the build,
  * which can have a lot of overhead and take some side effects.
  */
-export declare function createContext(options: ResolvedCreateRsbuildOptions, userConfig: RsbuildConfig): Promise<InternalContext>;
+export declare function createContext(options: ResolvedCreateRsbuildOptions, userConfig: RsbuildConfig, logger: Logger): Promise<InternalContext>;

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

@@ -1,2 +1,3 @@
 import type { StatsError } from '@rspack/core';
-export declare function formatStatsError(stats: StatsError, root: string, level?: 'error' | 'warning'): string;
+import { type Logger } from '../logger';
+export declare function formatStatsError(stats: StatsError, root: string, level: "error" | "warning" | undefined, logger: Logger): string;

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

@@ -1,3 +1,4 @@
+import type { Logger } from '../logger';
 import type { Rspack } from '../types';
 export declare const isFileSync: (filePath: string) => boolean | undefined;
 export declare function isEmptyDir(path: string): boolean;
@@ -14,4 +15,4 @@ export declare function fileExistsByCompilation({ inputFileSystem }: Rspack.Comp
  * Read file asynchronously using Rspack compiler's filesystem.
  */
 export declare function readFileAsync(fs: NonNullable<Rspack.Compilation['inputFileSystem'] | Rspack.OutputFileSystem>, filename: string): Promise<Buffer | string>;
-export declare function emptyDir(dir: string, keep?: RegExp[], checkExists?: boolean): Promise<void>;
+export declare function emptyDir(dir: string, logger: Logger, keep?: RegExp[], checkExists?: boolean): Promise<void>;

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

@@ -1,4 +1,4 @@
-import color from 'picocolors';
+import { color } from '../../compiled/rslog';
 import RspackChain from '../../compiled/rspack-chain/types';
 import type { FilenameConfig, NormalizedConfig, NormalizedEnvironmentConfig, RsbuildTarget, Rspack } from '../types';
 export { require } from './vendors';

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

@@ -1,3 +1,4 @@
+import { type Logger } from '../logger';
 import type { ActionType, RsbuildStats, Rspack } from '../types';
 /**
  * If stats has errors, return stats errors directly
@@ -6,8 +7,8 @@ import type { ActionType, RsbuildStats, Rspack } from '../types';
  */
 export declare const getStatsErrors: ({ errors, children, }: RsbuildStats) => Rspack.StatsError[];
 export declare const getStatsWarnings: ({ warnings, children, }: RsbuildStats) => Rspack.StatsError[];
-export declare function getRsbuildStats(statsInstance: Rspack.Stats | Rspack.MultiStats, compiler: Rspack.Compiler | Rspack.MultiCompiler, action?: ActionType): RsbuildStats;
-export declare function formatStats(stats: RsbuildStats, hasErrors: boolean, root: string): {
+export declare function getRsbuildStats(statsInstance: Rspack.Stats | Rspack.MultiStats, compiler: Rspack.Compiler | Rspack.MultiCompiler, logger: Logger, action?: ActionType): RsbuildStats;
+export declare function formatStats(stats: RsbuildStats, hasErrors: boolean, root: string, logger: Logger): {
     message?: string;
     level?: string;
 };
@@ -15,4 +16,4 @@ export declare function formatStats(stats: RsbuildStats, hasErrors: boolean, roo
  * Remove the loader chain delimiter from the module identifier.
  * @example ./src/index.js!=!/node_modules/my-loader/index.js -> ./src/index.js
  */
-export declare const removeLoaderChainDelimiter: (moduleId: string) => string;
+export declare const removeLoaderChainDelimiter: (moduleId: string, logger: Logger) => string;

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

@@ -1,8 +1,6 @@
 type CompiledPackages = {
-    ws: typeof import('../../compiled/ws').default;
     'webpack-merge': typeof import('../../compiled/webpack-merge');
     'html-rspack-plugin': typeof import('../../compiled/html-rspack-plugin').default;
-    'http-proxy-middleware': typeof import('../../compiled/http-proxy-middleware');
 };
 export declare const require: NodeJS.Require;
 /**

package/dist-types/hooks.d.ts

@@ -1,4 +1,4 @@
-import type { AsyncHook, EnvironmentAsyncHook, InternalContext, ModifyBundlerChainFn, ModifyEnvironmentConfigFn, ModifyHTMLFn, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, ModifyRspackConfigFn, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterDevCompileFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeDevCompileFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnExitFn, Rspack } from './types';
+import type { AsyncHook, EnvironmentAsyncHook, InternalContext, ModifyBundlerChainFn, ModifyEnvironmentConfigFn, ModifyHTMLFn, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, ModifyRspackConfigFn, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterDevCompileFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartPreviewServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeDevCompileFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartPreviewServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnExitFn, Rspack } from './types';
 export declare function createEnvironmentAsyncHook<Callback extends (...args: any[]) => any>(): EnvironmentAsyncHook<Callback>;
 export declare function createAsyncHook<Callback extends (...args: any[]) => any>(): AsyncHook<Callback>;
 export declare function initHooks(): {
@@ -12,8 +12,8 @@ export declare function initHooks(): {
     onCloseDevServer: AsyncHook<OnCloseDevServerFn>;
     onAfterStartDevServer: AsyncHook<OnAfterStartDevServerFn>;
     onBeforeStartDevServer: AsyncHook<OnBeforeStartDevServerFn>;
-    onAfterStartProdServer: AsyncHook<OnAfterStartProdServerFn>;
-    onBeforeStartProdServer: AsyncHook<OnBeforeStartProdServerFn>;
+    onAfterStartPreviewServer: AsyncHook<OnAfterStartPreviewServerFn>;
+    onBeforeStartPreviewServer: AsyncHook<OnBeforeStartPreviewServerFn>;
     onAfterCreateCompiler: AsyncHook<OnAfterCreateCompilerFn>;
     onBeforeCreateCompiler: AsyncHook<OnBeforeCreateCompilerFn>;
     /**  The following hooks are related to the environment */

package/dist-types/index.d.ts

@@ -15,8 +15,9 @@ export type { ChainIdentifier } from './configChain';
 export { PLUGIN_CSS_NAME, PLUGIN_SWC_NAME } from './constants';
 export { defaultAllowedOrigins } from './defaultConfig';
 export { ensureAssetPrefix } from './helpers/url';
-export { type Logger, logger } from './logger';
+export { createLogger, type Logger, defaultLogger as 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, BuildResult, 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, ModuleFederationConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedResolveConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedSplitChunksConfig, NormalizedToolsConfig, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterDevCompileFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeDevCompileFn, 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, ResolveConfig, ResolvedCreateRsbuildOptions, ResolveHandler, ResolveHook, ResourceHintsIncludeType, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildEntryDescription, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildTarget, RspackChain, RspackRule, ScriptInject, ScriptLoading, SecurityConfig, ServerConfig, SetupMiddlewaresContext, SetupMiddlewaresFn, SourceConfig, SourceMap, SplitChunks, SplitChunksConfig, SplitChunksPreset, SriAlgorithm, SriOptions, StartDevServerOptions, StyleLoaderOptions, ToolsConfig, TransformContext, TransformDescriptor, TransformHandler, TransformHook, TransformImport, WatchFiles, } from './types';
+export type { RsbuildServerBase, ServerStartResult, StartDevServerResult, StartPreviewServerResult, } from './server/helper';
+export type { RsbuildPreviewServer } from './server/previewServer';
+export type { AliasStrategy, AppIcon, AppIconItem, Build, BuildOptions, BuildResult, 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, ModuleFederationConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedResolveConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedSplitChunksConfig, NormalizedToolsConfig, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterDevCompileFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartPreviewServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeDevCompileFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartPreviewServerFn, 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, ResolveConfig, ResolvedCreateRsbuildOptions, ResolveHandler, ResolveHook, ResourceHintsIncludeType, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildEntryDescription, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildTarget, RspackChain, RspackRule, ScriptInject, ScriptLoading, SecurityConfig, ServerConfig, SetupMiddlewaresContext, SetupMiddlewaresFn, SourceConfig, SourceMap, SourceMapExtract, SourceMapExtractTarget, SplitChunks, SplitChunksConfig, SplitChunksPreset, SriAlgorithm, SriOptions, StartDevServerOptions, StyleLoaderOptions, ToolsConfig, TransformContext, TransformDescriptor, TransformHandler, TransformHook, TransformImport, WatchFiles, } from './types';

package/dist-types/initPlugins.d.ts

@@ -1,5 +1,6 @@
+import type { Logger } from './logger';
 import type { InternalContext, NormalizedEnvironmentConfig, PluginManager, RsbuildPluginAPI } from './types';
-export declare function getHTMLPathByEntry(entryName: string, config: NormalizedEnvironmentConfig): string;
+export declare function getHTMLPathByEntry(entryName: string, config: NormalizedEnvironmentConfig, logger: Logger): string;
 export declare function initPluginAPI({ context, pluginManager, }: {
     context: InternalContext;
     pluginManager: PluginManager;

package/dist-types/logger.d.ts

@@ -1,4 +1,9 @@
 /**
+ * The default logger exported from this module is mainly for CLI/bootstrap
+ * scenarios and backwards compatibility. When writing core runtime code,
+ * prefer `context.logger` or `api.logger` so logs stay scoped to the current
+ * Rsbuild instance.
+ *
  * Logging message case convention:
  *
  * Info, ready, success and debug messages:
@@ -12,8 +17,9 @@
  * This convention helps distinguish between normal operations
  * and important alerts that require attention.
  */
-import { type Logger, logger } from '../compiled/rslog';
+import { createLogger as baseCreateLogger, type Logger, logger as defaultLogger } from '../compiled/rslog';
 export declare const isDebug: () => boolean;
-export declare const isVerbose: () => boolean;
-export { logger };
+export declare const isVerbose: (targetLogger: Pick<Logger, "level">) => boolean;
+export declare const createLogger: (...args: Parameters<typeof baseCreateLogger>) => ReturnType<typeof baseCreateLogger>;
+export { defaultLogger };
 export type { Logger };

package/dist-types/pluginManager.d.ts

@@ -1,10 +1,11 @@
+import type { Logger } from './logger';
 import type { InternalContext, PluginManager, PluginMeta } from './types';
 /**
  * Determines whether the plugin is registered in the specified environment.
  * If the pluginEnvironment is undefined, it means it can match any environment.
  */
 export declare const isEnvironmentMatch: (pluginEnvironment?: string, specifiedEnvironment?: string) => boolean;
-export declare function createPluginManager(): PluginManager;
+export declare function createPluginManager(logger: Logger): PluginManager;
 /**
  * Sorts plugins by their `enforce` property.
  */

package/dist-types/restart.d.ts

@@ -1,13 +1,15 @@
-import type { ChokidarOptions } from '../compiled/chokidar/index.js';
+import type { ChokidarOptions } from '../compiled/chokidar';
+import type { Logger } from './logger';
 import type { RsbuildInstance } from './types';
 type Cleaner = () => unknown;
 /**
  * Add a cleaner to handle side effects
  */
 export declare const onBeforeRestartServer: (cleaner: Cleaner) => void;
-export declare const restartDevServer: ({ filePath, clear, }?: {
+export declare const restartDevServer: ({ filePath, clear, logger, }: {
     filePath?: string;
     clear?: boolean;
+    logger: Logger;
 }) => Promise<boolean>;
 export declare function watchFilesForRestart({ files, rsbuild, isBuildWatch, watchOptions, }: {
     files: string[];

package/dist-types/server/assets-middleware/index.d.ts

@@ -7,7 +7,7 @@
  * https://github.com/webpack/webpack-dev-middleware/blob/master/LICENSE
  */
 import { type Compiler, type MultiCompiler } from '@rspack/core';
-import type { InternalContext, NormalizedConfig, RequestHandler } from '../../types';
+import type { InternalContext, LiveReload, NormalizedConfig, RequestHandler } from '../../types';
 import type { SocketServer } from '../socketServer';
 export type MultiWatching = ReturnType<MultiCompiler['watch']>;
 export type AssetsMiddlewareClose = (callback: (err?: Error | null) => void) => void;
@@ -16,11 +16,12 @@ export type AssetsMiddleware = RequestHandler & {
     close: AssetsMiddlewareClose;
 };
 export declare const isClientCompiler: (compiler: Compiler) => boolean;
-export declare const setupServerHooks: ({ context, compiler, token, socketServer, }: {
+export declare const setupServerHooks: ({ context, compiler, token, socketServer, liveReload, }: {
     context: InternalContext;
     compiler: Compiler;
     token: string;
     socketServer: SocketServer;
+    liveReload: LiveReload;
 }) => void;
 /**
  * The assets middleware handles compiler setup for development:

package/dist-types/server/assets-middleware/setupWriteToDisk.d.ts

@@ -1,4 +1,5 @@
 import type { Compiler } from '@rspack/core';
+import type { Logger } from '../../logger';
 import type { EnvironmentContext, NormalizedDevConfig } from '../../types';
 declare module '@rspack/core' {
     interface Compiler {
@@ -12,4 +13,4 @@ export type ResolvedWriteToDisk = boolean | ((filePath: string, name?: string) =
  * otherwise returns a function that resolves config based on compilation.
  */
 export declare const resolveWriteToDiskConfig: (config: NormalizedDevConfig, environments: Record<string, EnvironmentContext>, environmentList: EnvironmentContext[]) => ResolvedWriteToDisk;
-export declare function setupWriteToDisk(compilers: Compiler[], writeToDisk: ResolvedWriteToDisk): void;
+export declare function setupWriteToDisk(compilers: Compiler[], writeToDisk: ResolvedWriteToDisk, logger: Logger): void;

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

@@ -1,10 +1,13 @@
+import type { Logger } from '../logger';
 import type { CliShortcut, NormalizedConfig } from '../types/config';
 export declare const isCliShortcutsEnabled: (config: NormalizedConfig) => boolean;
-export declare function setupCliShortcuts({ help, openPage, closeServer, printUrls, restartServer, customShortcuts, }: {
+export declare const normalizeShortcutInput: (input: string) => string;
+export declare function setupCliShortcuts({ help, openPage, closeServer, printUrls, restartServer, customShortcuts, logger, }: {
     help?: boolean | string;
     openPage: () => Promise<void>;
     closeServer: () => Promise<void>;
     printUrls: () => void;
     restartServer?: () => Promise<boolean>;
     customShortcuts?: (shortcuts: CliShortcut[]) => CliShortcut[];
+    logger: Logger;
 }): Promise<() => void>;

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

@@ -1,4 +1,4 @@
-import type { InternalContext, NormalizedConfig, RequestHandler } from '../types';
+import type { InternalContext, NormalizedConfig } from '../types';
 import type { BuildManager } from './buildManager';
 import type { RsbuildDevServer } from './devServer';
 import type { UpgradeEvent } from './helper';
@@ -6,16 +6,14 @@ export type RsbuildDevMiddlewareOptions = {
     config: NormalizedConfig;
     context: InternalContext;
     buildManager?: BuildManager;
-    devServerAPI: RsbuildDevServer;
+    devServer: RsbuildDevServer;
     /**
-     * Callbacks returned by the `onBeforeStartDevServer` hook.
+     * Callbacks returned by `onBeforeStartDevServer` hook and `server.setup` config
      */
-    postCallbacks: (() => void)[];
+    postCallbacks: (() => Promise<void> | void)[];
 };
-export type Middlewares = (RequestHandler | [string, RequestHandler])[];
 export type GetDevMiddlewaresResult = {
     close: () => Promise<void>;
     onUpgrade: UpgradeEvent;
-    middlewares: Middlewares;
 };
 export declare const getDevMiddlewares: (options: RsbuildDevMiddlewareOptions) => Promise<GetDevMiddlewaresResult>;

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

@@ -1,6 +1,7 @@
 import type { Server } from 'node:http';
 import type { Http2SecureServer } from 'node:http2';
-import type { Connect, CreateCompiler, CreateDevServerOptions, EnvironmentAPI, InternalContext, NormalizedConfig } from '../types';
+import type { CreateCompiler, CreateDevServerOptions, EnvironmentAPI, InternalContext, NormalizedConfig } from '../types';
+import { type RsbuildServerBase, type StartDevServerResult } from './helper';
 import type { ServerMessage } from './socketServer';
 type HTTPServer = Server | Http2SecureServer;
 type ExtractSocketMessageData<T extends ServerMessage['type']> = Extract<ServerMessage, {
@@ -9,39 +10,7 @@ type ExtractSocketMessageData<T extends ServerMessage['type']> = Extract<ServerM
     data: infer D;
 } ? D : undefined;
 export type SockWrite = <T extends ServerMessage['type']>(type: T, data?: ExtractSocketMessageData<T>) => void;
-export type RsbuildDevServer = {
-    /**
-     * The `connect` app instance.
-     * Can be used to attach custom middlewares to the dev server.
-     */
-    middlewares: Connect.Server;
-    /**
-     * The Node.js HTTP server instance.
-     * - 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;
-    /**
-     * Start listening on the Rsbuild dev server.
-     * Do not call this method if you are using a custom server.
-     */
-    listen: () => Promise<{
-        port: number;
-        urls: string[];
-        server: {
-            close: () => Promise<void>;
-        };
-    }>;
-    /**
-     * Environment API of Rsbuild server.
-     */
-    environments: EnvironmentAPI;
-    /**
-     * The resolved port.
-     * By default, Rsbuild server listens on port `3000` and automatically increments
-     * the port number if the port is occupied.
-     */
-    port: number;
+export type RsbuildDevServer = RsbuildServerBase & {
     /**
      * Notifies Rsbuild that the custom server has successfully started.
      * Rsbuild will trigger the `onAfterStartDevServer` hook at this stage.
@@ -55,17 +24,14 @@ export type RsbuildDevServer = {
         server: HTTPServer;
     }) => void;
     /**
-     * Close the Rsbuild server.
-     */
-    close: () => Promise<void>;
-    /**
-     * Print the server URLs.
+     * Environment API of Rsbuild server.
      */
-    printUrls: () => void;
+    environments: EnvironmentAPI;
     /**
-     * Open URL in the browser after starting the server.
+     * Start listening on the Rsbuild dev server.
+     * Do not call this method if you are using a custom server.
      */
-    open: () => Promise<void>;
+    listen: () => Promise<StartDevServerResult>;
     /**
      * Allows middleware to send some message to HMR client, and then the HMR
      * client will take different actions depending on the message type.

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

@@ -1,12 +1,15 @@
 import type { IncomingMessage, Server } from 'node:http';
 import type { Http2SecureServer } from 'node:http2';
 import type { Socket } from 'node:net';
-import type { InternalContext, NormalizedConfig, OutputStructure, PrintUrls, Routes, RsbuildConfig, RsbuildEntry } from '../types';
+import type { Logger } from '../logger';
+import type { Connect, InternalContext, NormalizedConfig, OutputStructure, PrintUrls, Routes, RsbuildConfig, RsbuildEntry } from '../types';
+import type { RsbuildDevServer } from './devServer';
+import type { RsbuildPreviewServer } from './previewServer';
 /**
  * It used to subscribe http upgrade event
  */
 export type UpgradeEvent = (req: IncomingMessage, socket: Socket, head: any) => void;
-export type StartServerResult = {
+export type ServerStartResult<T> = {
     /**
      * The URLs that server is listening on.
      */
@@ -15,20 +18,19 @@ export type StartServerResult = {
      * The actual port used by the server.
      */
     port: number;
-    server: {
-        /**
-         * Close the server.
-         * In development mode, this will call the `onCloseDevServer` hook.
-         */
-        close: () => Promise<void>;
-    };
+    /**
+     * The dev server or preview server instance.
+     */
+    server: T;
 };
+export type StartDevServerResult = ServerStartResult<RsbuildDevServer>;
+export type StartPreviewServerResult = ServerStartResult<RsbuildPreviewServer>;
 export declare const normalizeUrl: (url: string) => string;
 export declare const joinUrlSegments: (s1: string, s2: string) => string;
 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, originalConfig, }: {
+export declare function printServerURLs({ urls: originalUrls, port, routes, protocol, printUrls, trailingLineBreak, originalConfig, logger, }: {
     urls: {
         url: string;
         label: string;
@@ -39,6 +41,7 @@ export declare function printServerURLs({ urls: originalUrls, port, routes, prot
     printUrls?: PrintUrls;
     trailingLineBreak?: boolean;
     originalConfig?: Readonly<RsbuildConfig>;
+    logger: Logger;
 }): string | null;
 /**
  * Get available free port.
@@ -53,12 +56,8 @@ export declare const getPort: ({ host, port, strictPort, tryLimits, }: {
     strictPort: boolean;
     tryLimits?: number;
 }) => Promise<number>;
-export declare const getServerConfig: ({ config, }: {
-    config: NormalizedConfig;
-}) => Promise<{
+export declare const resolvePort: (config: NormalizedConfig) => Promise<{
     port: number;
-    host: string;
-    https: boolean;
     portTip: string | undefined;
 }>;
 export declare const isWildcardHost: (host: string) => boolean;
@@ -68,7 +67,7 @@ type AddressUrl = {
     url: string;
 };
 export declare const getAddressUrls: ({ protocol, port, host, }: {
-    protocol?: string;
+    protocol: string;
     port: number;
     host?: string;
 }) => Promise<AddressUrl[]>;
@@ -89,4 +88,39 @@ export declare const HttpCode: {
     readonly RangeNotSatisfiable: 416;
     readonly InternalServerError: 500;
 };
+/**
+ * The public server API shared by both the dev and preview servers.
+ */
+export type RsbuildServerBase = {
+    /**
+     * Close the server.
+     * In the dev server, this will call the `onCloseDevServer` hook.
+     */
+    close: () => Promise<void>;
+    /**
+     * The Node.js HTTP server instance.
+     * - 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;
+    /**
+     * The `connect` app instance.
+     * Can be used to attach custom middlewares to the server.
+     */
+    middlewares: Connect.Server;
+    /**
+     * Open URL in the browser after starting the server.
+     */
+    open: () => Promise<void>;
+    /**
+     * The resolved port.
+     * By default, Rsbuild server listens on port `3000` and automatically increments
+     * the port number if the port is occupied.
+     */
+    port: number;
+    /**
+     * Print the server URLs.
+     */
+    printUrls: () => void;
+};
 export {};

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

@@ -1,2 +1,3 @@
+import type { Logger } from '../logger';
 import type { HistoryApiFallbackOptions, RequestHandler } from '../types';
-export declare function historyApiFallbackMiddleware(options?: HistoryApiFallbackOptions): RequestHandler;
+export declare function historyApiFallbackMiddleware(logger: Logger, options?: HistoryApiFallbackOptions): RequestHandler;

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

@@ -1,7 +1,8 @@
-import type { Connect, EnvironmentAPI, HtmlFallback, RequestHandler } from '../types';
+import { type Logger } from '../logger';
+import type { Connect, EnvironmentAPI, RequestHandler } from '../types';
 import type { BuildManager } from './buildManager';
 export declare const faviconFallbackMiddleware: RequestHandler;
-export declare const getRequestLoggerMiddleware: () => Connect.NextHandleFunction;
+export declare const getRequestLoggerMiddleware: (logger: Logger) => Connect.NextHandleFunction;
 export declare const notFoundMiddleware: RequestHandler;
 export declare const optionsFallbackMiddleware: RequestHandler;
 /**
@@ -23,11 +24,12 @@ export declare const getBaseUrlMiddleware: (params: {
 export declare const getHtmlFallbackMiddleware: (params: {
     distPath: string;
     buildManager: BuildManager;
-    htmlFallback?: HtmlFallback;
+    logger: Logger;
 }) => RequestHandler;
 /**
  * Support viewing served files via `/rsbuild-dev-server` route
  */
 export declare const viewingServedFilesMiddleware: (params: {
     environments: EnvironmentAPI;
+    logger: Logger;
 }) => RequestHandler;

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

@@ -1,10 +1,12 @@
+import type { Logger } from '../logger';
 import type { NormalizedConfig, Routes } from '../types';
 export declare const replacePortPlaceholder: (url: string, port: number) => string;
 export declare function resolveUrl(str: string, base: string): string;
-export declare function open({ https, port, routes, config, clearCache, }: {
-    https?: boolean;
+export declare function open({ port, routes, config, protocol, clearCache, logger, }: {
     port: number;
     routes: Routes;
     config: NormalizedConfig;
+    protocol: string;
     clearCache?: boolean;
+    logger: Logger;
 }): Promise<void>;

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

@@ -0,0 +1,4 @@
+import type { InternalContext, NormalizedConfig, PreviewOptions } from '../types';
+import { type RsbuildServerBase, type StartPreviewServerResult } from './helper';
+export type RsbuildPreviewServer = RsbuildServerBase;
+export declare function startPreviewServer(context: InternalContext, config: NormalizedConfig, { getPortSilently }?: PreviewOptions): Promise<StartPreviewServerResult>;

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

@@ -1,6 +1,7 @@
+import type { Logger } from '../logger';
 import type { RequestHandler as Middleware, ProxyConfig } from '../types';
 import { type UpgradeEvent } from './helper';
-export declare function createProxyMiddleware(proxyOptions: ProxyConfig): {
+export declare function createProxyMiddleware(proxyOptions: ProxyConfig, logger: Logger): Promise<{
     middlewares: Middleware[];
     upgrade: UpgradeEvent;
-};
+}>;

package/dist-types/server/runner/asModule.d.ts

@@ -1,2 +1,2 @@
 import type { Module, SyntheticModule } from 'node:vm';
-export declare const asModule: (something: Record<string, any>, context: Record<string, any>, unlinked?: boolean) => Promise<Module | SyntheticModule>;
+export declare const asModule: (moduleExports: Record<string, unknown>, context: Record<string, unknown>, unlinked?: boolean) => Promise<Module | SyntheticModule>;

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

@@ -0,0 +1,2 @@
+import type { ServerSetupContext, ServerSetupFn } from '../types';
+export declare function applyServerSetup(setup: ServerSetupFn | ServerSetupFn[] | undefined, context: ServerSetupContext): Promise<(() => Promise<void> | void)[]>;

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

@@ -63,7 +63,7 @@ export declare class SocketServer {
     upgrade: (req: IncomingMessage, socket: Socket, head: Buffer) => void;
     private checkSockets;
     private clearHeartbeatTimer;
-    prepare(): void;
+    prepare(): Promise<void>;
     onBuildDone(): void;
     /**
      * Send error messages to the client and render error overlay
@@ -82,6 +82,9 @@ export declare class SocketServer {
     sockWrite(message: ServerMessage, token?: string): void;
     close(): Promise<void>;
     private onConnect;
+    private getEnvironmentByToken;
+    private getInitialChunks;
+    private ensureInitialChunks;
     private getStats;
     private sendStats;
     private send;

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

@@ -1,4 +1,4 @@
-import type { FSWatcher } from '../../compiled/chokidar/index.js';
+import type { FSWatcher } from '../../compiled/chokidar';
 import type { ChokidarOptions, NormalizedConfig } from '../types';
 import type { BuildManager } from './buildManager';
 type WatchFilesOptions = {