@flipdish/ui-library 0.19.0 → 0.20.0

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webStorage.utils.js","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;AAUG;AAKH,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAmB;IAC1E,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,IAAI;AAC9C,IAAA,IAAI;AACF,QAAA,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAClC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,EAAE,KAAa,KAAa;IACnF,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;QACF,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;AAChC,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAa;IACvE,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;AACF,QAAA,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;AAC5B,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAoBD;AACO,MAAM,SAAS,GAAG,CAAC,KAAc,KAAuB,OAAO,KAAK,KAAK;AAEhF;;;;AAIG;MACU,kBAAkB,GAAG,CAAC,GAAW,EAAE,YAAoB,KAAa;IAC/E,IAAI,GAAG,KAAK,MAAM;AAAE,QAAA,OAAO,IAAI;IAC/B,IAAI,GAAG,KAAK,OAAO;AAAE,QAAA,OAAO,KAAK;AACjC,IAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B;AAEA;AACO,MAAM,oBAAoB,GAAG,CAAI,UAA2B,EAAE,GAAW,EAAE,OAAA,GAAoC,EAAE,KAAuB;AAC7I,IAAA,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC,KAA2B,EAAE,QAAQ,EAAE,GAAG,OAAO;IAExG,OAAO;QACL,GAAG,GAAA;YACD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;YACpC,IAAI,GAAG,IAAI,IAAI;AAAE,gBAAA,OAAO,IAAI;AAC5B,YAAA,IAAI;AACF,gBAAA,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC;AAC9B,gBAAA,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AAAE,oBAAA,OAAO,IAAI;AAC7C,gBAAA,OAAO,KAAK;YACd;AAAE,YAAA,MAAM;AACN,gBAAA,OAAO,IAAI;YACb;QACF,CAAC;AACD,QAAA,GAAG,CAAC,KAAK,EAAA;AACP,YAAA,IAAI;AACF,gBAAA,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC;;;;gBAInC,IAAI,OAAO,UAAU,KAAK,QAAQ;oBAAE;AACpC,gBAAA,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC;YACtC;AAAE,YAAA,MAAM;;;YAGR;QACF,CAAC;QACD,KAAK,GAAA;AACH,YAAA,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC;QAC7B,CAAC;KACF;AACH;;;;"}

package/dist/utilities/cx/index.cjs

@@ -31,8 +31,8 @@ const twMerge = tailwindMerge.extendTailwindMerge({
 const cx = twMerge;
 /**
  * Identity helper that exists only so Tailwind IntelliSense recognises and sorts
- * the class strings held inside style-config objects (e.g. `tailwind-variants`
- * slot maps). Returns its argument unchanged.
+ * the class strings held inside style-config objects (the `*.styles.ts` sortCx
+ * maps components use). Returns its argument unchanged.
  */
 const sortCx = (classes) => classes;
 

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

@@ -14,8 +14,8 @@ type ClassValue = string | number;
 type ClassDefinition = Record<string, ClassValue | Record<string, ClassValue | Record<string, ClassValue>>>;
 /**
  * Identity helper that exists only so Tailwind IntelliSense recognises and sorts
- * the class strings held inside style-config objects (e.g. `tailwind-variants`
- * slot maps). Returns its argument unchanged.
+ * the class strings held inside style-config objects (the `*.styles.ts` sortCx
+ * maps components use). Returns its argument unchanged.
  */
 export declare const sortCx: <T extends ClassDefinition>(classes: T) => T;
 export {};

package/dist/utilities/cx/index.js

@@ -29,8 +29,8 @@ const twMerge = extendTailwindMerge({
 const cx = twMerge;
 /**
  * Identity helper that exists only so Tailwind IntelliSense recognises and sorts
- * the class strings held inside style-config objects (e.g. `tailwind-variants`
- * slot maps). Returns its argument unchanged.
+ * the class strings held inside style-config objects (the `*.styles.ts` sortCx
+ * maps components use). Returns its argument unchanged.
  */
 const sortCx = (classes) => classes;
 

package/dist/utilities/localStorageUtils/index.cjs

@@ -1,75 +1,18 @@
 'use strict';
 
+var webStorage_utils = require('../__internal__/webStorageUtils/webStorage.utils.cjs');
 var localStorageUtils_constants = require('./localStorageUtils.constants.cjs');
 
 /**
- * Web-only, typed `localStorage` persistence. DOM access (`window.localStorage`)
- * lives here rather than in components, so component code stays free of `window.*`
- * and keeps React Native parity — see `useBreakpoint` for the same isolation
- * pattern. Every helper no-ops / returns `null` when `localStorage` is
- * unavailable (SSR, React Native, private mode, quota errors).
+ * Web-only, typed `localStorage` persistence. Thin wrapper over the shared
+ * `#internal/utilities/webStorageUtils` factory (which `sessionStorageUtils`
+ * also uses — the two modules were byte-identical twins before the factory).
+ * Every helper no-ops / returns `null` when `localStorage` is unavailable
+ * (SSR, React Native, private mode, quota errors).
  *
  * Every key this package persists is registered in `localStorageUtils.constants.ts`
  * — check there for the full list before adding a new one.
  */
-const isBrowser = typeof window !== 'undefined';
-/**
- * Internal `localStorage` primitives backing `createLocalStorageItem`. Not
- * exported — everything a consumer needs goes through `createLocalStorageItem`,
- * 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 safeLocalGet = (key) => {
-    if (!isBrowser)
-        return null;
-    try {
-        return window.localStorage.getItem(key);
-    }
-    catch {
-        return null;
-    }
-};
-/** Persist a raw string value; returns whether the write succeeded. */
-const safeLocalSet = (key, value) => {
-    if (!isBrowser)
-        return false;
-    try {
-        window.localStorage.setItem(key, value);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-/** Remove a value; returns whether the removal succeeded. */
-const safeLocalRemove = (key) => {
-    if (!isBrowser)
-        return false;
-    try {
-        window.localStorage.removeItem(key);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Reusable `validate` guard for a `createLocalStorageItem<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 `createLocalStorageItem.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 `localStorage` key.
  *
@@ -78,51 +21,15 @@ const parseBooleanString = (raw, errorMessage) => {
  * draft.set({ title: 'Hi' });
  * const value = draft.get(); // Draft | null
  */
-const createLocalStorageItem = (key, options = {}) => {
-    const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
-    return {
-        get() {
-            const raw = safeLocalGet(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;
-                safeLocalSet(key, serialized);
-            }
-            catch {
-                // serialize() can throw (e.g. circular refs); matches the documented
-                // failure-safe contract — silently ignore, same as a write failure.
-            }
-        },
-        clear() {
-            safeLocalRemove(key);
-        },
-    };
-};
+const createLocalStorageItem = (key, options = {}) => webStorage_utils.createWebStorageItem(() => window.localStorage, key, options);
 /**
  * Persistence for the `SidebarNavigation` collapsed preference. Stored as the
  * plain strings `'true'` / `'false'` to preserve the original on-disk format.
  */
 const sidebarCollapsedStorage = createLocalStorageItem(localStorageUtils_constants.LOCAL_STORAGE_KEYS.sidebarCollapsed, {
     serialize: String,
-    deserialize: (raw) => parseBooleanString(raw, 'Invalid sidebar collapsed value'),
-    validate: isBoolean,
+    deserialize: (raw) => webStorage_utils.parseBooleanString(raw, 'Invalid sidebar collapsed value'),
+    validate: webStorage_utils.isBoolean,
 });
 
 exports.LOCAL_STORAGE_KEYS = localStorageUtils_constants.LOCAL_STORAGE_KEYS;

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/localStorageUtils/index.ts"],"sourcesContent":[null],"names":["LOCAL_STORAGE_KEYS"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/localStorageUtils/index.ts"],"sourcesContent":[null],"names":["createWebStorageItem","LOCAL_STORAGE_KEYS","parseBooleanString","isBoolean"],"mappings":";;;;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;AAOG;AACI,MAAM,sBAAsB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAsC,EAAE,KAC7FA,qCAAoB,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO;AAE9D;;;AAGG;MACU,uBAAuB,GAAG,sBAAsB,CAAUC,8CAAkB,CAAC,gBAAgB,EAAE;AAC1G,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAKC,mCAAkB,CAAC,GAAG,EAAE,iCAAiC,CAAC;AAChF,IAAA,QAAQ,EAAEC,0BAAS;AACpB,CAAA;;;;;;"}

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

@@ -1,9 +1,9 @@
 /**
- * Web-only, typed `localStorage` persistence. DOM access (`window.localStorage`)
- * lives here rather than in components, so component code stays free of `window.*`
- * and keeps React Native parity — see `useBreakpoint` for the same isolation
- * pattern. Every helper no-ops / returns `null` when `localStorage` is
- * unavailable (SSR, React Native, private mode, quota errors).
+ * Web-only, typed `localStorage` persistence. Thin wrapper over the shared
+ * `#internal/utilities/webStorageUtils` factory (which `sessionStorageUtils`
+ * also uses — the two modules were byte-identical twins before the factory).
+ * Every helper no-ops / returns `null` when `localStorage` is unavailable
+ * (SSR, React Native, private mode, quota errors).
  *
  * Every key this package persists is registered in `localStorageUtils.constants.ts`
  * — check there for the full list before adding a new one.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/localStorageUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AA2C9B,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,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,uBAAuB,CAAC,CAAC;IACxC,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,sBAAsB,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,uBAAuB,CAAC,CAAC,CAAM,KAAG,gBAAgB,CAAC,CAAC,CAgCnH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,2BAIlC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/localStorageUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAI9B,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,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,uBAAuB,CAAC,CAAC;IACxC,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;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,uBAAuB,CAAC,CAAC,CAAM,KAAG,gBAAgB,CAAC,CAAC,CACrD,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,2BAIlC,CAAC"}

package/dist/utilities/localStorageUtils/index.js

@@ -1,73 +1,16 @@
+import { createWebStorageItem, isBoolean, parseBooleanString } from '../__internal__/webStorageUtils/webStorage.utils.js';
 import { LOCAL_STORAGE_KEYS } from './localStorageUtils.constants.js';
 
 /**
- * Web-only, typed `localStorage` persistence. DOM access (`window.localStorage`)
- * lives here rather than in components, so component code stays free of `window.*`
- * and keeps React Native parity — see `useBreakpoint` for the same isolation
- * pattern. Every helper no-ops / returns `null` when `localStorage` is
- * unavailable (SSR, React Native, private mode, quota errors).
+ * Web-only, typed `localStorage` persistence. Thin wrapper over the shared
+ * `#internal/utilities/webStorageUtils` factory (which `sessionStorageUtils`
+ * also uses — the two modules were byte-identical twins before the factory).
+ * Every helper no-ops / returns `null` when `localStorage` is unavailable
+ * (SSR, React Native, private mode, quota errors).
  *
  * Every key this package persists is registered in `localStorageUtils.constants.ts`
  * — check there for the full list before adding a new one.
  */
-const isBrowser = typeof window !== 'undefined';
-/**
- * Internal `localStorage` primitives backing `createLocalStorageItem`. Not
- * exported — everything a consumer needs goes through `createLocalStorageItem`,
- * 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 safeLocalGet = (key) => {
-    if (!isBrowser)
-        return null;
-    try {
-        return window.localStorage.getItem(key);
-    }
-    catch {
-        return null;
-    }
-};
-/** Persist a raw string value; returns whether the write succeeded. */
-const safeLocalSet = (key, value) => {
-    if (!isBrowser)
-        return false;
-    try {
-        window.localStorage.setItem(key, value);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-/** Remove a value; returns whether the removal succeeded. */
-const safeLocalRemove = (key) => {
-    if (!isBrowser)
-        return false;
-    try {
-        window.localStorage.removeItem(key);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Reusable `validate` guard for a `createLocalStorageItem<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 `createLocalStorageItem.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 `localStorage` key.
  *
@@ -76,43 +19,7 @@ const parseBooleanString = (raw, errorMessage) => {
  * draft.set({ title: 'Hi' });
  * const value = draft.get(); // Draft | null
  */
-const createLocalStorageItem = (key, options = {}) => {
-    const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
-    return {
-        get() {
-            const raw = safeLocalGet(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;
-                safeLocalSet(key, serialized);
-            }
-            catch {
-                // serialize() can throw (e.g. circular refs); matches the documented
-                // failure-safe contract — silently ignore, same as a write failure.
-            }
-        },
-        clear() {
-            safeLocalRemove(key);
-        },
-    };
-};
+const createLocalStorageItem = (key, options = {}) => createWebStorageItem(() => window.localStorage, key, options);
 /**
  * Persistence for the `SidebarNavigation` collapsed preference. Stored as the
  * plain strings `'true'` / `'false'` to preserve the original on-disk format.

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utilities/localStorageUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/utilities/localStorageUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;AAOG;AACI,MAAM,sBAAsB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAsC,EAAE,KAC7F,oBAAoB,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO;AAE9D;;;AAGG;MACU,uBAAuB,GAAG,sBAAsB,CAAU,kBAAkB,CAAC,gBAAgB,EAAE;AAC1G,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAK,kBAAkB,CAAC,GAAG,EAAE,iCAAiC,CAAC;AAChF,IAAA,QAAQ,EAAE,SAAS;AACpB,CAAA;;;;"}

package/dist/utilities/sessionStorageUtils/index.cjs

@@ -1,76 +1,18 @@
 'use strict';
 
+var webStorage_utils = require('../__internal__/webStorageUtils/webStorage.utils.cjs');
 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).
+ * Web-only, typed `sessionStorage` persistence. Thin wrapper over the shared
+ * `#internal/utilities/webStorageUtils` factory (which `localStorageUtils`
+ * also uses — the two modules were byte-identical twins before the factory).
+ * 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.
  *
@@ -79,51 +21,15 @@ const parseBooleanString = (raw, errorMessage) => {
  * 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);
-        },
-    };
-};
+const createSessionStorageItem = (key, options = {}) => webStorage_utils.createWebStorageItem(() => window.sessionStorage, key, options);
 /**
  * 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,
+    deserialize: (raw) => webStorage_utils.parseBooleanString(raw, 'Invalid page-force-refreshed value'),
+    validate: webStorage_utils.isBoolean,
 });
 
 exports.SESSION_STORAGE_KEYS = sessionStorageUtils_constants.SESSION_STORAGE_KEYS;

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"sourcesContent":[null],"names":["SESSION_STORAGE_KEYS"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"sourcesContent":[null],"names":["createWebStorageItem","SESSION_STORAGE_KEYS","parseBooleanString","isBoolean"],"mappings":";;;;;AAAA;;;;;;;;;AASG;AA2BH;;;;;;;AAOG;AACI,MAAM,wBAAwB,GAAG,CAAI,GAAW,EAAE,OAAA,GAAwC,EAAE,KACjGA,qCAAoB,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO;AAEhE;;;AAGG;MACU,yBAAyB,GAAG,wBAAwB,CAAUC,kDAAoB,CAAC,yBAAyB,EAAE;AACzH,IAAA,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,CAAC,GAAG,KAAKC,mCAAkB,CAAC,GAAG,EAAE,oCAAoC,CAAC;AACnF,IAAA,QAAQ,EAAEC,0BAAS;AACpB,CAAA;;;;;;"}

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

@@ -1,10 +1,9 @@
 /**
- * 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).
+ * Web-only, typed `sessionStorage` persistence. Thin wrapper over the shared
+ * `#internal/utilities/webStorageUtils` factory (which `localStorageUtils`
+ * also uses — the two modules were byte-identical twins before the factory).
+ * 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.

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/sessionStorageUtils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAIhC,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;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,yBAAyB,CAAC,CAAC,CAAM,KAAG,kBAAkB,CAAC,CAAC,CACzD,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,6BAIpC,CAAC"}

package/dist/utilities/sessionStorageUtils/index.js

@@ -1,74 +1,16 @@
+import { createWebStorageItem, isBoolean, parseBooleanString } from '../__internal__/webStorageUtils/webStorage.utils.js';
 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).
+ * Web-only, typed `sessionStorage` persistence. Thin wrapper over the shared
+ * `#internal/utilities/webStorageUtils` factory (which `localStorageUtils`
+ * also uses — the two modules were byte-identical twins before the factory).
+ * 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.
  *
@@ -77,43 +19,7 @@ const parseBooleanString = (raw, errorMessage) => {
  * 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);
-        },
-    };
-};
+const createSessionStorageItem = (key, options = {}) => createWebStorageItem(() => window.sessionStorage, key, options);
 /**
  * Persistence for `lazyWithRetry`'s force-refresh-once marker. Stored as the
  * plain strings `'true'` / `'false'` to preserve the original portal-library format.