meticulous-ui 3.2.6 → 3.2.7

package/README.md

@@ -142,19 +142,23 @@ 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`                                                                                                                                                   |
 
 ## 🌱 Features
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meticulous-ui",
-  "version": "3.2.6",
+  "version": "3.2.7",
   "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/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/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/fallback.js

@@ -0,0 +1,4 @@
+const f = (n, d) => n != null && n !== "" ? n : d;
+export {
+  f 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/index.js

@@ -8,11 +8,11 @@ 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 "./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 E from "./isNonEmptyArray.js";
 import P from "./isPast.js";
-import E from "./isToday.js";
-import L from "./kebabCase.js";
-import B from "./keyBy.js";
-import A from "./maskEmail.js";
-import q 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 C from "./isToday.js";
+import A from "./kebabCase.js";
+import L from "./keyBy.js";
+import B from "./maskEmail.js";
+import N from "./maskPhone.js";
+import I from "./mergeDeep.js";
+import q from "./omit.js";
+import v from "./percentage.js";
+import w from "./pick.js";
+import O from "./randomBetween.js";
 import x from "./randomInt.js";
-import z from "./randomValue.js";
-import O from "./removeExtraSpaces.js";
+import D from "./randomValue.js";
+import F 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 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 H from "./isEmail.js";
-import J from "./isPhone.js";
-import K from "./isURL.js";
-import W from "./isPasswordStrong.js";
+import j from "./isEmail.js";
+import K from "./isPhone.js";
+import W from "./isURL.js";
+import H from "./isPasswordStrong.js";
 import X from "./isPAN.js";
 import Y from "./isAadhaar.js";
 import Z from "./isGST.js";
@@ -62,8 +62,8 @@ 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 "./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,81 @@ 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 Eo from "./setSessionStorage.js";
 import Po from "./getSessionStorage.js";
-import Eo from "./clearStorage.js";
-import Lo from "./debounce.js";
-import Bo from "./throttle.js";
-import Ao from "./memoize.js";
-import qo 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 Co from "./clearStorage.js";
+import Ao from "./debounce.js";
+import Lo from "./throttle.js";
+import Bo from "./memoize.js";
+import No from "./lazyLoadComponent.js";
+import Io from "./requestIdleTask.js";
+import qo from "./rafThrottle.js";
+import vo from "./scrollToTop.js";
+import wo from "./scrollToElement.js";
+import Oo from "./lockBodyScroll.js";
 import xo from "./unlockBodyScroll.js";
-import zo from "./toggleFullscreen.js";
-import Oo from "./focusElement.js";
+import Do from "./toggleFullscreen.js";
+import Fo 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 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 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";
+const St = {
   // string
   capFirstLetter: o,
   capitalize: r,
   camelCase: m,
-  generateInitials: u,
-  kebabCase: L,
-  maskEmail: A,
-  maskPhone: q,
-  removeExtraSpaces: O,
-  slugify: F,
-  snakeCase: Q,
-  titleCase: U,
-  truncate: j,
+  generateInitials: d,
+  kebabCase: A,
+  maskEmail: B,
+  maskPhone: N,
+  removeExtraSpaces: F,
+  slugify: z,
+  snakeCase: J,
+  titleCase: M,
+  truncate: U,
   // number
   clamp: i,
   formatCompactNumber: a,
   formatCurrency: s,
-  formatNumber: n,
-  percentage: D,
-  randomBetween: v,
+  formatNumber: l,
+  percentage: v,
+  randomBetween: O,
   randomInt: x,
-  randomValue: z,
+  randomValue: D,
   roundTo: R,
   // date-time
   addDays: S,
   countdown: T,
   differenceInDays: k,
-  formatDate: l,
+  formatDate: n,
   formatTime: c,
-  getGreetingByTime: d,
+  getGreetingByTime: u,
   isPast: P,
-  isToday: E,
-  timeAgo: M,
+  isToday: C,
+  timeAgo: G,
   // object / array
   chunk: t,
   compose: e,
@@ -140,18 +157,18 @@ const Rm = {
   hasEqualProps: y,
   isEmpty: b,
   isEqual: h,
-  isNonEmptyArray: C,
-  keyBy: B,
-  mergeDeep: w,
-  omit: I,
-  pick: N,
-  sortBy: G,
+  isNonEmptyArray: E,
+  keyBy: L,
+  mergeDeep: I,
+  omit: q,
+  pick: w,
+  sortBy: Q,
   uniqueBy: V,
   // validation
-  isEmail: H,
-  isPhone: J,
-  isURL: K,
-  isPasswordStrong: W,
+  isEmail: j,
+  isPhone: K,
+  isURL: W,
+  isPasswordStrong: H,
   isPAN: X,
   isAadhaar: Y,
   isGST: Z,
@@ -168,9 +185,9 @@ const Rm = {
   copyToClipboard: fo,
   downloadFile: ao,
   openInNewTab: so,
-  getScreenSize: lo,
+  getScreenSize: no,
   // routing
-  getQueryParams: no,
+  getQueryParams: lo,
   setQueryParam: co,
   removeQueryParam: uo,
   buildURL: go,
@@ -181,34 +198,55 @@ const Rm = {
   setLocalStorage: ko,
   getLocalStorage: bo,
   removeLocalStorage: ho,
-  setSessionStorage: Co,
+  setSessionStorage: Eo,
   getSessionStorage: Po,
-  clearStorage: Eo,
+  clearStorage: Co,
   // performance
-  debounce: Lo,
-  throttle: Bo,
-  memoize: Ao,
-  lazyLoadComponent: qo,
-  requestIdleTask: wo,
-  rafThrottle: Io,
+  debounce: Ao,
+  throttle: Lo,
+  memoize: Bo,
+  lazyLoadComponent: No,
+  requestIdleTask: Io,
+  rafThrottle: qo,
   // ui / dom
-  scrollToTop: Do,
-  scrollToElement: No,
-  lockBodyScroll: vo,
+  scrollToTop: vo,
+  scrollToElement: wo,
+  lockBodyScroll: Oo,
   unlockBodyScroll: xo,
-  toggleFullscreen: zo,
-  focusElement: Oo,
+  toggleFullscreen: Do,
+  focusElement: Fo,
   detectOutsideClick: Ro,
-  measureElement: Fo,
+  measureElement: zo,
+  // accessibility
+  announceToScreenReader: Jo,
+  trapFocus: Qo,
+  generateAriaId: Go,
+  handleKeyboardNavigation: Mo,
+  // error handling
+  logError: Uo,
+  captureException: Vo,
+  safeJSONParse: jo,
+  safeJSONStringify: Ko,
+  fallback: Wo,
+  // 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
 };
 export {
-  Rm as default
+  St 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/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/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
+};