fix: replace HMR with full page reload to avoid ghost listeners and duplicate render loop

Author: KilledByAPixel

examples/vite-starter/src/main.js

@@ -28,9 +28,5 @@ function gameRenderPost() {
 }
 
 // tiles.png lives in public/, served from the site root in dev and build
+// (on save, the vite config forces a full page reload instead of HMR)
 engineInit(gameInit, gameUpdate, gameUpdatePost, gameRender, gameRenderPost, ['tiles.png']);
-
-// LittleJS owns global engine state (canvas, WebGL, input, RAF loop), so
-// partial HMR would leave ghost listeners and a duplicate render loop.
-// Force a full page reload on every save instead.
-if (import.meta.hot) import.meta.hot.accept(() => location.reload());

examples/vite-starter/vite.config.js

@@ -6,4 +6,20 @@ export default defineConfig({
     // (GitHub Pages project sites, itch.io uploads, etc.). Set to '/' if
     // deploying to a domain root.
     base: './',
+    plugins: [
+        {
+            // LittleJS owns global engine state (canvas, WebGL, input, RAF
+            // loop), so partial HMR would leave ghost listeners and a
+            // duplicate render loop. Replace HMR with a full page reload.
+            name: 'littlejs-full-reload',
+            handleHotUpdate({ server, modules, timestamp }) {
+                // invalidate manually since returning [] skips normal HMR
+                const invalidatedModules = new Set();
+                for (const mod of modules)
+                    server.moduleGraph.invalidateModule(mod, invalidatedModules, timestamp, true);
+                server.ws.send({ type: 'full-reload' });
+                return [];
+            },
+        },
+    ],
 });