@flipdish/ui-library 0.18.0 → 0.20.0

package/dist/hooks/__internal__/useAriaDisclosureAttrs/useAriaDisclosureAttrs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAriaDisclosureAttrs.cjs","sources":["../../../../src/hooks/__internal__/useAriaDisclosureAttrs/useAriaDisclosureAttrs.ts"],"sourcesContent":[null],"names":["useEffect"],"mappings":";;;;AAWA;;;;;;;;;;AAUG;AACI,MAAM,sBAAsB,GAAG,CACpC,GAAwB,EACxB,EAAE,YAAY,EAAE,YAAY,EAAiC,KAC3D;IACFA,eAAS,CAAC,MAAK;AACb,QAAA,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO;AACxB,QAAA,IAAI,CAAC,IAAI;YAAE;AAEX,QAAA,IAAI,YAAY,KAAK,SAAS,EAAE;AAC9B,YAAA,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC;QACvC;aAAO;YACL,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAC1D;AAEA,QAAA,IAAI,YAAY,KAAK,SAAS,EAAE;AAC9B,YAAA,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC;QACvC;aAAO;AACL,YAAA,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,YAAY,CAAC;QAClD;IACF,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AACvC;;;;"}

package/dist/hooks/{useAriaDisclosureAttrs/index.d.ts → __internal__/useAriaDisclosureAttrs/useAriaDisclosureAttrs.d.ts}

@@ -17,4 +17,4 @@ export interface UseAriaDisclosureAttrsOptions {
  * @summary set disclosure ARIA attributes directly on a ref'd node
  */
 export declare const useAriaDisclosureAttrs: <T extends HTMLElement>(ref: RefObject<T | null>, { ariaExpanded, ariaControls }: UseAriaDisclosureAttrsOptions) => void;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=useAriaDisclosureAttrs.d.ts.map

package/dist/hooks/__internal__/useAriaDisclosureAttrs/useAriaDisclosureAttrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAriaDisclosureAttrs.d.ts","sourceRoot":"","sources":["../../../../src/hooks/__internal__/useAriaDisclosureAttrs/useAriaDisclosureAttrs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAElD,MAAM,WAAW,6BAA6B;IAC5C,iGAAiG;IACjG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,WAAW,EAC1D,KAAK,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EACxB,gCAAgC,6BAA6B,SAkB9D,CAAC"}

package/dist/hooks/{useAriaDisclosureAttrs/index.js → __internal__/useAriaDisclosureAttrs/useAriaDisclosureAttrs.js}

@@ -32,4 +32,4 @@ const useAriaDisclosureAttrs = (ref, { ariaExpanded, ariaControls }) => {
 };
 
 export { useAriaDisclosureAttrs };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=useAriaDisclosureAttrs.js.map

package/dist/hooks/__internal__/useAriaDisclosureAttrs/useAriaDisclosureAttrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAriaDisclosureAttrs.js","sources":["../../../../src/hooks/__internal__/useAriaDisclosureAttrs/useAriaDisclosureAttrs.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAWA;;;;;;;;;;AAUG;AACI,MAAM,sBAAsB,GAAG,CACpC,GAAwB,EACxB,EAAE,YAAY,EAAE,YAAY,EAAiC,KAC3D;IACF,SAAS,CAAC,MAAK;AACb,QAAA,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO;AACxB,QAAA,IAAI,CAAC,IAAI;YAAE;AAEX,QAAA,IAAI,YAAY,KAAK,SAAS,EAAE;AAC9B,YAAA,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC;QACvC;aAAO;YACL,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAC1D;AAEA,QAAA,IAAI,YAAY,KAAK,SAAS,EAAE;AAC9B,YAAA,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC;QACvC;aAAO;AACL,YAAA,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,YAAY,CAAC;QAClD;IACF,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AACvC;;;;"}

package/dist/native/components/atoms/Button/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/Button/index.native.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,EAAkB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAC7F,OAAO,EAAyC,KAAK,cAAc,EAAc,MAAM,cAAc,CAAC;AACtG,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,KAAK,QAAQ,GAAG,EAAE,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAAC;AAEtF,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,MAAM,CAAC,KAAK,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC;AAErD,UAAU,WAAW;IACnB,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,uDAAuD;IACvD,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,SAAS,GAAG,oBAAoB,GAAG,mBAAmB,CAAC,CAAC;AAE1G,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAElD,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;AA4F5C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC;IACjC,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;CAsGpC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/atoms/Button/index.native.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,EAAkB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAC7F,OAAO,EAAyC,KAAK,cAAc,EAAc,MAAM,cAAc,CAAC;AAEtG,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,KAAK,QAAQ,GAAG,EAAE,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAAC;AAEtF,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,MAAM,CAAC,KAAK,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC;AAErD,UAAU,WAAW;IACnB,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,uDAAuD;IACvD,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,SAAS,GAAG,oBAAoB,GAAG,mBAAmB,CAAC,CAAC;AAE1G,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAElD,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;AA4F5C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC;IACjC,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;CAsGpC,CAAC"}

package/dist/native/components/atoms/Button/index.js

@@ -1,9 +1,9 @@
 import { jsxs, jsx } from 'react/jsx-runtime';
 import { cx } from '../../../utilities/cx/index.js';
-import { isReactComponent } from '../../../utilities/isReactComponent/index.js';
 import { useResolvedTestId } from '../../../utilities/testIdUtils/index.js';
 import { useState, isValidElement } from 'react';
 import { Pressable, View, ActivityIndicator, Text, Linking } from 'react-native';
+import { isReactComponent } from '../../../utilities/__internal__/componentGuardUtils/componentGuard.utils.js';
 import { styles } from './Button.styles.js';
 
 const LINK_COLORS = ['link-gray', 'link-color', 'link-destructive'];

package/dist/{utilities/isReactComponent/index.d.ts → native/utilities/__internal__/componentGuardUtils/componentGuard.utils.d.ts}

@@ -9,8 +9,8 @@ type ReactComponent = React.FC<any> | React.ComponentClass<any, any> | React.For
  * form; these guards select the "render it yourself" branch.
  *
  * Pure JS with no DOM dependency — works on web (PostCSS) and React Native
- * (NativeWind). Imported by components as
- * `@flipdish/ui-library/utilities/isReactComponent`.
+ * (NativeWind). INTERNAL: imported by components as
+ * `#internal/utilities/componentGuardUtils/componentGuard.utils`.
  */
 /** Checks if a given value is a function component. */
 export declare const isFunctionComponent: (component: any) => component is React.FC<any>;
@@ -21,4 +21,4 @@ export declare const isForwardRefComponent: (component: any) => component is Rea
 /** Checks if a given value is a valid React component (FC, class, or forwardRef). */
 export declare const isReactComponent: (component: any) => component is ReactComponent;
 export {};
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=componentGuard.utils.d.ts.map

package/dist/native/utilities/__internal__/componentGuardUtils/componentGuard.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentGuard.utils.d.ts","sourceRoot":"","sources":["../../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,cAAc,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;AAE5G;;;;;;;;;;;GAWG;AAEH,uDAAuD;AAEvD,eAAO,MAAM,mBAAmB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAE7E,CAAC;AAEF,oDAAoD;AAEpD,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAE3F,CAAC;AAEF,0DAA0D;AAE1D,eAAO,MAAM,qBAAqB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAEtG,CAAC;AAEF,qFAAqF;AAErF,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,cAE9D,CAAC"}

package/dist/{utilities/isReactComponent/index.js → native/utilities/__internal__/componentGuardUtils/componentGuard.utils.js}

@@ -7,8 +7,8 @@
  * form; these guards select the "render it yourself" branch.
  *
  * Pure JS with no DOM dependency — works on web (PostCSS) and React Native
- * (NativeWind). Imported by components as
- * `@flipdish/ui-library/utilities/isReactComponent`.
+ * (NativeWind). INTERNAL: imported by components as
+ * `#internal/utilities/componentGuardUtils/componentGuard.utils`.
  */
 /** Checks if a given value is a function component. */
 // biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
@@ -32,4 +32,4 @@ const isReactComponent = (component) => {
 };
 
 export { isClassComponent, isForwardRefComponent, isFunctionComponent, isReactComponent };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=componentGuard.utils.js.map

package/dist/native/utilities/__internal__/componentGuardUtils/componentGuard.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentGuard.utils.js","sources":["../../../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAMA;;;;;;;;;;;AAWG;AAEH;AACA;AACO,MAAM,mBAAmB,GAAG,CAAC,SAAc,KAAgC;AAChF,IAAA,OAAO,OAAO,SAAS,KAAK,UAAU;AACxC;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiD;IAC9F,OAAO,OAAO,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;AAC3I;AAEA;AACA;AACO,MAAM,qBAAqB,GAAG,CAAC,SAAc,KAAuD;AACzG,IAAA,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,2BAA2B;AAC9H;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiC;AAC9E,IAAA,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC;AAC1G;;;;"}

package/dist/native/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/native/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/native/{hooks/useAriaDisclosureAttrs → utilities/hrefUtils}/index.d.ts

@@ -1,12 +1,12 @@
 /**
- * `useAriaDisclosureAttrs` has no React Native implementation.
+ * `hrefUtils` has no React Native implementation.
  *
  * This is a generated types-only stub (scripts/emit-native-stubs.mjs). It exists so
- * that importing `@flipdish/ui-library/hooks/useAriaDisclosureAttrs` from React Native fails at
+ * that importing `@flipdish/ui-library/utilities/hrefUtils` from React Native fails at
  * compile time rather than resolving to the web build's types. There is no
  * matching `index.js`, so Metro cannot bundle this module either.
  *
- * To make `useAriaDisclosureAttrs` available on React Native, add an `index.native.tsx` beside
+ * To make `hrefUtils` available on React Native, add an `index.native.tsx` beside
  * its `index.tsx` — the build picks it up automatically and this stub disappears.
  */
 export declare const __NO_REACT_NATIVE_IMPLEMENTATION__: never;

package/dist/utilities/{isReactComponent/index.cjs → __internal__/componentGuardUtils/componentGuard.utils.cjs}

@@ -9,8 +9,8 @@
  * form; these guards select the "render it yourself" branch.
  *
  * Pure JS with no DOM dependency — works on web (PostCSS) and React Native
- * (NativeWind). Imported by components as
- * `@flipdish/ui-library/utilities/isReactComponent`.
+ * (NativeWind). INTERNAL: imported by components as
+ * `#internal/utilities/componentGuardUtils/componentGuard.utils`.
  */
 /** Checks if a given value is a function component. */
 // biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
@@ -37,4 +37,4 @@ exports.isClassComponent = isClassComponent;
 exports.isForwardRefComponent = isForwardRefComponent;
 exports.isFunctionComponent = isFunctionComponent;
 exports.isReactComponent = isReactComponent;
-//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=componentGuard.utils.cjs.map

package/dist/utilities/__internal__/componentGuardUtils/componentGuard.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentGuard.utils.cjs","sources":["../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAMA;;;;;;;;;;;AAWG;AAEH;AACA;AACO,MAAM,mBAAmB,GAAG,CAAC,SAAc,KAAgC;AAChF,IAAA,OAAO,OAAO,SAAS,KAAK,UAAU;AACxC;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiD;IAC9F,OAAO,OAAO,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;AAC3I;AAEA;AACA;AACO,MAAM,qBAAqB,GAAG,CAAC,SAAc,KAAuD;AACzG,IAAA,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,2BAA2B;AAC9H;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiC;AAC9E,IAAA,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC;AAC1G;;;;;;;"}

package/dist/{native/utilities/isReactComponent/index.d.ts → utilities/__internal__/componentGuardUtils/componentGuard.utils.d.ts}

@@ -9,8 +9,8 @@ type ReactComponent = React.FC<any> | React.ComponentClass<any, any> | React.For
  * form; these guards select the "render it yourself" branch.
  *
  * Pure JS with no DOM dependency — works on web (PostCSS) and React Native
- * (NativeWind). Imported by components as
- * `@flipdish/ui-library/utilities/isReactComponent`.
+ * (NativeWind). INTERNAL: imported by components as
+ * `#internal/utilities/componentGuardUtils/componentGuard.utils`.
  */
 /** Checks if a given value is a function component. */
 export declare const isFunctionComponent: (component: any) => component is React.FC<any>;
@@ -21,4 +21,4 @@ export declare const isForwardRefComponent: (component: any) => component is Rea
 /** Checks if a given value is a valid React component (FC, class, or forwardRef). */
 export declare const isReactComponent: (component: any) => component is ReactComponent;
 export {};
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=componentGuard.utils.d.ts.map

package/dist/utilities/__internal__/componentGuardUtils/componentGuard.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentGuard.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,cAAc,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;AAE5G;;;;;;;;;;;GAWG;AAEH,uDAAuD;AAEvD,eAAO,MAAM,mBAAmB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAE7E,CAAC;AAEF,oDAAoD;AAEpD,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAE3F,CAAC;AAEF,0DAA0D;AAE1D,eAAO,MAAM,qBAAqB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAEtG,CAAC;AAEF,qFAAqF;AAErF,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,cAE9D,CAAC"}

package/dist/{native/utilities/isReactComponent/index.js → utilities/__internal__/componentGuardUtils/componentGuard.utils.js}

@@ -7,8 +7,8 @@
  * form; these guards select the "render it yourself" branch.
  *
  * Pure JS with no DOM dependency — works on web (PostCSS) and React Native
- * (NativeWind). Imported by components as
- * `@flipdish/ui-library/utilities/isReactComponent`.
+ * (NativeWind). INTERNAL: imported by components as
+ * `#internal/utilities/componentGuardUtils/componentGuard.utils`.
  */
 /** Checks if a given value is a function component. */
 // biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
@@ -32,4 +32,4 @@ const isReactComponent = (component) => {
 };
 
 export { isClassComponent, isForwardRefComponent, isFunctionComponent, isReactComponent };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=componentGuard.utils.js.map

package/dist/utilities/__internal__/componentGuardUtils/componentGuard.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentGuard.utils.js","sources":["../../../../src/utilities/__internal__/componentGuardUtils/componentGuard.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAMA;;;;;;;;;;;AAWG;AAEH;AACA;AACO,MAAM,mBAAmB,GAAG,CAAC,SAAc,KAAgC;AAChF,IAAA,OAAO,OAAO,SAAS,KAAK,UAAU;AACxC;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiD;IAC9F,OAAO,OAAO,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;AAC3I;AAEA;AACA;AACO,MAAM,qBAAqB,GAAG,CAAC,SAAc,KAAuD;AACzG,IAAA,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,2BAA2B;AAC9H;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiC;AAC9E,IAAA,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC;AAC1G;;;;"}

package/dist/utilities/__internal__/logUtils/log.utils.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+/**
+ * INTERNAL — not part of the public API.
+ *
+ * `__internal__` modules deliberately have no `index.ts`, so they never match
+ * `PUBLIC_ENTRY_GLOBS` (scripts/entry-manifest.mjs) and the `./utilities/*` exports
+ * map cannot resolve them — consumers physically cannot import this. Library code
+ * imports them via the package-private `#internal/utilities/*` subpath (area-namespaced — add `#internal/hooks/*` etc. as new areas grow internal modules) (package.json `imports`
+ * field, resolved by tsc/Vite/Vitest at source level and rewritten to relative paths
+ * in dist by the rollup `internal-subpath-imports` plugin). Never import via
+ * `@flipdish/ui-library/...` — it resolves in TypeScript but breaks at runtime;
+ * `check-deep-imports.mjs` enforces this.
+ */
+const seenWarnings = new Set();
+/**
+ * Emits a `console.warn` prefixed with the library name, once per `key` for the
+ * lifetime of the module. Use for data-dependent runtime conditions (a blocked
+ * href scheme, a missing account id) that must stay visible in production —
+ * error-tracking tools pick console.warn up as breadcrumbs — without flooding
+ * the console on re-renders.
+ */
+const warnOnce = (key, message) => {
+    if (seenWarnings.has(key)) {
+        return;
+    }
+    seenWarnings.add(key);
+    console.warn(`[@flipdish/ui-library] ${message}`);
+};
+
+exports.warnOnce = warnOnce;
+//# sourceMappingURL=log.utils.cjs.map

package/dist/utilities/__internal__/logUtils/log.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.utils.cjs","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;AAWG;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU;AAEtC;;;;;;AAMG;MACU,QAAQ,GAAG,CAAC,GAAW,EAAE,OAAe,KAAU;AAC7D,IAAA,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACzB;IACF;AACA,IAAA,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;AACrB,IAAA,OAAO,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAA,CAAE,CAAC;AACnD;;;;"}

package/dist/utilities/__internal__/logUtils/log.utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * INTERNAL — not part of the public API.
+ *
+ * `__internal__` modules deliberately have no `index.ts`, so they never match
+ * `PUBLIC_ENTRY_GLOBS` (scripts/entry-manifest.mjs) and the `./utilities/*` exports
+ * map cannot resolve them — consumers physically cannot import this. Library code
+ * imports them via the package-private `#internal/utilities/*` subpath (area-namespaced — add `#internal/hooks/*` etc. as new areas grow internal modules) (package.json `imports`
+ * field, resolved by tsc/Vite/Vitest at source level and rewritten to relative paths
+ * in dist by the rollup `internal-subpath-imports` plugin). Never import via
+ * `@flipdish/ui-library/...` — it resolves in TypeScript but breaks at runtime;
+ * `check-deep-imports.mjs` enforces this.
+ */
+/**
+ * Emits a `console.warn` prefixed with the library name, once per `key` for the
+ * lifetime of the module. Use for data-dependent runtime conditions (a blocked
+ * href scheme, a missing account id) that must stay visible in production —
+ * error-tracking tools pick console.warn up as breadcrumbs — without flooding
+ * the console on re-renders.
+ */
+export declare const warnOnce: (key: string, message: string) => void;
+/** Test-only: clears the once-per-key warning memory. */
+export declare const resetWarnOnce: () => void;
+//# sourceMappingURL=log.utils.d.ts.map

package/dist/utilities/__internal__/logUtils/log.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,SAAS,MAAM,KAAG,IAMvD,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,aAAa,QAAO,IAEhC,CAAC"}

package/dist/utilities/__internal__/logUtils/log.utils.js

@@ -0,0 +1,30 @@
+/**
+ * INTERNAL — not part of the public API.
+ *
+ * `__internal__` modules deliberately have no `index.ts`, so they never match
+ * `PUBLIC_ENTRY_GLOBS` (scripts/entry-manifest.mjs) and the `./utilities/*` exports
+ * map cannot resolve them — consumers physically cannot import this. Library code
+ * imports them via the package-private `#internal/utilities/*` subpath (area-namespaced — add `#internal/hooks/*` etc. as new areas grow internal modules) (package.json `imports`
+ * field, resolved by tsc/Vite/Vitest at source level and rewritten to relative paths
+ * in dist by the rollup `internal-subpath-imports` plugin). Never import via
+ * `@flipdish/ui-library/...` — it resolves in TypeScript but breaks at runtime;
+ * `check-deep-imports.mjs` enforces this.
+ */
+const seenWarnings = new Set();
+/**
+ * Emits a `console.warn` prefixed with the library name, once per `key` for the
+ * lifetime of the module. Use for data-dependent runtime conditions (a blocked
+ * href scheme, a missing account id) that must stay visible in production —
+ * error-tracking tools pick console.warn up as breadcrumbs — without flooding
+ * the console on re-renders.
+ */
+const warnOnce = (key, message) => {
+    if (seenWarnings.has(key)) {
+        return;
+    }
+    seenWarnings.add(key);
+    console.warn(`[@flipdish/ui-library] ${message}`);
+};
+
+export { warnOnce };
+//# sourceMappingURL=log.utils.js.map

package/dist/utilities/__internal__/logUtils/log.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.utils.js","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;AAWG;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU;AAEtC;;;;;;AAMG;MACU,QAAQ,GAAG,CAAC,GAAW,EAAE,OAAe,KAAU;AAC7D,IAAA,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACzB;IACF;AACA,IAAA,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;AACrB,IAAA,OAAO,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAA,CAAE,CAAC;AACnD;;;;"}

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.cjs

@@ -0,0 +1,102 @@
+'use strict';
+
+/**
+ * INTERNAL — not part of the public API (see `logUtils` for the `__internal__`
+ * conventions). Shared implementation behind `localStorageUtils` and
+ * `sessionStorageUtils`, which were byte-identical twins before this factory —
+ * the public modules stay thin wrappers so their APIs are unchanged.
+ *
+ * Web-only, typed Web Storage persistence. DOM access lives here rather than in
+ * components, so component code stays free of `window.*` and keeps React Native
+ * parity. Every helper no-ops / returns `null` when the backing storage is
+ * unavailable (SSR, React Native, private mode, quota errors).
+ */
+const safeGet = (getStorage, key) => {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        return getStorage().getItem(key);
+    }
+    catch {
+        return null;
+    }
+};
+const safeSet = (getStorage, key, value) => {
+    if (typeof window === 'undefined')
+        return false;
+    try {
+        getStorage().setItem(key, value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const safeRemove = (getStorage, key) => {
+    if (typeof window === 'undefined')
+        return false;
+    try {
+        getStorage().removeItem(key);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** Reusable `validate` guard for a 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 `WebStorageItem.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 key in the given storage. */
+const createWebStorageItem = (getStorage, key, options = {}) => {
+    const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
+    return {
+        get() {
+            const raw = safeGet(getStorage, 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;
+                safeSet(getStorage, key, serialized);
+            }
+            catch {
+                // serialize() can throw (e.g. circular refs); matches the documented
+                // failure-safe contract — silently ignore, same as a write failure.
+            }
+        },
+        clear() {
+            safeRemove(getStorage, key);
+        },
+    };
+};
+
+exports.createWebStorageItem = createWebStorageItem;
+exports.isBoolean = isBoolean;
+exports.parseBooleanString = parseBooleanString;
+//# sourceMappingURL=webStorage.utils.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webStorage.utils.cjs","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/__internal__/webStorageUtils/webStorage.utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * INTERNAL — not part of the public API (see `logUtils` for the `__internal__`
+ * conventions). Shared implementation behind `localStorageUtils` and
+ * `sessionStorageUtils`, which were byte-identical twins before this factory —
+ * the public modules stay thin wrappers so their APIs are unchanged.
+ *
+ * Web-only, typed Web Storage persistence. DOM access lives here rather than in
+ * components, so component code stays free of `window.*` and keeps React Native
+ * parity. Every helper no-ops / returns `null` when the backing storage is
+ * unavailable (SSR, React Native, private mode, quota errors).
+ */
+/** Lazily reach the backing store — accessing `window.*Storage` itself can throw. */
+type StorageAccessor = () => Storage;
+export interface WebStorageItem<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 WebStorageItemOptions<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;
+}
+/** Reusable `validate` guard for a boolean item. */
+export declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Parse a plain `'true'`/`'false'` string (not JSON) into a boolean; throws
+ * `errorMessage` for anything else so `WebStorageItem.get()` treats it as
+ * invalid data and returns `null`.
+ */
+export declare const parseBooleanString: (raw: string, errorMessage: string) => boolean;
+/** Build a typed, failure-safe accessor for a single key in the given storage. */
+export declare const createWebStorageItem: <T>(getStorage: StorageAccessor, key: string, options?: WebStorageItemOptions<T>) => WebStorageItem<T>;
+export {};
+//# sourceMappingURL=webStorage.utils.d.ts.map

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webStorage.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qFAAqF;AACrF,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC;AA+BrC,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,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,qBAAqB,CAAC,CAAC;IACtC,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,oDAAoD;AACpD,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAqC,CAAC;AAE1F;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,cAAc,MAAM,KAAG,OAItE,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,YAAY,eAAe,EAAE,KAAK,MAAM,EAAE,UAAS,qBAAqB,CAAC,CAAC,CAAM,KAAG,cAAc,CAAC,CAAC,CAgC1I,CAAC"}

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

@@ -0,0 +1,98 @@
+/**
+ * INTERNAL — not part of the public API (see `logUtils` for the `__internal__`
+ * conventions). Shared implementation behind `localStorageUtils` and
+ * `sessionStorageUtils`, which were byte-identical twins before this factory —
+ * the public modules stay thin wrappers so their APIs are unchanged.
+ *
+ * Web-only, typed Web Storage persistence. DOM access lives here rather than in
+ * components, so component code stays free of `window.*` and keeps React Native
+ * parity. Every helper no-ops / returns `null` when the backing storage is
+ * unavailable (SSR, React Native, private mode, quota errors).
+ */
+const safeGet = (getStorage, key) => {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        return getStorage().getItem(key);
+    }
+    catch {
+        return null;
+    }
+};
+const safeSet = (getStorage, key, value) => {
+    if (typeof window === 'undefined')
+        return false;
+    try {
+        getStorage().setItem(key, value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const safeRemove = (getStorage, key) => {
+    if (typeof window === 'undefined')
+        return false;
+    try {
+        getStorage().removeItem(key);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** Reusable `validate` guard for a 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 `WebStorageItem.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 key in the given storage. */
+const createWebStorageItem = (getStorage, key, options = {}) => {
+    const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
+    return {
+        get() {
+            const raw = safeGet(getStorage, 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;
+                safeSet(getStorage, key, serialized);
+            }
+            catch {
+                // serialize() can throw (e.g. circular refs); matches the documented
+                // failure-safe contract — silently ignore, same as a write failure.
+            }
+        },
+        clear() {
+            safeRemove(getStorage, key);
+        },
+    };
+};
+
+export { createWebStorageItem, isBoolean, parseBooleanString };
+//# sourceMappingURL=webStorage.utils.js.map

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;