"webpack": patch

Resolve chunk-hash placeholders in chunk URLs embedded into extracted HTML.

Comments inside `lib/`, `hot/`, `tooling/`, and `test/` must be **as short as possible** — ideally one line, at most two short lines. Every line must add information a careful reader can't get from the code itself: a hidden invariant, a non-obvious ordering constraint, a workaround pinned to a specific upstream bug, the name of the higher-level concept the block implements. **Never** write multi-paragraph essays, restate what the next line obviously does, narrate the diff ("previously …, now …"), restate the PR description, or quote the user/task framing. If a reader would already understand the line without the comment, delete the comment.

JSDoc on exported symbols stays as-is — that's the type contract, not commentary. The rule applies to free-standing `//` and `/* … */` comments, including the lead-in block above a function body.

Reviewers have repeatedly flagged paragraph-long comments as a blocker; this rule applies on every commit, not just the first one.

**Keep the description as short as possible** — ideally a single sentence, ≤ 80 characters, written in the imperative, with the **first character capitalized** and a **trailing period** ("Fix split-chunks cache key collision.", "Add `module.generator.html.extract` option."). Changesets are concatenated into the release `CHANGELOG.md` verbatim — sentence-case and the period are what makes them read as proper changelog entries rather than commit-message fragments. Multi-paragraph rationale, "why" context, migration notes, repro steps, or links to discussions belong in the PR body, not the changeset. If a sentence needs commas to fit, it is already too long — split the work or shorten the wording.

const HtmlGenerator = require("../html/HtmlGenerator");

// Defer chunk-URL substitution to renderManifest — chunk hashes aren't ready yet.

url = HtmlGenerator.makeChunkUrlSentinel(chunk, "javascript");

/**

updateHash(hash, context) {

// Recurse so the inline CSS's transitive deps (e.g. `url(asset)`) propagate up.

const { chunkGraph } = context;

const module = chunkGraph.moduleGraph.getModule(this);

if (!module) return;

module.updateHash(hash, context);

}

const HtmlGenerator = require("../html/HtmlGenerator");

// Rewrite src/href to a chunk-URL sentinel (resolved by renderManifest):

// `.css` for `<link rel="stylesheet">`, `.js` for everything else.

const entryUrl = HtmlGenerator.makeChunkUrlSentinel(

);

const url = HtmlGenerator.makeChunkUrlSentinel(chunk, kind);

/**

updateHash(hash, context) {

// Fold in the asset's hash so the HTML invalidates when the embedded URL changes.

const { chunkGraph } = context;

const module = chunkGraph.moduleGraph.getModule(this);

if (!module) return;

const { hash: buildHash } = /** @type {BuildInfo} */ (module.buildInfo);

if (buildHash) hash.update(buildHash);

}

const chunksByIdCache = new WeakMap();

/**

static makeChunkUrlSentinel(chunk, contentHashType) {

const hexId = Buffer.from(String(chunk.id), "utf8").toString("hex");

return `__WEBPACK_HTML_CHUNK_URL__${hexId}__${contentHashType}__END__`;

}

/**

static resolveChunkUrlSentinels(content, compilation) {

if (!content.includes("__WEBPACK_HTML_CHUNK_URL__")) return content;

const outputOptions = compilation.outputOptions;

let chunksById = chunksByIdCache.get(compilation);

if (chunksById === undefined) {

chunksById = new Map();

for (const chunk of compilation.chunks) {

chunksById.set(String(chunk.id), chunk);

}

chunksByIdCache.set(compilation, chunksById);

}

return content.replace(

/__WEBPACK_HTML_CHUNK_URL__([0-9a-f]+)__([a-z]+)__END__/g,

(_, hexId, contentHashType) => {

const chunkId = Buffer.from(hexId, "hex").toString("utf8");

const chunk = chunksById.get(chunkId);

if (!chunk) return "data:,";

let filenameTemplate;

if (contentHashType === "css") {

const CssModulesPlugin = require("../css/CssModulesPlugin");

filenameTemplate = CssModulesPlugin.getChunkFilenameTemplate(

chunk,

outputOptions

);

} else {

filenameTemplate =

chunk.filenameTemplate ||

(chunk.canBeInitial()

? outputOptions.filename

: outputOptions.chunkFilename);

}

const filename = compilation.getPath(

/** @type {import("../TemplatedPathPlugin").TemplatePath} */

(filenameTemplate),

{

chunk,

contentHashType

}

);

return `${CssUrlDependency.PUBLIC_PATH_AUTO}${filename}`;

}

);

}

// HTML output — leave sentinels and `[webpack/auto]` for renderManifest.

// JS-export path — resolve `[webpack/auto]` inline; chunk-URL sentinels

// stay for `HtmlModulesPlugin`'s `JavascriptModulesPlugin.render` tap.

let content = /** @type {string} */ (source.source());

content = content.split(CssUrlDependency.PUBLIC_PATH_AUTO).join(undoPath);

return content;

// Preserve `[webpack/auto]`; renderManifest resolves it once `.html` filename is known.

// JS export: resolve `[webpack/auto]` to root-relative URLs.

// Strip `<`, `>`, `--` runs from `error.message` so it can't escape the comment.

// Hash effective extraction state — source-type set changes when this flips.