Skip to content

Conditionally load uncommon paths#90514

Merged
sokra merged 10 commits intocanaryfrom
02-25-conditionally_load_uncommon_paths
Mar 3, 2026
Merged

Conditionally load uncommon paths#90514
sokra merged 10 commits intocanaryfrom
02-25-conditionally_load_uncommon_paths

Conversation

@timneutkens
Copy link
Member

@timneutkens timneutkens commented Feb 25, 2026

What?

No changes in functionality. Just skips requiring modules that are not used in the common hot path of builds.

@vercel
Copy link
Contributor

vercel bot commented Feb 25, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
next-js Error Error Feb 25, 2026 1:11pm

Copy link
Member Author

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

@timneutkens timneutkens marked this pull request as ready for review February 25, 2026 12:57
@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Feb 25, 2026

Tests Passed

@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Feb 25, 2026

Stats from current PR

🟢 1 improvement

Metric Canary PR Change Trend
node_modules Size 476 MB 476 MB 🟢 86.4 kB (0%) █████
📊 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) 440ms 440ms ▂▁▁▂█
Cold (First Request) 1.234s 1.281s ▃▃▄▄█
Warm (Listen) 457ms 457ms ▂▁▁▁█
Warm (Ready in log) 443ms 443ms ▂▁▁▁█
Warm (First Request) 349ms 352ms ▃▁▁▁█
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 456ms 456ms ▁▁█▁▁
Cold (Ready in log) 438ms 440ms ▄▄▇▁▄
Cold (First Request) 1.946s 1.986s ▂▂▇▁▂
Warm (Listen) 456ms 455ms ▁▁█▁▁
Warm (Ready in log) 439ms 439ms ▄▃▆▁▃
Warm (First Request) 1.955s 1.973s ▂▂▆▁▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 4.048s 3.888s ▄▁▁▁█
Cached Build 4.036s 3.922s ▄▁▁▁█
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 14.189s 14.097s ▁▁▆▁▁
Cached Build 14.250s 14.218s ▁▁▆▁▁
node_modules Size 476 MB 476 MB 🟢 86.4 kB (0%) █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **401 kB** → **401 kB** ✅ -23 B

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

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 768 B 765 B
Total 768 B 765 B ✅ -3 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 450 B 450 B
Total 450 B 450 B

📦 Webpack

Client

Main Bundles
Canary PR Change
5528-HASH.js gzip 5.54 kB N/A -
6280-HASH.js gzip 58.7 kB N/A -
6335.HASH.js gzip 169 B N/A -
912-HASH.js gzip 4.59 kB N/A -
e8aec2e4-HASH.js gzip 62.6 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 256 B 253 B 🟢 3 B (-1%)
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.59 kB -
2889.HASH.js gzip N/A 169 B -
5602-HASH.js gzip N/A 5.55 kB -
6948ada0-HASH.js gzip N/A 62.6 kB -
9544-HASH.js gzip N/A 59.4 kB -
Total 232 kB 233 kB ⚠️ +730 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.5 kB 2.5 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 ✅ -2 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 125 kB 125 kB
page.js gzip 255 kB 255 kB
Total 380 kB 380 kB ⚠️ +336 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 618 B 613 B
middleware-r..fest.js gzip 156 B 155 B
middleware.js gzip 43.5 kB 44 kB 🔴 +468 B (+1%)
edge-runtime..pack.js gzip 842 B 842 B
Total 45.2 kB 45.6 kB ⚠️ +462 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 715 B 718 B
Total 715 B 718 B ⚠️ +3 B
Build Cache
Canary PR Change
0.pack gzip 4.05 MB 4.06 MB 🔴 +9.68 kB (+0%)
index.pack gzip 103 kB 103 kB
index.pack.old gzip 102 kB 103 kB
Total 4.26 MB 4.27 MB ⚠️ +10.3 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 321 kB 321 kB
app-page-exp..prod.js gzip 170 kB 170 kB
app-page-tur...dev.js gzip 320 kB 320 kB
app-page-tur..prod.js gzip 170 kB 170 kB
app-page-tur...dev.js gzip 317 kB 317 kB
app-page-tur..prod.js gzip 168 kB 168 kB
app-page.run...dev.js gzip 317 kB 317 kB
app-page.run..prod.js gzip 168 kB 168 kB
app-route-ex...dev.js gzip 70.8 kB 70.8 kB
app-route-ex..prod.js gzip 49.3 kB 49.3 kB
app-route-tu...dev.js gzip 70.9 kB 70.9 kB
app-route-tu..prod.js gzip 49.3 kB 49.3 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.ru...dev.js gzip 70.4 kB 70.4 kB
app-route.ru..prod.js gzip 49 kB 49 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.9 kB 32.9 kB
pages-turbo....dev.js gzip 52.6 kB 52.6 kB
pages-turbo...prod.js gzip 38.5 kB 38.5 kB
pages.runtim...dev.js gzip 52.6 kB 52.6 kB
pages.runtim..prod.js gzip 38.5 kB 38.5 kB
server.runti..prod.js gzip 62 kB 62 kB
Total 2.83 MB 2.83 MB ✅ -1 B
📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/e2698a45b5f08c4bf3abb349540dd4ea39d2a37d/next

@timneutkens timneutkens force-pushed the 02-25-conditionally_load_uncommon_paths branch from eb5179c to dc19106 Compare February 25, 2026 17:42
@sokra sokra force-pushed the 02-25-conditionally_load_uncommon_paths branch from 01156b0 to bacbcb2 Compare February 26, 2026 15:52
Comment on lines +1236 to +1238
throwTurbopackInternalError: (
require('../../shared/lib/turbopack/internal-error') as typeof import('../../shared/lib/turbopack/internal-error')
).throwTurbopackInternalError,
Copy link
Contributor

Choose a reason for hiding this comment

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

im guessing this one isn't buying you much... we always call createProject don't we?

or is it beneficial simply to defer it?

// Uses modern browsers as the default.
return MODERN_BROWSERSLIST_TARGET
}
export { getSupportedBrowsers } from './get-supported-browsers'
Copy link
Contributor

Choose a reason for hiding this comment

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

just migrate importers to the new module?

Comment on lines +1 to +2
import { formatIssue, isRelevantWarning } from '../shared/lib/turbopack/utils'
import type { TurbopackResult } from './swc/types'
Copy link
Contributor

Choose a reason for hiding this comment

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

should these helpers (formatIssue, isRelevantWarning) also move into a new module to avoid including all of turbopack/utils

(utils meme strikes again)

image.png

@sokra sokra force-pushed the 02-25-conditionally_load_uncommon_paths branch 3 times, most recently from b8fe676 to 4332d7c Compare March 3, 2026 09:54
sokra added 8 commits March 3, 2026 10:56
Move getSupportedBrowsers from build/utils.ts to build/get-supported-browsers.ts
to reduce the import footprint of utils.ts and allow more targeted imports.
Move printBuildErrors from build/utils.ts to build/print-build-errors.ts
to reduce the import footprint of utils.ts.
Move shouldUseReactServerCondition and isWebpackAppPagesLayer from
build/utils.ts to build/webpack-layer.ts to reduce the import footprint
of utils.ts.
Move isInterceptionRouteRewrite from generate-interception-routes-rewrites.ts
to lib/is-interception-route-rewrite.ts to allow importing it without pulling
in the full interception routes generation code. Use lazy require in
manifest-loader.ts to defer loading.
Remove the trivial isFileSystemCacheEnabledForBuild helper from
turbopack/utils.ts and inline the config check at each call site to
reduce unnecessary imports.
Convert top-level imports of patch-incorrect-lockfile, download-swc,
swc-load-failure, swc/options, turbopack/internal-error, and util to
lazy require() calls so they are only loaded when needed. Also fix the
eventSwcLoadFailure type to use Pick for the fields actually passed.
Use readFileSync instead of fs.readFile to avoid pulling in the
promises-based fs module and simplify the call sites.
Add missing node-environment-baseline import in fast-set-immediate test.
Lazy-load workUnitAsyncStorage and createCookiesWithMutableAccessCheck in
request-cookies test to avoid importing modules that depend on globals
not yet set up at import time.
sokra added 2 commits March 3, 2026 10:56
Reflect module extraction and lazy-loading changes in the expected
server trace file list: removed files no longer statically imported
(utils.js, format.js, segment-config, static-paths, async-sema,
text-table, create-incremental-cache) and added new modules
(webpack-layer.js, is-interception-route-rewrite.js).
@sokra sokra force-pushed the 02-25-conditionally_load_uncommon_paths branch from 4332d7c to e2698a4 Compare March 3, 2026 09:57
@sokra sokra merged commit 18e07cf into canary Mar 3, 2026
159 checks passed
@sokra sokra deleted the 02-25-conditionally_load_uncommon_paths branch March 3, 2026 10:19
lukesandberg pushed a commit that referenced this pull request Mar 4, 2026
## Summary

Follow-up to #90514 addressing review feedback from @lukesandberg:

- **Extract webpack layer helpers to `webpack-layer.ts`**: Moves `shouldUseReactServerCondition` and `isWebpackAppPagesLayer` out of the large `utils.ts` into their own module, reducing transitive dependencies pulled into `swc/options.ts` (reverts the revert from the previous PR)
- **Restore top-level import of `throwTurbopackInternalError`**: The lazy `require()` in `swc/index.ts` was unnecessary since `createProject` is always called — restores the simpler top-level import
- **Remove dead `getSupportedBrowsers` re-export from `utils.ts`**: All importers already import directly from `get-supported-browsers.ts`, so the re-export was unused
- **Extract `formatIssue` and `isRelevantWarning` to `format-issue.ts`**: Moves these functions (and their private helpers) out of the large `turbopack/utils.ts` into a dedicated module, so `print-build-errors.ts` doesn't pull in all of `turbopack/utils`

## Test plan

- `pnpm --filter=next types` passes
- Unit tests for `formatIssue` pass (`utils.test.ts` updated to import from new module)
- NFT test expectations updated for the changed module graph
sokra added a commit that referenced this pull request Mar 6, 2026
## Summary

Follow-up to #90514 addressing review feedback from @lukesandberg:

- **Extract webpack layer helpers to `webpack-layer.ts`**: Moves `shouldUseReactServerCondition` and `isWebpackAppPagesLayer` out of the large `utils.ts` into their own module, reducing transitive dependencies pulled into `swc/options.ts` (reverts the revert from the previous PR)
- **Restore top-level import of `throwTurbopackInternalError`**: The lazy `require()` in `swc/index.ts` was unnecessary since `createProject` is always called — restores the simpler top-level import
- **Remove dead `getSupportedBrowsers` re-export from `utils.ts`**: All importers already import directly from `get-supported-browsers.ts`, so the re-export was unused
- **Extract `formatIssue` and `isRelevantWarning` to `format-issue.ts`**: Moves these functions (and their private helpers) out of the large `turbopack/utils.ts` into a dedicated module, so `print-build-errors.ts` doesn't pull in all of `turbopack/utils`

## Test plan

- `pnpm --filter=next types` passes
- Unit tests for `formatIssue` pass (`utils.test.ts` updated to import from new module)
- NFT test expectations updated for the changed module graph
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants