@rsbuild/core 1.3.20 → 1.3.22

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

@@ -1,4 +1,4 @@
-import type { ConfigLoader } from '../config';
+import type { ConfigLoader } from '../loadConfig';
 import type { RsbuildMode } from '../types';
 export type CommonOptions = {
     base?: string;

package/dist-types/defaultConfig.d.ts

@@ -0,0 +1,26 @@
+import type { NormalizedConfig, PublicDir, PublicDirOptions, RsbuildConfig, RsbuildEntry } from './types';
+/**
+ * Default allowed origins for CORS.
+ * - localhost
+ * - 127.0.0.1
+ * - [::1]
+ *
+ * Can be used in `server.cors.origin` config.
+ * @example
+ * ```ts
+ * server: {
+ *   cors: {
+ *     origin: [defaultAllowedOrigins, 'https://example.com'],
+ *   },
+ * }
+ * ```
+ */
+export declare const defaultAllowedOrigins: RegExp;
+export declare function getDefaultEntry(root: string): RsbuildEntry;
+export declare const withDefaultConfig: (rootPath: string, config: RsbuildConfig) => Promise<RsbuildConfig>;
+/**
+ * Merges user config with default values to ensure required properties
+ * are initialized.
+ */
+export declare const normalizeConfig: (config: RsbuildConfig) => NormalizedConfig;
+export declare const normalizePublicDirs: (publicDir?: PublicDir) => Required<PublicDirOptions>[];

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

@@ -5,7 +5,7 @@ export * from './fs';
 export * from './path';
 export * from './stats';
 export { color };
-export declare const rspackMinVersion = "1.0.0";
+export declare const rspackMinVersion = "1.2.4";
 export declare const getNodeEnv: () => string;
 export declare const setNodeEnv: (env: string) => void;
 export declare const isNil: (o: unknown) => o is undefined | null;
@@ -14,6 +14,11 @@ export declare const isObject: (obj: unknown) => obj is Record<string, any>;
 export declare const isPlainObject: (obj: unknown) => obj is Record<string, any>;
 export declare const castArray: <T>(arr?: T | T[]) => T[];
 export declare const cloneDeep: <T>(value: T) => T;
+/**
+ * If the application overrides the Rspack version to a lower one,
+ * 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 removeLeadingSlash: (s: string) => string;
 export declare const removeTailingSlash: (s: string) => string;
@@ -42,3 +47,4 @@ export declare const prettyTime: (seconds: number) => string;
  */
 export declare const isTTY: (type?: "stdin" | "stdout") => boolean;
 export declare const addCompilationError: (compilation: Rspack.Compilation, message: string) => void;
+export declare function hash(data: string): string;

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

@@ -1,5 +1,4 @@
-export declare function getAbsolutePath(base: string, filepath: string): string;
-export declare function getRelativePath(base: string, filepath: string): string;
+export declare function toRelativePath(base: string, filepath: string): string;
 export declare function getCommonParentPath(paths: string[]): string;
 export declare const getCompiledPath: (packageName: string) => string;
 /**
@@ -9,7 +8,7 @@ export declare const getCompiledPath: (packageName: string) => string;
  * @returns Resolved absolute file path.
  */
 export declare const ensureAbsolutePath: (base: string, filePath: string) => string;
-export declare const pathnameParse: (publicPath: string) => string;
+export declare const getPathnameFromUrl: (publicPath: string) => string;
 /** dedupe and remove nested paths */
 export declare const dedupeNestedPaths: (paths: string[]) => string[];
 /**

package/dist-types/index.d.ts

@@ -6,7 +6,7 @@ import { rspack } from '@rspack/core';
 import type * as Rspack from '@rspack/core';
 export { loadEnv, type LoadEnvOptions, type LoadEnvResult } from './loadEnv';
 export { createRsbuild } from './createRsbuild';
-export { loadConfig, defineConfig, type ConfigParams, type LoadConfigOptions, type LoadConfigResult, } from './config';
+export { loadConfig, defineConfig, type ConfigParams, type LoadConfigOptions, type LoadConfigResult, } from './loadConfig';
 export { runCLI } from './cli';
 export declare const version: string;
 export { rspack };
@@ -14,7 +14,7 @@ export type { Rspack };
 export { logger } from './logger';
 export { mergeRsbuildConfig } from './mergeConfig';
 export { ensureAssetPrefix } from './helpers';
-export { defaultAllowedOrigins } from './config';
+export { defaultAllowedOrigins } from './defaultConfig';
 export { PLUGIN_SWC_NAME, PLUGIN_CSS_NAME } from './constants';
 export type { AppIcon, AppIconItem, AliasStrategy, Build, BuildOptions, BundlerPluginInstance, Charset, ClientConfig, CliShortcut, CleanDistPath, CleanDistPathObject, ConfigChain, ConfigChainWithContext, ConsoleType, CreateCompiler, CreateRsbuildOptions, CrossOrigin, CSSLoaderOptions, CSSModules, CSSModulesLocalsConvention, DataUriLimit, Decorators, DevConfig, DistPathConfig, EnvironmentContext, EnvironmentConfig, FilenameConfig, HistoryApiFallbackContext, HistoryApiFallbackOptions, HtmlConfig, HtmlRspackPlugin, HtmlBasicTag, HtmlFallback, HtmlTagHandler, HtmlTagDescriptor, HtmlTagContext, InspectConfigOptions, InspectConfigResult, InlineChunkConfig, InlineChunkTest, InlineChunkTestFunction, InternalContext, LegalComments, ManifestData, ManifestConfig, ManifestObjectConfig, MetaAttrs, MetaOptions, Minify, ModifyBundlerChainFn, ModifyBundlerChainUtils, ModifyChainUtils, ModifyEnvironmentConfigFn, ModifyEnvironmentConfigUtils, ModifyHTMLContext, ModifyHTMLFn, ModifyHTMLTagsContext, ModifyHTMLTagsFn, ModifyRsbuildConfigUtils, ModifyRspackConfigFn, ModifyRspackConfigUtils, ModifyRsbuildConfigFn, ModifyWebpackChainFn, ModifyWebpackChainUtils, ModifyWebpackConfigFn, ModifyWebpackConfigUtils, ModuleFederationConfig, MergedEnvironmentConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedToolsConfig, OnAfterEnvironmentCompileFn, OnBeforeEnvironmentCompileFn, OnCloseBuildFn, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, OutputConfig, OutputStructure, PerformanceConfig, PluginManager, Polyfill, PostCSSLoaderOptions, PostCSSOptions, PostCSSPlugin, PreviewOptions, PreconnectOption, ProcessAssetsDescriptor, ProcessAssetsHook, ProcessAssetsHandler, ProxyBypass, ProxyConfig, ProxyFilter, ProxyOptions, PrintUrls, PublicDir, PublicDirOptions, ProgressBarConfig, RequestHandler, ResolveHook, ResolveHandler, ResolvedCreateRsbuildOptions, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildEntryDescription, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildProvider, RsbuildProviderHelpers, RsbuildTarget, RspackChain, RspackRule, ResourceHintsIncludeType, StartDevServerOptions, SriOptions, SriAlgorithm, ScriptInject, ScriptLoading, SecurityConfig, SourceMap, SetupMiddlewaresFn, SetupMiddlewaresServer, ServerConfig, SourceConfig, SplitChunks, StyleLoaderOptions, TransformContext, TransformDescriptor, ToolsConfig, TransformHook, TransformHandler, TransformImport, WatchFiles, } from './types';
 export type { ChainIdentifier } from './configChain';

package/dist-types/inspectConfig.d.ts

@@ -0,0 +1,35 @@
+import type { InitConfigsOptions } from './provider/initConfigs';
+import type { InspectConfigOptions, InspectConfigResult, NormalizedConfig, PluginManager, Rspack, WebpackConfig } from './types';
+export declare const getRsbuildInspectConfig: ({ normalizedConfig, inspectOptions, pluginManager, }: {
+    normalizedConfig: NormalizedConfig;
+    inspectOptions: InspectConfigOptions;
+    pluginManager: PluginManager;
+}) => {
+    rawRsbuildConfig: string;
+    rsbuildConfig: InspectConfigResult["origin"]["rsbuildConfig"];
+    rawEnvironmentConfigs: Array<{
+        name: string;
+        content: string;
+    }>;
+    environmentConfigs: InspectConfigResult["origin"]["environmentConfigs"];
+};
+export declare function outputInspectConfigFiles({ rawBundlerConfigs, rawEnvironmentConfigs, inspectOptions, configType, }: {
+    configType: string;
+    rawEnvironmentConfigs: Array<{
+        name: string;
+        content: string;
+    }>;
+    rawBundlerConfigs: Array<{
+        name: string;
+        content: string;
+    }>;
+    inspectOptions: InspectConfigOptions & {
+        outputPath: string;
+    };
+}): Promise<void>;
+export declare function stringifyConfig(config: unknown, verbose?: boolean): string;
+export declare function inspectConfig<B extends 'rspack' | 'webpack' = 'rspack'>({ context, pluginManager, bundlerConfigs, inspectOptions, bundler, }: InitConfigsOptions & {
+    inspectOptions?: InspectConfigOptions;
+    bundlerConfigs: B extends 'rspack' ? Rspack.Configuration[] : WebpackConfig[];
+    bundler?: 'rspack' | 'webpack';
+}): Promise<InspectConfigResult<B>>;

package/dist-types/{config.d.ts → loadConfig.d.ts}

@@ -1,28 +1,4 @@
-import type { InspectConfigOptions, InspectConfigResult, NormalizedConfig, PluginManager, PublicDir, PublicDirOptions, RsbuildConfig, RsbuildEntry } from './types';
-/**
- * Default allowed origins for CORS.
- * - localhost
- * - 127.0.0.1
- * - [::1]
- *
- * Can be used in `server.cors.origin` config.
- * @example
- * ```ts
- * server: {
- *   cors: {
- *     origin: [defaultAllowedOrigins, 'https://example.com'],
- *   },
- * }
- * ```
- */
-export declare const defaultAllowedOrigins: RegExp;
-export declare function getDefaultEntry(root: string): RsbuildEntry;
-export declare const withDefaultConfig: (rootPath: string, config: RsbuildConfig) => Promise<RsbuildConfig>;
-/**
- * Merges user config with default values to ensure required properties
- * are initialized.
- */
-export declare const normalizeConfig: (config: RsbuildConfig) => NormalizedConfig;
+import type { RsbuildConfig } from './types';
 export type ConfigParams = {
     env: string;
     command: string;
@@ -32,14 +8,6 @@ export type ConfigParams = {
 export type RsbuildConfigAsyncFn = (env: ConfigParams) => Promise<RsbuildConfig>;
 export type RsbuildConfigSyncFn = (env: ConfigParams) => RsbuildConfig;
 export type RsbuildConfigExport = RsbuildConfig | RsbuildConfigSyncFn | RsbuildConfigAsyncFn;
-/**
- * This function helps you to autocomplete configuration types.
- * It accepts a Rsbuild config object, or a function that returns a config.
- */
-export declare function defineConfig(config: RsbuildConfig): RsbuildConfig;
-export declare function defineConfig(config: RsbuildConfigSyncFn): RsbuildConfigSyncFn;
-export declare function defineConfig(config: RsbuildConfigAsyncFn): RsbuildConfigAsyncFn;
-export declare function defineConfig(config: RsbuildConfigExport): RsbuildConfigExport;
 export type LoadConfigOptions = {
     /**
      * The root path to resolve the config file.
@@ -79,34 +47,13 @@ export type LoadConfigResult = {
      */
     filePath: string | null;
 };
+/**
+ * This function helps you to autocomplete configuration types.
+ * It accepts a Rsbuild config object, or a function that returns a config.
+ */
+export declare function defineConfig(config: RsbuildConfig): RsbuildConfig;
+export declare function defineConfig(config: RsbuildConfigSyncFn): RsbuildConfigSyncFn;
+export declare function defineConfig(config: RsbuildConfigAsyncFn): RsbuildConfigAsyncFn;
+export declare function defineConfig(config: RsbuildConfigExport): RsbuildConfigExport;
 export type ConfigLoader = 'jiti' | 'native';
 export declare function loadConfig({ cwd, path, envMode, meta, loader, }?: LoadConfigOptions): Promise<LoadConfigResult>;
-export declare const getRsbuildInspectConfig: ({ normalizedConfig, inspectOptions, pluginManager, }: {
-    normalizedConfig: NormalizedConfig;
-    inspectOptions: InspectConfigOptions;
-    pluginManager: PluginManager;
-}) => {
-    rawRsbuildConfig: string;
-    rsbuildConfig: InspectConfigResult["origin"]["rsbuildConfig"];
-    rawEnvironmentConfigs: Array<{
-        name: string;
-        content: string;
-    }>;
-    environmentConfigs: InspectConfigResult["origin"]["environmentConfigs"];
-};
-export declare function outputInspectConfigFiles({ rawBundlerConfigs, rawEnvironmentConfigs, inspectOptions, configType, }: {
-    configType: string;
-    rawEnvironmentConfigs: Array<{
-        name: string;
-        content: string;
-    }>;
-    rawBundlerConfigs: Array<{
-        name: string;
-        content: string;
-    }>;
-    inspectOptions: InspectConfigOptions & {
-        outputPath: string;
-    };
-}): Promise<void>;
-export declare function stringifyConfig(config: unknown, verbose?: boolean): string;
-export declare const normalizePublicDirs: (publicDir?: PublicDir) => Required<PublicDirOptions>[];

package/dist-types/pluginHelper.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file is used to get/set the global instance for html-plugin and css-extract plugin.
  */
-import rspack from '@rspack/core';
+import { rspack } from '@rspack/core';
 import type { HtmlRspackPlugin } from './types';
 /**
  * This method is used to override the Rsbuild default html-plugin (html-rspack-plugin).

package/dist-types/plugins/minimize.d.ts

@@ -1,7 +1,7 @@
 import type { LightningCssMinimizerRspackPluginOptions, SwcJsMinimizerRspackPluginOptions } from '@rspack/core';
 import type { NormalizedEnvironmentConfig, RsbuildPlugin } from '../types';
 export declare const getSwcMinimizerOptions: (config: NormalizedEnvironmentConfig, jsOptions?: SwcJsMinimizerRspackPluginOptions) => SwcJsMinimizerRspackPluginOptions;
-export declare const parseMinifyOptions: (config: NormalizedEnvironmentConfig, isProd: boolean) => {
+export declare const parseMinifyOptions: (config: NormalizedEnvironmentConfig) => {
     minifyJs: boolean;
     minifyCss: boolean;
     jsOptions?: SwcJsMinimizerRspackPluginOptions;

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

@@ -3,7 +3,7 @@
  */
 export { setCssExtractPlugin, setHTMLPlugin } from '../pluginHelper';
 export { initRsbuildConfig } from './initConfigs';
-export { stringifyConfig, getRsbuildInspectConfig, outputInspectConfigFiles, } from '../config';
+export { inspectConfig } from '../inspectConfig';
 export { getHTMLPlugin } from '../pluginHelper';
 export { formatStats, getStatsOptions, prettyTime } from '../helpers';
 export { registerBuildHook, registerDevHook } from '../hooks';

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

@@ -4,6 +4,15 @@ export type InitConfigsOptions = {
     pluginManager: PluginManager;
     rsbuildOptions: ResolvedCreateRsbuildOptions;
 };
+/**
+ * Initialize the Rsbuild config
+ * 1. Initialize the Rsbuild plugins
+ * 2. Run all the `modifyRsbuildConfig` hooks
+ * 3. Normalize the Rsbuild config, merge with the default config
+ * 4. Initialize the configs for each environment
+ * 5. Run all the `modifyEnvironmentConfig` hooks
+ * 6. Validate the final Rsbuild config
+ */
 export declare function initRsbuildConfig({ context, pluginManager, }: Pick<InitConfigsOptions, 'context' | 'pluginManager'>): Promise<NormalizedConfig>;
 export declare function initConfigs({ context, pluginManager, rsbuildOptions, }: InitConfigsOptions): Promise<{
     rspackConfigs: Rspack.Configuration[];

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

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

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

@@ -61,7 +61,7 @@ export declare const getServerConfig: ({ config, }: {
     portTip: string | undefined;
 }>;
 export declare const isWildcardHost: (host: string) => boolean;
-export declare const getHostInUrl: (host: string) => string;
+export declare const getHostInUrl: (host: string) => Promise<string>;
 type AddressUrl = {
     label: string;
     url: string;
@@ -70,7 +70,7 @@ export declare const getAddressUrls: ({ protocol, port, host, }: {
     protocol?: string;
     port: number;
     host?: string;
-}) => AddressUrl[];
+}) => Promise<AddressUrl[]>;
 export declare const getCompilationId: (compiler: Rspack.Compiler | Rspack.Compilation) => string;
 export declare function getServerTerminator(server: Server | Http2SecureServer): () => Promise<void>;
 /**

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

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

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

@@ -14,7 +14,7 @@ import type { ModifyWebpackChainUtils, ModifyWebpackConfigUtils, RsbuildPlugins
 import type { RsbuildEntry, RsbuildMode, RsbuildTarget } from './rsbuild';
 import type { BundlerPluginInstance, Rspack, RspackRule } from './rspack';
 import type { CSSExtractOptions, CSSLoaderModulesOptions, CSSLoaderOptions, HtmlRspackPlugin, PostCSSLoaderOptions, PostCSSPlugin, StyleLoaderOptions, WebpackConfig } from './thirdParty';
-import type { ConfigChain, ConfigChainMergeContext, ConfigChainWithContext, DeepReadonly, MaybePromise, OneOrMany } from './utils';
+import type { ConfigChain, ConfigChainMergeContext, ConfigChainWithContext, MaybePromise, OneOrMany, TwoLevelReadonly } from './utils';
 export type ToolsSwcConfig = ConfigChain<SwcLoaderOptions>;
 export type ToolsBundlerChainConfig = OneOrMany<(chain: RspackChain, utils: ModifyBundlerChainUtils) => MaybePromise<void>>;
 export type ToolsPostCSSLoaderConfig = ConfigChainWithContext<PostCSSLoaderOptions, {
@@ -226,11 +226,6 @@ export type TransformImport = {
 type TransformImportFn = (imports: TransformImport[]) => TransformImport[] | void;
 export interface NormalizedSourceConfig extends SourceConfig {
     define: Define;
-    /**
-     * @deprecated Use `resolve.alias` instead.
-     * `source.alias` will be removed in v2.0.0.
-     */
-    alias: ConfigChain<Alias>;
     preEntry: string[];
     decorators: Required<Decorators>;
 }
@@ -805,19 +800,29 @@ export type CSSModules = {
 };
 export type Minify = boolean | {
     /**
-     * Whether to enable JavaScript minification.
+     * Whether to enable minification for JavaScript bundles.
+     * - `true`: Enabled in production mode.
+     * - `false`: Disabled in all modes.
+     * - `'always'`: Enabled in all modes.
+     * @default true
      */
-    js?: boolean;
+    js?: boolean | 'always';
     /**
      * Minimizer options of JavaScript, which will be passed to SWC.
+     * @default {}
      */
     jsOptions?: SwcJsMinimizerRspackPluginOptions;
     /**
-     * Whether to enable CSS minimization.
+     * Whether to enable minification for CSS bundles.
+     * - `true`: Enabled in production mode.
+     * - `false`: Disabled in all modes.
+     * - `'always'`: Enabled in all modes.
+     * @default true
      */
-    css?: boolean;
+    css?: boolean | 'always';
     /**
      * Minimizer options of CSS, which will be passed to LightningCSS.
+     * @default inherit from `tools.lightningcssLoader` config
      */
     cssOptions?: LightningCssMinimizerRspackPluginOptions;
 };
@@ -954,7 +959,8 @@ export interface OutputConfig {
      */
     cssModules?: CSSModules;
     /**
-     * Whether to disable code minification in production build.
+     * Configure whether to enable code minification in production mode, or to configure
+     * minimizer options.
      * @default true
      */
     minify?: Minify;
@@ -1349,9 +1355,12 @@ export interface DevConfig {
         custom?: (shortcuts: CliShortcut[]) => CliShortcut[];
         /**
          * Whether to print the help hint when the server is started.
+         * - `true`: Print the default help hint.
+         * - `false`: Disable the help hint.
+         * - `string`: Print a custom help hint.
          * @default true
          */
-        help?: boolean;
+        help?: boolean | string;
     };
     /**
      * Provides the ability to execute a custom function and apply custom middlewares.
@@ -1373,7 +1382,8 @@ export interface DevConfig {
      */
     lazyCompilation?: boolean | Rspack.LazyCompilationOptions;
 }
-export type NormalizedDevConfig = DevConfig & Required<Pick<DevConfig, 'hmr' | 'liveReload' | 'assetPrefix' | 'writeToDisk' | 'cliShortcuts'>> & {
+export type NormalizedDevConfig = Omit<DevConfig, 'watchFiles'> & Required<Pick<DevConfig, 'hmr' | 'liveReload' | 'assetPrefix' | 'writeToDisk' | 'cliShortcuts'>> & {
+    watchFiles: WatchFiles[];
     client: NormalizedClientConfig;
 };
 export interface ResolveConfig {
@@ -1520,7 +1530,7 @@ export type MergedEnvironmentConfig = {
 /**
  * The normalized Rsbuild environment config.
  */
-export type NormalizedEnvironmentConfig = DeepReadonly<Omit<MergedEnvironmentConfig, 'dev'> & {
+export type NormalizedEnvironmentConfig = TwoLevelReadonly<Omit<MergedEnvironmentConfig, 'dev'> & {
     dev: NormalizedDevConfig;
     server: NormalizedServerConfig;
     _privateMeta?: RsbuildConfigMeta;

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

@@ -13,10 +13,29 @@ export type RsbuildContext = {
     distPath: string;
     /** Absolute path of cache files. */
     cachePath: string;
-    /** Info of dev server  */
+    /**
+     * Dev server information when running in dev mode.
+     * Available after the dev server has been created.
+     *
+     * @example
+     * ```ts
+     * import { createRsbuild } from '@rsbuild/core';
+     *
+     * async function main() {
+     *   const rsbuild = createRsbuild({
+     *     // ...
+     *   });
+     *   await rsbuild.startDevServer();
+     *   console.log(rsbuild.context.devServer); // { hostname: 'localhost', port: 3000, https: false }
+     * }
+     * ```
+     */
     devServer?: {
+        /** The hostname the server is running on. */
         hostname: string;
+        /** The port number the server is listening on. */
         port: number;
+        /** Whether the server is using HTTPS protocol. */
         https: boolean;
     };
     /**

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

@@ -20,7 +20,7 @@ export type EnvironmentAsyncHook<Callback extends (...args: any[]) => T, T = any
      * Registers a callback function to be executed when the hook is triggered.
      * The callback can be a plain function or a HookDescriptor that includes execution order.
      * The callback will be executed in all environments by default.
-     * If you need to specify the environment, please use `tapEnvironment`
+     * If you need to specify the environment, use `tapEnvironment`
      * @param cb The callback function or hook descriptor to register
      */
     tap: (cb: Callback | HookDescriptor<Callback>) => void;

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

@@ -1,8 +1,13 @@
 export type Falsy = false | null | undefined;
 export type OneOrMany<T> = T | T[];
 export type MaybePromise<T> = T | Promise<T>;
-export type DeepReadonly<T> = keyof T extends never ? T : {
-    readonly [k in keyof T]: DeepReadonly<T[k]>;
+/**
+ * Creates a type with readonly properties at the first and second levels only.
+ */
+export type TwoLevelReadonly<T> = keyof T extends never ? T : {
+    readonly [k in keyof T]: T[k] extends object ? {
+        readonly [p in keyof T[k]]: T[k][p];
+    } : T[k];
 };
 export type ConfigChain<T> = OneOrMany<T | ((config: T) => T | void)>;
 export type ConfigChainWithContext<T, Ctx> = OneOrMany<T | ((config: T, ctx: Ctx) => T | void)>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.3.20",
+  "version": "1.3.22",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.dev",
   "bugs": {
@@ -46,17 +46,17 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@rspack/core": "1.3.10",
+    "@rspack/core": "1.3.12",
     "@rspack/lite-tapable": "~1.0.1",
     "@swc/helpers": "^0.5.17",
     "core-js": "~3.42.0",
     "jiti": "^2.4.2"
   },
   "devDependencies": {
-    "@rslib/core": "0.7.0",
+    "@rslib/core": "0.8.0",
     "@types/connect": "3.4.38",
     "@types/cors": "^2.8.18",
-    "@types/node": "^22.15.17",
+    "@types/node": "^22.15.21",
     "@types/on-finished": "2.3.4",
     "@types/webpack-bundle-analyzer": "4.7.0",
     "@types/ws": "^8.18.1",
@@ -88,9 +88,9 @@
     "rspack-manifest-plugin": "5.0.3",
     "sirv": "^3.0.1",
     "style-loader": "3.3.4",
-    "tinyglobby": "^0.2.13",
+    "tinyglobby": "^0.2.14",
     "typescript": "^5.8.3",
-    "webpack": "^5.99.8",
+    "webpack": "^5.99.9",
     "webpack-bundle-analyzer": "^4.10.2",
     "webpack-merge": "6.0.1",
     "ws": "^8.18.2"

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

@@ -1,6 +0,0 @@
-import type { InspectConfigOptions, InspectConfigResult, Rspack } from '../types';
-import { type InitConfigsOptions } from './initConfigs';
-export declare function inspectConfig({ context, pluginManager, rsbuildOptions, bundlerConfigs, inspectOptions, }: InitConfigsOptions & {
-    inspectOptions?: InspectConfigOptions;
-    bundlerConfigs?: Rspack.Configuration[];
-}): Promise<InspectConfigResult<'rspack'>>;