index.js 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598
  1. /*
  2. MIT License http://www.opensource.org/licenses/mit-license.php
  3. Author Tobias Koppers @sokra
  4. */
  5. "use strict";
  6. const util = require("util");
  7. const memoize = require("./util/memoize");
  8. /** @typedef {import("../declarations/WebpackOptions").Entry} Entry */
  9. /** @typedef {import("../declarations/WebpackOptions").EntryNormalized} EntryNormalized */
  10. /** @typedef {import("../declarations/WebpackOptions").EntryObject} EntryObject */
  11. /** @typedef {import("../declarations/WebpackOptions").ExternalItemFunctionData} ExternalItemFunctionData */
  12. /** @typedef {import("../declarations/WebpackOptions").ExternalItemObjectKnown} ExternalItemObjectKnown */
  13. /** @typedef {import("../declarations/WebpackOptions").ExternalItemObjectUnknown} ExternalItemObjectUnknown */
  14. /** @typedef {import("../declarations/WebpackOptions").ExternalItemValue} ExternalItemValue */
  15. /** @typedef {import("../declarations/WebpackOptions").Externals} Externals */
  16. /** @typedef {import("../declarations/WebpackOptions").FileCacheOptions} FileCacheOptions */
  17. /** @typedef {import("../declarations/WebpackOptions").LibraryOptions} LibraryOptions */
  18. /** @typedef {import("../declarations/WebpackOptions").MemoryCacheOptions} MemoryCacheOptions */
  19. /** @typedef {import("../declarations/WebpackOptions").ModuleOptions} ModuleOptions */
  20. /** @typedef {import("../declarations/WebpackOptions").ResolveOptions} ResolveOptions */
  21. /** @typedef {import("../declarations/WebpackOptions").RuleSetCondition} RuleSetCondition */
  22. /** @typedef {import("../declarations/WebpackOptions").RuleSetConditionAbsolute} RuleSetConditionAbsolute */
  23. /** @typedef {import("../declarations/WebpackOptions").RuleSetRule} RuleSetRule */
  24. /** @typedef {import("../declarations/WebpackOptions").RuleSetUse} RuleSetUse */
  25. /** @typedef {import("../declarations/WebpackOptions").RuleSetUseItem} RuleSetUseItem */
  26. /** @typedef {import("../declarations/WebpackOptions").StatsOptions} StatsOptions */
  27. /** @typedef {import("../declarations/WebpackOptions").WebpackOptions} Configuration */
  28. /** @typedef {import("../declarations/WebpackOptions").WebpackOptionsNormalized} WebpackOptionsNormalized */
  29. /** @typedef {import("../declarations/WebpackOptions").WebpackPluginFunction} WebpackPluginFunction */
  30. /** @typedef {import("../declarations/WebpackOptions").WebpackPluginInstance} WebpackPluginInstance */
  31. /** @typedef {import("./ChunkGroup")} ChunkGroup */
  32. /** @typedef {import("./Compilation").Asset} Asset */
  33. /** @typedef {import("./Compilation").AssetInfo} AssetInfo */
  34. /** @typedef {import("./Compilation").EntryOptions} EntryOptions */
  35. /** @typedef {import("./Compilation").PathData} PathData */
  36. /** @typedef {import("./Compiler").AssetEmittedInfo} AssetEmittedInfo */
  37. /** @typedef {import("./MultiCompiler").MultiCompilerOptions} MultiCompilerOptions */
  38. /** @typedef {import("./MultiStats")} MultiStats */
  39. /** @typedef {import("./NormalModuleFactory").ResolveData} ResolveData */
  40. /** @typedef {import("./Parser").ParserState} ParserState */
  41. /** @typedef {import("./ResolverFactory").ResolvePluginInstance} ResolvePluginInstance */
  42. /** @typedef {import("./ResolverFactory").Resolver} Resolver */
  43. /** @typedef {import("./Watching")} Watching */
  44. /** @typedef {import("./cli").Argument} Argument */
  45. /** @typedef {import("./cli").Problem} Problem */
  46. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsAsset} StatsAsset */
  47. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsChunk} StatsChunk */
  48. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsChunkGroup} StatsChunkGroup */
  49. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsChunkOrigin} StatsChunkOrigin */
  50. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsCompilation} StatsCompilation */
  51. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsError} StatsError */
  52. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsLogging} StatsLogging */
  53. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsLoggingEntry} StatsLoggingEntry */
  54. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsModule} StatsModule */
  55. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsModuleIssuer} StatsModuleIssuer */
  56. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsModuleReason} StatsModuleReason */
  57. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsModuleTraceDependency} StatsModuleTraceDependency */
  58. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsModuleTraceItem} StatsModuleTraceItem */
  59. /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsProfile} StatsProfile */
  60. /**
  61. * @template {Function} T
  62. * @param {function(): T} factory factory function
  63. * @returns {T} function
  64. */
  65. const lazyFunction = factory => {
  66. const fac = memoize(factory);
  67. const f = /** @type {any} */ (
  68. (...args) => {
  69. return fac()(...args);
  70. }
  71. );
  72. return /** @type {T} */ (f);
  73. };
  74. /**
  75. * @template A
  76. * @template B
  77. * @param {A} obj input a
  78. * @param {B} exports input b
  79. * @returns {A & B} merged
  80. */
  81. const mergeExports = (obj, exports) => {
  82. const descriptors = Object.getOwnPropertyDescriptors(exports);
  83. for (const name of Object.keys(descriptors)) {
  84. const descriptor = descriptors[name];
  85. if (descriptor.get) {
  86. const fn = descriptor.get;
  87. Object.defineProperty(obj, name, {
  88. configurable: false,
  89. enumerable: true,
  90. get: memoize(fn)
  91. });
  92. } else if (typeof descriptor.value === "object") {
  93. Object.defineProperty(obj, name, {
  94. configurable: false,
  95. enumerable: true,
  96. writable: false,
  97. value: mergeExports({}, descriptor.value)
  98. });
  99. } else {
  100. throw new Error(
  101. "Exposed values must be either a getter or an nested object"
  102. );
  103. }
  104. }
  105. return /** @type {A & B} */ (Object.freeze(obj));
  106. };
  107. const fn = lazyFunction(() => require("./webpack"));
  108. module.exports = mergeExports(fn, {
  109. get webpack() {
  110. return require("./webpack");
  111. },
  112. get validate() {
  113. const webpackOptionsSchemaCheck = require("../schemas/WebpackOptions.check.js");
  114. const getRealValidate = memoize(() => {
  115. const validateSchema = require("./validateSchema");
  116. const webpackOptionsSchema = require("../schemas/WebpackOptions.json");
  117. return options => validateSchema(webpackOptionsSchema, options);
  118. });
  119. return options => {
  120. if (!webpackOptionsSchemaCheck(options)) getRealValidate()(options);
  121. };
  122. },
  123. get validateSchema() {
  124. const validateSchema = require("./validateSchema");
  125. return validateSchema;
  126. },
  127. get version() {
  128. return /** @type {string} */ (require("../package.json").version);
  129. },
  130. get cli() {
  131. return require("./cli");
  132. },
  133. get AutomaticPrefetchPlugin() {
  134. return require("./AutomaticPrefetchPlugin");
  135. },
  136. get AsyncDependenciesBlock() {
  137. return require("./AsyncDependenciesBlock");
  138. },
  139. get BannerPlugin() {
  140. return require("./BannerPlugin");
  141. },
  142. get Cache() {
  143. return require("./Cache");
  144. },
  145. get Chunk() {
  146. return require("./Chunk");
  147. },
  148. get ChunkGraph() {
  149. return require("./ChunkGraph");
  150. },
  151. get CleanPlugin() {
  152. return require("./CleanPlugin");
  153. },
  154. get Compilation() {
  155. return require("./Compilation");
  156. },
  157. get Compiler() {
  158. return require("./Compiler");
  159. },
  160. get ConcatenationScope() {
  161. return require("./ConcatenationScope");
  162. },
  163. get ContextExclusionPlugin() {
  164. return require("./ContextExclusionPlugin");
  165. },
  166. get ContextReplacementPlugin() {
  167. return require("./ContextReplacementPlugin");
  168. },
  169. get DefinePlugin() {
  170. return require("./DefinePlugin");
  171. },
  172. get DelegatedPlugin() {
  173. return require("./DelegatedPlugin");
  174. },
  175. get Dependency() {
  176. return require("./Dependency");
  177. },
  178. get DllPlugin() {
  179. return require("./DllPlugin");
  180. },
  181. get DllReferencePlugin() {
  182. return require("./DllReferencePlugin");
  183. },
  184. get DynamicEntryPlugin() {
  185. return require("./DynamicEntryPlugin");
  186. },
  187. get EntryOptionPlugin() {
  188. return require("./EntryOptionPlugin");
  189. },
  190. get EntryPlugin() {
  191. return require("./EntryPlugin");
  192. },
  193. get EnvironmentPlugin() {
  194. return require("./EnvironmentPlugin");
  195. },
  196. get EvalDevToolModulePlugin() {
  197. return require("./EvalDevToolModulePlugin");
  198. },
  199. get EvalSourceMapDevToolPlugin() {
  200. return require("./EvalSourceMapDevToolPlugin");
  201. },
  202. get ExternalModule() {
  203. return require("./ExternalModule");
  204. },
  205. get ExternalsPlugin() {
  206. return require("./ExternalsPlugin");
  207. },
  208. get Generator() {
  209. return require("./Generator");
  210. },
  211. get HotUpdateChunk() {
  212. return require("./HotUpdateChunk");
  213. },
  214. get HotModuleReplacementPlugin() {
  215. return require("./HotModuleReplacementPlugin");
  216. },
  217. get IgnorePlugin() {
  218. return require("./IgnorePlugin");
  219. },
  220. get JavascriptModulesPlugin() {
  221. return util.deprecate(
  222. () => require("./javascript/JavascriptModulesPlugin"),
  223. "webpack.JavascriptModulesPlugin has moved to webpack.javascript.JavascriptModulesPlugin",
  224. "DEP_WEBPACK_JAVASCRIPT_MODULES_PLUGIN"
  225. )();
  226. },
  227. get LibManifestPlugin() {
  228. return require("./LibManifestPlugin");
  229. },
  230. get LibraryTemplatePlugin() {
  231. return util.deprecate(
  232. () => require("./LibraryTemplatePlugin"),
  233. "webpack.LibraryTemplatePlugin is deprecated and has been replaced by compilation.outputOptions.library or compilation.addEntry + passing a library option",
  234. "DEP_WEBPACK_LIBRARY_TEMPLATE_PLUGIN"
  235. )();
  236. },
  237. get LoaderOptionsPlugin() {
  238. return require("./LoaderOptionsPlugin");
  239. },
  240. get LoaderTargetPlugin() {
  241. return require("./LoaderTargetPlugin");
  242. },
  243. get Module() {
  244. return require("./Module");
  245. },
  246. get ModuleFilenameHelpers() {
  247. return require("./ModuleFilenameHelpers");
  248. },
  249. get ModuleGraph() {
  250. return require("./ModuleGraph");
  251. },
  252. get ModuleGraphConnection() {
  253. return require("./ModuleGraphConnection");
  254. },
  255. get NoEmitOnErrorsPlugin() {
  256. return require("./NoEmitOnErrorsPlugin");
  257. },
  258. get NormalModule() {
  259. return require("./NormalModule");
  260. },
  261. get NormalModuleReplacementPlugin() {
  262. return require("./NormalModuleReplacementPlugin");
  263. },
  264. get MultiCompiler() {
  265. return require("./MultiCompiler");
  266. },
  267. get OptimizationStages() {
  268. return require("./OptimizationStages");
  269. },
  270. get Parser() {
  271. return require("./Parser");
  272. },
  273. get PrefetchPlugin() {
  274. return require("./PrefetchPlugin");
  275. },
  276. get ProgressPlugin() {
  277. return require("./ProgressPlugin");
  278. },
  279. get ProvidePlugin() {
  280. return require("./ProvidePlugin");
  281. },
  282. get RuntimeGlobals() {
  283. return require("./RuntimeGlobals");
  284. },
  285. get RuntimeModule() {
  286. return require("./RuntimeModule");
  287. },
  288. get SingleEntryPlugin() {
  289. return util.deprecate(
  290. () => require("./EntryPlugin"),
  291. "SingleEntryPlugin was renamed to EntryPlugin",
  292. "DEP_WEBPACK_SINGLE_ENTRY_PLUGIN"
  293. )();
  294. },
  295. get SourceMapDevToolPlugin() {
  296. return require("./SourceMapDevToolPlugin");
  297. },
  298. get Stats() {
  299. return require("./Stats");
  300. },
  301. get Template() {
  302. return require("./Template");
  303. },
  304. get UsageState() {
  305. return require("./ExportsInfo").UsageState;
  306. },
  307. get WatchIgnorePlugin() {
  308. return require("./WatchIgnorePlugin");
  309. },
  310. get WebpackError() {
  311. return require("./WebpackError");
  312. },
  313. get WebpackOptionsApply() {
  314. return require("./WebpackOptionsApply");
  315. },
  316. get WebpackOptionsDefaulter() {
  317. return util.deprecate(
  318. () => require("./WebpackOptionsDefaulter"),
  319. "webpack.WebpackOptionsDefaulter is deprecated and has been replaced by webpack.config.getNormalizedWebpackOptions and webpack.config.applyWebpackOptionsDefaults",
  320. "DEP_WEBPACK_OPTIONS_DEFAULTER"
  321. )();
  322. },
  323. // TODO webpack 6 deprecate
  324. get WebpackOptionsValidationError() {
  325. return require("schema-utils").ValidationError;
  326. },
  327. get ValidationError() {
  328. return require("schema-utils").ValidationError;
  329. },
  330. cache: {
  331. get MemoryCachePlugin() {
  332. return require("./cache/MemoryCachePlugin");
  333. }
  334. },
  335. config: {
  336. get getNormalizedWebpackOptions() {
  337. return require("./config/normalization").getNormalizedWebpackOptions;
  338. },
  339. get applyWebpackOptionsDefaults() {
  340. return require("./config/defaults").applyWebpackOptionsDefaults;
  341. }
  342. },
  343. dependencies: {
  344. get ModuleDependency() {
  345. return require("./dependencies/ModuleDependency");
  346. },
  347. get HarmonyImportDependency() {
  348. return require("./dependencies/HarmonyImportDependency");
  349. },
  350. get ConstDependency() {
  351. return require("./dependencies/ConstDependency");
  352. },
  353. get NullDependency() {
  354. return require("./dependencies/NullDependency");
  355. }
  356. },
  357. ids: {
  358. get ChunkModuleIdRangePlugin() {
  359. return require("./ids/ChunkModuleIdRangePlugin");
  360. },
  361. get NaturalModuleIdsPlugin() {
  362. return require("./ids/NaturalModuleIdsPlugin");
  363. },
  364. get OccurrenceModuleIdsPlugin() {
  365. return require("./ids/OccurrenceModuleIdsPlugin");
  366. },
  367. get NamedModuleIdsPlugin() {
  368. return require("./ids/NamedModuleIdsPlugin");
  369. },
  370. get DeterministicChunkIdsPlugin() {
  371. return require("./ids/DeterministicChunkIdsPlugin");
  372. },
  373. get DeterministicModuleIdsPlugin() {
  374. return require("./ids/DeterministicModuleIdsPlugin");
  375. },
  376. get NamedChunkIdsPlugin() {
  377. return require("./ids/NamedChunkIdsPlugin");
  378. },
  379. get OccurrenceChunkIdsPlugin() {
  380. return require("./ids/OccurrenceChunkIdsPlugin");
  381. },
  382. get HashedModuleIdsPlugin() {
  383. return require("./ids/HashedModuleIdsPlugin");
  384. }
  385. },
  386. javascript: {
  387. get EnableChunkLoadingPlugin() {
  388. return require("./javascript/EnableChunkLoadingPlugin");
  389. },
  390. get JavascriptModulesPlugin() {
  391. return require("./javascript/JavascriptModulesPlugin");
  392. },
  393. get JavascriptParser() {
  394. return require("./javascript/JavascriptParser");
  395. }
  396. },
  397. optimize: {
  398. get AggressiveMergingPlugin() {
  399. return require("./optimize/AggressiveMergingPlugin");
  400. },
  401. get AggressiveSplittingPlugin() {
  402. return util.deprecate(
  403. () => require("./optimize/AggressiveSplittingPlugin"),
  404. "AggressiveSplittingPlugin is deprecated in favor of SplitChunksPlugin",
  405. "DEP_WEBPACK_AGGRESSIVE_SPLITTING_PLUGIN"
  406. )();
  407. },
  408. get InnerGraph() {
  409. return require("./optimize/InnerGraph");
  410. },
  411. get LimitChunkCountPlugin() {
  412. return require("./optimize/LimitChunkCountPlugin");
  413. },
  414. get MinChunkSizePlugin() {
  415. return require("./optimize/MinChunkSizePlugin");
  416. },
  417. get ModuleConcatenationPlugin() {
  418. return require("./optimize/ModuleConcatenationPlugin");
  419. },
  420. get RealContentHashPlugin() {
  421. return require("./optimize/RealContentHashPlugin");
  422. },
  423. get RuntimeChunkPlugin() {
  424. return require("./optimize/RuntimeChunkPlugin");
  425. },
  426. get SideEffectsFlagPlugin() {
  427. return require("./optimize/SideEffectsFlagPlugin");
  428. },
  429. get SplitChunksPlugin() {
  430. return require("./optimize/SplitChunksPlugin");
  431. }
  432. },
  433. runtime: {
  434. get GetChunkFilenameRuntimeModule() {
  435. return require("./runtime/GetChunkFilenameRuntimeModule");
  436. },
  437. get LoadScriptRuntimeModule() {
  438. return require("./runtime/LoadScriptRuntimeModule");
  439. }
  440. },
  441. prefetch: {
  442. get ChunkPrefetchPreloadPlugin() {
  443. return require("./prefetch/ChunkPrefetchPreloadPlugin");
  444. }
  445. },
  446. web: {
  447. get FetchCompileAsyncWasmPlugin() {
  448. return require("./web/FetchCompileAsyncWasmPlugin");
  449. },
  450. get FetchCompileWasmPlugin() {
  451. return require("./web/FetchCompileWasmPlugin");
  452. },
  453. get JsonpChunkLoadingRuntimeModule() {
  454. return require("./web/JsonpChunkLoadingRuntimeModule");
  455. },
  456. get JsonpTemplatePlugin() {
  457. return require("./web/JsonpTemplatePlugin");
  458. }
  459. },
  460. webworker: {
  461. get WebWorkerTemplatePlugin() {
  462. return require("./webworker/WebWorkerTemplatePlugin");
  463. }
  464. },
  465. node: {
  466. get NodeEnvironmentPlugin() {
  467. return require("./node/NodeEnvironmentPlugin");
  468. },
  469. get NodeSourcePlugin() {
  470. return require("./node/NodeSourcePlugin");
  471. },
  472. get NodeTargetPlugin() {
  473. return require("./node/NodeTargetPlugin");
  474. },
  475. get NodeTemplatePlugin() {
  476. return require("./node/NodeTemplatePlugin");
  477. },
  478. get ReadFileCompileWasmPlugin() {
  479. return require("./node/ReadFileCompileWasmPlugin");
  480. }
  481. },
  482. electron: {
  483. get ElectronTargetPlugin() {
  484. return require("./electron/ElectronTargetPlugin");
  485. }
  486. },
  487. wasm: {
  488. get AsyncWebAssemblyModulesPlugin() {
  489. return require("./wasm-async/AsyncWebAssemblyModulesPlugin");
  490. },
  491. get EnableWasmLoadingPlugin() {
  492. return require("./wasm/EnableWasmLoadingPlugin");
  493. }
  494. },
  495. library: {
  496. get AbstractLibraryPlugin() {
  497. return require("./library/AbstractLibraryPlugin");
  498. },
  499. get EnableLibraryPlugin() {
  500. return require("./library/EnableLibraryPlugin");
  501. }
  502. },
  503. container: {
  504. get ContainerPlugin() {
  505. return require("./container/ContainerPlugin");
  506. },
  507. get ContainerReferencePlugin() {
  508. return require("./container/ContainerReferencePlugin");
  509. },
  510. get ModuleFederationPlugin() {
  511. return require("./container/ModuleFederationPlugin");
  512. },
  513. get scope() {
  514. return require("./container/options").scope;
  515. }
  516. },
  517. sharing: {
  518. get ConsumeSharedPlugin() {
  519. return require("./sharing/ConsumeSharedPlugin");
  520. },
  521. get ProvideSharedPlugin() {
  522. return require("./sharing/ProvideSharedPlugin");
  523. },
  524. get SharePlugin() {
  525. return require("./sharing/SharePlugin");
  526. },
  527. get scope() {
  528. return require("./container/options").scope;
  529. }
  530. },
  531. debug: {
  532. get ProfilingPlugin() {
  533. return require("./debug/ProfilingPlugin");
  534. }
  535. },
  536. util: {
  537. get createHash() {
  538. return require("./util/createHash");
  539. },
  540. get comparators() {
  541. return require("./util/comparators");
  542. },
  543. get runtime() {
  544. return require("./util/runtime");
  545. },
  546. get serialization() {
  547. return require("./util/serialization");
  548. },
  549. get cleverMerge() {
  550. return require("./util/cleverMerge").cachedCleverMerge;
  551. },
  552. get LazySet() {
  553. return require("./util/LazySet");
  554. }
  555. },
  556. get sources() {
  557. return require("webpack-sources");
  558. },
  559. experiments: {
  560. schemes: {
  561. get HttpUriPlugin() {
  562. return require("./schemes/HttpUriPlugin");
  563. }
  564. },
  565. ids: {
  566. get SyncModuleIdsPlugin() {
  567. return require("./ids/SyncModuleIdsPlugin");
  568. }
  569. }
  570. }
  571. });