feat: annotate schema options with added keywords by bjohansebas · Pull Request #21473 · webpack/webpack

bjohansebas · Jul 22, 2026

Summary

What kind of change does this PR introduce?

Did you add tests for your changes?

Does this PR introduce a breaking change?

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

Use of AI

Note

Low Risk
Documentation and generated types only; no runtime behavior or config validation changes beyond stripping doc-only schema keywords.

Overview
Adds version metadata to webpack’s public TypeScript surface so IDEs and docs can show when options and hooks were introduced.

Schema entries gain an "added": "<version>" keyword (and existing experimental is documented in AGENTS.md); tooling v1.27.0 turns those into @since (and @experimental) on generated WebpackOptions declarations. Many newer options (resource hints, HTML output, CSS parsers, etc.) are tagged 5.109.0 where appropriate; experiments.* now carry @since for their original release versions.

Plugin hooks are refactored to createCompilationHooks() factories with inline @since on each hook (e.g. HtmlModulesPlugin, JavascriptModulesPlugin, NormalModule, Compiler, Compilation), and getCompilationHooks return types are inlined in types.d.ts so hook versions appear on the public API.

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

changeset-bot · Jul 22, 2026

🦋 Changeset detected

Latest commit: 9018e85

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
webpack	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another 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.

codspeed-hq · Jul 22, 2026

Merging this PR will regress 1 benchmark

⚠️

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
❌ 1 regressed benchmark
✅ 214 untouched benchmarks

Warning

Please fix the performance issues or acknowledge them on CodSpeed.

Performance Changes

	Mode	Benchmark	`BASE`	`HEAD`	Efficiency
❌	Memory	`benchmark "many-modules-esm", scenario '{"name":"mode-production","mode":"production"}'`	7.5 MB	9.9 MB	-24.25%
⚡	Memory	`benchmark "devtool-eval", scenario '{"name":"mode-development-rebuild","mode":"development","watch":true}'`	3.1 MB	1.3 MB	×2.4

Tip

Investigate this regression by commenting @codspeedbot fix this regression on this PR, or directly use the CodSpeed MCP with your agent.

_{Comparing bjohansebas:feat/schema-since-default-annotations (9018e85) with main (ec39088)}

codecov · Jul 22, 2026

Codecov Report

❌ Patch coverage is 92.30769% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 93.80%. Comparing base (ec39088) to head (9018e85).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
lib/NormalModule.js	85.71%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #21473      +/-   ##
==========================================
+ Coverage   93.78%   93.80%   +0.01%     
==========================================
  Files         620      620              
  Lines       73330    73324       -6     
  Branches    21203    21203              
==========================================
+ Hits        68771    68779       +8     
+ Misses       4559     4545      -14

Flag	Coverage Δ
css-parsing	`25.59% <77.27%> (-0.01%)`	⬇️
html5lib	`27.02% <76.19%> (-0.01%)`	⬇️
integration	`89.61% <92.30%> (+0.01%)`	⬆️
test262	`43.37% <81.81%> (+0.02%)`	⬆️
unit	`47.22% <82.60%> (-0.01%)`	⬇️

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.

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.

Copilot

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

alexander-akait

I like the idea with @ since, let’s avoid default from here, I want to discuss about it and have ideas

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.

…were added in

github-actions · Jul 28, 2026

This PR is packaged and the instant preview is available (774e7e4).

Install it locally:

npm

npm i -D webpack@https://pkg.pr.new/webpack@774e7e4

yarn

yarn add -D webpack@https://pkg.pr.new/webpack@774e7e4

pnpm

pnpm add -D webpack@https://pkg.pr.new/webpack@774e7e4

Copilot AI review requested due to automatic review settings July 22, 2026 00:22

Copilot AI reviewed Jul 22, 2026

bjohansebas force-pushed the feat/schema-since-default-annotations branch from 59e6563 to 27fa1ab Compare July 22, 2026 00:26

Copilot AI review requested due to automatic review settings July 22, 2026 00:26

Copilot AI reviewed Jul 22, 2026

Copilot AI review requested due to automatic review settings July 22, 2026 01:21

Copilot AI reviewed Jul 22, 2026

Copilot AI review requested due to automatic review settings July 22, 2026 01:45

Copilot AI reviewed Jul 22, 2026

bjohansebas force-pushed the feat/schema-since-default-annotations branch from 4b49a3a to 8db43f6 Compare July 22, 2026 01:51

Copilot AI review requested due to automatic review settings July 22, 2026 01:51

Copilot AI reviewed Jul 22, 2026

alexander-akait reviewed Jul 22, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings July 22, 2026 18:21

Copilot AI reviewed Jul 22, 2026

avivkeller approved these changes Jul 24, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings July 25, 2026 21:32

bjohansebas force-pushed the feat/schema-since-default-annotations branch from 7c619f4 to e48b158 Compare July 25, 2026 21:32

Copilot AI reviewed Jul 25, 2026

avivkeller requested a review from alexander-akait July 25, 2026 21:39

bjohansebas changed the title ~~feat: annotate schema options with added and default keywords~~ feat: annotate schema options with added keywords Jul 26, 2026

bjohansebas added 5 commits July 27, 2026 18:00

feat: annotate schema options with added and default keywords

f024fea

feat: annotate public hooks with the version they were added in

5fbc07d

feat: annotate public plugin compilation hooks with the version they …

c07ebea

…were added in

refactor: drop default annotations for now

baa4fa7

fixup!

9018e85

bjohansebas force-pushed the feat/schema-since-default-annotations branch from e48b158 to 9018e85 Compare July 27, 2026 23:01

bjohansebas merged commit 774e7e4 into webpack:main Jul 28, 2026
61 of 62 checks passed

bjohansebas deleted the feat/schema-since-default-annotations branch July 28, 2026 15:27

github-actions Bot mentioned this pull request Jul 28, 2026

chore(release): new release #21534

Merged

Search code, repositories, users, issues, pull requests...

Uh oh!

Uh oh!

Conversation

bjohansebas commented Jul 22, 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 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

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!

codspeed-hq Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merging this PR will regress 1 benchmark

Performance Changes

Uh oh!

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

Uh oh!

Codecov Report

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!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

alexander-akait left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

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!

Uh oh!

github-actions Bot commented Jul 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

bjohansebas commented Jul 22, 2026 •

edited by cursor Bot

Loading

changeset-bot Bot commented Jul 22, 2026 •

edited

Loading

codspeed-hq Bot commented Jul 22, 2026 •

edited

Loading

codecov Bot commented Jul 22, 2026 •

edited

Loading

alexander-akait left a comment •

edited

Loading