react-js-plugins 1.3.11 → 1.4.0

package/README.md

@@ -24,1751 +24,1368 @@ pnpm add react-js-plugins
 | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
 | Latest ✔                                                                                          | Latest ✔                                                                                             | Latest ✔                                                                                          | Latest ✔                                                                                       | Latest ✔                                                                                    | 
 
-### **Features**  
-Here's the properly structured documentation with clear purpose explanations:
 
-✅ **_log**  
-Logs a styled message to the console with a specified log level (`log`, `info`, `warn`, `error`).
+## Array Functions
 
+### ✅ **_arrayDiff**
+Returns the difference between two arrays.
 ```ts
-// 📝 Custom log with style
-_log("UserService", "Fetching user details...", "info");
+const diff = _arrayDiff(['a', 'b'], ['b']); // ['a']
 ```
 
----
- ✅ **_handleApi**  
-Wraps an API call with success and error handling, executing the appropriate callback based on the result.
-
+### ✅ **_arrayIncludesObject**
+Checks if array contains object (by value).
 ```ts
-_handleApi(
-  getDetails({ name: 'sia' }),
-  (res) => console.log(res), 
-  (err) => console.error(err)
-);
+_arrayIncludesObject(arr, obj);
 ```
----
-
-✅ **_copyText**
-Copies the provided text to the clipboard, using modern APIs with a fallback for older browsers.
 
+### ✅ **_arrayIntersection**
+Returns common elements between two arrays.
 ```ts
-// 📋 Copy Text
-const success = await _copyText("Hello, clipboard!");
-if (success) {
-  console.log("Text copied successfully");
-}
+_arrayIntersection([1,2,3], [2,3,4]); // [2,3]
 ```
----
 
-✅ **_pasteText**
-Retrieves and returns the current text content from the clipboard, using modern APIs with a fallback for older browsers.
+### ✅ **_arrayToObject**
+Converts array of key-value pairs to object.
+```ts
+_arrayToObject([['a', 1], ['b', 2]]); // { a: 1, b: 2 }
+```
 
+### ✅ **_arrayToObjectByKey**
+Converts array of objects to object using a key.
 ```ts
-// 📥 Paste Text
-const text = await _pasteText();
-if (text) {
-  console.log("Pasted text:", text);
-}
+_arrayToObjectByKey(users, 'id');
 ```
----
 
- ✅ **_alert** 
-Shows a customizable alert modal.
+### ✅ **_asyncMap**
+Async map over array items one by one.
 ```ts
-// 🚨 Alert Dialog
-await _alert({ title: "Test", text: "Data save successfully!" });
+const results = await _asyncMap(ids, fetchById);
+```
 
+### ✅ **_average**
+Calculates the average of numbers in an array.
+```ts
+_average([4, 8]); // 6
 ```
----
- ✅ **_confirm**  
-Shows a customizable confirm modal.
 
+### ✅ **_batchProcess**
+Processes an array of data in asynchronous batches.
 ```ts
-const confirmed = await _confirm({
-    title: "Are you sure?",
-    text: "Do you really want to delete this item?",
-    icon: "warning",
-    confirmButtonText: "Yes, delete it",
-    cancelButtonText: "No, cancel",
+await _batchProcess(myArray, 10, async (item) => {
+  await handleItem(item);
 });
-
-if (confirmed) {
-  // proceed with delete
-} else {
-  // cancelled
-}
-
 ```
 
----
-
-### ✅ **_generateUUID**
-
-Generates a unique UUID string using the browser's `crypto` API.
-
+### ✅ **_chunk**
+Splits an array into chunks of a given size.
 ```ts
-// Example usage
-const id = _generateUUID();
-console.log(id); // e.g., "3b12f1df-5232-4e6b-8f36-3a4e5f7f8b84"
+const parts = _chunk([1, 2, 3, 4], 2); // [[1,2], [3,4]]
 ```
 
----
-✅ **_throwError**  
-Throws an error with an optional context object and logs it to the console.
-
+### ✅ **_deepCloneArray**
+Deeply clones an array of objects.
 ```ts
-// ❌ Throw an error
-_throwError("Something went wrong",);
+const cloned = _deepCloneArray(originalArray);
 ```
----
- ✅ **_encodeURI**  
-Encodes a URI component by escaping special characters to make it safe for use in URLs.
 
+### ✅ **_deepCompareArrays**
+Checks if two arrays are deeply equal.
 ```ts
-const encoded = _encodeURI('hello world@2024');
-// Output: 'hello%20world%402024'
+const isEqual = _deepCompareArrays(arr1, arr2);
 ```
----
- ✅ **_decodeURI**  
-Decodes an encoded URI component back to its original readable string format.
+
+### ✅ **_extractKeyValues**
+Extracts all non-undefined values for a specific key from an array.
 ```ts
-const decoded = _decodeURI('hello%20world%402024');
-// Output: 'hello world@2024'
+const employees = [
+  { id: 1, name: "Alice" },
+  { id: 2 },
+  { id: 3, name: "Bob" },
+];
+_extractKeyValues(employees, "name"); // ["Alice", "Bob"]
 ```
----
- ✅ **_encryptJson**  
-Encrypts a JSON object using AES encryption with a secret key.
+
+### ✅ **_extractNestedKeyValues**
+Extracts all non-undefined values from a nested key path in an array of objects.
 ```ts
-// 🔐 Encrypt JSON
-const encrypted = _encryptJson({ name: "John" }, "secret123");
+const users = [
+  { id: 1, address: { city: "Mumbai" } },
+  { id: 2, address: { city: "Pune" } },
+  { id: 3 },
+];
+_extractNestedKeyValues(users, "address.city"); // ["Mumbai", "Pune"]
 ```
----
- ✅ **_decryptJson**  
-Decrypts AES-encrypted JSON string using a secret key.
+
+### ✅ **_extractUniqueValues**
+Extracts unique values from an array based on a specific key.
 ```ts
-// 🔓 Decrypt JSON
-const decrypted = _decryptJson(encryptedString, "secret123");
+const employees = [
+  { id: 1, department: "HR" },
+  { id: 2, department: "IT" },
+  { id: 3, department: "HR" },
+];
+_extractUniqueValues(employees, "department"); // ["HR", "IT"]
 ```
----
- ✅ **_encryptString**  
-Encrypts a plain string using AES encryption, with optional random IV.
+
+### ✅ **_filterArrayByKeyValue**
+Filters an array by a key-value match. Defaults to filtering where the key's value is `true`.
 ```ts
-// 🔐 Encrypt String
-const result = _encryptString("mySecretText", "secretKey");
+const enabledUsers = _filterArrayByKeyValue(userList, "isActive", true);
 ```
----
- ✅ **_decryptString**  
-Decrypts an AES-encrypted string using the provided IV and secret key.
+
+### ✅ **_filterByMatchedKey**
+Filters `list1` based on matching key values from `list2`.
 ```ts
-// 🔓 Decrypt String
-const plainText = _decryptString(ciphertext, iv, "secretKey");
+const filtered = _filterByMatchedKey(usersList, activeUsers, "userId");
 ```
----
- ✅ **_encryptPayload**  
-Encrypts a full payload using a randomly generated key and IV, secured by a static key.
+
+### ✅ **_filterByMatchingKey**
+Filters `list1` by comparing the key's value in `list2`, with more validation than `_filterByMatchedKey`.
 ```ts
-// 🔐 Encrypt Payload
-const payload = _encryptPayload({ id: 1 }, "mainSecretKey");
+const filtered = _filterByMatchingKey(productList, inStockItems, "productId");
 ```
----
-  ✅ **_downloadBlob**  
-Triggers download of a Blob object.
+
+### ✅ **_filterDuplicates**
+Removes duplicates based on a specific object key.
 ```ts
-_downloadBlob(blob, 'myfile.pdf');
+const unique = _filterDuplicates(users, 'id');
 ```
----
-  ✅ **_fileToBase64**  
-Converts a file to a base64-encoded string.  
+
+### ✅ **_findObjectById**
+Finds an object in an array by its `id`.
 ```ts
-const base64 = await _fileToBase64(file);
+const item = _findObjectById(items, '123');
 ```
----
-  ✅ **_base64ToBlob**  
-Converts a base64-encoded string into a Blob object.  
+
+### ✅ **_flattenArray**
+Flattens nested arrays by recursively extracting `item.data` if present.
 ```ts
-const blob = _base64ToBlob(base64String);
+const flat = _flattenArray(nestedArray);
 ```
 
----
-  ✅ **_downloadBase64File**  
-This function allows downloading any base64-encoded data as a file with a specified filename and extension. 
+### ✅ **_getArrayOfObjectsByProperty**
+Returns all objects with a specific property value.
 ```ts
-const base64Image = 'iVBORw0KGgoAAAANSUhEUgAAA...';
-downloadBase64File(base64Image, 'my-picture.png');
-
-const base64ImageWithPrefix = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA...';
-downloadBase64File(base64ImageWithPrefix, 'my-picture.png');
-
-const base64PDF = 'JVBERi0xLjQKJeLjz9MNCjEgMCBvYmoK...';
-downloadBase64File(base64PDF, 'invoice.pdf');
-
-const base64PDFWithPrefix = 'data:application/pdf;base64,JVBERi0xLjQKJeLjz9MNCjEgMCBvYmoK...';
-downloadBase64File(base64PDFWithPrefix, 'invoice.pdf');
-
+_getArrayOfObjectsByProperty(data, 'type', 'active');
 ```
 
----
-   ✅ **_dynamicReducer**  
-Creates a simple dynamic reducer using generic action handler logic.
+### ✅ **_getMaxMinValue**
+Finds the max and min values in an array.
 ```ts
-// 🧠 Dynamic Reducer
-const reducer = _dynamicReducer(initialState);
+const { max, min } = _getMaxMinValue([5, 2, 9]);
 ```
----
-  ✅ **_genericReducer**  
-A generic reducer accepting predefined handlers for each action type.
+
+### ✅ **_getUniqueValues**
+Returns an array of unique values.
 ```ts
-// ⚙️ Generic Reducer with Custom Actions
-const reducer = _genericReducer(initialState, customActions);
+const unique = _getUniqueValues([1, 2, 2, 3]);
 ```
 
----
-  ✅ **_importFile**  
-It supports multiple types of result formats:
-base64 → returns file as a base64 string (useful for previews or uploads)
-buffer → returns file as an ArrayBuffer (for binary handling)
-file → returns the raw File object (for form submission or re-uploads)
-unit8array → returns a Uint8Array (for low-level binary use)
-
+### ✅ **_groupBy**
+Groups array items by a given key.
 ```ts
-  const handleChangeFile = async (file) => {
-    const result = await _importFile(file, 'base64');
-    console.log('result', result);
-  };
+const grouped = _groupBy(users, 'department');
 ```
----
- ✅ **_exportExcel**  
-Exports JSON data to an Excel or CSV file.
+
+### ✅ **_hasElement**
+Searches recursively in a menu tree to find an element by key and value.
 ```ts
-await _exportExcel({
-      data: [
-        { name: 'siya', age: 5 },
-        { name: 'riya', age: 6 },
-      ],
-      filename: 'users',
-    })
-      .then(() => console.log('Export successful'))
-      .catch((err) => console.error('Export failed:', err.message));
+const found = _hasElement(menuItems, "id", 5);
 ```
----
- ✅ **_importExcel**  
-Exports JSON data to an Excel file.
+
+### ✅ **_hasItem**
+Searches recursively in a menu tree to find an item by `path`.
 ```ts
-// 📤 Import to Excel
-const fileInputHandler = async (event: React.ChangeEvent<HTMLInputElement>) => {
-  const { data, error } = await _importExcel(event);
+const item = _hasItem(menuItems, "/dashboard");
+```
 
-  if (error) {
-    console.error('Error:', error.message);
-    return;
-  }
-  
-  if (data) {
-    console.log('Successfully parsed data:', data);
-  }
-};
+### ✅ **_isEmptyArray**
+Checks if a given value is an empty array.
+```ts
+const isEmpty = _isEmptyArray([]);
 ```
----
-  ✅ **_thousandSeparator**  
-Formats a number with thousand separators and fixed decimal precision.
+
+### ✅ **_isInArray**
+Checks if a value exists in array.
 ```ts
-// 💰 Thousand Separator
-const formatted = _thousandSeparator(1234567.89);
+_isInArray(['a', 'b'], 'b'); // true
 ```
----
-  ✅ **_getFinancialYear**  
-Returns the current financial year based on today's date.
+
+### ✅ **_isValueInArray**
+Checks whether a value exists in a given array.
 ```ts
-// 📆 Get Financial Year
-const fy = _getFinancialYear();
+const exists = _isValueInArray([1, 2, 3], 2);
 ```
----
-  ✅ **_dateFormat**  
-Formats a date using Moment.js with the specified format.  
+
+### ✅ **_mapAsync**
+Parallel async map over array.
 ```ts
-const formatted = _dateFormat(new Date(), 'YYYY-MM-DD');
+const data = await _mapAsync(users, fetchDetails);
 ```
----
-  ✅ **_dateTransformer**  
-Recursively formats all dates in an object or array.  
 
+### ✅ **_mergeArrays**
+Merges two arrays and removes duplicates.
 ```ts
-const result = _dateTransformer(data);
+const merged = _mergeArrays(arr1, arr2);
 ```
----
 
-  ✅ **_getStorage**  
-Handles local/session storage actions like GET, SET, REMOVE, CLEAR.
+### ✅ **_mergeArraysByKey**
+Merges two arrays of objects based on a common key.
 ```ts
-// 🗃️ Use Local Storage
-const data = _getStorage({ action: 'GET', type: 'local', key: 'user' });
+const merged = _mergeArraysByKey(arr1, arr2, 'id');
 ```
----
-  ✅ **_convertToCurrency**  
-Converts a number to a formatted currency string.
+
+### ✅ **_removeFalsy**
+Removes all falsy values (`false`, `0`, `''`, `null`, `undefined`, `NaN`) from an array.
 ```ts
-// 💵 Convert to Currency
-const price = _convertToCurrency(2500, 'INR');
+const cleaned = _removeFalsy([0, 1, false, 2, '', 3]); // [1, 2, 3]
 ```
----
 
 ### ✅ **_removeDuplicateByKey**
-
 Removes duplicates based on a specific key (e.g. `id`), keeping the **first occurrence**.
-
 ```ts
 const users = [
   { id: 1, name: 'Alice' },
   { id: 2, name: 'Bob' },
   { id: 1, name: 'Alice Duplicate' },
 ];
-
 const uniqueUsers = _removeDuplicateByKey(users, 'id');
 // Result: [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]
 ```
 
----
-
-### ✅ **_globalizeDateTime**
-
-Converts a date/time to a specific time zone and format.
-
+### ✅ **_removeDuplicates**
+Removes duplicate objects based on a key.
 ```ts
-const localized = _globalizeDateTime('2024-07-09T12:00:00', {
-  timeZone: 'Asia/Kolkata',
-  format: 'yyyy-MM-dd HH:mm',
-});
-// Result: "2024-07-09 17:30"
+const cleaned = _removeDuplicates(data, 'email');
 ```
 
----
-
-### ✅ **_formatInternationalDate**
-
-Formats a date according to locale, timezone, and preset or custom format.
-
+### ✅ **_sortByKey**
+Sorts array of objects by a specific key.
 ```ts
-const formatted = _formatInternationalDate('2024-07-09T10:00:00Z', {
-  country: 'IN',
-  timezone: 'Asia/Kolkata',
-  format: 'DATETIME_SHORT',
-});
-// Result: "9/7/2024, 3:30 pm"
+const sorted = _sortByKey(products, 'price');
 ```
 
----
-  ✅ **_parseJSON**  
-Safely parses a JSON string into an object.
+### ✅ **_sum**
+Returns the sum of an array of numbers.
 ```ts
-// 📦 Parse JSON
-const obj = _parseJSON(jsonString);
+_sum([1, 2, 3]); // 6
 ```
----
-  ✅ **_stringifyJSON**  
-Safely converts an object to a JSON string.
 
+### ✅ **_swapArrayByKey**
+Sorts an array in descending order based on a key.
 ```ts
-// 🧾 Stringify JSON
-const str = _stringifyJSON(obj);
+const sorted = _swapArrayByKey(data, 'score');
 ```
----
-  ✅ **_getCookie**  
-Retrieves a cookie value by its name.
+
+### ✅ **_swapArrayElements**
+Swaps two elements in an array.
 ```ts
-// 🍪 Get Cookie
-const token = _getCookie('auth_token');
+_swapArrayElements(arr, 0, 1);
 ```
----
-  ✅ **_setCookie**  
-Sets a cookie with a name, value, and expiry (in days).
-```ts
-// 📝 Set Cookie
-_setCookie('auth_token', 'abc123', 7);
-```
----
-  ✅ **_getBrowserInfo**  
-Returns the name of the browser (e.g., Chrome, Firefox).
-```ts
-// 🌐 Get Browser Info
-const browser = _getBrowserInfo();
-```
----
- ✅ **_generatePassword**  
-Generates a strong random password with mixed characters.
-```ts
-// 🔑 Generate Random Password
-const newPassword = _generatePassword(12);
-```
----
- ✅ **_getStartStopTime**  
-Returns the start and end datetime of a given date's month in specified format.
-```ts
-// 🕐 Get Start & Stop Time
-const { startTime, stopTime } = _getStartStopTime(new Date());
-```
----
- ✅ **getUTCTimestamp**  
-Returns the UTC timestamp.
-```ts
-const ts3 = getUTCTimestamp({ year: 2025, month: "December", day: 25, hour: 10, minute: 30 });
-console.log(new Date(ts3).toUTCString()); // Thu, 25 Dec 2025 10:30:00 GMT
-```
----
-  ✅ **_setTouchedFields**  
-Marks all fields with errors as touched in a Formik form.  
-```ts
-_setTouchedFields(formRef, errors);
-```
----
-  ✅ **_isValidForm**  
-Validates a Formik form and returns whether it's valid.  
-```ts
-const isValid = await _isValidForm(formRef);
-```
----
-  ✅ **_validateFormRef**  
-Returns form validity and error details from a Formik ref.  
-```ts
-const { isValid, errors } = await _validateFormRef(formRef);
-```
----
-  ✅ **_initializeFormValues**  
-Initializes form values with empty strings for each field.  
-```ts
-const initialValues = _initializeFormValues(['name', 'email']);
-```
----
-  ✅ **_dynamicRequiredValidation**  
-Generates a Yup schema with required validations for given fields.  
-```ts
-const schema = _dynamicRequiredValidation(['name', 'email']);
-```
----
-  ✅ **_generateYupValidation**  
-Creates a Yup validation schema with all fields marked as required.  
-```ts
-const schema = _generateYupValidation(['name', 'age']);
-```
----
-  ✅ **_initializeFormikFields**  
-Returns an object with default empty string values for Formik fields.  
-```ts
-const formikFields = _initializeFormikFields(['username', 'password']);
-```
----
- ✅ **_isNotEmpty**  
-Checks if a given value is not empty — returns false for empty arrays, empty objects, and falsy values like null, undefined, false, or ''.
-```ts
-const isEmpty = _isNotEmpty([]);
-```
----
- ✅ **_isEmptyArray**  
-Checks if a given value is an empty array.
-```ts
-const isEmpty = _isEmptyArray([]);
-```
----
- ✅ **_isEmptyObject**  
-Checks if an object has no own properties.
-```ts
-const isObjEmpty = _isEmptyObject({});
-```
----
- ✅ **_isValueInArray**  
-Checks whether a value exists in a given array.
-```ts
-// 🔍 Value in Array
-const exists = _isValueInArray([1, 2, 3], 2);
-```
----
- ✅ **_sleep**  
-Creates a delay for a given time using Promise.
 
+### ✅ **_transformArray**
+Applies a transformation function to each item in an array.
 ```ts
-// ⏳ Delay Execution
-await _sleep(1000); 
-```
----
- ✅ **_hasItem**  
-Searches recursively in a menu tree to find an item by `path`.
-```ts
-// 🧭 Find Menu Item by Path
-const item = _hasItem(menuItems, "/dashboard");
-```
----
-  ✅ **_hasElement**  
-Searches recursively in a menu tree to find an element by key and value.
-```ts
-// 🔎 Find Element in Menu
-const found = _hasElement(menuItems, "id", 5);
-```
----
-  ✅ **_flattenArray**  
-Flattens nested arrays by recursively extracting `item.data` if present.
-```ts
-// 🔁 Flatten Nested Arrays
-const flat = _flattenArray(nestedArray);
+const result = _transformArray(users, user => user.name);
 ```
----
-
-✅ **_filterByMatchedKey**  
-Filters `list1` based on matching key values from `list2`.
 
+### ✅ **_transformAsyncData**
+Applies a transformer to each array item asynchronously.
 ```ts
-// 🔍 Filter by matching key in both lists
-const filtered = _filterByMatchedKey(usersList, activeUsers, "userId");
+const updated = await _transformAsyncData(data, transformFn);
 ```
 
----
-
-✅ **_filterByMatchingKey**  
-Filters `list1` by comparing the key's value in `list2`, with more validation than `_filterByMatchedKey`.
-
+### ✅ **_updateObjectInArray**
+Updates a matching object in an array by key-value.
 ```ts
-// 🔍 Filter with validation for objects
-const filtered = _filterByMatchingKey(productList, inStockItems, "productId");
+const updated = _updateObjectInArray(users, 'id', '123', { name: 'New Name' });
 ```
 
 ---
 
-✅ **_filterArrayByKeyValue**  
-Filters an array by a key-value match. Defaults to filtering where the key's value is `true`.
+##  Object Functions
 
-```ts
-// ✅ Filter by key value
-const enabledUsers = _filterArrayByKeyValue(userList, "isActive", true);
-```
-
----
-  ✅ **_deepClone**  
+### ✅ **_deepClone**
 Deep clones an object using `JSON.stringify` and `JSON.parse`.
 ```ts
-// 🧬 Deep Clone
 const clone = _deepClone(originalObj);
 ```
----
-  ✅ **_mergeObjects**  
-Merges two objects, giving priority to the second object’s properties.
-```ts
-// 🔀 Merge Objects
-const merged = _mergeObjects(obj1, obj2);
-```
----
-  ✅ **_mapObject**  
-Maps over an object and returns an array using a callback.
-```ts
-// 🗺️ Map Object
-const result = _mapObject(myObj, (key, value) => `${key}: ${value}`);
-```
----
-  ✅ **_isEqual**  
-Checks deep equality of two values using `JSON.stringify`.
-```ts
-// 🟰 Check Equality
-const isSame = _isEqual(obj1, obj2);
-```
----
-  ✅ **_capitalize**  
-Capitalizes the first character of a string.
-```ts
-// 🔡 Capitalize
-const name = _capitalize("john");
-```
-
----
-
-### ✅ **_countWords**
-
-Counts the number of words in a string by trimming whitespace and splitting by spaces.
 
+### ✅ **_deepEqual**
+Deep comparison between two objects.
 ```ts
-const wordCount = _countWords('  Hello world! How are you?  ');
-// Output: 5
+const isSame = _deepEqual(objA, objB);
 ```
 
----
-  ✅ **_isMobile**  
-Detects if the current device is a mobile device.
-```ts
-// 📱 Check if Mobile
-const mobile = _isMobile();
-```
----
-  ✅ **_scrollToTop**  
-Scrolls the page smoothly to the top.
-```ts
-// ⬆️ Scroll to Top
-_scrollToTop();
-```
----
-  ✅ **_batchProcess**  
-Processes an array of data in asynchronous batches.
-```ts
-await _batchProcess(myArray, 10, async (item) => {
-  await handleItem(item);
-});
-```
----
-  ✅ **_flattenObject**  
-Flattens a nested object into dot notation key-value pairs.
-```ts
-const flat = _flattenObject({ a: { b: 1 } }); // { 'a.b': 1 }
-```
----
-  ✅ **_deepMerge**  
+### ✅ **_deepMerge**
 Recursively merges two objects.
 ```ts
 const merged = _deepMerge(obj1, obj2);
 ```
----
-  ✅ **_chunk**  
-Splits an array into chunks of a given size.
 
+### ✅ **_filterObjectByKey**
+Filters object based on allowed keys.
 ```ts
-const parts = _chunk([1, 2, 3, 4], 2); // [[1,2], [3,4]]
-```
----
-  ✅ **_asyncDebounce**  
-Debounces an async function call.
-```ts
-const debouncedFn = _asyncDebounce(fetchData, 500);
-debouncedFn();
+_filterObjectByKey(user, ['id', 'name']);
 ```
----
-  ✅ **_deepCloneArray**  
-Deeply clones an array of objects.
+
+### ✅ **_flattenObject**
+Flattens a nested object into dot notation key-value pairs.
 ```ts
-const cloned = _deepCloneArray(originalArray);
+const flat = _flattenObject({ a: { b: 1 } }); // { 'a.b': 1 }
 ```
----
-  ✅ **_getMaxMinValue**  
-Finds the max and min values in an array.
+
+### ✅ **_freeze**
+Freezes an object to make it immutable.
 ```ts
-const { max, min } = _getMaxMinValue([5, 2, 9]);
+const frozen = _freeze(config);
 ```
----
-  ✅ **_asyncMap**  
-Async map over array items one by one.
+
+### ✅ **_getKeyByValue**
+Returns the first key in an object with the matching value.
 ```ts
-const results = await _asyncMap(ids, fetchById);
+const key = _getKeyByValue(obj, 'targetValue');
 ```
----
-  ✅ **_transformAsyncData**  
-Applies a transformer to each array item asynchronously.
 
+### ✅ **_getKeysByValue**
+Finds all keys in an object with a specific value.
 ```ts
-const updated = await _transformAsyncData(data, transformFn);
+const keys = _getKeysByValue(obj, 'active');
 ```
----
-  ✅ **_getNestedProperty**  
+
+### ✅ **_getNestedProperty**
 Retrieves value from object using a string path.
 ```ts
 const value = _getNestedProperty(user, 'profile.name');
 ```
----
-  ✅ **_deepEqual**  
-Deep comparison between two objects.
-```ts
-const isSame = _deepEqual(objA, objB);
-```
----
-  ✅ **_mergeArrays**  
-Merges two arrays and removes duplicates.
-```ts
-const merged = _mergeArrays(arr1, arr2);
-```
----
-  ✅ **_filterDuplicates**  
-Removes duplicates based on a specific object key.
-```ts
-const unique = _filterDuplicates(users, 'id');
-```
-
----
-
-✅ **_extractUniqueValues**
-Extracts unique values from an array based on a specific key.
 
+### ✅ **_getObjectValues**
+Returns object values as an array.
 ```ts
-const employees = [
-  { id: 1, department: "HR" },
-  { id: 2, department: "IT" },
-  { id: 3, department: "HR" },
-];
-
-_extractUniqueValues(employees, "department");
-["HR", "IT"]
+_getObjectValues({ a: 1, b: 2 }); // [1, 2]
 ```
 
----
-
-✅ **_extractKeyValues**
-Extracts all non-undefined values for a specific key from an array.
-
+### ✅ **_getValueByKey**
+Returns the value of a key from an object.
 ```ts
-const employees = [
-  { id: 1, name: "Alice" },
-  { id: 2 },
-  { id: 3, name: "Bob" },
-];
-
-_extractKeyValues(employees, "name");
-["Alice", "Bob"]
+const value = _getValueByKey(obj, 'username');
 ```
 
----
-
-✅ **_extractNestedKeyValues**
-Extracts all non-undefined values from a nested key path in an array of objects.
-
-```ts
-const users = [
-  { id: 1, address: { city: "Mumbai" } },
-  { id: 2, address: { city: "Pune" } },
-  { id: 3 },
-];
-
-_extractNestedKeyValues(users, "address.city");
-
-["Mumbai", "Pune"]
-```
----
-  ✅ **_sortByKey**  
-Sorts array of objects by a specific key.
-```ts
-const sorted = _sortByKey(products, 'price');
-```
----
-  ✅ **_mapAsync**  
-Parallel async map over array.
-```ts
-const data = await _mapAsync(users, fetchDetails);
-```
----
-  ✅ **_formatDate**  
-Formats a date based on a custom pattern.
-```ts
-_formatDate(new Date(), 'YMD'); // e.g., "Apr 9, 2025"
-```
----
-  ✅ **_calPercentage**  
-Calculates the percentage of a value relative to total.
-```ts
-_calPercentage(40, 200); // 20
-```
----
-  ✅ **_sum**  
-Returns the sum of an array of numbers.
-```ts
-_sum([1, 2, 3]); // 6
-```
----
-  ✅ **_average**  
-Calculates the average of numbers in an array.
-```ts
-_average([4, 8]); // 6
-```
----
-  ✅ **_getPriceAfterTax**  
-Adds tax to a given price.
-```ts
-_getPriceAfterTax(100, 18); // 118
-```
----
-  ✅ **_calculateTimeDifference**  
-Returns difference between two dates in readable format.
-```ts
-_calculateTimeDifference(start, end); // "1d 2h 3m 4s"
-```
----
-  ✅ **_arrayIncludesObject**  
-Checks if array contains object (by value).
-```ts
-_arrayIncludesObject(arr, obj);
-```
----
-  ✅ **_toCamelCase**  
-Converts kebab-case or snake_case to camelCase.
+### ✅ **_isEmptyObject**
+Checks if an object has no own properties.
 ```ts
-_toCamelCase('hello_world'); // helloWorld
+const isObjEmpty = _isEmptyObject({});
 ```
----
-  ✅ **_freeze**  
-Freezes an object to make it immutable.
+
+### ✅ **_isEqual**
+Checks deep equality of two values using `JSON.stringify`.
 ```ts
-const frozen = _freeze(config);
+const isSame = _isEqual(obj1, obj2);
 ```
----
-  ✅ **_isFreeze**  
+
+### ✅ **_isFreeze**
 Checks if object is frozen.
 ```ts
 _isFreeze(obj); // true/false
 ```
----
-  ✅ **_seal**  
-Seals an object to prevent adding/removing properties.
-```ts
-_seal(settings);
-```
----
-  ✅ **_isSeal**  
+
+### ✅ **_isSeal**
 Checks if object is sealed.
 ```ts
 _isSeal(obj); // true/false
 ```
----
-  ✅ **_arrayToObject**  
-Converts array of key-value pairs to object.
-```ts
-_arrayToObject([['a', 1], ['b', 2]]);
-```
----
-  ✅ **_objectToArray**  
-Converts object to array of key-value pairs.
-```ts
-_objectToArray({ a: 1 }); // [['a', 1]]
-```
----
-  ✅ **_arrayToObjectByKey**  
-Converts array of objects to object using a key.
-```ts
-_arrayToObjectByKey(users, 'id');
-```
----
-  ✅ **_isInArray**  
-Checks if a value exists in array.
+
+### ✅ **_mapObject**
+Maps over an object and returns an array using a callback.
 ```ts
-_isInArray(['a', 'b'], 'b'); // true
+const result = _mapObject(myObj, (key, value) => `${key}: ${value}`);
 ```
----
-  ✅ **_getObjectValues**  
-Returns object values as an array.
+
+### ✅ **_mergeObjects**
+Merges two objects, giving priority to the second object's properties.
 ```ts
-_getObjectValues({ a: 1, b: 2 }); // [1, 2]
+const merged = _mergeObjects(obj1, obj2);
 ```
----
-  ✅ **_swapArrayElements**  
-Swaps two elements in an array.
+
+### ✅ **_objectToArray**
+Converts object to array of key-value pairs.
 ```ts
-_swapArrayElements(arr, 0, 1);
+_objectToArray({ a: 1 }); // [['a', 1]]
 ```
----
-  ✅ **_filterObjectByKey**  
-Filters object based on allowed keys.
+
+### ✅ **_seal**
+Seals an object to prevent adding/removing properties.
 ```ts
-_filterObjectByKey(user, ['id', 'name']);
+_seal(settings);
 ```
----
-  ✅ **_getScrollPosition**  
-Returns current window scroll position.
 
+### ✅ **_setNestedProperty**
+Sets a deeply nested property in an object using a string path.
 ```ts
-const { scrollX, scrollY } = _getScrollPosition();
+_setNestedProperty(obj, 'user.address.city', 'Mumbai');
 ```
+
 ---
-  ✅ **_arrayIntersection**  
-Returns common elements between two arrays.
+
+## Form & Validation Functions
+
+### ✅ **_dynamicRequiredValidation**
+Generates a Yup schema with required validations for given fields.
 ```ts
-_arrayIntersection([1,2,3], [2,3,4]); // [2,3]
+const schema = _dynamicRequiredValidation(['name', 'email']);
 ```
----
-  ✅ **_getArrayOfObjectsByProperty**  
-Returns all objects with a specific property value.
+
+### ✅ **_generateYupValidation**
+Creates a Yup validation schema with all fields marked as required.
 ```ts
-_getArrayOfObjectsByProperty(data, 'type', 'active');
+const schema = _generateYupValidation(['name', 'age']);
 ```
----
-  ✅ **_setNestedProperty**  
-Sets a deeply nested property in an object using a string path.  
+
+### ✅ **_initializeFormikFields**
+Returns an object with default empty string values for Formik fields.
 ```ts
-_setNestedProperty(obj, 'user.address.city', 'Mumbai');
+const formikFields = _initializeFormikFields(['username', 'password']);
 ```
----
-  ✅ **_transformArray**  
-Applies a transformation function to each item in an array.  
+
+### ✅ **_initializeFormValues**
+Initializes form values with empty strings for each field.
 ```ts
-const result = _transformArray(users, user => user.name);
+const initialValues = _initializeFormValues(['name', 'email']);
 ```
----
-  ✅ **_findObjectById**  
-Finds an object in an array by its `id`.  
+
+### ✅ **_isValidForm**
+Validates a Formik form and returns whether it's valid.
 ```ts
-const item = _findObjectById(items, '123');
+const isValid = await _isValidForm(formRef);
 ```
----
-  ✅ **_getUniqueValues**  
-Returns an array of unique values.  
+
+### ✅ **_setTouchedFields**
+Marks all fields with errors as touched in a Formik form.
 ```ts
-const unique = _getUniqueValues([1, 2, 2, 3]);
+_setTouchedFields(formRef, errors);
 ```
----
-  ✅ **_mergeArraysByKey**  
-Merges two arrays of objects based on a common key.  
+
+### ✅ **_validateFormRef**
+Returns form validity and error details from a Formik ref.
 ```ts
-const merged = _mergeArraysByKey(arr1, arr2, 'id');
+const { isValid, errors } = await _validateFormRef(formRef);
 ```
 
 ---
 
-  ✅ **_removeDuplicates**  
-Removes duplicate objects based on a key.  
+## ✅ Validation Functions
 
+### ✅ **_isValidBase64**
+Checks if a string is a valid Base64-encoded value.
 ```ts
-const cleaned = _removeDuplicates(data, 'email');
+const isValid = _isValidBase64('U29tZSB0ZXh0');
 ```
 
----
-
-  ✅ **_groupBy**  
-Groups array items by a given key.  
+### ✅ **_isValidBlob**
+Checks if the input is a `Blob`.
+```ts
+const isValid = _isValidBlob(new Blob(['text']));
+```
 
+### ✅ **_isValidBoolean**
+Checks if the input is a boolean.
 ```ts
-const grouped = _groupBy(users, 'department');
+const isValid = _isValidBoolean(true);
 ```
 
----
+### ✅ **_isValidCreditCard**
+Checks if a string matches known credit card patterns.
+```ts
+const isValid = _isValidCreditCard('4111111111111111');
+```
 
-  ✅ **_arrayDiff**  
-Returns the difference between two arrays.  
+### ✅ **_isValidDate**
+Checks if a string matches the `YYYY-MM-DD` date format.
+```ts
+const isValid = _isValidDate('2025-04-09');
+```
 
+### ✅ **_isValidDateObject**
+Checks if the input is a valid `Date` object.
 ```ts
-const diff = _arrayDiff(['a', 'b'], ['b']);
+const isValid = _isValidDateObject(new Date());
 ```
 
----
+### ✅ **_isValidDateRange**
+Checks if the start date is earlier than or equal to the end date.
+```ts
+const isValid = _isValidDateRange('2025-01-01', '2025-12-31');
+```
 
-  ✅ **_deepCompareArrays**  
-Checks if two arrays are deeply equal.  
+### ✅ **_isValidDateTime**
+Checks if a string matches the `YYYY-MM-DDTHH:mm:ss` format.
+```ts
+const isValid = _isValidDateTime('2025-04-09T12:30:00');
+```
 
+### ✅ **_isValidDateString**
+Checks if the string can be parsed as a valid date.
 ```ts
-const isEqual = _deepCompareArrays(arr1, arr2);
+const isValid = _isValidDateString('2025-04-09');
 ```
 
----
+### ✅ **_isValidEmail**
+Checks if a string is a valid email address.
+```ts
+const isValid = _isValidEmail('user@example.com');
+```
 
-  ✅ **_updateObjectInArray**  
-Updates a matching object in an array by key-value.  
+### ✅ **_isValidEvent**
+Checks if the input is an instance of `Event`.
+```ts
+const isValid = _isValidEvent(new Event('click'));
+```
 
+### ✅ **_isValidFile**
+Checks if the input is a `File`.
 ```ts
-const updated = _updateObjectInArray(users, 'id', '123', { name: 'New Name' });
+const isValid = _isValidFile(new File([''], 'file.txt'));
 ```
 
----
+### ✅ **_isValidFormData**
+Checks if the input is a `FormData` instance.
+```ts
+const isValid = _isValidFormData(new FormData());
+```
 
-  ✅ **_getKeyByValue**  
-Returns the first key in an object with the matching value.  
+### ✅ **_isValidFunction**
+Checks if the input is a valid function.
+```ts
+const isValid = _isValidFunction(() => {});
+```
 
+### ✅ **_isValidHexColor**
+Checks if a string is a valid hex color code.
 ```ts
-const key = _getKeyByValue(obj, 'targetValue');
+const isValid = _isValidHexColor('#FF5733');
 ```
 
----
+### ✅ **_isValidHTMLCollection**
+Checks if the input is an `HTMLCollection`.
+```ts
+const isValid = _isValidHTMLCollection(document.forms);
+```
 
-  ✅ **_getValueByKey**  
-Returns the value of a key from an object.  
+### ✅ **_isValidHTMLElement**
+Checks if the input is an instance of `HTMLElement`.
+```ts
+const isValid = _isValidHTMLElement(document.body);
+```
 
+### ✅ **_isValidIP**
+Checks if a string is a valid IPv4 address.
 ```ts
-const value = _getValueByKey(obj, 'username');
+const isValid = _isValidIP('192.168.1.1');
 ```
 
----
+### ✅ **_isValidJSON**
+Checks if a string is valid JSON.
+```ts
+const isValid = _isValidJSON('{"name":"John"}');
+```
 
-  ✅ **_getKeysByValue**  
-Finds all keys in an object with a specific value.  
+### ✅ **_isValidMacAddress**
+Checks if a string is a valid MAC address.
+```ts
+const isValid = _isValidMacAddress('00:1A:2B:3C:4D:5E');
+```
 
+### ✅ **_isValidNode**
+Checks if the input is a `Node`.
 ```ts
-const keys = _getKeysByValue(obj, 'active');
+const isValid = _isValidNode(document.createTextNode('text'));
 ```
 
----
+### ✅ **_isValidNodeList**
+Checks if the input is a `NodeList`.
+```ts
+const isValid = _isValidNodeList(document.querySelectorAll('div'));
+```
 
-  ✅ **_escapeRegExpMatch**  
-Escapes special characters for regex matching.  
+### ✅ **_isValidNumber**
+Checks if the input is a valid number.
+```ts
+const isValid = _isValidNumber(123.45);
+```
 
+### ✅ **_isValidPassword**
+Checks if a password has 8+ characters, at least 1 letter and 1 number.
 ```ts
-const escaped = _escapeRegExpMatch('a+b*c');
+const isValid = _isValidPassword('Abc12345');
 ```
 
----
+### ✅ **_isValidPhoneNumber**
+Checks if a string is a valid international phone number (10–15 digits).
+```ts
+const isValid = _isValidPhoneNumber('+919876543210');
+```
 
-  ✅ **_isExactMatch**  
-Checks if a string contains an exact word match using regex.  
+### ✅ **_isValidPromise**
+Checks if the input is a `Promise`.
+```ts
+const isValid = _isValidPromise(Promise.resolve());
+```
 
+### ✅ **_isValidRegExp**
+Checks if the input is a regular expression.
 ```ts
-const match = _isExactMatch('The quick brown fox', 'quick');
+const isValid = _isValidRegExp(/abc/);
 ```
 
----
+### ✅ **_isValidString**
+Checks if the input is a non-empty string.
+```ts
+const isValid = _isValidString('Hello');
+```
 
-  ✅ **_bytesToSize**  
-Converts byte size into a human-readable format.  
+### ✅ **_isValidTime**
+Checks if a string is a valid 24-hour `HH:mm` format.
+```ts
+const isValid = _isValidTime('23:59');
+```
 
+### ✅ **_isValidURL**
+Checks if a string is a valid URL format.
 ```ts
-const size = _bytesToSize(1024); // "1 KB"
+const isValid = _isValidURL('https://example.com');
 ```
 
----
+### ✅ **_isValidURLSearchParams**
+Checks if the input is a `URLSearchParams` instance.
+```ts
+const isValid = _isValidURLSearchParams(new URLSearchParams());
+```
 
-  ✅ **_swapArrayByKey**  
-Sorts an array in descending order based on a key.  
+### ✅ **_isValidUsername**
+Checks if a username is 3+ characters and contains only letters, numbers, dots, underscores, or hyphens.
+```ts
+const isValid = _isValidUsername('john_doe');
+```
 
+### ✅ **_isValidUUID**
+Checks if a string is a valid UUID (v1 to v5).
 ```ts
-const sorted = _swapArrayByKey(data, 'score');
+const isValid = _isValidUUID('550e8400-e29b-41d4-a716-446655440000');
 ```
 
 ---
 
-  ✅ **_allowDecimalKeys**  
-Allows only decimal input and valid control keys.
+## Security & Encryption Functions
 
+### ✅ **_decryptJson**
+Decrypts AES-encrypted JSON string using a secret key.
 ```ts
-<input onKeyDown={_allowDecimalKeys} />
+const decrypted = _decryptJson(encryptedString, "secret123");
 ```
 
----
+### ✅ **_decryptString**
+Decrypts an AES-encrypted string using the provided IV and secret key.
+```ts
+const plainText = _decryptString(ciphertext, iv, "secretKey");
+```
 
-  ✅ **_allowAlphaKeys**  
-Allows only alphabetic input and valid control keys.
+### ✅ **_encryptJson**
+Encrypts a JSON object using AES encryption with a secret key.
+```ts
+const encrypted = _encryptJson({ name: "John" }, "secret123");
+```
 
+### ✅ **_encryptPayload**
+Encrypts a full payload using a randomly generated key and IV, secured by a static key.
 ```ts
-<input onKeyDown={_allowAlphaKeys} />
+const payload = _encryptPayload({ id: 1 }, "mainSecretKey");
 ```
 
----
+### ✅ **_encryptString**
+Encrypts a plain string using AES encryption, with optional random IV.
+```ts
+const result = _encryptString("mySecretText", "secretKey");
+```
 
-  ✅ **_handlePasteDecimalKeys**  
-Prevents pasting invalid decimal values.
+### ✅ **_escapeHTML**
+Escapes special HTML characters to prevent injection or rendering issues.
+```ts
+const safeHTML = _escapeHTML('<div class="test">Tom & Jerry</div>');
+// Output: '&lt;div class=&quot;test&quot;&gt;Tom &amp; Jerry&lt;/div&gt;'
+```
 
+### ✅ **_generatePassword**
+Generates a strong random password with mixed characters.
 ```ts
-<input onPaste={_handlePasteDecimalKeys} />
+const newPassword = _generatePassword(12);
 ```
 
 ---
 
-  ✅ **_handlePasteAlphabetKeys**  
-Prevents pasting non-alphabetic characters.
+## Event & DOM Functions
 
+### ✅ **_addEventListenerToElement**
+Attaches an event listener to a DOM element.
 ```ts
-<input onPaste={_handlePasteAlphabetKeys} />
+_addEventListenerToElement('#my-btn', 'click', handleClick);
 ```
 
----
+### ✅ **_allowAlphaKeys**
+Allows only alphabetic input and valid control keys.
+```ts
+<input onKeyDown={_allowAlphaKeys} />
+```
 
-  ✅ **_allowAlphaNumericKeys**  
+### ✅ **_allowAlphaNumericKeys**
 Allows only alphanumeric keys during typing.
-
 ```ts
 document.addEventListener('keydown', _allowAlphaNumericKeys);
 ```
 
----
-
- ✅ **_onWindowLoad**
-
-Executes the callback when the **entire window is fully loaded**, including all images and assets.
-
+### ✅ **_allowDecimalKeys**
+Allows only decimal input and valid control keys.
 ```ts
-// 🔍 Run when everything (DOM + images) is fully loaded
-_onWindowLoad(() => {
-  console.log('Window fully loaded!');
-});
+<input onKeyDown={_allowDecimalKeys} />
 ```
 
----
-
- ✅ **_onDOMLoad**
-
-Executes the callback when the **DOM is fully parsed**, but before images and other resources are necessarily loaded.
-
+### ✅ **_clearNode**
+Hides specific sibling DOM nodes relative to a base element.
 ```ts
-// 🔍 Run when DOM is ready for manipulation
-_onDOMLoad(() => {
-  const el = document.getElementById('app');
-  console.log('DOM ready:', el);
-});
+_clearNode('.my-element', [{ type: 'previous', steps: 1 }]);
 ```
 
----
-
-✅ **_onFullReload**
-
-Executes the callback **only when the page is reloaded** (not on SPA route changes or soft navigation).
+### ✅ **_cloneElement**
+Clones a DOM element.
+```ts
+const clone = _cloneElement('.to-clone');
+```
 
+### ✅ **_domSelector**
+Selects a single or all DOM elements matching a CSS selector.
 ```ts
-// 🔄 Run only on a full page reload (F5 or browser refresh)
-_onFullReload(() => {
-  console.log('Page was fully reloaded.');
-});
+const el = _domSelector('#myElement');
+const elements = _domSelector('.list-item', true);
 ```
 
----
+### ✅ **_getChildElements**
+Returns child elements of a selector.
+```ts
+const children = _getChildElements('.container');
+```
 
-✅ **_getQueryString**
+### ✅ **_getElementAttribute**
+Gets the value of an element's attribute.
+```ts
+const id = _getElementAttribute('.item', 'data-id');
+```
 
-Returns the query string from the current URL, supporting both `?search` and `#hash?search` formats.
+### ✅ **_getElementsByClass**
+Returns elements with a given class.
+```ts
+const elements = _getElementsByClass('my-class');
+```
 
+### ✅ **_getElementsByTag**
+Returns elements with a given tag name.
 ```ts
-// 🔍 Get current query string
-const query = _getQueryString();
-console.log('Query string:', query); // Example: ?id=123
+const buttons = _getElementsByTag('button');
 ```
 
----
-
-  ✅ **_domSelector**  
-Selects a single or all DOM elements matching a CSS selector.
+### ✅ **_getParent**
+Returns parent of a DOM element.
+```ts
+const parent = _getParent('.child');
+```
 
+### ✅ **_getScrollPosition**
+Returns current window scroll position.
 ```ts
-// 🔍 Select DOM Element
-const el = _domSelector('#myElement');
+const { scrollX, scrollY } = _getScrollPosition();
+```
 
-// 🔍 Select All DOM Elements
-const elements = _domSelector('.list-item', true);
+### ✅ **_handlePasteAlphabetKeys**
+Prevents pasting non-alphabetic characters.
+```ts
+<input onPaste={_handlePasteAlphabetKeys} />
 ```
 
----
+### ✅ **_handlePasteDecimalKeys**
+Prevents pasting invalid decimal values.
+```ts
+<input onPaste={_handlePasteDecimalKeys} />
+```
 
-  ✅ **_hideElement**  
+### ✅ **_hideElement**
 Hides a DOM element by setting its `display` style to `'none'`.
-
 ```ts
-// 🙈 Hide Element
 _hideElement('#modal');
 ```
 
----
-
-  ✅ **_showElement**  
-Displays a hidden DOM element using the provided `displayType` (default is `'block'`).
-
+### ✅ **_insertHTML**
+Injects HTML at a specific position.
 ```ts
-// 👁️ Show Element
-_showElement('#modal');
-
-// 👁️ Show with Custom Display Type
-_showElement('#modal', 'flex');
+_insertHTML('#box', 'beforeend', '<div>Hello</div>');
 ```
 
----
-
-  ✅ **_removeElement**  
-Removes the **first matched** DOM element from the document.
-
+### ✅ **_isDocumentLoaded**
+Checks if the document has fully loaded.
 ```ts
-// ❌ Remove Element
-_removeElement('#banner');
+if (_isDocumentLoaded()) { /* safe to run code */ }
 ```
 
----
-
-  ✅ **_removeNode**  
-Removes **all matched** DOM elements from the document.
-
+### ✅ **_isElementInViewport**
+Checks if element is visible in viewport.
 ```ts
-// 🧹 Remove All Matching Nodes
-_removeNode('.temp-item');
+const isVisible = _isElementInViewport('.my-element');
 ```
 
----
-
-  ✅ **_removeSafeElement**  
-Safely removes an element if it exists and has a parent.
-
+### ✅ **_isElementPresent**
+Checks if an element exists in the DOM.
 ```ts
-// 🛡️ Safe Remove Element
-_removeSafeElement('#popup');
+const exists = _isElementPresent('.my-element');
 ```
 
----
-
-  ✅ **_clearNode**  
-Hides specific sibling DOM nodes relative to a base element.
-
+### ✅ **_onDOMLoad**
+Executes the callback when the **DOM is fully parsed**, but before images and other resources are necessarily loaded.
 ```ts
-_clearNode('.my-element', [{ type: 'previous', steps: 1 }]);
+_onDOMLoad(() => {
+  const el = document.getElementById('app');
+  console.log('DOM ready:', el);
+});
 ```
 
----
-
-  ✅ **_isElementPresent**  
-Checks if an element exists in the DOM.
+### ✅ **_onFullReload**
+Executes the callback **only when the page is reloaded** (not on SPA route changes or soft navigation).
 ```ts
-const exists = _isElementPresent('.my-element');
+_onFullReload(() => {
+  console.log('Page was fully reloaded.');
+});
 ```
----
 
-  ✅ **_removeElement**  
-Removes an element from the DOM.
+### ✅ **_onWindowLoad**
+Executes the callback when the **entire window is fully loaded**, including all images and assets.
+```ts
+_onWindowLoad(() => {
+  console.log('Window fully loaded!');
+});
+```
 
+### ✅ **_reloadAfterLoad**
+Reloads page after a delay post-load.
 ```ts
-_removeElement('#to-remove');
+_reloadAfterLoad(3000); // Reload 3s after load
 ```
 
----
-  ✅ **_getParent**  
-Returns parent of a DOM element.
+### ✅ **_removeAllChildren**
+Clears all child nodes of an element.
 ```ts
-const parent = _getParent('.child');
+_removeAllChildren('#container');
 ```
----
-  ✅ **_getChildElements**  
-Returns child elements of a selector.
+
+### ✅ **_removeElement**
+Removes the **first matched** DOM element from the document.
 ```ts
-const children = _getChildElements('.container');
+_removeElement('#banner');
 ```
----
-  ✅ **_handleParentsMenu**  
-Recursively updates parent menu's assigned state and permissions based on children.
+
+### ✅ **_removeElementAttribute**
+Removes an attribute from an element.
 ```ts
-_handleParentsMenu(menuList, menuId);
+_removeElementAttribute('.item', 'data-id');
 ```
----
-  ✅ **_handleParentNode**  
-Recursively updates parent permissions based on child permissions.
+
+### ✅ **_removeEventListenerFromElement**
+Removes a specific event listener.
 ```ts
-_handleParentNode(menuList, menuId, permissionKey);
+_removeEventListenerFromElement('#my-btn', 'click', handleClick);
 ```
----
-  ✅ **_handleChildrenMenu**  
-Recursively sets assigned state and permissions of child nodes.
+
+### ✅ **_removeNode**
+Removes **all matched** DOM elements from the document.
 ```ts
-_handleChildrenMenu(menuList, parentKey, checked);
+_removeNode('.temp-item');
 ```
 
----
+### ✅ **_removeSafeElement**
+Safely removes an element if it exists and has a parent.
+```ts
+_removeSafeElement('#popup');
+```
 
-  ✅ **_replaceContent**  
+### ✅ **_replaceContent**
 Replaces inner HTML of an element.
-
 ```ts
 _replaceContent('#content', '<p>New content</p>');
 ```
 
----
-
-  ✅ **_cloneElement**  
-Clones a DOM element.
-
+### ✅ **_runOnIframeLoad**
+Runs a callback when iframe finishes loading.
 ```ts
-const clone = _cloneElement('.to-clone');
+_runOnIframeLoad('#myIframe', () => console.log('Loaded'));
 ```
 
----
-
-  ✅ **_scrollToElement**  
+### ✅ **_scrollToElement**
 Scrolls smoothly to an element.
-
 ```ts
 _scrollToElement('#target');
 ```
 
----
-
-  ✅ **_isElementInViewport**  
-Checks if element is visible in viewport.
-
+### ✅ **_scrollToTop**
+Scrolls the page smoothly to the top.
 ```ts
-const isVisible = _isElementInViewport('.my-element');
+_scrollToTop();
 ```
 
----
+### ✅ **_setElementAttribute**
+Sets an attribute on a DOM element.
+```ts
+_setElementAttribute('.item', 'data-id', '123');
+```
 
-  ✅ **_setElementDisabled**  
+### ✅ **_setElementDisabled**
 Enables or disables a DOM element.
-
 ```ts
 _setElementDisabled('#submit-btn', true);
 ```
 
----
-
-  ✅ **_addEventListenerToElement**  
-Attaches an event listener to a DOM element.
-
+### ✅ **_setMultipleStyles**
+Applies multiple CSS styles to an element.
 ```ts
-_addEventListenerToElement('#my-btn', 'click', handleClick);
+_setMultipleStyles('.card', { color: 'red', fontWeight: 'bold' });
 ```
 
----
-
-  ✅ **_removeEventListenerFromElement**  
-Removes a specific event listener.
-
+### ✅ **_showElement**
+Displays a hidden DOM element using the provided `displayType` (default is `'block'`).
 ```ts
-_removeEventListenerFromElement('#my-btn', 'click', handleClick);
+_showElement('#modal');
+_showElement('#modal', 'flex');
 ```
 
 ---
 
-  ✅ **_getElementAttribute**  
-Gets the value of an element’s attribute.
+## File & Data Functions
 
+### ✅ **_base64ToBlob**
+Converts a base64-encoded string into a Blob object.
 ```ts
-const id = _getElementAttribute('.item', 'data-id');
+const blob = _base64ToBlob(base64String);
 ```
 
----
-
-  ✅ **_setElementAttribute**  
-Sets an attribute on a DOM element.
-
+### ✅ **_downloadBase64File**
+Downloads any base64-encoded data as a file with a specified filename and extension.
 ```ts
-_setElementAttribute('.item', 'data-id', '123');
-```
-
----
+const base64Image = 'iVBORw0KGgoAAAANSUhEUgAAA...';
+downloadBase64File(base64Image, 'my-picture.png');
 
-  ✅ **_removeElementAttribute**  
-Removes an attribute from an element.
+const base64PDF = 'JVBERi0xLjQKJeLjz9MNCjEgMCBvYmoK...';
+downloadBase64File(base64PDF, 'invoice.pdf');
+```
 
+### ✅ **_downloadBlob**
+Triggers download of a Blob object.
 ```ts
-_removeElementAttribute('.item', 'data-id');
+_downloadBlob(blob, 'myfile.pdf');
 ```
 
----
-
-  ✅ **_removeAllChildren**  
-Clears all child nodes of an element.
-
+### ✅ **_exportExcel**
+Exports JSON data to an Excel or CSV file.
 ```ts
-_removeAllChildren('#container');
+await _exportExcel({
+  data: [
+    { name: 'siya', age: 5 },
+    { name: 'riya', age: 6 },
+  ],
+  filename: 'users',
+})
+.then(() => console.log('Export successful'))
+.catch((err) => console.error('Export failed:', err.message));
 ```
 
----
-
-  ✅ **_getElementsByClass**  
-Returns elements with a given class.
-
+### ✅ **_fileToBase64**
+Converts a file to a base64-encoded string.
 ```ts
-const elements = _getElementsByClass('my-class');
+const base64 = await _fileToBase64(file);
 ```
 
----
+### ✅ **_importExcel**
+Imports data from an Excel file.
+```ts
+const fileInputHandler = async (event: React.ChangeEvent<HTMLInputElement>) => {
+  const { data, error } = await _importExcel(event);
 
-  ✅ **_getElementsByTag**  
-Returns elements with a given tag name.
+  if (error) {
+    console.error('Error:', error.message);
+    return;
+  }
+  
+  if (data) {
+    console.log('Successfully parsed data:', data);
+  }
+};
+```
 
+### ✅ **_importFile**
+Supports multiple types of result formats: base64, buffer, file, unit8array.
 ```ts
-const buttons = _getElementsByTag('button');
+const handleChangeFile = async (file) => {
+  const result = await _importFile(file, 'base64');
+  console.log('result', result);
+};
 ```
 
 ---
 
-  ✅ **_setMultipleStyles**  
-Applies multiple CSS styles to an element.
+## Browser & Storage Functions
 
+### ✅ **_clearRouteState**
+Removes the route state from the browser's history without reloading the page, keeping the current path intact.
 ```ts
-_setMultipleStyles('.card', { color: 'red', fontWeight: 'bold' });
+_clearRouteState('/dashboard');
 ```
 
----
-
-  ✅ **_insertHTML**  
-Injects HTML at a specific position.
-
+### ✅ **_copyText**
+Copies the provided text to the clipboard, using modern APIs with a fallback for older browsers.
 ```ts
-_insertHTML('#box', 'beforeend', '<div>Hello</div>');
+const success = await _copyText("Hello, clipboard!");
+if (success) {
+  console.log("Text copied successfully");
+}
 ```
 
----
-
-  ✅ **_isDocumentLoaded**  
-Checks if the document has fully loaded.
-
+### ✅ **_getBrowserInfo**
+Returns the name of the browser (e.g., Chrome, Firefox).
 ```ts
-if (_isDocumentLoaded()) { /* safe to run code */ }
+const browser = _getBrowserInfo();
 ```
 
----
-
-  ✅ **_runOnIframeLoad**  
-Runs a callback when iframe finishes loading.
-
+### ✅ **_getCookie**
+Retrieves a cookie value by its name.
 ```ts
-_runOnIframeLoad('#myIframe', () => console.log('Loaded'));
+const token = _getCookie('auth_token');
 ```
 
----
-
-  ✅ **_reloadAfterLoad**  
-Reloads page after a delay post-load.
-
+### ✅ **_getQueryString**
+Returns the query string from the current URL, supporting both `?search` and `#hash?search` formats.
 ```ts
-_reloadAfterLoad(3000); // Reload 3s after load
+const query = _getQueryString();
+console.log('Query string:', query); // Example: ?id=123
 ```
 
----
-
-  ✅ **_isValidEmail**  
-Checks if a string is a valid email address.
-
+### ✅ **_getStorage**
+Handles local/session storage actions like GET, SET, REMOVE, CLEAR.
 ```ts
-// 📧 Validate Email
-const isValid = _isValidEmail('user@example.com');
+const data = _getStorage({ action: 'GET', type: 'local', key: 'user' });
 ```
 
----
-
-  ✅ **_isValidPhoneNumber**  
-Checks if a string is a valid international phone number (10–15 digits).
-
+### ✅ **_isMobile**
+Detects if the current device is a mobile device.
 ```ts
-// 📱 Validate Phone Number
-const isValid = _isValidPhoneNumber('+919876543210');
+const mobile = _isMobile();
 ```
 
----
-
-  ✅ **_isValidURL**  
-Checks if a string is a valid URL format.
+### ✅ **_pasteText**
+Retrieves and returns the current text content from the clipboard, using modern APIs with a fallback for older browsers.
+```ts
+const text = await _pasteText();
+if (text) {
+  console.log("Pasted text:", text);
+}
+```
 
+### ✅ **_setCookie**
+Sets a cookie with a name, value, and expiry (in days).
 ```ts
-// 🌐 Validate URL
-const isValid = _isValidURL('https://example.com');
+_setCookie('auth_token', 'abc123', 7);
 ```
 
 ---
 
-  ✅ **_isValidDate**  
-Checks if a string matches the `YYYY-MM-DD` date format.
+##  String & Text Functions
 
+### ✅ **_bytesToSize**
+Converts byte size into a human-readable format.
 ```ts
-// 📅 Validate Date
-const isValid = _isValidDate('2025-04-09');
+const size = _bytesToSize(1024); // "1 KB"
 ```
 
----
-
-  ✅ **_isValidTime**  
-Checks if a string is a valid 24-hour `HH:mm` format.
-
+### ✅ **_capitalize**
+Capitalizes the first character of a string.
 ```ts
-// ⏰ Validate Time
-const isValid = _isValidTime('23:59');
+const name = _capitalize("john"); // "John"
 ```
 
----
-
-  ✅ **_isValidDateTime**  
-Checks if a string matches the `YYYY-MM-DDTHH:mm:ss` format.
-
+### ✅ **_countWords**
+Counts the number of words in a string by trimming whitespace and splitting by spaces.
 ```ts
-// 🕒 Validate DateTime
-const isValid = _isValidDateTime('2025-04-09T12:30:00');
+const wordCount = _countWords('  Hello world! How are you?  '); // 5
 ```
 
----
-
-  ✅ **_isValidDateRange**  
-Checks if the start date is earlier than or equal to the end date.
-
+### ✅ **_decodeURI**
+Decodes an encoded URI component back to its original readable string format.
 ```ts
-// 🔄 Validate Date Range
-const isValid = _isValidDateRange('2025-01-01', '2025-12-31');
+const decoded = _decodeURI('hello%20world%402024'); // 'hello world@2024'
 ```
 
----
-
-  ✅ **_isValidPassword**  
-Checks if a password has 8+ characters, at least 1 letter and 1 number.
-
+### ✅ **_encodeURI**
+Encodes a URI component by escaping special characters to make it safe for use in URLs.
 ```ts
-// 🔐 Validate Password
-const isValid = _isValidPassword('Abc12345');
+const encoded = _encodeURI('hello world@2024'); // 'hello%20world%402024'
 ```
 
----
-
-  ✅ **_isValidUsername**  
-Checks if a username is 3+ characters and contains only letters, numbers, dots, underscores, or hyphens.
-
+### ✅ **_escapeRegExpMatch**
+Escapes special characters for regex matching.
 ```ts
-// 👤 Validate Username
-const isValid = _isValidUsername('john_doe');
+const escaped = _escapeRegExpMatch('a+b*c');
 ```
 
----
-
-  ✅ **_isValidCreditCard**  
-Checks if a string matches known credit card patterns.
-
+### ✅ **_isExactMatch**
+Checks if a string contains an exact word match using regex.
 ```ts
-// 💳 Validate Credit Card
-const isValid = _isValidCreditCard('4111111111111111');
+const match = _isExactMatch('The quick brown fox', 'quick');
 ```
 
----
-
-  ✅ **_isValidHexColor**  
-Checks if a string is a valid hex color code.
-
+### ✅ **_parseJSON**
+Safely parses a JSON string into an object.
 ```ts
-// 🎨 Validate Hex Color
-const isValid = _isValidHexColor('#FF5733');
+const obj = _parseJSON(jsonString);
 ```
 
----
-
-  ✅ **_isValidIP**  
-Checks if a string is a valid IPv4 address.
-
+### ✅ **_stringifyJSON**
+Safely converts an object to a JSON string.
 ```ts
-// 🌐 Validate IP Address
-const isValid = _isValidIP('192.168.1.1');
+const str = _stringifyJSON(obj);
 ```
 
----
-
-  ✅ **_isValidMacAddress**  
-Checks if a string is a valid MAC address.
-
+### ✅ **_toCamelCase**
+Converts kebab-case or snake_case to camelCase.
 ```ts
-// 💻 Validate MAC Address
-const isValid = _isValidMacAddress('00:1A:2B:3C:4D:5E');
+_toCamelCase('hello_world'); // helloWorld
 ```
 
 ---
 
-  ✅ **_isValidUUID**  
-Checks if a string is a valid UUID (v1 to v5).
+##  Date & Time Functions
 
+### ✅ **_calculateTimeDifference**
+Returns difference between two dates in readable format.
 ```ts
-// 🆔 Validate UUID
-const isValid = _isValidUUID('550e8400-e29b-41d4-a716-446655440000');
+_calculateTimeDifference(start, end); // "1d 2h 3m 4s"
 ```
 
----
-
-  ✅ **_isValidBase64**  
-Checks if a string is a valid Base64-encoded value.
-
+### ✅ **_dateFormat**
+Formats a date using Moment.js with the specified format.
 ```ts
-// 🧬 Validate Base64
-const isValid = _isValidBase64('U29tZSB0ZXh0');
+const formatted = _dateFormat(new Date(), 'YYYY-MM-DD');
 ```
 
----
-
-  ✅ **_isValidJSON**  
-Checks if a string is valid JSON.
-
+### ✅ **_dateTransformer**
+Recursively formats all dates in an object or array.
 ```ts
-// 📦 Validate JSON
-const isValid = _isValidJSON('{"name":"John"}');
+const result = _dateTransformer(data);
 ```
 
----
-
-  ✅ **_isValidFunction**  
-Checks if the input is a valid function.
-
+### ✅ **_formatDate**
+Formats a date based on a custom pattern.
 ```ts
-// 🛠️ Validate Function
-const isValid = _isValidFunction(() => {});
+_formatDate(new Date(), 'YMD'); // e.g., "Apr 9, 2025"
 ```
 
----
-
-  ✅ **_isValidString**  
-Checks if the input is a non-empty string.
-
+### ✅ **_formatInternationalDate**
+Formats a date according to locale, timezone, and preset or custom format.
 ```ts
-// ✏️ Validate String
-const isValid = _isValidString('Hello');
+const formatted = _formatInternationalDate('2024-07-09T10:00:00Z', {
+  country: 'IN',
+  timezone: 'Asia/Kolkata',
+  format: 'DATETIME_SHORT',
+}); // "9/7/2024, 3:30 pm"
 ```
 
----
-
-  ✅ **_isValidNumber**  
-Checks if the input is a valid number.
-
+### ✅ **_getFinancialYear**
+Returns the current financial year based on today's date.
 ```ts
-// 🔢 Validate Number
-const isValid = _isValidNumber(123.45);
+const fy = _getFinancialYear();
 ```
 
----
-
-  ✅ **_isValidBoolean**  
-Checks if the input is a boolean.
-
+### ✅ **_getStartStopTime**
+Returns the start and end datetime of a given date's month in specified format.
 ```ts
-// ✅ Validate Boolean
-const isValid = _isValidBoolean(true);
+const { startTime, stopTime } = _getStartStopTime(new Date());
 ```
 
----
-
-  ✅ **_isValidDateObject**  
-Checks if the input is a valid `Date` object.
-
+### ✅ **_getUTCTimestamp**
+Returns the UTC timestamp.
 ```ts
-// 📆 Validate Date Object
-const isValid = _isValidDateObject(new Date());
+const ts3 = getUTCTimestamp({ year: 2025, month: "December", day: 25, hour: 10, minute: 30 });
+console.log(new Date(ts3).toUTCString()); // Thu, 25 Dec 2025 10:30:00 GMT
 ```
 
----
-
-  ✅ **_isValidBlob**  
-Checks if the input is a `Blob`.
-
+### ✅ **_globalizeDateTime**
+Converts a date/time to a specific time zone and format.
 ```ts
-// 🗂️ Validate Blob
-const isValid = _isValidBlob(new Blob(['text']));
+const localized = _globalizeDateTime('2024-07-09T12:00:00', {
+  timeZone: 'Asia/Kolkata',
+  format: 'yyyy-MM-dd HH:mm',
+}); // "2024-07-09 17:30"
 ```
 
----
-
- ✅ **_isLeapYear**
-
+### ✅ **_isLeapYear**
 Determines whether a given year is a leap year based on calendar rules.
-
 ```ts
-const isLeap = _isLeapYear(2024);
-// Output: true
+const isLeap = _isLeapYear(2024); // true
 ```
 
----
-
- ✅ **_isWeekend**
-
+### ✅ **_isWeekend**
 Checks if a given date falls on a weekend (Saturday or Sunday).
-
 ```ts
-const weekend = _isWeekend(new Date('2025-06-08'));
-// Output: true  // (Sunday)
+const weekend = _isWeekend(new Date('2025-06-08')); // true (Sunday)
 ```
 
 ---
 
- ✅ **_removeFalsy**
-
-Removes all falsy values (`false`, `0`, `''`, `null`, `undefined`, `NaN`) from an array.
 
+### ✅ **_calPercentage**
+Calculates the percentage of a value relative to total.
 ```ts
-const cleaned = _removeFalsy([0, 1, false, 2, '', 3]);
-// Output: [1, 2, 3]
+_calPercentage(40, 200); // 20
 ```
 
----
-
- ✅ **_escapeHTML**
-
-Escapes special HTML characters to prevent injection or rendering issues.
-
+### ✅ **_convertToCurrency**
+Converts a number to a formatted currency string.
 ```ts
-const safeHTML = _escapeHTML('<div class="test">Tom & Jerry</div>');
-// Output: '&lt;div class=&quot;test&quot;&gt;Tom &amp; Jerry&lt;/div&gt;'
+const price = _convertToCurrency(2500, 'INR');
 ```
 
----
-
-  ✅ **_isValidFile**  
-Checks if the input is a `File`.
-
+### ✅ **_getPriceAfterTax**
+Adds tax to a given price.
 ```ts
-// 📁 Validate File
-const isValid = _isValidFile(new File([''], 'file.txt'));
+_getPriceAfterTax(100, 18); // 118
 ```
 
----
-
-  ✅ **_isValidRegExp**  
-Checks if the input is a regular expression.
-
+### ✅ **_thousandSeparator**
+Formats a number with thousand separators and fixed decimal precision.
 ```ts
-// 🔍 Validate RegExp
-const isValid = _isValidRegExp(/abc/);
+const formatted = _thousandSeparator(1234567.89);
 ```
 
 ---
 
-  ✅ **_isValidPromise**  
-Checks if the input is a `Promise`.
-
+### ✅ **_alert**
+Shows a customizable alert modal.
 ```ts
-// ⏳ Validate Promise
-const isValid = _isValidPromise(Promise.resolve());
+await _alert({ title: "Test", text: "Data save successfully!" });
 ```
 
----
-
-  ✅ **_isValidDateString**  
-Checks if the string can be parsed as a valid date.
-
+### ✅ **_asyncDebounce**
+Debounces an async function call.
 ```ts
-// 🗓️ Validate Date String
-const isValid = _isValidDateString('2025-04-09');
+const debouncedFn = _asyncDebounce(fetchData, 500);
+debouncedFn();
 ```
 
----
+### ✅ **_confirm**
+Shows a customizable confirm modal.
+```ts
+const confirmed = await _confirm({
+  title: "Are you sure?",
+  text: "Do you really want to delete this item?",
+  icon: "warning",
+  confirmButtonText: "Yes, delete it",
+  cancelButtonText: "No, cancel",
+});
 
-  ✅ **_isValidHTMLElement**  
-Checks if the input is an instance of `HTMLElement`.
+if (confirmed) {
+  // proceed with delete
+} else {
+  // cancelled
+}
+```
 
+### ✅ **_dynamicReducer**
+Creates a simple dynamic reducer using generic action handler logic.
 ```ts
-// 🧱 Validate HTMLElement
-const isValid = _isValidHTMLElement(document.body);
+const reducer = _dynamicReducer(initialState);
 ```
 
----
-
-  ✅ **_isValidEvent**  
-Checks if the input is an instance of `Event`.
-
+### ✅ **_generateUUID**
+Generates a unique UUID string using the browser's `crypto` API.
 ```ts
-// 🎫 Validate Event
-const isValid = _isValidEvent(new Event('click'));
+const id = _generateUUID();
+console.log(id); // e.g., "3b12f1df-5232-4e6b-8f36-3a4e5f7f8b84"
 ```
 
----
-
-  ✅ **_isValidNode**  
-Checks if the input is a `Node`.
-
+### ✅ **_genericReducer**
+A generic reducer accepting predefined handlers for each action type.
 ```ts
-// 🌿 Validate Node
-const isValid = _isValidNode(document.createTextNode('text'));
+const reducer = _genericReducer(initialState, customActions);
 ```
 
----
-
-  ✅ **_isValidNodeList**  
-Checks if the input is a `NodeList`.
-
+### ✅ **_handleApi**
+Wraps an API call with success and error handling, executing the appropriate callback based on the result.
 ```ts
-// 📚 Validate NodeList
-const isValid = _isValidNodeList(document.querySelectorAll('div'));
+_handleApi(
+  getDetails({ name: 'sia' }),
+  (res) => console.log(res), 
+  (err) => console.error(err)
+);
 ```
 
----
-
-  ✅ **_isValidHTMLCollection**  
-Checks if the input is an `HTMLCollection`.
+### ✅ **_handleChildrenMenu**
+Recursively sets assigned state and permissions of child nodes.
+```ts
+_handleChildrenMenu(menuList, parentKey, checked);
+```
 
+### ✅ **_handleParentNode**
+Recursively updates parent permissions based on child permissions.
 ```ts
-// 🏗️ Validate HTMLCollection
-const isValid = _isValidHTMLCollection(document.forms);
+_handleParentNode(menuList, menuId, permissionKey);
 ```
 
----
+### ✅ **_handleParentsMenu**
+Recursively updates parent menu's assigned state and permissions based on children.
+```ts
+_handleParentsMenu(menuList, menuId);
+```
 
-  ✅ **_isValidFormData**  
-Checks if the input is a `FormData` instance.
+### ✅ **_handleSafe**
+Executes a synchronous or asynchronous action safely, handling errors and an optional `finally` block without breaking the application.
+```ts
+await _handleSafe(
+  async () => {
+    await someAsyncTask();
+  },
+  (error) => {
+    console.error('Error occurred:', error);
+  },
+  () => {
+    console.log('Cleanup after execution');
+  }
+);
+```
 
+### ✅ **_isNotEmpty**
+Checks if a given value is not empty — returns false for empty arrays, empty objects, and falsy values like null, undefined, false, or ''.
 ```ts
-// 📝 Validate FormData
-const isValid = _isValidFormData(new FormData());
+const isEmpty = _isNotEmpty([]);
 ```
 
----
+### ✅ **_log**
+Logs a styled message to the console with a specified log level (`log`, `info`, `warn`, `error`).
+```ts
+_log("UserService", "Fetching user details...", "info");
+```
 
-  ✅ **_isValidURLSearchParams**  
-Checks if the input is a `URLSearchParams` instance.
+### ✅ **_sleep**
+Creates a delay for a given time using Promise.
+```ts
+await _sleep(1000); // Wait 1 second
+```
 
+### ✅ **_throwError**
+Throws an error with an optional context object and logs it to the console.
 ```ts
-// 🔍 Validate URLSearchParams
-const isValid = _isValidURLSearchParams(new URLSearchParams());
+_throwError("Something went wrong");
 ```
 
 ###