fix: show fallback for oversized package files

[anilloutombam]

🔗 Linked issue

Fixes #2732

🧭 Context

The package code browser remained in a loading state when the selected file exceeded the supported size limit. The page already had a fallback for oversized files, but it was never rendered because the skipped content request remained in the idle state and was still treated as loading.

The issue can be reproduced on the current production site:

https://npmx.dev/package-code/@types/vscode/v/1.118.0/index.d.ts

The updated behaviour can be verified on the PR preview:

https://npmx-h3s403v0g-npmx.vercel.app/package-code/@types/vscode/v/1.118.0/index.d.ts

📚 Description

I updated the loading-state logic so an oversized file no longer leaves the page waiting for a request that will not run. The existing large-file warning and “Open raw file” action are now displayed as intended.

I also added a regression test that covers the oversized-file path, verifies that the fallback is rendered, and confirms that the application does not request the file content.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
npmx.dev	Ready	Preview	Aug 3, 2026 8:11am

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs.npmx.dev	Ignored	Preview	Aug 3, 2026 8:11am
npmx-lunaria	Ignored		Aug 3, 2026 8:11am

[coderabbitai]

📝 Walkthrough

Summary by CodeRabbit

• Bug Fixes

  • Oversized package files now skip the loading state and display the raw-file fallback immediately.
  • Prevented unnecessary file-content requests for files exceeding the supported size limit.

• Tests

  • Added coverage confirming the fallback display, loading behaviour, request handling, and generated CDN URL for oversized files.

Walkthrough

Changes

Large file fallback

Layer / File(s)	Summary
Oversized file fallback and validation app/pages/package-code/.../[...filePath].vue, test/nuxt/pages/PackageCodePage.spec.ts	The page stops showing the loading state when a file exceeds MAX_FILE_SIZE. The integration test verifies the “File too large” fallback, avoids file-content fetching, and checks the jsDelivr raw-file URL.

Suggested reviewers: serhalp

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes address issue #2732 by rendering the oversized-file fallback and avoiding an unnecessary content request.
Out of Scope Changes check	✅ Passed	The changes are limited to the oversized-file loading fix and its regression test.
Title check	✅ Passed	The title clearly describes the main change: showing the fallback for oversized package files.
Description check	✅ Passed	The description explains the oversized-file loading issue, the fix, and the regression test.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[ghostdevv]

ty! The only issue I see currently is that it doesn't seem to work when navigating to it - e.g. if I go from README.md to index.d.ts it will show me this

And then when I refresh I correctly get

We can fix this in a follow up since it also happens on production