Skip to content

refactor(css,html): name token types, quotes and namespaces with enums - #22640

Merged
alexander-akait merged 2 commits into
mainfrom
refactor/css-html-syntax-enums
Oct 12, 2026
Merged

alexander-akait merged 2 commits into
mainfrom
refactor/css-html-syntax-enums

Conversation

@alexander-akait

@alexander-akait alexander-akait commented Oct 12, 2026 •

Copy link
Copy Markdown
Member

Summary

The CSS and HTML syntax modules still exported groups of bare constants where NodeType already uses an enum. This PR turns those groups into enums too, so all three are read the same way.

// before
if (t.type === TT_LEFT_CURLY_BRACKET) …
quoteType === QUOTE_NONE
_namespaceOf(el) === NS_SVG
// after
if (t.type === TokenType.LeftCurlyBracket) …
quoteType === Quote.None
_namespaceOf(el) === Namespace.SVG
Before After
CSS TT_* (26 constants) TokenType (Ident, BadString, LeftCurlyBracket, …, names matching NodeType)
HTML QUOTE_NONE / DOUBLE / SINGLE Quote.None / Double / Single
HTML NS_HTML / MATHML / SVG Namespace.HTML / MathML / SVG
CC_* and LIST_* used only by the printers private (_) exports
6 HTML CC_* nothing imports removed

Every value keeps its number, so output is unchanged. CSS tokenize and parse of the Tailwind fixture, 20 alternating processes per side: median 56.9 ms on this branch vs 58.5 ms on main, inside run-to-run spread.

What kind of change does this PR introduce?

refactor

Did you add tests for your changes?

No new tests. The existing tests in test/unitCases/CssSyntax.unittest.js and test/unitCases/HtmlSyntax.unittest.js, plus the spec helpers, now read the enums.

Does this PR introduce a breaking change?

No. The renamed and removed exports belong to the experimental syntax API and were never in a release.

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

n/a

Use of AI

Claude Code made the renames, updated the call sites, tests and tooling scripts, and compared CPU time against main. A maintainer reviewed the result.

🤖 Generated with Claude Code

https://claude.ai/code/session_015gdnghKbLJ7VvJ5nNCNHhH


Generated by Claude Code

Summary by CodeRabbit

  • API Changes
    • Parser classifications are exposed through grouped token, namespace, and quote values. Several standalone constants are no longer available, so integrations that reference them may need updating.
  • Behavior
    • CSS and HTML parsing behavior, including token classifications and namespace handling, remains unchanged.

CSS token types become TokenType, HTML quote kinds Quote and namespaces
Namespace, like NodeType. Character codes and the minifier's list states
the printers share become private exports; six unused ones are removed.
@changeset-bot

changeset-bot Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: e51be66

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

@github-actions github-actions Bot added area: css CSS support (lib/css) area: html Experimental HTML support (lib/html) area: types types.d.ts, JSDoc annotations, hand-maintained declarations area: build-perf Build time and memory of webpack itself area: tooling Repo tooling, codegen, CLI entry (tooling/, bin/) labels Oct 12, 2026
@github-actions

github-actions Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

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

Install it locally:

  • npm
npm i -D webpack@https://pkg.pr.new/webpack@f899873
  • yarn
yarn add -D webpack@https://pkg.pr.new/webpack@f899873
  • pnpm
pnpm add -D webpack@https://pkg.pr.new/webpack@f899873

@coderabbitai

coderabbitai Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Repository: webpack/webpack/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: d28830dc-0216-437f-8f8d-fb3449eb4d79

📥 Commits

Reviewing files that changed from the base of the PR and between d82eb97 and e51be66.


📒 Files selected for processing (3)
  • lib/css/syntax-parser.js
  • lib/html/syntax-parser.js
  • lib/html/syntax-printer.js

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 5 remain after this review.



📝 Walkthrough

Walkthrough

The CSS parser now exports token types through TokenType and prefixes selected character-code and list-kind exports with underscores. The HTML parser adds Namespace and Quote objects. Parser consumers, tests, benchmarks, and tooling use the named members.

Changes

Parser enum migration

Layer / File(s) Summary
CSS token types and parser
lib/css/syntax-parser.js
The parser adds TokenType with the existing token values. It exports this object instead of individual TT_* constants and prefixes selected character-code and list-kind exports with underscores.
CSS token type consumers
lib/css/syntax-printer.js, lib/html/HtmlGenerator.js, test/benchmarkCases/css-parser-tailwind-unit/*, test/helpers/FakeDocument.js, test/unitCases/CssSyntax.unittest.js, tooling/compare-css-tools.js
These consumers use TokenType members instead of individual token constants. The CSS printer aliases underscored exports to local names.
HTML namespace and quote enums
lib/html/syntax-parser.js
The parser adds and exports Namespace and Quote, and uses TokenType members when parsing CSS URLs. It removes the listed standalone namespace, quote, and character-code exports.
HTML enum consumers
lib/html/syntax-printer.js, test/helpers/serializeHtmlTree.js, test/specCases/*, test/unitCases/HtmlSyntax.unittest.js, tooling/compare-html-tools.js
These consumers use Namespace and Quote members instead of the former standalone constants.

Suggested reviewers: bjohansebas


Priority: ⬇️ Low

Change: Refactor

Merge Risk: ⚪ Minimal · up to e51be

This is a behavior-preserving refactor that renames internal parser constants into enums. No concrete risk was identified, and it looks safe to merge after normal checks.

Pre-merge checks | Passed 4
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title uses the required Conventional Commit form with the allowed type refactor, the optional css,html scope, and a subject that accurately describes the enum naming changes.
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Warning

Some tools did not complete. Review the errors below.

🔧 ast-grep (0.45.3)
lib/html/syntax-parser.js

ast-grep timed out on this file



Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

Types Coverage

Coverage after merging refactor/css-html-syntax-enums into main will be
97.28%
Coverage Report
FileStmtsBranchesFuncsLinesUncovered Lines
bin
   webpack.js98.82%100%100%98.82%103
declarations
   WebpackOptions.ts99.94%100%100%99.94%4188
examples
   build-common.js100%100%100%100%
   buildAll.js100%100%100%100%
   examples.js100%100%100%100%
   template-common.js98.21%100%100%98.21%72
examples/custom-javascript-parser
   test.filter.js100%100%100%100%
examples/custom-javascript-parser/internals
   acorn-parse.js100%100%100%100%
   meriyah-parse.js100%100%100%100%
   oxc-parse.js100%100%100%100%
examples/markdown
   webpack.config.mjs100%100%100%100%
examples/module-federation
   test.filter.js100%100%100%100%
examples/reexport-components
   test.filter.js100%100%100%100%
examples/ssr
   test.filter.js100%100%100%100%
examples/typescript
   test.filter.js100%100%100%100%
examples/typescript-non-erasable
   test.filter.js50%100%100%50%5
examples/virtual-modules
   test.filter.js100%100%100%100%
examples/wasm-bindgen-esm
   test.filter.js100%100%100%100%
examples/wasm-complex
   test.filter.js100%100%100%100%
examples/wasm-emscripten
   test.filter.js100%100%100%100%
examples/wasm-simple
   test.filter.js100%100%100%100%
examples/wasm-simple-source-phase
   test.filter.js100%100%100%100%
lib
   Chunk.js100%100%100%100%
   Compilation.js98.60%100%100%98.60%1757, 2078, 2085, 2093, 2115, 2118, 23, 3075, 3578–3579, 3611, 4200, 4204, 4331, 4352, 4477, 4514, 4521, 4574–4575, 4579, 4584, 4600–4601, 4615–4616, 4621–4622, 5145, 5171, 6001, 6018, 6036, 6052, 6067, 6092, 6095, 6463, 6466–6467, 6472, 6487, 6570, 6594, 6708, 837–838
   Compiler.js98.81%100%100%98.81%1116, 1153, 1156, 1336–1337, 1345, 848, 934, 975
   Dependency.js100%100%100%100%
   DependencyTemplate.js100%100%100%100%
   EntryPlugin.js100%100%100%100%
   Entrypoint.js100%100%100%100%
   ExternalsPlugin.js100%100%100%100%
   FileSystemInfo.js100%100%100%100%
   InitFragment.js100%100%100%100%
   LibraryTemplatePlugin.js100%100%100%100%
   ModuleFilenameHelpers.js100%100%100%100%
   ModuleNotFoundError.js100%100%100%100%
   MultiCompiler.js98.88%100%100%98.88%460, 532, 719, 784
   NormalModule.js100%100%100%100%
   NullFactory.js100%100%100%100%
   ProgressPlugin.js100%100%100%100%
   RawModule.js100%100%100%100%
   RequestShortener.js100%100%100%100%
   SingleEntryPlugin.js100%100%100%100%
   WebpackError.js100%100%100%100%
   index.js99.78%100%100%99.78%206
   webpack.js97.84%100%100%97.84%278, 300, 302
lib/asset
   AssetBytesGenerator.js100%100%100%100%
   AssetBytesParser.js100%100%100%100%
   AssetGenerator.js100%100%100%100%
   AssetModule.js100%100%100%100%
   AssetModulesPlugin.js98.14%100%100%98.14%337, 361, 364, 494, 56, 61
   AssetParser.js100%100%100%100%
   AssetSourceGenerator.js100%100%100%100%
   AssetSourceParser.js100%100%100%100%
   RawDataUrlModule.js100%100%100%100%
   WebManifestGenerator.js100%100%100%100%
   WebManifestParser.js100%100%100%100%
lib/async-modules
   AsyncModuleHelpers.js100%100%100%100%
   AwaitDependenciesInitFragment.js100%100%100%100%
   InferAsyncModulesPlugin.js100%100%100%100%
   isGeneratorLowered.js100%100%100%100%
lib/bun
   BunTargetPlugin.js100%100%100%100%
lib/cache
   AddBuildDependenciesPlugin.js100%100%100%100%
   AddManagedPathsPlugin.js100%100%100%100%
   Cache.js96.49%100%100%96.49%10, 104
   CacheFacade.js100%100%100%100%
   IdleFileCachePlugin.js97.92%100%100%97.92%75, 87, 95
   MemoryCachePlugin.js92%100%100%92%33, 42
   MemoryWithGcCachePlugin.js93.42%100%100%93.42%106, 120–121, 130, 88
   PackFileCacheStrategy.js96.54%100%100%96.54%1304, 1404, 1408, 1470, 1716, 1800, 1823, 1853, 682, 701, 711–713, 715, 731–732, 737, 740, 742, 747, 752, 777, 783, 817, 823, 829, 834, 845, 854, 859–860, 862, 879, 885–886, 888
   ResolverCachePlugin.js100%100%100%100%
   getLazyHashedEtag.js100%100%100%100%
   mergeEtags.js100%100%100%100%
lib/config
   OptionsApply.js100%100%100%100%
   PlatformPlugin.js100%100%100%100%
   WebpackOptionsApply.js100%100%100%100%
   WebpackOptionsDefaulter.js100%100%100%100%
   browserslistTargetHandler.js100%100%100%100%
   cli.js98.61%100%100%98.61%116, 546, 578, 628, 9
   defaults.js99.44%100%100%99.44%1624–1626, 1634, 283, 286, 291, 295
   defineConfig.js100%100%100%100%
   getClaimedAssetTypes.js100%100%100%100%
   normalization.js99.12%100%100%99.12%279–280, 346, 361
   target.js100%100%100%100%
   validateSchema.js94.67%100%100%94.67%100, 87, 89, 98
lib/container
   ContainerEntryDependency.js100%100%100%100%
   ContainerEntryModule.js100%100%100%100%
   ContainerEntryModuleFactory.js100%100%100%100%
   ContainerExposedDependency.js100%100%100%100%
   ContainerPlugin.js100%100%100%100%
   ContainerReferencePlugin.js100%100%100%100%
   FallbackDependency.js100%100%100%100%
   FallbackItemDependency.js100%100%100%100%
   FallbackModule.js100%100%100%100%
   FallbackModuleFactory.js100%100%100%100%
   HoistContainerReferencesPlugin.js100%100%100%100%
   ModuleFederationPlugin.js100%100%100%100%
   RemoteModule.js100%100%100%100%
   RemoteRuntimeModule.js100%100%100%100%
   RemoteToExternalDependency.js100%100%100%100%
   declaredRemotes.js100%100%100%100%
   moduleFederationHooks.js100%100%100%100%
   options.js100%100%100%100%
lib/context
   ContextExclusionPlugin.js100%100%100%100%
   ContextModule.js99.88%100%100%99.88%1495
   ContextModuleFactory.js95.70%100%100%95.70%230, 257, 276, 280–281, 289, 466, 487, 492, 534, 543, 545, 549, 552, 558–559
   ContextReplacementPlugin.js100%100%100%100%
lib/css
   CssGenerator.js99.29%100%100%99.29%1092, 134, 301, 849
   CssInjectStyleRuntimeModule.js100%100%100%100%
   CssLoadingRuntimeModule.js100%100%100%100%
   CssModule.js83.33%100%100%83.33%197, 202–210, 212–217
   CssModulesPlugin.js99.86%100%100%99.86%884
   CssParser.js99.48%100%100%99.48%1044, 1075, 24, 2406, 3053, 3056, 3062, 3103, 3106, 3145, 3148, 3485, 5039, 5042, 928
   CssServerStylesRuntimeModule.js100%100%100%100%
   conventions.js98.65%100%100%98.65%93
   cssMinify.js97.50%100%100%97.50%162, 171
   data.js99.84%100%100%99.84%229, 5601
   syntax-parser.js99.65%100%100%99.65%10281–10282, 10818–10819, 10856, 11051, 11097, 13429–13432, 13532–13533, 13630–13631, 14276, 14573, 14575, 15065, 15431, 17544, 2606, 3311, 3313, 3318, 3337, 4086, 4092, 7567, 7605, 7612
   syntax-printer.js99.31%100%100%99.31%2537–2538, 2540–2541, 2543–2544, 2549, 2816–2819, 2912, 351, 3587, 4007, 4116, 4804, 5105, 5891, 725
   syntax.js100%100%100%100%
   topologicalSort.js100%100%100%100%
lib/debug
   ProfilingPlugin.js96.22%100%100%96.22%169, 425, 554, 561, 570, 574, 583, 588, 594, 599, 92
lib/define
   DefinePlugin.js98.85%100%100%98.85%1495, 268–269, 285, 304, 378, 936, 938, 943, 967
   DotenvPlugin.js98.07%100%100%98.07%391, 439, 452–453
   EnvironmentPlugin.js97.14%100%100%97.14%49
lib/deno
   DenoTargetPlugin.js100%100%100%100%
lib/dependencies
   ConstDependency.js100%100%100%100%
   ContextElementDependency.js100%100%100%100%
   NullDependency.js100%100%100%100%
lib/dependencies/amd
   AMDDefineDependency.js100%100%100%100%
   AMDDefineDependencyParserPlugin.js100%100%100%100%
   AMDPlugin.js99.31%100%100%99.31%54
   AMDRequireArrayDependency.js100%100%100%100%
   AMDRequireContextDependency.js100%100%100%100%
   AMDRequireDependenciesBlock.js100%100%100%100%
   

@codecov

codecov Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.27%. Comparing base (fa15f02) to head (e51be66).
⚠️ Report is 6 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #22640      +/-   ##
==========================================
- Coverage   96.28%   96.27%   -0.01%     
==========================================
  Files         774      774              
  Lines      129982   129951      -31     
  Branches    43297    43297              
==========================================
- Hits       125149   125114      -35     
- Misses       4833     4837       +4     
Flag Coverage Δ
css-parsing 25.04% <100.00%> (-0.03%) ⬇️
html5lib 26.98% <38.46%> (-0.01%) ⬇️
integration 82.19% <100.00%> (-0.01%) ⬇️
minify-corpora 90.54% <ø> (ø)
syntax-equivalence 79.09% <84.61%> (-0.04%) ⬇️
test262 57.05% <ø> (ø)
test262-parser 82.65% <ø> (ø)
unit 75.61% <95.12%> (-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.

@github-actions

github-actions Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

Generated code size

Comparing base (fa15f02) to head (e51be66). Merging this pull request will not change the code webpack generates.

What moved Tests Assets Gzip Raw Test edit
Changed, test untouched 0 0 — — —
Changed, test edited 0 0 — — —
New 0 0 — — —
Deleted 0 0 — — —
Unchanged — 8609 — — —

Read Changed, test untouched first: the test is byte-identical on both sides, so webpack generated the difference. Changed, test edited moved partly because the test did — Test edit is how many bytes the test gained, and a bundle that grew by less is not a regression. New and Deleted are whole files, not deltas — a new asset was created, not grown, so it reads gray (⚪ added) — and adding tests cannot bury a real change. Gzip decides, because that is what users download; raw is the tiebreak, and brotli and zstd are per asset below.

No asset changed size.

No runtime gained or lost a runtime module.

Built test/configCases with the defaults a user gets: 2218 test(s), 8609 asset(s), 99 emitted nothing.

@codspeed

codspeed Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

Merging this PR will degrade performance by 10.08%

⚠️ 108 benchmarks spent significant time in system calls

System calls cannot be consistently instrumented, so they are not included in the measure, which understates the real cost. Please switch to the Walltime instrument to accurately measure system calls.

Measurement and system calls

ℹ️ 30 benchmarks have no flame graph

The flamegraph could not be generated because too much time was spent in runtime internals, making the visualization not useful for performance analysis.

⚠️ 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
❌ 2 regressed benchmarks
✅ 403 untouched benchmarks
⏩ 6 skipped benchmarks1

Warning

Please fix the performance issues or acknowledge them on CodSpeed.

Performance Changes

Mode Benchmark BASE HEAD Efficiency
❌ Memory benchmark "html-many-chunks", scenario '{"name":"mode-development-rebuild","mode":"development","watch":true}' 160.8 KB 779.7 KB -79.37%
❌ Memory benchmark "concatenate-modules", scenario '{"name":"mode-development-rebuild","mode":"development","watch":true}' 465.9 KB 659 KB -29.3%
⚡ Memory unit benchmark "html-printer-document-unit", walk (document) 146.4 KB 29.4 KB ×5

Tip

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


Comparing refactor/css-html-syntax-enums (e51be66) with main (fa15f02)

Open in CodSpeed

Footnotes

  1. 6 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

Reading TokenType, Quote and Namespace members on the hot paths cost
CodSpeed's readToken benchmark 25% more instructions. The parsers read
the TT_*, QUOTE_* and NS_* constants again and build the enums from them.
@alexander-akait
alexander-akait merged commit f899873 into main Oct 12, 2026
115 of 116 checks passed
@alexander-akait
alexander-akait deleted the refactor/css-html-syntax-enums branch October 12, 2026 18:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: build-perf Build time and memory of webpack itself area: css CSS support (lib/css) area: html Experimental HTML support (lib/html) area: tooling Repo tooling, codegen, CLI entry (tooling/, bin/) area: types types.d.ts, JSDoc annotations, hand-maintained declarations

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant