@gusnips/react 0.5.0 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusnips/react",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "The headless runtime under a Vite + React SPA: typed fetch client with single-flight refresh, auth store, query defaults, route guards, error boundary, stale-tab recovery, i18n bootstrap.",
   "type": "module",
   "license": "MIT",
@@ -60,7 +60,7 @@
     "headless"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist && tsc",
     "typecheck": "tsc --noEmit",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",

package/dist/chunk-reload.d.ts

@@ -1,61 +0,0 @@
-/**
- * Surviving a deploy that lands while a tab is open.
- *
- * Every app on this stack is a Vite SPA with `lazy()` routes, deployed on push. When a build
- * replaces the one a tab is running, the next navigation asks for a chunk whose hashed name no
- * longer exists — and a static host answers a missing asset with the SPA fallback, so the
- * import gets HTML where it expected a module. React's lazy boundary throws, and the person
- * gets a white screen on a click that worked a minute ago.
- *
- * One repo in the fleet had all of this. The others had none of it, and none of them knew.
- */
-/**
- * A lazy-chunk fetch failure — recoverable by reloading.
- *
- * Matched by message because no browser gives it a shared type. Every phrasing in the wild is
- * here: Chrome/Edge "Failed to fetch dynamically imported module", Firefox "error loading
- * dynamically imported module", Safari "Importing a module script failed", webpack's
- * ChunkLoadError and "Loading chunk N failed", and the SPA-fallback "MIME type" refusal —
- * which is the one that actually fires on a static host, because the missing `.js` is answered
- * with `index.html`.
- *
- * A standalone predicate rather than a method on the boundary, so a global `unhandledrejection`
- * handler can classify the same failure without importing a component.
- */
-export declare function isChunkLoadError(error: unknown): boolean;
-/**
- * Hard-reload once to pick up the fresh deploy. Returns false when the guard suppressed it.
- *
- * The guard is the part that matters. Reloading on a chunk error is obvious; reloading on a
- * chunk error that the reload does not fix is an infinite loop with the user inside it. At most
- * one reload per minute, so a genuinely missing chunk degrades to the error UI — which can at
- * least say something — instead of flickering forever.
- *
- * `sessionStorage` and not `localStorage`: the guard is about this tab's current predicament,
- * and a stale flag in another tab must not suppress a reload this one needs. Wrapped because
- * storage throws outright when site data is blocked, and a privacy setting must not be the
- * reason somebody cannot recover.
- */
-export declare function reloadOnceForChunkError(): boolean;
-/**
- * Vite's *hint* failure, which is not the same thing and must not be treated as one.
- *
- * Vite injects a speculative `<link rel="stylesheet">` for a chunk's CSS before importing it.
- * When that link fails, the import itself still runs right after and usually succeeds — so this
- * one is worth swallowing, where a failure of the import is the real thing
- * {@link isChunkLoadError} matches. Vite builds this message in exactly one place and only ever
- * for a stylesheet link; script hints never reject.
- */
-export declare function isPreloadHintFailure(error: unknown): boolean;
-/**
- * Install the `vite:preloadError` listener. Call once, from the browser entry.
- *
- * Vite offers `preventDefault()` here so an app can own a failed asset itself — but taking that
- * deal unconditionally resolves the dynamic import with `undefined` (Vite's helper ends in
- * `baseModule().catch(handlePreloadError)`), and `React.lazy` then reads `.default` off nothing.
- * The user gets the crash screen and the developer gets a TypeError with only React frames in
- * it, naming no chunk. So it is taken ONLY for a failed preload hint, where the import still
- * runs. A real module failure is left to throw, where the error boundary can recognise it.
- */
-export declare function installPreloadErrorHandler(): void;
-//# sourceMappingURL=chunk-reload.d.ts.map

package/dist/chunk-reload.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk-reload.d.ts","sourceRoot":"","sources":["../src/chunk-reload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAWjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAKjD"}

package/dist/chunk-reload.js

@@ -1,92 +0,0 @@
-/**
- * Surviving a deploy that lands while a tab is open.
- *
- * Every app on this stack is a Vite SPA with `lazy()` routes, deployed on push. When a build
- * replaces the one a tab is running, the next navigation asks for a chunk whose hashed name no
- * longer exists — and a static host answers a missing asset with the SPA fallback, so the
- * import gets HTML where it expected a module. React's lazy boundary throws, and the person
- * gets a white screen on a click that worked a minute ago.
- *
- * One repo in the fleet had all of this. The others had none of it, and none of them knew.
- */
-const RELOAD_FLAG_KEY = "frontkit:chunk-reload-at";
-const RELOAD_WINDOW_MS = 60_000;
-/**
- * A lazy-chunk fetch failure — recoverable by reloading.
- *
- * Matched by message because no browser gives it a shared type. Every phrasing in the wild is
- * here: Chrome/Edge "Failed to fetch dynamically imported module", Firefox "error loading
- * dynamically imported module", Safari "Importing a module script failed", webpack's
- * ChunkLoadError and "Loading chunk N failed", and the SPA-fallback "MIME type" refusal —
- * which is the one that actually fires on a static host, because the missing `.js` is answered
- * with `index.html`.
- *
- * A standalone predicate rather than a method on the boundary, so a global `unhandledrejection`
- * handler can classify the same failure without importing a component.
- */
-export function isChunkLoadError(error) {
-    if (error instanceof Error && error.name === "ChunkLoadError")
-        return true;
-    const message = (error instanceof Error ? error.message : String(error) || "").toLowerCase();
-    return (message.includes("dynamically imported module") ||
-        message.includes("importing a module script failed") ||
-        message.includes("mime type") ||
-        message.includes("loading chunk"));
-}
-/**
- * Hard-reload once to pick up the fresh deploy. Returns false when the guard suppressed it.
- *
- * The guard is the part that matters. Reloading on a chunk error is obvious; reloading on a
- * chunk error that the reload does not fix is an infinite loop with the user inside it. At most
- * one reload per minute, so a genuinely missing chunk degrades to the error UI — which can at
- * least say something — instead of flickering forever.
- *
- * `sessionStorage` and not `localStorage`: the guard is about this tab's current predicament,
- * and a stale flag in another tab must not suppress a reload this one needs. Wrapped because
- * storage throws outright when site data is blocked, and a privacy setting must not be the
- * reason somebody cannot recover.
- */
-export function reloadOnceForChunkError() {
-    const now = Date.now();
-    try {
-        const last = Number(sessionStorage.getItem(RELOAD_FLAG_KEY) ?? 0);
-        if (now - last < RELOAD_WINDOW_MS)
-            return false;
-        sessionStorage.setItem(RELOAD_FLAG_KEY, String(now));
-    }
-    catch {
-        // Storage blocked — proceed with the reload rather than refusing to recover.
-    }
-    window.location.reload();
-    return true;
-}
-/**
- * Vite's *hint* failure, which is not the same thing and must not be treated as one.
- *
- * Vite injects a speculative `<link rel="stylesheet">` for a chunk's CSS before importing it.
- * When that link fails, the import itself still runs right after and usually succeeds — so this
- * one is worth swallowing, where a failure of the import is the real thing
- * {@link isChunkLoadError} matches. Vite builds this message in exactly one place and only ever
- * for a stylesheet link; script hints never reject.
- */
-export function isPreloadHintFailure(error) {
-    return error instanceof Error && error.message.startsWith("Unable to preload CSS for");
-}
-/**
- * Install the `vite:preloadError` listener. Call once, from the browser entry.
- *
- * Vite offers `preventDefault()` here so an app can own a failed asset itself — but taking that
- * deal unconditionally resolves the dynamic import with `undefined` (Vite's helper ends in
- * `baseModule().catch(handlePreloadError)`), and `React.lazy` then reads `.default` off nothing.
- * The user gets the crash screen and the developer gets a TypeError with only React frames in
- * it, naming no chunk. So it is taken ONLY for a failed preload hint, where the import still
- * runs. A real module failure is left to throw, where the error boundary can recognise it.
- */
-export function installPreloadErrorHandler() {
-    window.addEventListener("vite:preloadError", (event) => {
-        const payload = event.payload;
-        if (isPreloadHintFailure(payload))
-            event.preventDefault();
-    });
-}
-//# sourceMappingURL=chunk-reload.js.map

package/dist/chunk-reload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk-reload.js","sourceRoot":"","sources":["../src/chunk-reload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAC3E,MAAM,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7F,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC/C,OAAO,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAClC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,IAAI,GAAG,GAAG,IAAI,GAAG,gBAAgB;YAAE,OAAO,KAAK,CAAC;QAChD,cAAc,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC;AACzF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;QACrD,MAAM,OAAO,GAAI,KAAuC,CAAC,OAAO,CAAC;QACjE,IAAI,oBAAoB,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,cAAc,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC"}