/* MIT License http://www.opensource.org/licenses/mit-license.php Author Tobias Koppers @sokra and Zackary Jackson @ScriptedAlchemy */ "use strict"; const AsyncDependenciesBlock = require("../AsyncDependenciesBlock"); const Module = require("../Module"); const { SHARED_INIT_TYPES } = require("../ModuleSourceTypesConstants"); const { WEBPACK_MODULE_TYPE_PROVIDE } = require("../ModuleTypeConstants"); const RuntimeGlobals = require("../RuntimeGlobals"); const makeSerializable = require("../util/makeSerializable"); const ProvideForSharedDependency = require("./ProvideForSharedDependency"); /** @typedef {import("../../declarations/WebpackOptions").WebpackOptionsNormalized} WebpackOptions */ /** @typedef {import("../Chunk")} Chunk */ /** @typedef {import("../ChunkGraph")} ChunkGraph */ /** @typedef {import("../ChunkGroup")} ChunkGroup */ /** @typedef {import("../Compilation")} Compilation */ /** @typedef {import("../Module").CodeGenerationContext} CodeGenerationContext */ /** @typedef {import("../Module").CodeGenerationResult} CodeGenerationResult */ /** @typedef {import("../Module").LibIdentOptions} LibIdentOptions */ /** @typedef {import("../Module").NeedBuildContext} NeedBuildContext */ /** @typedef {import("../Module").SourceTypes} SourceTypes */ /** @typedef {import("../RequestShortener")} RequestShortener */ /** @typedef {import("../ResolverFactory").ResolverWithOptions} ResolverWithOptions */ /** @typedef {import("../WebpackError")} WebpackError */ /** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */ /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */ /** @typedef {import("../util/Hash")} Hash */ /** @typedef {import("../util/fs").InputFileSystem} InputFileSystem */ class ProvideSharedModule extends Module { /** * @param {string} shareScope shared scope name * @param {string} name shared key * @param {string | false} version version * @param {string} request request to the provided module * @param {boolean} eager include the module in sync way */ constructor(shareScope, name, version, request, eager) { super(WEBPACK_MODULE_TYPE_PROVIDE); this._shareScope = shareScope; this._name = name; this._version = version; this._request = request; this._eager = eager; } /** * @returns {string} a unique identifier of the module */ identifier() { return `provide module (${this._shareScope}) ${this._name}@${this._version} = ${this._request}`; } /** * @param {RequestShortener} requestShortener the request shortener * @returns {string} a user readable identifier of the module */ readableIdentifier(requestShortener) { return `provide shared module (${this._shareScope}) ${this._name}@${ this._version } = ${requestShortener.shorten(this._request)}`; } /** * @param {LibIdentOptions} options options * @returns {string | null} an identifier for library inclusion */ libIdent(options) { return `${this.layer ? `(${this.layer})/` : ""}webpack/sharing/provide/${ this._shareScope }/${this._name}`; } /** * @param {NeedBuildContext} context context info * @param {function((WebpackError | null)=, boolean=): void} callback callback function, returns true, if the module needs a rebuild * @returns {void} */ needBuild(context, callback) { callback(null, !this.buildInfo); } /** * @param {WebpackOptions} options webpack options * @param {Compilation} compilation the compilation * @param {ResolverWithOptions} resolver the resolver * @param {InputFileSystem} fs the file system * @param {function(WebpackError=): void} callback callback function * @returns {void} */ build(options, compilation, resolver, fs, callback) { this.buildMeta = {}; this.buildInfo = { strict: true }; this.clearDependenciesAndBlocks(); const dep = new ProvideForSharedDependency(this._request); if (this._eager) { this.addDependency(dep); } else { const block = new AsyncDependenciesBlock({}); block.addDependency(dep); this.addBlock(block); } callback(); } /** * @param {string=} type the source type for which the size should be estimated * @returns {number} the estimated size of the module (must be non-zero) */ size(type) { return 42; } /** * @returns {SourceTypes} types available (do not mutate) */ getSourceTypes() { return SHARED_INIT_TYPES; } /** * @param {CodeGenerationContext} context context for code generation * @returns {CodeGenerationResult} result */ codeGeneration({ runtimeTemplate, moduleGraph, chunkGraph }) { const runtimeRequirements = new Set([RuntimeGlobals.initializeSharing]); const code = `register(${JSON.stringify(this._name)}, ${JSON.stringify( this._version || "0" )}, ${ this._eager ? runtimeTemplate.syncModuleFactory({ dependency: this.dependencies[0], chunkGraph, request: this._request, runtimeRequirements }) : runtimeTemplate.asyncModuleFactory({ block: this.blocks[0], chunkGraph, request: this._request, runtimeRequirements }) }${this._eager ? ", 1" : ""});`; const sources = new Map(); const data = new Map(); data.set("share-init", [ { shareScope: this._shareScope, initStage: 10, init: code } ]); return { sources, data, runtimeRequirements }; } /** * @param {ObjectSerializerContext} context context */ serialize(context) { const { write } = context; write(this._shareScope); write(this._name); write(this._version); write(this._request); write(this._eager); super.serialize(context); } /** * @param {ObjectDeserializerContext} context context * @returns {ProvideSharedModule} deserialize fallback dependency */ static deserialize(context) { const { read } = context; const obj = new ProvideSharedModule(read(), read(), read(), read(), read()); obj.deserialize(context); return obj; } } makeSerializable( ProvideSharedModule, "webpack/lib/sharing/ProvideSharedModule" ); module.exports = ProvideSharedModule;