@rspack-debug/browser 2.0.0-rc.0 → 2.0.0-rc.3

package/dist/ModuleGraph.d.ts

@@ -1,5 +1,6 @@
-import type { Dependency, JsModuleGraph, ModuleGraphConnection } from './binding';
+import type { Dependency, JsModuleGraph } from './binding';
 import { ExportsInfo } from './ExportsInfo';
+import type { ModuleGraphConnection } from './ModuleGraphConnection';
 import type { Module } from './Module';
 export default class ModuleGraph {
     #private;

package/dist/ModuleGraphConnection.d.ts

@@ -0,0 +1,10 @@
+import binding, { ModuleGraphConnection as BindingModuleGraphConnection } from './binding';
+type ModuleGraphConnectionConstructor = typeof BindingModuleGraphConnection & {
+    readonly TRANSITIVE_ONLY: typeof binding.TRANSITIVE_ONLY_SYMBOL;
+    readonly CIRCULAR_CONNECTION: typeof binding.CIRCULAR_CONNECTION_SYMBOL;
+};
+export interface ModuleGraphConnection extends BindingModuleGraphConnection {
+}
+export declare const ModuleGraphConnection: ModuleGraphConnectionConstructor;
+export type ConnectionState = boolean | typeof ModuleGraphConnection.TRANSITIVE_ONLY | typeof ModuleGraphConnection.CIRCULAR_CONNECTION;
+export {};

package/dist/builtin-plugin/HashedModuleIdsPlugin.d.ts

@@ -0,0 +1,10 @@
+import { type RawHashedModuleIdsPluginOptions } from '../binding';
+export declare const HashedModuleIdsPlugin: {
+    new (options?: RawHashedModuleIdsPluginOptions | undefined): {
+        name: string;
+        _args: [options?: RawHashedModuleIdsPluginOptions | undefined];
+        affectedHooks: keyof import("..").CompilerHooks | undefined;
+        raw(compiler: import("..").Compiler): import("../binding").BuiltinPlugin;
+        apply(compiler: import("..").Compiler): void;
+    };
+};

package/dist/builtin-plugin/SideEffectsFlagPlugin.d.ts

@@ -1,9 +1,9 @@
-export declare const SideEffectsFlagPlugin: {
-    new (): {
-        name: string;
-        _args: [];
-        affectedHooks: keyof import("..").CompilerHooks | undefined;
-        raw(compiler: import("..").Compiler): import("../binding").BuiltinPlugin;
-        apply(compiler: import("..").Compiler): void;
-    };
-};
+import { type BuiltinPlugin, BuiltinPluginName } from '../binding';
+import { RspackBuiltinPlugin } from './base';
+export declare class SideEffectsFlagPlugin extends RspackBuiltinPlugin {
+    private analyzeSideEffectsFree;
+    name: BuiltinPluginName;
+    affectedHooks: "compilation";
+    constructor(analyzeSideEffectsFree?: boolean);
+    raw(): BuiltinPlugin;
+}

package/dist/builtin-plugin/index.d.ts

@@ -36,6 +36,7 @@ export * from './FetchCompileAsyncWasmPlugin';
 export * from './FileUriPlugin';
 export * from './FlagDependencyExportsPlugin';
 export * from './FlagDependencyUsagePlugin';
+export * from './HashedModuleIdsPlugin';
 export * from './HotModuleReplacementPlugin';
 export * from './HttpExternalsRspackPlugin';
 export * from './HttpUriPlugin';
@@ -82,5 +83,4 @@ export * from './SplitChunksPlugin';
 export * from './SubresourceIntegrityPlugin';
 export * from './SwcJsMinimizerPlugin';
 export * from './URLPlugin';
-export * from './WebWorkerTemplatePlugin';
 export * from './WorkerPlugin';

package/dist/config/adapterRuleUse.d.ts

@@ -186,7 +186,7 @@ export interface LoaderContext<OptionsType = {}> {
      */
     request: string;
     /**
-     * An array of all the loaders. It is writeable in the pitch phase.
+     * An array of all the loaders. It is writable in the pitch phase.
      * loaders = [{request: string, path: string, query: string, module: function}]
      *
      * In the example:

package/dist/config/devServer.d.ts

@@ -10,7 +10,7 @@
 import type { ReadStream } from 'node:fs';
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { ServerOptions } from 'node:https';
-import type { Server as ConnectApplication, NextFunction } from 'connect-next';
+import type { NextFunction } from 'connect-next';
 import type { Filter as ProxyFilter, Options as ProxyOptions } from 'http-proxy-middleware';
 import type { Options as OpenOptions } from 'open';
 import type { Compiler, Configuration, LiteralUnion, MultiCompiler, MultiStats, Stats, Watching } from '..';
@@ -153,7 +153,7 @@ export type DevServerClient = {
     webSocketTransport?: LiteralUnion<'ws', string>;
     webSocketURL?: string | DevServerWebSocketURL;
 };
-export type DevServerOptions<A extends BasicApplication = ConnectApplication, S extends BasicServer = BasicServer> = {
+export type DevServerOptions<A extends BasicApplication = BasicApplication, S extends BasicServer = BasicServer> = {
     ipc?: string | boolean;
     host?: DevServerHost;
     port?: Port;

package/dist/config/normalization.d.ts

@@ -102,6 +102,7 @@ export interface ExperimentsNormalized {
     useInputFileSystem?: false | RegExp[];
     nativeWatcher?: boolean;
     deferImport?: boolean;
+    pureFunctions?: boolean;
 }
 export type IgnoreWarningsNormalized = ((warning: WebpackError, compilation: Compilation) => boolean)[];
 export type OptimizationRuntimeChunkNormalized = false | {
@@ -137,7 +138,7 @@ export interface RspackOptionsNormalized {
     incremental?: false | Incremental;
     watch?: Watch;
     watchOptions: WatchOptions;
-    devServer?: DevServer;
+    devServer?: false | DevServer;
     ignoreWarnings?: IgnoreWarningsNormalized;
     performance?: Performance;
     amd?: Amd;

package/dist/config/types.d.ts

@@ -153,7 +153,7 @@ export type EntryStatic = EntryObject | EntryUnnamed;
 export type EntryDynamic = () => EntryStatic | Promise<EntryStatic>;
 /** The entry options for building */
 export type Entry = EntryStatic | EntryDynamic;
-/** The output directory as an absolute path. */
+/** The output directory. Relative paths are resolved against `context`. */
 export type Path = string;
 /** Tells Rspack to include comments in bundles with information about the contained modules. */
 export type Pathinfo = boolean | 'verbose';
@@ -210,7 +210,7 @@ export type WorkerPublicPath = string;
 /** Controls [Trusted Types](https://web.dev/articles/trusted-types) compatibility. */
 export type TrustedTypes = {
     /**
-     * The name of the Trusted Types policy created by webpack to serve bundle chunks.
+     * The name of the Trusted Types policy created by Rspack to serve bundle chunks.
      */
     policyName?: string;
     /**
@@ -288,7 +288,7 @@ export type Environment = {
     module?: boolean;
     /**
      * Determines if the node: prefix is generated for core module imports in environments that support it.
-     * This is only applicable to Webpack runtime code.
+     * This is only applicable to Rspack runtime code.
      * */
     nodePrefixForCoreModules?: boolean;
     /** The environment supports optional chaining ('obj?.a' or 'obj?.()'). */
@@ -298,7 +298,7 @@ export type Environment = {
 };
 export type Output = {
     /**
-     * The output directory as an absolute path.
+     * The output directory. Relative paths are resolved against `context`.
      * @default path.resolve(process.cwd(), 'dist')
      * */
     path?: Path;
@@ -631,8 +631,30 @@ export type RuleSetLoaderWithOptions = {
 };
 export type RuleSetUseItem = RuleSetLoader | RuleSetLoaderWithOptions;
 export type RuleSetUse = RuleSetUseItem | RuleSetUseItem[] | ((data: RawFuncUseCtx) => RuleSetUseItem[]);
+export type RuleSetRuleUseAndLoader = {
+    /** A loader name */
+    loader: RuleSetLoader;
+    /** A loader options */
+    options?: RuleSetLoaderOptions;
+    /** An array to pass the Loader package name and its options. */
+    use?: never;
+} | {
+    /** A loader name */
+    loader?: never;
+    /** A loader options */
+    options?: never;
+    /** An array to pass the Loader package name and its options. */
+    use: RuleSetUse;
+} | {
+    /** A loader name */
+    loader?: never;
+    /** A loader options */
+    options?: never;
+    /** An array to pass the Loader package name and its options. */
+    use?: never;
+};
 /** Rule defines the conditions for matching a module and the behavior of handling those modules. */
-export type RuleSetRule = {
+export type RuleSetRule = RuleSetRuleUseAndLoader & {
     /** Matches all modules that match this resource, and will match against Resource. */
     test?: RuleSetCondition;
     /** Excludes all modules that match this condition and will match against the absolute path of the resource */
@@ -663,12 +685,6 @@ export type RuleSetRule = {
     type?: string;
     /** Used to mark the layer of the matching module. */
     layer?: string;
-    /** A loader name */
-    loader?: RuleSetLoader;
-    /** A loader options */
-    options?: RuleSetLoaderOptions;
-    /** An array to pass the Loader package name and its options.  */
-    use?: RuleSetUse;
     /**
      * Parser options for the specific modules that matched by the rule conditions
      * It will override the parser options in module.parser.
@@ -807,7 +823,6 @@ export type JavascriptParserOptions = {
     dynamicImportFetchPriority?: 'low' | 'high' | 'auto';
     /**
      * Enable or disable evaluating import.meta. Set to 'preserve-unknown' to preserve unknown properties for runtime evaluation.
-     * @default 'preserve-unknown'
      */
     importMeta?: boolean | 'preserve-unknown';
     /**
@@ -898,6 +913,11 @@ export type JavascriptParserOptions = {
      * @default false
      */
     importMetaResolve?: boolean;
+    /**
+     * Flag top-level exported functions as side-effect-free for pure-function-based tree shaking.
+     * @experimental
+     */
+    pureFunctions?: string[];
 };
 export type JsonParserOptions = {
     /**
@@ -1354,6 +1374,8 @@ export type MemoryCacheOptions = {
  */
 export type CacheOptions = boolean | MemoryCacheOptions | PersistentCacheOptions;
 export type StatsPresets = 'normal' | 'none' | 'verbose' | 'errors-only' | 'errors-warnings' | 'minimal' | 'detailed' | 'summary';
+type AssetFilterItemTypes = RegExp | string | ((name: string, asset: any) => boolean);
+type AssetFilterTypes = boolean | AssetFilterItemTypes | AssetFilterItemTypes[];
 type ModuleFilterItemTypes = RegExp | string | ((name: string, module: any, type: any) => boolean);
 type ModuleFilterTypes = boolean | ModuleFilterItemTypes | ModuleFilterItemTypes[];
 export type StatsColorOptions = {
@@ -1638,7 +1660,7 @@ export type StatsOptions = {
      * Exclude the matching assets information.
      * @default false
      */
-    excludeAssets?: ModuleFilterTypes;
+    excludeAssets?: AssetFilterTypes;
     /**
      * Specifies the sorting order for modules.
      * @default 'id'
@@ -1818,6 +1840,13 @@ type SharedOptimizationSplitChunksCacheGroup = {
      */
     minSize?: OptimizationSplitChunksSizes;
     minSizeReduction?: OptimizationSplitChunksSizes;
+    /**
+     * Size threshold at which splitting is enforced and other restrictions
+     * (minRemainingSize, maxAsyncRequests, maxInitialRequests) are ignored.
+     * The value is `50000` in production mode.
+     * The value is `30000` in others mode.
+     */
+    enforceSizeThreshold?: OptimizationSplitChunksSizes;
     /** Maximum size, in bytes, for a chunk to be generated. */
     maxSize?: OptimizationSplitChunksSizes;
     /** Maximum size, in bytes, for a async chunk to be generated. */
@@ -1900,8 +1929,10 @@ export type OptimizationSplitChunksOptions = {
 export type Optimization = {
     /**
      * Which algorithm to use when choosing module ids.
+     * Setting to `false` disables the built-in algorithm, allowing a custom plugin
+     * (e.g. HashedModuleIdsPlugin) to provide module ids instead.
      */
-    moduleIds?: 'named' | 'natural' | 'deterministic';
+    moduleIds?: false | 'named' | 'natural' | 'deterministic' | 'hashed';
     /**
      * Which algorithm to use when choosing chunk ids.
      */
@@ -2199,19 +2230,24 @@ export type Experiments = {
      * @default false
      */
     deferImport?: boolean;
+    /**
+     * Enable pure-function-based side-effects analysis.
+     * @default false
+     */
+    pureFunctions?: boolean;
 };
 export type Watch = boolean;
 /** Options for watch mode. */
 export type WatchOptions = {
     /**
      * Add a delay before rebuilding once the first file changed.
-     * This allows webpack to aggregate any other changes made during this time period into one rebuild.
+     * This allows Rspack to aggregate any other changes made during this time period into one rebuild.
      * @default 5
      */
     aggregateTimeout?: number;
     /**
      * Follow symlinks while looking for files.
-     * This is usually not needed as webpack already resolves symlinks ('resolve.symlinks' and 'resolve.alias').
+     * This is usually not needed as Rspack already resolves symlinks ('resolve.symlinks' and 'resolve.alias').
      */
     followSymlinks?: boolean;
     /**
@@ -2270,13 +2306,13 @@ export type Performance = false | {
      */
     hints?: false | 'warning' | 'error';
     /**
-     * File size limit (in bytes) when exceeded, that webpack will provide performance hints.
-     * @default 250000
+     * File size limit (in bytes) when exceeded, Rspack will provide performance hints.
+     * @default 307200 (300 KiB)
      */
     maxAssetSize?: number;
     /**
      * Total size of an entry point (in bytes).
-     * @default 250000
+     * @default 512000 (500 KiB)
      */
     maxEntrypointSize?: number;
 };
@@ -2400,7 +2436,7 @@ export type RspackOptions = {
     /**
      * Configuration for the development server.
      */
-    devServer?: DevServer;
+    devServer?: false | DevServer;
     /**
      * Options for module configuration.
      */

package/dist/exports.d.ts

@@ -16,6 +16,7 @@ export { ExternalModule } from './ExternalModule';
 export type { ResolveData, ResourceDataWithData } from './Module';
 export { Module } from './Module';
 export type { default as ModuleGraph } from './ModuleGraph';
+export { ModuleGraphConnection, type ConnectionState, } from './ModuleGraphConnection';
 export { MultiStats } from './MultiStats';
 export { NormalModule } from './NormalModule';
 export type { NormalModuleFactory } from './NormalModuleFactory';
@@ -56,9 +57,11 @@ export { LoaderOptionsPlugin } from './lib/LoaderOptionsPlugin';
 export { LoaderTargetPlugin } from './lib/LoaderTargetPlugin';
 export type { OutputFileSystem, WatchFileSystem } from './util/fs';
 import { FetchCompileAsyncWasmPlugin, lazyCompilationMiddleware, rsc, SubresourceIntegrityPlugin } from './builtin-plugin';
+import JsonpTemplatePlugin from './web/JsonpTemplatePlugin';
 export { SubresourceIntegrityPlugin };
 interface Web {
     FetchCompileAsyncWasmPlugin: typeof FetchCompileAsyncWasmPlugin;
+    JsonpTemplatePlugin: typeof JsonpTemplatePlugin;
 }
 export declare const web: Web;
 import { NodeTargetPlugin } from './builtin-plugin';
@@ -76,6 +79,11 @@ interface Electron {
     ElectronTargetPlugin: typeof ElectronTargetPlugin;
 }
 export declare const electron: Electron;
+import { HashedModuleIdsPlugin } from './builtin-plugin';
+interface Ids {
+    HashedModuleIdsPlugin: typeof HashedModuleIdsPlugin;
+}
+export declare const ids: Ids;
 import { EnableLibraryPlugin } from './builtin-plugin';
 interface Library {
     EnableLibraryPlugin: typeof EnableLibraryPlugin;
@@ -92,7 +100,7 @@ interface JavaScript {
     JavascriptModulesPlugin: typeof JavascriptModulesPlugin;
 }
 export declare const javascript: JavaScript;
-import { WebWorkerTemplatePlugin } from './builtin-plugin';
+import WebWorkerTemplatePlugin from './webworker/WebWorkerTemplatePlugin';
 interface Webworker {
     WebWorkerTemplatePlugin: typeof WebWorkerTemplatePlugin;
 }