Skip to content

Conversation

@sokra
Copy link
Member

@sokra sokra commented Jan 9, 2026

What?

Refactor ModuleGraph to be a strongly consistent snapshot of the module graph. This should avoid eventually consistency problems where different versions of single module graphs do not fit together.

@nextjs-bot
Copy link
Collaborator

Allow CI Workflow Run

  • approve CI run for commit: 52d9dd0

Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer

@sokra sokra changed the title Turbopack: pass binding info as operation to module graph Turbopack: snapshot the ModuleGraph to avoid (eventual) inconsistent graphs Jan 9, 2026
@sokra sokra marked this pull request as ready for review January 9, 2026 17:57
@sokra sokra requested a review from mischnic January 9, 2026 17:57
Comment on lines +967 to +977
let binding_usage_info = remove_unused_imports.then(|| {
compute_binding_usage_info(
ModuleGraph::from_graphs(graphs.clone()),
should_read_binding_usage,
)
});

let full = if let Some(binding_usage_info) = binding_usage_info {
ModuleGraph::from_graphs_without_unused_references(graphs, binding_usage_info)
} else {
full_with_unused_references
ModuleGraph::from_graphs(graphs)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
let binding_usage_info = remove_unused_imports.then(|| {
compute_binding_usage_info(
ModuleGraph::from_graphs(graphs.clone()),
should_read_binding_usage,
)
});
let full = if let Some(binding_usage_info) = binding_usage_info {
ModuleGraph::from_graphs_without_unused_references(graphs, binding_usage_info)
} else {
full_with_unused_references
ModuleGraph::from_graphs(graphs)
let (full, binding_usage_info) = if remove_unused_imports {
let full_with_unused_references = ModuleGraph::from_graphs(graphs.clone());
let binding_usage_info = compute_binding_usage_info(
full_with_unused_references,
should_read_binding_usage,
);
(
ModuleGraph::from_graphs_without_unused_references(graphs, binding_usage_info),
Some(binding_usage_info),
)
} else {
(ModuleGraph::from_graphs(graphs), None)

Type mismatch in binding_usage_info assignment - closure returns Future instead of OperationVc

Fix on Vercel

@codspeed-hq
Copy link

codspeed-hq bot commented Jan 12, 2026

CodSpeed Performance Report

Merging this PR will improve performance by 3.6%

Comparing sokra/module-graph-consistency (965d41d) with canary (5746e3b)1

Summary

⚡ 1 improved benchmark
✅ 16 untouched benchmarks
⏩ 3 skipped benchmarks2

Performance Changes

Mode Benchmark BASE HEAD Efficiency
Simulation build[lucide-react-all] 8.3 s 8 s +3.6%

Footnotes

  1. No successful run was found on sokra/parallel-backend (e70e940) during the generation of this report, so canary (5746e3b) was used instead as the comparison base. There might be some changes unrelated to this pull request in this report.

  2. 3 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.

@nextjs-bot
Copy link
Collaborator

Failing test suites

Commit: 965d41d | About building and testing Next.js

pnpm test test/integration/invalid-custom-routes/test/index.test.ts (job)

  • Errors on invalid custom routes > development mode > should error during next build for invalid headers (DD)
Expand output

● Errors on invalid custom routes › development mode › should error during next build for invalid headers

expect(received).toContain(expected) // indexOf

Expected substring: "`source` is missing, `key` in header item must be string for route {\"headers\":[{\"x-first\":\"first\"}]}"
Received string:    "`destination` is missing for route {\"source\":\"/hello\"}·
`source` is not a string for route {\"source\":123,\"destination\":\"/another\"}·
 invalid field: headers for route {\"source\":\"/hello\",\"destination\":\"/another\",\"headers\":\"not-allowed\"}·
`source` does not start with / for route {\"source\":\"hello\",\"destination\":\"/another\"}·
`destination` does not start with `/`, `http://`, or `https://` for route {\"source\":\"/hello\",\"destination\":\"another\"}··
Error parsing `/feedback/(?!general)` https://nextjs.org/docs/messages/invalid-route-source
Reason: Pattern cannot start with \"?\" at 11·
  /feedback/(?!general)
             ^·
`source` parse failed for route {\"source\":\"/feedback/(?!general)\",\"destination\":\"/feedback/general\"}·
`destination` has unnamed params :0 for route {\"source\":\"/hello/world/(.*)\",\"destination\":\"/:0\"}·
The route /hello rewrites urls outside of the basePath. Please use a destination that starts with `http://` or `https://` https://nextjs.org/docs/messages/invalid-external-rewrite
The route null is not a valid object with `source` and `destination`
The route \"string\" is not a valid object with `source` and `destination`
Invalid `has` item:
invalid type \"cookiee\" for {\"type\":\"cookiee\",\"key\":\"loggedIn\"}·
invalid `has` item found for route {\"source\":\"/hello\",\"destination\":\"/another\",\"has\":[{\"type\":\"cookiee\",\"key\":\"loggedIn\"}]}·
Invalid `has` items:
invalid type \"headerr\", invalid key \"undefined\" for {\"type\":\"headerr\"}
invalid type \"queryr\" for {\"type\":\"queryr\",\"key\":\"hello\"}·
invalid `has` items found for route {\"source\":\"/hello\",\"destination\":\"/another\",\"has\":[{\"type\":\"headerr\"},{\"type\":\"queryr\",\"key\":\"hello\"}]}··
Valid `has` object shape is {
  \"type\": \"header, cookie, query, host\",
  \"key\": \"the key to check for\",
  \"value\": \"undefined or a value string to match against\"
}·
Error: Invalid rewrites found
"

  450 |     const stderr = await getStderr()
  451 |
> 452 |     expect(stderr).toContain(
      |                    ^
  453 |       '`source` is missing, `key` in header item must be string for route {"headers":[{"x-first":"first"}]}'
  454 |     )
  455 |

  at Object.toContain (integration/invalid-custom-routes/test/index.test.ts:452:20)

@nextjs-bot
Copy link
Collaborator

Stats from current PR

✅ No significant changes detected

📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 455ms 455ms ▁▁█▁▁
Cold (Ready in log) 437ms 437ms ▁█▂▇▇
Cold (First Request) 1.129s 1.135s ▁█▂▇█
Warm (Listen) 456ms 458ms ▃▆▃▆▃
Warm (Ready in log) 443ms 442ms ▂▁█▁▁
Warm (First Request) 341ms 337ms ▁▆██▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 456ms 456ms ▁████
Cold (Ready in log) 433ms 432ms ▅▁▂█▅
Cold (First Request) 1.752s 1.740s ▄▄▄█▄
Warm (Listen) 456ms 455ms ▁▅▅▅▅
Warm (Ready in log) 433ms 432ms ▃▇▁▅▅
Warm (First Request) 1.747s 1.737s ▄▆▄█▅

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 4.027s 4.043s ▄▁█▁▁
Cached Build 4.051s 4.077s ▄▁█▁▂
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 13.860s 13.793s ▁▂▂█▁
Cached Build 13.868s 13.897s ▁▂▁█▁
node_modules Size 457 MB 457 MB █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **430 kB** → **430 kB** ✅ -29 B

82 files with content-based hashes (individual files not comparable between builds)

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 788 B 788 B
Total 788 B 788 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 451 B 450 B
Total 451 B 450 B ✅ -1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
2086.HASH.js gzip 169 B N/A -
2161-HASH.js gzip 5.41 kB N/A -
2747-HASH.js gzip 4.48 kB N/A -
4322-HASH.js gzip 52.8 kB N/A -
ec793fe8-HASH.js gzip 62.3 kB N/A -
framework-HASH.js gzip 59.8 kB 59.8 kB
main-app-HASH.js gzip 251 B 253 B
main-HASH.js gzip 38.6 kB 39 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
1596.HASH.js gzip N/A 169 B -
2658-HASH.js gzip N/A 52.7 kB -
6349-HASH.js gzip N/A 4.46 kB -
7019-HASH.js gzip N/A 5.43 kB -
b17a3386-HASH.js gzip N/A 62.3 kB -
Total 225 kB 226 kB ⚠️ +243 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 194 B 193 B
_error-HASH.js gzip 182 B 182 B
css-HASH.js gzip 336 B 335 B
dynamic-HASH.js gzip 1.8 kB 1.8 kB
edge-ssr-HASH.js gzip 256 B 256 B
head-HASH.js gzip 352 B 349 B
hooks-HASH.js gzip 385 B 384 B
image-HASH.js gzip 580 B 580 B
index-HASH.js gzip 259 B 258 B
link-HASH.js gzip 2.5 kB 2.51 kB
routerDirect..HASH.js gzip 319 B 317 B
script-HASH.js gzip 385 B 387 B
withRouter-HASH.js gzip 316 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.97 kB 7.96 kB ✅ -8 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 125 kB 125 kB
page.js gzip 239 kB 239 kB
Total 364 kB 364 kB ⚠️ +257 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 653 B 651 B
middleware-r..fest.js gzip 155 B 156 B
middleware.js gzip 32.8 kB 33.1 kB 🔴 +339 B (+1%)
edge-runtime..pack.js gzip 842 B 842 B
Total 34.4 kB 34.8 kB ⚠️ +338 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 738 B 738 B
Total 738 B 738 B
Build Cache
Canary PR Change
0.pack gzip 3.62 MB 3.62 MB
index.pack gzip 99.5 kB 98.3 kB 🟢 1.27 kB (-1%)
index.pack.old gzip 102 kB 99.7 kB 🟢 2.28 kB (-2%)
Total 3.83 MB 3.82 MB ✅ -3.24 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 303 kB 303 kB
app-page-exp..prod.js gzip 158 kB 158 kB
app-page-tur...dev.js gzip 303 kB 303 kB
app-page-tur..prod.js gzip 158 kB 158 kB
app-page-tur...dev.js gzip 299 kB 299 kB
app-page-tur..prod.js gzip 156 kB 156 kB
app-page.run...dev.js gzip 300 kB 300 kB
app-page.run..prod.js gzip 156 kB 156 kB
app-route-ex...dev.js gzip 68.2 kB 68.2 kB
app-route-ex..prod.js gzip 46.9 kB 46.9 kB
app-route-tu...dev.js gzip 68.2 kB 68.2 kB
app-route-tu..prod.js gzip 46.9 kB 46.9 kB
app-route-tu...dev.js gzip 67.8 kB 67.8 kB
app-route-tu..prod.js gzip 46.7 kB 46.7 kB
app-route.ru...dev.js gzip 67.8 kB 67.8 kB
app-route.ru..prod.js gzip 46.7 kB 46.7 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 41.1 kB 41.1 kB
pages-api-tu..prod.js gzip 31.2 kB 31.2 kB
pages-api.ru...dev.js gzip 41.1 kB 41.1 kB
pages-api.ru..prod.js gzip 31.2 kB 31.2 kB
pages-turbo....dev.js gzip 50.8 kB 50.8 kB
pages-turbo...prod.js gzip 38.2 kB 38.2 kB
pages.runtim...dev.js gzip 50.8 kB 50.8 kB
pages.runtim..prod.js gzip 38.2 kB 38.2 kB
server.runti..prod.js gzip 62 kB 62 kB
Total 2.68 MB 2.68 MB ✅ -2 B

Comment on lines 518 to -524
impl ClientReferencesGraph {
#[turbo_tasks::function]
pub async fn new_with_entries(
graph: SingleModuleGraphWithBindingUsage,
graph: ResolvedVc<ModuleGraph>,
is_single_page: bool,
) -> Result<Vc<Self>> {
let mapped = map_client_references(*graph.graph);
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Previously, the types ensured/made it obvious that this should be one of the individual stacked graphs.

But not anymore, even though it's still the individual graph, as far as I can tell?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

created-by: Turbopack team PRs by the Turbopack team. Turbopack Related to Turbopack with Next.js.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants