@rsbuild/core 2.1.1 → 2.1.3

package/dist/fresh-import.js

@@ -0,0 +1,90 @@
+let importer;
+import { Module } from "node:module";
+import { fileURLToPath } from "node:url";
+import { MessageChannel } from "node:worker_threads";
+let instanceId = Math.random().toString(36).slice(2), relativeImportRE = /^\.{1,2}(?:\/|\\)/;
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function buildQueryName() {
+    return `fresh-import-${instanceId}`;
+}
+function buildQueryRE(queryName) {
+    return RegExp(`(?:\\?|&)${escapeRegExp(queryName)}=(\\d+),([^&]+)(?:&|$)`);
+}
+function formatTrackingQuery(queryName, id, context) {
+    return `?${queryName}=${id},${context}`;
+}
+function trackResolved(specifier, context, result, queryName, queryRE, onDependency) {
+    let isRelativeImport = relativeImportRE.test(specifier);
+    if ("builtin" === result.format || !isRelativeImport || !context.parentURL || queryRE.test(result.url) || !result.url.startsWith("file:")) return result;
+    let m = queryRE.exec(context.parentURL);
+    if (m) {
+        let [, id, contextFile] = m;
+        onDependency(contextFile, result.url), result.url = result.url.replace(/(\?)|$/, (_n, n1)=>`?${queryName}=${id},${contextFile}${"?" === n1 ? "&" : ""}`);
+    }
+    return result;
+}
+let nextId$1 = 0;
+function createOffThreadImporter() {
+    let queryName = buildQueryName(), { port1, port2 } = new MessageChannel();
+    return Module.register('data:text/javascript,Math.random().toString(36).slice(2);%0Aconst relativeImportRE = /^\\.{1,2}(%3F:\\/|\\\\)/;%0Afunction escapeRegExp(value) {%0A%09return value.replace(/[.*+%3F^${}()|[\\]\\\\]/g, "\\\\$&");%0A}%0A/**%0A* Build the regex that matches the tracking query `%3F<name>=<id>,<context>`%0A* (or the `&<name>=...` form).%0A*/%0Afunction buildQueryRE(queryName) {%0A%09return new RegExp(`(%3F:\\\\%3F|&)${escapeRegExp(queryName)}=(\\\\d+),([^&]+)(%3F:&|$)`);%0A}%0A/**%0A* Shared body of the resolve hook for both the on-thread and off-thread%0A* importers. Given an already-resolved `result`, decides whether it is a tracked%0A* relative file dependency; if so, reports it via `onDependency` and tags the%0A* URL so the query propagates to its own dependencies.%0A*%0A* The sync/async difference between the two hooks lives entirely in the caller%0A* (which awaits `nextResolve` or not); this function performs no I/O. `result`%0A* is mutated in place and returned.%0A*/%0Afunction trackResolved(specifier, context, result, queryName, queryRE, onDependency) {%0A%09const isRelativeImport = relativeImportRE.test(specifier);%0A%09if (result.format === "builtin" || !isRelativeImport) return result;%0A%09if (!context.parentURL || queryRE.test(result.url) || !result.url.startsWith("file:")) return result;%0A%09const m = queryRE.exec(context.parentURL);%0A%09if (m) {%0A%09%09const [, id, contextFile] = m;%0A%09%09onDependency(contextFile, result.url);%0A%09%09result.url = result.url.replace(/(\\%3F)|$/, (_n, n1) => `%3F${queryName}=${id},${contextFile}${n1 === "%3F" %3F "&" : ""}`);%0A%09}%0A%09return result;%0A}%0A//%23endregion%0A//%23region src/off-thread/loader.ts%0Alet port;%0Alet queryName;%0Alet queryRE;%0Aconst initialize = async (data) => {%0A%09port = data.port;%0A%09queryName = data.queryName;%0A%09queryRE = buildQueryRE(queryName);%0A};%0Aconst resolve = async (specifier, context, nextResolve) => {%0A%09return trackResolved(specifier, context, await nextResolve(specifier, context), queryName, queryRE, (ctx, url) => {%0A%09%09port.postMessage({%0A%09%09%09context: ctx,%0A%09%09%09url%0A%09%09});%0A%09});%0A};%0A//%23endregion%0Aexport { initialize, resolve };%0A', {
+        data: {
+            port: port2,
+            queryName
+        },
+        transferList: [
+            port2
+        ]
+    }), port1.unref(), {
+        async collect (specifier) {
+            let id = nextId$1++, depsList = new Set(), onMessage = (e)=>{
+                e.context === specifier && depsList.add(e.url);
+            };
+            port1.on("message", onMessage), port1.unref();
+            try {
+                let result = await import(specifier + formatTrackingQuery(queryName, id, specifier));
+                return await new Promise((resolve)=>setImmediate(resolve)), {
+                    result,
+                    dependencies: [
+                        ...depsList
+                    ].filter((url)=>url.startsWith("file:")).map((url)=>fileURLToPath(url))
+                };
+            } finally{
+                port1.off("message", onMessage);
+            }
+        }
+    };
+}
+let nextId = 0;
+function createOnThreadImporter() {
+    let registry = new Map(), queryName = buildQueryName(), queryRE = buildQueryRE(queryName);
+    return Module.registerHooks({
+        resolve: (specifier, context, nextResolve)=>trackResolved(specifier, context, nextResolve(specifier, context), queryName, queryRE, (ctx, url)=>{
+                registry.get(ctx)?.add(url);
+            })
+    }), {
+        async collect (specifier) {
+            let id = nextId++, depsList = new Set();
+            registry.set(specifier, depsList);
+            try {
+                return {
+                    result: await import(specifier + formatTrackingQuery(queryName, id, specifier)),
+                    dependencies: [
+                        ...depsList
+                    ].filter((url)=>url.startsWith("file:")).map((url)=>fileURLToPath(url))
+                };
+            } finally{
+                registry.delete(specifier);
+            }
+        }
+    };
+}
+function createImporter() {
+    return Module.registerHooks ? createOnThreadImporter() : Module.register ? createOffThreadImporter() : void 0;
+}
+let initialized = !1;
+function freshImport(specifier) {
+    return initialized || (importer = createImporter(), initialized = !0), importer?.collect(specifier);
+}
+export { freshImport };

package/dist/{rspack-manifest-plugin.js → manifest-plugin.js}

@@ -1,7 +1,7 @@
 import { __webpack_require__ } from "./1~rslib-runtime.js";
 import "./756.js";
 __webpack_require__.add({
-    "../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.1/node_modules/rspack-manifest-plugin/dist/helpers.js" (__unused_rspack_module, exports, __webpack_require__) {
+    "../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.2/node_modules/rspack-manifest-plugin/dist/helpers.js" (__unused_rspack_module, exports, __webpack_require__) {
         exports.transformFiles = exports.reduceChunk = exports.reduceAssets = exports.generateManifest = void 0;
         let node_path_1 = __webpack_require__("node:path?435f");
         exports.generateManifest = (compilation, files, { generate, seed = {} })=>generate ? generate(seed, files, Array.from(compilation.entrypoints.entries()).reduce((e, [name, entrypoint])=>Object.assign(e, {
@@ -61,9 +61,9 @@ __webpack_require__.add({
                 'sort'
             ].filter((fname)=>!!options[fname]).reduce((prev, fname)=>prev[fname](options[fname]), files).map(standardizeFilePaths);
     },
-    "../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.1/node_modules/rspack-manifest-plugin/dist/hooks.js" (__unused_rspack_module, exports, __webpack_require__) {
+    "../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.2/node_modules/rspack-manifest-plugin/dist/hooks.js" (__unused_rspack_module, exports, __webpack_require__) {
         exports.getCompilerHooks = exports.emitHook = exports.beforeRunHook = void 0;
-        let node_fs_1 = __webpack_require__("node:fs?9592"), node_path_1 = __webpack_require__("node:path?435f"), lite_tapable_1 = __webpack_require__("../../node_modules/.pnpm/@rspack+lite-tapable@1.1.0/node_modules/@rspack/lite-tapable/dist/index.cjs"), helpers_1 = __webpack_require__("../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.1/node_modules/rspack-manifest-plugin/dist/helpers.js"), compilerHookMap = new WeakMap(), getCompilerHooks = (compiler)=>{
+        let node_fs_1 = __webpack_require__("node:fs?9592"), node_path_1 = __webpack_require__("node:path?435f"), lite_tapable_1 = __webpack_require__("../../node_modules/.pnpm/@rspack+lite-tapable@1.1.0/node_modules/@rspack/lite-tapable/dist/index.cjs"), helpers_1 = __webpack_require__("../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.2/node_modules/rspack-manifest-plugin/dist/helpers.js"), compilerHookMap = new WeakMap(), getCompilerHooks = (compiler)=>{
             let hooks = compilerHookMap.get(compiler);
             return void 0 === hooks && (hooks = {
                 afterEmit: new lite_tapable_1.SyncWaterfallHook([
@@ -112,9 +112,9 @@ __webpack_require__.add({
             getCompilerHooks(compiler).afterEmit.call(manifest);
         };
     },
-    "../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.1/node_modules/rspack-manifest-plugin/dist/index.js" (__unused_rspack_module, exports, __webpack_require__) {
+    "../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.2/node_modules/rspack-manifest-plugin/dist/index.js" (__unused_rspack_module, exports, __webpack_require__) {
         exports.RspackManifestPlugin = void 0;
-        let node_path_1 = __webpack_require__("node:path?435f"), hooks_1 = __webpack_require__("../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.1/node_modules/rspack-manifest-plugin/dist/hooks.js"), emitCountMap = new Map(), defaults = {
+        let node_path_1 = __webpack_require__("node:path?435f"), hooks_1 = __webpack_require__("../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.2/node_modules/rspack-manifest-plugin/dist/hooks.js"), emitCountMap = new Map(), defaults = {
             assetHookStage: 1 / 0,
             basePath: '',
             fileName: 'manifest.json',
@@ -684,5 +684,5 @@ __webpack_require__.add({
         });
     }
 });
-var RspackManifestPlugin = __webpack_require__("../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.1/node_modules/rspack-manifest-plugin/dist/index.js").RspackManifestPlugin;
+var RspackManifestPlugin = __webpack_require__("../../node_modules/.pnpm/rspack-manifest-plugin@5.2.2_@rspack+core@2.1.2/node_modules/rspack-manifest-plugin/dist/index.js").RspackManifestPlugin;
 export { RspackManifestPlugin };

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

@@ -2,6 +2,8 @@ import type { ConfigLoader } from '../loadConfig';
 import type { LogLevel, RsbuildMode } from '../types';
 export type CommonOptions = {
     base?: string;
+    distPath?: string;
+    sourceMap?: boolean;
     root?: string;
     mode?: RsbuildMode;
     config?: string;
@@ -12,6 +14,7 @@ export type CommonOptions = {
     open?: boolean | string;
     host?: true | string;
     port?: number;
+    strictPort?: boolean;
     environment?: string[];
     logLevel?: LogLevel;
 };
@@ -25,4 +28,4 @@ export type InspectOptions = CommonOptions & {
 };
 export type DevOptions = CommonOptions;
 export type PreviewOptions = CommonOptions;
-export declare function setupCommands(): void;
+export declare function setupCommands(argv: string[]): void;

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

@@ -1 +1,7 @@
-export declare function runCLI(): void;
+export type RunCLIOptions = {
+    /**
+   * The command-line arguments to parse, matching the shape of Node.js `process.argv`
+   * @default process.argv
+   */ argv?: string[];
+};
+export declare function runCLI({ argv }?: RunCLIOptions): void;

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

@@ -1,7 +1,8 @@
 import type { RsbuildInstance } from '../types';
 import type { CommonOptions } from './commands';
-export declare function init({ cliOptions, isRestart, isBuildWatch }: {
-    cliOptions?: CommonOptions;
+export type CommandName = 'dev' | 'build' | 'preview' | 'inspect';
+export declare const initCliAction: (command: CommandName, options: CommonOptions) => void;
+export declare function init({ isRestart, isBuildWatch }?: {
     isRestart?: boolean;
     isBuildWatch?: boolean;
 }): Promise<RsbuildInstance | undefined>;

package/dist-types/configChain.d.ts

@@ -24,12 +24,15 @@ export declare const CHAIN_ID: {
         /** JS oneOf rules */ readonly JS_MAIN: 'js';
         readonly JS_WORKER: 'js-worker';
         readonly JS_RAW: 'js-raw';
+        readonly JS_TEXT: 'js-text';
         /** CSS oneOf rules */ readonly CSS_MAIN: 'css';
         readonly CSS_RAW: 'css-raw';
+        readonly CSS_TEXT: 'css-text';
         readonly CSS_URL: 'css-url';
         readonly CSS_INLINE: 'css-inline';
         /** SVG oneOf rules */ readonly SVG: 'svg';
         readonly SVG_RAW: 'svg-asset-raw';
+        readonly SVG_TEXT: 'svg-asset-text';
         readonly SVG_URL: 'svg-asset-url';
         readonly SVG_ASSET: 'svg-asset';
         readonly SVG_REACT: 'svg-react';

package/dist-types/index.d.ts

@@ -3,9 +3,9 @@
  * the public API of @rsbuild/core.
  */ import type * as Rspack from '@rspack/core';
 import { rspack } from '@rspack/core';
-export { runCLI } from './cli';
+export { type RunCLIOptions, runCLI } from './cli';
 export { createRsbuild } from './createRsbuild';
-export { type ConfigParams, defineConfig, type LoadConfigOptions, type LoadConfigResult, loadConfig } from './loadConfig';
+export { type ConfigParams, defineConfig, type LoadConfigOptions, type LoadConfigResult, type RsbuildConfigAsyncFn, type RsbuildConfigDefinition, type RsbuildConfigSyncFn, loadConfig } from './loadConfig';
 // Core methods
 export { type LoadEnvOptions, type LoadEnvResult, loadEnv } from './loadEnv';
 // Rsbuild version

package/dist-types/loadConfig.d.ts

@@ -7,7 +7,7 @@ export type ConfigParams = {
 };
 export type RsbuildConfigAsyncFn = (env: ConfigParams) => Promise<RsbuildConfig>;
 export type RsbuildConfigSyncFn = (env: ConfigParams) => RsbuildConfig;
-export type RsbuildConfigExport = RsbuildConfig | RsbuildConfigSyncFn | RsbuildConfigAsyncFn;
+export type RsbuildConfigDefinition = RsbuildConfig | RsbuildConfigSyncFn | RsbuildConfigAsyncFn;
 export type LoadConfigOptions = {
     /**
    * The root path to resolve the config file.
@@ -18,6 +18,10 @@ export type LoadConfigOptions = {
    * If `path` is not provided, the function will search for the config file in the `cwd`.
    */ path?: string;
     /**
+   * Config file names to search in `cwd` when `path` is not provided.
+   * The list replaces the default `rsbuild.config.*` lookup order.
+   */ configFileNames?: string[];
+    /**
    * A custom meta object to be passed into the config function of `defineConfig`.
    */ meta?: Record<string, unknown>;
     /**
@@ -31,6 +35,10 @@ export type LoadConfigOptions = {
    * - 'native': Use native Node.js loader, requires TypeScript support in Node.js >= 22.6
    * @default 'auto'
    */ loader?: ConfigLoader;
+    /**
+   * The command passed to the config function.
+   * @default process.argv[2]
+   */ command?: string;
 };
 export type LoadConfigResult = {
     /**
@@ -40,6 +48,10 @@ export type LoadConfigResult = {
    * The path to the loaded configuration file.
    * Return `null` if the configuration file is not found.
    */ filePath: string | null;
+    /**
+   * Absolute file paths of statically imported (relative) dependencies of the
+   * config file.
+   */ dependencies: string[];
 };
 /**
  * This function helps you to autocomplete configuration types.
@@ -47,6 +59,6 @@ export type LoadConfigResult = {
  */ 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 declare function defineConfig(config: RsbuildConfigDefinition): RsbuildConfigDefinition;
 export type ConfigLoader = 'auto' | 'jiti' | 'native';
-export declare function loadConfig({ cwd, path, envMode, meta, loader }?: LoadConfigOptions): Promise<LoadConfigResult>;
+export declare function loadConfig({ cwd, path, configFileNames, envMode, meta, loader, command }?: LoadConfigOptions): Promise<LoadConfigResult>;

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

@@ -3,5 +3,5 @@
  * license at https://github.com/facebook/create-react-app/blob/master/LICENSE
  */ import type { InternalContext, PrintFileSizeAsset, RsbuildPlugin } from '../types';
 /** Normalize file path by removing hash for comparison across builds */ export declare function normalizeFilePath(filePath: string): string;
-/** Exclude source map and license files by default */ export declare const excludeAsset: (asset: PrintFileSizeAsset) => boolean;
+/** Exclude source map, license, and type declaration files by default */ export declare const excludeAsset: (asset: PrintFileSizeAsset) => boolean;
 export declare const pluginFileSize: (context: InternalContext) => RsbuildPlugin;

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

@@ -516,7 +516,7 @@ export type PrintFileSizeOptions = {
     /**
    * A filter function to exclude static assets from the total size or detailed size.
    * If both `include` and `exclude` are set, `exclude` will take precedence.
-   * @default (asset) => /\.(?:map|LICENSE\.txt)$/.test(asset.name)
+   * @default (asset) => /\.(?:map|LICENSE\.txt|d\.(?:ts|mts|cts))$/.test(asset.name)
    */ exclude?: (asset: PrintFileSizeAsset) => boolean;
     /**
    * Controls whether file size differences are displayed relative to the previous build.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.rs",
   "bugs": {
@@ -40,13 +40,13 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@rspack/core": "~2.1.1",
+    "@rspack/core": "~2.1.2",
     "@swc/helpers": "^0.5.23"
   },
   "devDependencies": {
     "@jridgewell/remapping": "^2.3.5",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@rslib/core": "0.23.0",
+    "@rslib/core": "0.23.1",
     "@types/cors": "^2.8.19",
     "@types/node": "^24.13.2",
     "@types/on-finished": "2.3.5",
@@ -61,6 +61,7 @@
     "css-loader": "7.1.4",
     "deepmerge": "^4.3.1",
     "dotenv-expand": "^13.0.0",
+    "fresh-import": "^0.2.1",
     "html-rspack-plugin": "6.1.9",
     "http-proxy-middleware": "4.1.1",
     "jiti": "^2.7.0",