meticulous-ui 3.2.6 → 3.2.8

package/README.md

@@ -142,19 +142,49 @@ import blue from 'meticulous-ui/colors/blue';
 
 ## 📦 Utils
 
-| Category        | Functions                                                                                                                                                           |
-| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **String**      | `capFirstLetter` `capitalize` `titleCase` `camelCase` `snakeCase` `kebabCase` `slugify` `truncate` `removeExtraSpaces` `maskEmail` `maskPhone` `generateInitials`   |
-| **Number**      | `clamp` `formatCurrency` `formatNumber` `formatCompactNumber` `percentage` `randomInt` `randomBetween` `randomValue` `roundTo`                                      |
-| **Date-Time**   | `formatDate` `formatTime` `addDays` `differenceInDays` `isToday` `isPast` `timeAgo` `getGreetingByTime` `countdown`                                                 |
-| **Data**        | `deepClone` `mergeDeep` `pick` `omit` `isEmpty` `isEqual` `hasEqualProps` `isNonEmptyArray` `flattenObject` `groupBy` `keyBy` `uniqueBy` `sortBy` `chunk` `compose` |
-| **Validation**  | `isEmail` `isPhone` `isURL` `isPasswordStrong` `isPAN` `isAadhaar` `isGST` `isRequired` `minLength` `maxLength`                                                     |
-| **Device**      | `isMobile` `isIOS` `isAndroid` `isSafari` `isDarkMode` `isOnline` `copyToClipboard` `downloadFile` `openInNewTab` `getScreenSize`                                   |
-| **Storage**     | `setLocalStorage` `getLocalStorage` `removeLocalStorage` `setSessionStorage` `getSessionStorage` `clearStorage`                                                     |
-| **Routing**     | `getQueryParams` `setQueryParam` `removeQueryParam` `buildURL` `redirectTo` `getCurrentPath` `isActiveRoute`                                                        |
-| **UI**          | `scrollToTop` `scrollToElement` `lockBodyScroll` `unlockBodyScroll` `toggleFullscreen` `focusElement` `detectOutsideClick` `measureElement`                         |
-| **Performance** | `debounce` `throttle` `memoize` `lazyLoadComponent` `requestIdleTask` `rafThrottle`                                                                                 |
-| **Async**       | `retry` `sleep` `withTimeout` `parallel` `sequential` `safeAsync` `cancelablePromise`                                                                               |
+| Category           | Functions                                                                                                                                                                          |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **String**         | `capFirstLetter`, `capitalize`, `titleCase`, `camelCase`, `snakeCase`, `kebabCase`, `slugify`, `truncate`, `removeExtraSpaces`, `maskEmail`, `maskPhone`, `generateInitials`,      |
+| **Number**         | `clamp`, `formatCurrency`, `formatNumber`, `formatCompactNumber`, `percentage`, `randomInt`, `randomBetween`, `randomValue`, `roundTo`,                                            |
+| **Date-Time**      | `formatDate`, `formatTime`, `addDays`, `differenceInDays`, `isToday`, `isPast`, `timeAgo`, `getGreetingByTime`, `countdown`,                                                       |
+| **Data**           | `deepClone`, `mergeDeep`, `pick`, `omit`, `isEmpty`, `isEqual`, `hasEqualProps`, `isNonEmptyArray`, `flattenObject`, `groupBy`, `keyBy`, `uniqueBy`, `sortBy`, `chunk`, `compose`, |
+| **Validation**     | `isEmail`, `isPhone`, `isURL`, `isPasswordStrong`, `isPAN`, `isAadhaar`, `isGST`, `isRequired`, `minLength`, `maxLength`,                                                          |
+| **Device**         | `isMobile`, `isIOS`, `isAndroid`, `isSafari`, `isDarkMode`, `isOnline`, `copyToClipboard`, `downloadFile`, `openInNewTab`, `getScreenSize`,                                        |
+| **Storage**        | `setLocalStorage`, `getLocalStorage`, `removeLocalStorage`, `setSessionStorage`, `getSessionStorage`, `clearStorage`,                                                              |
+| **Routing**        | `getQueryParams`, `setQueryParam`, `removeQueryParam`, `buildURL`, `redirectTo`, `getCurrentPath`, `isActiveRoute`,                                                                |
+| **UI**             | `scrollToTop`, `scrollToElement`, `lockBodyScroll`, `unlockBodyScroll`, `toggleFullscreen`, `focusElement`, `detectOutsideClick`, `measureElement`,                                |
+| **Performance**    | `debounce`, `throttle`, `memoize`, `lazyLoadComponent`, `requestIdleTask`, `rafThrottle`,                                                                                          |
+| **Async**          | `retry`, `sleep`, `withTimeout`, `parallel`, `sequential`, `safeAsync`, `cancelablePromise`                                                                                        |
+| **Accessibility**  | `announceToScreenReader`, `trapFocus`, `generateAriaId`, `handleKeyboardNavigation`                                                                                                |
+| **Error Handling** | `logError`, `captureException`, `safeJSONParse`, `safeJSONStringify`, `fallback`                                                                                                   |
+| **Auth**           | `isAuthenticated`, `getToken`, `setToken`, `removeToken`, `decodeJWT`, `hasPermission`                                                                                             |
+| **Feature Flags**  | `isFeatureEnabled`, `getVariant`                                                                                                                                                   |
+| **Enterprise**     | `trackEvent`, `trackPageView`, `measurePerformance`, `featureGate`, `permissionGuard`, `auditLog`, `logInfo`, `logWarn`, `captureException`                                        |
+| **Filter**         | `fuzzySearch`, `filterByKey`, `multiSort`, `paginate`                                                                                                                              |
+| **Animation**      | `fadeIn`, `fadeOut`, `smoothScroll`, `waitForTransitionEnd`                                                                                                                        |
+| **Function**       | `once`, `noop`, `identity`, `pipe`, `singleton`, `createPubSub`, `deepFreeze`                                                                                                      |
+
+## 📦 React Helper Functions
+
+| Function            | Description                                                                        |
+| ------------------- | ---------------------------------------------------------------------------------- |
+| `createContextHook` | Creates a React context + typed hook pair; throws if consumed outside its Provider |
+| `composeProviders`  | Merges N provider components into one wrapper, eliminating the provider pyramid    |
+| `lazyImport`        | Extends `React.lazy` to work with named exports, not just default exports          |
+| `withErrorBoundary` | HOC wrapping a component in an error boundary with a configurable fallback         |
+| `withSuspense`      | HOC wrapping a component in `<Suspense>` with a co-located fallback UI             |
+| `memoCompare`       | Typed wrapper around `React.memo` with a custom equality comparator                |
+| `createPortalNode`  | Creates and appends a DOM node to `document.body` for use as a portal container    |
+
+## 📦 Hooks
+
+| Category        | Hooks                                                                                                                 |
+| --------------- | --------------------------------------------------------------------------------------------------------------------- |
+| **State**       | `usePrevious`, `useDebounce`, `useThrottle`, `useToggle`                                                              |
+| **Lifecycle**   | `useIsMounted`, `useUnmount`, `useFirstRender`, `useTimeout`, `useInterval`                                           |
+| **DOM/Browser** | `useEventListener`, `useIntersectionObserver`, `useMediaQuery`, `useOutsideClick`, `useWindowSize`, `useOnlineStatus` |
+| **Storage**     | `useLocalStorage`, `useSessionStorage`                                                                                |
+| **Utility**     | `useCopyToClipboard`                                                                                                  |
 
 ## 🌱 Features
 

package/index.js

@@ -1,20 +1,20 @@
 import { default as a } from "./components/Pagination/Pagination.js";
 import { default as r, ToastContainer as f } from "./components/Toast/Toast.js";
-import { default as d } from "./components/Spinner/Spinner.js";
-import { default as s } from "./components/Loader/Loader.js";
+import { default as l } from "./components/Spinner/Spinner.js";
+import { default as d } from "./components/Loader/Loader.js";
 import { default as m } from "./components/PageLoader/PageLoader.js";
 import { default as n } from "./components/OtpInput/OtpInput.js";
 import { default as c } from "./components/Dropdown/Dropdown.js";
 import { default as C } from "./components/RootComponent/RootComponent.js";
 import { default as T } from "./components/Selectbox/Selectbox.js";
-import { default as S } from "./components/Button/Button.js";
-import { default as h } from "./components/Timer/Timer.js";
-import { default as R } from "./components/Shimmer/Shimmer.js";
-import { default as w } from "./components/VideoPlayer/VideoPlayer.js";
-import { default as B } from "./components/Image/Image.js";
-import { default as F } from "./components/Carousel/Carousel.js";
-import { default as H } from "./components/Typography/Headings/index.js";
-import { default as U } from "./components/Typography/P/P.js";
+import { default as I } from "./components/Button/Button.js";
+import { default as b } from "./components/Timer/Timer.js";
+import { default as L } from "./components/Shimmer/Shimmer.js";
+import { default as U } from "./components/VideoPlayer/VideoPlayer.js";
+import { default as y } from "./components/Image/Image.js";
+import { default as D } from "./components/Carousel/Carousel.js";
+import { default as G } from "./components/Typography/Headings/index.js";
+import { default as O } from "./components/Typography/P/P.js";
 import { default as j } from "./components/Input/Input/Input.js";
 import { default as v } from "./components/Input/Textarea/Textarea.js";
 import { default as A } from "./components/Input/Checkbox/Checkbox.js";
@@ -22,32 +22,36 @@ import { default as J } from "./components/Input/RadioGroup/RadioGroup.js";
 import { default as M } from "./components/Input/FileUploader/FileUploader.js";
 import { default as Q } from "./colors/index.js";
 import { default as X } from "./utils/index.js";
-import { default as Z } from "./components/Icons/index.js";
+import { default as Z } from "./hooks/index.js";
+import { default as $ } from "./react-utils/index.js";
+import { default as eo } from "./components/Icons/index.js";
 export {
-  S as Button,
-  F as Carousel,
+  I as Button,
+  D as Carousel,
   A as Checkbox,
   c as Dropdown,
   M as FileUploader,
-  H as Headings,
-  B as Image,
+  G as Headings,
+  y as Image,
   j as Input,
-  s as Loader,
+  d as Loader,
   n as OtpInput,
-  U as P,
+  O as P,
   m as PageLoader,
   a as Pagination,
   J as RadioGroup,
   C as RootComponent,
   T as Selectbox,
-  R as Shimmer,
-  d as Spinner,
+  L as Shimmer,
+  l as Spinner,
   v as Textarea,
-  h as Timer,
+  b as Timer,
   r as Toast,
   f as ToastContainer,
-  w as VideoPlayer,
+  U as VideoPlayer,
   Q as colors,
-  Z as icons,
+  Z as hooks,
+  eo as icons,
+  $ as reactUtils,
   X as utils
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meticulous-ui",
-  "version": "3.2.6",
+  "version": "3.2.8",
   "license": "ISC",
   "description": "A comprehensive React UI component library with a wide range of customizable components, icons, colors, and utilities for building modern web applications.",
   "main": "./index.js",

package/utils/announceToScreenReader.js

@@ -0,0 +1,9 @@
+const i = (t, o = "polite") => {
+  const e = document.createElement("div");
+  e.setAttribute("aria-live", o), e.setAttribute("aria-atomic", "true"), e.style.cssText = "position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0", document.body.appendChild(e), requestAnimationFrame(() => {
+    e.textContent = t, setTimeout(() => document.body.removeChild(e), 1e3);
+  });
+};
+export {
+  i as default
+};

package/utils/auditLog.js

@@ -0,0 +1,12 @@
+const t = (n, o = {}) => {
+  const e = {
+    action: n,
+    metadata: o,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    user: typeof window < "u" ? window.__currentUser ?? null : null
+  };
+  return typeof window < "u" && typeof window.__auditLogger == "function" ? window.__auditLogger(e) : console.log("[auditLog]", e), e;
+};
+export {
+  t as default
+};

package/utils/captureException.js

@@ -0,0 +1,12 @@
+const o = (e, n = {}) => {
+  const t = {
+    message: e instanceof Error ? e.message : String(e),
+    stack: e instanceof Error ? e.stack : void 0,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    ...n
+  };
+  return typeof window < "u" && typeof window.__captureException == "function" ? window.__captureException(t) : console.error("[captureException]", t), t;
+};
+export {
+  o as default
+};

package/utils/createPubSub.js

@@ -0,0 +1,11 @@
+const i = () => {
+  const u = {};
+  return { subscribe: (s, b) => ((u[s] ?? (u[s] = [])).push(b), () => {
+    u[s] = u[s].filter((c) => c !== b);
+  }), publish: (s, ...b) => {
+    (u[s] ?? []).forEach((c) => c(...b));
+  } };
+};
+export {
+  i as default
+};

package/utils/decodeJWT.js

@@ -0,0 +1,11 @@
+const e = (t) => {
+  try {
+    const [, a] = t.split(".");
+    return JSON.parse(atob(a));
+  } catch {
+    return null;
+  }
+};
+export {
+  e as default
+};

package/utils/deepFreeze.js

@@ -0,0 +1,7 @@
+const c = (e) => (Object.getOwnPropertyNames(e).forEach((r) => {
+  const t = e[r];
+  t && typeof t == "object" && c(t);
+}), Object.freeze(e));
+export {
+  c as default
+};

package/utils/fadeIn.js

@@ -0,0 +1,10 @@
+const s = (a, t = 300) => {
+  a.style.opacity = "0", a.style.display = "", a.style.transition = `opacity ${t}ms ease`, requestAnimationFrame(() => {
+    requestAnimationFrame(() => {
+      a.style.opacity = "1";
+    });
+  });
+};
+export {
+  s as default
+};

package/utils/fadeOut.js

@@ -0,0 +1,8 @@
+const a = (s, t = 300) => {
+  s.style.transition = `opacity ${t}ms ease`, s.style.opacity = "0", setTimeout(() => {
+    s.style.display = "none";
+  }, t);
+};
+export {
+  a as default
+};

package/utils/fallback.js

@@ -0,0 +1,4 @@
+const f = (n, d) => n != null && n !== "" ? n : d;
+export {
+  f as default
+};

package/utils/featureGate.js

@@ -0,0 +1,4 @@
+const a = (e) => typeof window < "u" && window.__featureFlags ? !!window.__featureFlags[e] : !1;
+export {
+  a as default
+};

package/utils/filterByKey.js

@@ -0,0 +1,4 @@
+const r = (e, t, f) => e.filter((l) => l[t] === f);
+export {
+  r as default
+};

package/utils/fuzzySearch.js

@@ -0,0 +1,16 @@
+const u = (r, o) => {
+  if (!o) return r;
+  const n = o.toLowerCase(), s = (t) => {
+    let e = 0;
+    const f = t.toLowerCase();
+    for (const c of n) {
+      if (e = f.indexOf(c, e), e === -1) return !1;
+      e++;
+    }
+    return !0;
+  };
+  return r.filter((t) => typeof t == "string" ? s(t) : Object.values(t).some((e) => typeof e == "string" && s(e)));
+};
+export {
+  u as default
+};

package/utils/generateAriaId.js

@@ -0,0 +1,5 @@
+let a = 0;
+const t = (e = "aria") => `${e}-${++a}`;
+export {
+  t as default
+};

package/utils/getToken.js

@@ -0,0 +1,4 @@
+const e = (t = "auth_token") => localStorage.getItem(t);
+export {
+  e as default
+};

package/utils/getVariant.js

@@ -0,0 +1,10 @@
+const n = (t, a = "ab_variants") => {
+  try {
+    return JSON.parse(localStorage.getItem(a) ?? "{}")[t] ?? null;
+  } catch {
+    return null;
+  }
+};
+export {
+  n as default
+};

package/utils/handleKeyboardNavigation.js

@@ -0,0 +1,17 @@
+const y = (a, t, h = {}) => {
+  const { onSelect: o, loop: l = !0, orientation: p = "vertical" } = h, n = p === "horizontal" ? "ArrowLeft" : "ArrowUp", v = p === "horizontal" ? "ArrowRight" : "ArrowDown";
+  return (r) => {
+    if (r.key === v) {
+      r.preventDefault();
+      const f = t + 1 >= a.length ? l ? 0 : t : t + 1;
+      o == null || o(f, a[f]);
+    } else if (r.key === n) {
+      r.preventDefault();
+      const f = t - 1 < 0 ? l ? a.length - 1 : t : t - 1;
+      o == null || o(f, a[f]);
+    } else r.key === "Home" ? (r.preventDefault(), o == null || o(0, a[0])) : r.key === "End" && (r.preventDefault(), o == null || o(a.length - 1, a[a.length - 1]));
+  };
+};
+export {
+  y as default
+};

package/utils/hasPermission.js

@@ -0,0 +1,13 @@
+import n from "./decodeJWT.js";
+import a from "./getToken.js";
+const l = (o, s = "auth_token") => {
+  const t = a(s);
+  if (!t) return !1;
+  const r = n(t);
+  if (!r) return !1;
+  const e = r.roles ?? r.role ?? [];
+  return Array.isArray(e) ? e.includes(o) : e === o;
+};
+export {
+  l as default
+};

package/utils/identity.js

@@ -0,0 +1,4 @@
+const e = (t) => t;
+export {
+  e as default
+};

package/utils/index.js

@@ -7,12 +7,12 @@ import e from "./compose.js";
 import p from "./deepClone.js";
 import f from "./flattenObject.js";
 import a from "./formatCompactNumber.js";
-import s from "./formatCurrency.js";
-import l from "./formatDate.js";
-import n from "./formatNumber.js";
+import n from "./formatCurrency.js";
+import s from "./formatDate.js";
+import l from "./formatNumber.js";
 import c from "./formatTime.js";
-import u from "./generateInitials.js";
-import d from "./getGreetingByTime.js";
+import d from "./generateInitials.js";
+import u from "./getGreetingByTime.js";
 import g from "./groupBy.js";
 import y from "./hasEqualProps.js";
 import S from "./addDays.js";
@@ -20,33 +20,33 @@ import T from "./countdown.js";
 import k from "./differenceInDays.js";
 import b from "./isEmpty.js";
 import h from "./isEqual.js";
-import C from "./isNonEmptyArray.js";
-import P from "./isPast.js";
-import E from "./isToday.js";
+import P from "./isNonEmptyArray.js";
+import E from "./isPast.js";
+import C from "./isToday.js";
 import L from "./kebabCase.js";
-import B from "./keyBy.js";
-import A from "./maskEmail.js";
-import q from "./maskPhone.js";
+import A from "./keyBy.js";
+import B from "./maskEmail.js";
+import I from "./maskPhone.js";
 import w from "./mergeDeep.js";
-import I from "./omit.js";
-import D from "./percentage.js";
-import N from "./pick.js";
-import v from "./randomBetween.js";
-import x from "./randomInt.js";
-import z from "./randomValue.js";
-import O from "./removeExtraSpaces.js";
-import R from "./roundTo.js";
-import F from "./slugify.js";
-import Q from "./snakeCase.js";
-import G from "./sortBy.js";
-import M from "./timeAgo.js";
-import U from "./titleCase.js";
-import j from "./truncate.js";
-import V from "./uniqueBy.js";
-import H from "./isEmail.js";
-import J from "./isPhone.js";
-import K from "./isURL.js";
-import W from "./isPasswordStrong.js";
+import N from "./omit.js";
+import v from "./percentage.js";
+import z from "./pick.js";
+import F from "./randomBetween.js";
+import O from "./randomInt.js";
+import q from "./randomValue.js";
+import x from "./removeExtraSpaces.js";
+import D from "./roundTo.js";
+import R from "./slugify.js";
+import G from "./snakeCase.js";
+import J from "./sortBy.js";
+import Q from "./timeAgo.js";
+import V from "./titleCase.js";
+import K from "./truncate.js";
+import M from "./uniqueBy.js";
+import U from "./isEmail.js";
+import W from "./isPhone.js";
+import j from "./isURL.js";
+import H from "./isPasswordStrong.js";
 import X from "./isPAN.js";
 import Y from "./isAadhaar.js";
 import Z from "./isGST.js";
@@ -61,9 +61,9 @@ import eo from "./isDarkMode.js";
 import po from "./isOnline.js";
 import fo from "./copyToClipboard.js";
 import ao from "./downloadFile.js";
-import so from "./openInNewTab.js";
-import lo from "./getScreenSize.js";
-import no from "./getQueryParams.js";
+import no from "./openInNewTab.js";
+import so from "./getScreenSize.js";
+import lo from "./getQueryParams.js";
 import co from "./setQueryParam.js";
 import uo from "./removeQueryParam.js";
 import go from "./buildURL.js";
@@ -73,64 +73,104 @@ import To from "./isActiveRoute.js";
 import ko from "./setLocalStorage.js";
 import bo from "./getLocalStorage.js";
 import ho from "./removeLocalStorage.js";
-import Co from "./setSessionStorage.js";
-import Po from "./getSessionStorage.js";
-import Eo from "./clearStorage.js";
+import Po from "./setSessionStorage.js";
+import Eo from "./getSessionStorage.js";
+import Co from "./clearStorage.js";
 import Lo from "./debounce.js";
-import Bo from "./throttle.js";
-import Ao from "./memoize.js";
-import qo from "./lazyLoadComponent.js";
+import Ao from "./throttle.js";
+import Bo from "./memoize.js";
+import Io from "./lazyLoadComponent.js";
 import wo from "./requestIdleTask.js";
-import Io from "./rafThrottle.js";
-import Do from "./scrollToTop.js";
-import No from "./scrollToElement.js";
-import vo from "./lockBodyScroll.js";
-import xo from "./unlockBodyScroll.js";
-import zo from "./toggleFullscreen.js";
-import Oo from "./focusElement.js";
-import Ro from "./detectOutsideClick.js";
-import Fo from "./measureElement.js";
-import Qo from "./retry.js";
-import Go from "./sleep.js";
-import Mo from "./withTimeout.js";
-import Uo from "./parallel.js";
-import jo from "./sequential.js";
-import Vo from "./safeAsync.js";
-import Ho from "./cancelablePromise.js";
-const Rm = {
+import No from "./rafThrottle.js";
+import vo from "./scrollToTop.js";
+import zo from "./scrollToElement.js";
+import Fo from "./lockBodyScroll.js";
+import Oo from "./unlockBodyScroll.js";
+import qo from "./toggleFullscreen.js";
+import xo from "./focusElement.js";
+import Do from "./detectOutsideClick.js";
+import Ro from "./measureElement.js";
+import Go from "./announceToScreenReader.js";
+import Jo from "./trapFocus.js";
+import Qo from "./generateAriaId.js";
+import Vo from "./handleKeyboardNavigation.js";
+import Ko from "./logError.js";
+import Mo from "./captureException.js";
+import Uo from "./safeJSONParse.js";
+import Wo from "./safeJSONStringify.js";
+import jo from "./fallback.js";
+import Ho from "./isAuthenticated.js";
+import Xo from "./getToken.js";
+import Yo from "./setToken.js";
+import Zo from "./removeToken.js";
+import _o from "./decodeJWT.js";
+import $o from "./hasPermission.js";
+import or from "./isFeatureEnabled.js";
+import rr from "./getVariant.js";
+import mr from "./retry.js";
+import tr from "./sleep.js";
+import ir from "./withTimeout.js";
+import er from "./parallel.js";
+import pr from "./sequential.js";
+import fr from "./safeAsync.js";
+import ar from "./cancelablePromise.js";
+import nr from "./fuzzySearch.js";
+import sr from "./filterByKey.js";
+import lr from "./multiSort.js";
+import cr from "./paginate.js";
+import dr from "./fadeIn.js";
+import ur from "./fadeOut.js";
+import gr from "./smoothScroll.js";
+import yr from "./waitForTransitionEnd.js";
+import Sr from "./trackEvent.js";
+import Tr from "./trackPageView.js";
+import kr from "./measurePerformance.js";
+import br from "./featureGate.js";
+import hr from "./permissionGuard.js";
+import Pr from "./auditLog.js";
+import Er from "./logInfo.js";
+import Cr from "./logWarn.js";
+import Lr from "./once.js";
+import Ar from "./noop.js";
+import Br from "./identity.js";
+import Ir from "./pipe.js";
+import wr from "./singleton.js";
+import Nr from "./createPubSub.js";
+import vr from "./deepFreeze.js";
+const ni = {
   // string
   capFirstLetter: o,
   capitalize: r,
   camelCase: m,
-  generateInitials: u,
+  generateInitials: d,
   kebabCase: L,
-  maskEmail: A,
-  maskPhone: q,
-  removeExtraSpaces: O,
-  slugify: F,
-  snakeCase: Q,
-  titleCase: U,
-  truncate: j,
+  maskEmail: B,
+  maskPhone: I,
+  removeExtraSpaces: x,
+  slugify: R,
+  snakeCase: G,
+  titleCase: V,
+  truncate: K,
   // number
   clamp: i,
   formatCompactNumber: a,
-  formatCurrency: s,
-  formatNumber: n,
-  percentage: D,
-  randomBetween: v,
-  randomInt: x,
-  randomValue: z,
-  roundTo: R,
+  formatCurrency: n,
+  formatNumber: l,
+  percentage: v,
+  randomBetween: F,
+  randomInt: O,
+  randomValue: q,
+  roundTo: D,
   // date-time
   addDays: S,
   countdown: T,
   differenceInDays: k,
-  formatDate: l,
+  formatDate: s,
   formatTime: c,
-  getGreetingByTime: d,
-  isPast: P,
-  isToday: E,
-  timeAgo: M,
+  getGreetingByTime: u,
+  isPast: E,
+  isToday: C,
+  timeAgo: Q,
   // object / array
   chunk: t,
   compose: e,
@@ -140,18 +180,18 @@ const Rm = {
   hasEqualProps: y,
   isEmpty: b,
   isEqual: h,
-  isNonEmptyArray: C,
-  keyBy: B,
+  isNonEmptyArray: P,
+  keyBy: A,
   mergeDeep: w,
-  omit: I,
-  pick: N,
-  sortBy: G,
-  uniqueBy: V,
+  omit: N,
+  pick: z,
+  sortBy: J,
+  uniqueBy: M,
   // validation
-  isEmail: H,
-  isPhone: J,
-  isURL: K,
-  isPasswordStrong: W,
+  isEmail: U,
+  isPhone: W,
+  isURL: j,
+  isPasswordStrong: H,
   isPAN: X,
   isAadhaar: Y,
   isGST: Z,
@@ -167,10 +207,10 @@ const Rm = {
   isOnline: po,
   copyToClipboard: fo,
   downloadFile: ao,
-  openInNewTab: so,
-  getScreenSize: lo,
+  openInNewTab: no,
+  getScreenSize: so,
   // routing
-  getQueryParams: no,
+  getQueryParams: lo,
   setQueryParam: co,
   removeQueryParam: uo,
   buildURL: go,
@@ -181,34 +221,82 @@ const Rm = {
   setLocalStorage: ko,
   getLocalStorage: bo,
   removeLocalStorage: ho,
-  setSessionStorage: Co,
-  getSessionStorage: Po,
-  clearStorage: Eo,
+  setSessionStorage: Po,
+  getSessionStorage: Eo,
+  clearStorage: Co,
   // performance
   debounce: Lo,
-  throttle: Bo,
-  memoize: Ao,
-  lazyLoadComponent: qo,
+  throttle: Ao,
+  memoize: Bo,
+  lazyLoadComponent: Io,
   requestIdleTask: wo,
-  rafThrottle: Io,
+  rafThrottle: No,
   // ui / dom
-  scrollToTop: Do,
-  scrollToElement: No,
-  lockBodyScroll: vo,
-  unlockBodyScroll: xo,
-  toggleFullscreen: zo,
-  focusElement: Oo,
-  detectOutsideClick: Ro,
-  measureElement: Fo,
+  scrollToTop: vo,
+  scrollToElement: zo,
+  lockBodyScroll: Fo,
+  unlockBodyScroll: Oo,
+  toggleFullscreen: qo,
+  focusElement: xo,
+  detectOutsideClick: Do,
+  measureElement: Ro,
+  // accessibility
+  announceToScreenReader: Go,
+  trapFocus: Jo,
+  generateAriaId: Qo,
+  handleKeyboardNavigation: Vo,
+  // error handling
+  logError: Ko,
+  captureException: Mo,
+  safeJSONParse: Uo,
+  safeJSONStringify: Wo,
+  fallback: jo,
+  // auth
+  isAuthenticated: Ho,
+  getToken: Xo,
+  setToken: Yo,
+  removeToken: Zo,
+  decodeJWT: _o,
+  hasPermission: $o,
+  // feature flags
+  isFeatureEnabled: or,
+  getVariant: rr,
   // async / api
-  retry: Qo,
-  sleep: Go,
-  withTimeout: Mo,
-  parallel: Uo,
-  sequential: jo,
-  safeAsync: Vo,
-  cancelablePromise: Ho
+  retry: mr,
+  sleep: tr,
+  withTimeout: ir,
+  parallel: er,
+  sequential: pr,
+  safeAsync: fr,
+  cancelablePromise: ar,
+  // filter
+  fuzzySearch: nr,
+  filterByKey: sr,
+  multiSort: lr,
+  paginate: cr,
+  // animation
+  fadeIn: dr,
+  fadeOut: ur,
+  smoothScroll: gr,
+  waitForTransitionEnd: yr,
+  // enterprise
+  trackEvent: Sr,
+  trackPageView: Tr,
+  measurePerformance: kr,
+  featureGate: br,
+  permissionGuard: hr,
+  auditLog: Pr,
+  logInfo: Er,
+  logWarn: Cr,
+  // function
+  once: Lr,
+  noop: Ar,
+  identity: Br,
+  pipe: Ir,
+  singleton: wr,
+  createPubSub: Nr,
+  deepFreeze: vr
 };
 export {
-  Rm as default
+  ni as default
 };

package/utils/isAuthenticated.js

@@ -0,0 +1,14 @@
+import o from "./getToken.js";
+const s = (r = "auth_token") => {
+  const t = o(r);
+  if (!t) return !1;
+  try {
+    const [, n] = t.split("."), { exp: e } = JSON.parse(atob(n));
+    return !(e && Date.now() / 1e3 > e);
+  } catch {
+    return !!t;
+  }
+};
+export {
+  s as default
+};

package/utils/isFeatureEnabled.js

@@ -0,0 +1,10 @@
+const r = (e, t = "feature_flags") => {
+  try {
+    return JSON.parse(localStorage.getItem(t) ?? "{}")[e] === !0;
+  } catch {
+    return !1;
+  }
+};
+export {
+  r as default
+};

package/utils/logError.js

@@ -0,0 +1,7 @@
+const c = (s, n = {}) => {
+  const o = s instanceof Error ? s.message : String(s), t = s instanceof Error ? s.stack : void 0;
+  console.error("[logError]", o, { ...n, stack: t });
+};
+export {
+  c as default
+};

package/utils/logInfo.js

@@ -0,0 +1,8 @@
+const f = (e, t = {}) => {
+  var n;
+  const o = { level: "info", message: e, ...t, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+  return typeof window < "u" && typeof ((n = window.__logger) == null ? void 0 : n.info) == "function" ? window.__logger.info(o) : console.info("[logInfo]", o), o;
+};
+export {
+  f as default
+};

package/utils/logWarn.js

@@ -0,0 +1,8 @@
+const r = (o, t = {}) => {
+  var e;
+  const n = { level: "warn", message: o, ...t, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+  return typeof window < "u" && typeof ((e = window.__logger) == null ? void 0 : e.warn) == "function" ? window.__logger.warn(n) : console.warn("[logWarn]", n), n;
+};
+export {
+  r as default
+};

package/utils/measurePerformance.js

@@ -0,0 +1,12 @@
+const r = (o) => {
+  const e = typeof performance < "u" ? performance.getEntriesByName(o)[0] ?? null : null, n = {
+    metric: o,
+    duration: (e == null ? void 0 : e.duration) ?? null,
+    startTime: (e == null ? void 0 : e.startTime) ?? null,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  return typeof window < "u" && typeof window.__performanceReporter == "function" ? window.__performanceReporter(n) : console.log("[measurePerformance]", n), n;
+};
+export {
+  r as default
+};

package/utils/multiSort.js

@@ -0,0 +1,11 @@
+const u = (f, s) => [...f].sort((o, r) => {
+  for (const { key: t, order: n = "asc" } of s) {
+    const c = typeof t == "function" ? t(o) : o[t], e = typeof t == "function" ? t(r) : r[t];
+    if (c < e) return n === "asc" ? -1 : 1;
+    if (c > e) return n === "asc" ? 1 : -1;
+  }
+  return 0;
+});
+export {
+  u as default
+};

package/utils/noop.js

@@ -0,0 +1,5 @@
+const o = () => {
+};
+export {
+  o as default
+};

package/utils/once.js

@@ -0,0 +1,7 @@
+const u = (l) => {
+  let e = !1, t;
+  return (...r) => (e || (e = !0, t = l(...r)), t);
+};
+export {
+  u as default
+};

package/utils/paginate.js

@@ -0,0 +1,13 @@
+const c = (a, s, t) => {
+  const e = a.length, o = Math.ceil(e / t), n = (s - 1) * t;
+  return {
+    data: a.slice(n, n + t),
+    total: e,
+    page: s,
+    limit: t,
+    totalPages: o
+  };
+};
+export {
+  c as default
+};

package/utils/permissionGuard.js

@@ -0,0 +1,4 @@
+const i = (r, e = []) => typeof window < "u" && Array.isArray(window.__userRoles) ? window.__userRoles.includes(r) : Array.isArray(e) && e.includes(r);
+export {
+  i as default
+};

package/utils/pipe.js

@@ -0,0 +1,4 @@
+const c = (...e) => (p) => e.reduce((t, a) => a(t), p);
+export {
+  c as default
+};

package/utils/removeToken.js

@@ -0,0 +1,4 @@
+const o = (e = "auth_token") => localStorage.removeItem(e);
+export {
+  o as default
+};

package/utils/safeJSONParse.js

@@ -0,0 +1,10 @@
+const t = (r, e = null) => {
+  try {
+    return JSON.parse(r);
+  } catch {
+    return e;
+  }
+};
+export {
+  t as default
+};

package/utils/safeJSONStringify.js

@@ -0,0 +1,10 @@
+const e = (t, r = "", n) => {
+  try {
+    return JSON.stringify(t, null, n);
+  } catch {
+    return r;
+  }
+};
+export {
+  e as default
+};

package/utils/setToken.js

@@ -0,0 +1,4 @@
+const o = (t, e = "auth_token") => localStorage.setItem(e, t);
+export {
+  o as default
+};

package/utils/singleton.js

@@ -0,0 +1,7 @@
+const t = (n) => {
+  let e;
+  return () => (e === void 0 && (e = n()), e);
+};
+export {
+  t as default
+};

package/utils/smoothScroll.js

@@ -0,0 +1,14 @@
+const u = (o, i = 500) => {
+  var t;
+  const e = window.scrollY, r = (typeof o == "number" ? o : ((t = o instanceof Element ? o : document.querySelector(o)) == null ? void 0 : t.getBoundingClientRect().top) + window.scrollY) - e;
+  let n = null;
+  const s = (c) => {
+    n || (n = c);
+    const d = c - n, l = Math.min(d / i, 1), a = 1 - Math.pow(1 - l, 3);
+    window.scrollTo(0, e + r * a), l < 1 && requestAnimationFrame(s);
+  };
+  requestAnimationFrame(s);
+};
+export {
+  u as default
+};

package/utils/trackEvent.js

@@ -0,0 +1,8 @@
+const a = (e, o = {}) => {
+  var n;
+  const t = { name: e, payload: o, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+  return typeof window < "u" && typeof ((n = window.__analytics) == null ? void 0 : n.track) == "function" ? window.__analytics.track(t) : console.log("[trackEvent]", t), t;
+};
+export {
+  a as default
+};

package/utils/trackPageView.js

@@ -0,0 +1,12 @@
+const o = (t) => {
+  var n;
+  const e = {
+    path: t,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    referrer: typeof document < "u" && document.referrer || null
+  };
+  return typeof window < "u" && typeof ((n = window.__analytics) == null ? void 0 : n.page) == "function" ? window.__analytics.page(e) : console.log("[trackPageView]", e), e;
+};
+export {
+  o as default
+};

package/utils/trapFocus.js

@@ -0,0 +1,16 @@
+const c = 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])', d = (t) => {
+  const e = (t == null ? void 0 : t.current) ?? t;
+  if (!e) return () => {
+  };
+  const i = () => [...e.querySelectorAll(c)], s = (n) => {
+    if (n.key !== "Tab") return;
+    const o = i();
+    if (!o.length) return;
+    const r = o[0], a = o[o.length - 1];
+    n.shiftKey ? document.activeElement === r && (n.preventDefault(), a.focus()) : document.activeElement === a && (n.preventDefault(), r.focus());
+  };
+  return e.addEventListener("keydown", s), () => e.removeEventListener("keydown", s);
+};
+export {
+  d as default
+};

package/utils/waitForTransitionEnd.js

@@ -0,0 +1,9 @@
+const a = (n, t) => new Promise((i) => {
+  const e = (r) => {
+    t && r.propertyName !== t || (n.removeEventListener("transitionend", e), i(r));
+  };
+  n.addEventListener("transitionend", e);
+});
+export {
+  a as default
+};