/* MIT License http://www.opensource.org/licenses/mit-license.php Author Tobias Koppers @sokra */ "use strict"; const fs = require("fs"); const path = require("path"); const { CSS_TYPE, JAVASCRIPT_TYPE, UNKNOWN_TYPE } = require("../ModuleSourceTypeConstants"); const { ASSET_MODULE_TYPE, ASSET_MODULE_TYPE_BYTES, ASSET_MODULE_TYPE_INLINE, ASSET_MODULE_TYPE_RESOURCE, ASSET_MODULE_TYPE_SOURCE, CSS_MODULE_TYPE, CSS_MODULE_TYPE_AUTO, CSS_MODULE_TYPE_GLOBAL, CSS_MODULE_TYPE_MODULE, HTML_MODULE_TYPE, JAVASCRIPT_MODULE_TYPE_AUTO, JAVASCRIPT_MODULE_TYPE_DYNAMIC, JAVASCRIPT_MODULE_TYPE_ESM, JSON_MODULE_TYPE, WEBASSEMBLY_MODULE_TYPE_ASYNC, WEBASSEMBLY_MODULE_TYPE_SYNC } = require("../ModuleTypeConstants"); const Template = require("../Template"); const { cleverMerge } = require("../util/cleverMerge"); const { getDefaultTarget, getTargetProperties, getTargetsProperties } = require("./target"); /** @typedef {import("../../declarations/WebpackOptions").CacheOptionsNormalized} CacheOptionsNormalized */ /** @typedef {import("../../declarations/WebpackOptions").Context} Context */ /** @typedef {import("../../declarations/WebpackOptions").DevTool} Devtool */ /** @typedef {import("../../declarations/WebpackOptions").CssGeneratorOptions} CssGeneratorOptions */ /** @typedef {import("../../declarations/WebpackOptions").EntryDescription} EntryDescription */ /** @typedef {import("../../declarations/WebpackOptions").EntryNormalized} Entry */ /** @typedef {import("../../declarations/WebpackOptions").Environment} Environment */ /** @typedef {import("../../declarations/WebpackOptions").Experiments} Experiments */ /** @typedef {import("../../declarations/WebpackOptions").ExperimentsNormalized} ExperimentsNormalized */ /** @typedef {import("../../declarations/WebpackOptions").ExternalsPresets} ExternalsPresets */ /** @typedef {import("../../declarations/WebpackOptions").ExternalsType} ExternalsType */ /** @typedef {import("../../declarations/WebpackOptions").FileCacheOptions} FileCacheOptions */ /** @typedef {import("../../declarations/WebpackOptions").GeneratorOptionsByModuleTypeKnown} GeneratorOptionsByModuleTypeKnown */ /** @typedef {import("../../declarations/WebpackOptions").InfrastructureLogging} InfrastructureLogging */ /** @typedef {import("../../declarations/WebpackOptions").JavascriptParserOptions} JavascriptParserOptions */ /** @typedef {import("../../declarations/WebpackOptions").JsonGeneratorOptions} JsonGeneratorOptions */ /** @typedef {import("../../declarations/WebpackOptions").Library} Library */ /** @typedef {import("../../declarations/WebpackOptions").LibraryName} LibraryName */ /** @typedef {import("../../declarations/WebpackOptions").LibraryType} LibraryType */ /** @typedef {import("../../declarations/WebpackOptions").Loader} Loader */ /** @typedef {import("../../declarations/WebpackOptions").Mode} Mode */ /** @typedef {import("../../declarations/WebpackOptions").HashFunction} HashFunction */ /** @typedef {import("../../declarations/WebpackOptions").HashSalt} HashSalt */ /** @typedef {import("../../declarations/WebpackOptions").HashDigest} HashDigest */ /** @typedef {import("../../declarations/WebpackOptions").HashDigestLength} HashDigestLength */ /** @typedef {import("../../declarations/WebpackOptions").ModuleOptionsNormalized} ModuleOptions */ /** @typedef {import("../../declarations/WebpackOptions").Node} WebpackNode */ /** @typedef {import("../../declarations/WebpackOptions").OptimizationNormalized} Optimization */ /** @typedef {import("../../declarations/WebpackOptions").OptimizationSplitChunksOptions} OptimizationSplitChunksOptions */ /** @typedef {import("../../declarations/WebpackOptions").OutputNormalized} Output */ /** @typedef {import("../../declarations/WebpackOptions").ParserOptionsByModuleTypeKnown} ParserOptionsByModuleTypeKnown */ /** @typedef {import("../../declarations/WebpackOptions").Performance} Performance */ /** @typedef {import("../../declarations/WebpackOptions").ResolveOptions} ResolveOptions */ /** @typedef {import("../../declarations/WebpackOptions").RuleSetRules} RuleSetRules */ /** @typedef {import("../../declarations/WebpackOptions").SnapshotOptions} SnapshotOptions */ /** @typedef {import("../../declarations/WebpackOptions").WebpackOptionsNormalized} WebpackOptionsNormalized */ /** @typedef {import("../Module")} Module */ /** @typedef {import("../javascript/EnableChunkLoadingPlugin").ChunkLoadingTypes} ChunkLoadingTypes */ /** @typedef {import("../wasm/EnableWasmLoadingPlugin").WasmLoadingTypes} WasmLoadingTypes */ /** @typedef {import("./target").PlatformTargetProperties} PlatformTargetProperties */ /** @typedef {import("./target").TargetProperties} TargetProperties */ /** * Defines the recursive non nullable type used by this module. * @template T * @typedef {{ [P in keyof T]-?: T[P] extends object ? RecursiveNonNullable> : NonNullable }} RecursiveNonNullable */ /** * Defines the shared type used by this module. * @typedef {Output & { * uniqueName: NonNullable, * filename: NonNullable, * cssFilename: NonNullable, * chunkFilename: NonNullable, * cssChunkFilename: NonNullable, * hotUpdateChunkFilename: NonNullable, * hotUpdateGlobal: NonNullable, * assetModuleFilename: NonNullable, * webassemblyModuleFilename: NonNullable, * sourceMapFilename: NonNullable, * hotUpdateMainFilename: NonNullable, * devtoolNamespace: NonNullable, * publicPath: NonNullable, * workerPublicPath: NonNullable, * workerWasmLoading: NonNullable, * workerChunkLoading: NonNullable, * chunkFormat: NonNullable, * module: NonNullable, * asyncChunks: NonNullable, * charset: NonNullable, * iife: NonNullable, * globalObject: NonNullable, * scriptType: NonNullable, * path: NonNullable, * pathinfo: NonNullable, * hashFunction: NonNullable, * hashDigest: NonNullable, * hashDigestLength: NonNullable, * chunkLoadTimeout: NonNullable, * chunkLoading: NonNullable, * chunkLoadingGlobal: NonNullable, * compareBeforeEmit: NonNullable, * strictModuleErrorHandling: NonNullable, * strictModuleExceptionHandling: NonNullable, * importFunctionName: NonNullable, * importMetaName: NonNullable, * environment: RecursiveNonNullable, * crossOriginLoading: NonNullable, * wasmLoading: NonNullable, * }} OutputNormalizedWithDefaults */ /** * Defines the shared type used by this module. * @typedef {SnapshotOptions & { * managedPaths: NonNullable, * unmanagedPaths: NonNullable, * immutablePaths: NonNullable, * resolveBuildDependencies: NonNullable, * buildDependencies: NonNullable, * module: NonNullable, * resolve: NonNullable, * }} SnapshotNormalizedWithDefaults */ /** * Defines the shared type used by this module. * @typedef {Optimization & { * runtimeChunk: NonNullable, * splitChunks: NonNullable, * mergeDuplicateChunks: NonNullable, * removeAvailableModules: NonNullable, * removeEmptyChunks: NonNullable, * flagIncludedChunks: NonNullable, * moduleIds: NonNullable, * chunkIds: NonNullable, * sideEffects: NonNullable, * providedExports: NonNullable, * usedExports: NonNullable, * mangleExports: NonNullable, * innerGraph: NonNullable, * concatenateModules: NonNullable, * avoidEntryIife: NonNullable, * emitOnErrors: NonNullable, * checkWasmTypes: NonNullable, * mangleWasmImports: NonNullable, * portableRecords: NonNullable, * realContentHash: NonNullable, * minimize: NonNullable, * minimizer: NonNullable>, * nodeEnv: NonNullable, * }} OptimizationNormalizedWithDefaults */ /** * Defines the shared type used by this module. * @typedef {ExternalsPresets & { * web: NonNullable, * node: NonNullable, * nwjs: NonNullable, * electron: NonNullable, * electronMain: NonNullable, * electronPreload: NonNullable, * electronRenderer: NonNullable, * }} ExternalsPresetsNormalizedWithDefaults */ /** * Defines the shared type used by this module. * @typedef {InfrastructureLogging & { * stream: NonNullable, * level: NonNullable, * debug: NonNullable, * colors: NonNullable, * appendOnly: NonNullable, * }} InfrastructureLoggingNormalizedWithDefaults */ /** * Defines the webpack options normalized with base defaults type used by this module. * @typedef {WebpackOptionsNormalized & { context: NonNullable } & { infrastructureLogging: InfrastructureLoggingNormalizedWithDefaults }} WebpackOptionsNormalizedWithBaseDefaults */ /** * Defines the webpack options normalized with defaults type used by this module. * @typedef {WebpackOptionsNormalizedWithBaseDefaults & { target: NonNullable } & { output: OutputNormalizedWithDefaults } & { optimization: OptimizationNormalizedWithDefaults } & { devtool: NonNullable } & { stats: NonNullable } & { node: NonNullable } & { profile: NonNullable } & { parallelism: NonNullable } & { snapshot: SnapshotNormalizedWithDefaults } & { externalsPresets: ExternalsPresetsNormalizedWithDefaults } & { externalsType: NonNullable } & { watch: NonNullable } & { performance: NonNullable } & { recordsInputPath: NonNullable } & { recordsOutputPath: NonNullable } & { dotenv: NonNullable }} WebpackOptionsNormalizedWithDefaults */ /** * Defines the resolved options type used by this module. * @typedef {object} ResolvedOptions * @property {PlatformTargetProperties | false} platform - platform target properties */ const NODE_MODULES_REGEXP = /[\\/]node_modules[\\/]/i; const DEFAULT_CACHE_NAME = "default"; const DEFAULTS = { // TODO webpack 6 - use xxhash64 HASH_FUNCTION: "md4" }; /** * Processes the provided obj. * @template T * @template {keyof T} P * @param {T} obj an object * @param {P} prop a property of this object * @param {T[P]} value a default value of the property * @returns {void} */ const D = (obj, prop, value) => { if (obj[prop] === undefined) { obj[prop] = value; } }; /** * Processes the provided obj. * @template T * @template {keyof T} P * @param {T} obj an object * @param {P} prop a property of this object * @param {() => T[P]} factory a default value factory for the property * @returns {void} */ const F = (obj, prop, factory) => { if (obj[prop] === undefined) { obj[prop] = factory(); } }; /** * Sets a dynamic default value when undefined, by calling the factory function. * factory must return an array or undefined * When the current value is already an array an contains "..." it's replaced with * the result of the factory function * @template T * @template {keyof T} P * @param {T} obj an object * @param {P} prop a property of this object * @param {() => T[P]} factory a default value factory for the property * @returns {void} */ const A = (obj, prop, factory) => { const value = obj[prop]; if (value === undefined) { obj[prop] = factory(); } else if (Array.isArray(value)) { /** @type {EXPECTED_ANY[] | undefined} */ let newArray; for (let i = 0; i < value.length; i++) { const item = value[i]; if (item === "...") { if (newArray === undefined) { newArray = value.slice(0, i); obj[prop] = /** @type {T[P]} */ (/** @type {unknown} */ (newArray)); } const items = /** @type {EXPECTED_ANY[]} */ (/** @type {unknown} */ (factory())); if (items !== undefined) { for (const item of items) { newArray.push(item); } } } else if (newArray !== undefined) { newArray.push(item); } } } }; /** * Apply webpack options base defaults. * @param {WebpackOptionsNormalized} options options to be modified * @returns {void} */ const applyWebpackOptionsBaseDefaults = (options) => { F(options, "context", () => process.cwd()); applyInfrastructureLoggingDefaults(options.infrastructureLogging); }; /** * Apply webpack options defaults. * @param {WebpackOptionsNormalized} options options to be modified * @param {number=} compilerIndex index of compiler * @returns {ResolvedOptions} Resolved options after apply defaults */ const applyWebpackOptionsDefaults = (options, compilerIndex) => { F(options, "context", () => process.cwd()); F(options, "target", () => getDefaultTarget(/** @type {string} */ (options.context)) ); const { mode, name, target } = options; const targetProperties = target === false ? /** @type {false} */ (false) : typeof target === "string" ? getTargetProperties(target, /** @type {Context} */ (options.context)) : getTargetsProperties( /** @type {string[]} */ (target), /** @type {Context} */ (options.context) ); const development = mode === "development"; const production = mode === "production" || !mode; if (typeof options.entry !== "function") { for (const key of Object.keys(options.entry)) { F( options.entry[key], "import", () => /** @type {[string]} */ (["./src"]) ); } } F( options, "devtool", () => /** @type {Devtool} */ ( development ? [ options.experiments.css ? { type: "css", use: "source-map" } : undefined, { type: "javascript", use: "eval" } ].filter(Boolean) : false ) ); D(options, "watch", false); D(options, "profile", false); D(options, "parallelism", 100); D(options, "recordsInputPath", false); D(options, "recordsOutputPath", false); applyExperimentsDefaults(options.experiments, { production, development, targetProperties }); const futureDefaults = /** @type {NonNullable} */ (options.experiments.futureDefaults); F(options, "validate", () => !(futureDefaults === true && production)); F(options, "cache", () => development ? { type: /** @type {"memory"} */ ("memory") } : false ); applyCacheDefaults(options.cache, { name: name || DEFAULT_CACHE_NAME, mode: mode || "production", development, cacheUnaffected: options.experiments.cacheUnaffected, futureDefaults, compilerIndex }); const cache = Boolean(options.cache); applySnapshotDefaults(options.snapshot, { production, futureDefaults }); applyOutputDefaults(options.output, { context: /** @type {Context} */ (options.context), targetProperties, isAffectedByBrowserslist: target === undefined || (typeof target === "string" && target.startsWith("browserslist")) || (Array.isArray(target) && target.some((target) => target.startsWith("browserslist"))), outputModule: /** @type {NonNullable} */ (options.experiments.outputModule), development, entry: options.entry, futureDefaults, asyncWebAssembly: /** @type {NonNullable} */ (options.experiments.asyncWebAssembly) }); applyModuleDefaults(options.module, { cache, hashSalt: /** @type {NonNullable} */ ( options.output.hashSalt ), hashFunction: /** @type {NonNullable} */ ( options.output.hashFunction ), syncWebAssembly: /** @type {NonNullable} */ (options.experiments.syncWebAssembly), asyncWebAssembly: /** @type {NonNullable} */ (options.experiments.asyncWebAssembly), css: /** @type {NonNullable} */ (options.experiments.css), html: /** @type {NonNullable} */ (options.experiments.html), typescript: /** @type {NonNullable} */ (options.experiments.typescript), deferImport: /** @type {NonNullable} */ (options.experiments.deferImport), sourceImport: /** @type {NonNullable} */ (options.experiments.sourceImport), futureDefaults, isNode: targetProperties && targetProperties.node === true, uniqueName: /** @type {string} */ (options.output.uniqueName), targetProperties, mode: options.mode, outputModule: /** @type {NonNullable} */ (options.output.module), library: options.output.library }); applyExternalsPresetsDefaults(options.externalsPresets, { targetProperties, buildHttp: Boolean(options.experiments.buildHttp), outputModule: /** @type {NonNullable} */ (options.output.module) }); applyLoaderDefaults( /** @type {NonNullable} */ ( options.loader ), { targetProperties, environment: options.output.environment } ); F(options, "externalsType", () => { const validExternalTypes = require("../../schemas/WebpackOptions.json") .definitions.ExternalsType.enum; return options.output.library && validExternalTypes.includes(options.output.library.type) ? /** @type {ExternalsType} */ (options.output.library.type) : options.output.module ? "module-import" : "var"; }); applyNodeDefaults(options.node, { futureDefaults: /** @type {NonNullable} */ (options.experiments.futureDefaults), outputModule: /** @type {NonNullable} */ (options.output.module), targetProperties }); F(options, "performance", () => production && targetProperties && (targetProperties.browser || targetProperties.browser === null) ? {} : false ); applyPerformanceDefaults( /** @type {NonNullable} */ (options.performance), { production } ); applyOptimizationDefaults(options.optimization, { development, production, css: /** @type {NonNullable} */ (options.experiments.css), records: Boolean(options.recordsInputPath || options.recordsOutputPath) }); options.resolve = cleverMerge( getResolveDefaults({ cache, context: /** @type {Context} */ (options.context), targetProperties, mode: /** @type {Mode} */ (options.mode), css: /** @type {NonNullable} */ (options.experiments.css), typescript: /** @type {NonNullable} */ (options.experiments.typescript) }), options.resolve ); options.resolveLoader = cleverMerge( getResolveLoaderDefaults({ cache }), options.resolveLoader ); return { platform: targetProperties === false ? targetProperties : { web: targetProperties.web, browser: targetProperties.browser, webworker: targetProperties.webworker, node: targetProperties.node, nwjs: targetProperties.nwjs, electron: targetProperties.electron } }; }; /** * Apply experiments defaults. * @param {ExperimentsNormalized} experiments options * @param {object} options options * @param {boolean} options.production is production * @param {boolean} options.development is development mode * @param {TargetProperties | false} options.targetProperties target properties * @returns {void} */ const applyExperimentsDefaults = ( experiments, { production, development, targetProperties } ) => { D(experiments, "futureDefaults", false); D(experiments, "backCompat", !experiments.futureDefaults); // TODO do we need sync web assembly in webpack@6? D(experiments, "syncWebAssembly", false); D(experiments, "asyncWebAssembly", experiments.futureDefaults); D(experiments, "outputModule", false); D(experiments, "lazyCompilation", undefined); D(experiments, "buildHttp", undefined); D(experiments, "cacheUnaffected", experiments.futureDefaults); D(experiments, "deferImport", false); D(experiments, "sourceImport", false); F(experiments, "css", () => (experiments.futureDefaults ? true : undefined)); F(experiments, "html", () => (experiments.futureDefaults ? true : undefined)); F(experiments, "typescript", () => experiments.futureDefaults ? true : undefined ); if (typeof experiments.buildHttp === "object") { D(experiments.buildHttp, "frozen", production); D(experiments.buildHttp, "upgrade", false); } }; /** * Apply cache defaults. * @param {CacheOptionsNormalized} cache options * @param {object} options options * @param {string} options.name name * @param {Mode} options.mode mode * @param {boolean} options.futureDefaults is future defaults enabled * @param {boolean} options.development is development mode * @param {number=} options.compilerIndex index of compiler * @param {Experiments["cacheUnaffected"]} options.cacheUnaffected the cacheUnaffected experiment is enabled * @returns {void} */ const applyCacheDefaults = ( cache, { name, mode, development, cacheUnaffected, compilerIndex, futureDefaults } ) => { if (cache === false) return; switch (cache.type) { case "filesystem": F(cache, "name", () => compilerIndex !== undefined ? `${`${name}-${mode}`}__compiler${compilerIndex + 1}__` : `${name}-${mode}` ); D(cache, "version", ""); F(cache, "cacheDirectory", () => { const cwd = process.cwd(); /** @type {string | undefined} */ let dir = cwd; for (;;) { try { if (fs.statSync(path.join(dir, "package.json")).isFile()) break; // eslint-disable-next-line no-empty } catch (_err) {} const parent = path.dirname(dir); if (dir === parent) { dir = undefined; break; } dir = parent; } if (!dir) { return path.resolve(cwd, ".cache/webpack"); } else if (process.versions.pnp === "1") { return path.resolve(dir, ".pnp/.cache/webpack"); } else if (process.versions.pnp === "3") { return path.resolve(dir, ".yarn/.cache/webpack"); } return path.resolve(dir, "node_modules/.cache/webpack"); }); F(cache, "cacheLocation", () => path.resolve( /** @type {NonNullable} */ (cache.cacheDirectory), /** @type {NonNullable} */ (cache.name) ) ); D(cache, "hashAlgorithm", futureDefaults ? "xxhash64" : "md4"); D(cache, "store", "pack"); D(cache, "compression", false); D(cache, "profile", false); D(cache, "idleTimeout", 60000); D(cache, "idleTimeoutForInitialStore", 5000); D(cache, "idleTimeoutAfterLargeChanges", 1000); D(cache, "maxMemoryGenerations", development ? 5 : Infinity); D(cache, "maxAge", 1000 * 60 * 60 * 24 * 60); // 1 month D(cache, "allowCollectingMemory", development); D(cache, "memoryCacheUnaffected", development && cacheUnaffected); D(cache, "readonly", false); D( /** @type {NonNullable} */ (cache.buildDependencies), "defaultWebpack", [path.resolve(__dirname, "..") + path.sep] ); break; case "memory": D(cache, "maxGenerations", Infinity); D(cache, "cacheUnaffected", development && cacheUnaffected); break; } }; /** * Apply snapshot defaults. * @param {SnapshotOptions} snapshot options * @param {object} options options * @param {boolean} options.production is production * @param {boolean} options.futureDefaults is future defaults enabled * @returns {void} */ const applySnapshotDefaults = (snapshot, { production, futureDefaults }) => { if (futureDefaults) { F(snapshot, "managedPaths", () => process.versions.pnp === "3" ? [ /^(.+?(?:[\\/]\.yarn[\\/]unplugged[\\/][^\\/]+)?[\\/]node_modules[\\/])/ ] : [/^(.+?[\\/]node_modules[\\/])/] ); F(snapshot, "immutablePaths", () => process.versions.pnp === "3" ? [/^(.+?[\\/]cache[\\/][^\\/]+\.zip[\\/]node_modules[\\/])/] : [] ); } else { A(snapshot, "managedPaths", () => { if (process.versions.pnp === "3") { const match = /^(.+?)[\\/]cache[\\/]watchpack-npm-[^\\/]+\.zip[\\/]node_modules[\\/]/.exec( require.resolve("watchpack") ); if (match) { return [path.resolve(match[1], "unplugged")]; } } else { const match = /^(.+?[\\/]node_modules[\\/])/.exec( require.resolve("watchpack") ); if (match) { return [match[1]]; } } return []; }); A(snapshot, "immutablePaths", () => { if (process.versions.pnp === "1") { const match = /^(.+?[\\/]v4)[\\/]npm-watchpack-[^\\/]+-[\da-f]{40}[\\/]node_modules[\\/]/.exec( require.resolve("watchpack") ); if (match) { return [match[1]]; } } else if (process.versions.pnp === "3") { const match = /^(.+?)[\\/]watchpack-npm-[^\\/]+\.zip[\\/]node_modules[\\/]/.exec( require.resolve("watchpack") ); if (match) { return [match[1]]; } } return []; }); } F(snapshot, "unmanagedPaths", () => []); F(snapshot, "resolveBuildDependencies", () => ({ timestamp: true, hash: true })); F(snapshot, "buildDependencies", () => ({ timestamp: true, hash: true })); F(snapshot, "module", () => production ? { timestamp: true, hash: true } : { timestamp: true } ); F(snapshot, "contextModule", () => ({ timestamp: true })); F(snapshot, "resolve", () => production ? { timestamp: true, hash: true } : { timestamp: true } ); }; /** * Apply javascript parser options defaults. * @param {JavascriptParserOptions} parserOptions parser options * @param {object} options options * @param {boolean} options.futureDefaults is future defaults enabled * @param {boolean} options.deferImport is defer import enabled * @param {boolean} options.sourceImport is import source enabled * @param {boolean} options.isNode is node target platform * @param {boolean} options.outputModule is output.module enabled * @param {WebpackOptionsNormalized["output"]["library"]} options.library library options * @param {boolean} options.typescript is typescript enabled * @returns {void} */ const applyJavascriptParserOptionsDefaults = ( parserOptions, { futureDefaults, deferImport, sourceImport, isNode, outputModule, library, typescript } ) => { D(parserOptions, "unknownContextRequest", "."); D(parserOptions, "unknownContextRegExp", false); D(parserOptions, "unknownContextRecursive", true); D(parserOptions, "unknownContextCritical", true); D(parserOptions, "exprContextRequest", "."); D(parserOptions, "exprContextRegExp", false); D(parserOptions, "exprContextRecursive", true); D(parserOptions, "exprContextCritical", true); D(parserOptions, "wrappedContextRegExp", /.*/); D(parserOptions, "wrappedContextRecursive", true); D(parserOptions, "wrappedContextCritical", false); D(parserOptions, "strictThisContextOnImports", false); D(parserOptions, "importMeta", outputModule ? "preserve-unknown" : true); D(parserOptions, "dynamicImportMode", "lazy"); D(parserOptions, "dynamicImportPrefetch", false); D(parserOptions, "dynamicImportPreload", false); D(parserOptions, "dynamicImportFetchPriority", false); D(parserOptions, "createRequire", isNode); D(parserOptions, "dynamicUrl", true); D(parserOptions, "deferImport", deferImport); D(parserOptions, "sourceImport", sourceImport); D(parserOptions, "typescript", typescript); if (futureDefaults) D(parserOptions, "exportsPresence", "error"); D(parserOptions, "anonymousDefaultExportName", !library); }; /** * Apply json generator options defaults. * @param {JsonGeneratorOptions} generatorOptions generator options * @returns {void} */ const applyJsonGeneratorOptionsDefaults = (generatorOptions) => { D(generatorOptions, "JSONParse", true); }; /** * Apply css generator options defaults. * @param {CssGeneratorOptions} generatorOptions generator options * @param {object} options options * @param {TargetProperties | false} options.targetProperties target properties * @returns {void} */ const applyCssGeneratorOptionsDefaults = ( generatorOptions, { targetProperties } ) => { D( generatorOptions, "exportsOnly", !targetProperties || targetProperties.document === false ); D(generatorOptions, "esModule", true); }; /** * Apply module defaults. * @param {ModuleOptions} module options * @param {object} options options * @param {boolean} options.cache is caching enabled * @param {boolean} options.syncWebAssembly is syncWebAssembly enabled * @param {boolean} options.asyncWebAssembly is asyncWebAssembly enabled * @param {boolean} options.typescript is typescript enabled * @param {boolean} options.css is css enabled * @param {boolean} options.html is html enabled * @param {boolean} options.futureDefaults is future defaults enabled * @param {string} options.uniqueName the unique name * @param {boolean} options.isNode is node target platform * @param {boolean} options.deferImport is defer import enabled * @param {boolean} options.sourceImport is import source enabled * @param {TargetProperties | false} options.targetProperties target properties * @param {Mode | undefined} options.mode mode * @param {HashSalt} options.hashSalt hash salt * @param {HashFunction} options.hashFunction hash function * @param {boolean} options.outputModule is output.module enabled * @param {WebpackOptionsNormalized["output"]["library"]} options.library library options * @returns {void} */ const applyModuleDefaults = ( module, { hashSalt, hashFunction, cache, syncWebAssembly, asyncWebAssembly, css, html, typescript, futureDefaults, isNode, uniqueName, targetProperties, mode, deferImport, sourceImport, outputModule, library } ) => { if (cache) { D( module, "unsafeCache", /** * Handles the callback logic for this hook. * @param {Module} module module * @returns {boolean} true, if we want to cache the module */ (module) => { const name = module.nameForCondition(); if (!name) { return false; } return NODE_MODULES_REGEXP.test(name); } ); } else { D(module, "unsafeCache", false); } F(module.parser, ASSET_MODULE_TYPE, () => ({})); F( /** @type {NonNullable} */ (module.parser[ASSET_MODULE_TYPE]), "dataUrlCondition", () => ({}) ); if ( typeof ( /** @type {NonNullable} */ (module.parser[ASSET_MODULE_TYPE]).dataUrlCondition ) === "object" ) { D( /** @type {NonNullable} */ (module.parser[ASSET_MODULE_TYPE]).dataUrlCondition, "maxSize", 8096 ); } F(module.parser, "javascript", () => ({})); F(module.parser, JSON_MODULE_TYPE, () => ({})); D( /** @type {NonNullable} */ (module.parser[JSON_MODULE_TYPE]), "exportsDepth", mode === "development" ? 1 : Infinity ); applyJavascriptParserOptionsDefaults( /** @type {NonNullable} */ (module.parser.javascript), { futureDefaults, deferImport, sourceImport, isNode, outputModule, library, typescript } ); F(module.generator, "json", () => ({})); applyJsonGeneratorOptionsDefaults( /** @type {NonNullable} */ (module.generator.json) ); if (css) { F(module.parser, CSS_MODULE_TYPE, () => ({})); D( /** @type {NonNullable} */ (module.parser[CSS_MODULE_TYPE]), "import", true ); D( /** @type {NonNullable} */ (module.parser[CSS_MODULE_TYPE]), "url", true ); D( /** @type {NonNullable} */ (module.parser[CSS_MODULE_TYPE]), "namedExports", true ); for (const type of [ CSS_MODULE_TYPE_AUTO, CSS_MODULE_TYPE_MODULE, CSS_MODULE_TYPE_GLOBAL ]) { F(module.parser, type, () => ({})); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.parser[type]), "animation", true ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.parser[type]), "container", true ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.parser[type]), "customIdents", true ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.parser[type]), "dashedIdents", true ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.parser[type]), "function", true ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.parser[type]), "grid", true ); } F(module.generator, CSS_MODULE_TYPE, () => ({})); applyCssGeneratorOptionsDefaults( /** @type {NonNullable} */ (module.generator[CSS_MODULE_TYPE]), { targetProperties } ); const localIdentName = mode === "development" ? uniqueName.length > 0 ? "[uniqueName]-[id]-[local]" : "[id]-[local]" : "[fullhash]"; const localIdentHashSalt = hashSalt; const localIdentHashDigest = "base64url"; const localIdentHashDigestLength = 6; const exportsConvention = "as-is"; for (const type of [ CSS_MODULE_TYPE_AUTO, CSS_MODULE_TYPE_MODULE, CSS_MODULE_TYPE_GLOBAL ]) { F(module.generator, type, () => ({})); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.generator[type]), "localIdentName", localIdentName ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.generator[type]), "localIdentHashSalt", localIdentHashSalt ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.generator[type]), "localIdentHashFunction", hashFunction ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.generator[type]), "localIdentHashDigest", localIdentHashDigest ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.generator[type]), "localIdentHashDigestLength", localIdentHashDigestLength ); D( /** @type {NonNullable | NonNullable | NonNullable} */ (module.generator[type]), "exportsConvention", exportsConvention ); } } if (html) { // `module.generator.html.extract` is intentionally left undefined by // default: HtmlGenerator treats undefined as "extract iff this HTML // module is a compilation entry", which is the HTML-entry-point // behaviour. Setting `extract: true` forces extraction for all HTML // modules (including imported ones); `extract: false` disables it // everywhere. F(module.generator, HTML_MODULE_TYPE, () => ({})); } A(module, "defaultRules", () => { const esm = { type: JAVASCRIPT_MODULE_TYPE_ESM, resolve: { byDependency: { esm: { fullySpecified: true } } } }; const commonjs = { type: JAVASCRIPT_MODULE_TYPE_DYNAMIC }; /** @type {RuleSetRules} */ const rules = [ { mimetype: "application/node", type: JAVASCRIPT_MODULE_TYPE_AUTO }, { test: /\.json$/i, type: JSON_MODULE_TYPE }, { mimetype: "application/json", type: JSON_MODULE_TYPE }, { test: /\.mjs$/i, ...esm }, { test: /\.js$/i, descriptionData: { type: "module" }, ...esm }, { test: /\.cjs$/i, ...commonjs }, { test: /\.js$/i, descriptionData: { type: "commonjs" }, ...commonjs }, { mimetype: { or: ["text/javascript", "application/javascript"] }, ...esm } ]; if (asyncWebAssembly) { const wasm = { type: WEBASSEMBLY_MODULE_TYPE_ASYNC, rules: [ { descriptionData: { type: "module" }, resolve: { fullySpecified: true } } ] }; rules.push({ test: /\.wasm$/i, ...wasm }); rules.push({ mimetype: "application/wasm", ...wasm }); } else if (syncWebAssembly) { const wasm = { type: WEBASSEMBLY_MODULE_TYPE_SYNC, rules: [ { descriptionData: { type: "module" }, resolve: { fullySpecified: true } } ] }; rules.push({ test: /\.wasm$/i, ...wasm }); rules.push({ mimetype: "application/wasm", ...wasm }); } if (css) { const resolve = { fullySpecified: true, preferRelative: true }; rules.push({ test: /\.css$/i, type: CSS_MODULE_TYPE_AUTO, resolve }); rules.push({ mimetype: "text/css+module", type: CSS_MODULE_TYPE_MODULE, resolve }); rules.push({ mimetype: "text/css", type: CSS_MODULE_TYPE, resolve }); // For CSS modules, i.e. `.class { composes: className from "./style.css" }` // We inherit for such constructions, but skip files that are already // detected as CSS modules by extension (`.module.`) — they get // the same modules-mode behavior from the auto rule, and forcing a // different type stamp here would create a duplicate module instance. const moduleExtension = /\.module\.\w+$/i; rules.push({ dependency: /css-import-local-module/, exclude: moduleExtension, type: CSS_MODULE_TYPE_MODULE, resolve }); rules.push({ dependency: /css-import-global-module/, exclude: moduleExtension, type: CSS_MODULE_TYPE_GLOBAL, resolve }); rules.push( { with: { type: "css" }, parser: { exportType: "css-style-sheet" }, resolve }, { assert: { type: "css" }, parser: { exportType: "css-style-sheet" }, resolve } ); } if (html) { const resolve = { fullySpecified: true, preferRelative: true }; rules.push({ test: /\.html$/i, type: HTML_MODULE_TYPE, resolve }); rules.push({ mimetype: "text/html", type: HTML_MODULE_TYPE, resolve }); if (css) { // Inline `