[lxsmnsyc]

Adds start.reloadOnChunkError, on by default. In a production build, the generated client entry reloads the page once when a code-split chunk fails to load, as it does when a deploy replaced the chunk while the page was open. It is the counterpart of SolidStart's reloadOnRouteChunkError.

Changes

• The generated client entry listens for Vite's vite:preloadError event. Vite fires it when a dynamic import or one of its preloaded files fails.
• A second failure within 10 seconds of the reload does not reload again, so a chunk that is still missing shows the normal error instead of reloading in a loop. The last reload time is kept in sessionStorage. Without storage the page never reloads. This matches SolidStart's guard.
• A listener that calls event.preventDefault() skips the reload. The listener is added in the entry body, so one from start.clientSetup runs first.
• The listener never calls preventDefault() itself, so the failed import still rejects and the app's own error handling runs.
• It applies to production builds with a generated client entry, in both start modes. Dev output and authored entries are unchanged.
• README: a new reloadOnChunkError section. The clientSetup example no longer shows a hand-written reload listener.

Difference from SolidStart

SolidStart wraps each route's import and returns an empty component, so the router finishes the navigation and the page reloads at the destination URL. The plugin has no router, so it listens for the global event instead. The page reloads at the current URL.

Testing

• New chunk-reload mode in examples/start-ssr/test/run.mjs, 9 assertions. It builds the app, opens it in headless Chrome, deletes the chunk a button loads, and checks:
  • the first failure reloads the page and stamps sessionStorage,
  • a second failure within the window rejects without reloading,
  • with the chunk back, the import works and nothing reloads,
  • with reloadOnChunkError: false, no chunk carries the listener and a failure does not reload,
  • the dev client entry has no listener.
• The prod (77) and client-setup (20) modes of examples/start-ssr and the examples/start-client suite (70) still pass.
• vitest run passes.

The test app awaits the import instead of chaining .then(onLoad, onError). Vite wraps a chained .then() in its preload helper too, so that rejection handler would catch the error before the event fires. lazy(() => import(...)) is not affected.

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 228106e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@solidjs/vite-plugin	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@solidjs/vite-plugin@465

commit: 228106e