@tristan2828/ui-foundation 4.27.0 → 4.29.0

package/dist/lib/stale-chunk-reload.js

@@ -0,0 +1,64 @@
+// After a deploy, a tab opened on the build before it still runs that
+// build, and its content-hashed chunks are gone from the server: the next
+// lazy import (the rich-text editor's, say) fails with "Failed to fetch
+// dynamically imported module" (#206). Vite's preload helper announces it
+// first as a cancelable `vite:preloadError` on `window`, for the package's
+// own lazy chunks too once the app's build bundles them. On it, the page
+// reloads once onto the new build, and the failure is not reported.
+//
+// Once, because a file missing from the new build too would reload
+// forever: the reload is remembered in sessionStorage, and a second
+// failure within `windowMs` of it is let through to the error boundary
+// (and reported, since that one is a real missing file). Where nothing
+// can be remembered, nothing reloads.
+//
+// createStaleChunkReload takes its storage, reload and clock, so the rules
+// are unit tested in node (tests/stale-chunk-reload.test.ts);
+// FoundationProviders installs the shared instance over the real ones.
+const KEY = 'ui-foundation:stale-chunk-reload';
+const WINDOW_MS = 60_000;
+export function createStaleChunkReload({ storage, reload, now = Date.now, windowMs = WINDOW_MS, }) {
+    let reloading = false;
+    const remember = () => {
+        try {
+            const store = storage();
+            if (!store)
+                return false;
+            const last = Number(store.getItem(KEY));
+            if (Number.isFinite(last) && last > 0 && now() - last < windowMs)
+                return false;
+            store.setItem(KEY, String(now()));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const onPreloadError = (event) => {
+        if (reloading) {
+            event.preventDefault();
+            return;
+        }
+        if (!remember())
+            return;
+        reloading = true;
+        event.preventDefault();
+        reload();
+    };
+    return {
+        isReloading: () => reloading,
+        install(target) {
+            target.addEventListener('vite:preloadError', onPreloadError);
+            return () => target.removeEventListener('vite:preloadError', onPreloadError);
+        },
+    };
+}
+let shared = null;
+/** The one instance over the real window, sessionStorage and reload. */
+export function browserStaleChunkReload() {
+    shared ??= createStaleChunkReload({
+        storage: () => (typeof sessionStorage === 'undefined' ? undefined : sessionStorage),
+        reload: () => window.location.reload(),
+    });
+    return shared;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tristan2828/ui-foundation",
-  "version": "4.27.0",
+  "version": "4.29.0",
   "description": "Shared UI foundation for contract-first, database-backed React apps: shadcn primitives, DataTable/EntityForm composites, auth, the gateway error seam, design tokens, lint rules and the AI playbook.",
   "license": "MIT",
   "repository": {