@rsbuild/core 1.3.21 → 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/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/{config.d.ts → loadConfig.d.ts}

@@ -1,28 +1,4 @@
-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;
+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,6 +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 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/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

@@ -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.

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.3.21",
+  "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.11",
+    "@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.1",
+    "@rslib/core": "0.8.0",
     "@types/connect": "3.4.38",
     "@types/cors": "^2.8.18",
-    "@types/node": "^22.15.19",
+    "@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"