webpack/declarations/WebpackOptions.d.ts

2311 lines
61 KiB
TypeScript
Raw Normal View History

/*
* This file was automatically generated.
* DO NOT MODIFY BY HAND.
* Run `yarn special-lint-fix` to update
2018-05-08 12:04:57 +08:00
*/
/**
* Set the value of `require.amd` and `define.amd`. Or disable AMD support.
*/
export type Amd =
| false
| {
[k: string]: any;
};
/**
* Report the first error as a hard error instead of tolerating it.
*/
export type Bail = boolean;
/**
* Cache generated modules and chunks to improve performance for multiple incremental builds.
*/
export type CacheOptions = true | CacheOptionsNormalized;
/**
* Cache generated modules and chunks to improve performance for multiple incremental builds.
*/
export type CacheOptionsNormalized =
| false
| MemoryCacheOptions
| FileCacheOptions;
/**
* The base directory (absolute path!) for resolving the `entry` option. If `output.pathinfo` is set, the included pathinfo is shortened to this directory.
*/
export type Context = string;
/**
* References to other configurations to depend on.
*/
export type Dependencies = string[];
/**
* A developer tool to enhance debugging (false | eval | [inline-|hidden-|eval-][nosources-][cheap-[module-]]source-map).
*/
export type DevTool = (false | "eval") | string;
/**
* The entry point(s) of the compilation.
*/
2018-09-19 18:59:48 +08:00
export type Entry = EntryDynamic | EntryStatic;
/**
* A Function returning an entry object, an entry string, an entry array or a promise to these things.
*/
2019-02-05 17:06:32 +08:00
export type EntryDynamic = () => EntryStatic | Promise<EntryStatic>;
2018-09-19 18:59:48 +08:00
/**
* A static entry description.
2018-09-19 18:59:48 +08:00
*/
export type EntryStatic = EntryObject | EntryUnnamed;
/**
* Module(s) that are loaded upon startup.
*/
export type EntryItem = [string, ...string[]] | string;
/**
* Specifies the name of each output file on disk. You must **not** specify an absolute path here! The `output.path` option determines the location on disk the files are written to, filename is used solely for naming the individual files.
*/
export type Filename =
| string
| ((
pathData: import("../lib/Compilation").PathData,
assetInfo?: import("../lib/Compilation").AssetInfo
) => string);
/**
* Add a comment in the UMD wrapper.
*/
export type AuxiliaryComment = string | LibraryCustomUmdCommentObject;
/**
* Specify which export should be exposed as library.
*/
export type LibraryExport = string[] | string;
/**
* The name of the library (some types allow unnamed libraries too).
*/
export type LibraryName = string[] | string | LibraryCustomUmdObject;
/**
* Type of library.
*/
export type LibraryType =
| "var"
| "module"
| "assign"
| "this"
| "window"
| "self"
| "global"
| "commonjs"
| "commonjs2"
| "commonjs-module"
| "amd"
| "amd-require"
| "umd"
| "umd2"
| "jsonp"
| "system";
/**
* If `output.libraryTarget` is set to umd and `output.library` is set, setting this to true will name the AMD module.
*/
export type UmdNamedDefine = boolean;
/**
* The name of the runtime chunk. If set a runtime chunk with this name is created or an existing entrypoint is used as runtime.
*/
export type EntryRuntime = string;
2018-09-19 18:59:48 +08:00
/**
* An entry point without name.
2018-09-19 18:59:48 +08:00
*/
export type EntryUnnamed = EntryItem;
/**
* Specify dependencies that shouldn't be resolved by webpack, but should become dependencies of the resulting bundle. The kind of the dependency depends on `output.libraryTarget`.
*/
export type Externals = ExternalItem[] | ExternalItem;
2018-09-18 21:17:44 +08:00
/**
* Specify dependency that shouldn't be resolved by webpack, but should become dependencies of the resulting bundle. The kind of the dependency depends on `output.libraryTarget`.
2018-09-18 21:17:44 +08:00
*/
export type ExternalItem =
| RegExp
2018-05-08 12:04:57 +08:00
| string
| {
/**
* The dependency used for the external.
2018-05-08 12:04:57 +08:00
*/
[k: string]:
| string[]
| boolean
| string
2018-05-08 12:04:57 +08:00
| {
[k: string]: any;
};
2018-05-08 12:04:57 +08:00
}
| ((
2020-08-17 20:25:27 +08:00
data: { context: string; request: string },
callback: (err?: Error, result?: string) => void
) => void);
/**
* Specifies the default type of externals ('amd*', 'umd*', 'system' and 'jsonp' depend on output.libraryTarget set to the same value).
*/
export type ExternalsType =
| "var"
| "module"
| "assign"
| "this"
| "window"
| "self"
| "global"
| "commonjs"
| "commonjs2"
| "commonjs-module"
| "amd"
| "amd-require"
| "umd"
| "umd2"
| "jsonp"
| "system"
| "promise"
| "import"
| "script";
/**
* Filtering values.
*/
export type FilterTypes = FilterItemTypes[] | FilterItemTypes;
/**
* Filtering value, regexp or function.
*/
export type FilterItemTypes = RegExp | string | ((value: string) => boolean);
/**
* Enable production optimizations or development hints.
*/
export type Mode = "development" | "production" | "none";
2018-09-18 21:17:44 +08:00
/**
* One or multiple rule conditions.
2018-09-18 21:17:44 +08:00
*/
export type RuleSetConditionOrConditions = RuleSetCondition | RuleSetConditions;
/**
* A condition matcher.
*/
2018-05-08 12:04:57 +08:00
export type RuleSetCondition =
2018-09-21 14:39:15 +08:00
| RegExp
2018-05-08 12:04:57 +08:00
| string
| {
/**
* Logical AND.
2018-05-08 12:04:57 +08:00
*/
and?: RuleSetConditions;
/**
* Logical NOT.
2018-05-08 12:04:57 +08:00
*/
not?: RuleSetConditions;
/**
* Logical OR.
2018-05-08 12:04:57 +08:00
*/
or?: RuleSetConditions;
}
| ((value: string) => boolean)
| RuleSetConditions;
/**
* A list of rule conditions.
*/
export type RuleSetConditions = RuleSetCondition[];
/**
* One or multiple rule conditions matching an absolute path.
*/
export type RuleSetConditionOrConditionsAbsolute =
| RuleSetConditionAbsolute
| RuleSetConditionsAbsolute;
/**
* A condition matcher matching an absolute path.
*/
export type RuleSetConditionAbsolute =
| RegExp
| string
| {
/**
* Logical AND.
*/
and?: RuleSetConditionsAbsolute;
/**
* Logical NOT.
*/
not?: RuleSetConditionsAbsolute;
/**
* Logical OR.
*/
or?: RuleSetConditionsAbsolute;
}
| ((value: string) => boolean)
| RuleSetConditionsAbsolute;
/**
* A list of rule conditions matching an absolute path.
*/
export type RuleSetConditionsAbsolute = RuleSetConditionAbsolute[];
/**
* A loader request.
*/
2018-05-08 12:04:57 +08:00
export type RuleSetLoader = string;
/**
* Options passed to a loader.
*/
export type RuleSetLoaderOptions =
| string
| {
[k: string]: any;
};
/**
* A list of descriptions of loaders applied.
*/
export type RuleSetUse =
| RuleSetUseItem[]
| ((data: {
resource: string;
realResource: string;
resourceQuery: string;
issuer: string;
compiler: string;
}) => RuleSetUseItem[])
| RuleSetUseItem;
/**
* A description of an applied loader.
*/
2018-05-08 12:04:57 +08:00
export type RuleSetUseItem =
| {
2018-09-19 16:17:33 +08:00
/**
* Unique loader options identifier.
2018-09-19 16:17:33 +08:00
*/
ident?: string;
2018-05-08 12:04:57 +08:00
/**
* Loader name.
2018-05-08 12:04:57 +08:00
*/
loader?: RuleSetLoader;
/**
* Loader options.
2018-05-08 12:04:57 +08:00
*/
options?: RuleSetLoaderOptions;
}
| ((data: object) => RuleSetUseItem | RuleSetUseItem[])
| RuleSetLoader;
/**
* A list of rules.
*/
export type RuleSetRules = ("..." | RuleSetRule)[];
/**
* Name of the configuration. Used when loading multiple configurations.
*/
export type Name = string;
/**
* Include polyfills or mocks for various node stuff.
*/
export type Node = false | NodeOptions;
2018-09-18 21:17:44 +08:00
/**
* Function acting as plugin.
2018-09-18 21:17:44 +08:00
*/
2018-09-19 16:37:53 +08:00
export type WebpackPluginFunction = (
this: import("../lib/Compiler"),
2018-09-18 21:17:44 +08:00
compiler: import("../lib/Compiler")
) => void;
/**
* Create an additional chunk which contains only the webpack runtime and chunk hash maps.
*/
export type OptimizationRuntimeChunk =
| ("single" | "multiple")
| boolean
| {
/**
* The name or name factory for the runtime chunks.
*/
name?: string | Function;
};
/**
* Size description for limits.
*/
export type OptimizationSplitChunksSizes =
| number
| {
/**
* Size of the part of the chunk with the type of the key.
*/
[k: string]: number;
};
2020-02-20 03:25:49 +08:00
/**
* The filename of asset modules as relative path inside the `output.path` directory.
*/
export type AssetModuleFilename =
| string
| ((
pathData: import("../lib/Compilation").PathData,
assetInfo?: import("../lib/Compilation").AssetInfo
) => string);
/**
* The callback function name used by webpack for loading of chunks in WebWorkers.
*/
export type ChunkCallbackName = string;
/**
* The filename of non-entry chunks as relative path inside the `output.path` directory.
*/
export type ChunkFilename = string;
/**
* Number of milliseconds before chunk request expires.
2020-02-20 03:25:49 +08:00
*/
export type ChunkLoadTimeout = number;
/**
* Check if to be emitted file already exists and have the same content before writing to output filesystem.
2020-02-20 03:25:49 +08:00
*/
export type CompareBeforeEmit = boolean;
/**
* This option enables cross-origin loading of chunks.
*/
export type CrossOriginLoading = false | "anonymous" | "use-credentials";
/**
* Similar to `output.devtoolModuleFilenameTemplate`, but used in the case of duplicate module identifiers.
*/
export type DevtoolFallbackModuleFilenameTemplate = string | Function;
/**
* Filename template string of function for the sources array in a generated SourceMap.
*/
export type DevtoolModuleFilenameTemplate = string | Function;
/**
* Module namespace to use when interpolating filename template string for the sources array in a generated SourceMap. Defaults to `output.library` if not set. It's useful for avoiding runtime collisions in sourcemaps from multiple webpack projects built as libraries.
*/
export type DevtoolNamespace = string;
/**
* The maximum EcmaScript version of the webpack generated code (doesn't include input source code from modules).
*/
export type EcmaVersion = 2009 | number;
2020-02-20 03:25:49 +08:00
/**
* List of library types enabled for use by entry points.
2020-02-20 03:25:49 +08:00
*/
export type EnabledLibraryTypes = LibraryType[];
/**
* An expression which is used to address the global object/scope in runtime code.
2020-02-20 03:25:49 +08:00
*/
export type GlobalObject = string;
/**
* Digest type used for the hash.
2020-02-20 03:25:49 +08:00
*/
export type HashDigest = string;
/**
* Number of chars which are used for the hash.
2020-02-20 03:25:49 +08:00
*/
export type HashDigestLength = number;
/**
* Algorithm used for generation the hash (see node.js crypto package).
2020-02-20 03:25:49 +08:00
*/
export type HashFunction = string | typeof import("../lib/util/Hash");
/**
* Any string which is added to the hash to salt it.
2020-02-20 03:25:49 +08:00
*/
export type HashSalt = string;
/**
* The filename of the Hot Update Chunks. They are inside the output.path directory.
*/
export type HotUpdateChunkFilename = string;
/**
* The JSONP function used by webpack for async loading of hot update chunks.
*/
export type HotUpdateFunction = string;
/**
* The filename of the Hot Update Main File. It is inside the `output.path` directory.
*/
export type HotUpdateMainFilename = string;
/**
2020-03-13 17:03:17 +08:00
* Wrap javascript code into IIFE's to avoid leaking into global scope.
2020-02-20 03:25:49 +08:00
*/
export type Iife = boolean;
/**
* The name of the native import() function (can be exchanged for a polyfill).
*/
export type ImportFunctionName = string;
2020-02-20 03:25:49 +08:00
/**
* The JSONP function used by webpack for async loading of chunks.
*/
export type JsonpFunction = string;
/**
* Make the output files a library, exporting the exports of the entry point.
2020-02-20 03:25:49 +08:00
*/
export type Library = LibraryName | LibraryOptions;
/**
* Output javascript files as module source type.
*/
export type OutputModule = boolean;
/**
* The output directory as **absolute path** (required).
*/
export type Path = string;
/**
* Include comments with information about the modules.
*/
export type Pathinfo = boolean;
/**
* The `publicPath` specifies the public URL address of the output files when referenced in a browser.
*/
export type PublicPath =
| string
| ((
pathData: import("../lib/Compilation").PathData,
assetInfo?: import("../lib/Compilation").AssetInfo
) => string);
2020-06-25 04:05:21 +08:00
/**
* This option enables loading async chunks via a custom script type, such as script type="module".
*/
export type ScriptType = false | "text/javascript" | "module";
2020-02-20 03:25:49 +08:00
/**
* The filename of the SourceMaps for the JavaScript files. They are inside the `output.path` directory.
*/
export type SourceMapFilename = string;
/**
* Prefixes every line of the source in the bundle with this string.
*/
export type SourcePrefix = string;
/**
* Handles exceptions in module loading correctly at a performance cost.
*/
export type StrictModuleExceptionHandling = boolean;
/**
* A unique name of the webpack build to avoid multiple webpack runtimes to conflict when using globals.
*/
export type UniqueName = string;
/**
* The filename of WebAssembly modules as relative path inside the `output.path` directory.
*/
export type WebassemblyModuleFilename = string;
/**
* The number of parallel processed modules in the compilation.
*/
export type Parallelism = number;
/**
* Configuration for web performance recommendations.
*/
export type Performance = false | PerformanceOptions;
/**
* Add additional plugins to the compiler.
*/
export type Plugins = (WebpackPluginInstance | WebpackPluginFunction)[];
/**
* Capture timing information for each module.
*/
export type Profile = boolean;
/**
* Store compiler state to a json file.
*/
export type RecordsInputPath = false | string;
/**
* Load compiler state from a json file.
*/
export type RecordsOutputPath = false | string;
/**
* Store/Load compiler state from/to a json file. This will result in persistent ids of modules and chunks. An absolute path is expected. `recordsPath` is used for `recordsInputPath` and `recordsOutputPath` if they left undefined.
*/
export type RecordsPath = false | string;
/**
* Options for the resolver.
*/
export type Resolve = ResolveOptions;
/**
* Options for the resolver when resolving loaders.
*/
export type ResolveLoader = ResolveOptions;
/**
* Stats options object or preset name.
*/
export type StatsValue =
| (
| "none"
| "errors-only"
| "minimal"
| "normal"
| "detailed"
| "verbose"
| "errors-warnings"
)
| boolean
| StatsOptions;
/**
* Environment to build for.
*/
export type Target =
| (
| "web"
| "webworker"
| "node"
| "async-node"
| "node-webkit"
| "electron-main"
| "electron-renderer"
| "electron-preload"
)
| ((compiler: import("../lib/Compiler")) => void);
/**
* Enter watch mode, which rebuilds on file change.
*/
export type Watch = boolean;
/**
* A Function returning a Promise resolving to a normalized entry.
*/
export type EntryDynamicNormalized = () => Promise<EntryStaticNormalized>;
/**
* The entry point(s) of the compilation.
*/
export type EntryNormalized = EntryDynamicNormalized | EntryStaticNormalized;
/**
* Create an additional chunk which contains only the webpack runtime and chunk hash maps.
*/
export type OptimizationRuntimeChunkNormalized =
| false
| {
/**
* The name factory for the runtime chunks.
*/
name?: Function;
};
/**
* A function returning cache groups.
*/
export type OptimizationSplitChunksGetCacheGroups = (
module: import("../lib/Module")
) =>
| OptimizationSplitChunksCacheGroup
| OptimizationSplitChunksCacheGroup[]
| void;
2018-05-08 12:04:57 +08:00
/**
* Options object as provided by the user.
*/
2018-05-08 12:04:57 +08:00
export interface WebpackOptions {
/**
* Set the value of `require.amd` and `define.amd`. Or disable AMD support.
*/
amd?: Amd;
/**
* Report the first error as a hard error instead of tolerating it.
*/
bail?: Bail;
/**
* Cache generated modules and chunks to improve performance for multiple incremental builds.
*/
cache?: CacheOptions;
/**
* The base directory (absolute path!) for resolving the `entry` option. If `output.pathinfo` is set, the included pathinfo is shortened to this directory.
*/
context?: Context;
/**
* References to other configurations to depend on.
*/
dependencies?: Dependencies;
/**
* Options for the webpack-dev-server.
*/
devServer?: DevServer;
/**
* A developer tool to enhance debugging (false | eval | [inline-|hidden-|eval-][nosources-][cheap-[module-]]source-map).
*/
devtool?: DevTool;
/**
* The entry point(s) of the compilation.
*/
2018-05-08 12:04:57 +08:00
entry?: Entry;
/**
2020-03-13 17:03:17 +08:00
* Enables/Disables experiments (experimental features with relax SemVer compatibility).
*/
2019-06-04 17:26:04 +08:00
experiments?: Experiments;
/**
* Specify dependencies that shouldn't be resolved by webpack, but should become dependencies of the resulting bundle. The kind of the dependency depends on `output.libraryTarget`.
*/
2018-05-08 12:04:57 +08:00
externals?: Externals;
/**
* Specifies the default type of externals ('amd*', 'umd*', 'system' and 'jsonp' depend on output.libraryTarget set to the same value).
*/
externalsType?: ExternalsType;
/**
* Options for infrastructure level logging.
*/
infrastructureLogging?: InfrastructureLogging;
/**
* Custom values available in the loader context.
*/
loader?: Loader;
/**
* Enable production optimizations or development hints.
*/
mode?: Mode;
/**
* Options affecting the normal modules (`NormalModuleFactory`).
*/
module?: ModuleOptions;
/**
* Name of the configuration. Used when loading multiple configurations.
*/
name?: Name;
/**
* Include polyfills or mocks for various node stuff.
*/
node?: Node;
/**
* Enables/Disables integrated optimizations.
*/
optimization?: Optimization;
/**
* Options affecting the output of the compilation. `output` options tell webpack how to write the compiled files to disk.
*/
output?: Output;
/**
* The number of parallel processed modules in the compilation.
*/
parallelism?: Parallelism;
/**
* Configuration for web performance recommendations.
*/
performance?: Performance;
/**
* Add additional plugins to the compiler.
*/
plugins?: Plugins;
/**
* Capture timing information for each module.
*/
profile?: Profile;
/**
* Store compiler state to a json file.
*/
recordsInputPath?: RecordsInputPath;
/**
* Load compiler state from a json file.
*/
recordsOutputPath?: RecordsOutputPath;
/**
* Store/Load compiler state from/to a json file. This will result in persistent ids of modules and chunks. An absolute path is expected. `recordsPath` is used for `recordsInputPath` and `recordsOutputPath` if they left undefined.
*/
recordsPath?: RecordsPath;
/**
* Options for the resolver.
*/
resolve?: Resolve;
/**
* Options for the resolver when resolving loaders.
*/
resolveLoader?: ResolveLoader;
/**
* Stats options object or preset name.
*/
stats?: StatsValue;
/**
* Environment to build for.
*/
target?: Target;
/**
* Enter watch mode, which rebuilds on file change.
*/
watch?: Watch;
/**
* Options for the watcher.
*/
2018-12-10 18:34:59 +08:00
watchOptions?: WatchOptions;
2018-05-08 12:04:57 +08:00
}
2018-10-09 20:30:59 +08:00
/**
* Options object for in-memory caching.
2018-10-09 20:30:59 +08:00
*/
export interface MemoryCacheOptions {
/**
2020-05-02 19:10:55 +08:00
* List of paths that are managed by a package manager and contain a version or hash in its path so all files are immutable.
*/
immutablePaths?: string[];
/**
* List of paths that are managed by a package manager and can be trusted to not be modified otherwise.
*/
managedPaths?: string[];
2018-10-09 20:30:59 +08:00
/**
* In memory caching.
2018-10-09 20:30:59 +08:00
*/
type: "memory";
}
/**
* Options object for persistent file-based caching.
2018-10-09 20:30:59 +08:00
*/
export interface FileCacheOptions {
2019-08-09 20:46:42 +08:00
/**
* Dependencies the build depends on (in multiple categories, default categories: 'defaultWebpack').
2019-08-09 20:46:42 +08:00
*/
buildDependencies?: {
/**
* List of dependencies the build depends on.
2019-08-09 20:46:42 +08:00
*/
[k: string]: string[];
};
2018-10-09 20:30:59 +08:00
/**
* Base directory for the cache (defaults to node_modules/.cache/webpack).
*/
cacheDirectory?: string;
/**
* Locations for the cache (defaults to cacheDirectory / name).
*/
cacheLocation?: string;
2018-10-09 20:30:59 +08:00
/**
* Algorithm used for generation the hash (see node.js crypto package).
2018-10-09 20:30:59 +08:00
*/
hashAlgorithm?: string;
/**
* Time in ms after which idle period the cache storing should happen (only for store: 'pack' or 'idle').
*/
idleTimeout?: number;
/**
* Time in ms after which idle period the initial cache storing should happen (only for store: 'pack' or 'idle').
*/
idleTimeoutForInitialStore?: number;
/**
2020-05-02 19:10:55 +08:00
* List of paths that are managed by a package manager and contain a version or hash in its path so all files are immutable.
*/
immutablePaths?: string[];
/**
* List of paths that are managed by a package manager and can be trusted to not be modified otherwise.
*/
managedPaths?: string[];
2018-10-09 20:30:59 +08:00
/**
* Name for the cache. Different names will lead to different coexisting caches.
*/
name?: string;
/**
* When to store data to the filesystem. (pack: Store data when compiler is idle in a single file).
2018-10-09 20:30:59 +08:00
*/
store?: "pack";
2018-10-09 20:30:59 +08:00
/**
* Filesystem caching.
2018-10-09 20:30:59 +08:00
*/
type: "filesystem";
/**
* Version of the cache data. Different versions won't allow to reuse the cache and override existing content. Update the version when config changed in a way which doesn't allow to reuse cache. This will invalidate the cache.
*/
version?: string;
}
2018-09-19 18:59:48 +08:00
/**
* Options for the webpack-dev-server.
*/
export interface DevServer {
[k: string]: any;
}
/**
* Multiple entry bundles are created. The key is the entry name. The value can be a string, an array or an entry description object.
2018-09-19 18:59:48 +08:00
*/
export interface EntryObject {
/**
* An entry point with name.
2018-09-19 18:59:48 +08:00
*/
[k: string]: EntryItem | EntryDescription;
}
/**
* An object with entry point description.
*/
export interface EntryDescription {
/**
* The entrypoints that the current entrypoint depend on. They must be loaded when this entrypoint is loaded.
*/
dependOn?: [string, ...string[]] | string;
2020-02-07 18:00:25 +08:00
/**
* Specifies the name of each output file on disk. You must **not** specify an absolute path here! The `output.path` option determines the location on disk the files are written to, filename is used solely for naming the individual files.
2020-02-07 18:00:25 +08:00
*/
filename?: Filename;
/**
* Module(s) that are loaded upon startup.
*/
import: EntryItem;
/**
* Options for library.
*/
library?: LibraryOptions;
/**
* The name of the runtime chunk. If set a runtime chunk with this name is created or an existing entrypoint is used as runtime.
*/
runtime?: EntryRuntime;
}
/**
* Options for library.
*/
export interface LibraryOptions {
/**
* Add a comment in the UMD wrapper.
*/
auxiliaryComment?: AuxiliaryComment;
/**
* Specify which export should be exposed as library.
*/
export?: LibraryExport;
/**
* The name of the library (some types allow unnamed libraries too).
*/
name?: LibraryName;
/**
* Type of library.
*/
type: LibraryType;
/**
* If `output.libraryTarget` is set to umd and `output.library` is set, setting this to true will name the AMD module.
*/
umdNamedDefine?: UmdNamedDefine;
}
/**
* Set explicit comments for `commonjs`, `commonjs2`, `amd`, and `root`.
*/
export interface LibraryCustomUmdCommentObject {
/**
* Set comment for `amd` section in UMD.
*/
amd?: string;
/**
* Set comment for `commonjs` (exports) section in UMD.
*/
commonjs?: string;
/**
* Set comment for `commonjs2` (module.exports) section in UMD.
*/
commonjs2?: string;
/**
* Set comment for `root` (global variable) section in UMD.
*/
root?: string;
}
/**
* Description object for all UMD variants of the library name.
*/
export interface LibraryCustomUmdObject {
/**
* Name of the exposed AMD library in the UMD.
*/
amd?: string;
/**
* Name of the exposed commonjs export in the UMD.
*/
commonjs?: string;
/**
* Name of the property exposed globally by a UMD library.
*/
root?: string[] | string;
2018-09-19 18:59:48 +08:00
}
2019-06-04 17:26:04 +08:00
/**
2020-03-13 17:03:17 +08:00
* Enables/Disables experiments (experimental features with relax SemVer compatibility).
2019-06-04 17:26:04 +08:00
*/
export interface Experiments {
/**
* Allow module type 'asset' to generate assets.
*/
asset?: boolean;
/**
* Support WebAssembly as asynchronous EcmaScript Module.
*/
asyncWebAssembly?: boolean;
2019-06-04 17:26:04 +08:00
/**
* Support .mjs files as way to define strict ESM file (node.js).
2019-06-04 17:26:04 +08:00
*/
mjs?: boolean;
/**
2020-03-13 17:03:17 +08:00
* Allow output javascript files as module source type.
*/
outputModule?: boolean;
/**
* Support WebAssembly as synchronous EcmaScript Module (outdated).
*/
syncWebAssembly?: boolean;
/**
* Allow using top-level-await in EcmaScript Modules.
*/
topLevelAwait?: boolean;
2019-06-04 17:26:04 +08:00
}
/**
* Options for infrastructure level logging.
*/
export interface InfrastructureLogging {
/**
* Enable debug logging for specific loggers.
*/
debug?: boolean | FilterTypes;
/**
* Log level.
*/
level?: "none" | "error" | "warn" | "info" | "log" | "verbose";
}
/**
* Custom values available in the loader context.
*/
export interface Loader {
[k: string]: any;
}
/**
* Options affecting the normal modules (`NormalModuleFactory`).
*/
export interface ModuleOptions {
2018-09-19 16:17:33 +08:00
/**
* An array of rules applied by default for modules.
*/
defaultRules?: RuleSetRules;
2018-05-08 12:04:57 +08:00
/**
* Enable warnings for full dynamic dependencies.
2018-05-08 12:04:57 +08:00
*/
exprContextCritical?: boolean;
/**
* Enable recursive directory lookup for full dynamic dependencies.
2018-05-08 12:04:57 +08:00
*/
exprContextRecursive?: boolean;
/**
* Sets the default regular expression for full dynamic dependencies.
2018-05-08 12:04:57 +08:00
*/
exprContextRegExp?: RegExp | boolean;
2018-05-08 12:04:57 +08:00
/**
* Set the default request for full dynamic dependencies.
2018-05-08 12:04:57 +08:00
*/
exprContextRequest?: string;
/**
* Don't parse files matching. It's matched against the full resolved request.
*/
2019-08-06 15:00:05 +08:00
noParse?:
| [RegExp | string | Function, ...(RegExp | string | Function)[]]
2019-08-06 15:00:05 +08:00
| RegExp
| string
| Function;
2018-05-08 12:04:57 +08:00
/**
* An array of rules applied for modules.
*/
rules?: RuleSetRules;
/**
* Emit errors instead of warnings when imported names don't exist in imported module.
2018-05-08 12:04:57 +08:00
*/
2018-09-19 16:17:33 +08:00
strictExportPresence?: boolean;
/**
* Handle the this context correctly according to the spec for namespace objects.
2018-09-19 16:17:33 +08:00
*/
strictThisContextOnImports?: boolean;
2018-05-08 12:04:57 +08:00
/**
* Enable warnings when using the require function in a not statically analyse-able way.
2018-05-08 12:04:57 +08:00
*/
unknownContextCritical?: boolean;
/**
* Enable recursive directory lookup when using the require function in a not statically analyse-able way.
2018-05-08 12:04:57 +08:00
*/
unknownContextRecursive?: boolean;
/**
* Sets the regular expression when using the require function in a not statically analyse-able way.
2018-05-08 12:04:57 +08:00
*/
unknownContextRegExp?: RegExp | boolean;
2018-05-08 12:04:57 +08:00
/**
* Sets the request when using the require function in a not statically analyse-able way.
2018-05-08 12:04:57 +08:00
*/
unknownContextRequest?: string;
/**
* Cache the resolving of module requests.
2018-05-08 12:04:57 +08:00
*/
2018-09-19 18:59:48 +08:00
unsafeCache?: boolean | Function;
2018-05-08 12:04:57 +08:00
/**
* Enable warnings for partial dynamic dependencies.
2018-05-08 12:04:57 +08:00
*/
wrappedContextCritical?: boolean;
/**
* Enable recursive directory lookup for partial dynamic dependencies.
2018-05-08 12:04:57 +08:00
*/
wrappedContextRecursive?: boolean;
/**
* Set the inner regular expression for partial dynamic dependencies.
2018-05-08 12:04:57 +08:00
*/
2018-09-21 14:39:15 +08:00
wrappedContextRegExp?: RegExp;
2018-05-08 12:04:57 +08:00
}
/**
* A rule description with conditions and effects for modules.
*/
2018-05-08 12:04:57 +08:00
export interface RuleSetRule {
2018-09-19 16:17:33 +08:00
/**
* Match the child compiler name.
2018-09-19 16:17:33 +08:00
*/
2018-09-18 21:17:44 +08:00
compiler?: RuleSetConditionOrConditions;
/**
* Match values of properties in the description file (usually package.json).
*/
descriptionData?: {
[k: string]: RuleSetConditionOrConditions;
};
2018-05-08 12:04:57 +08:00
/**
* Enforce this rule as pre or post step.
2018-05-08 12:04:57 +08:00
*/
enforce?: "pre" | "post";
/**
* Shortcut for resource.exclude.
2018-05-08 12:04:57 +08:00
*/
exclude?: RuleSetConditionOrConditionsAbsolute;
2019-11-16 00:27:36 +08:00
/**
* The options for the module generator.
2019-11-16 00:27:36 +08:00
*/
generator?: {
[k: string]: any;
};
2018-05-08 12:04:57 +08:00
/**
* Shortcut for resource.include.
2018-05-08 12:04:57 +08:00
*/
include?: RuleSetConditionOrConditionsAbsolute;
2018-05-08 12:04:57 +08:00
/**
* Match the issuer of the module (The module pointing to this module).
2018-05-08 12:04:57 +08:00
*/
issuer?: RuleSetConditionOrConditionsAbsolute;
2018-05-08 12:04:57 +08:00
/**
* Shortcut for use.loader.
2018-05-08 12:04:57 +08:00
*/
loader?: RuleSetLoader;
2020-05-18 15:00:28 +08:00
/**
2020-06-05 19:41:25 +08:00
* Match module mimetype when load from Data URI.
2020-05-18 15:00:28 +08:00
*/
2020-06-05 19:41:25 +08:00
mimetype?: RuleSetConditionOrConditions;
2018-05-08 12:04:57 +08:00
/**
* Only execute the first matching rule in this array.
2018-05-08 12:04:57 +08:00
*/
oneOf?: RuleSetRule[];
2018-05-08 12:04:57 +08:00
/**
* Shortcut for use.options.
2018-05-08 12:04:57 +08:00
*/
options?: RuleSetLoaderOptions;
2018-05-08 12:04:57 +08:00
/**
* Options for parsing.
2018-05-08 12:04:57 +08:00
*/
parser?: {
[k: string]: any;
};
/**
* Match the real resource path of the module.
2018-05-08 12:04:57 +08:00
*/
realResource?: RuleSetConditionOrConditionsAbsolute;
2018-05-08 12:04:57 +08:00
/**
* Options for the resolver.
2018-05-08 12:04:57 +08:00
*/
2018-09-19 16:37:53 +08:00
resolve?: ResolveOptions;
2018-05-08 12:04:57 +08:00
/**
* Match the resource path of the module.
2018-05-08 12:04:57 +08:00
*/
resource?: RuleSetConditionOrConditionsAbsolute;
2020-07-03 23:03:15 +08:00
/**
* Match the resource fragment of the module.
*/
resourceFragment?: RuleSetConditionOrConditions;
2018-05-08 12:04:57 +08:00
/**
* Match the resource query of the module.
2018-05-08 12:04:57 +08:00
*/
2018-09-18 21:17:44 +08:00
resourceQuery?: RuleSetConditionOrConditions;
2018-05-08 12:04:57 +08:00
/**
* Match and execute these rules when this rule is matched.
2018-05-08 12:04:57 +08:00
*/
rules?: RuleSetRule[];
2018-09-19 16:17:33 +08:00
/**
* Flags a module as with or without side effects.
2018-09-19 16:17:33 +08:00
*/
sideEffects?: boolean;
2018-05-08 12:04:57 +08:00
/**
* Shortcut for resource.test.
2018-05-08 12:04:57 +08:00
*/
test?: RuleSetConditionOrConditionsAbsolute;
2018-09-19 16:17:33 +08:00
/**
* Module type to use for the module.
2018-09-19 16:17:33 +08:00
*/
type?: string;
2018-05-08 12:04:57 +08:00
/**
* Modifiers applied to the module when rule is matched.
2018-05-08 12:04:57 +08:00
*/
use?: RuleSetUse;
}
/**
* Options object for resolving requests.
*/
2018-09-19 16:37:53 +08:00
export interface ResolveOptions {
2018-05-08 12:04:57 +08:00
/**
* Redirect module requests.
2018-05-08 12:04:57 +08:00
*/
alias?:
| {
/**
* New request.
2018-05-08 12:04:57 +08:00
*/
alias: string[] | false | string;
2018-05-08 12:04:57 +08:00
/**
* Request to be redirected.
2018-05-08 12:04:57 +08:00
*/
2019-07-12 21:40:52 +08:00
name: string;
2018-05-08 12:04:57 +08:00
/**
* Redirect only exact matching request.
2018-05-08 12:04:57 +08:00
*/
onlyModule?: boolean;
}[]
| {
/**
* New request.
*/
[k: string]: string[] | false | string;
};
2018-05-08 12:04:57 +08:00
/**
* Fields in the description file (usually package.json) which are used to redirect requests inside the module.
2018-05-08 12:04:57 +08:00
*/
aliasFields?: (string[] | string)[];
/**
* Extra resolve options per dependency category. Typical categories are "commonjs", "amd", "esm".
*/
byDependency?: {
/**
* Options object for resolving requests.
*/
[k: string]: ResolveOptions;
};
/**
* Enable caching of successfully resolved requests (cache entries are revalidated).
*/
cache?: boolean;
2018-05-08 12:04:57 +08:00
/**
* Predicate function to decide which requests should be cached.
2018-05-08 12:04:57 +08:00
*/
cachePredicate?: (
request: import("enhanced-resolve").ResolveRequest
) => boolean;
2018-05-08 12:04:57 +08:00
/**
* Include the context information in the cache identifier when caching.
2018-05-08 12:04:57 +08:00
*/
cacheWithContext?: boolean;
/**
* Condition names for exports field entry point.
*/
conditionNames?: string[];
2018-05-08 12:04:57 +08:00
/**
* Filenames used to find a description file (like a package.json).
2018-05-08 12:04:57 +08:00
*/
descriptionFiles?: string[];
2018-05-08 12:04:57 +08:00
/**
* Enforce the resolver to use one of the extensions from the extensions option (User must specify requests without extension).
2018-05-08 12:04:57 +08:00
*/
enforceExtension?: boolean;
/**
2020-05-28 03:47:37 +08:00
* Field names from the description file (usually package.json) which are used to provide entry points of a package.
*/
exportsFields?: string[];
2018-05-08 12:04:57 +08:00
/**
* Extensions added to the request when trying to find the file.
2018-05-08 12:04:57 +08:00
*/
extensions?: string[];
2018-05-08 12:04:57 +08:00
/**
* Filesystem for the resolver.
2018-05-08 12:04:57 +08:00
*/
fileSystem?: import("../lib/util/fs").InputFileSystem;
/**
* Treats the request specified by the user as fully specified, meaning no extensions are added and the mainFiles in directories are not resolved (This doesn't affect requests from mainFields, aliasFields or aliases).
*/
fullySpecified?: boolean;
2018-05-08 12:04:57 +08:00
/**
* Field names from the description file (package.json) which are used to find the default entry point.
2018-05-08 12:04:57 +08:00
*/
mainFields?: (string[] | string)[];
2018-05-08 12:04:57 +08:00
/**
* Filenames used to find the default entry point if there is no description file or main field.
2018-05-08 12:04:57 +08:00
*/
mainFiles?: string[];
2018-05-08 12:04:57 +08:00
/**
* Folder names or directory paths where to find modules.
2018-05-08 12:04:57 +08:00
*/
modules?: string[];
2018-05-08 12:04:57 +08:00
/**
* Plugins for the resolver.
2018-05-08 12:04:57 +08:00
*/
plugins?: ("..." | ResolvePluginInstance)[];
2018-05-08 12:04:57 +08:00
/**
* Custom resolver.
2018-05-08 12:04:57 +08:00
*/
resolver?: import("enhanced-resolve").Resolver;
2020-06-09 04:54:59 +08:00
/**
2020-07-09 14:55:52 +08:00
* A list of resolve restrictions. Resolve results must fulfill all of these restrictions to resolve successfully. Other resolve paths are taken when restrictions are not met.
2020-06-09 04:54:59 +08:00
*/
restrictions?: (RegExp | string)[];
2020-07-09 05:12:45 +08:00
/**
2020-07-09 14:55:52 +08:00
* A list of directories in which requests that are server-relative URLs (starting with '/') are resolved. On non-windows system these requests are tried to resolve as absolute path first.
2020-07-09 05:12:45 +08:00
*/
roots?: string[];
2018-05-08 12:04:57 +08:00
/**
* Enable resolving symlinks to the original location.
2018-05-08 12:04:57 +08:00
*/
symlinks?: boolean;
/**
* Enable caching of successfully resolved requests (cache entries are not revalidated).
2018-05-08 12:04:57 +08:00
*/
unsafeCache?:
| boolean
| {
[k: string]: any;
};
/**
* Use synchronous filesystem calls for the resolver.
2018-05-08 12:04:57 +08:00
*/
useSyncFileSystemCalls?: boolean;
}
/**
* Plugin instance.
2018-05-08 12:04:57 +08:00
*/
export interface ResolvePluginInstance {
2018-05-08 12:04:57 +08:00
/**
* The run point of the plugin, required method.
*/
apply: (resolver: import("enhanced-resolve/lib/Resolver")) => void;
2018-05-08 12:04:57 +08:00
[k: string]: any;
}
/**
* Options object for node compatibility features.
*/
2018-09-19 16:37:53 +08:00
export interface NodeOptions {
2018-05-08 12:04:57 +08:00
/**
* Include a polyfill for the '__dirname' variable.
2018-05-08 12:04:57 +08:00
*/
2018-09-19 16:37:53 +08:00
__dirname?: false | true | "mock";
2018-05-08 12:04:57 +08:00
/**
* Include a polyfill for the '__filename' variable.
2018-05-08 12:04:57 +08:00
*/
2018-09-19 16:37:53 +08:00
__filename?: false | true | "mock";
2018-05-08 12:04:57 +08:00
/**
* Include a polyfill for the 'global' variable.
2018-05-08 12:04:57 +08:00
*/
2018-09-19 16:37:53 +08:00
global?: boolean;
}
/**
* Enables/Disables integrated optimizations.
2018-09-19 16:37:53 +08:00
*/
export interface Optimization {
2018-09-19 16:37:53 +08:00
/**
* Check for incompatible wasm types when importing/exporting from/to ESM.
2018-09-19 16:37:53 +08:00
*/
checkWasmTypes?: boolean;
/**
* Define the algorithm to choose chunk ids (named: readable ids for better debugging, deterministic: numeric hash ids for better long term caching, size: numeric ids focused on minimal initial download size, total-size: numeric ids focused on minimal total download size, false: no algorithm used, as custom one can be provided via plugin).
2018-09-19 16:37:53 +08:00
*/
chunkIds?:
| "natural"
| "named"
| "deterministic"
| "size"
| "total-size"
| false;
2018-09-19 16:37:53 +08:00
/**
* Concatenate modules when possible to generate less modules, more efficient code and enable more optimizations by the minimizer.
2018-09-19 16:37:53 +08:00
*/
concatenateModules?: boolean;
/**
* Emit assets even when errors occur. Critical errors are emitted into the generated code and will cause errors at runtime.
*/
emitOnErrors?: boolean;
2018-09-19 16:37:53 +08:00
/**
* Also flag chunks as loaded which contain a subset of the modules.
2018-09-19 16:37:53 +08:00
*/
flagIncludedChunks?: boolean;
/**
* Creates a module-internal dependency graph for top level symbols, exports and imports, to improve unused exports detection.
*/
innerGraph?: boolean;
2019-01-28 17:40:32 +08:00
/**
* Rename exports when possible to generate shorter code (depends on optimization.usedExports and optimization.providedExports, true/"deterministic": generate short deterministic names optimized for caching, "size": generate the shortest possible names).
2019-01-28 17:40:32 +08:00
*/
mangleExports?: ("size" | "deterministic") | boolean;
2018-09-19 16:37:53 +08:00
/**
* Reduce size of WASM by changing imports to shorter strings.
*/
mangleWasmImports?: boolean;
/**
* Merge chunks which contain the same modules.
2018-09-19 16:37:53 +08:00
*/
mergeDuplicateChunks?: boolean;
/**
* Enable minimizing the output. Uses optimization.minimizer.
*/
minimize?: boolean;
/**
* Minimizer(s) to use for minimizing the output.
2018-09-19 16:37:53 +08:00
*/
minimizer?: ("..." | WebpackPluginInstance | WebpackPluginFunction)[];
2018-09-19 16:37:53 +08:00
/**
* Define the algorithm to choose module ids (natural: numeric ids in order of usage, named: readable ids for better debugging, hashed: (deprecated) short hashes as ids for better long term caching, deterministic: numeric hash ids for better long term caching, size: numeric ids focused on minimal initial download size, false: no algorithm used, as custom one can be provided via plugin).
*/
moduleIds?: "natural" | "named" | "hashed" | "deterministic" | "size" | false;
2018-09-19 16:37:53 +08:00
/**
* Avoid emitting assets when errors occur (deprecated: use 'emitOnErrors' instead).
2018-09-19 16:37:53 +08:00
*/
noEmitOnErrors?: boolean;
/**
* Set process.env.NODE_ENV to a specific value.
2018-09-19 16:37:53 +08:00
*/
nodeEnv?: false | string;
/**
* Generate records with relative paths to be able to move the context folder.
2018-09-19 16:37:53 +08:00
*/
portableRecords?: boolean;
/**
* Figure out which exports are provided by modules to generate more efficient code.
2018-09-19 16:37:53 +08:00
*/
providedExports?: boolean;
/**
* Removes modules from chunks when these modules are already included in all parents.
2018-09-19 16:37:53 +08:00
*/
removeAvailableModules?: boolean;
/**
* Remove chunks which are empty.
2018-09-19 16:37:53 +08:00
*/
removeEmptyChunks?: boolean;
/**
* Create an additional chunk which contains only the webpack runtime and chunk hash maps.
*/
runtimeChunk?: OptimizationRuntimeChunk;
2018-09-19 16:37:53 +08:00
/**
* Skip over modules which are flagged to contain no side effects when exports are not used.
2018-09-19 16:37:53 +08:00
*/
sideEffects?: boolean;
/**
* Optimize duplication and caching by splitting chunks by shared modules and cache group.
2018-09-19 16:37:53 +08:00
*/
splitChunks?: false | OptimizationSplitChunksOptions;
/**
* Figure out which exports are used by modules to mangle export names, omit unused exports and generate more efficient code (true: analyse used exports for each runtime, "global": analyse exports globally for all runtimes combined).
2018-09-19 16:37:53 +08:00
*/
usedExports?: "global" | boolean;
2018-09-19 16:37:53 +08:00
}
/**
* Plugin instance.
*/
export interface WebpackPluginInstance {
/**
* The run point of the plugin, required method.
*/
apply: (compiler: import("../lib/Compiler")) => void;
[k: string]: any;
}
2018-09-19 16:37:53 +08:00
/**
* Options object for splitting chunks into smaller chunks.
2018-09-19 16:37:53 +08:00
*/
export interface OptimizationSplitChunksOptions {
/**
* Sets the name delimiter for created chunks.
2018-09-19 16:37:53 +08:00
*/
automaticNameDelimiter?: string;
/**
* Assign modules to a cache group (modules from different cache groups are tried to keep in separate chunks, default categories: 'default', 'defaultVendors').
2018-09-19 16:37:53 +08:00
*/
cacheGroups?: {
/**
* Configuration for a cache group.
2018-09-19 16:37:53 +08:00
*/
[k: string]:
| false
2018-09-21 14:39:15 +08:00
| RegExp
| string
| Function
| OptimizationSplitChunksCacheGroup;
2018-09-19 16:37:53 +08:00
};
/**
* Select chunks for determining shared modules (defaults to "async", "initial" and "all" requires adding these chunks to the HTML).
2018-09-19 16:37:53 +08:00
*/
2020-04-20 15:26:08 +08:00
chunks?:
| ("initial" | "async" | "all")
| ((chunk: import("../lib/Chunk")) => boolean);
/**
* Size threshold at which splitting is enforced and other restrictions (minRemainingSize, maxAsyncRequests, maxInitialRequests) are ignored.
*/
enforceSizeThreshold?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
/**
* Options for modules not selected by any other cache group.
2018-09-19 16:37:53 +08:00
*/
fallbackCacheGroup?: {
/**
* Sets the name delimiter for created chunks.
2018-09-19 16:37:53 +08:00
*/
automaticNameDelimiter?: string;
/**
* Maximal size hint for the on-demand chunks.
*/
maxAsyncSize?: OptimizationSplitChunksSizes;
/**
* Maximal size hint for the initial chunks.
*/
maxInitialSize?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
/**
* Maximal size hint for the created chunks.
2018-09-19 16:37:53 +08:00
*/
maxSize?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
/**
* Minimal size for the created chunk.
2018-09-19 16:37:53 +08:00
*/
minSize?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
};
/**
* Sets the template for the filename for created chunks.
2018-09-19 16:37:53 +08:00
*/
filename?:
| string
2019-09-13 17:12:26 +08:00
| ((
pathData: import("../lib/Compilation").PathData,
assetInfo?: import("../lib/Compilation").AssetInfo
) => string);
2018-09-19 16:37:53 +08:00
/**
* Prevents exposing path info when creating names for parts splitted by maxSize.
2018-09-19 16:37:53 +08:00
*/
hidePathInfo?: boolean;
/**
* Maximum number of requests which are accepted for on-demand loading.
2018-09-19 16:37:53 +08:00
*/
maxAsyncRequests?: number;
/**
* Maximal size hint for the on-demand chunks.
*/
maxAsyncSize?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
/**
* Maximum number of initial chunks which are accepted for an entry point.
2018-09-19 16:37:53 +08:00
*/
maxInitialRequests?: number;
/**
* Maximal size hint for the initial chunks.
*/
maxInitialSize?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
/**
* Maximal size hint for the created chunks.
2018-09-19 16:37:53 +08:00
*/
maxSize?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
/**
* Minimum number of times a module has to be duplicated until it's considered for splitting.
2018-09-19 16:37:53 +08:00
*/
minChunks?: number;
/**
* Minimal size for the chunks the stay after moving the modules to a new chunk.
*/
minRemainingSize?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
/**
* Minimal size for the created chunks.
2018-09-19 16:37:53 +08:00
*/
minSize?: OptimizationSplitChunksSizes;
2018-09-19 16:37:53 +08:00
/**
* Give chunks created a name (chunks with equal name are merged).
2018-09-19 16:37:53 +08:00
*/
name?: false | string | Function;
/**
* Compare used exports when checking common modules. Modules will only be put in the same chunk when exports are equal.
*/
usedExports?: boolean;
2018-09-19 16:37:53 +08:00
}
/**
* Options object for describing behavior of a cache group selecting modules that should be cached together.
*/
export interface OptimizationSplitChunksCacheGroup {
/**
* Sets the name delimiter for created chunks.
*/
automaticNameDelimiter?: string;
/**
* Select chunks for determining cache group content (defaults to "initial", "initial" and "all" requires adding these chunks to the HTML).
*/
2018-12-12 17:46:44 +08:00
chunks?:
| ("initial" | "async" | "all")
| ((chunk: import("../lib/Chunk")) => boolean);
/**
* Ignore minimum size, minimum chunks and maximum requests and always create chunks for this cache group.
*/
enforce?: boolean;
/**
* Size threshold at which splitting is enforced and other restrictions (minRemainingSize, maxAsyncRequests, maxInitialRequests) are ignored.
*/
enforceSizeThreshold?: OptimizationSplitChunksSizes;
/**
* Sets the template for the filename for created chunks.
*/
filename?:
| string
2019-09-13 17:12:26 +08:00
| ((
pathData: import("../lib/Compilation").PathData,
assetInfo?: import("../lib/Compilation").AssetInfo
) => string);
/**
* Sets the hint for chunk id.
*/
idHint?: string;
/**
* Maximum number of requests which are accepted for on-demand loading.
*/
maxAsyncRequests?: number;
/**
* Maximal size hint for the on-demand chunks.
*/
maxAsyncSize?: OptimizationSplitChunksSizes;
/**
* Maximum number of initial chunks which are accepted for an entry point.
*/
maxInitialRequests?: number;
/**
* Maximal size hint for the initial chunks.
*/
maxInitialSize?: OptimizationSplitChunksSizes;
/**
* Maximal size hint for the created chunks.
*/
maxSize?: OptimizationSplitChunksSizes;
/**
* Minimum number of times a module has to be duplicated until it's considered for splitting.
*/
minChunks?: number;
/**
* Minimal size for the chunks the stay after moving the modules to a new chunk.
*/
minRemainingSize?: OptimizationSplitChunksSizes;
/**
* Minimal size for the created chunk.
*/
minSize?: OptimizationSplitChunksSizes;
/**
* Give chunks for this cache group a name (chunks with equal name are merged).
*/
name?: false | string | Function;
/**
* Priority of this cache group.
*/
priority?: number;
/**
* Try to reuse existing chunk (with name) when it has matching modules.
*/
reuseExistingChunk?: boolean;
/**
* Assign modules to a cache group by module name.
*/
test?: RegExp | string | Function;
/**
* Assign modules to a cache group by module type.
*/
type?: RegExp | string | Function;
/**
* Compare used exports when checking common modules. Modules will only be put in the same chunk when exports are equal.
*/
usedExports?: boolean;
}
2018-09-19 16:37:53 +08:00
/**
* Options affecting the output of the compilation. `output` options tell webpack how to write the compiled files to disk.
2018-09-19 16:37:53 +08:00
*/
export interface Output {
/**
* The filename of asset modules as relative path inside the `output.path` directory.
*/
2020-02-20 03:25:49 +08:00
assetModuleFilename?: AssetModuleFilename;
2018-09-19 16:37:53 +08:00
/**
* Add a comment in the UMD wrapper.
*/
2020-02-20 03:25:49 +08:00
auxiliaryComment?: AuxiliaryComment;
2020-08-17 20:25:27 +08:00
/**
* Add charset attribute for script tag
*/
charset?: boolean;
2018-09-19 16:37:53 +08:00
/**
* The callback function name used by webpack for loading of chunks in WebWorkers.
*/
2020-02-20 03:25:49 +08:00
chunkCallbackName?: ChunkCallbackName;
2018-09-19 16:37:53 +08:00
/**
* The filename of non-entry chunks as relative path inside the `output.path` directory.
*/
2020-02-20 03:25:49 +08:00
chunkFilename?: ChunkFilename;
2018-09-19 16:37:53 +08:00
/**
* Number of milliseconds before chunk request expires.
2018-09-19 16:37:53 +08:00
*/
2020-02-20 03:25:49 +08:00
chunkLoadTimeout?: ChunkLoadTimeout;
2019-11-04 23:46:45 +08:00
/**
* Check if to be emitted file already exists and have the same content before writing to output filesystem.
2019-11-04 23:46:45 +08:00
*/
2020-02-20 03:25:49 +08:00
compareBeforeEmit?: CompareBeforeEmit;
2018-09-19 16:37:53 +08:00
/**
* This option enables cross-origin loading of chunks.
*/
2020-02-20 03:25:49 +08:00
crossOriginLoading?: CrossOriginLoading;
2018-09-19 16:37:53 +08:00
/**
* Similar to `output.devtoolModuleFilenameTemplate`, but used in the case of duplicate module identifiers.
*/
2020-02-20 03:25:49 +08:00
devtoolFallbackModuleFilenameTemplate?: DevtoolFallbackModuleFilenameTemplate;
2018-05-08 12:04:57 +08:00
/**
* Filename template string of function for the sources array in a generated SourceMap.
*/
2020-02-20 03:25:49 +08:00
devtoolModuleFilenameTemplate?: DevtoolModuleFilenameTemplate;
2018-05-08 12:04:57 +08:00
/**
* Module namespace to use when interpolating filename template string for the sources array in a generated SourceMap. Defaults to `output.library` if not set. It's useful for avoiding runtime collisions in sourcemaps from multiple webpack projects built as libraries.
*/
2020-02-20 03:25:49 +08:00
devtoolNamespace?: DevtoolNamespace;
/**
* The maximum EcmaScript version of the webpack generated code (doesn't include input source code from modules).
*/
2020-02-20 03:25:49 +08:00
ecmaVersion?: EcmaVersion;
/**
* List of library types enabled for use by entry points.
2020-02-20 03:25:49 +08:00
*/
enabledLibraryTypes?: EnabledLibraryTypes;
2018-05-08 12:04:57 +08:00
/**
* Specifies the name of each output file on disk. You must **not** specify an absolute path here! The `output.path` option determines the location on disk the files are written to, filename is used solely for naming the individual files.
*/
2020-02-20 03:25:49 +08:00
filename?: Filename;
2018-09-19 16:17:33 +08:00
/**
* An expression which is used to address the global object/scope in runtime code.
2018-09-19 16:17:33 +08:00
*/
2020-02-20 03:25:49 +08:00
globalObject?: GlobalObject;
2018-05-08 12:04:57 +08:00
/**
* Digest type used for the hash.
2018-05-08 12:04:57 +08:00
*/
2020-02-20 03:25:49 +08:00
hashDigest?: HashDigest;
2018-05-08 12:04:57 +08:00
/**
* Number of chars which are used for the hash.
2018-05-08 12:04:57 +08:00
*/
2020-02-20 03:25:49 +08:00
hashDigestLength?: HashDigestLength;
2018-05-08 12:04:57 +08:00
/**
* Algorithm used for generation the hash (see node.js crypto package).
2018-05-08 12:04:57 +08:00
*/
2020-02-20 03:25:49 +08:00
hashFunction?: HashFunction;
2018-05-08 12:04:57 +08:00
/**
* Any string which is added to the hash to salt it.
2018-05-08 12:04:57 +08:00
*/
2020-02-20 03:25:49 +08:00
hashSalt?: HashSalt;
2018-05-08 12:04:57 +08:00
/**
* The filename of the Hot Update Chunks. They are inside the output.path directory.
*/
2020-02-20 03:25:49 +08:00
hotUpdateChunkFilename?: HotUpdateChunkFilename;
2018-05-08 12:04:57 +08:00
/**
* The JSONP function used by webpack for async loading of hot update chunks.
*/
2020-02-20 03:25:49 +08:00
hotUpdateFunction?: HotUpdateFunction;
2018-05-08 12:04:57 +08:00
/**
* The filename of the Hot Update Main File. It is inside the `output.path` directory.
*/
2020-02-20 03:25:49 +08:00
hotUpdateMainFilename?: HotUpdateMainFilename;
/**
2020-03-13 17:03:17 +08:00
* Wrap javascript code into IIFE's to avoid leaking into global scope.
*/
2020-02-20 03:25:49 +08:00
iife?: Iife;
/**
* The name of the native import() function (can be exchanged for a polyfill).
*/
importFunctionName?: ImportFunctionName;
2018-05-08 12:04:57 +08:00
/**
* The JSONP function used by webpack for async loading of chunks.
*/
2020-02-20 03:25:49 +08:00
jsonpFunction?: JsonpFunction;
2018-05-08 12:04:57 +08:00
/**
* Make the output files a library, exporting the exports of the entry point.
2018-05-08 12:04:57 +08:00
*/
2020-02-20 03:25:49 +08:00
library?: Library;
2018-09-19 16:17:33 +08:00
/**
* Specify which export should be exposed as library.
2018-09-19 16:17:33 +08:00
*/
2020-02-20 03:25:49 +08:00
libraryExport?: LibraryExport;
2018-05-08 12:04:57 +08:00
/**
* Type of library.
2018-05-08 12:04:57 +08:00
*/
2020-02-20 03:25:49 +08:00
libraryTarget?: LibraryType;
/**
* Output javascript files as module source type.
*/
2020-02-20 03:25:49 +08:00
module?: OutputModule;
2018-05-08 12:04:57 +08:00
/**
* The output directory as **absolute path** (required).
*/
2020-02-20 03:25:49 +08:00
path?: Path;
2018-05-08 12:04:57 +08:00
/**
* Include comments with information about the modules.
*/
2020-02-20 03:25:49 +08:00
pathinfo?: Pathinfo;
2018-05-08 12:04:57 +08:00
/**
* The `publicPath` specifies the public URL address of the output files when referenced in a browser.
*/
2020-02-20 03:25:49 +08:00
publicPath?: PublicPath;
2020-06-25 04:05:21 +08:00
/**
* This option enables loading async chunks via a custom script type, such as script type="module".
*/
scriptType?: ScriptType;
2018-05-08 12:04:57 +08:00
/**
* The filename of the SourceMaps for the JavaScript files. They are inside the `output.path` directory.
*/
2020-02-20 03:25:49 +08:00
sourceMapFilename?: SourceMapFilename;
2018-05-08 12:04:57 +08:00
/**
* Prefixes every line of the source in the bundle with this string.
*/
2020-02-20 03:25:49 +08:00
sourcePrefix?: SourcePrefix;
2018-05-08 12:04:57 +08:00
/**
* Handles exceptions in module loading correctly at a performance cost.
*/
2020-02-20 03:25:49 +08:00
strictModuleExceptionHandling?: StrictModuleExceptionHandling;
2018-05-08 12:04:57 +08:00
/**
* If `output.libraryTarget` is set to umd and `output.library` is set, setting this to true will name the AMD module.
*/
2020-02-20 03:25:49 +08:00
umdNamedDefine?: UmdNamedDefine;
/**
* A unique name of the webpack build to avoid multiple webpack runtimes to conflict when using globals.
*/
2020-02-20 03:25:49 +08:00
uniqueName?: UniqueName;
2018-09-19 16:17:33 +08:00
/**
* The filename of WebAssembly modules as relative path inside the `output.path` directory.
*/
2020-02-20 03:25:49 +08:00
webassemblyModuleFilename?: WebassemblyModuleFilename;
2018-05-08 12:04:57 +08:00
}
2018-09-19 16:37:53 +08:00
/**
* Configuration object for web performance recommendations.
2018-09-19 16:37:53 +08:00
*/
export interface PerformanceOptions {
/**
* Filter function to select assets that are checked.
2018-09-19 16:37:53 +08:00
*/
2018-09-19 18:59:48 +08:00
assetFilter?: Function;
2018-09-19 16:37:53 +08:00
/**
* Sets the format of the hints: warnings, errors or nothing at all.
2018-09-19 16:37:53 +08:00
*/
hints?: false | "warning" | "error";
/**
2020-03-13 17:03:17 +08:00
* File size limit (in bytes) when exceeded, that webpack will provide performance hints.
2018-09-19 16:37:53 +08:00
*/
maxAssetSize?: number;
/**
* Total size of an entry point (in bytes).
2018-09-19 16:37:53 +08:00
*/
maxEntrypointSize?: number;
}
/**
* Stats options object.
2018-09-19 16:37:53 +08:00
*/
export interface StatsOptions {
/**
* Fallback value for stats options when an option is not defined (has precedence over local webpack defaults).
2018-09-19 16:37:53 +08:00
*/
all?: boolean;
/**
* Add assets information.
2018-09-19 16:37:53 +08:00
*/
assets?: boolean;
/**
* Sort the assets by that field.
2018-09-19 16:37:53 +08:00
*/
assetsSort?: string;
/**
* Add built at time information.
2018-09-19 16:37:53 +08:00
*/
builtAt?: boolean;
/**
* Add information about cached (not built) modules.
2018-09-19 16:37:53 +08:00
*/
cached?: boolean;
/**
* Show cached assets (setting this to `false` only shows emitted files).
2018-09-19 16:37:53 +08:00
*/
cachedAssets?: boolean;
/**
* Add children information.
2018-09-19 16:37:53 +08:00
*/
children?: boolean;
/**
* Display all chunk groups with the corresponding bundles.
2018-09-19 16:37:53 +08:00
*/
chunkGroups?: boolean;
/**
* Add built modules information to chunk information.
2018-09-19 16:37:53 +08:00
*/
chunkModules?: boolean;
/**
* Add the origins of chunks and chunk merging info.
2018-09-19 16:37:53 +08:00
*/
chunkOrigins?: boolean;
2018-12-22 20:19:13 +08:00
/**
* Add information about parent, children and sibling chunks to chunk information.
2018-12-22 20:19:13 +08:00
*/
chunkRelations?: boolean;
/**
* Add root modules information to chunk information.
*/
chunkRootModules?: boolean;
2018-09-19 16:37:53 +08:00
/**
* Add chunk information.
2018-09-19 16:37:53 +08:00
*/
chunks?: boolean;
/**
* Sort the chunks by that field.
2018-09-19 16:37:53 +08:00
*/
chunksSort?: string;
/**
* Enables/Disables colorful output.
2018-09-19 16:37:53 +08:00
*/
colors?:
| boolean
| {
/**
* Custom color for bold text.
2018-09-19 16:37:53 +08:00
*/
bold?: string;
/**
* Custom color for cyan text.
2018-09-19 16:37:53 +08:00
*/
cyan?: string;
/**
* Custom color for green text.
2018-09-19 16:37:53 +08:00
*/
green?: string;
/**
* Custom color for magenta text.
2018-09-19 16:37:53 +08:00
*/
magenta?: string;
/**
* Custom color for red text.
2018-09-19 16:37:53 +08:00
*/
red?: string;
/**
* Custom color for yellow text.
2018-09-19 16:37:53 +08:00
*/
yellow?: string;
};
/**
* Context directory for request shortening.
2018-09-19 16:37:53 +08:00
*/
context?: string;
/**
* Add module depth in module graph.
2018-09-19 16:37:53 +08:00
*/
depth?: boolean;
/**
* Display the entry points with the corresponding bundles.
2018-09-19 16:37:53 +08:00
*/
entrypoints?: boolean;
/**
* Add --env information.
2018-09-19 16:37:53 +08:00
*/
env?: boolean;
/**
* Add details to errors (like resolving log).
2018-09-19 16:37:53 +08:00
*/
errorDetails?: boolean;
/**
* Add internal stack trace to errors.
*/
errorStack?: boolean;
2018-09-19 16:37:53 +08:00
/**
* Add errors.
2018-09-19 16:37:53 +08:00
*/
errors?: boolean;
/**
* Please use excludeModules instead.
*/
exclude?: boolean | FilterTypes;
2018-09-19 16:37:53 +08:00
/**
* Suppress assets that match the specified filters. Filters can be Strings, RegExps or Functions.
2018-09-19 16:37:53 +08:00
*/
excludeAssets?: FilterTypes;
/**
* Suppress modules that match the specified filters. Filters can be Strings, RegExps, Booleans or Functions.
2018-09-19 16:37:53 +08:00
*/
excludeModules?: boolean | FilterTypes;
2018-09-19 16:37:53 +08:00
/**
* Add the hash of the compilation.
2018-09-19 16:37:53 +08:00
*/
hash?: boolean;
2020-02-03 18:00:13 +08:00
/**
* Add ids.
2020-02-03 18:00:13 +08:00
*/
ids?: boolean;
/**
* Add logging output.
*/
logging?: ("none" | "error" | "warn" | "info" | "log" | "verbose") | boolean;
/**
* Include debug logging of specified loggers (i. e. for plugins or loaders). Filters can be Strings, RegExps or Functions.
*/
loggingDebug?: boolean | FilterTypes;
/**
* Add stack traces to logging output.
*/
loggingTrace?: boolean;
2018-09-19 16:37:53 +08:00
/**
* Set the maximum number of modules to be shown.
2018-09-19 16:37:53 +08:00
*/
maxModules?: number;
/**
* Add information about assets inside modules.
2018-09-19 16:37:53 +08:00
*/
moduleAssets?: boolean;
/**
* Add dependencies and origin of warnings/errors.
2018-09-19 16:37:53 +08:00
*/
moduleTrace?: boolean;
/**
* Add built modules information.
2018-09-19 16:37:53 +08:00
*/
modules?: boolean;
/**
* Sort the modules by that field.
2018-09-19 16:37:53 +08:00
*/
modulesSort?: string;
/**
* Add information about modules nested in other modules (like with module concatenation).
2018-09-19 16:37:53 +08:00
*/
nestedModules?: boolean;
/**
* Show reasons why optimization bailed out for modules.
2018-09-19 16:37:53 +08:00
*/
optimizationBailout?: boolean;
2018-09-25 22:07:42 +08:00
/**
* Add information about orphan modules.
2018-09-25 22:07:42 +08:00
*/
orphanModules?: boolean;
2018-09-19 16:37:53 +08:00
/**
* Add output path information.
2018-09-19 16:37:53 +08:00
*/
outputPath?: boolean;
/**
* Add performance hint flags.
2018-09-19 16:37:53 +08:00
*/
performance?: boolean;
2018-12-22 18:58:29 +08:00
/**
* Preset for the default values.
2018-12-22 18:58:29 +08:00
*/
preset?: boolean | string;
2018-09-19 16:37:53 +08:00
/**
* Show exports provided by modules.
2018-09-19 16:37:53 +08:00
*/
providedExports?: boolean;
/**
* Add public path information.
2018-09-19 16:37:53 +08:00
*/
publicPath?: boolean;
/**
* Add information about the reasons why modules are included.
2018-09-19 16:37:53 +08:00
*/
reasons?: boolean;
/**
* Add information about assets that are related to other assets (like SourceMaps for assets).
*/
relatedAssets?: boolean;
/**
* Add information about runtime modules.
*/
runtime?: boolean;
2018-09-19 16:37:53 +08:00
/**
* Add the source code of modules.
2018-09-19 16:37:53 +08:00
*/
source?: boolean;
/**
* Add timing information.
2018-09-19 16:37:53 +08:00
*/
timings?: boolean;
/**
* Show exports used by modules.
2018-09-19 16:37:53 +08:00
*/
usedExports?: boolean;
/**
* Add webpack version information.
2018-09-19 16:37:53 +08:00
*/
version?: boolean;
/**
* Add warnings.
2018-09-19 16:37:53 +08:00
*/
warnings?: boolean;
/**
* Suppress warnings that match the specified filters. Filters can be Strings, RegExps or Functions.
2018-09-19 16:37:53 +08:00
*/
warningsFilter?: FilterTypes;
}
2018-12-10 18:34:59 +08:00
/**
* Options for the watcher.
2018-12-10 18:34:59 +08:00
*/
export interface WatchOptions {
/**
* Delay the rebuilt after the first change. Value is a time in ms.
*/
aggregateTimeout?: number;
/**
* Ignore some files from watching (glob pattern).
2018-12-10 18:34:59 +08:00
*/
ignored?: string[] | string;
2018-12-10 18:34:59 +08:00
/**
* Enable polling mode for watching.
2018-12-10 18:34:59 +08:00
*/
poll?: number | boolean;
2018-12-10 18:34:59 +08:00
/**
* Stop watching when stdin stream has ended.
2018-12-10 18:34:59 +08:00
*/
stdin?: boolean;
}
/**
* An object with entry point description.
*/
export interface EntryDescriptionNormalized {
/**
* The entrypoints that the current entrypoint depend on. They must be loaded when this entrypoint is loaded.
*/
dependOn?: [string, ...string[]];
/**
* Specifies the name of each output file on disk. You must **not** specify an absolute path here! The `output.path` option determines the location on disk the files are written to, filename is used solely for naming the individual files.
*/
filename?: Filename;
/**
* Module(s) that are loaded upon startup. The last one is exported.
*/
import?: [string, ...string[]];
/**
* Options for library.
*/
library?: LibraryOptions;
/**
* The name of the runtime chunk. If set a runtime chunk with this name is created or an existing entrypoint is used as runtime.
*/
runtime?: EntryRuntime;
}
/**
* Multiple entry bundles are created. The key is the entry name. The value is an entry description object.
*/
export interface EntryStaticNormalized {
/**
* An object with entry point description.
*/
[k: string]: EntryDescriptionNormalized;
}
2020-02-20 03:25:49 +08:00
/**
* Normalized options affecting the output of the compilation. `output` options tell webpack how to write the compiled files to disk.
*/
export interface OutputNormalized {
/**
* The filename of asset modules as relative path inside the `output.path` directory.
*/
assetModuleFilename?: AssetModuleFilename;
/**
* The callback function name used by webpack for loading of chunks in WebWorkers.
*/
chunkCallbackName?: ChunkCallbackName;
/**
* The filename of non-entry chunks as relative path inside the `output.path` directory.
*/
chunkFilename?: ChunkFilename;
/**
* Number of milliseconds before chunk request expires.
2020-02-20 03:25:49 +08:00
*/
chunkLoadTimeout?: ChunkLoadTimeout;
/**
* Check if to be emitted file already exists and have the same content before writing to output filesystem.
2020-02-20 03:25:49 +08:00
*/
compareBeforeEmit?: CompareBeforeEmit;
/**
* This option enables cross-origin loading of chunks.
*/
crossOriginLoading?: CrossOriginLoading;
/**
* Similar to `output.devtoolModuleFilenameTemplate`, but used in the case of duplicate module identifiers.
*/
devtoolFallbackModuleFilenameTemplate?: DevtoolFallbackModuleFilenameTemplate;
/**
* Filename template string of function for the sources array in a generated SourceMap.
*/
devtoolModuleFilenameTemplate?: DevtoolModuleFilenameTemplate;
/**
* Module namespace to use when interpolating filename template string for the sources array in a generated SourceMap. Defaults to `output.library` if not set. It's useful for avoiding runtime collisions in sourcemaps from multiple webpack projects built as libraries.
*/
devtoolNamespace?: DevtoolNamespace;
/**
* The maximum EcmaScript version of the webpack generated code (doesn't include input source code from modules).
*/
ecmaVersion?: EcmaVersion;
/**
* List of library types enabled for use by entry points.
2020-02-20 03:25:49 +08:00
*/
enabledLibraryTypes?: EnabledLibraryTypes;
/**
* Specifies the name of each output file on disk. You must **not** specify an absolute path here! The `output.path` option determines the location on disk the files are written to, filename is used solely for naming the individual files.
*/
filename?: Filename;
/**
* An expression which is used to address the global object/scope in runtime code.
2020-02-20 03:25:49 +08:00
*/
globalObject?: GlobalObject;
/**
* Digest type used for the hash.
2020-02-20 03:25:49 +08:00
*/
hashDigest?: HashDigest;
/**
* Number of chars which are used for the hash.
2020-02-20 03:25:49 +08:00
*/
hashDigestLength?: HashDigestLength;
/**
* Algorithm used for generation the hash (see node.js crypto package).
2020-02-20 03:25:49 +08:00
*/
hashFunction?: HashFunction;
/**
* Any string which is added to the hash to salt it.
2020-02-20 03:25:49 +08:00
*/
hashSalt?: HashSalt;
/**
* The filename of the Hot Update Chunks. They are inside the output.path directory.
*/
hotUpdateChunkFilename?: HotUpdateChunkFilename;
/**
* The JSONP function used by webpack for async loading of hot update chunks.
*/
hotUpdateFunction?: HotUpdateFunction;
/**
* The filename of the Hot Update Main File. It is inside the `output.path` directory.
*/
hotUpdateMainFilename?: HotUpdateMainFilename;
/**
2020-03-13 17:03:17 +08:00
* Wrap javascript code into IIFE's to avoid leaking into global scope.
2020-02-20 03:25:49 +08:00
*/
iife?: Iife;
/**
* The name of the native import() function (can be exchanged for a polyfill).
*/
importFunctionName?: ImportFunctionName;
2020-02-20 03:25:49 +08:00
/**
* The JSONP function used by webpack for async loading of chunks.
*/
jsonpFunction?: JsonpFunction;
/**
* Options for library.
2020-02-20 03:25:49 +08:00
*/
library?: LibraryOptions;
/**
* Output javascript files as module source type.
*/
module?: OutputModule;
/**
* The output directory as **absolute path** (required).
*/
path?: Path;
/**
* Include comments with information about the modules.
*/
pathinfo?: Pathinfo;
/**
* The `publicPath` specifies the public URL address of the output files when referenced in a browser.
*/
publicPath?: PublicPath;
2020-06-25 04:05:21 +08:00
/**
* This option enables loading async chunks via a custom script type, such as script type="module".
*/
scriptType?: ScriptType;
2020-02-20 03:25:49 +08:00
/**
* The filename of the SourceMaps for the JavaScript files. They are inside the `output.path` directory.
*/
sourceMapFilename?: SourceMapFilename;
/**
* Prefixes every line of the source in the bundle with this string.
*/
sourcePrefix?: SourcePrefix;
/**
* Handles exceptions in module loading correctly at a performance cost.
*/
strictModuleExceptionHandling?: StrictModuleExceptionHandling;
/**
* A unique name of the webpack build to avoid multiple webpack runtimes to conflict when using globals.
*/
uniqueName?: UniqueName;
/**
* The filename of WebAssembly modules as relative path inside the `output.path` directory.
*/
webassemblyModuleFilename?: WebassemblyModuleFilename;
}
/**
* Normalized webpack options object.
*/
export interface WebpackOptionsNormalized {
/**
* Set the value of `require.amd` and `define.amd`. Or disable AMD support.
*/
amd?: Amd;
/**
* Report the first error as a hard error instead of tolerating it.
*/
bail?: Bail;
/**
* Cache generated modules and chunks to improve performance for multiple incremental builds.
*/
cache: CacheOptionsNormalized;
/**
* The base directory (absolute path!) for resolving the `entry` option. If `output.pathinfo` is set, the included pathinfo is shortened to this directory.
*/
context?: Context;
/**
* References to other configurations to depend on.
*/
dependencies?: Dependencies;
/**
* Options for the webpack-dev-server.
*/
devServer?: DevServer;
/**
* A developer tool to enhance debugging (false | eval | [inline-|hidden-|eval-][nosources-][cheap-[module-]]source-map).
*/
devtool?: DevTool;
/**
* The entry point(s) of the compilation.
*/
entry: EntryNormalized;
/**
2020-03-13 17:03:17 +08:00
* Enables/Disables experiments (experimental features with relax SemVer compatibility).
*/
experiments: Experiments;
/**
* Specify dependencies that shouldn't be resolved by webpack, but should become dependencies of the resulting bundle. The kind of the dependency depends on `output.libraryTarget`.
*/
externals: Externals;
/**
* Specifies the default type of externals ('amd*', 'umd*', 'system' and 'jsonp' depend on output.libraryTarget set to the same value).
*/
externalsType?: ExternalsType;
/**
* Options for infrastructure level logging.
*/
infrastructureLogging: InfrastructureLogging;
/**
* Custom values available in the loader context.
*/
loader?: Loader;
/**
* Enable production optimizations or development hints.
*/
mode?: Mode;
/**
* Options affecting the normal modules (`NormalModuleFactory`).
*/
module: ModuleOptions;
/**
* Name of the configuration. Used when loading multiple configurations.
*/
name?: Name;
/**
* Include polyfills or mocks for various node stuff.
*/
node: Node;
/**
* Enables/Disables integrated optimizations.
*/
optimization: Optimization;
/**
2020-02-20 03:25:49 +08:00
* Normalized options affecting the output of the compilation. `output` options tell webpack how to write the compiled files to disk.
*/
2020-02-20 03:25:49 +08:00
output: OutputNormalized;
/**
* The number of parallel processed modules in the compilation.
*/
parallelism?: Parallelism;
/**
* Configuration for web performance recommendations.
*/
performance?: Performance;
/**
* Add additional plugins to the compiler.
*/
plugins: Plugins;
/**
* Capture timing information for each module.
*/
profile?: Profile;
/**
* Store compiler state to a json file.
*/
recordsInputPath?: RecordsInputPath;
/**
* Load compiler state from a json file.
*/
recordsOutputPath?: RecordsOutputPath;
/**
* Options for the resolver.
*/
resolve: Resolve;
/**
* Options for the resolver when resolving loaders.
*/
resolveLoader: ResolveLoader;
/**
* Stats options object or preset name.
*/
stats: StatsValue;
/**
* Environment to build for.
*/
target?: Target;
/**
* Enter watch mode, which rebuilds on file change.
*/
watch?: Watch;
/**
* Options for the watcher.
*/
watchOptions: WatchOptions;
}