cursedbelt 5.12.0 → 5.12.1

package/dist/react/components/ErrorBoundary.d.ts

@@ -43,7 +43,16 @@ export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBo
  * rather than "the app is broken" or "the server is unreachable".
  */
 export declare function isStaleChunkError(error: unknown): boolean;
-/** Whether this tab has already tried reloading for this URL. Never throws. */
+/**
+ * Whether this tab already reloaded for a stale chunk inside the last minute — and
+ * true when storage is unavailable, so a reload loop is impossible in the one
+ * environment where we cannot remember trying. Never throws.
+ *
+ * 🔴 The memory is `lazyWithReload`'s (`../lazy/staleChunk.ts`), shared on purpose.
+ * Until 2026-09-27 this was its own flag, once per tab per URL FOREVER: a tab left
+ * open across a SECOND deploy — a film playing for hours — got "could not be
+ * loaded" instead of a reload, and the two guards could add up to two reloads.
+ */
 export declare function staleChunkReloadAttempted(): boolean;
 export interface StaleDeployHealerProps {
     /** The caught error, shown as detail when the reload has already been tried. */

package/dist/react/components/ErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/react/components/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAGvF,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAerG;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC,CAAC;IACxE,iEAAiE;IACjE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,qFAAqF;IACrF,SAAS,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B;;;kFAG8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;CACxC;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAQD,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAClF,KAAK,EAAE,kBAAkB,CAAmB;IAE5C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAItD,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAMlD,KAAK,QAAO,IAAI,CAEd;IAEF,MAAM,IAAI,SAAS;CA0BpB;AA4CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAMD,+EAA+E;AAC/E,wBAAgB,yBAAyB,IAAI,OAAO,CAQnD;AAUD,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,sBAAsB,sBAAsB,gCAsC7E,CAAC"}
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/react/components/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAIvF,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAerG;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC,CAAC;IACxE,iEAAiE;IACjE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,qFAAqF;IACrF,SAAS,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B;;;kFAG8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;CACxC;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAQD,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAClF,KAAK,EAAE,kBAAkB,CAAmB;IAE5C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAItD,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAMlD,KAAK,QAAO,IAAI,CAEd;IAEF,MAAM,IAAI,SAAS;CA0BpB;AA4CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAGnD;AAED,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,sBAAsB,sBAAsB,gCAqC7E,CAAC"}

package/dist/react/components/ErrorBoundary.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Component, useEffect, useState } from 'react';
 import { Alert } from './Alert.js';
 import { Spinner } from './Spinner.js';
+import { claimStaleChunkReload, staleChunkReloadedRecently } from '../lazy/staleChunk.js';
 import { ConnectionHealer, isUnreachableError } from './ConnectionHealer.js';
 const keysChanged = (a, b) => {
     if (!a || !b)
@@ -39,7 +40,7 @@ export class ErrorBoundary extends Component {
         // visualizer, the owner's report of 2026-08-22), and `isUnreachableError` matches
         // the substring `failed to fetch`, so `autoHeal` would have claimed the server was
         // unreachable while it answered every request. `StaleDeployHealer` reloads exactly
-        // once per tab per URL and explains itself if that does not help.
+        // once per tab per minute and explains itself if that does not help.
         if (isStaleChunkError(error))
             return _jsx(StaleDeployHealer, { error: error });
         if (autoHeal && isUnreachableError(error))
@@ -78,7 +79,7 @@ export class ErrorBoundary extends Component {
  * hashes, and the route loads. If the chunk is genuinely missing from the
  * deployed artifact rather than merely stale, reloading would loop — so the
  * attempt is recorded in `sessionStorage` and only ever made ONCE per tab per
- * URL. The second failure stops and says what is actually wrong, which is a
+ * minute (the memory `lazyWithReload` shares). The second failure stops and says what is actually wrong, which is a
  * broken deployment and a sentence the owner can act on.
  *
  * Since 2026-08-22 the origin answers a missing build asset with a 404 rather
@@ -102,26 +103,20 @@ export function isStaleChunkError(error) {
     const message = (error instanceof Error ? `${error.name} ${error.message}` : String(error)).toLowerCase();
     return STALE_CHUNK_PATTERNS.some((p) => message.includes(p));
 }
-/** One key per tab per URL — a reload that did not help must not be repeated. */
-const attemptKey = () => `cwip.staleChunkReload:${typeof window === 'undefined' ? '' : window.location.pathname}`;
-/** Whether this tab has already tried reloading for this URL. Never throws. */
+/**
+ * Whether this tab already reloaded for a stale chunk inside the last minute — and
+ * true when storage is unavailable, so a reload loop is impossible in the one
+ * environment where we cannot remember trying. Never throws.
+ *
+ * 🔴 The memory is `lazyWithReload`'s (`../lazy/staleChunk.ts`), shared on purpose.
+ * Until 2026-09-27 this was its own flag, once per tab per URL FOREVER: a tab left
+ * open across a SECOND deploy — a film playing for hours — got "could not be
+ * loaded" instead of a reload, and the two guards could add up to two reloads.
+ */
 export function staleChunkReloadAttempted() {
-    try {
-        return window.sessionStorage.getItem(attemptKey()) !== null;
-    }
-    catch {
-        // Private mode / disabled storage: treat as "already tried" so a reload loop
-        // is impossible in the one environment where we cannot remember trying.
+    if (typeof window === 'undefined')
         return true;
-    }
-}
-function markStaleChunkReload() {
-    try {
-        window.sessionStorage.setItem(attemptKey(), '1');
-    }
-    catch {
-        // Nothing to do — `staleChunkReloadAttempted` fails closed for the same reason.
-    }
+    return staleChunkReloadedRecently();
 }
 /**
  * Drop-in fallback for a stale-chunk error: reloads once, automatically, and if
@@ -134,11 +129,10 @@ export const StaleDeployHealer = ({ error, onRecover }) => {
     useEffect(() => {
         if (typeof window === 'undefined')
             return;
-        if (staleChunkReloadAttempted()) {
+        if (!claimStaleChunkReload()) {
             setExhausted(true);
             return;
         }
-        markStaleChunkReload();
         // A tick of delay so the banner paints first — an instant reload on a slow
         // connection reads as a flicker with no explanation.
         const timer = setTimeout(() => {

package/dist/react/components/ErrorBoundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../../src/react/components/ErrorBoundary.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../../src/react/components/ErrorBoundary.tsx"],"names":[],"mappings":"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"}

package/dist/react/lazy/staleChunk.d.ts

@@ -17,7 +17,15 @@
  * boundary, rather than reloading in a loop.
  *
  * The memory is `sessionStorage`, which is per tab AND per origin, so one generic
- * key serves every app without two of them ever reading each other's.
+ * key serves every app without two of them ever reading each other's. It is a TIME,
+ * not a flag: a tab left open across two deploys (a film playing for hours) heals
+ * both times. `ErrorBoundary`'s `StaleDeployHealer` reads and writes the same
+ * memory, so the two never add up to more than one reload a minute.
+ *
+ * 🔴 It fails CLOSED. Storage this tab cannot read or write (site data blocked)
+ * means no reload at all — the error goes to the boundary, which explains it —
+ * because a chunk genuinely missing from the deployed build would otherwise reload
+ * forever with nothing able to remember trying.
  *
  * `guardrailsEnforce`'s `no-raw-lazy` is the WHETHER: a bare `React.lazy` in an app
  * is refused, so the next lazy view cannot quietly reopen this.
@@ -31,6 +39,15 @@ export interface StaleChunkEnv {
     reload: () => void;
     now: () => number;
 }
+export declare function browserEnv(): StaleChunkEnv;
+/**
+ * Claim this tab's one stale-chunk reload for the window: true when a reload may
+ * happen now, and the claim is already recorded. False when one happened inside the
+ * window, or when the memory cannot be read or written — fail closed, see the header.
+ */
+export declare function claimStaleChunkReload(env?: StaleChunkEnv): boolean;
+/** Whether this tab reloaded for a stale chunk inside the window — true, too, when it cannot tell. */
+export declare function staleChunkReloadedRecently(env?: StaleChunkEnv): boolean;
 /** Wrap a dynamic `import()` so a chunk a deploy removed reloads the page instead of failing. */
 export declare function reloadOnStaleChunk<T>(load: () => Promise<T>, env?: () => StaleChunkEnv): () => Promise<T>;
 /**

package/dist/react/lazy/staleChunk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staleChunk.d.ts","sourceRoot":"","sources":["../../../src/react/lazy/staleChunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAQ,MAAM,OAAO,CAAC;AAE3E,eAAO,MAAM,2BAA2B,kCAAkC,CAAC;AAE3E,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IACrD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAYD,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,GAAG,GAAE,MAAM,aAA0B,GACpC,MAAM,OAAO,CAAC,CAAC,CAAC,CAsBlB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,EACzD,IAAI,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,EACnC,GAAG,CAAC,EAAE,MAAM,aAAa,GACxB,mBAAmB,CAAC,CAAC,CAAC,CAExB"}
+{"version":3,"file":"staleChunk.d.ts","sourceRoot":"","sources":["../../../src/react/lazy/staleChunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAQ,MAAM,OAAO,CAAC;AAE3E,eAAO,MAAM,2BAA2B,kCAAkC,CAAC;AAE3E,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IACrD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,IAAI,aAAa,CAQ1C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,aAA4B,GAAG,OAAO,CAShF;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,aAA4B,GAAG,OAAO,CASrF;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,GAAG,GAAE,MAAM,aAA0B,GACpC,MAAM,OAAO,CAAC,CAAC,CAAC,CAWlB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,EACzD,IAAI,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,EACnC,GAAG,CAAC,EAAE,MAAM,aAAa,GACxB,mBAAmB,CAAC,CAAC,CAAC,CAExB"}

package/dist/react/lazy/staleChunk.js

@@ -17,7 +17,15 @@
  * boundary, rather than reloading in a loop.
  *
  * The memory is `sessionStorage`, which is per tab AND per origin, so one generic
- * key serves every app without two of them ever reading each other's.
+ * key serves every app without two of them ever reading each other's. It is a TIME,
+ * not a flag: a tab left open across two deploys (a film playing for hours) heals
+ * both times. `ErrorBoundary`'s `StaleDeployHealer` reads and writes the same
+ * memory, so the two never add up to more than one reload a minute.
+ *
+ * 🔴 It fails CLOSED. Storage this tab cannot read or write (site data blocked)
+ * means no reload at all — the error goes to the boundary, which explains it —
+ * because a chunk genuinely missing from the deployed build would otherwise reload
+ * forever with nothing able to remember trying.
  *
  * `guardrailsEnforce`'s `no-raw-lazy` is the WHETHER: a bare `React.lazy` in an app
  * is refused, so the next lazy view cannot quietly reopen this.
@@ -26,16 +34,46 @@ import { lazy } from 'react';
 export const STALE_CHUNK_RELOADED_AT_KEY = 'cursedbelt.staleChunkReloadAt';
 /** A reload within this long of the last one is a loop, not a stale page. */
 export const STALE_CHUNK_RELOAD_WINDOW_MS = 60_000;
-function browserEnv() {
+export function browserEnv() {
     let storage = null;
     try {
         storage = window.sessionStorage;
     }
     catch {
-        // Storage refused (private mode, blocked site data) — reload without the guard's memory.
+        // Storage refused (blocked site data) — no memory, so no reload: the guard fails closed.
     }
     return { storage, reload: () => window.location.reload(), now: Date.now };
 }
+/**
+ * Claim this tab's one stale-chunk reload for the window: true when a reload may
+ * happen now, and the claim is already recorded. False when one happened inside the
+ * window, or when the memory cannot be read or written — fail closed, see the header.
+ */
+export function claimStaleChunkReload(env = browserEnv()) {
+    if (staleChunkReloadedRecently(env))
+        return false;
+    const stamp = String(env.now());
+    try {
+        env.storage?.setItem(STALE_CHUNK_RELOADED_AT_KEY, stamp);
+        return env.storage?.getItem(STALE_CHUNK_RELOADED_AT_KEY) === stamp;
+    }
+    catch {
+        return false;
+    }
+}
+/** Whether this tab reloaded for a stale chunk inside the window — true, too, when it cannot tell. */
+export function staleChunkReloadedRecently(env = browserEnv()) {
+    const { storage, now } = env;
+    if (!storage)
+        return true;
+    try {
+        const last = Number(storage.getItem(STALE_CHUNK_RELOADED_AT_KEY) ?? 0) || 0;
+        return last > 0 && now() - last < STALE_CHUNK_RELOAD_WINDOW_MS;
+    }
+    catch {
+        return true;
+    }
+}
 /** Wrap a dynamic `import()` so a chunk a deploy removed reloads the page instead of failing. */
 export function reloadOnStaleChunk(load, env = browserEnv) {
     return async () => {
@@ -43,23 +81,10 @@ export function reloadOnStaleChunk(load, env = browserEnv) {
             return await load();
         }
         catch (error) {
-            const { storage, reload, now } = env();
-            let last = 0;
-            try {
-                last = Number(storage?.getItem(STALE_CHUNK_RELOADED_AT_KEY) ?? 0) || 0;
-            }
-            catch {
-                // Unreadable memory is treated as no reload yet.
-            }
-            if (last > 0 && now() - last < STALE_CHUNK_RELOAD_WINDOW_MS)
+            const current = env();
+            if (!claimStaleChunkReload(current))
                 throw error;
-            try {
-                storage?.setItem(STALE_CHUNK_RELOADED_AT_KEY, String(now()));
-            }
-            catch {
-                // Unwritable: the reload still happens; the guard just cannot remember it.
-            }
-            reload();
+            current.reload();
             return new Promise(() => undefined);
         }
     };

package/dist/react/lazy/staleChunk.js.map

@@ -1 +1 @@
-{"version":3,"file":"staleChunk.js","sourceRoot":"","sources":["../../../src/react/lazy/staleChunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAgD,IAAI,EAAE,MAAM,OAAO,CAAC;AAE3E,MAAM,CAAC,MAAM,2BAA2B,GAAG,+BAA+B,CAAC;AAE3E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAQnD,SAAS,UAAU;IACjB,IAAI,OAAO,GAA6B,IAAI,CAAC;IAC7C,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,yFAAyF;IAC3F,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;AAC5E,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,kBAAkB,CAChC,IAAsB,EACtB,MAA2B,UAAU;IAErC,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YACvC,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YACzE,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;YACD,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,4BAA4B;gBAAE,MAAM,KAAK,CAAC;YACzE,IAAI,CAAC;gBACH,OAAO,EAAE,OAAO,CAAC,2BAA2B,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,2EAA2E;YAC7E,CAAC;YACD,MAAM,EAAE,CAAC;YACT,OAAO,IAAI,OAAO,CAAI,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAmC,EACnC,GAAyB;IAEzB,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"staleChunk.js","sourceRoot":"","sources":["../../../src/react/lazy/staleChunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAgD,IAAI,EAAE,MAAM,OAAO,CAAC;AAE3E,MAAM,CAAC,MAAM,2BAA2B,GAAG,+BAA+B,CAAC;AAE3E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAQnD,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,GAA6B,IAAI,CAAC;IAC7C,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,yFAAyF;IAC3F,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;AAC5E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAqB,UAAU,EAAE;IACrE,IAAI,0BAA0B,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,CAAC,KAAK,KAAK,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,0BAA0B,CAAC,MAAqB,UAAU,EAAE;IAC1E,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5E,OAAO,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,4BAA4B,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,kBAAkB,CAChC,IAAsB,EACtB,MAA2B,UAAU;IAErC,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC;gBAAE,MAAM,KAAK,CAAC;YACjD,OAAO,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,IAAI,OAAO,CAAI,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAmC,EACnC,GAAyB;IAEzB,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedbelt",
-	"version": "5.12.0",
+	"version": "5.12.1",
 	"license": "ISC",
 	"type": "module",
 	"description": "The React design system of the cursedbelt split — components, styles, theme. cursedbelt-core below it; server tier in cursedbelt-server.",

package/src/react/components/ErrorBoundary.tsx

@@ -1,6 +1,7 @@
 import { Component, type ErrorInfo, type ReactNode, useEffect, useState } from 'react';
 import { Alert } from './Alert.js';
 import { Spinner } from './Spinner.js';
+import { claimStaleChunkReload, staleChunkReloadedRecently } from '../lazy/staleChunk.js';
 import { ConnectionHealer, isUnreachableError, type ServerHealOptions } from './ConnectionHealer.js';
 
 /* ───────────────────────────────────────────────────────────────────────────
@@ -88,7 +89,7 @@ export class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundarySt
     // visualizer, the owner's report of 2026-08-22), and `isUnreachableError` matches
     // the substring `failed to fetch`, so `autoHeal` would have claimed the server was
     // unreachable while it answered every request. `StaleDeployHealer` reloads exactly
-    // once per tab per URL and explains itself if that does not help.
+    // once per tab per minute and explains itself if that does not help.
     if (isStaleChunkError(error)) return <StaleDeployHealer error={error} />;
     if (autoHeal && isUnreachableError(error))
       return <ConnectionHealer error={error} {...(autoHeal === true ? {} : autoHeal)} />;
@@ -129,7 +130,7 @@ export class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundarySt
  * hashes, and the route loads. If the chunk is genuinely missing from the
  * deployed artifact rather than merely stale, reloading would loop — so the
  * attempt is recorded in `sessionStorage` and only ever made ONCE per tab per
- * URL. The second failure stops and says what is actually wrong, which is a
+ * minute (the memory `lazyWithReload` shares). The second failure stops and says what is actually wrong, which is a
  * broken deployment and a sentence the owner can act on.
  *
  * Since 2026-08-22 the origin answers a missing build asset with a 404 rather
@@ -157,27 +158,19 @@ export function isStaleChunkError(error: unknown): boolean {
   return STALE_CHUNK_PATTERNS.some((p) => message.includes(p));
 }
 
-/** One key per tab per URL — a reload that did not help must not be repeated. */
-const attemptKey = (): string =>
-  `cwip.staleChunkReload:${typeof window === 'undefined' ? '' : window.location.pathname}`;
-
-/** Whether this tab has already tried reloading for this URL. Never throws. */
+/**
+ * Whether this tab already reloaded for a stale chunk inside the last minute — and
+ * true when storage is unavailable, so a reload loop is impossible in the one
+ * environment where we cannot remember trying. Never throws.
+ *
+ * 🔴 The memory is `lazyWithReload`'s (`../lazy/staleChunk.ts`), shared on purpose.
+ * Until 2026-09-27 this was its own flag, once per tab per URL FOREVER: a tab left
+ * open across a SECOND deploy — a film playing for hours — got "could not be
+ * loaded" instead of a reload, and the two guards could add up to two reloads.
+ */
 export function staleChunkReloadAttempted(): boolean {
-  try {
-    return window.sessionStorage.getItem(attemptKey()) !== null;
-  } catch {
-    // Private mode / disabled storage: treat as "already tried" so a reload loop
-    // is impossible in the one environment where we cannot remember trying.
-    return true;
-  }
-}
-
-function markStaleChunkReload(): void {
-  try {
-    window.sessionStorage.setItem(attemptKey(), '1');
-  } catch {
-    // Nothing to do — `staleChunkReloadAttempted` fails closed for the same reason.
-  }
+  if (typeof window === 'undefined') return true;
+  return staleChunkReloadedRecently();
 }
 
 export interface StaleDeployHealerProps {
@@ -198,11 +191,10 @@ export const StaleDeployHealer = ({ error, onRecover }: StaleDeployHealerProps)
 
   useEffect(() => {
     if (typeof window === 'undefined') return;
-    if (staleChunkReloadAttempted()) {
+    if (!claimStaleChunkReload()) {
       setExhausted(true);
       return;
     }
-    markStaleChunkReload();
     // A tick of delay so the banner paints first — an instant reload on a slow
     // connection reads as a flicker with no explanation.
     const timer = setTimeout(() => {

package/src/react/components/StaleDeployHealer.spec.tsx

@@ -1,5 +1,6 @@
-import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
+import { afterEach, beforeEach, describe, expect, spyOn, test } from 'bun:test';
 import { cleanup, render, screen, waitFor } from '@testing-library/react';
+import { STALE_CHUNK_RELOADED_AT_KEY } from '../lazy/staleChunk.js';
 import { ErrorBoundary, isStaleChunkError, StaleDeployHealer } from './ErrorBoundary.js';
 
 afterEach(() => {
@@ -105,3 +106,33 @@ describe('StaleDeployHealer recovers exactly once', () => {
     expect(screen.getByText(/VisualizerView-9pEZSQqW\.js/)).toBeTruthy();
   });
 });
+
+describe('StaleDeployHealer shares lazyWithReload\'s memory', () => {
+  /**
+   * 🔴 The old flag was once per tab per URL FOREVER, so a tab left open across a SECOND
+   * deploy — a film playing for hours — hit the dead end instead of reloading.
+   */
+  test('a tab open across two deploys heals both', async () => {
+    let recovered = 0;
+    const first = render(<StaleDeployHealer error={OWNERS_ERROR} onRecover={() => recovered++} />);
+    await waitFor(() => expect(recovered).toBe(1), { timeout: 2000 });
+    first.unmount();
+
+    const twoHoursLater = Date.now() + 2 * 60 * 60_000;
+    const clock = spyOn(Date, 'now').mockImplementation(() => twoHoursLater);
+    try {
+      render(<StaleDeployHealer error={OWNERS_ERROR} onRecover={() => recovered++} />);
+      await waitFor(() => expect(recovered).toBe(2), { timeout: 2000 });
+    } finally {
+      clock.mockRestore();
+    }
+  });
+
+  test('a reload lazyWithReload just made is not repeated by the boundary', async () => {
+    window.sessionStorage.setItem(STALE_CHUNK_RELOADED_AT_KEY, String(Date.now() - 1000));
+    let recovered = 0;
+    render(<StaleDeployHealer error={OWNERS_ERROR} onRecover={() => recovered++} />);
+    await waitFor(() => expect(screen.getByText(/could not be loaded/i)).toBeTruthy());
+    expect(recovered).toBe(0);
+  });
+});

package/src/react/lazy/staleChunk.spec.tsx

@@ -82,12 +82,31 @@ describe('a chunk a deploy removed', () => {
     expect(state.reloads).toBe(2);
   });
 
-  test('with no storage at all it still reloads rather than failing', async () => {
+  /*
+   * 🔴 Fail CLOSED. With no memory, a chunk genuinely missing from the deployed build
+   * would reload forever; the error goes to the boundary instead, which explains it.
+   */
+  test('with no storage it never reloads — the error goes to the boundary', async () => {
     const { state } = fakeEnv(1_000_000);
     const env: StaleChunkEnv = { storage: null, reload: () => void state.reloads++, now: () => 5 };
-    void reloadOnStaleChunk(gone, () => env)();
-    await tick();
-    expect(state.reloads).toBe(1);
+    await expect(reloadOnStaleChunk(gone, () => env)()).rejects.toThrow('dynamically imported');
+    expect(state.reloads).toBe(0);
+  });
+
+  test('storage that refuses a write is no memory either — no reload', async () => {
+    const { state } = fakeEnv(1_000_000);
+    const env: StaleChunkEnv = {
+      storage: {
+        getItem: () => null,
+        setItem: () => {
+          throw new DOMException('blocked', 'SecurityError');
+        },
+      },
+      reload: () => void state.reloads++,
+      now: () => 5,
+    };
+    await expect(reloadOnStaleChunk(gone, () => env)()).rejects.toThrow('dynamically imported');
+    expect(state.reloads).toBe(0);
   });
 });
 

package/src/react/lazy/staleChunk.ts

@@ -17,7 +17,15 @@
  * boundary, rather than reloading in a loop.
  *
  * The memory is `sessionStorage`, which is per tab AND per origin, so one generic
- * key serves every app without two of them ever reading each other's.
+ * key serves every app without two of them ever reading each other's. It is a TIME,
+ * not a flag: a tab left open across two deploys (a film playing for hours) heals
+ * both times. `ErrorBoundary`'s `StaleDeployHealer` reads and writes the same
+ * memory, so the two never add up to more than one reload a minute.
+ *
+ * 🔴 It fails CLOSED. Storage this tab cannot read or write (site data blocked)
+ * means no reload at all — the error goes to the boundary, which explains it —
+ * because a chunk genuinely missing from the deployed build would otherwise reload
+ * forever with nothing able to remember trying.
  *
  * `guardrailsEnforce`'s `no-raw-lazy` is the WHETHER: a bare `React.lazy` in an app
  * is refused, so the next lazy view cannot quietly reopen this.
@@ -35,16 +43,44 @@ export interface StaleChunkEnv {
   now: () => number;
 }
 
-function browserEnv(): StaleChunkEnv {
+export function browserEnv(): StaleChunkEnv {
   let storage: StaleChunkEnv['storage'] = null;
   try {
     storage = window.sessionStorage;
   } catch {
-    // Storage refused (private mode, blocked site data) — reload without the guard's memory.
+    // Storage refused (blocked site data) — no memory, so no reload: the guard fails closed.
   }
   return { storage, reload: () => window.location.reload(), now: Date.now };
 }
 
+/**
+ * Claim this tab's one stale-chunk reload for the window: true when a reload may
+ * happen now, and the claim is already recorded. False when one happened inside the
+ * window, or when the memory cannot be read or written — fail closed, see the header.
+ */
+export function claimStaleChunkReload(env: StaleChunkEnv = browserEnv()): boolean {
+  if (staleChunkReloadedRecently(env)) return false;
+  const stamp = String(env.now());
+  try {
+    env.storage?.setItem(STALE_CHUNK_RELOADED_AT_KEY, stamp);
+    return env.storage?.getItem(STALE_CHUNK_RELOADED_AT_KEY) === stamp;
+  } catch {
+    return false;
+  }
+}
+
+/** Whether this tab reloaded for a stale chunk inside the window — true, too, when it cannot tell. */
+export function staleChunkReloadedRecently(env: StaleChunkEnv = browserEnv()): boolean {
+  const { storage, now } = env;
+  if (!storage) return true;
+  try {
+    const last = Number(storage.getItem(STALE_CHUNK_RELOADED_AT_KEY) ?? 0) || 0;
+    return last > 0 && now() - last < STALE_CHUNK_RELOAD_WINDOW_MS;
+  } catch {
+    return true;
+  }
+}
+
 /** Wrap a dynamic `import()` so a chunk a deploy removed reloads the page instead of failing. */
 export function reloadOnStaleChunk<T>(
   load: () => Promise<T>,
@@ -54,20 +90,9 @@ export function reloadOnStaleChunk<T>(
     try {
       return await load();
     } catch (error) {
-      const { storage, reload, now } = env();
-      let last = 0;
-      try {
-        last = Number(storage?.getItem(STALE_CHUNK_RELOADED_AT_KEY) ?? 0) || 0;
-      } catch {
-        // Unreadable memory is treated as no reload yet.
-      }
-      if (last > 0 && now() - last < STALE_CHUNK_RELOAD_WINDOW_MS) throw error;
-      try {
-        storage?.setItem(STALE_CHUNK_RELOADED_AT_KEY, String(now()));
-      } catch {
-        // Unwritable: the reload still happens; the guard just cannot remember it.
-      }
-      reload();
+      const current = env();
+      if (!claimStaleChunkReload(current)) throw error;
+      current.reload();
       return new Promise<T>(() => undefined);
     }
   };