@flipdish/ui-library 0.11.12 → 0.12.1

package/dist/utilities/renderUtils/index.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var React = require('react');
+var importWithRetry_utils = require('./importWithRetry.utils.cjs');
 
 /**
  * Retrieves an environment variable.
@@ -91,26 +92,7 @@ const getIsFlipdishStaff = () => {
     return stringValue?.toString() === 'true';
 };
 // biome-ignore lint/suspicious/noExplicitAny: dynamic import factory shape isn't expressible without `any`; preserved from portal-library implementation
-const lazyWithRetry = (componentImport) => React.lazy(async () => {
-    const pageHasAlreadyBeenForceRefreshed = JSON.parse(window.sessionStorage.getItem('page-has-been-force-refreshed') || 'false');
-    try {
-        const component = await componentImport();
-        window.sessionStorage.setItem('page-has-been-force-refreshed', 'false');
-        return component;
-    }
-    catch (error) {
-        if (!pageHasAlreadyBeenForceRefreshed) {
-            // Assuming that the user is not on the latest version of the application.
-            // Let's refresh the page immediately.
-            window.sessionStorage.setItem('page-has-been-force-refreshed', 'true');
-            return window.location.reload();
-        }
-        // The page has already been reloaded
-        // Assuming that user is already using the latest version of the application.
-        // Let's let the application crash and raise the error.
-        throw error;
-    }
-});
+const lazyWithRetry = (componentImport) => React.lazy(() => importWithRetry_utils.importWithRetry(componentImport));
 
 exports.getAppId = getAppId;
 exports.getBrandId = getBrandId;

package/dist/utilities/renderUtils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":["lazy"],"mappings":";;;;AAEA;;;;;AAKG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;AAKA,IAAA,IAAI;;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAqD;AAC1F,QAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;IAC7B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACF;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KACtDA,UAAI,CAAC,YAAW;AACd,IAAA,MAAM,gCAAgC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,CAAC,IAAI,OAAO,CAAC;AAE9H,IAAA,IAAI;AACF,QAAA,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE;QACzC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,OAAO,CAAC;AAEvE,QAAA,OAAO,SAAS;IAClB;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,gCAAgC,EAAE;;;YAGrC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,MAAM,CAAC;AACtE,YAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QACjC;;;;AAKA,QAAA,MAAM,KAAK;IACb;AACF,CAAC;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":["lazy","importWithRetry"],"mappings":";;;;;AAIA;;;;;AAKG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;AAKA,IAAA,IAAI;;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAqD;AAC1F,QAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;IAC7B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACF;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KAAKA,UAAI,CAAC,MAAMC,qCAAe,CAAC,eAAe,CAAC;;;;;;;;;;"}

package/dist/utilities/renderUtils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/renderUtils/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAgBpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MAMvD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,QAAO,MAE7B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAMrC,CAAC;AAGF,eAAO,MAAM,aAAa,GAAI,iBAAiB,MAAM,GAAG,4EAsBpD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/renderUtils/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAgBpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MAMvD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,QAAO,MAE7B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAMrC,CAAC;AAGF,eAAO,MAAM,aAAa,GAAI,iBAAiB,MAAM,GAAG,4EAAiD,CAAC"}

package/dist/utilities/renderUtils/index.js

@@ -1,4 +1,5 @@
 import { lazy } from 'react';
+import { importWithRetry } from './importWithRetry.utils.js';
 
 /**
  * Retrieves an environment variable.
@@ -89,26 +90,7 @@ const getIsFlipdishStaff = () => {
     return stringValue?.toString() === 'true';
 };
 // biome-ignore lint/suspicious/noExplicitAny: dynamic import factory shape isn't expressible without `any`; preserved from portal-library implementation
-const lazyWithRetry = (componentImport) => lazy(async () => {
-    const pageHasAlreadyBeenForceRefreshed = JSON.parse(window.sessionStorage.getItem('page-has-been-force-refreshed') || 'false');
-    try {
-        const component = await componentImport();
-        window.sessionStorage.setItem('page-has-been-force-refreshed', 'false');
-        return component;
-    }
-    catch (error) {
-        if (!pageHasAlreadyBeenForceRefreshed) {
-            // Assuming that the user is not on the latest version of the application.
-            // Let's refresh the page immediately.
-            window.sessionStorage.setItem('page-has-been-force-refreshed', 'true');
-            return window.location.reload();
-        }
-        // The page has already been reloaded
-        // Assuming that user is already using the latest version of the application.
-        // Let's let the application crash and raise the error.
-        throw error;
-    }
-});
+const lazyWithRetry = (componentImport) => lazy(() => importWithRetry(componentImport));
 
 export { getAppId, getBrandId, getEnvironmentVariable, getIsFlipdishStaff, getMicroFrontendAttribute, getOrgId, lazyWithRetry };
 //# sourceMappingURL=index.js.map

package/dist/utilities/renderUtils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;AAKG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;AAKA,IAAA,IAAI;;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAqD;AAC1F,QAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;IAC7B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACF;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KACtD,IAAI,CAAC,YAAW;AACd,IAAA,MAAM,gCAAgC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,CAAC,IAAI,OAAO,CAAC;AAE9H,IAAA,IAAI;AACF,QAAA,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE;QACzC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,OAAO,CAAC;AAEvE,QAAA,OAAO,SAAS;IAClB;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,gCAAgC,EAAE;;;YAGrC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,MAAM,CAAC;AACtE,YAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QACjC;;;;AAKA,QAAA,MAAM,KAAK;IACb;AACF,CAAC;;;;"}
+{"version":3,"file":"index.js","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAIA;;;;;AAKG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;AAKA,IAAA,IAAI;;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAqD;AAC1F,QAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;IAC7B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACF;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KAAK,IAAI,CAAC,MAAM,eAAe,CAAC,eAAe,CAAC;;;;"}

package/dist/utilities/sessionStorageUtils/index.cjs

@@ -0,0 +1,132 @@
+'use strict';
+
+var sessionStorageUtils_constants = require('./sessionStorageUtils.constants.cjs');
+
+/**
+ * Web-only, typed `sessionStorage` persistence. DOM access (`window.sessionStorage`)
+ * lives here rather than in components, so component code stays free of `window.*`
+ * and keeps React Native parity — this is the `sessionStorage` counterpart of
+ * `localStorageUtils` (same isolation pattern). Every helper no-ops / returns
+ * `null` when `sessionStorage` is unavailable (SSR, React Native, private mode,
+ * quota errors).
+ *
+ * Every key this package persists is registered in `sessionStorageUtils.constants.ts`
+ * — check there for the full list before adding a new one.
+ */
+const isBrowser = typeof window !== 'undefined';
+/**
+ * Internal `sessionStorage` primitives backing `createSessionStorageItem`. Not
+ * exported — everything a consumer needs goes through `createSessionStorageItem`,
+ * which adds typed serialization/validation on top. Add a raw string export
+ * here only once a real caller needs plain-string storage without JSON typing.
+ */
+/** Read a raw string value, or `null` when unset/unavailable. */
+const safeSessionGet = (key) => {
+    if (!isBrowser)
+        return null;
+    try {
+        return window.sessionStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+};
+/** Persist a raw string value; returns whether the write succeeded. */
+const safeSessionSet = (key, value) => {
+    if (!isBrowser)
+        return false;
+    try {
+        window.sessionStorage.setItem(key, value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** Remove a value; returns whether the removal succeeded. */
+const safeSessionRemove = (key) => {
+    if (!isBrowser)
+        return false;
+    try {
+        window.sessionStorage.removeItem(key);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Reusable `validate` guard for a `createSessionStorageItem<boolean>` item.
+ */
+const isBoolean = (value) => typeof value === 'boolean';
+/**
+ * Parse a plain `'true'`/`'false'` string (not JSON) into a boolean; throws
+ * `errorMessage` for anything else so `createSessionStorageItem.get()` treats it
+ * as invalid data and returns `null`.
+ */
+const parseBooleanString = (raw, errorMessage) => {
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    throw new Error(errorMessage);
+};
+/**
+ * Build a typed, failure-safe accessor for a single `sessionStorage` key.
+ *
+ * @example
+ * const draft = createSessionStorageItem<Draft>('fd-draft');
+ * draft.set({ title: 'Hi' });
+ * const value = draft.get(); // Draft | null
+ */
+const createSessionStorageItem = (key, options = {}) => {
+    const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
+    return {
+        get() {
+            const raw = safeSessionGet(key);
+            if (raw == null)
+                return null;
+            try {
+                const value = deserialize(raw);
+                if (validate && !validate(value))
+                    return null;
+                return value;
+            }
+            catch {
+                return null;
+            }
+        },
+        set(value) {
+            try {
+                const serialized = serialize(value);
+                // JSON.stringify (and a custom serializer) can return `undefined` for a
+                // top-level `undefined`, function, or symbol — treat that as a failed
+                // serialization rather than writing the literal string "undefined".
+                if (typeof serialized !== 'string')
+                    return;
+                safeSessionSet(key, serialized);
+            }
+            catch {
+                // serialize() can throw (e.g. circular refs); matches the documented
+                // failure-safe contract — silently ignore, same as a write failure.
+            }
+        },
+        clear() {
+            safeSessionRemove(key);
+        },
+    };
+};
+/**
+ * Persistence for `lazyWithRetry`'s force-refresh-once marker. Stored as the
+ * plain strings `'true'` / `'false'` to preserve the original portal-library format.
+ */
+const pageForceRefreshedStorage = createSessionStorageItem(sessionStorageUtils_constants.SESSION_STORAGE_KEYS.pageHasBeenForceRefreshed, {
+    serialize: String,
+    deserialize: (raw) => parseBooleanString(raw, 'Invalid page-force-refreshed value'),
+    validate: isBoolean,
+});
+
+exports.SESSION_STORAGE_KEYS = sessionStorageUtils_constants.SESSION_STORAGE_KEYS;
+exports.createSessionStorageItem = createSessionStorageItem;
+exports.pageForceRefreshedStorage = pageForceRefreshedStorage;
+//# sourceMappingURL=index.cjs.map

package/dist/utilities/sessionStorageUtils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"sourcesContent":[null],"names":["SESSION_STORAGE_KEYS"],"mappings":"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"}

package/dist/utilities/sessionStorageUtils/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Web-only, typed `sessionStorage` persistence. DOM access (`window.sessionStorage`)
+ * lives here rather than in components, so component code stays free of `window.*`
+ * and keeps React Native parity — this is the `sessionStorage` counterpart of
+ * `localStorageUtils` (same isolation pattern). Every helper no-ops / returns
+ * `null` when `sessionStorage` is unavailable (SSR, React Native, private mode,
+ * quota errors).
+ *
+ * Every key this package persists is registered in `sessionStorageUtils.constants.ts`
+ * — check there for the full list before adding a new one.
+ */
+import { SESSION_STORAGE_KEYS } from './sessionStorageUtils.constants';
+export { SESSION_STORAGE_KEYS };
+export interface SessionStorageItem<T> {
+    /** Read and deserialize the value, or `null` when unset/invalid/unavailable. */
+    get(): T | null;
+    /** Serialize and persist the value; silently ignores write failures. */
+    set(value: T): void;
+    /** Remove the value; silently ignores failures. */
+    clear(): void;
+}
+export interface SessionStorageItemOptions<T> {
+    /** Serialize before writing. Defaults to `JSON.stringify`. */
+    serialize?: (value: T) => string;
+    /** Deserialize after reading. Defaults to `JSON.parse`. */
+    deserialize?: (raw: string) => T;
+    /** Optional runtime guard; `get()` returns `null` when it fails. */
+    validate?: (value: unknown) => value is T;
+}
+/**
+ * Build a typed, failure-safe accessor for a single `sessionStorage` key.
+ *
+ * @example
+ * const draft = createSessionStorageItem<Draft>('fd-draft');
+ * draft.set({ title: 'Hi' });
+ * const value = draft.get(); // Draft | null
+ */
+export declare const createSessionStorageItem: <T>(key: string, options?: SessionStorageItemOptions<T>) => SessionStorageItem<T>;
+/**
+ * Persistence for `lazyWithRetry`'s force-refresh-once marker. Stored as the
+ * plain strings `'true'` / `'false'` to preserve the original portal-library format.
+ */
+export declare const pageForceRefreshedStorage: SessionStorageItem<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/utilities/sessionStorageUtils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AA2ChC,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,gFAAgF;IAChF,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChB,wEAAwE;IACxE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;CAC3C;AAkBD;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,yBAAyB,CAAC,CAAC,CAAM,KAAG,kBAAkB,CAAC,CAAC,CAgCzH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,6BAIpC,CAAC"}

package/dist/utilities/sessionStorageUtils/index.js

@@ -0,0 +1,128 @@
+import { SESSION_STORAGE_KEYS } from './sessionStorageUtils.constants.js';
+
+/**
+ * Web-only, typed `sessionStorage` persistence. DOM access (`window.sessionStorage`)
+ * lives here rather than in components, so component code stays free of `window.*`
+ * and keeps React Native parity — this is the `sessionStorage` counterpart of
+ * `localStorageUtils` (same isolation pattern). Every helper no-ops / returns
+ * `null` when `sessionStorage` is unavailable (SSR, React Native, private mode,
+ * quota errors).
+ *
+ * Every key this package persists is registered in `sessionStorageUtils.constants.ts`
+ * — check there for the full list before adding a new one.
+ */
+const isBrowser = typeof window !== 'undefined';
+/**
+ * Internal `sessionStorage` primitives backing `createSessionStorageItem`. Not
+ * exported — everything a consumer needs goes through `createSessionStorageItem`,
+ * which adds typed serialization/validation on top. Add a raw string export
+ * here only once a real caller needs plain-string storage without JSON typing.
+ */
+/** Read a raw string value, or `null` when unset/unavailable. */
+const safeSessionGet = (key) => {
+    if (!isBrowser)
+        return null;
+    try {
+        return window.sessionStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+};
+/** Persist a raw string value; returns whether the write succeeded. */
+const safeSessionSet = (key, value) => {
+    if (!isBrowser)
+        return false;
+    try {
+        window.sessionStorage.setItem(key, value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** Remove a value; returns whether the removal succeeded. */
+const safeSessionRemove = (key) => {
+    if (!isBrowser)
+        return false;
+    try {
+        window.sessionStorage.removeItem(key);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Reusable `validate` guard for a `createSessionStorageItem<boolean>` item.
+ */
+const isBoolean = (value) => typeof value === 'boolean';
+/**
+ * Parse a plain `'true'`/`'false'` string (not JSON) into a boolean; throws
+ * `errorMessage` for anything else so `createSessionStorageItem.get()` treats it
+ * as invalid data and returns `null`.
+ */
+const parseBooleanString = (raw, errorMessage) => {
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    throw new Error(errorMessage);
+};
+/**
+ * Build a typed, failure-safe accessor for a single `sessionStorage` key.
+ *
+ * @example
+ * const draft = createSessionStorageItem<Draft>('fd-draft');
+ * draft.set({ title: 'Hi' });
+ * const value = draft.get(); // Draft | null
+ */
+const createSessionStorageItem = (key, options = {}) => {
+    const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
+    return {
+        get() {
+            const raw = safeSessionGet(key);
+            if (raw == null)
+                return null;
+            try {
+                const value = deserialize(raw);
+                if (validate && !validate(value))
+                    return null;
+                return value;
+            }
+            catch {
+                return null;
+            }
+        },
+        set(value) {
+            try {
+                const serialized = serialize(value);
+                // JSON.stringify (and a custom serializer) can return `undefined` for a
+                // top-level `undefined`, function, or symbol — treat that as a failed
+                // serialization rather than writing the literal string "undefined".
+                if (typeof serialized !== 'string')
+                    return;
+                safeSessionSet(key, serialized);
+            }
+            catch {
+                // serialize() can throw (e.g. circular refs); matches the documented
+                // failure-safe contract — silently ignore, same as a write failure.
+            }
+        },
+        clear() {
+            safeSessionRemove(key);
+        },
+    };
+};
+/**
+ * Persistence for `lazyWithRetry`'s force-refresh-once marker. Stored as the
+ * plain strings `'true'` / `'false'` to preserve the original portal-library format.
+ */
+const pageForceRefreshedStorage = createSessionStorageItem(SESSION_STORAGE_KEYS.pageHasBeenForceRefreshed, {
+    serialize: String,
+    deserialize: (raw) => parseBooleanString(raw, 'Invalid page-force-refreshed value'),
+    validate: isBoolean,
+});
+
+export { SESSION_STORAGE_KEYS, createSessionStorageItem, pageForceRefreshedStorage };
+//# sourceMappingURL=index.js.map

package/dist/utilities/sessionStorageUtils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/utilities/sessionStorageUtils/sessionStorageUtils.constants.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+/**
+ * Central registry of every `sessionStorage` key `@flipdish/ui-library` writes.
+ * Add a new key here whenever a component needs to persist per-tab state via
+ * `createSessionStorageItem` (see `index.ts`), so this file stays the single
+ * place to see everything the library puts in `sessionStorage`.
+ */
+const SESSION_STORAGE_KEYS = {
+    /** `lazyWithRetry`'s force-refresh-once marker (key name preserved from the portal-library implementation). */
+    pageHasBeenForceRefreshed: 'fd-page-has-been-force-refreshed',
+};
+
+exports.SESSION_STORAGE_KEYS = SESSION_STORAGE_KEYS;
+//# sourceMappingURL=sessionStorageUtils.constants.cjs.map

package/dist/utilities/sessionStorageUtils/sessionStorageUtils.constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStorageUtils.constants.cjs","sources":["../../../src/utilities/sessionStorageUtils/sessionStorageUtils.constants.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AACI,MAAM,oBAAoB,GAAG;;AAElC,IAAA,yBAAyB,EAAE,kCAAkC;;;;;"}

package/dist/utilities/sessionStorageUtils/sessionStorageUtils.constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Central registry of every `sessionStorage` key `@flipdish/ui-library` writes.
+ * Add a new key here whenever a component needs to persist per-tab state via
+ * `createSessionStorageItem` (see `index.ts`), so this file stays the single
+ * place to see everything the library puts in `sessionStorage`.
+ */
+export declare const SESSION_STORAGE_KEYS: {
+    /** `lazyWithRetry`'s force-refresh-once marker (key name preserved from the portal-library implementation). */
+    readonly pageHasBeenForceRefreshed: "fd-page-has-been-force-refreshed";
+};
+//# sourceMappingURL=sessionStorageUtils.constants.d.ts.map

package/dist/utilities/sessionStorageUtils/sessionStorageUtils.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStorageUtils.constants.d.ts","sourceRoot":"","sources":["../../../src/utilities/sessionStorageUtils/sessionStorageUtils.constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;IAC/B,+GAA+G;;CAEvG,CAAC"}

package/dist/utilities/sessionStorageUtils/sessionStorageUtils.constants.js

@@ -0,0 +1,13 @@
+/**
+ * Central registry of every `sessionStorage` key `@flipdish/ui-library` writes.
+ * Add a new key here whenever a component needs to persist per-tab state via
+ * `createSessionStorageItem` (see `index.ts`), so this file stays the single
+ * place to see everything the library puts in `sessionStorage`.
+ */
+const SESSION_STORAGE_KEYS = {
+    /** `lazyWithRetry`'s force-refresh-once marker (key name preserved from the portal-library implementation). */
+    pageHasBeenForceRefreshed: 'fd-page-has-been-force-refreshed',
+};
+
+export { SESSION_STORAGE_KEYS };
+//# sourceMappingURL=sessionStorageUtils.constants.js.map

package/dist/utilities/sessionStorageUtils/sessionStorageUtils.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStorageUtils.constants.js","sources":["../../../src/utilities/sessionStorageUtils/sessionStorageUtils.constants.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;AAKG;AACI,MAAM,oBAAoB,GAAG;;AAElC,IAAA,yBAAyB,EAAE,kCAAkC;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flipdish/ui-library",
-  "version": "0.11.12",
+  "version": "0.12.1",
   "description": "Flipdish Design System — atomic-design component library (Tailwind v4 + UntitledUI + React Aria).",
   "type": "module",
   "sideEffects": [