meticulous-ui 3.2.7 → 3.2.9

package/README.md

@@ -159,6 +159,32 @@ import blue from 'meticulous-ui/colors/blue';
 | **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/hooks/index.js

@@ -0,0 +1,46 @@
+import o from "./usePrevious.js";
+import r from "./useDebounce.js";
+import e from "./useThrottle.js";
+import m from "./useIsMounted.js";
+import t from "./useEventListener.js";
+import i from "./useIntersectionObserver.js";
+import s from "./useMediaQuery.js";
+import u from "./useLocalStorage.js";
+import p from "./useSessionStorage.js";
+import f from "./useOutsideClick.js";
+import n from "./useWindowSize.js";
+import a from "./useOnlineStatus.js";
+import d from "./useCopyToClipboard.js";
+import l from "./useToggle.js";
+import c from "./useTimeout.js";
+import S from "./useInterval.js";
+import g from "./useUnmount.js";
+import v from "./useFirstRender.js";
+const R = {
+  // state
+  usePrevious: o,
+  useDebounce: r,
+  useThrottle: e,
+  useToggle: l,
+  // lifecycle
+  useIsMounted: m,
+  useUnmount: g,
+  useFirstRender: v,
+  useTimeout: c,
+  useInterval: S,
+  // dom / browser
+  useEventListener: t,
+  useIntersectionObserver: i,
+  useMediaQuery: s,
+  useOutsideClick: f,
+  useWindowSize: n,
+  useOnlineStatus: a,
+  // storage
+  useLocalStorage: u,
+  useSessionStorage: p,
+  // utility
+  useCopyToClipboard: d
+};
+export {
+  R as default
+};

package/hooks/useCopyToClipboard.js

@@ -0,0 +1,14 @@
+import { useState as a } from "react";
+const c = () => {
+  const [e, t] = a(!1);
+  return [e, async (o) => {
+    try {
+      await navigator.clipboard.writeText(o), t(!0), setTimeout(() => t(!1), 2e3);
+    } catch {
+      t(!1);
+    }
+  }];
+};
+export {
+  c as default
+};

package/hooks/useDebounce.js

@@ -0,0 +1,11 @@
+import { useState as c, useEffect as n } from "react";
+const d = (e, t) => {
+  const [o, s] = c(e);
+  return n(() => {
+    const u = setTimeout(() => s(e), t);
+    return () => clearTimeout(u);
+  }, [e, t]), o;
+};
+export {
+  d as default
+};

package/hooks/useEventListener.js

@@ -0,0 +1,15 @@
+import { useRef as o, useEffect as c } from "react";
+const f = (r, s, e = window) => {
+  const t = o(s);
+  c(() => {
+    t.current = s;
+  }, [s]), c(() => {
+    const n = e && "current" in e ? e.current : e;
+    if (!(n != null && n.addEventListener)) return;
+    const u = (i) => t.current(i);
+    return n.addEventListener(r, u), () => n.removeEventListener(r, u);
+  }, [r, e]);
+};
+export {
+  f as default
+};

package/hooks/useFirstRender.js

@@ -0,0 +1,10 @@
+import { useRef as r, useEffect as t } from "react";
+const u = () => {
+  const e = r(!0);
+  return t(() => {
+    e.current = !1;
+  }, []), e.current;
+};
+export {
+  u as default
+};

package/hooks/useIntersectionObserver.js

@@ -0,0 +1,13 @@
+import { useState as u, useEffect as l } from "react";
+const b = (r, e = {}) => {
+  const [s, o] = u(null);
+  return l(() => {
+    const t = r.current;
+    if (!t) return;
+    const n = new IntersectionObserver(([c]) => o(c), e);
+    return n.observe(t), () => n.disconnect();
+  }, [r, e.threshold, e.root, e.rootMargin]), s;
+};
+export {
+  b as default
+};

package/hooks/useInterval.js

@@ -0,0 +1,14 @@
+import { useRef as u, useEffect as n } from "react";
+const o = (e, r) => {
+  const t = u(e);
+  n(() => {
+    t.current = e;
+  }, [e]), n(() => {
+    if (r === null) return;
+    const s = setInterval(() => t.current(), r);
+    return () => clearInterval(s);
+  }, [r]);
+};
+export {
+  o as default
+};

package/hooks/useIsMounted.js

@@ -0,0 +1,10 @@
+import { useRef as t, useEffect as r } from "react";
+const s = () => {
+  const e = t(!1);
+  return r(() => (e.current = !0, () => {
+    e.current = !1;
+  }), []), e;
+};
+export {
+  s as default
+};

package/hooks/useLocalStorage.js

@@ -0,0 +1,28 @@
+import { useState as n } from "react";
+const g = (e, o) => {
+  const [r, c] = n(() => {
+    try {
+      const t = localStorage.getItem(e);
+      return t !== null ? JSON.parse(t) : o;
+    } catch {
+      return o;
+    }
+  });
+  return [r, (t) => {
+    const s = typeof t == "function" ? t(r) : t;
+    c(s);
+    try {
+      localStorage.setItem(e, JSON.stringify(s));
+    } catch {
+    }
+  }, () => {
+    c(o);
+    try {
+      localStorage.removeItem(e);
+    } catch {
+    }
+  }];
+};
+export {
+  g as default
+};

package/hooks/useMediaQuery.js

@@ -0,0 +1,11 @@
+import { useState as o, useEffect as r } from "react";
+const h = (e) => {
+  const [n, s] = o(() => window.matchMedia(e).matches);
+  return r(() => {
+    const t = window.matchMedia(e), a = (c) => s(c.matches);
+    return t.addEventListener("change", a), () => t.removeEventListener("change", a);
+  }, [e]), n;
+};
+export {
+  h as default
+};

package/hooks/useOnlineStatus.js

@@ -0,0 +1,13 @@
+import { useState as o, useEffect as s } from "react";
+const f = () => {
+  const [i, e] = o(navigator.onLine);
+  return s(() => {
+    const n = () => e(!0), t = () => e(!1);
+    return window.addEventListener("online", n), window.addEventListener("offline", t), () => {
+      window.removeEventListener("online", n), window.removeEventListener("offline", t);
+    };
+  }, []), i;
+};
+export {
+  f as default
+};

package/hooks/useOutsideClick.js

@@ -0,0 +1,14 @@
+import { useEffect as r } from "react";
+const u = (e, n) => {
+  r(() => {
+    const t = (o) => {
+      e.current && !e.current.contains(o.target) && n(o);
+    };
+    return document.addEventListener("mousedown", t), document.addEventListener("touchstart", t), () => {
+      document.removeEventListener("mousedown", t), document.removeEventListener("touchstart", t);
+    };
+  }, [e, n]);
+};
+export {
+  u as default
+};

package/hooks/usePrevious.js

@@ -0,0 +1,10 @@
+import { useRef as t, useEffect as u } from "react";
+const n = (r) => {
+  const e = t(void 0);
+  return u(() => {
+    e.current = r;
+  }), e.current;
+};
+export {
+  n as default
+};

package/hooks/useSessionStorage.js

@@ -0,0 +1,28 @@
+import { useState as c } from "react";
+const g = (e, s) => {
+  const [o, r] = c(() => {
+    try {
+      const t = sessionStorage.getItem(e);
+      return t !== null ? JSON.parse(t) : s;
+    } catch {
+      return s;
+    }
+  });
+  return [o, (t) => {
+    const n = typeof t == "function" ? t(o) : t;
+    r(n);
+    try {
+      sessionStorage.setItem(e, JSON.stringify(n));
+    } catch {
+    }
+  }, () => {
+    r(s);
+    try {
+      sessionStorage.removeItem(e);
+    } catch {
+    }
+  }];
+};
+export {
+  g as default
+};

package/hooks/useThrottle.js

@@ -0,0 +1,16 @@
+import { useState as c, useRef as u, useEffect as i } from "react";
+const f = (t, e) => {
+  const [r, n] = c(t), o = u(Date.now());
+  return i(() => {
+    const s = e - (Date.now() - o.current), a = setTimeout(
+      () => {
+        n(t), o.current = Date.now();
+      },
+      Math.max(0, s)
+    );
+    return () => clearTimeout(a);
+  }, [t, e]), r;
+};
+export {
+  f as default
+};

package/hooks/useTimeout.js

@@ -0,0 +1,14 @@
+import { useRef as s, useEffect as u } from "react";
+const f = (e, t) => {
+  const r = s(e);
+  u(() => {
+    r.current = e;
+  }, [e]), u(() => {
+    if (t === null) return;
+    const o = setTimeout(() => r.current(), t);
+    return () => clearTimeout(o);
+  }, [t]);
+};
+export {
+  f as default
+};

package/hooks/useToggle.js

@@ -0,0 +1,10 @@
+import { useState as u, useCallback as r } from "react";
+const f = (o = !1) => {
+  const [t, a] = u(o), l = r((e) => {
+    a((s) => typeof e == "boolean" ? e : !s);
+  }, []);
+  return [t, l];
+};
+export {
+  f as default
+};

package/hooks/useUnmount.js

@@ -0,0 +1,10 @@
+import { useRef as u, useEffect as r } from "react";
+const s = (e) => {
+  const t = u(e);
+  r(() => {
+    t.current = e;
+  }, [e]), r(() => () => t.current(), []);
+};
+export {
+  s as default
+};

package/hooks/useWindowSize.js

@@ -0,0 +1,14 @@
+import { useState as t, useEffect as r } from "react";
+const w = () => {
+  const [i, n] = t({
+    width: window.innerWidth,
+    height: window.innerHeight
+  });
+  return r(() => {
+    const e = () => n({ width: window.innerWidth, height: window.innerHeight });
+    return window.addEventListener("resize", e), () => window.removeEventListener("resize", e);
+  }, []), i;
+};
+export {
+  w as default
+};

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 "./reactUtils/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.7",
+  "version": "3.2.9",
   "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",
@@ -18,6 +18,8 @@
     "colors",
     "components",
     "utils",
+    "hooks",
+    "reactUtils",
     "package.json",
     "README.md"
   ],

package/reactUtils/composeProviders.js

@@ -0,0 +1,5 @@
+import { jsx as t } from "react/jsx-runtime";
+const d = (...e) => ({ children: o }) => e.reduceRight((r, s) => /* @__PURE__ */ t(s, { children: r }), o);
+export {
+  d as default
+};

package/reactUtils/createContextHook.js

@@ -0,0 +1,12 @@
+import { createContext as n, useContext as s } from "react";
+const i = (o) => {
+  const e = n(o), r = () => {
+    const t = s(e);
+    if (t === void 0) throw new Error("useContext must be used inside its Provider");
+    return t;
+  };
+  return [e.Provider, r];
+};
+export {
+  i as default
+};

package/reactUtils/createPortalNode.js

@@ -0,0 +1,7 @@
+const d = (t = "div") => {
+  const e = document.createElement(t);
+  return document.body.appendChild(e), e;
+};
+export {
+  d as default
+};

package/reactUtils/index.js

@@ -0,0 +1,19 @@
+import o from "./createContextHook.js";
+import r from "./composeProviders.js";
+import m from "./lazyImport.js";
+import t from "./withErrorBoundary.js";
+import e from "./withSuspense.js";
+import p from "./memoCompare.js";
+import i from "./createPortalNode.js";
+const u = {
+  createContextHook: o,
+  composeProviders: r,
+  lazyImport: m,
+  withErrorBoundary: t,
+  withSuspense: e,
+  memoCompare: p,
+  createPortalNode: i
+};
+export {
+  u as default
+};

package/reactUtils/lazyImport.js

@@ -0,0 +1,7 @@
+import { lazy as l } from "react";
+const e = (o, t) => ({
+  [t]: l(() => o().then((a) => ({ default: a[t] })))
+});
+export {
+  e as default
+};

package/reactUtils/memoCompare.js

@@ -0,0 +1,5 @@
+import { memo as e } from "react";
+const t = (m, o) => e(m, o);
+export {
+  t as default
+};

package/reactUtils/withErrorBoundary.js

@@ -0,0 +1,24 @@
+import { jsx as o } from "react/jsx-runtime";
+import { Component as a } from "react";
+class n extends a {
+  constructor(r) {
+    super(r), this.state = { hasError: !1, error: null };
+  }
+  static getDerivedStateFromError(r) {
+    return { hasError: !0, error: r };
+  }
+  render() {
+    if (this.state.hasError) {
+      const r = this.props.fallback;
+      return /* @__PURE__ */ o(r, { error: this.state.error });
+    }
+    return this.props.children;
+  }
+}
+const h = (t, r) => {
+  const s = (e) => /* @__PURE__ */ o(n, { fallback: r, children: /* @__PURE__ */ o(t, { ...e }) });
+  return s.displayName = `withErrorBoundary(${t.displayName ?? t.name ?? "Component"})`, s;
+};
+export {
+  h as default
+};

package/reactUtils/withSuspense.js

@@ -0,0 +1,9 @@
+import { jsx as t } from "react/jsx-runtime";
+import { Suspense as u } from "react";
+const r = (s, i = null) => {
+  const e = (n) => /* @__PURE__ */ t(u, { fallback: i, children: /* @__PURE__ */ t(s, { ...n }) });
+  return e.displayName = `withSuspense(${s.displayName ?? s.name ?? "Component"})`, e;
+};
+export {
+  r 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/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/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/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/identity.js

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

package/utils/index.js

@@ -7,8 +7,8 @@ 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 n from "./formatDate.js";
+import n from "./formatCurrency.js";
+import s from "./formatDate.js";
 import l from "./formatNumber.js";
 import c from "./formatTime.js";
 import d from "./generateInitials.js";
@@ -20,32 +20,32 @@ import T from "./countdown.js";
 import k from "./differenceInDays.js";
 import b from "./isEmpty.js";
 import h from "./isEqual.js";
-import E from "./isNonEmptyArray.js";
-import P from "./isPast.js";
+import P from "./isNonEmptyArray.js";
+import E from "./isPast.js";
 import C from "./isToday.js";
-import A from "./kebabCase.js";
-import L from "./keyBy.js";
+import L from "./kebabCase.js";
+import A from "./keyBy.js";
 import B from "./maskEmail.js";
-import N from "./maskPhone.js";
-import I from "./mergeDeep.js";
-import q from "./omit.js";
+import I from "./maskPhone.js";
+import w from "./mergeDeep.js";
+import N from "./omit.js";
 import v from "./percentage.js";
-import w from "./pick.js";
-import O from "./randomBetween.js";
-import x from "./randomInt.js";
-import D from "./randomValue.js";
-import F from "./removeExtraSpaces.js";
-import R from "./roundTo.js";
-import z from "./slugify.js";
-import J from "./snakeCase.js";
-import Q from "./sortBy.js";
-import G from "./timeAgo.js";
-import M from "./titleCase.js";
-import U from "./truncate.js";
-import V from "./uniqueBy.js";
-import j from "./isEmail.js";
-import K from "./isPhone.js";
-import W from "./isURL.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";
@@ -61,8 +61,8 @@ 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 no from "./getScreenSize.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";
@@ -73,32 +73,32 @@ import To from "./isActiveRoute.js";
 import ko from "./setLocalStorage.js";
 import bo from "./getLocalStorage.js";
 import ho from "./removeLocalStorage.js";
-import Eo from "./setSessionStorage.js";
-import Po from "./getSessionStorage.js";
+import Po from "./setSessionStorage.js";
+import Eo from "./getSessionStorage.js";
 import Co from "./clearStorage.js";
-import Ao from "./debounce.js";
-import Lo from "./throttle.js";
+import Lo from "./debounce.js";
+import Ao from "./throttle.js";
 import Bo from "./memoize.js";
-import No from "./lazyLoadComponent.js";
-import Io from "./requestIdleTask.js";
-import qo from "./rafThrottle.js";
+import Io from "./lazyLoadComponent.js";
+import wo from "./requestIdleTask.js";
+import No from "./rafThrottle.js";
 import vo from "./scrollToTop.js";
-import wo from "./scrollToElement.js";
-import Oo from "./lockBodyScroll.js";
-import xo from "./unlockBodyScroll.js";
-import Do from "./toggleFullscreen.js";
-import Fo from "./focusElement.js";
-import Ro from "./detectOutsideClick.js";
-import zo from "./measureElement.js";
-import Jo from "./announceToScreenReader.js";
-import Qo from "./trapFocus.js";
-import Go from "./generateAriaId.js";
-import Mo from "./handleKeyboardNavigation.js";
-import Uo from "./logError.js";
-import Vo from "./captureException.js";
-import jo from "./safeJSONParse.js";
-import Ko from "./safeJSONStringify.js";
-import Wo from "./fallback.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";
@@ -114,40 +114,63 @@ import er from "./parallel.js";
 import pr from "./sequential.js";
 import fr from "./safeAsync.js";
 import ar from "./cancelablePromise.js";
-const St = {
+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: d,
-  kebabCase: A,
+  kebabCase: L,
   maskEmail: B,
-  maskPhone: N,
-  removeExtraSpaces: F,
-  slugify: z,
-  snakeCase: J,
-  titleCase: M,
-  truncate: U,
+  maskPhone: I,
+  removeExtraSpaces: x,
+  slugify: R,
+  snakeCase: G,
+  titleCase: V,
+  truncate: K,
   // number
   clamp: i,
   formatCompactNumber: a,
-  formatCurrency: s,
+  formatCurrency: n,
   formatNumber: l,
   percentage: v,
-  randomBetween: O,
-  randomInt: x,
-  randomValue: D,
-  roundTo: R,
+  randomBetween: F,
+  randomInt: O,
+  randomValue: q,
+  roundTo: D,
   // date-time
   addDays: S,
   countdown: T,
   differenceInDays: k,
-  formatDate: n,
+  formatDate: s,
   formatTime: c,
   getGreetingByTime: u,
-  isPast: P,
+  isPast: E,
   isToday: C,
-  timeAgo: G,
+  timeAgo: Q,
   // object / array
   chunk: t,
   compose: e,
@@ -157,17 +180,17 @@ const St = {
   hasEqualProps: y,
   isEmpty: b,
   isEqual: h,
-  isNonEmptyArray: E,
-  keyBy: L,
-  mergeDeep: I,
-  omit: q,
-  pick: w,
-  sortBy: Q,
-  uniqueBy: V,
+  isNonEmptyArray: P,
+  keyBy: A,
+  mergeDeep: w,
+  omit: N,
+  pick: z,
+  sortBy: J,
+  uniqueBy: M,
   // validation
-  isEmail: j,
-  isPhone: K,
-  isURL: W,
+  isEmail: U,
+  isPhone: W,
+  isURL: j,
   isPasswordStrong: H,
   isPAN: X,
   isAadhaar: Y,
@@ -184,8 +207,8 @@ const St = {
   isOnline: po,
   copyToClipboard: fo,
   downloadFile: ao,
-  openInNewTab: so,
-  getScreenSize: no,
+  openInNewTab: no,
+  getScreenSize: so,
   // routing
   getQueryParams: lo,
   setQueryParam: co,
@@ -198,36 +221,36 @@ const St = {
   setLocalStorage: ko,
   getLocalStorage: bo,
   removeLocalStorage: ho,
-  setSessionStorage: Eo,
-  getSessionStorage: Po,
+  setSessionStorage: Po,
+  getSessionStorage: Eo,
   clearStorage: Co,
   // performance
-  debounce: Ao,
-  throttle: Lo,
+  debounce: Lo,
+  throttle: Ao,
   memoize: Bo,
-  lazyLoadComponent: No,
-  requestIdleTask: Io,
-  rafThrottle: qo,
+  lazyLoadComponent: Io,
+  requestIdleTask: wo,
+  rafThrottle: No,
   // ui / dom
   scrollToTop: vo,
-  scrollToElement: wo,
-  lockBodyScroll: Oo,
-  unlockBodyScroll: xo,
-  toggleFullscreen: Do,
-  focusElement: Fo,
-  detectOutsideClick: Ro,
-  measureElement: zo,
+  scrollToElement: zo,
+  lockBodyScroll: Fo,
+  unlockBodyScroll: Oo,
+  toggleFullscreen: qo,
+  focusElement: xo,
+  detectOutsideClick: Do,
+  measureElement: Ro,
   // accessibility
-  announceToScreenReader: Jo,
-  trapFocus: Qo,
-  generateAriaId: Go,
-  handleKeyboardNavigation: Mo,
+  announceToScreenReader: Go,
+  trapFocus: Jo,
+  generateAriaId: Qo,
+  handleKeyboardNavigation: Vo,
   // error handling
-  logError: Uo,
-  captureException: Vo,
-  safeJSONParse: jo,
-  safeJSONStringify: Ko,
-  fallback: Wo,
+  logError: Ko,
+  captureException: Mo,
+  safeJSONParse: Uo,
+  safeJSONStringify: Wo,
+  fallback: jo,
   // auth
   isAuthenticated: Ho,
   getToken: Xo,
@@ -245,8 +268,35 @@ const St = {
   parallel: er,
   sequential: pr,
   safeAsync: fr,
-  cancelablePromise: ar
+  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 {
-  St as default
+  ni 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/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/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
+};