fix(html): allow OutputHtmlOptions object for per-entry html schema by aryanraj45 · Pull Request #21447 · webpack/webpack

aryanraj45 · 2026-07-17T18:35:13Z

Summary

This fixes a schema validation and TypeScript mismatch for the HTML entry feature.

Context: The per-entry html option inside EntryDescription and EntryDescriptionNormalized was restricted strictly to type: "boolean" in the schema (schemas/WebpackOptions.json). However, the implementation inside HtmlModulesPlugin already smoothly accepts an object to override specific HTML options at the entry level (e.g., pulling desc.html.favicon and desc.html.inject).

Because of this mismatch, whenever a developer tried to use the object syntax (e.g., html: { favicon: false }), webpack would throw a schema validation error, and TypeScript definitions would flag it as an invalid type.

The Fix: We widened the schema definition for entry html to boolean | OutputHtmlOptions (using $ref: "#/definitions/OutputHtmlOptions"). This aligns the JSON schema definition with the existing capability output.html uses globally, ensuring developers can safely configure per-entry overrides.

Updated schemas/WebpackOptions.json to include the $ref to OutputHtmlOptions.
Regenerated declarations/WebpackOptions.d.ts, schemas/WebpackOptions.check.js, and types.d.ts using yarn fix:special.
Added a full test suite verifying html: { favicon: false }, html: { inject: "head" }, custom favicon paths, and global output.html fallbacks.

What kind of change does this PR introduce?

fix

Did you add tests for your changes?

Yes. Added test/configCases/html/output-html-per-entry-object/ covering the execution and validation of per-entry object overrides.

Does this PR introduce a breaking change?

No. This is purely an additive type widening; boolean values continue to function exactly as before.

If relevant, what needs to be documented once your changes are merged or what have you already documented?

n/a

Use of AI

YES

Note

Low Risk
Schema and type widening only; no runtime logic changes, and boolean entry HTML options stay backward compatible.

Overview
Aligns per-entry html configuration with what output.html already supports and what the HTML plugin already reads at runtime.

Entry html on EntryDescription / EntryDescriptionNormalized is widened from boolean only to boolean | OutputHtmlOptions, so configs like html: { favicon: false } or html: { inject: "head" } pass schema validation and match TypeScript. Generated artifacts (declarations/WebpackOptions.d.ts, schema check) were refreshed via yarn fix:special; the .d.ts diff also reorders HtmlFaviconIcon / OutputHtmlOptions declarations with no semantic change.

Behavior: additive—html: true / false unchanged; object form was previously rejected at validate time despite working in implementation.

^{Reviewed by Cursor Bugbot for commit de0f97d. Bugbot is set up for automated code reviews on this repo. Configure here.}

changeset-bot · 2026-07-17T18:35:17Z

⚠️ No Changeset found

Latest commit: de0f97d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

alexander-akait · 2026-07-31T10:18:18Z

Let’s rebase and we can merge

aryanraj45 · 2026-07-31T10:36:12Z

@alexander-akait done thanks

cursor

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit de0f97d. Configure here.}

codecov · 2026-07-31T13:02:45Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.86%. Comparing base (a298ad8) to head (de0f97d).

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #21447   +/-   ##
=======================================
  Coverage   93.85%   93.86%           
=======================================
  Files         622      622           
  Lines       75561    75561           
  Branches    21989    21989           
=======================================
+ Hits        70920    70922    +2     
+ Misses       4641     4639    -2

Flag	Coverage Δ
css-parsing	`25.03% <ø> (ø)`
html5lib	`26.45% <ø> (ø)`
integration	`89.35% <ø> (+<0.01%)`	⬆️
test262	`43.50% <ø> (ø)`
unit	`48.14% <ø> (ø)`

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

codspeed · 2026-07-31T13:49:44Z

Merging this PR will improve performance by 21.85%

⚠️

Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 1 improved benchmark
✅ 219 untouched benchmarks

Performance Changes

	Mode	Benchmark	`BASE`	`HEAD`	Efficiency
⚡	Memory	`benchmark "future-defaults", scenario '{"name":"mode-production","mode":"production"}'`	11.3 MB	9.3 MB	+21.85%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

_{Comparing aryanraj45:fix/html-entry-schema-object (de0f97d) with main (a298ad8)}

github-actions · 2026-07-31T14:35:31Z

This PR is packaged and the instant preview is available (821b1c5).

Install it locally:

npm

npm i -D webpack@https://pkg.pr.new/webpack@821b1c5

yarn

yarn add -D webpack@https://pkg.pr.new/webpack@821b1c5

pnpm

pnpm add -D webpack@https://pkg.pr.new/webpack@821b1c5

Copilot AI review requested due to automatic review settings July 17, 2026 18:35

Copilot AI reviewed Jul 17, 2026

aryanraj45 force-pushed the fix/html-entry-schema-object branch from 7bf3686 to 81a02c4 Compare July 21, 2026 08:51

Copilot AI review requested due to automatic review settings July 21, 2026 08:51

Copilot AI reviewed Jul 21, 2026

fix(html): allow OutputHtmlOptions object for per-entry html schema

de0f97d

aryanraj45 force-pushed the fix/html-entry-schema-object branch from 81a02c4 to de0f97d Compare July 31, 2026 10:35

cursor Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread declarations/WebpackOptions.d.ts

alexander-akait merged commit 821b1c5 into webpack:main Jul 31, 2026
61 of 62 checks passed

alexander-akait mentioned this pull request Jul 31, 2026

fix(html): apply an entry's html options over output.html #21574

Merged

Navigation Menu

Uh oh!

fix(html): allow OutputHtmlOptions object for per-entry html schema - #21447

fix(html): allow OutputHtmlOptions object for per-entry html schema#21447
alexander-akait merged 1 commit into
webpack:mainfrom
aryanraj45:fix/html-entry-schema-object

aryanraj45 commented Jul 17, 2026 •

edited by cursor Bot

Loading

Uh oh!

changeset-bot Bot commented Jul 17, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

alexander-akait commented Jul 31, 2026

Uh oh!

aryanraj45 commented Jul 31, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

codecov Bot commented Jul 31, 2026 •

edited

Loading

Uh oh!

codspeed Bot commented Jul 31, 2026

Uh oh!

Uh oh!

github-actions Bot commented Jul 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

aryanraj45 commented Jul 17, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented Jul 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

alexander-akait commented Jul 31, 2026

Uh oh!

aryanraj45 commented Jul 31, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

codecov Bot commented Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

codspeed Bot commented Jul 31, 2026

Merging this PR will improve performance by 21.85%

Performance Changes

Uh oh!

Uh oh!

github-actions Bot commented Jul 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

aryanraj45 commented Jul 17, 2026 •

edited by cursor Bot

Loading

changeset-bot Bot commented Jul 17, 2026 •

edited

Loading

codecov Bot commented Jul 31, 2026 •

edited

Loading