meticulous-ui 3.2.5 → 3.2.7

package/README.md

@@ -142,79 +142,23 @@ import blue from 'meticulous-ui/colors/blue';
 
 ## 📦 Utils
 
-### General
-
-| Function      | Signature                  | Description                               |
-| ------------- | -------------------------- | ----------------------------------------- |
-| `compose`     | `(...funcs) → (val) → any` | Right-to-left function composition        |
-| `randomInt`   | `(min, max) → number`      | Random integer in `[min, floor(max + 1))` |
-| `randomValue` | `(min, max) → number`      | Random float in `[min, max + 1)`          |
-
-### Data Utilities
-
-| Function          | Signature                        | Description                                                              |
-| ----------------- | -------------------------------- | ------------------------------------------------------------------------ |
-| `deepClone`       | `(obj) → any`                    | Recursively clones objects, arrays, and Dates with no shared references  |
-| `mergeDeep`       | `(target, source) → object`      | Deep-merges source into target; source wins on conflicts                 |
-| `pick`            | `(obj, keys) → object`           | Returns a new object with only the specified keys                        |
-| `omit`            | `(obj, keys) → object`           | Returns a new object without the specified keys                          |
-| `isEmpty`         | `(value) → boolean`              | `true` for `null`, `undefined`, `""`, `[]`, `{}`                         |
-| `isEqual`         | `(a, b) → boolean`               | Deep structural equality — handles objects, arrays, and Dates            |
-| `hasEqualProps`   | `(oldProps, newProps) → boolean` | Deep equality ignoring function-valued keys; ideal for `React.memo`      |
-| `isNonEmptyArray` | `(arr) → boolean`                | `true` only when the value is an array with at least one element         |
-| `flattenObject`   | `(obj, prefix?) → object`        | Collapses nested object to dot-notation keys                             |
-| `groupBy`         | `(array, key) → object`          | Groups array items into an object of arrays keyed by a field or function |
-| `keyBy`           | `(array, key) → object`          | Converts an array into a lookup object keyed by a field or function      |
-| `uniqueBy`        | `(array, key) → array`           | Removes duplicates by a field or function; first occurrence wins         |
-| `sortBy`          | `(array, key) → array`           | Ascending sort by a field or function; non-mutating                      |
-| `chunk`           | `(array, size) → array[]`        | Splits array into consecutive chunks of the given size                   |
-
-### String Utilities
-
-| Function            | Signature               | Description                                                         |
-| ------------------- | ----------------------- | ------------------------------------------------------------------- |
-| `capFirstLetter`    | `(str) → string`        | Takes a string and returns with first letter capitalised            |
-| `capitalize`        | `(str) → string`        | Uppercases first character, lowercases the rest                     |
-| `titleCase`         | `(str) → string`        | Capitalizes the first letter of every word                          |
-| `camelCase`         | `(str) → string`        | Converts to `camelCase` from spaces, hyphens, or underscores        |
-| `snakeCase`         | `(str) → string`        | Converts to `snake_case` from camelCase, spaces, or hyphens         |
-| `kebabCase`         | `(str) → string`        | Converts to `kebab-case` from camelCase, spaces, or underscores     |
-| `truncate`          | `(str, limit) → string` | Trims to `limit` characters and appends `…`                         |
-| `slugify`           | `(str) → string`        | URL-safe slug — strips diacritics, removes special chars            |
-| `removeExtraSpaces` | `(str) → string`        | Trims and collapses internal whitespace runs to a single space      |
-| `maskEmail`         | `(str) → string`        | Shows only the first character of the local part, e.g. `j***@x.com` |
-| `maskPhone`         | `(str) → string`        | Masks all digits except the last four; preserves formatting chars   |
-| `generateInitials`  | `(name) → string`       | Extracts uppercased first letter of each word, e.g. `"JD"`          |
-
-### Device Utilities
-
-| Function          | Signature                                                       | Description                                                                    |
-| ----------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------ |
-| `isMobile`        | `() → boolean`                                                  | `true` when the UA matches any known mobile platform                           |
-| `isIOS`           | `() → boolean`                                                  | `true` on iPhone, iPad, and iPod; handles iPadOS 13+ UA quirk                  |
-| `isAndroid`       | `() → boolean`                                                  | `true` when the UA string contains `Android`                                   |
-| `isSafari`        | `() → boolean`                                                  | `true` for genuine Safari; excludes Chrome/Android which also include "Safari" |
-| `isDarkMode`      | `() → boolean`                                                  | `true` when the OS/browser prefers dark color scheme                           |
-| `isOnline`        | `() → boolean`                                                  | `true` when the browser reports network connectivity                           |
-| `copyToClipboard` | `(text: string) → Promise<void>`                                | Copies text using Clipboard API with `execCommand` fallback                    |
-| `downloadFile`    | `(url: string, filename?: string) → void`                       | Triggers a file download; filename inferred from URL if omitted                |
-| `openInNewTab`    | `(url: string) → void`                                          | Opens URL in a new tab with `noopener,noreferrer`                              |
-| `getScreenSize`   | `() → { width, height, deviceWidth, deviceHeight, pixelRatio }` | Returns viewport size, physical screen size, and device pixel ratio            |
-
-### Validation Utilities
-
-| Function           | Signature              | Description                                                               |
-| ------------------ | ---------------------- | ------------------------------------------------------------------------- |
-| `isEmail`          | `(value) → boolean`    | Valid email — must have local part, `@`, and domain with dot              |
-| `isPhone`          | `(value) → boolean`    | Plausible phone — optional `+`, 7–15 digits, allows spaces/hyphens/parens |
-| `isURL`            | `(value) → boolean`    | Valid `http` or `https` URL via native `URL` constructor                  |
-| `isPasswordStrong` | `(value) → boolean`    | 8+ chars with uppercase, lowercase, digit, and special character          |
-| `isPAN`            | `(value) → boolean`    | Indian PAN — `AAAAA0000A` (5 letters, 4 digits, 1 letter)                 |
-| `isAadhaar`        | `(value) → boolean`    | Indian Aadhaar — 12 digits, first digit non-zero; strips spaces           |
-| `isGST`            | `(value) → boolean`    | Indian GSTIN — 2-digit state code + PAN + entity digit + `Z` + check char |
-| `isRequired`       | `(value) → boolean`    | `false` for `null`, `undefined`, blank strings, and empty arrays          |
-| `minLength`        | `(value, n) → boolean` | `true` when `value.length >= n`                                           |
-| `maxLength`        | `(value, n) → boolean` | `true` when `value.length <= n`                                           |
+| 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.5",
+  "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/buildURL.js

@@ -0,0 +1,9 @@
+const a = (r, e = {}) => {
+  const t = new URL(r, window.location.origin);
+  return Object.entries(e).forEach(([n, o]) => {
+    t.searchParams.set(n, o);
+  }), t.toString();
+};
+export {
+  a as default
+};

package/utils/cancelablePromise.js

@@ -0,0 +1,17 @@
+const t = (c) => {
+  let e = !1;
+  return {
+    promise: new Promise((n, a) => {
+      c.then(
+        (r) => e ? a({ canceled: !0 }) : n(r),
+        (r) => a(e ? { canceled: !0 } : r)
+      );
+    }),
+    cancel: () => {
+      e = !0;
+    }
+  };
+};
+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/clearStorage.js

@@ -0,0 +1,6 @@
+const a = () => {
+  localStorage.clear(), sessionStorage.clear();
+};
+export {
+  a as default
+};

package/utils/debounce.js

@@ -0,0 +1,9 @@
+const u = (t, o) => {
+  let e;
+  return (...r) => {
+    clearTimeout(e), e = setTimeout(() => t(...r), o);
+  };
+};
+export {
+  u 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/detectOutsideClick.js

@@ -0,0 +1,10 @@
+const s = (t, d) => {
+  const e = (n) => {
+    const o = (t == null ? void 0 : t.current) ?? t;
+    o && !o.contains(n.target) && d(n);
+  };
+  return document.addEventListener("mousedown", e), () => document.removeEventListener("mousedown", e);
+};
+export {
+  s 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/focusElement.js

@@ -0,0 +1,7 @@
+const o = (t) => {
+  const c = (t == null ? void 0 : t.current) ?? t;
+  c == null || c.focus();
+};
+export {
+  o 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/getCurrentPath.js

@@ -0,0 +1,4 @@
+const t = () => window.location.pathname;
+export {
+  t as default
+};

package/utils/getLocalStorage.js

@@ -0,0 +1,11 @@
+const l = (e) => {
+  try {
+    const t = localStorage.getItem(e);
+    return t !== null ? JSON.parse(t) : null;
+  } catch {
+    return null;
+  }
+};
+export {
+  l as default
+};

package/utils/getQueryParams.js

@@ -0,0 +1,9 @@
+const o = () => {
+  const a = {};
+  return new URLSearchParams(window.location.search).forEach((r, e) => {
+    a[e] = r;
+  }), a;
+};
+export {
+  o as default
+};

package/utils/getSessionStorage.js

@@ -0,0 +1,11 @@
+const n = (e) => {
+  try {
+    const t = sessionStorage.getItem(e);
+    return t !== null ? JSON.parse(t) : null;
+  } catch {
+    return null;
+  }
+};
+export {
+  n 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

@@ -1,52 +1,52 @@
 import o from "./capFirstLetter.js";
 import r from "./capitalize.js";
 import m from "./camelCase.js";
-import i from "./chunk.js";
-import t from "./clamp.js";
-import p from "./compose.js";
-import f from "./deepClone.js";
-import e from "./flattenObject.js";
+import t from "./chunk.js";
+import i from "./clamp.js";
+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 d from "./formatNumber.js";
-import l from "./formatTime.js";
-import c from "./generateInitials.js";
+import l from "./formatNumber.js";
+import c from "./formatTime.js";
+import d from "./generateInitials.js";
 import u from "./getGreetingByTime.js";
-import y from "./groupBy.js";
-import g from "./hasEqualProps.js";
-import b from "./addDays.js";
-import k from "./countdown.js";
-import C from "./differenceInDays.js";
-import h from "./isEmpty.js";
-import E from "./isEqual.js";
-import S from "./isNonEmptyArray.js";
-import T from "./isPast.js";
-import B from "./isToday.js";
-import P from "./kebabCase.js";
-import w from "./keyBy.js";
-import A from "./maskEmail.js";
-import D from "./maskPhone.js";
+import g from "./groupBy.js";
+import y from "./hasEqualProps.js";
+import S from "./addDays.js";
+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 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 N from "./omit.js";
-import q from "./percentage.js";
-import x from "./pick.js";
-import L from "./randomBetween.js";
-import O from "./randomInt.js";
-import z from "./randomValue.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 D from "./randomValue.js";
 import F from "./removeExtraSpaces.js";
-import G from "./roundTo.js";
-import M from "./slugify.js";
-import R from "./snakeCase.js";
-import j from "./sortBy.js";
-import v from "./timeAgo.js";
-import U from "./titleCase.js";
-import V from "./truncate.js";
-import H from "./uniqueBy.js";
-import J from "./isEmail.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 Q from "./isURL.js";
-import W from "./isPasswordStrong.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";
@@ -55,69 +55,120 @@ import $ from "./minLength.js";
 import oo from "./maxLength.js";
 import ro from "./isMobile.js";
 import mo from "./isIOS.js";
-import io from "./isAndroid.js";
-import to from "./isSafari.js";
-import po from "./isDarkMode.js";
-import fo from "./isOnline.js";
-import eo from "./copyToClipboard.js";
+import to from "./isAndroid.js";
+import io from "./isSafari.js";
+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";
-const Tr = {
+import lo from "./getQueryParams.js";
+import co from "./setQueryParam.js";
+import uo from "./removeQueryParam.js";
+import go from "./buildURL.js";
+import yo from "./redirectTo.js";
+import So from "./getCurrentPath.js";
+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 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 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 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: c,
-  kebabCase: P,
-  maskEmail: A,
-  maskPhone: D,
+  generateInitials: d,
+  kebabCase: A,
+  maskEmail: B,
+  maskPhone: N,
   removeExtraSpaces: F,
-  slugify: M,
-  snakeCase: R,
-  titleCase: U,
-  truncate: V,
+  slugify: z,
+  snakeCase: J,
+  titleCase: M,
+  truncate: U,
   // number
-  clamp: t,
+  clamp: i,
   formatCompactNumber: a,
   formatCurrency: s,
-  formatNumber: d,
-  percentage: q,
-  randomBetween: L,
-  randomInt: O,
-  randomValue: z,
-  roundTo: G,
+  formatNumber: l,
+  percentage: v,
+  randomBetween: O,
+  randomInt: x,
+  randomValue: D,
+  roundTo: R,
   // date-time
-  addDays: b,
-  countdown: k,
-  differenceInDays: C,
+  addDays: S,
+  countdown: T,
+  differenceInDays: k,
   formatDate: n,
-  formatTime: l,
+  formatTime: c,
   getGreetingByTime: u,
-  isPast: T,
-  isToday: B,
-  timeAgo: v,
+  isPast: P,
+  isToday: C,
+  timeAgo: G,
   // object / array
-  chunk: i,
-  compose: p,
-  deepClone: f,
-  flattenObject: e,
-  groupBy: y,
-  hasEqualProps: g,
-  isEmpty: h,
-  isEqual: E,
-  isNonEmptyArray: S,
-  keyBy: w,
+  chunk: t,
+  compose: e,
+  deepClone: p,
+  flattenObject: f,
+  groupBy: g,
+  hasEqualProps: y,
+  isEmpty: b,
+  isEqual: h,
+  isNonEmptyArray: E,
+  keyBy: L,
   mergeDeep: I,
-  omit: N,
-  pick: x,
-  sortBy: j,
-  uniqueBy: H,
+  omit: q,
+  pick: w,
+  sortBy: Q,
+  uniqueBy: V,
   // validation
-  isEmail: J,
+  isEmail: j,
   isPhone: K,
-  isURL: Q,
-  isPasswordStrong: W,
+  isURL: W,
+  isPasswordStrong: H,
   isPAN: X,
   isAadhaar: Y,
   isGST: Z,
@@ -127,15 +178,75 @@ const Tr = {
   // device
   isMobile: ro,
   isIOS: mo,
-  isAndroid: io,
-  isSafari: to,
-  isDarkMode: po,
-  isOnline: fo,
-  copyToClipboard: eo,
+  isAndroid: to,
+  isSafari: io,
+  isDarkMode: eo,
+  isOnline: po,
+  copyToClipboard: fo,
   downloadFile: ao,
   openInNewTab: so,
-  getScreenSize: no
+  getScreenSize: no,
+  // routing
+  getQueryParams: lo,
+  setQueryParam: co,
+  removeQueryParam: uo,
+  buildURL: go,
+  redirectTo: yo,
+  getCurrentPath: So,
+  isActiveRoute: To,
+  // storage
+  setLocalStorage: ko,
+  getLocalStorage: bo,
+  removeLocalStorage: ho,
+  setSessionStorage: Eo,
+  getSessionStorage: Po,
+  clearStorage: Co,
+  // performance
+  debounce: Ao,
+  throttle: Lo,
+  memoize: Bo,
+  lazyLoadComponent: No,
+  requestIdleTask: Io,
+  rafThrottle: qo,
+  // ui / dom
+  scrollToTop: vo,
+  scrollToElement: wo,
+  lockBodyScroll: Oo,
+  unlockBodyScroll: xo,
+  toggleFullscreen: Do,
+  focusElement: Fo,
+  detectOutsideClick: Ro,
+  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: mr,
+  sleep: tr,
+  withTimeout: ir,
+  parallel: er,
+  sequential: pr,
+  safeAsync: fr,
+  cancelablePromise: ar
 };
 export {
-  Tr as default
+  St as default
 };

package/utils/isActiveRoute.js

@@ -0,0 +1,4 @@
+const o = (t) => window.location.pathname === t;
+export {
+  o 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/lazyLoadComponent.js

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

package/utils/lockBodyScroll.js

@@ -0,0 +1,6 @@
+const o = () => {
+  document.body.style.overflow = "hidden";
+};
+export {
+  o 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/measureElement.js

@@ -0,0 +1,7 @@
+const e = (t) => {
+  const n = (t == null ? void 0 : t.current) ?? t;
+  return n ? n.getBoundingClientRect() : null;
+};
+export {
+  e as default
+};

package/utils/memoize.js

@@ -0,0 +1,12 @@
+const c = (s) => {
+  const e = /* @__PURE__ */ new Map();
+  return (...n) => {
+    const t = JSON.stringify(n);
+    if (e.has(t)) return e.get(t);
+    const r = s(...n);
+    return e.set(t, r), r;
+  };
+};
+export {
+  c as default
+};

package/utils/parallel.js

@@ -0,0 +1,4 @@
+const a = (l) => Promise.all(l);
+export {
+  a as default
+};

package/utils/rafThrottle.js

@@ -0,0 +1,11 @@
+const l = (t) => {
+  let r = null;
+  return (...e) => {
+    r === null && (r = requestAnimationFrame(() => {
+      t(...e), r = null;
+    }));
+  };
+};
+export {
+  l as default
+};

package/utils/redirectTo.js

@@ -0,0 +1,6 @@
+const e = (o) => {
+  window.location.href = o;
+};
+export {
+  e as default
+};

package/utils/removeLocalStorage.js

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

package/utils/removeQueryParam.js

@@ -0,0 +1,7 @@
+const o = (a) => {
+  const e = new URL(window.location.href);
+  e.searchParams.delete(a), window.history.pushState({}, "", e);
+};
+export {
+  o as default
+};

package/utils/removeToken.js

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

package/utils/requestIdleTask.js

@@ -0,0 +1,6 @@
+const l = (e) => {
+  typeof requestIdleCallback < "u" ? requestIdleCallback(e) : setTimeout(e, 1);
+};
+export {
+  l as default
+};

package/utils/retry.js

@@ -0,0 +1,13 @@
+const c = async (a, e = 3) => {
+  let r;
+  for (let t = 0; t < e; t++)
+    try {
+      return await a();
+    } catch (o) {
+      r = o;
+    }
+  throw r;
+};
+export {
+  c as default
+};

package/utils/safeAsync.js

@@ -0,0 +1,10 @@
+const n = (r) => async (...e) => {
+  try {
+    return [null, await r(...e)];
+  } catch (t) {
+    return [t, null];
+  }
+};
+export {
+  n 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/scrollToElement.js

@@ -0,0 +1,7 @@
+const l = (o, e = "smooth") => {
+  const t = document.getElementById(o);
+  t && t.scrollIntoView({ behavior: e, block: "start" });
+};
+export {
+  l as default
+};

package/utils/scrollToTop.js

@@ -0,0 +1,6 @@
+const l = (o = "smooth") => {
+  window.scrollTo({ top: 0, behavior: o });
+};
+export {
+  l as default
+};

package/utils/sequential.js

@@ -0,0 +1,9 @@
+const e = async (t) => {
+  const s = [];
+  for (const a of t)
+    s.push(await a());
+  return s;
+};
+export {
+  e as default
+};

package/utils/setLocalStorage.js

@@ -0,0 +1,9 @@
+const e = (t, a) => {
+  try {
+    localStorage.setItem(t, JSON.stringify(a));
+  } catch {
+  }
+};
+export {
+  e as default
+};

package/utils/setQueryParam.js

@@ -0,0 +1,7 @@
+const s = (a, e) => {
+  const t = new URL(window.location.href);
+  t.searchParams.set(a, e), window.history.pushState({}, "", t);
+};
+export {
+  s as default
+};

package/utils/setSessionStorage.js

@@ -0,0 +1,9 @@
+const e = (t, s) => {
+  try {
+    sessionStorage.setItem(t, JSON.stringify(s));
+  } catch {
+  }
+};
+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/sleep.js

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

package/utils/throttle.js

@@ -0,0 +1,10 @@
+const n = (l, o) => {
+  let t = 0;
+  return (...a) => {
+    const e = Date.now();
+    e - t >= o && (t = e, l(...a));
+  };
+};
+export {
+  n as default
+};

package/utils/toggleFullscreen.js

@@ -0,0 +1,7 @@
+const l = (e = document.documentElement) => {
+  var u, c;
+  document.fullscreenElement ? (c = document.exitFullscreen) == null || c.call(document) : (u = e.requestFullscreen) == null || u.call(e);
+};
+export {
+  l 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/unlockBodyScroll.js

@@ -0,0 +1,6 @@
+const o = () => {
+  document.body.style.overflow = "";
+};
+export {
+  o as default
+};

package/utils/withTimeout.js

@@ -0,0 +1,9 @@
+const m = (t, e) => {
+  const o = new Promise(
+    (i, r) => setTimeout(() => r(new Error(`Timed out after ${e}ms`)), e)
+  );
+  return Promise.race([t, o]);
+};
+export {
+  m as default
+};