Skip to content

Turbopack: Pass asset_suffix_path as Vc#89899

Merged
sokra merged 2 commits into
canaryfrom
sokra/fix-chunking-context-caching
Feb 12, 2026
Merged

Turbopack: Pass asset_suffix_path as Vc#89899
sokra merged 2 commits into
canaryfrom
sokra/fix-chunking-context-caching

Conversation

@sokra

@sokra sokra commented Feb 12, 2026

Copy link
Copy Markdown
Member

Summary

  • Pass asset_suffix_path as Vc<Option<RcStr>> instead of eagerly resolving it to Option<RcStr> in the chunking context option structs
  • Add filesystem cache size growth assertions to e2e tests to detect unbounded cache growth regressions

Why

Previously, css_url_suffix was eagerly awaited in project.rs before being passed into ClientChunkingContextOptions, ServerChunkingContextOptions, and EdgeChunkingContextOptions. This caused a new chunking context Vc to be created for every build, duplicating the entire build in cache and recompiling it.

By keeping it as a Vc, the chunking context identity is stable across builds, preventing unnecessary cache duplication.

How

  • Changed css_url_suffix field from Option<RcStr> to Vc<Option<RcStr>> in all three chunking context option structs
  • Removed .owned().await?.clone() in project.rs (3 call sites), passing the Vc directly
  • Added .owned().await? at the point of use in the 5 context builder functions
  • Added cache size measurements to filesystem-cache.test.ts: normal changes limited to 10% growth, renames allow up to 50% due to dead cache entries

We need to pass it by vc instead of by value, otherwise we create a new chunking context Vc for every build, which duplicates the whole build in cache (and compiles it again)
Measure Turbopack cache size (.next/cache/turbopack/) before and after
rebuild cycles to detect unbounded cache growth regressions. Normal
changes are limited to 10% growth; renames allow up to 50% due to
dead cache entries from old routes persisting.
@nextjs-bot nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. tests Turbopack Related to Turbopack with Next.js. labels Feb 12, 2026

sokra commented Feb 12, 2026

Copy link
Copy Markdown
Member Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@sokra sokra marked this pull request as ready for review February 12, 2026 09:46
@sokra sokra requested a review from mischnic February 12, 2026 09:46
@nextjs-bot

nextjs-bot commented Feb 12, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

@codspeed-hq

codspeed-hq Bot commented Feb 12, 2026

Copy link
Copy Markdown

Merging this PR will not alter performance

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks1


Comparing sokra/fix-chunking-context-caching (59a5316) with canary (d41c50b)

Open in CodSpeed

Footnotes

  1. 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
Copy Markdown
Contributor

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) 456ms 455ms ▁▁▁▁▁
Cold (Ready in log) 438ms 439ms ▁▂▁▁▁
Cold (First Request) 1.136s 1.148s ▁▄▂▁▄
Warm (Listen) 458ms 456ms ▁▁▁▁▁
Warm (Ready in log) 442ms 447ms ▁▁▁▁▁
Warm (First Request) 329ms 333ms ▁▂▂▁▂
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 457ms 456ms ▁▁▁█▁
Cold (Ready in log) 453ms 452ms ▁▁▁█▃
Cold (First Request) 1.919s 1.898s ▂▁▁█▂
Warm (Listen) 457ms 456ms ▁▁▁█▁
Warm (Ready in log) 452ms 454ms ▂▁▁█▃
Warm (First Request) 1.884s 1.924s ▂▁▁█▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 3.728s 3.792s ▁▁▃▁▁
Cached Build 3.780s 3.793s ▁▁▃▁▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 14.501s 14.606s ▂▁▁█▁
Cached Build 14.688s 14.649s ▂▁▁█▁
node_modules Size 472 MB 472 MB █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **437 kB** → **437 kB** ✅ -3 B

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

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 765 B 761 B
Total 765 B 761 B ✅ -4 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 448 B 451 B
Total 448 B 451 B ⚠️ +3 B

📦 Webpack

Client

Main Bundles
Canary PR Change
5528-HASH.js gzip 5.47 kB N/A -
6280-HASH.js gzip 57 kB N/A -
6335.HASH.js gzip 169 B N/A -
912-HASH.js gzip 4.53 kB N/A -
e8aec2e4-HASH.js gzip 62.5 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 255 B 254 B
main-HASH.js gzip 39.1 kB 39.1 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
262-HASH.js gzip N/A 4.53 kB -
2889.HASH.js gzip N/A 169 B -
5602-HASH.js gzip N/A 5.49 kB -
6948ada0-HASH.js gzip N/A 62.5 kB -
9544-HASH.js gzip N/A 57.7 kB -
Total 230 kB 231 kB ⚠️ +632 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 194 B
_error-HASH.js gzip 183 B 180 B 🟢 3 B (-2%)
css-HASH.js gzip 331 B 330 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 256 B 256 B
head-HASH.js gzip 351 B 352 B
hooks-HASH.js gzip 384 B 383 B
image-HASH.js gzip 580 B 581 B
index-HASH.js gzip 260 B 260 B
link-HASH.js gzip 2.49 kB 2.49 kB
routerDirect..HASH.js gzip 320 B 319 B
script-HASH.js gzip 386 B 386 B
withRouter-HASH.js gzip 315 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.97 kB 7.97 kB ✅ -1 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 126 kB 126 kB
page.js gzip 249 kB 250 kB
Total 375 kB 376 kB ⚠️ +380 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 613 B 614 B
middleware-r..fest.js gzip 156 B 155 B
middleware.js gzip 33.1 kB 33 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 34.7 kB 34.6 kB ✅ -81 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 733 B 735 B
Total 733 B 735 B ⚠️ +2 B
Build Cache
Canary PR Change
0.pack gzip 3.84 MB 3.85 MB 🔴 +10.4 kB (+0%)
index.pack gzip 103 kB 103 kB
index.pack.old gzip 103 kB 102 kB
Total 4.04 MB 4.05 MB ⚠️ +10.2 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 316 kB 316 kB
app-page-exp..prod.js gzip 168 kB 168 kB
app-page-tur...dev.js gzip 315 kB 315 kB
app-page-tur..prod.js gzip 167 kB 167 kB
app-page-tur...dev.js gzip 312 kB 312 kB
app-page-tur..prod.js gzip 166 kB 166 kB
app-page.run...dev.js gzip 312 kB 312 kB
app-page.run..prod.js gzip 166 kB 166 kB
app-route-ex...dev.js gzip 70.5 kB 70.5 kB
app-route-ex..prod.js gzip 49 kB 49 kB
app-route-tu...dev.js gzip 70.5 kB 70.5 kB
app-route-tu..prod.js gzip 49 kB 49 kB
app-route-tu...dev.js gzip 70.1 kB 70.1 kB
app-route-tu..prod.js gzip 48.8 kB 48.8 kB
app-route.ru...dev.js gzip 70.1 kB 70.1 kB
app-route.ru..prod.js gzip 48.8 kB 48.8 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 43.2 kB 43.2 kB
pages-api-tu..prod.js gzip 32.9 kB 32.9 kB
pages-api.ru...dev.js gzip 43.2 kB 43.2 kB
pages-api.ru..prod.js gzip 32.8 kB 32.8 kB
pages-turbo....dev.js gzip 52.5 kB 52.5 kB
pages-turbo...prod.js gzip 39.4 kB 39.4 kB
pages.runtim...dev.js gzip 52.5 kB 52.5 kB
pages.runtim..prod.js gzip 39.4 kB 39.4 kB
server.runti..prod.js gzip 62.7 kB 62.7 kB
Total 2.8 MB 2.8 MB ⚠️ +1 B

@sokra sokra requested review from bgw, lukesandberg and mischnic and removed request for mischnic February 12, 2026 11:28
let css_url_suffix = css_url_suffix.owned().await?;

let next_mode = mode.await?;
let asset_prefix = asset_prefix.owned().await?;

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

[Re: line +513]

should you keep it as a VC through here as well?

See this comment inline on Graphite.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

yes

@sokra sokra merged commit 9b0277f into canary Feb 12, 2026
290 of 295 checks passed
@sokra sokra deleted the sokra/fix-chunking-context-caching branch February 12, 2026 16:45
@github-actions github-actions Bot locked as resolved and limited conversation to collaborators Feb 27, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants