@rspack/core 1.0.14 → 1.1.0

package/dist/config/adapter.d.ts

@@ -2,7 +2,7 @@ import { type JsLibraryOptions, type RawOptions } from "@rspack/binding";
 import type { Compiler } from "../Compiler";
 import { type LoaderContext, type LoaderDefinition, type LoaderDefinitionFunction } from "./adapterRuleUse";
 import type { RspackOptionsNormalized } from "./normalization";
-import type { ChunkLoading, LibraryOptions, Resolve } from "./zod";
+import type { ChunkLoading, LibraryOptions, Resolve } from "./types";
 export type { LoaderContext, LoaderDefinition, LoaderDefinitionFunction };
 export declare const getRawOptions: (options: RspackOptionsNormalized, compiler: Compiler) => RawOptions;
 export declare function getRawResolve(resolve: Resolve): RawOptions["resolve"];

package/dist/config/adapterRuleUse.d.ts

@@ -6,7 +6,7 @@ import type { Module } from "../Module";
 import { type LoaderObject } from "../loader-runner";
 import type { Logger } from "../logging/Logger";
 import type Hash from "../util/hash";
-import type { Mode, PublicPath, Resolve, RuleSetUseItem, Target } from "./zod";
+import type { Mode, PublicPath, Resolve, RuleSetUseItem, Target } from "./types";
 export declare const BUILTIN_LOADER_PREFIX = "builtin:";
 export interface ComposeJsUseOptions {
     devtool: RawOptions["devtool"];

package/dist/config/index.d.ts

@@ -2,3 +2,4 @@ export * from "./adapter";
 export * from "./defaults";
 export * from "./normalization";
 export * from "./zod";
+export type * from "./types";

package/dist/config/normalization.d.ts

@@ -8,25 +8,17 @@
  * https://github.com/webpack/webpack/blob/main/LICENSE
  */
 import type { Compilation } from "../Compilation";
-import type { AssetModuleFilename, AsyncChunks, Bail, BaseUri, CacheOptions, ChunkFilename, ChunkLoading, ChunkLoadingGlobal, Clean, Context, CrossOriginLoading, CssChunkFilename, CssFilename, Dependencies, DevServer, DevTool, DevtoolFallbackModuleFilenameTemplate, DevtoolModuleFilenameTemplate, DevtoolNamespace, EnabledLibraryTypes, EnabledWasmLoadingTypes, EntryFilename, EntryRuntime, Environment, Externals, ExternalsPresets, ExternalsType, Filename, GeneratorOptionsByModuleType, GlobalObject, HashDigest, HashDigestLength, HashFunction, HashSalt, HotUpdateChunkFilename, HotUpdateGlobal, HotUpdateMainFilename, Iife, ImportFunctionName, ImportMetaName, Incremental, InfrastructureLogging, Layer, LazyCompilationOptions, LibraryOptions, Loader, Mode, Name, NoParseOption, Node, Optimization, OutputModule, ParserOptionsByModuleType, Path, Performance, Plugins, Profile, PublicPath, Resolve, RspackFutureOptions, RspackOptions, RuleSetRules, ScriptType, SnapshotOptions, SourceMapFilename, StatsValue, StrictModuleErrorHandling, Target, TrustedTypes, UniqueName, WasmLoading, Watch, WatchOptions, WebassemblyModuleFilename, WorkerPublicPath } from "./zod";
+import type { AssetModuleFilename, Bail, CacheOptions, ChunkFilename, ChunkLoading, ChunkLoadingGlobal, Clean, Context, CrossOriginLoading, CssChunkFilename, CssFilename, Dependencies, DevServer, DevTool, DevtoolFallbackModuleFilenameTemplate, DevtoolModuleFilenameTemplate, DevtoolNamespace, EnabledLibraryTypes, EnabledWasmLoadingTypes, EntryDescription, Environment, Externals, ExternalsPresets, ExternalsType, Filename, GeneratorOptionsByModuleType, GlobalObject, HashDigest, HashDigestLength, HashFunction, HashSalt, HotUpdateChunkFilename, HotUpdateGlobal, HotUpdateMainFilename, Iife, ImportFunctionName, ImportMetaName, Incremental, InfrastructureLogging, LazyCompilationOptions, LibraryOptions, Loader, Mode, Name, NoParseOption, Node, Optimization, OutputModule, ParserOptionsByModuleType, Path, Performance, Plugins, Profile, PublicPath, Resolve, RspackFutureOptions, RspackOptions, RuleSetRules, ScriptType, SnapshotOptions, SourceMapFilename, StatsValue, StrictModuleErrorHandling, Target, TrustedTypes, UniqueName, WasmLoading, Watch, WatchOptions, WebassemblyModuleFilename, WorkerPublicPath } from "./types";
 export declare const getNormalizedRspackOptions: (config: RspackOptions) => RspackOptionsNormalized;
 export type EntryDynamicNormalized = () => Promise<EntryStaticNormalized>;
 export type EntryNormalized = EntryDynamicNormalized | EntryStaticNormalized;
 export interface EntryStaticNormalized {
     [k: string]: EntryDescriptionNormalized;
 }
-export interface EntryDescriptionNormalized {
+export type EntryDescriptionNormalized = Pick<EntryDescription, "runtime" | "chunkLoading" | "asyncChunks" | "publicPath" | "baseUri" | "filename" | "library" | "layer"> & {
     import?: string[];
-    runtime?: EntryRuntime;
-    chunkLoading?: ChunkLoading;
-    asyncChunks?: AsyncChunks;
-    publicPath?: PublicPath;
-    baseUri?: BaseUri;
-    filename?: EntryFilename;
-    library?: LibraryOptions;
     dependOn?: string[];
-    layer?: Layer;
-}
+};
 export interface OutputNormalized {
     path?: Path;
     pathinfo?: boolean | "verbose";
@@ -75,6 +67,7 @@ export interface OutputNormalized {
     charset?: boolean;
     chunkLoadTimeout?: number;
     cssHeadDataCompression?: boolean;
+    compareBeforeEmit?: boolean;
 }
 export interface ModuleOptionsNormalized {
     defaultRules?: RuleSetRules;

package/dist/config/types.d.ts

@@ -1,5 +1,6 @@
 import type { JsAssetInfo, RawFuncUseCtx } from "@rspack/binding";
-import type { PathData } from "../Compilation";
+import type * as webpackDevServer from "webpack-dev-server";
+import type { Compilation, PathData } from "../Compilation";
 import type { Compiler } from "../Compiler";
 import type { Module } from "../Module";
 import type { Chunk } from "../exports";
@@ -88,10 +89,14 @@ export type EntryRuntime = false | string;
 export type EntryItem = string | string[];
 /** The entry that the current entry depends on. With dependOn option you can share the modules from one entry chunk to another. */
 export type EntryDependOn = string | string[];
+/**
+ * An object with entry point description.
+ */
 export type EntryDescription = {
     /**
      * The path to the entry module.
      * @default './src/index.js'
+     * @example ['./src/index.js', './src/foo.js']
      * */
     import: EntryItem;
     /**
@@ -112,11 +117,21 @@ export type EntryDescription = {
     wasmLoading?: WasmLoading;
     /** The filename of the entry chunk. */
     filename?: EntryFilename;
-    /** The format of the chunk generated by this entry as a library. */
+    /**
+     * The format of the chunk generated by this entry as a library.
+     * For detailed configuration, see `output.library`.
+     */
     library?: LibraryOptions;
-    /** The entry that the current entry depends on. With dependOn option you can share the modules from one entry chunk to another. */
+    /**
+     * The entry that the current entry depends on. With `dependOn` option
+     * you can share the modules from one entry chunk to another.
+     */
     dependOn?: EntryDependOn;
-    /** The layer of this entry, make the corresponding configuration take effect through layer matching in SplitChunks, Rules, Stats, and Externals. */
+    /**
+     * Specifies the layer in which modules of this entrypoint are placed.
+     * Make the corresponding configuration take effect through layer matching
+     * in split chunks, rules, stats, and externals.
+     */
     layer?: Layer;
 };
 export type EntryUnnamed = EntryItem;
@@ -385,12 +400,12 @@ export type Output = {
     hashDigest?: HashDigest;
     /**
      * The prefix length of the hash digest to use.
-     * @default 20
+     * @default 16
      * */
     hashDigestLength?: HashDigestLength;
     /**
      * The hashing algorithm to use.
-     * @default 'md4'
+     * @default 'xxhash64'
      * */
     hashFunction?: HashFunction;
     /** An optional salt to update the hash. */
@@ -435,6 +450,10 @@ export type Output = {
     charset?: boolean;
     /** Tell Rspack what kind of ES-features may be used in the generated runtime-code. */
     environment?: Environment;
+    /**
+     * Check if to be emitted file already exists and have the same content before writing to output filesystem.
+     */
+    compareBeforeEmit?: boolean;
 };
 /**
  * Path alias
@@ -621,9 +640,9 @@ export type RuleSetRule = {
     /** Specify loader category.  */
     enforce?: "pre" | "post";
     /** A kind of Nested Rule, an array of Rules from which only the first matching Rule is used when the parent Rule matches. */
-    oneOf?: RuleSetRule[];
+    oneOf?: (RuleSetRule | Falsy)[];
     /** A kind of Nested Rule, an array of Rules that is also used when the parent Rule matches. */
-    rules?: RuleSetRule[];
+    rules?: (RuleSetRule | Falsy)[];
 };
 /** A list of rules. */
 export type RuleSetRules = ("..." | RuleSetRule | Falsy)[];
@@ -712,6 +731,10 @@ export type JavascriptParserOptions = {
      * @default false
      * */
     wrappedContextCritical?: boolean;
+    /**
+     * Set the inner regular expression for partial dynamic dependencies
+     * */
+    wrappedContextRegExp?: RegExp;
     /**
      * Warn or error for using non-existent exports and conflicting re-exports.
      * @default 'auto'
@@ -868,7 +891,15 @@ export type ExternalsType = "var" | "module" | "assign" | "this" | "window" | "s
 /**
  * The dependency used for the external.
  */
-export type ExternalItemValue = string | boolean | string[] | Record<string, string | string[]>;
+export type ExternalItemValue = string | boolean | string[] | {
+    /**
+     * only available when libraryTarget and externalsType is 'umd'
+     */
+    root: string | string[];
+    commonjs: string | string[];
+    commonjs2: string | string[];
+    amd?: string | string[];
+};
 /**
  * If an dependency matches exactly a property of the object, the property value is used as dependency.
  */
@@ -1643,4 +1674,381 @@ export type Optimization = {
      * */
     emitOnErrors?: boolean;
 };
+/**
+ * Options for future Rspack features.
+ */
+export type RspackFutureOptions = {
+    /**
+     * Information about the bundler.
+     */
+    bundlerInfo?: {
+        /**
+         * Version of the bundler.
+         */
+        version?: string;
+        /**
+         * Name of the bundler.
+         */
+        bundler?: string;
+        /**
+         * Force specific features.
+         */
+        force?: boolean | ("version" | "uniqueId")[];
+    };
+};
+/**
+ * Options for server listening.
+ */
+type ListenOptions = {
+    /**
+     * The port to listen on.
+     */
+    port?: number;
+    /**
+     * The host to listen on.
+     */
+    host?: string;
+    /**
+     * The backlog of connections.
+     */
+    backlog?: number;
+    /**
+     * The path for Unix socket.
+     */
+    path?: string;
+    /**
+     * Whether the server is exclusive.
+     */
+    exclusive?: boolean;
+    /**
+     * Whether the socket is readable by all users.
+     */
+    readableAll?: boolean;
+    /**
+     * Whether the socket is writable by all users.
+     */
+    writableAll?: boolean;
+    /**
+     * Whether to use IPv6 only.
+     */
+    ipv6Only?: boolean;
+};
+/**
+ * Options for lazy compilation.
+ */
+export type LazyCompilationOptions = {
+    /**
+     * Backend configuration for lazy compilation.
+     */
+    backend?: {
+        /**
+         * Client script path.
+         */
+        client?: string;
+        /**
+         * Listening options.
+         */
+        listen?: number | ListenOptions;
+        /**
+         * Protocol to use.
+         */
+        protocol?: "http" | "https";
+    };
+    /**
+     * Enable lazy compilation for imports.
+     */
+    imports?: boolean;
+    /**
+     * Enable lazy compilation for entries.
+     */
+    entries?: boolean;
+    /**
+     * Test function or regex to determine which modules to include.
+     */
+    test?: RegExp | ((module: any) => boolean);
+};
+/**
+ * Options for incremental builds.
+ */
+export type Incremental = {
+    /**
+     * Enable incremental make.
+     */
+    make?: boolean;
+    /**
+     * Enable incremental asset emission.
+     */
+    emitAssets?: boolean;
+    /**
+     * Enable inference of async modules.
+     */
+    inferAsyncModules?: boolean;
+    /**
+     * Enable incremental provided exports.
+     */
+    providedExports?: boolean;
+    /**
+     * Enables diagnostics for dependencies.
+     */
+    dependenciesDiagnostics?: boolean;
+    /**
+     * Enable incremental module hashes.
+     */
+    modulesHashes?: boolean;
+    /**
+     * Enable incremental module code generation.
+     */
+    modulesCodegen?: boolean;
+    /**
+     * Enable incremental module runtime requirements.
+     */
+    modulesRuntimeRequirements?: boolean;
+    /**
+     * Enable incremental build chunk graph.
+     */
+    buildChunkGraph?: boolean;
+};
+/**
+ * Experimental features configuration.
+ */
+export type Experiments = {
+    /**
+     * Enable lazy compilation.
+     */
+    lazyCompilation?: boolean | LazyCompilationOptions;
+    /**
+     * Enable async WebAssembly.
+     * Support the new WebAssembly according to the [updated specification](https://github.com/WebAssembly/esm-integration), it makes a WebAssembly module an async module.
+     */
+    asyncWebAssembly?: boolean;
+    /**
+     * Enable output as ES module.
+     */
+    outputModule?: boolean;
+    /**
+     * Enable top-level await.
+     */
+    topLevelAwait?: boolean;
+    /**
+     * Enable CSS support.
+     *
+     * @description
+     * Once enabled, Rspack will enable native CSS support, and CSS related parser and generator options.
+     * - `module.parser["css/auto"]`
+     * - `module.parser.css`
+     * - `module.parser["css/module"]`
+     * - `module.generator["css/auto"]`
+     * - `module.generator.css`
+     * - `module.generator["css/module"]`
+     */
+    css?: boolean;
+    /**
+     * Enable module layers feature.
+     * @default false
+     */
+    layers?: boolean;
+    /**
+     * Enable incremental builds.
+     */
+    incremental?: boolean | Incremental;
+    /**
+     * Enable future default options.
+     */
+    futureDefaults?: boolean;
+    /**
+     * Enable future Rspack features default options.
+     */
+    rspackFuture?: RspackFutureOptions;
+};
+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.
+     * @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').
+     */
+    followSymlinks?: boolean;
+    /**
+     * Ignore some files from being watched.
+     */
+    ignored?: string | RegExp | string[];
+    /**
+     * Turn on polling by passing true, or specifying a poll interval in milliseconds.
+     * @default false
+     */
+    poll?: number | boolean;
+    /**
+     * Stop watching when stdin stream has ended.
+     */
+    stdin?: boolean;
+};
+/**
+ * Options for devServer, it based on `webpack-dev-server@5`
+ * */
+export interface DevServer extends webpackDevServer.Configuration {
+}
+/**
+ * An array of either regular expressions or functions that determine if a warning should be ignored.
+ */
+export type IgnoreWarnings = (RegExp | ((error: Error, compilation: Compilation) => boolean))[];
+/**
+ * Capture a "profile" of the application, including statistics and hints, which can then be dissected using the Analyze tool.
+ * */
+export type Profile = boolean;
+/**
+ * Fail out on the first error instead of tolerating it.
+ * @default false
+ * */
+export type Bail = boolean;
+/** Options to control how Rspack notifies you of assets and entry points that exceed a specific file limit.   */
+export type Performance = false | {
+    /**
+     * Filter function to select assets that are checked.
+     */
+    assetFilter?: (assetFilename: string) => boolean;
+    /**
+     * Sets the format of the hints: warnings, errors or nothing at all.
+     */
+    hints?: false | "warning" | "error";
+    /**
+     * File size limit (in bytes) when exceeded, that webpack will provide performance hints.
+     * @default 250000
+     */
+    maxAssetSize?: number;
+    /**
+     * Total size of an entry point (in bytes).
+     * @default 250000
+     */
+    maxEntrypointSize?: number;
+};
+export type RspackOptions = {
+    /**
+     * The name of the Rspack configuration.
+     */
+    name?: Name;
+    /**
+     * An array of dependencies required by the project.
+     */
+    dependencies?: Dependencies;
+    /**
+     * The entry point of the application.
+     */
+    entry?: Entry;
+    /**
+     * Configuration for the output of the compilation.
+     */
+    output?: Output;
+    /**
+     * The environment in which the code should run.
+     */
+    target?: Target;
+    /**
+     * The mode in which Rspack should operate.
+     */
+    mode?: Mode;
+    /**
+     * Options for experimental features.
+     */
+    experiments?: Experiments;
+    /**
+     * External libraries that should not be bundled.
+     */
+    externals?: Externals;
+    /**
+     * The type of externals.
+     */
+    externalsType?: ExternalsType;
+    /**
+     * Presets for external libraries.
+     */
+    externalsPresets?: ExternalsPresets;
+    /**
+     * Logging options for infrastructure.
+     */
+    infrastructureLogging?: InfrastructureLogging;
+    /**
+     * Options for caching.
+     */
+    cache?: CacheOptions;
+    /**
+     * The context in which the compilation should occur.
+     */
+    context?: Context;
+    /**
+     * The source map configuration.
+     */
+    devtool?: DevTool;
+    /**
+     * Options for Node.js environment.
+     */
+    node?: Node;
+    /**
+     * Configuration for loaders.
+     */
+    loader?: Loader;
+    /**
+     * Warnings to ignore during compilation.
+     */
+    ignoreWarnings?: IgnoreWarnings;
+    /**
+     * Options for watch mode.
+     */
+    watchOptions?: WatchOptions;
+    /**
+     * Whether to enable watch mode.
+     */
+    watch?: Watch;
+    /**
+     * Options for the stats output.
+     */
+    stats?: StatsValue;
+    /**
+     * Options for snapshotting.
+     */
+    snapshot?: SnapshotOptions;
+    /**
+     * Optimization options.
+     */
+    optimization?: Optimization;
+    /**
+     * Options for resolving modules.
+     */
+    resolve?: ResolveOptions;
+    /**
+     * Options for resolving loader modules.
+     */
+    resolveLoader?: ResolveOptions;
+    /**
+     * Plugins to use during compilation.
+     */
+    plugins?: Plugins;
+    /**
+     * Configuration for the development server.
+     */
+    devServer?: DevServer;
+    /**
+     * Options for module configuration.
+     */
+    module?: ModuleOptions;
+    /**
+     * Whether to capture a profile of the application.
+     */
+    profile?: Profile;
+    /**
+     * Whether to fail on the first error.
+     */
+    bail?: Bail;
+    /**
+     * Performance optimization options.
+     */
+    performance?: Performance;
+};
+/** Configuration for Rspack */
+export type Configuration = RspackOptions;
 export {};