@arex95/vue-core 1.0.5 → 1.0.7

package/dist/index.mjs

@@ -1,2450 +1,2700 @@
+import { useTimeoutFn, useBreakpoints, breakpointsTailwind, useWindowSize } from '@vueuse/core';
 import axios from 'axios';
+import { useRouter } from 'vue-router';
 import { useQuery } from '@tanstack/vue-query';
 import { ref, watch, onServerPrefetch, onMounted, computed } from 'vue';
-import { useBreakpoints, breakpointsTailwind, useWindowSize, useTimeoutFn } from '@vueuse/core';
 
 /**
- * A standard REST API interface for handling basic CRUD operations.
- * This class can be instantiated with a resource endpoint and a fetch composable for API requests.
+ * Creates and downloads a file from Blob data.
+ * @param {Blob} blob The Blob containing the file data.
+ * @param {string} fileName The name of the file to create.
  */
-class RestStd {
-    static resource;
-    static fetchComposable;
-    /**
-     * Fetch a list of items from the server.
-     *
-     * @param params Query parameters for filtering the results.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
-     */
-    static getMany(params, options = {}) {
-        return this.fetchComposable({
-            method: 'GET',
-            url: this.resource,
-            params,
-        }, options);
-    }
-    /**
-     * Fetch a single item by ID from the server.
-     *
-     * @param id The ID of the item to fetch.
-     * @param params Additional query parameters for the request.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
-     */
-    static getOne(id, params, options = {}) {
-        return this.fetchComposable({
-            method: 'GET',
-            url: `${this.resource}/${id}`,
-            params,
-        }, options);
-    }
-    /**
-     * Create a new item on the server.
-     *
-     * @param data The data for the new item to create.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
-     */
-    static create(data, options = {}) {
-        return this.fetchComposable({
-            method: 'POST',
-            url: this.resource,
-            data,
-        }, options);
-    }
-    /**
-     * Update an existing item on the server.
-     *
-     * @param id The ID of the item to update.
-     * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
-     */
-    static update(id, data, options = {}) {
-        return this.fetchComposable({
-            method: 'PUT',
-            url: `${this.resource}/${id}`,
-            data,
-        }, options);
-    }
-    /**
-     * Partially update an existing item on the server.
-     *
-     * @param id The ID of the item to update.
-     * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
-     */
-    static patch(id, data, options = {}) {
-        return this.fetchComposable({
-            method: 'PATCH',
-            url: `${this.resource}/${id}`,
-            data,
-        }, options);
-    }
-    /**
-     * Delete an item from the server.
-     *
-     * @param id The ID of the item to delete.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
-     */
-    static delete(id, options = {}) {
-        return this.fetchComposable({
-            method: 'DELETE',
-            url: `${this.resource}/${id}`,
-        }, options);
-    }
-    /**
-     * Custom request method for more flexibility.
-     *
-     * @param method HTTP method (GET, POST, etc.).
-     * @param params Query parameters.
-     * @param data Request body data.
-     * @param token Authorization token (optional).
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
-     */
-    static customRequest(method, params, data, options = {}) {
-        return this.fetchComposable({
-            method: method,
-            url: this.resource,
-            params: params,
-            data: data,
-        }, options);
+function downloadFile(blob, fileName) {
+    const link = document.createElement('a');
+    const url = URL.createObjectURL(blob);
+    link.setAttribute('href', url);
+    link.setAttribute('download', fileName);
+    // Append link to the body and trigger a click
+    document.body.appendChild(link);
+    link.click();
+    // Clean up
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+}
+/**
+ * Exports data to a CSV file.
+ * @param {string[]} headers The headers for the CSV.
+ * @param {any[][]} data The data to export, as an array of arrays.
+ * @param {string} fileName The name of the file to create.
+ */
+function exportToCSV(headers, data, fileName) {
+    const csvRows = [];
+    // Add the headers
+    csvRows.push(headers.map(header => `"${header.replace(/"/g, '""')}"`).join(','));
+    // Add the data rows
+    for (const row of data) {
+        csvRows.push(row.map(cell => `"${String(cell).replace(/"/g, '""')}"`).join(','));
     }
+    // Create a Blob with CSV data
+    const csvContent = csvRows.join('\n');
+    const blob = new Blob([csvContent], { type: 'text/csv;charset=utf-8;' });
+    // Use the download utility function
+    downloadFile(blob, fileName);
 }
-
 /**
- * Custom composable function for making API requests with Axios.
- *
- * @template T The expected return type of the API request.
- * @param {AxiosInstance} axios - The Axios instance for making HTTP requests.
- * @param {AxiosRequestConfig} axiosRequest - Configuration for the Axios request.
- * @returns {Promise<T>} A promise with the result of the API request.
+ * Exports data to an Excel file (.xls) using HTML table.
+ * @param {string[]} headers The headers for the Excel file.
+ * @param {any[][]} data The data to export, as an array of arrays.
+ * @param {string} fileName The name of the file to create.
  */
-async function axiosFetch(axios, axiosRequest) {
-    return axios(axiosRequest)
-        .then(response => response.data)
-        .catch(error => {
-        throw error;
+function exportToExcel(headers, data, fileName) {
+    // Create a table element
+    const table = document.createElement('table');
+    const thead = table.createTHead();
+    const tbody = table.createTBody();
+    // Create the header row
+    const headerRow = thead.insertRow();
+    headers.forEach(header => {
+        const th = document.createElement('th');
+        th.textContent = header;
+        headerRow.appendChild(th);
+    });
+    // Create the data rows
+    data.forEach(row => {
+        const tr = tbody.insertRow();
+        row.forEach(cell => {
+            const td = tr.insertCell();
+            td.textContent = String(cell);
+        });
     });
+    // Create a Blob with the table HTML
+    const html = table.outerHTML;
+    const blob = new Blob([html], { type: 'application/vnd.ms-excel;charset=utf-8;' });
+    // Use the download utility function
+    downloadFile(blob, fileName);
 }
-
 /**
- * AxiosService class encapsulates the Axios configuration and logic.
- * It manages request and response interceptors and provides methods for making HTTP requests.
+ * Exports data to a JSON file.
+ * @param {any[]} data The data to export.
+ * @param {string} fileName The name of the file to create.
  */
-class AxiosService {
-    instance;
-    cancelTokenSource;
-    activeRequests = 0; // Track active requests
-    /**
-     * Initializes the AxiosService instance by creating an Axios instance with default configuration
-     * and setting up request and response interceptors.
-     */
-    constructor(url) {
-        this.cancelTokenSource = axios.CancelToken.source();
-        this.instance = axios.create({
-            baseURL: url ?? '',
-            timeout: 300000,
-            headers: {
-                Accept: 'application/json',
-                'Content-Type': 'application/json',
-            },
-            withCredentials: false,
-        });
-        this.initializeInterceptors();
-    }
-    /**
-     * Initializes request and response interceptors for the Axios instance.
-     */
-    initializeInterceptors() {
-        this.instance.interceptors.request.use((config) => {
-            const token = typeof window !== 'undefined' ? localStorage.getItem('authToken') : null;
-            if (token && config.headers) {
-                config.headers.Authorization = `Bearer ${token}`;
-            }
-            config.cancelToken = this.cancelTokenSource.token;
-            this.activeRequests++;
-            return config;
-        }, (error) => {
-            // handleError(error);
-            console.error('Request error:', error.message);
-            this.activeRequests++;
-            return Promise.reject(error);
-        });
-        this.instance.interceptors.response.use((response) => {
-            this.activeRequests--;
-            return response;
-        }, (error) => {
-            if (axios.isCancel(error)) {
-                console.warn('Request canceled:', error.message);
-            }
-            else if (axios.isAxiosError(error)) {
-                // handleError(error);
-                console.error('Response error:', error.response?.status, error.message);
-                if (error.response?.status === 401) {
-                    this.handleUnauthorized();
-                }
-            }
-            else {
-                console.error('Unexpected error:', error);
-            }
-            this.activeRequests--;
-            return Promise.reject(error);
-        });
-    }
-    /**
-     * Returns the number of active requests.
-     */
-    getActiveRequests() {
-        return this.activeRequests;
-    }
-    /**
-     * Handles unauthorized access errors (401).
-     */
-    handleUnauthorized() {
-        console.warn('Unauthorized access - redirecting to login.');
-    }
-    /**
-     * Returns the Axios instance with the configured settings and interceptors.
-     * @returns {AxiosInstance} The configured Axios instance.
-     */
-    getAxiosInstance() {
-        return this.instance;
-    }
-    /**
-     * Cancels all ongoing requests.
-     */
-    cancelAllRequests() {
-        this.cancelTokenSource.cancel('Operation canceled by the user.');
-        this.cancelTokenSource = axios.CancelToken.source();
-    }
-    /**
-     * Sets a new header for the Axios instance.
-     * @param {string} key - The header key.
-     * @param {string} value - The header value.
-     */
-    setHeader(key, value) {
-        this.instance.defaults.headers.common[key] = value;
-    }
-    /**
-     * Removes a header from the Axios instance.
-     * @param {string} key - The header key to remove.
-     */
-    removeHeader(key) {
-        delete this.instance.defaults.headers.common[key];
-    }
-}
-
-/**
- * Creates a fetchComposable for Axios requests with an optional custom instance.
- * @param fetchComposable - The composable to use for the request (can be any fetch function).
- * @param apiUrl - The base URL for the Axios instance.
- * @param axiosInstance - An optional custom Axios instance to use for the request.
- * @returns A function that handles the request using the provided composable.
- */
-function createFetch(fetchComposable, apiUrl, axiosInstance) {
-    const instance = axiosInstance || new AxiosService(apiUrl).getAxiosInstance();
-    return (axiosRequestConfig, options) => {
-        return fetchComposable(instance, axiosRequestConfig, options);
-    };
-}
-
-/**
- * Custom composable for integrating Axios requests with Vue Query.
- *
- * @template T - The type of data expected from the query.
- * @param {AxiosInstance} axios - Axios instance used for making HTTP requests.
- * @param {AxiosRequestConfig} axiosRequest - Initial Axios request configuration.
- * @param {ExtendedQueryOptions<T>} [queryOptions] - Optional Vue Query options with server execution flag.
- * @returns {object} Composable functions and query state for managing API requests.
- */
-function useVueQuery(axios, axiosRequest, queryOptions) {
-    const key = ref([
-        queryOptions?.queryKey || `${axiosRequest.url}-${JSON.stringify(axiosRequest)}`
-    ]);
-    const axiosRequestRef = ref(axiosRequest);
-    const queryOptionsRef = ref(queryOptions);
-    const isInitialized = ref(false);
-    const errorCallbacks = ref([]);
-    const resultCallbacks = ref([]);
-    /**
-     * Vue Query instance for managing API requests.
-     */
-    const query = useQuery({
-        queryKey: key.value,
-        queryFn: async () => {
-            const response = await axios(axiosRequestRef.value);
-            return response.data;
-        },
-        ...(queryOptionsRef.value?.options ?? {})
-    });
-    /**
-     * Executes the query manually with optional new key and request parameters.
-     *
-     * @param {Array<any>} [newKey] - New query key to use.
-     * @param {object} [newRequestParams] - New request parameters to use.
-     * @param {ExtendedQueryOptions<T>} [newQueryOptions] - New Vue Query options to use.
-     */
-    function execute(newKey, newRequestParams, newQueryOptions) {
-        if (newKey) {
-            key.value = newKey;
-        }
-        if (newRequestParams) {
-            axiosRequestRef.value.data = newRequestParams;
-        }
-        if (newQueryOptions) {
-            queryOptionsRef.value = newQueryOptions;
-        }
-        query.refetch();
-    }
-    /**
-     * Registers a callback to be executed on successful request result.
-     * If data is already available, the callback will be executed immediately.
-     *
-     * @param {(data: T) => void} cb - Callback function to handle the result.
-     */
-    function onResult(cb) {
-        resultCallbacks.value.push(cb);
-        if (query.data.value !== undefined && query.data.value !== null) {
-            cb(query.data.value);
-        }
-    }
-    /**
-     * Registers a callback to be executed when the request results in an error.
-     * If an error is already present, the callback will be executed immediately.
-     *
-     * @param {(e: unknown) => void} callback - Callback function to handle errors.
-     */
-    function onError(callback) {
-        errorCallbacks.value.push(callback);
-        if (query.error.value !== undefined) {
-            callback(query.error.value);
-        }
-    }
-    /**
-     * Watches for changes in the query result and triggers result callbacks.
-     */
-    watch(query.data, (newData) => {
-        if (newData !== undefined && newData !== null && isInitialized.value) {
-            resultCallbacks.value.forEach((cb) => cb(newData));
-        }
-    });
-    /**
-     * Watches for changes in query errors and triggers error callbacks.
-     */
-    watch(query.error, (newError) => {
-        if (newError !== undefined && isInitialized.value) {
-            errorCallbacks.value.forEach((cb) => cb(newError));
-        }
-    });
-    /**
-     * Handles server-side prefetching for SSR.
-     * Ensures data is fetched before rendering on the server.
-     */
-    onServerPrefetch(async () => {
-        if (queryOptionsRef.value?.server !== false) {
-            await query.suspense();
-            if (query.data.value != null) {
-                resultCallbacks.value.forEach((cb) => cb(query.data.value));
-            }
-        }
-    });
-    /**
-     * Ensures callbacks are executed after the component is mounted on the client-side.
-     */
-    onMounted(() => {
-        isInitialized.value = true;
-        if (query.data.value != null) {
-            resultCallbacks.value.forEach((cb) => cb(query.data.value));
-        }
-        if (query.error.value !== undefined) {
-            errorCallbacks.value.forEach((cb) => cb(query.error.value));
-        }
-    });
-    return {
-        execute,
-        onResult,
-        onError,
-        ...query
-    };
-}
-
-let notified = false;
-/**
- * Composable to manage breakpoints using Tailwind CSS and shared window resize listener.
- *
- * @returns {Object} An object containing the breakpoints and their states.
- */
-function useBreakpoint() {
-    const breakpoints = useBreakpoints(breakpointsTailwind);
-    const current = breakpoints.current();
-    const active = breakpoints.active();
-    // Define breakpoints
-    const sm_S = breakpoints.smaller('sm');
-    const sm_SE = breakpoints.smallerOrEqual('sm');
-    const sm_GE = breakpoints.greaterOrEqual('sm');
-    const sm_md = breakpoints.between('sm', 'md');
-    const sm_xl = breakpoints.between('sm', 'xl');
-    const sm_2xl = breakpoints.between('sm', '2xl');
-    const md_S = breakpoints.smaller('md');
-    const md_SE = breakpoints.smallerOrEqual('md');
-    const md_GE = breakpoints.greaterOrEqual('md');
-    const md_lg = breakpoints.between('md', 'lg');
-    const md_xl = breakpoints.between('md', 'xl');
-    const md_2xl = breakpoints.between('md', '2xl');
-    const lg_S = breakpoints.smaller('lg');
-    const lg_SE = breakpoints.smallerOrEqual('lg');
-    const lg_GE = breakpoints.greaterOrEqual('lg');
-    const lg_xl = breakpoints.between('lg', 'xl');
-    const lg_2xl = breakpoints.between('lg', '2xl');
-    const xl_S = breakpoints.smaller('xl');
-    const xl_SE = breakpoints.smallerOrEqual('xl');
-    const xl_GE = breakpoints.greaterOrEqual('xl');
-    const xl_2xl = breakpoints.between('xl', '2xl');
-    const _2xl_S = breakpoints.smaller('2xl');
-    const _2xl_SE = breakpoints.smallerOrEqual('2xl');
-    const _2xl_GE = breakpoints.greaterOrEqual('2xl');
-    const reactiveBreakpoint = ref('sm');
-    const isGreaterThanBreakpoint = breakpoints.greaterOrEqual(() => reactiveBreakpoint.value);
-    // Define device ranges
-    const mobile = breakpoints.smaller('md'); // <768px
-    const tablet = breakpoints.between('md', 'lg'); // 768px - 1024px
-    const laptop = breakpoints.between('lg', 'xl'); // 1024px - 1280px
-    const desktop = breakpoints.greaterOrEqual('xl'); // >=1280px
-    // Use VueUse for window size
-    const { width: windowWidth, height: windowHeight } = useWindowSize();
-    /**
-     * Logs a styled "chip" message to the console.
-     *
-     * @param {string} label - The label to display inside the chip.
-     * @param {string} backgroundColor - The background color of the chip.
-     * @param {string} textColor - The text color of the chip.
-     */
-    const logChip = (label, backgroundColor, textColor = 'white') => {
-        console.log(`%c ${label} `, `background-color: ${backgroundColor}; color: ${textColor}; border-radius: 16px; padding: 4px 8px;`);
-    };
-    // Singleton logic: Only notify once
-    const notifyOnce = () => {
-        if (notified)
-            return;
-        watch([mobile, tablet, laptop, desktop], ([isMobile, isTablet, isLaptop, isDesktop]) => {
-            if (isMobile) {
-                logChip('Mobile', '#ff6b6b');
-            }
-            else if (isTablet) {
-                logChip('Tablet', '#4ecdc4');
-            }
-            else if (isLaptop) {
-                logChip('Laptop', '#1a535c');
-            }
-            else if (isDesktop) {
-                logChip('Desktop', '#f7fff7', 'black');
-            }
-            notified = true; // Mark as notified
-        }, { immediate: true });
-    };
-    notifyOnce(); // Ensure the notification happens only once globally
-    return {
-        current,
-        active,
-        sm_S,
-        sm_SE,
-        sm_GE,
-        sm_md,
-        sm_xl,
-        sm_2xl,
-        md_S,
-        md_SE,
-        md_GE,
-        md_lg,
-        md_xl,
-        md_2xl,
-        lg_S,
-        lg_SE,
-        lg_GE,
-        lg_xl,
-        lg_2xl,
-        xl_S,
-        xl_SE,
-        xl_GE,
-        xl_2xl,
-        _2xl_S,
-        _2xl_SE,
-        _2xl_GE,
-        isGreaterThanBreakpoint,
-        reactiveBreakpoint,
-        breakpointsTailwind,
-        windowWidth,
-        windowHeight,
-        mobile,
-        tablet,
-        laptop,
-        desktop,
-        breakpoints,
-    };
+function exportToJSON(data, fileName) {
+    const jsonContent = JSON.stringify(data, null, 2); // Pretty print with 2 spaces
+    const blob = new Blob([jsonContent], { type: 'application/json;charset=utf-8;' });
+    // Use the download utility function
+    downloadFile(blob, fileName);
 }
-
 /**
- * A composable function that filters objects based on a specific field and criteria.
- *
- * @param {Object[]} items - The list of objects to filter.
- * @param {Object} filterConfig - Configuration for the filter, specifying the field, the data type to filter, and the criteria.
- * @param {string} filterConfig.field - The field in the objects to filter.
- * @param {string} filterConfig.type - The data type of the field ('date', 'string', 'number', 'boolean').
- * @param {any} filterConfig.criteria - The criteria for filtering. Can be a date range, a string to search, a number range, or a boolean value.
- *
- * @returns {Object[]} - The filtered list of objects.
- */
-function useFilter(items, filterConfig) {
-    // Ensure the filterConfig is correctly structured
-    const { field, type, criteria } = filterConfig;
-    // Define the filter functions
-    const filterByDate = (objects, field, { startDate, endDate }) => objects.filter(item => {
-        const date = new Date(item[field]);
-        return date >= new Date(startDate) && date <= new Date(endDate);
+ * Exports data to an XML file.
+ * @param {string[]} headers The headers for the XML.
+ * @param {any[][]} data The data to export, as an array of arrays.
+ * @param {string} fileName The name of the file to create.
+ */
+function exportToXML(headers, data, fileName) {
+    let xmlContent = '<?xml version="1.0" encoding="UTF-8"?>\n<rows>\n';
+    // Add headers
+    xmlContent += '  <header>\n';
+    headers.forEach(header => {
+        xmlContent += `    <column>${header}</column>\n`;
     });
-    const filterByString = (objects, field, searchTerm) => {
-        const normalize = (str) => str.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
-        const words = normalize(searchTerm).split(/\s+/).filter(Boolean);
-        return objects.filter(item => {
-            const normalizedFieldValue = normalize(item[field]);
-            return words.every(word => normalizedFieldValue.includes(word));
+    xmlContent += '  </header>\n';
+    // Add data rows
+    data.forEach(row => {
+        xmlContent += '  <row>\n';
+        row.forEach(cell => {
+            xmlContent += `    <cell>${cell}</cell>\n`;
         });
-    };
-    const filterByNumber = (objects, field, { min, max }) => objects.filter(item => {
-        const value = item[field];
-        return value >= min && value <= max;
-    });
-    const filterByBoolean = (objects, field, expectedValue) => objects.filter(item => item[field] === expectedValue);
-    // Apply the appropriate filter and return the filtered objects
-    const filteredObjects = computed(() => {
-        if (!criteria ||
-            (type === 'date' && (!criteria.startDate || !criteria.endDate)) ||
-            (type === 'number' && (criteria.min == null || criteria.max == null)) ||
-            (type === 'boolean' && typeof criteria !== 'boolean')) {
-            return items; // Return all objects if criteria is not valid
-        }
-        // Apply the filter based on the type
-        switch (type) {
-            case 'date':
-                return filterByDate(items, field, criteria);
-            case 'string':
-                return filterByString(items, field, criteria);
-            case 'number':
-                return filterByNumber(items, field, criteria);
-            case 'boolean':
-                return filterByBoolean(items, field, criteria);
-            default:
-                return items;
-        }
+        xmlContent += '  </row>\n';
     });
-    return filteredObjects.value;
+    xmlContent += '</rows>';
+    const blob = new Blob([xmlContent], { type: 'application/xml;charset=utf-8;' });
+    // Use the download utility function
+    downloadFile(blob, fileName);
 }
-
 /**
- * Composable to handle pagination logic.
- *
- * @param page - Reactive ref for the current page number.
- * @param total - Reactive ref for total number of items.
- * @param pageSize - Reactive ref for number of items per page.
- * @returns An object with pagination controls.
+ * Exports data to a plain text file.
+ * @param {string[]} headers The headers for the text file.
+ * @param {any[][]} data The data to export, as an array of arrays.
+ * @param {string} fileName The name of the file to create.
  */
-function usePagination(page, total, pageSize) {
-    // Calculate the total number of pages
-    const totalPages = computed(() => Math.ceil(total.value / pageSize.value));
-    // Determine if the next page can be fetched
-    const canFetchNextPage = () => page.value < totalPages.value;
-    // Determine if the previous page can be fetched
-    const canFetchPreviousPage = () => page.value > 1;
-    return {
-        totalPages,
-        canFetchNextPage,
-        canFetchPreviousPage
-    };
+function exportToText(headers, data, fileName) {
+    const textRows = [];
+    // Add headers
+    textRows.push(headers.join('\t'));
+    // Add data rows
+    data.forEach(row => {
+        textRows.push(row.join('\t'));
+    });
+    // Create a Blob with text data
+    const textContent = textRows.join('\n');
+    const blob = new Blob([textContent], { type: 'text/plain;charset=utf-8;' });
+    // Use the download utility function
+    downloadFile(blob, fileName);
 }
 
 /**
- * Custom composable for sorting products based on a selected criterion.
- * @param {Array} items - The array of products to sort.
- * @param {Array} criteriaList - The list of available sorting criteria.
- * @param {Number} selectedCriteria - The currently selected sorting criterion.
- * @returns {ComputedRef<Array>} - The sorted array of products.
+ * Opens a new window with the specified URL and options.
+ * @param {string} url The URL to open.
+ * @param {Object} [opt] Options for the new window.
+ * @param {string} [opt.target='__blank'] The target window name.
+ * @param {boolean} [opt.noopener=true] Whether to add 'noopener' attribute.
+ * @param {boolean} [opt.noreferrer=true] Whether to add 'noreferrer' attribute.
  */
-function useSorter(items, criteriaList, selectedCriteria) {
-    return computed(() => {
-        const criteria = criteriaList.find(item => item.value === Number(selectedCriteria));
-        if (!criteria)
-            return items;
-        return [...items].sort((a, b) => {
-            const aValue = a[criteria.field];
-            const bValue = b[criteria.field];
-            if (criteria.type === 'number') {
-                const numA = typeof aValue === 'number' ? aValue : parseFloat(aValue) || 0;
-                const numB = typeof bValue === 'number' ? bValue : parseFloat(bValue) || 0;
-                return criteria.order === 'asc' ? numA - numB : numB - numA;
-            }
-            else if (criteria.type === 'date') {
-                const dateA = new Date(aValue).getTime();
-                const dateB = new Date(bValue).getTime();
-                return criteria.order === 'asc' ? dateA - dateB : dateB - dateA;
-            }
-            else if (criteria.type === 'boolean') {
-                const boolA = !!aValue;
-                const boolB = !!bValue;
-                return criteria.order === 'asc' ? (boolA === boolB ? 0 : boolA ? 1 : -1) : (boolA === boolB ? 0 : boolA ? -1 : 1);
-            }
-            else {
-                // Fallback for string sorting
-                const strA = (aValue || '').toString().toLowerCase();
-                const strB = (bValue || '').toString().toLowerCase();
-                return criteria.order === 'asc' ? strA.localeCompare(strB) : strB.localeCompare(strA);
-            }
-        });
-    }).value;
+function openWindow(url, opt) {
+    const { target = '__blank', noopener = true, noreferrer = true } = opt || {};
+    const features = [];
+    // Append noopener and noreferrer attributes if enabled
+    if (noopener)
+        features.push('noopener=yes');
+    if (noreferrer)
+        features.push('noreferrer=yes');
+    // Open the window with the specified features
+    window.open(url, target, features.join(','));
 }
-
 /**
- * Object defining available screen sizes as constants.
- * @readonly
+ * Copies text to the clipboard.
+ * @param {string} text The text to copy.
+ * @returns {Promise<void>} A promise that resolves when the text has been copied.
  */
-const sizeEnum = {
-    XS: 'XS',
-    SM: 'SM',
-    MD: 'MD',
-    LG: 'LG',
-    XL: 'XL',
-    XXL: 'XXL',
-};
+async function copyToClipboard(text) {
+    if (navigator.clipboard) {
+        await navigator.clipboard.writeText(text);
+    }
+    else {
+        // Fallback for browsers that do not support the Clipboard API
+        const textArea = document.createElement('textarea');
+        textArea.value = text;
+        document.body.appendChild(textArea);
+        textArea.select();
+        document.execCommand('copy');
+        document.body.removeChild(textArea);
+    }
+}
 /**
- * Object defining breakpoints for design based on screen width.
- * Values are in pixels.
- * @readonly
+ * Scrolls the window to the top smoothly.
+ * @param {number} [duration=300] Duration of the scroll animation in milliseconds.
  */
-const screenEnum = {
-    XS: 480,
-    SM: 576,
-    MD: 768,
-    LG: 992,
-    XL: 1200,
-    XXL: 1600,
-};
+function scrollToTop(duration = 300) {
+    const start = window.scrollY;
+    const startTime = performance.now();
+    function scroll() {
+        const elapsed = performance.now() - startTime;
+        const progress = Math.min(elapsed / duration, 1);
+        window.scrollTo(0, start * (1 - progress));
+        if (progress < 1) {
+            requestAnimationFrame(scroll);
+        }
+    }
+    requestAnimationFrame(scroll);
+}
 /**
- * Map that associates each screen size defined in `sizeEnum` with its corresponding pixel value from `screenEnum`.
- * @type {Map<typeof sizeEnum[keyof typeof sizeEnum], number>}
+ * Gets the value of a query parameter from the URL.
+ * @param {string} paramName The name of the query parameter.
+ * @returns {string | null} The value of the query parameter, or null if it does not exist.
  */
-const screenMap = new Map();
-screenMap.set(sizeEnum.XS, screenEnum.XS);
-screenMap.set(sizeEnum.SM, screenEnum.SM);
-screenMap.set(sizeEnum.MD, screenEnum.MD);
-screenMap.set(sizeEnum.LG, screenEnum.LG);
-screenMap.set(sizeEnum.XL, screenEnum.XL);
-screenMap.set(sizeEnum.XXL, screenEnum.XXL);
+function getQueryParam(paramName) {
+    const urlParams = new URLSearchParams(window.location.search);
+    return urlParams.get(paramName);
+}
 
 /**
- * Object defining various exception codes.
- * @readonly
+ * Disables the right-click context menu on the window.
  */
-const ExceptionEnum = {
-    /**
-     * HTTP status code for page access forbidden.
-     */
-    PAGE_NOT_ACCESS: 403,
-    /**
-     * HTTP status code for page not found.
-     */
-    PAGE_NOT_FOUND: 404,
-    /**
-     * HTTP status code for general server error.
-     */
-    ERROR: 500,
-    /**
-     * HTTP status code for bad request.
-     */
-    BAD_REQUEST: 406,
-    /**
-     * Custom error code for network errors.
-     */
-    NET_WORK_ERROR: 10000,
-    /**
-     * Custom code indicating no data on the page, not actually an exception page.
-     */
-    PAGE_NOT_DATA: 10100,
-};
-
+function disableRightClick() {
+    const handler = (event) => event.preventDefault();
+    window.addEventListener('contextmenu', handler);
+    // Store handler to allow removal
+    disableRightClick.handler = handler;
+}
+disableRightClick.handler = null;
+/**
+ * Enables the right-click context menu on the window.
+ */
+function enableRightClick() {
+    if (disableRightClick.handler) {
+        window.removeEventListener('contextmenu', disableRightClick.handler);
+    }
+}
 /**
- * Object defining various image MIME types.
- * @readonly
+ * Disables specific mouse buttons.
+ * @param {Array<number>} buttons Array of mouse button codes to disable (0 for left, 1 for middle, 2 for right).
  */
-const ImageTypes = {
-    apng: 'image/apng',
-    bmp: 'image/bmp',
-    gif: 'image/gif',
-    jpeg: 'image/jpeg',
-    pjpeg: 'image/pjpeg',
-    png: 'image/png',
-    svg: 'image/svg+xml',
-    tiff: 'image/tiff',
-    webp: 'image/webp',
-    xicon: 'image/x-icon',
-};
+function disableMouseButtons(buttons) {
+    const handler = (event) => {
+        if (buttons.includes(event.button)) {
+            event.preventDefault();
+        }
+    };
+    window.addEventListener('mousedown', handler);
+    window.addEventListener('contextmenu', handler); // Also handles right-click context menu
+    // Store handler to allow removal later
+    disableMouseButtons.handlers.push(handler);
+}
+disableMouseButtons.handlers = [];
 /**
- * Object defining various file meta types.
- * @readonly
+ * Enables all previously disabled mouse buttons.
  */
-const FileMetaTypes = {
-    images: 'image/*',
-    audios: 'audio/*',
-    videos: 'video/*',
-};
-
+function enableMouseButtons() {
+    for (const handler of disableMouseButtons.handlers) {
+        window.removeEventListener('mousedown', handler);
+        window.removeEventListener('contextmenu', handler);
+    }
+    disableMouseButtons.handlers = [];
+}
 /**
- * Object representing different content types for HTTP headers.
- * @readonly
+ * Adds a double-click event listener to a specific element.
+ * @param {HTMLElement} element The target element.
+ * @param {(event: MouseEvent) => void} callback The callback function to execute on double click.
  */
-const ContentTypeEnum = {
-    /**
-     * Content type for JSON.
-     * @constant
-     */
-    JSON: 'application/json;charset=UTF-8',
-    /**
-     * Content type for URL-encoded form data.
-     * @constant
-     */
-    FORM_URLENCODED: 'application/x-www-form-urlencoded;charset=UTF-8',
-    /**
-     * Content type for multipart form data with file uploads.
-     * @constant
-     */
-    FORM_DATA: 'multipart/form-data;charset=UTF-8',
-};
-
+function addDoubleClickListener(element, callback) {
+    element.addEventListener('dblclick', callback);
+}
 /**
- * Object defining various key codes for keyboard events.
- * @readonly
+ * Removes a double-click event listener from a specific element.
+ * @param {HTMLElement} element The target element.
+ * @param {(event: MouseEvent) => void} callback The callback function to remove.
  */
-const KeyCodeEnum = {
-    UP: 38,
-    DOWN: 40,
-    ENTER: 13,
-    ESC: 27,
-};
-
+function removeDoubleClickListener(element, callback) {
+    element.removeEventListener('dblclick', callback);
+}
+// Example usage:
+// addDoubleClickListener(document.body, () => alert('Double clicked!'));
 /**
- * Key used for storing the authentication token.
- * @constant {string}
+ * Detects a click outside a specific element and triggers a callback.
+ * @param {HTMLElement} element The element to detect clicks outside of.
+ * @param {() => void} callback The callback function to execute when a click outside is detected.
  */
-const TOKEN_KEY = 'TOKEN__';
+function clickOutside(element, callback) {
+    const handler = (event) => {
+        if (!element.contains(event.target)) {
+            callback();
+        }
+    };
+    document.addEventListener('click', handler);
+    // Store handler to allow removal later
+    clickOutside.handlers.push({ element, handler });
+}
+clickOutside.handlers = [];
 /**
- * Key used for storing the locale information.
- * @constant {string}
+ * Removes the click outside listener for a specific element.
+ * @param {HTMLElement} element The element to stop detecting clicks outside of.
  */
-const LOCALE_KEY = 'LOCALE__';
+function removeClickOutside(element) {
+    const index = clickOutside.handlers.findIndex(h => h.element === element);
+    if (index !== -1) {
+        document.removeEventListener('click', clickOutside.handlers[index].handler);
+        clickOutside.handlers.splice(index, 1);
+    }
+}
+// Example usage: Close a menu when clicking outside of it
+// const menu = document.getElementById('menu');
+// if (menu) {
+//     clickOutside(menu, () => menu.style.display = 'none');
+// }
 /**
- * Key used for storing user information.
- * @constant {string}
+ * Disables the F12 key and certain key combinations for developer tools.
  */
-const USER_INFO_KEY = 'USER__INFO__';
+function disableF12Key() {
+    const handler = function (event) {
+        return true;
+    };
+    document.addEventListener('keydown', handler);
+}
 /**
- * Key used for storing role information.
- * @constant {string}
+ * Enables or disables the tab navigation (Tab key) on the page.
+ * @param {boolean} enable Whether to enable or disable tab navigation.
  */
-const ROLES_KEY = 'ROLES__KEY__';
+function toggleTabNavigation(enable) {
+    if (enable) {
+        document.onkeydown = null; // Removes any previously set handler
+    }
+    else {
+        document.onkeydown = (event) => {
+            if (event.key === 'Tab') {
+                event.preventDefault();
+                return false;
+            }
+            return true;
+        };
+    }
+}
 /**
- * Key used for storing project configuration.
- * @constant {string}
+ * Disables the copy (Ctrl + C) functionality on the page.
  */
-const PROJ_CFG_KEY = 'PROJ__CFG__KEY__';
+function disableCopy() {
+    document.addEventListener('copy', (event) => {
+        event.preventDefault();
+        alert('Copying text is disabled on this page.');
+    });
+}
 /**
- * Key used for storing lock information.
- * @constant {string}
+ * Adds a custom keyboard shortcut to execute a given callback function.
+ * @param {string} key The key to trigger the callback.
+ * @param {Function} callback The function to execute on the key press.
+ * @param {boolean} [ctrlKey=false] Whether Ctrl key should be pressed.
+ * @param {boolean} [shiftKey=false] Whether Shift key should be pressed.
  */
-const LOCK_INFO_KEY = 'LOCK__INFO__KEY__';
+function addCustomKeyboardShortcut(key, callback, ctrlKey = false, shiftKey = false) {
+    document.addEventListener('keydown', (event) => {
+        if (event.key === key &&
+            event.ctrlKey === ctrlKey &&
+            event.shiftKey === shiftKey) {
+            event.preventDefault();
+            callback();
+        }
+    });
+}
 /**
- * Key used for base global local cache.
- * @constant {string}
+ * Removes a custom keyboard shortcut by key and modifiers.
+ * @param {string} key The key to trigger the callback.
+ * @param {boolean} [ctrlKey=false] Whether Ctrl key should be pressed.
+ * @param {boolean} [shiftKey=false] Whether Shift key should be pressed.
  */
-const APP_LOCAL_CACHE_KEY = 'COMMON__LOCAL__KEY';
+function removeCustomKeyboardShortcut(key, ctrlKey = false, shiftKey = false) {
+    const handler = (event) => {
+        if (event.key === key &&
+            event.ctrlKey === ctrlKey &&
+            event.shiftKey === shiftKey) {
+            event.preventDefault();
+        }
+    };
+    document.removeEventListener('keydown', handler);
+}
 /**
- * Key used for base global session cache.
- * @constant {string}
+ * Disables specific keys or key combinations.
+ * @param {Array<string>} keys Array of key names to disable (e.g., ['F1', 'F5', 'Control+S']).
  */
-const APP_SESSION_CACHE_KEY = 'COMMON__SESSION__KEY';
+function disableSpecificKeys(keys) {
+    const handler = (event) => {
+        const keyCombination = `${event.ctrlKey ? 'Control+' : ''}${event.shiftKey ? 'Shift+' : ''}${event.altKey ? 'Alt+' : ''}${event.key}`;
+        if (keys.includes(event.key) || keys.includes(keyCombination)) {
+            event.preventDefault();
+        }
+    };
+    document.addEventListener('keydown', handler);
+    // Storing the handler to allow removal later
+    disableSpecificKeys.handlers.push(handler);
+}
+disableSpecificKeys.handlers = [];
 /**
- * Object defining types of cache storage.
- * @readonly
+ * Enables keys that were previously disabled using disableSpecificKeys.
  */
-const CacheTypeEnum = {
-    /** Represents session storage */
-    SESSION: 0,
-    /** Represents local storage */
-    LOCAL: 1,
-};
-
+function enableSpecificKeys() {
+    for (const handler of disableSpecificKeys.handlers) {
+        document.removeEventListener('keydown', handler);
+    }
+    disableSpecificKeys.handlers = [];
+}
+/**
+ * Registers multiple keyboard shortcuts with their respective callback functions.
+ * @param {Array<{ key: string, ctrlKey?: boolean, shiftKey?: boolean, altKey?: boolean, callback: Function }>} shortcuts Array of shortcut objects.
+ */
+function registerKeyboardShortcuts(shortcuts) {
+    const handler = (event) => {
+        for (const shortcut of shortcuts) {
+            if (event.key === shortcut.key &&
+                (shortcut.ctrlKey ? event.ctrlKey : true) &&
+                (shortcut.shiftKey ? event.shiftKey : true) &&
+                (shortcut.altKey ? event.altKey : true)) {
+                event.preventDefault();
+                shortcut.callback();
+            }
+        }
+    };
+    document.addEventListener('keydown', handler);
+    // Storing the handler to allow removal later
+    registerKeyboardShortcuts.handlers.push(handler);
+}
+registerKeyboardShortcuts.handlers = [];
+/**
+ * Unregisters all keyboard shortcuts that were registered with registerKeyboardShortcuts.
+ */
+function unregisterKeyboardShortcuts() {
+    for (const handler of registerKeyboardShortcuts.handlers) {
+        document.removeEventListener('keydown', handler);
+    }
+    registerKeyboardShortcuts.handlers = [];
+}
 /**
- * Creates and downloads a file from Blob data.
- * @param {Blob} blob The Blob containing the file data.
- * @param {string} fileName The name of the file to create.
+ * Adds a listener for a specific key to trigger a custom event.
+ * @param {string} key The key to listen for (e.g., 'Enter', 'Escape').
+ * @param {Function} callback The function to execute when the key is pressed.
  */
-function downloadFile(blob, fileName) {
-    const link = document.createElement('a');
-    const url = URL.createObjectURL(blob);
-    link.setAttribute('href', url);
-    link.setAttribute('download', fileName);
-    // Append link to the body and trigger a click
-    document.body.appendChild(link);
-    link.click();
-    // Clean up
-    document.body.removeChild(link);
-    URL.revokeObjectURL(url);
+function addKeyListener(key, callback) {
+    const handler = (event) => {
+        if (event.key === key) {
+            event.preventDefault();
+            callback();
+        }
+    };
+    document.addEventListener('keydown', handler);
+    // Storing the handler to allow removal later
+    addKeyListener.handlers.push(handler);
 }
+addKeyListener.handlers = [];
 /**
- * Exports data to a CSV file.
- * @param {string[]} headers The headers for the CSV.
- * @param {any[][]} data The data to export, as an array of arrays.
- * @param {string} fileName The name of the file to create.
+ * Removes all custom key listeners added by addKeyListener.
  */
-function exportToCSV(headers, data, fileName) {
-    const csvRows = [];
-    // Add the headers
-    csvRows.push(headers.map(header => `"${header.replace(/"/g, '""')}"`).join(','));
-    // Add the data rows
-    for (const row of data) {
-        csvRows.push(row.map(cell => `"${String(cell).replace(/"/g, '""')}"`).join(','));
+function removeKeyListeners() {
+    for (const handler of addKeyListener.handlers) {
+        document.removeEventListener('keydown', handler);
     }
-    // Create a Blob with CSV data
-    const csvContent = csvRows.join('\n');
-    const blob = new Blob([csvContent], { type: 'text/csv;charset=utf-8;' });
-    // Use the download utility function
-    downloadFile(blob, fileName);
+    addKeyListener.handlers = [];
 }
 /**
- * Exports data to an Excel file (.xls) using HTML table.
- * @param {string[]} headers The headers for the Excel file.
- * @param {any[][]} data The data to export, as an array of arrays.
- * @param {string} fileName The name of the file to create.
+ * Detects if a specific key is held down.
+ * @param {string} key The key to detect (e.g., 'Shift', 'Control', 'Alt', 'a').
+ * @param {Function} onHold Callback function to execute while the key is held down.
  */
-function exportToExcel(headers, data, fileName) {
-    // Create a table element
-    const table = document.createElement('table');
-    const thead = table.createTHead();
-    const tbody = table.createTBody();
-    // Create the header row
-    const headerRow = thead.insertRow();
-    headers.forEach(header => {
-        const th = document.createElement('th');
-        th.textContent = header;
-        headerRow.appendChild(th);
-    });
-    // Create the data rows
-    data.forEach(row => {
-        const tr = tbody.insertRow();
-        row.forEach(cell => {
-            const td = tr.insertCell();
-            td.textContent = String(cell);
-        });
-    });
-    // Create a Blob with the table HTML
-    const html = table.outerHTML;
-    const blob = new Blob([html], { type: 'application/vnd.ms-excel;charset=utf-8;' });
-    // Use the download utility function
-    downloadFile(blob, fileName);
+function detectKeyHold(key, onHold) {
+    const keyDownHandler = (event) => {
+        if (event.key === key) {
+            onHold();
+        }
+    };
+    document.addEventListener('keydown', keyDownHandler);
+    // Storing the handler to allow removal later
+    detectKeyHold.handlers.push(keyDownHandler);
 }
+detectKeyHold.handlers = [];
 /**
- * Exports data to a JSON file.
- * @param {any[]} data The data to export.
- * @param {string} fileName The name of the file to create.
+ * Stops detecting if a specific key is held down.
  */
-function exportToJSON(data, fileName) {
-    const jsonContent = JSON.stringify(data, null, 2); // Pretty print with 2 spaces
-    const blob = new Blob([jsonContent], { type: 'application/json;charset=utf-8;' });
-    // Use the download utility function
-    downloadFile(blob, fileName);
+function stopDetectingKeyHold() {
+    for (const handler of detectKeyHold.handlers) {
+        document.removeEventListener('keydown', handler);
+    }
+    detectKeyHold.handlers = [];
 }
 /**
- * Exports data to an XML file.
- * @param {string[]} headers The headers for the XML.
- * @param {any[][]} data The data to export, as an array of arrays.
- * @param {string} fileName The name of the file to create.
+ * Tracks currently pressed keys and provides a map of active keys.
+ * @returns {Set<string>} A set of currently pressed keys.
  */
-function exportToXML(headers, data, fileName) {
-    let xmlContent = '<?xml version="1.0" encoding="UTF-8"?>\n<rows>\n';
-    // Add headers
-    xmlContent += '  <header>\n';
-    headers.forEach(header => {
-        xmlContent += `    <column>${header}</column>\n`;
-    });
-    xmlContent += '  </header>\n';
-    // Add data rows
-    data.forEach(row => {
-        xmlContent += '  <row>\n';
-        row.forEach(cell => {
-            xmlContent += `    <cell>${cell}</cell>\n`;
-        });
-        xmlContent += '  </row>\n';
-    });
-    xmlContent += '</rows>';
-    const blob = new Blob([xmlContent], { type: 'application/xml;charset=utf-8;' });
-    // Use the download utility function
-    downloadFile(blob, fileName);
+function createKeyMap() {
+    const pressedKeys = new Set();
+    const keyDownHandler = (event) => {
+        pressedKeys.add(event.key);
+    };
+    const keyUpHandler = (event) => {
+        pressedKeys.delete(event.key);
+    };
+    document.addEventListener('keydown', keyDownHandler);
+    document.addEventListener('keyup', keyUpHandler);
+    // Function to remove listeners
+    createKeyMap.clearListeners = () => {
+        document.removeEventListener('keydown', keyDownHandler);
+        document.removeEventListener('keyup', keyUpHandler);
+    };
+    return pressedKeys;
 }
 /**
- * Exports data to a plain text file.
- * @param {string[]} headers The headers for the text file.
- * @param {any[][]} data The data to export, as an array of arrays.
- * @param {string} fileName The name of the file to create.
+ * Clears listeners for the key map tracking.
  */
-function exportToText(headers, data, fileName) {
-    const textRows = [];
-    // Add headers
-    textRows.push(headers.join('\t'));
-    // Add data rows
-    data.forEach(row => {
-        textRows.push(row.join('\t'));
-    });
-    // Create a Blob with text data
-    const textContent = textRows.join('\n');
-    const blob = new Blob([textContent], { type: 'text/plain;charset=utf-8;' });
-    // Use the download utility function
-    downloadFile(blob, fileName);
-}
-
+createKeyMap.clearListeners = () => { };
 /**
- * Opens a new window with the specified URL and options.
- * @param {string} url The URL to open.
- * @param {Object} [opt] Options for the new window.
- * @param {string} [opt.target='__blank'] The target window name.
- * @param {boolean} [opt.noopener=true] Whether to add 'noopener' attribute.
- * @param {boolean} [opt.noreferrer=true] Whether to add 'noreferrer' attribute.
+ * Sets up custom keyboard shortcuts with flexible order.
+ * @param {Array<string>} keys The combination of keys for the shortcut.
+ * @param {Function} callback The callback function to execute when the combination is detected.
  */
-function openWindow(url, opt) {
-    const { target = '__blank', noopener = true, noreferrer = true } = opt || {};
-    const features = [];
-    // Append noopener and noreferrer attributes if enabled
-    if (noopener)
-        features.push('noopener=yes');
-    if (noreferrer)
-        features.push('noreferrer=yes');
-    // Open the window with the specified features
-    window.open(url, target, features.join(','));
+function customShortcut(keys, callback) {
+    const pressedKeys = new Set();
+    const keyDownHandler = (event) => {
+        pressedKeys.add(event.key);
+        if (keys.every(key => pressedKeys.has(key))) {
+            callback();
+        }
+    };
+    const keyUpHandler = (event) => {
+        pressedKeys.delete(event.key);
+    };
+    document.addEventListener('keydown', keyDownHandler);
+    document.addEventListener('keyup', keyUpHandler);
+    // Store the handlers for later removal
+    customShortcut.handlers.push({ keyDownHandler, keyUpHandler });
 }
+customShortcut.handlers = [];
 /**
- * Copies text to the clipboard.
- * @param {string} text The text to copy.
- * @returns {Promise<void>} A promise that resolves when the text has been copied.
+ * Removes all custom keyboard shortcuts added by customShortcut.
  */
-async function copyToClipboard(text) {
-    if (navigator.clipboard) {
-        await navigator.clipboard.writeText(text);
-    }
-    else {
-        // Fallback for browsers that do not support the Clipboard API
-        const textArea = document.createElement('textarea');
-        textArea.value = text;
-        document.body.appendChild(textArea);
-        textArea.select();
-        document.execCommand('copy');
-        document.body.removeChild(textArea);
+function removeCustomShortcuts() {
+    for (const { keyDownHandler, keyUpHandler } of customShortcut.handlers) {
+        document.removeEventListener('keydown', keyDownHandler);
+        document.removeEventListener('keyup', keyUpHandler);
     }
+    customShortcut.handlers = [];
 }
 /**
- * Scrolls the window to the top smoothly.
- * @param {number} [duration=300] Duration of the scroll animation in milliseconds.
+ * Simulates a key press event.
+ * @param {string} key The key to simulate (e.g., 'Enter', 'a').
+ * @param {boolean} ctrlKey If true, include Ctrl key in the event.
+ * @param {boolean} shiftKey If true, include Shift key in the event.
+ * @param {boolean} altKey If true, include Alt key in the event.
  */
-function scrollToTop(duration = 300) {
-    const start = window.scrollY;
-    const startTime = performance.now();
-    function scroll() {
-        const elapsed = performance.now() - startTime;
-        const progress = Math.min(elapsed / duration, 1);
-        window.scrollTo(0, start * (1 - progress));
-        if (progress < 1) {
-            requestAnimationFrame(scroll);
+function simulateKeyPress(key, ctrlKey = false, shiftKey = false, altKey = false) {
+    const event = new KeyboardEvent('keydown', {
+        key,
+        ctrlKey,
+        shiftKey,
+        altKey,
+        bubbles: true,
+        cancelable: true
+    });
+    document.dispatchEvent(event);
+}
+
+/**
+ * Parses a date string into a Date object.
+ * @param {string} dateString The date string in 'YYYY-MM-DD' format.
+ * @returns {Date | null} The parsed Date object or null if the format is invalid.
+ */
+function parseDate(dateString) {
+    const parts = dateString.split('-');
+    if (parts.length === 3) {
+        const year = parseInt(parts[0], 10);
+        const month = parseInt(parts[1], 10) - 1; // Months are zero-based
+        const day = parseInt(parts[2], 10);
+        const date = new Date(year, month, day);
+        if (date.getFullYear() === year && date.getMonth() === month && date.getDate() === day) {
+            return date;
         }
     }
-    requestAnimationFrame(scroll);
+    return null;
 }
 /**
- * Gets the value of a query parameter from the URL.
- * @param {string} paramName The name of the query parameter.
- * @returns {string | null} The value of the query parameter, or null if it does not exist.
+ * Formats a Date object into a string.
+ * @param {Date} date The date to format.
+ * @param {string} format The format string (e.g., 'YYYY-MM-DD').
+ * @returns {string} The formatted date string.
  */
-function getQueryParam(paramName) {
-    const urlParams = new URLSearchParams(window.location.search);
-    return urlParams.get(paramName);
+function formatDate(date, format) {
+    const map = {
+        'YYYY': date.getFullYear(),
+        'MM': String(date.getMonth() + 1).padStart(2, '0'),
+        'DD': String(date.getDate()).padStart(2, '0'),
+        'HH': String(date.getHours()).padStart(2, '0'),
+        'mm': String(date.getMinutes()).padStart(2, '0'),
+        'ss': String(date.getSeconds()).padStart(2, '0')
+    };
+    return format.replace(/YYYY|MM|DD|HH|mm|ss/g, (matched) => (map[matched] || matched).toString());
 }
-
 /**
- * Disables the right-click context menu on the window.
+ * Calculates the number of days between two dates.
+ * @param {Date} startDate The start date.
+ * @param {Date} endDate The end date.
+ * @returns {number} The number of days between the two dates.
  */
-function disableRightClick() {
-    const handler = (event) => event.preventDefault();
-    window.addEventListener('contextmenu', handler);
-    // Store handler to allow removal
-    disableRightClick.handler = handler;
+function daysBetween(startDate, endDate) {
+    const millisecondsPerDay = 86400000; // Number of milliseconds in one day
+    return Math.round((endDate.getTime() - startDate.getTime()) / millisecondsPerDay);
 }
-disableRightClick.handler = null;
 /**
- * Enables the right-click context menu on the window.
+ * Adds a specified number of days to a date.
+ * @param {Date} date The date to modify.
+ * @param {number} days The number of days to add.
+ * @returns {Date} The new date with days added.
  */
-function enableRightClick() {
-    if (disableRightClick.handler) {
-        window.removeEventListener('contextmenu', disableRightClick.handler);
-    }
+function addDays(date, days) {
+    const result = new Date(date);
+    result.setDate(result.getDate() + days);
+    return result;
 }
 /**
- * Disables specific mouse buttons.
- * @param {Array<number>} buttons Array of mouse button codes to disable (0 for left, 1 for middle, 2 for right).
+ * Subtracts a specified number of days from a date.
+ * @param {Date} date The date to modify.
+ * @param {number} days The number of days to subtract.
+ * @returns {Date} The new date with days subtracted.
  */
-function disableMouseButtons(buttons) {
-    const handler = (event) => {
-        if (buttons.includes(event.button)) {
-            event.preventDefault();
-        }
-    };
-    window.addEventListener('mousedown', handler);
-    window.addEventListener('contextmenu', handler); // Also handles right-click context menu
-    // Store handler to allow removal later
-    disableMouseButtons.handlers.push(handler);
+function subtractDays(date, days) {
+    return addDays(date, -days);
 }
-disableMouseButtons.handlers = [];
 /**
- * Enables all previously disabled mouse buttons.
+ * Determines if a year is a leap year.
+ * @param {number} year The year to check.
+ * @returns {boolean} True if the year is a leap year, false otherwise.
  */
-function enableMouseButtons() {
-    for (const handler of disableMouseButtons.handlers) {
-        window.removeEventListener('mousedown', handler);
-        window.removeEventListener('contextmenu', handler);
-    }
-    disableMouseButtons.handlers = [];
+function isLeapYear(year) {
+    return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
 }
 /**
- * Adds a double-click event listener to a specific element.
- * @param {HTMLElement} element The target element.
- * @param {(event: MouseEvent) => void} callback The callback function to execute on double click.
+ * Gets the first day of the month for a given date.
+ * @param {Date} date The date to use.
+ * @returns {Date} The first day of the month.
  */
-function addDoubleClickListener(element, callback) {
-    element.addEventListener('dblclick', callback);
+function getStartOfMonth(date) {
+    return new Date(date.getFullYear(), date.getMonth(), 1);
 }
 /**
- * Removes a double-click event listener from a specific element.
- * @param {HTMLElement} element The target element.
- * @param {(event: MouseEvent) => void} callback The callback function to remove.
+ * Gets the last day of the month for a given date.
+ * @param {Date} date The date to use.
+ * @returns {Date} The last day of the month.
  */
-function removeDoubleClickListener(element, callback) {
-    element.removeEventListener('dblclick', callback);
+function getEndOfMonth(date) {
+    return new Date(date.getFullYear(), date.getMonth() + 1, 0);
 }
-// Example usage:
-// addDoubleClickListener(document.body, () => alert('Double clicked!'));
 /**
- * Detects a click outside a specific element and triggers a callback.
- * @param {HTMLElement} element The element to detect clicks outside of.
- * @param {() => void} callback The callback function to execute when a click outside is detected.
+ * Calculates age from a given birth date.
+ * @param {Date} birthDate The birth date.
+ * @returns {number} The calculated age.
  */
-function clickOutside(element, callback) {
-    const handler = (event) => {
-        if (!element.contains(event.target)) {
-            callback();
-        }
-    };
-    document.addEventListener('click', handler);
-    // Store handler to allow removal later
-    clickOutside.handlers.push({ element, handler });
+function calculateAge(birthDate) {
+    const today = new Date();
+    let age = today.getFullYear() - birthDate.getFullYear();
+    const m = today.getMonth() - birthDate.getMonth();
+    if (m < 0 || (m === 0 && today.getDate() < birthDate.getDate())) {
+        age--;
+    }
+    return age;
 }
-clickOutside.handlers = [];
 /**
- * Removes the click outside listener for a specific element.
- * @param {HTMLElement} element The element to stop detecting clicks outside of.
+ * Calculates the number of days until the next birthday.
+ * @param {Date} birthDate The birth date.
+ * @returns {number} The number of days until the next birthday.
  */
-function removeClickOutside(element) {
-    const index = clickOutside.handlers.findIndex(h => h.element === element);
-    if (index !== -1) {
-        document.removeEventListener('click', clickOutside.handlers[index].handler);
-        clickOutside.handlers.splice(index, 1);
+function daysToNextBirthday(birthDate) {
+    const today = new Date();
+    const currentYear = today.getFullYear();
+    const nextBirthday = new Date(birthDate);
+    nextBirthday.setFullYear(currentYear);
+    if (nextBirthday < today) {
+        nextBirthday.setFullYear(currentYear + 1);
     }
+    return daysBetween(today, nextBirthday);
 }
-// Example usage: Close a menu when clicking outside of it
-// const menu = document.getElementById('menu');
-// if (menu) {
-//     clickOutside(menu, () => menu.style.display = 'none');
-// }
 /**
- * Disables the F12 key and certain key combinations for developer tools.
+ * Calculates the age at a specific date.
+ * @param {Date} birthDate The birth date.
+ * @param {Date} atDate The date to calculate the age at.
+ * @returns {number} The calculated age.
  */
-function disableF12Key() {
-    const handler = function (event) {
-        return true;
-    };
-    document.addEventListener('keydown', handler);
+function ageAtDate(birthDate, atDate) {
+    let age = atDate.getFullYear() - birthDate.getFullYear();
+    const m = atDate.getMonth() - birthDate.getMonth();
+    if (m < 0 || (m === 0 && atDate.getDate() < birthDate.getDate())) {
+        age--;
+    }
+    return age;
 }
+
 /**
- * Enables or disables the tab navigation (Tab key) on the page.
- * @param {boolean} enable Whether to enable or disable tab navigation.
+ * Creates a debounced asynchronous validator function.
+ *
+ * @param validator - The async validator function to debounce.
+ * @param delay - The debounce delay in milliseconds.
+ * @returns A debounced version of the validator function.
  */
-function toggleTabNavigation(enable) {
-    if (enable) {
-        document.onkeydown = null; // Removes any previously set handler
-    }
-    else {
-        document.onkeydown = (event) => {
-            if (event.key === 'Tab') {
-                event.preventDefault();
-                return false;
+function debounceAsyncValidator(validator, delay) {
+    let currentPromiseReject = null;
+    /**
+     * Creates a debounce delay.
+     *
+     * @returns A promise that resolves after the debounce delay.
+     */
+    function debounce() {
+        return new Promise((resolve, reject) => {
+            const { start, stop } = useTimeoutFn(() => {
+                currentPromiseReject = null;
+                resolve();
+            }, delay);
+            if (currentPromiseReject) {
+                currentPromiseReject(new Error('replaced'));
             }
-            return true;
-        };
+            currentPromiseReject = reject;
+            start();
+        });
     }
+    return function (value) {
+        if (currentPromiseReject) {
+            currentPromiseReject(new Error('replaced'));
+            currentPromiseReject = null;
+        }
+        return validator.call(this, value, debounce);
+    };
 }
 /**
- * Disables the copy (Ctrl + C) functionality on the page.
+ * Creates a debounced version of an asynchronous function.
+ * @param {Function} func The asynchronous function to debounce.
+ * @param {number} wait The number of milliseconds to wait before invoking the function.
+ * @returns {Function} The debounced function.
  */
-function disableCopy() {
-    document.addEventListener('copy', (event) => {
-        event.preventDefault();
-        alert('Copying text is disabled on this page.');
-    });
+function debounceAsync(func, wait) {
+    let timeoutReject = null;
+    return function (...args) {
+        if (timeoutReject) {
+            timeoutReject(new Error('replaced'));
+            timeoutReject = null;
+        }
+        return new Promise((resolve, reject) => {
+            const { start } = useTimeoutFn(() => {
+                func.apply(this, args).then(resolve).catch(reject);
+            }, wait);
+            timeoutReject = reject;
+            start();
+        });
+    };
 }
 /**
- * Adds a custom keyboard shortcut to execute a given callback function.
- * @param {string} key The key to trigger the callback.
- * @param {Function} callback The function to execute on the key press.
- * @param {boolean} [ctrlKey=false] Whether Ctrl key should be pressed.
- * @param {boolean} [shiftKey=false] Whether Shift key should be pressed.
+ * Creates a debounced asynchronous function that executes immediately on the first call.
+ * @param {Function} func The asynchronous function to debounce.
+ * @param {number} wait The number of milliseconds to wait before invoking the function.
+ * @returns {Function} The debounced function with immediate execution on the first call.
  */
-function addCustomKeyboardShortcut(key, callback, ctrlKey = false, shiftKey = false) {
-    document.addEventListener('keydown', (event) => {
-        if (event.key === key &&
-            event.ctrlKey === ctrlKey &&
-            event.shiftKey === shiftKey) {
-            event.preventDefault();
-            callback();
+function debounceAsyncWithImmediate(func, wait) {
+    let timeoutReject = null;
+    let callNow = true;
+    return function (...args) {
+        const context = this;
+        if (callNow) {
+            callNow = false;
+            return func.apply(context, args).finally(() => {
+                const { start } = useTimeoutFn(() => {
+                    callNow = true;
+                }, wait);
+                start();
+            });
         }
-    });
+        else {
+            if (timeoutReject) {
+                timeoutReject(new Error('replaced'));
+                timeoutReject = null;
+            }
+            return new Promise((resolve, reject) => {
+                const { start } = useTimeoutFn(() => {
+                    func.apply(context, args).then(resolve).catch(reject);
+                }, wait);
+                timeoutReject = reject;
+                start();
+            });
+        }
+    };
 }
 /**
- * Removes a custom keyboard shortcut by key and modifiers.
- * @param {string} key The key to trigger the callback.
- * @param {boolean} [ctrlKey=false] Whether Ctrl key should be pressed.
- * @param {boolean} [shiftKey=false] Whether Shift key should be pressed.
+ * Creates a debounced version of a function that executes on the leading edge.
+ * @param {Function} func The function to debounce.
+ * @param {number} wait The number of milliseconds to wait before invoking the function.
+ * @returns {Function} The debounced function.
  */
-function removeCustomKeyboardShortcut(key, ctrlKey = false, shiftKey = false) {
-    const handler = (event) => {
-        if (event.key === key &&
-            event.ctrlKey === ctrlKey &&
-            event.shiftKey === shiftKey) {
-            event.preventDefault();
+function debounceLeading(func, wait) {
+    let timeoutReject = null;
+    return function (...args) {
+        const context = this;
+        if (!timeoutReject) {
+            func.apply(context, args);
         }
+        if (timeoutReject) {
+            timeoutReject(new Error('replaced'));
+            timeoutReject = null;
+        }
+        const { start } = useTimeoutFn(() => {
+            timeoutReject = null;
+        }, wait);
+        timeoutReject = () => { };
+        start();
     };
-    document.removeEventListener('keydown', handler);
 }
 /**
- * Disables specific keys or key combinations.
- * @param {Array<string>} keys Array of key names to disable (e.g., ['F1', 'F5', 'Control+S']).
+ * Creates a debounced version of a function that executes on the trailing edge.
+ * @param {Function} func The function to debounce.
+ * @param {number} wait The number of milliseconds to wait before invoking the function.
+ * @returns {Function} The debounced function.
  */
-function disableSpecificKeys(keys) {
-    const handler = (event) => {
-        const keyCombination = `${event.ctrlKey ? 'Control+' : ''}${event.shiftKey ? 'Shift+' : ''}${event.altKey ? 'Alt+' : ''}${event.key}`;
-        if (keys.includes(event.key) || keys.includes(keyCombination)) {
-            event.preventDefault();
+function debounceTrailing(func, wait) {
+    let timeoutReject = null;
+    return function (...args) {
+        const context = this;
+        if (timeoutReject) {
+            timeoutReject(new Error('replaced'));
+            timeoutReject = null;
         }
+        const { start } = useTimeoutFn(() => {
+            func.apply(context, args);
+        }, wait);
+        timeoutReject = () => { };
+        start();
     };
-    document.addEventListener('keydown', handler);
-    // Storing the handler to allow removal later
-    disableSpecificKeys.handlers.push(handler);
 }
-disableSpecificKeys.handlers = [];
 /**
- * Enables keys that were previously disabled using disableSpecificKeys.
+ * Creates a debounced version of a function that executes on both leading and trailing edges.
+ * @param {Function} func The function to debounce.
+ * @param {number} wait The number of milliseconds to wait before invoking the function.
+ * @returns {Function} The debounced function.
  */
-function enableSpecificKeys() {
-    for (const handler of disableSpecificKeys.handlers) {
-        document.removeEventListener('keydown', handler);
-    }
-    disableSpecificKeys.handlers = [];
+function debounceLeadingTrailing(func, wait) {
+    let timeoutReject = null;
+    let lastCall = 0;
+    return function (...args) {
+        const context = this;
+        const now = Date.now();
+        if (timeoutReject) {
+            timeoutReject(new Error('replaced'));
+            timeoutReject = null;
+        }
+        if (now - lastCall >= wait) {
+            func.apply(context, args);
+            lastCall = now;
+        }
+        else {
+            const { start } = useTimeoutFn(() => {
+                func.apply(context, args);
+            }, wait - (now - lastCall));
+            timeoutReject = () => { };
+            start();
+        }
+    };
 }
 /**
- * Registers multiple keyboard shortcuts with their respective callback functions.
- * @param {Array<{ key: string, ctrlKey?: boolean, shiftKey?: boolean, altKey?: boolean, callback: Function }>} shortcuts Array of shortcut objects.
+ * Creates a debounced version of a function.
+ * @param {Function} func The function to debounce.
+ * @param {number} wait The number of milliseconds to wait before invoking the function.
+ * @returns {Function} The debounced function.
  */
-function registerKeyboardShortcuts(shortcuts) {
-    const handler = (event) => {
-        for (const shortcut of shortcuts) {
-            if (event.key === shortcut.key &&
-                (shortcut.ctrlKey ? event.ctrlKey : true) &&
-                (shortcut.shiftKey ? event.shiftKey : true) &&
-                (shortcut.altKey ? event.altKey : true)) {
-                event.preventDefault();
-                shortcut.callback();
-            }
+function debounce(func, wait) {
+    let timeoutReject = null;
+    return function (...args) {
+        if (timeoutReject) {
+            timeoutReject(new Error('replaced'));
+            timeoutReject = null;
         }
+        const { start } = useTimeoutFn(() => {
+            func.apply(this, args);
+        }, wait);
+        timeoutReject = () => { };
+        start();
     };
-    document.addEventListener('keydown', handler);
-    // Storing the handler to allow removal later
-    registerKeyboardShortcuts.handlers.push(handler);
 }
-registerKeyboardShortcuts.handlers = [];
 /**
- * Unregisters all keyboard shortcuts that were registered with registerKeyboardShortcuts.
+ * Creates a throttled version of a function.
+ * @param {Function} func The function to throttle.
+ * @param {number} limit The number of milliseconds to wait between function calls.
+ * @returns {Function} The throttled function.
  */
-function unregisterKeyboardShortcuts() {
-    for (const handler of registerKeyboardShortcuts.handlers) {
-        document.removeEventListener('keydown', handler);
-    }
-    registerKeyboardShortcuts.handlers = [];
+function throttle(func, limit) {
+    let lastCall = 0;
+    return function (...args) {
+        const now = Date.now();
+        if (now - lastCall >= limit) {
+            lastCall = now;
+            func.apply(this, args);
+        }
+    };
 }
+
 /**
- * Adds a listener for a specific key to trigger a custom event.
- * @param {string} key The key to listen for (e.g., 'Enter', 'Escape').
- * @param {Function} callback The function to execute when the key is pressed.
+ * Converts a FormData object to a plain JavaScript object.
+ * @param {FormData} formData The FormData object to convert.
+ * @returns {Record<string, any>} The plain JavaScript object.
  */
-function addKeyListener(key, callback) {
-    const handler = (event) => {
-        if (event.key === key) {
-            event.preventDefault();
-            callback();
+function formDataToObject(formData) {
+    const obj = {};
+    formData.forEach((value, key) => {
+        // Handle multiple values for the same key
+        if (obj[key]) {
+            if (!Array.isArray(obj[key])) {
+                obj[key] = [obj[key]];
+            }
+            obj[key].push(value);
         }
-    };
-    document.addEventListener('keydown', handler);
-    // Storing the handler to allow removal later
-    addKeyListener.handlers.push(handler);
+        else {
+            obj[key] = value;
+        }
+    });
+    return obj;
 }
-addKeyListener.handlers = [];
 /**
- * Removes all custom key listeners added by addKeyListener.
+ * Reads a file as text.
+ * @param {File} file The file to read.
+ * @returns {Promise<string>} A promise that resolves with the file content.
  */
-function removeKeyListeners() {
-    for (const handler of addKeyListener.handlers) {
-        document.removeEventListener('keydown', handler);
-    }
-    addKeyListener.handlers = [];
+function readFileAsText(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result);
+        reader.onerror = reject;
+        reader.readAsText(file);
+    });
 }
 /**
- * Detects if a specific key is held down.
- * @param {string} key The key to detect (e.g., 'Shift', 'Control', 'Alt', 'a').
- * @param {Function} onHold Callback function to execute while the key is held down.
+ * Reads a file as a Data URL.
+ * @param {File} file The file to read.
+ * @returns {Promise<string>} A promise that resolves with the Data URL.
  */
-function detectKeyHold(key, onHold) {
-    const keyDownHandler = (event) => {
-        if (event.key === key) {
-            onHold();
-        }
-    };
-    document.addEventListener('keydown', keyDownHandler);
-    // Storing the handler to allow removal later
-    detectKeyHold.handlers.push(keyDownHandler);
+function readFileAsDataURL(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result);
+        reader.onerror = reject;
+        reader.readAsDataURL(file);
+    });
 }
-detectKeyHold.handlers = [];
 /**
- * Stops detecting if a specific key is held down.
+ * Creates a Blob from a string.
+ * @param {string} content The string content for the Blob.
+ * @param {string} [type='text/plain'] The MIME type of the Blob.
+ * @returns {Blob} The Blob object.
  */
-function stopDetectingKeyHold() {
-    for (const handler of detectKeyHold.handlers) {
-        document.removeEventListener('keydown', handler);
-    }
-    detectKeyHold.handlers = [];
+function stringToBlob(content, type = 'text/plain') {
+    return new Blob([content], { type });
 }
 /**
- * Tracks currently pressed keys and provides a map of active keys.
- * @returns {Set<string>} A set of currently pressed keys.
+ * Creates a Blob from an ArrayBuffer.
+ * @param {ArrayBuffer} buffer The ArrayBuffer to convert.
+ * @param {string} [type='application/octet-stream'] The MIME type of the Blob.
+ * @returns {Blob} The Blob object.
  */
-function createKeyMap() {
-    const pressedKeys = new Set();
-    const keyDownHandler = (event) => {
-        pressedKeys.add(event.key);
-    };
-    const keyUpHandler = (event) => {
-        pressedKeys.delete(event.key);
-    };
-    document.addEventListener('keydown', keyDownHandler);
-    document.addEventListener('keyup', keyUpHandler);
-    // Function to remove listeners
-    createKeyMap.clearListeners = () => {
-        document.removeEventListener('keydown', keyDownHandler);
-        document.removeEventListener('keyup', keyUpHandler);
-    };
-    return pressedKeys;
+function bufferToBlob(buffer, type = 'application/octet-stream') {
+    return new Blob([buffer], { type });
 }
 /**
- * Clears listeners for the key map tracking.
+ * Creates and downloads a file from Blob data.
+ * @param {Blob} blob The Blob containing the file data.
+ * @param {string} fileName The name of the file to create.
  */
-createKeyMap.clearListeners = () => { };
+function downloadBlob(blob, fileName) {
+    const link = document.createElement('a');
+    const url = URL.createObjectURL(blob);
+    link.setAttribute('href', url);
+    link.setAttribute('download', fileName);
+    // Append link to the body and trigger a click
+    document.body.appendChild(link);
+    link.click();
+    // Clean up
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+}
 /**
- * Sets up custom keyboard shortcuts with flexible order.
- * @param {Array<string>} keys The combination of keys for the shortcut.
- * @param {Function} callback The callback function to execute when the combination is detected.
+ * Creates a FormData object containing a Blob.
+ * @param {Blob} blob The Blob to include in the FormData.
+ * @param {string} name The name of the form field.
+ * @param {string} [fileName='file'] The file name for the Blob.
+ * @returns {FormData} The FormData object.
  */
-function customShortcut(keys, callback) {
-    const pressedKeys = new Set();
-    const keyDownHandler = (event) => {
-        pressedKeys.add(event.key);
-        if (keys.every(key => pressedKeys.has(key))) {
-            callback();
-        }
-    };
-    const keyUpHandler = (event) => {
-        pressedKeys.delete(event.key);
-    };
-    document.addEventListener('keydown', keyDownHandler);
-    document.addEventListener('keyup', keyUpHandler);
-    // Store the handlers for later removal
-    customShortcut.handlers.push({ keyDownHandler, keyUpHandler });
+function blobToFormData(blob, name, fileName = 'file') {
+    const formData = new FormData();
+    formData.append(name, blob, fileName);
+    return formData;
 }
-customShortcut.handlers = [];
+
 /**
- * Removes all custom keyboard shortcuts added by customShortcut.
+ * Converts a Proxy object to a plain object.
+ * @param {ProxyConstructor} proxy The Proxy object to convert.
+ * @returns {Object} The plain object.
  */
-function removeCustomShortcuts() {
-    for (const { keyDownHandler, keyUpHandler } of customShortcut.handlers) {
-        document.removeEventListener('keydown', keyDownHandler);
-        document.removeEventListener('keyup', keyUpHandler);
+function proxyToPlainObject(proxy) {
+    if (!proxy)
+        return {};
+    const plainObject = {};
+    for (const property of Object.keys(proxy)) {
+        plainObject[property] = proxy[property];
     }
-    customShortcut.handlers = [];
+    return plainObject;
 }
 /**
- * Simulates a key press event.
- * @param {string} key The key to simulate (e.g., 'Enter', 'a').
- * @param {boolean} ctrlKey If true, include Ctrl key in the event.
- * @param {boolean} shiftKey If true, include Shift key in the event.
- * @param {boolean} altKey If true, include Alt key in the event.
+ * Compares two objects to check if they have the same keys.
+ * @param {Object} object1 The first object to compare.
+ * @param {Object} object2 The second object to compare.
+ * @returns {boolean} True if the objects have the same keys, otherwise false.
  */
-function simulateKeyPress(key, ctrlKey = false, shiftKey = false, altKey = false) {
-    const event = new KeyboardEvent('keydown', {
-        key,
-        ctrlKey,
-        shiftKey,
-        altKey,
-        bubbles: true,
-        cancelable: true
+function compareObject(object1, object2) {
+    return Object.keys(object1).every(function (element) {
+        return Object.keys(object2).includes(element);
     });
-    document.dispatchEvent(event);
 }
-
 /**
- * Parses a date string into a Date object.
- * @param {string} dateString The date string in 'YYYY-MM-DD' format.
- * @returns {Date | null} The parsed Date object or null if the format is invalid.
+ * Deeply compares two objects to check if they are equal.
+ * @param {Object} object1 The first object to compare.
+ * @param {Object} object2 The second object to compare.
+ * @returns {boolean} True if the objects are deeply equal, otherwise false.
  */
-function parseDate(dateString) {
-    const parts = dateString.split('-');
-    if (parts.length === 3) {
-        const year = parseInt(parts[0], 10);
-        const month = parseInt(parts[1], 10) - 1; // Months are zero-based
-        const day = parseInt(parts[2], 10);
-        const date = new Date(year, month, day);
-        if (date.getFullYear() === year && date.getMonth() === month && date.getDate() === day) {
-            return date;
+function deepEqual(object1, object2) {
+    if (object1 === object2)
+        return true;
+    if (typeof object1 !== 'object' || typeof object2 !== 'object' || object1 === null || object2 === null) {
+        return false;
+    }
+    const keys1 = Object.keys(object1);
+    const keys2 = Object.keys(object2);
+    if (keys1.length !== keys2.length) {
+        return false;
+    }
+    for (const key of keys1) {
+        if (!keys2.includes(key) || !deepEqual(object1[key], object2[key])) {
+            return false;
         }
     }
-    return null;
+    return true;
 }
 /**
- * Formats a Date object into a string.
- * @param {Date} date The date to format.
- * @param {string} format The format string (e.g., 'YYYY-MM-DD').
- * @returns {string} The formatted date string.
+ * Deeply clones an object.
+ * @param {Object} obj The object to clone.
+ * @returns {Object} The cloned object.
  */
-function formatDate(date, format) {
-    const map = {
-        'YYYY': date.getFullYear(),
-        'MM': String(date.getMonth() + 1).padStart(2, '0'),
-        'DD': String(date.getDate()).padStart(2, '0'),
-        'HH': String(date.getHours()).padStart(2, '0'),
-        'mm': String(date.getMinutes()).padStart(2, '0'),
-        'ss': String(date.getSeconds()).padStart(2, '0')
-    };
-    return format.replace(/YYYY|MM|DD|HH|mm|ss/g, (matched) => (map[matched] || matched).toString());
+function deepClone(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    if (obj instanceof Array) {
+        return obj.map(item => deepClone(item));
+    }
+    if (obj instanceof Object) {
+        const copy = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                copy[key] = deepClone(obj[key]);
+            }
+        }
+        return copy;
+    }
+    throw new Error('Unable to clone object! Its type is not supported.');
 }
 /**
- * Calculates the number of days between two dates.
- * @param {Date} startDate The start date.
- * @param {Date} endDate The end date.
- * @returns {number} The number of days between the two dates.
+ * Converts an object to a query string.
+ * @param {Object} obj The object to convert.
+ * @returns {string} The query string.
  */
-function daysBetween(startDate, endDate) {
-    const millisecondsPerDay = 86400000; // Number of milliseconds in one day
-    return Math.round((endDate.getTime() - startDate.getTime()) / millisecondsPerDay);
+function objectToQueryString(obj) {
+    return Object.keys(obj)
+        .map(key => encodeURIComponent(key) + '=' + encodeURIComponent(obj[key]))
+        .join('&');
 }
+// Example usage:
+// objectToQueryString({ name: 'John Doe', age: 30 }); // 'name=John%20Doe&age=30'
 /**
- * Adds a specified number of days to a date.
- * @param {Date} date The date to modify.
- * @param {number} days The number of days to add.
- * @returns {Date} The new date with days added.
+ * Gets the differences between two objects.
+ * @param {Object} object1 The first object.
+ * @param {Object} object2 The second object.
+ * @returns {Object} An object containing the differences.
  */
-function addDays(date, days) {
-    const result = new Date(date);
-    result.setDate(result.getDate() + days);
-    return result;
+function getObjectDifferences(object1, object2) {
+    const differences = {};
+    const keys = new Set([...Object.keys(object1), ...Object.keys(object2)]);
+    for (const key of keys) {
+        if (object1[key] !== object2[key]) {
+            differences[key] = { object1: object1[key], object2: object2[key] };
+        }
+    }
+    return differences;
 }
 /**
- * Subtracts a specified number of days from a date.
- * @param {Date} date The date to modify.
- * @param {number} days The number of days to subtract.
- * @returns {Date} The new date with days subtracted.
+ * Filters an object by a list of keys.
+ * @param {Object} obj The object to filter.
+ * @param {Array<string>} keys The keys to keep.
+ * @returns {Object} The filtered object.
  */
-function subtractDays(date, days) {
-    return addDays(date, -days);
+function filterObjectByKeys(obj, keys) {
+    const filteredObject = {};
+    for (const key of keys) {
+        if (key in obj) {
+            filteredObject[key] = obj[key];
+        }
+    }
+    return filteredObject;
 }
+// Example usage:
+// filterObjectByKeys({ name: 'John', age: 30, job: 'Developer' }, ['name', 'job']); // { name: 'John', job: 'Developer' }
 /**
- * Determines if a year is a leap year.
- * @param {number} year The year to check.
- * @returns {boolean} True if the year is a leap year, false otherwise.
+ * Deeply merges two objects.
+ * @param {Object} target The target object to merge into.
+ * @param {Object} source The source object to merge from.
+ * @returns {Object} The merged object.
  */
-function isLeapYear(year) {
-    return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
+function deepMerge(target, source) {
+    if (target === null || typeof target !== 'object' || typeof source !== 'object') {
+        return target;
+    }
+    for (const key in source) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            if (source[key] && typeof source[key] === 'object') {
+                if (target && !target[key]) {
+                    Object.assign(target, { [key]: {} });
+                }
+                deepMerge(target[key], source[key]);
+            }
+            else {
+                Object.assign(target, { [key]: source[key] });
+            }
+        }
+    }
+    return target;
 }
 /**
- * Gets the first day of the month for a given date.
- * @param {Date} date The date to use.
- * @returns {Date} The first day of the month.
+ * Checks if an object is empty.
+ * @param {Object} obj The object to check.
+ * @returns {boolean} True if the object is empty, otherwise false.
  */
-function getStartOfMonth(date) {
-    return new Date(date.getFullYear(), date.getMonth(), 1);
+function isEmptyObject(obj) {
+    return Object.keys(obj).length === 0;
 }
 /**
- * Gets the last day of the month for a given date.
- * @param {Date} date The date to use.
- * @returns {Date} The last day of the month.
+ * Safely accesses nested properties in an object.
+ * @param {Object} obj The object to access.
+ * @param {Array<string>} keys The array of keys representing the path.
+ * @returns {any} The value at the nested path, or undefined if not found.
  */
-function getEndOfMonth(date) {
-    return new Date(date.getFullYear(), date.getMonth() + 1, 0);
+function safeGet(obj, keys) {
+    return keys.reduce((acc, key) => (acc && acc[key] !== undefined) ? acc[key] : undefined, obj);
 }
+// Example usage:
+// safeGet({ a: { b: { c: 10 } } }, ['a', 'b', 'c']); // 10
+// safeGet({ a: { b: { c: 10 } } }, ['a', 'x', 'c']); // undefined
 /**
- * Calculates age from a given birth date.
- * @param {Date} birthDate The birth date.
- * @returns {number} The calculated age.
+ * Removes empty properties (null, undefined, or empty string) from an object.
+ * @param {Object} obj The object to clean.
+ * @returns {Object} A new object without empty properties.
  */
-function calculateAge(birthDate) {
-    const today = new Date();
-    let age = today.getFullYear() - birthDate.getFullYear();
-    const m = today.getMonth() - birthDate.getMonth();
-    if (m < 0 || (m === 0 && today.getDate() < birthDate.getDate())) {
-        age--;
-    }
-    return age;
+function removeEmptyProperties(obj) {
+    return Object.keys(obj)
+        .filter(key => obj[key] !== null && obj[key] !== undefined && obj[key] !== '')
+        .reduce((acc, key) => {
+        acc[key] = obj[key];
+        return acc;
+    }, {});
 }
+// Example usage:
+// removeEmptyProperties({ a: null, b: 2, c: undefined, d: '', e: 'hello' }); // { b: 2, e: 'hello' }
 /**
- * Calculates the number of days until the next birthday.
- * @param {Date} birthDate The birth date.
- * @returns {number} The number of days until the next birthday.
+ * Retrieves all keys of an object as an array.
+ * @param {Object} obj The object to retrieve keys from.
+ * @returns {Array<string>} The array of keys.
  */
-function daysToNextBirthday(birthDate) {
-    const today = new Date();
-    const currentYear = today.getFullYear();
-    const nextBirthday = new Date(birthDate);
-    nextBirthday.setFullYear(currentYear);
-    if (nextBirthday < today) {
-        nextBirthday.setFullYear(currentYear + 1);
-    }
-    return daysBetween(today, nextBirthday);
+function getObjectKeys(obj) {
+    return Object.keys(obj);
 }
+// Example usage:
+// getObjectKeys({ name: 'John', age: 30 }); // ['name', 'age']
 /**
- * Calculates the age at a specific date.
- * @param {Date} birthDate The birth date.
- * @param {Date} atDate The date to calculate the age at.
- * @returns {number} The calculated age.
+ * Checks if an object has nested properties.
+ * @param {Object} obj The object to check.
+ * @returns {boolean} True if there are nested properties, false otherwise.
  */
-function ageAtDate(birthDate, atDate) {
-    let age = atDate.getFullYear() - birthDate.getFullYear();
-    const m = atDate.getMonth() - birthDate.getMonth();
-    if (m < 0 || (m === 0 && atDate.getDate() < birthDate.getDate())) {
-        age--;
-    }
-    return age;
+function hasNestedProperties(obj) {
+    return Object.values(obj).some(value => typeof value === 'object' && value !== null);
 }
-
+// Example usage:
+// hasNestedProperties({ a: 1, b: { c: 2 } }); // true
+// hasNestedProperties({ a: 1, b: 2 }); // false
 /**
- * Creates a debounced asynchronous validator function.
- *
- * @param validator - The async validator function to debounce.
- * @param delay - The debounce delay in milliseconds.
- * @returns A debounced version of the validator function.
+ * Converts an object to FormData, handling nested objects.
+ * @param {Object} obj The object to convert.
+ * @param {FormData} [formData] The FormData object to append to.
+ * @param {string} [parentKey] The parent key for nested objects.
+ * @returns {FormData} The FormData object.
  */
-function debounceAsyncValidator(validator, delay) {
-    let currentPromiseReject = null;
-    /**
-     * Creates a debounce delay.
-     *
-     * @returns A promise that resolves after the debounce delay.
-     */
-    function debounce() {
-        return new Promise((resolve, reject) => {
-            const { start, stop } = useTimeoutFn(() => {
-                currentPromiseReject = null;
-                resolve();
-            }, delay);
-            if (currentPromiseReject) {
-                currentPromiseReject(new Error('replaced'));
-            }
-            currentPromiseReject = reject;
-            start();
-        });
-    }
-    return function (value) {
-        if (currentPromiseReject) {
-            currentPromiseReject(new Error('replaced'));
-            currentPromiseReject = null;
+function objectToFormDataEnhanced(obj, formData = new FormData(), parentKey = '') {
+    Object.entries(obj).forEach(([key, value]) => {
+        const finalKey = parentKey ? `${parentKey}[${key}]` : key;
+        if (value && typeof value === 'object' && !(value instanceof File)) {
+            objectToFormDataEnhanced(value, formData, finalKey);
         }
-        return validator.call(this, value, debounce);
-    };
-}
-/**
- * Creates a debounced version of an asynchronous function.
- * @param {Function} func The asynchronous function to debounce.
- * @param {number} wait The number of milliseconds to wait before invoking the function.
- * @returns {Function} The debounced function.
- */
-function debounceAsync(func, wait) {
-    let timeoutReject = null;
-    return function (...args) {
-        if (timeoutReject) {
-            timeoutReject(new Error('replaced'));
-            timeoutReject = null;
+        else {
+            formData.append(finalKey, value);
         }
-        return new Promise((resolve, reject) => {
-            const { start } = useTimeoutFn(() => {
-                func.apply(this, args).then(resolve).catch(reject);
-            }, wait);
-            timeoutReject = reject;
-            start();
-        });
-    };
+    });
+    return formData;
 }
+// Example usage:
+// objectToFormDataEnhanced({ user: { name: 'John', age: 30 } });
 /**
- * Creates a debounced asynchronous function that executes immediately on the first call.
- * @param {Function} func The asynchronous function to debounce.
- * @param {number} wait The number of milliseconds to wait before invoking the function.
- * @returns {Function} The debounced function with immediate execution on the first call.
+ * Converts a JavaScript object into FormData.
+ *
+ * @param obj - The object to be converted.
+ * @param form - An optional FormData instance to use.
+ * @param namespace - An optional namespace to use for nested objects.
+ * @returns The FormData instance with the object's key-value pairs.
  */
-function debounceAsyncWithImmediate(func, wait) {
-    let timeoutReject = null;
-    let callNow = true;
-    return function (...args) {
-        const context = this;
-        if (callNow) {
-            callNow = false;
-            return func.apply(context, args).finally(() => {
-                const { start } = useTimeoutFn(() => {
-                    callNow = true;
-                }, wait);
-                start();
-            });
+const objectToFormData = function (obj, form, namespace) {
+    const fd = form || new FormData();
+    let formKey;
+    for (const property in obj) {
+        if (obj[property] === undefined) {
+            continue;
         }
-        else {
-            if (timeoutReject) {
-                timeoutReject(new Error('replaced'));
-                timeoutReject = null;
+        if (Object.prototype.hasOwnProperty.call(obj, property)) {
+            if (namespace) {
+                formKey = `${namespace}[${property}]`;
+            }
+            else {
+                formKey = property;
+            }
+            if (typeof obj[property] === 'object' && !(obj[property] instanceof File)) {
+                // Recursively handle nested objects
+                objectToFormData(obj[property], fd, formKey);
+            }
+            else {
+                // Convert boolean values to 1/0
+                const value = obj[property] === true || obj[property] === false ? Number(obj[property]) : obj[property];
+                fd.append(formKey, value);
             }
-            return new Promise((resolve, reject) => {
-                const { start } = useTimeoutFn(() => {
-                    func.apply(context, args).then(resolve).catch(reject);
-                }, wait);
-                timeoutReject = reject;
-                start();
-            });
         }
-    };
-}
+    }
+    return fd;
+};
 /**
- * Creates a debounced version of a function that executes on the leading edge.
- * @param {Function} func The function to debounce.
- * @param {number} wait The number of milliseconds to wait before invoking the function.
- * @returns {Function} The debounced function.
+ * Flattens a nested object, bringing all properties to the top level.
+ * @param {Object} obj The object to flatten.
+ * @param {string} [parentKey] The parent key for nested properties.
+ * @param {Object} [result] The resulting flattened object.
+ * @returns {Object} The flattened object.
  */
-function debounceLeading(func, wait) {
-    let timeoutReject = null;
-    return function (...args) {
-        const context = this;
-        if (!timeoutReject) {
-            func.apply(context, args);
-        }
-        if (timeoutReject) {
-            timeoutReject(new Error('replaced'));
-            timeoutReject = null;
-        }
-        const { start } = useTimeoutFn(() => {
-            timeoutReject = null;
-        }, wait);
-        timeoutReject = () => { };
-        start();
-    };
+function flattenObject(obj, parentKey = '', result = {}) {
+    for (const key in obj) {
+        if (obj.hasOwnProperty(key)) {
+            const propName = parentKey ? `${parentKey}.${key}` : key;
+            if (typeof obj[key] === 'object' && obj[key] !== null) {
+                flattenObject(obj[key], propName, result);
+            }
+            else {
+                result[propName] = obj[key];
+            }
+        }
+    }
+    return result;
 }
+// Example usage:
+// flattenObject({ a: 1, b: { c: 2, d: { e: 3 } } }); // { 'a': 1, 'b.c': 2, 'b.d.e': 3 }
+
 /**
- * Creates a debounced version of a function that executes on the trailing edge.
- * @param {Function} func The function to debounce.
- * @param {number} wait The number of milliseconds to wait before invoking the function.
- * @returns {Function} The debounced function.
+ * Capitalizes the first character of a string.
+ * @param {string} s The string to capitalize.
+ * @returns {string} The capitalized string.
  */
-function debounceTrailing(func, wait) {
-    let timeoutReject = null;
-    return function (...args) {
-        const context = this;
-        if (timeoutReject) {
-            timeoutReject(new Error('replaced'));
-            timeoutReject = null;
-        }
-        const { start } = useTimeoutFn(() => {
-            func.apply(context, args);
-        }, wait);
-        timeoutReject = () => { };
-        start();
-    };
+function upperFirst(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
 }
+// Example usage:
+// console.log(upperFirst('hello')); // 'Hello'
 /**
- * Creates a debounced version of a function that executes on both leading and trailing edges.
- * @param {Function} func The function to debounce.
- * @param {number} wait The number of milliseconds to wait before invoking the function.
- * @returns {Function} The debounced function.
+ * Lowercases the first character of a string.
+ * @param {string} s The string to lowercase.
+ * @returns {string} The lowercased string.
  */
-function debounceLeadingTrailing(func, wait) {
-    let timeoutReject = null;
-    let lastCall = 0;
-    return function (...args) {
-        const context = this;
-        const now = Date.now();
-        if (timeoutReject) {
-            timeoutReject(new Error('replaced'));
-            timeoutReject = null;
-        }
-        if (now - lastCall >= wait) {
-            func.apply(context, args);
-            lastCall = now;
-        }
-        else {
-            const { start } = useTimeoutFn(() => {
-                func.apply(context, args);
-            }, wait - (now - lastCall));
-            timeoutReject = () => { };
-            start();
-        }
-    };
+function lowerFirst(s) {
+    return s.charAt(0).toLowerCase() + s.slice(1);
 }
+// Example usage:
+// console.log(lowerFirst('Hello')); // 'hello'
 /**
- * Creates a debounced version of a function.
- * @param {Function} func The function to debounce.
- * @param {number} wait The number of milliseconds to wait before invoking the function.
- * @returns {Function} The debounced function.
+ * Removes accents and special characters from a string and converts it to a URL-friendly format.
+ * @param {string} input The string to process.
+ * @returns {string} The processed string.
  */
-function debounce(func, wait) {
-    let timeoutReject = null;
-    return function (...args) {
-        if (timeoutReject) {
-            timeoutReject(new Error('replaced'));
-            timeoutReject = null;
-        }
-        const { start } = useTimeoutFn(() => {
-            func.apply(this, args);
-        }, wait);
-        timeoutReject = () => { };
-        start();
-    };
+function removeAccent(input) {
+    return input
+        .toLowerCase()
+        .trim()
+        .replace(/[\s_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "");
 }
+// Example usage:
+// console.log(removeAccent('Café du Nord')); // 'cafe-du-nord'
 /**
- * Creates a throttled version of a function.
- * @param {Function} func The function to throttle.
- * @param {number} limit The number of milliseconds to wait between function calls.
- * @returns {Function} The throttled function.
+ * Reverses a string.
+ * @param {string} str The string to reverse.
+ * @returns {string} The reversed string.
  */
-function throttle(func, limit) {
-    let lastCall = 0;
-    return function (...args) {
-        const now = Date.now();
-        if (now - lastCall >= limit) {
-            lastCall = now;
-            func.apply(this, args);
-        }
-    };
+function reverseString(str) {
+    return str.split('').reverse().join('');
 }
-
+// Example usage:
+// console.log(reverseString('hello')); // 'olleh'
 /**
- * Converts a FormData object to a plain JavaScript object.
- * @param {FormData} formData The FormData object to convert.
- * @returns {Record<string, any>} The plain JavaScript object.
+ * Counts the number of words in a string.
+ * @param {string} str The string to analyze.
+ * @returns {number} The word count.
  */
-function formDataToObject(formData) {
-    const obj = {};
-    formData.forEach((value, key) => {
-        // Handle multiple values for the same key
-        if (obj[key]) {
-            if (!Array.isArray(obj[key])) {
-                obj[key] = [obj[key]];
-            }
-            obj[key].push(value);
-        }
-        else {
-            obj[key] = value;
-        }
-    });
-    return obj;
+function countWords(str) {
+    return str.trim().split(/\s+/).length;
 }
+// Example usage:
+// console.log(countWords('Hello world!')); // 2
 /**
- * Reads a file as text.
- * @param {File} file The file to read.
- * @returns {Promise<string>} A promise that resolves with the file content.
+ * Truncates a string to the specified length and adds ellipsis if necessary.
+ * @param {string} str The string to truncate.
+ * @param {number} maxLength The maximum length of the string.
+ * @returns {string} The truncated string.
  */
-function readFileAsText(file) {
-    return new Promise((resolve, reject) => {
-        const reader = new FileReader();
-        reader.onload = () => resolve(reader.result);
-        reader.onerror = reject;
-        reader.readAsText(file);
-    });
+function truncateString(str, maxLength) {
+    return str.length > maxLength ? str.slice(0, maxLength) + '...' : str;
 }
+// Example usage:
+// console.log(truncateString('This is a long string', 10)); // 'This is a...'
 /**
- * Reads a file as a Data URL.
- * @param {File} file The file to read.
- * @returns {Promise<string>} A promise that resolves with the Data URL.
+ * Converts a string to camel case.
+ * @param {string} str The string to convert.
+ * @returns {string} The camel cased string.
  */
-function readFileAsDataURL(file) {
-    return new Promise((resolve, reject) => {
-        const reader = new FileReader();
-        reader.onload = () => resolve(reader.result);
-        reader.onerror = reject;
-        reader.readAsDataURL(file);
-    });
+function toCamelCase(str) {
+    return str
+        .toLowerCase()
+        .replace(/[^a-zA-Z0-9]+(.)/g, (match, chr) => chr.toUpperCase());
 }
+// Example usage:
+// console.log(toCamelCase('hello world example')); // 'helloWorldExample'
 /**
- * Creates a Blob from a string.
- * @param {string} content The string content for the Blob.
- * @param {string} [type='text/plain'] The MIME type of the Blob.
- * @returns {Blob} The Blob object.
+ * Converts a string to kebab case.
+ * @param {string} str The string to convert.
+ * @returns {string} The kebab cased string.
  */
-function stringToBlob(content, type = 'text/plain') {
-    return new Blob([content], { type });
+function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+// Example usage:
+// console.log(toKebabCase('Hello World Example')); // 'hello-world-example'
+/**
+ * Replaces all instances of a substring within a string.
+ * @param {string} str The original string.
+ * @param {string} find The substring to find.
+ * @param {string} replace The substring to replace with.
+ * @returns {string} The modified string.
+ */
+function replaceAll(str, find, replace) {
+    return str.split(find).join(replace);
 }
+// Example usage:
+// console.log(replaceAll('hello world', 'o', 'a')); // 'hella warld'
 /**
- * Creates a Blob from an ArrayBuffer.
- * @param {ArrayBuffer} buffer The ArrayBuffer to convert.
- * @param {string} [type='application/octet-stream'] The MIME type of the Blob.
- * @returns {Blob} The Blob object.
+ * Generates a random string of a specific length.
+ * @param {number} length The length of the string to generate.
+ * @returns {string} The random string.
  */
-function bufferToBlob(buffer, type = 'application/octet-stream') {
-    return new Blob([buffer], { type });
+function generateRandomString(length) {
+    const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    return Array.from({ length }, () => characters.charAt(Math.floor(Math.random() * characters.length))).join('');
 }
+// Example usage:
+// console.log(generateRandomString(10)); // 'A1b2C3d4E5'
+
 /**
- * Creates and downloads a file from Blob data.
- * @param {Blob} blob The Blob containing the file data.
- * @param {string} fileName The name of the file to create.
+ * Validates if the key pressed is a valid letter or special character.
+ * @param {KeyboardEvent} e The keyboard event.
+ * @returns {boolean} True if the key is valid, otherwise false.
  */
-function downloadBlob(blob, fileName) {
-    const link = document.createElement('a');
-    const url = URL.createObjectURL(blob);
-    link.setAttribute('href', url);
-    link.setAttribute('download', fileName);
-    // Append link to the body and trigger a click
-    document.body.appendChild(link);
-    link.click();
-    // Clean up
-    document.body.removeChild(link);
-    URL.revokeObjectURL(url);
+function validateLetters(e) {
+    const key = e.keyCode;
+    const validKeys = [
+        ...Array.from({ length: 26 }, (_, i) => i + 65), // Letters A-Z
+        ...Array.from({ length: 26 }, (_, i) => i + 97), // Letters a-z
+        45, // Hyphen
+        32, // Space
+        241, // ñ
+        209, // Ñ
+        225, // á
+        233, // é
+        237, // í
+        243, // ó
+        250, // ú
+        193, // Á
+        201, // É
+        205, // Í
+        211, // Ó
+        218 // Ú
+    ];
+    if (validKeys.includes(key)) {
+        return true;
+    }
+    e.preventDefault();
+    return false;
 }
+// Example usage:
+// document.addEventListener('keydown', validateLetters);
 /**
- * Creates a FormData object containing a Blob.
- * @param {Blob} blob The Blob to include in the FormData.
- * @param {string} name The name of the form field.
- * @param {string} [fileName='file'] The file name for the Blob.
- * @returns {FormData} The FormData object.
+ * Validates if the key pressed is a valid alphanumeric character.
+ * @param {KeyboardEvent} e The keyboard event.
+ * @returns {boolean} True if the key is valid, otherwise false.
  */
-function blobToFormData(blob, name, fileName = 'file') {
-    const formData = new FormData();
-    formData.append(name, blob, fileName);
-    return formData;
+function validateAlphanumeric(e) {
+    const key = e.keyCode;
+    const validKeys = [
+        ...Array.from({ length: 10 }, (_, i) => i + 48), // Numbers 0-9
+        ...Array.from({ length: 26 }, (_, i) => i + 65), // Letters A-Z
+        ...Array.from({ length: 26 }, (_, i) => i + 97), // Letters a-z
+        45, // Hyphen
+        95, // Underscore
+        32 // Space
+    ];
+    if (validKeys.includes(key)) {
+        return true;
+    }
+    e.preventDefault();
+    return false;
 }
-
+// Example usage:
+// document.addEventListener('keydown', validateAlphanumeric);
 /**
- * Converts a Proxy object to a plain object.
- * @param {ProxyConstructor} proxy The Proxy object to convert.
- * @returns {Object} The plain object.
+ * Validates if the key pressed is a number.
+ * @param {KeyboardEvent} e The keyboard event.
+ * @returns {boolean} True if the key is a number, otherwise false.
  */
-function proxyToPlainObject(proxy) {
-    if (!proxy)
-        return {};
-    const plainObject = {};
-    for (const property of Object.keys(proxy)) {
-        plainObject[property] = proxy[property];
+function validateNumbers(e) {
+    const key = e.keyCode;
+    if ((key >= 48 && key <= 57) || key === 46 || key === 8 || key === 37 || key === 39) {
+        return true;
     }
-    return plainObject;
+    e.preventDefault();
+    return false;
 }
+// Example usage:
+// document.addEventListener('keydown', validateNumbers);
 /**
- * Compares two objects to check if they have the same keys.
- * @param {Object} object1 The first object to compare.
- * @param {Object} object2 The second object to compare.
- * @returns {boolean} True if the objects have the same keys, otherwise false.
+ * Validates if a phone number is valid.
+ * @param {string} phoneNumber The phone number to validate.
+ * @returns {boolean} True if the phone number is valid, otherwise false.
  */
-function compareObject(object1, object2) {
-    return Object.keys(object1).every(function (element) {
-        return Object.keys(object2).includes(element);
-    });
+function isValidPhoneNumber(phoneNumber) {
+    const phonePattern = /^[0-9]{10}$/; // Example pattern for 10-digit phone numbers
+    return phonePattern.test(phoneNumber);
 }
+// Example usage:
+// console.log(isValidPhoneNumber('1234567890')); // true
+// console.log(isValidPhoneNumber('123-456-7890')); // false
 /**
- * Deeply compares two objects to check if they are equal.
- * @param {Object} object1 The first object to compare.
- * @param {Object} object2 The second object to compare.
- * @returns {boolean} True if the objects are deeply equal, otherwise false.
+ * Validates if a string is a valid email address.
+ * @param {string} email The email address to validate.
+ * @returns {boolean} True if the email address is valid, otherwise false.
  */
-function deepEqual(object1, object2) {
-    if (object1 === object2)
+function isValidEmail(email) {
+    const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailPattern.test(email);
+}
+// Example usage:
+// console.log(isValidEmail('example@domain.com')); // true
+// console.log(isValidEmail('invalid-email')); // false
+/**
+ * Validates if a string is a valid URL.
+ * @param {string} url The URL to validate.
+ * @returns {boolean} True if the URL is valid, otherwise false.
+ */
+function isValidURL(url) {
+    try {
+        new URL(url);
         return true;
-    if (typeof object1 !== 'object' || typeof object2 !== 'object' || object1 === null || object2 === null) {
-        return false;
     }
-    const keys1 = Object.keys(object1);
-    const keys2 = Object.keys(object2);
-    if (keys1.length !== keys2.length) {
+    catch {
         return false;
     }
-    for (const key of keys1) {
-        if (!keys2.includes(key) || !deepEqual(object1[key], object2[key])) {
-            return false;
-        }
-    }
-    return true;
 }
+// Example usage:
+// console.log(isValidURL('https://www.example.com')); // true
+// console.log(isValidURL('invalid-url')); // false
 /**
- * Deeply clones an object.
- * @param {Object} obj The object to clone.
- * @returns {Object} The cloned object.
+ * Validates if a string is a valid date in YYYY-MM-DD format.
+ * @param {string} date The date string to validate.
+ * @returns {boolean} True if the date is valid, otherwise false.
  */
-function deepClone(obj) {
-    if (obj === null || typeof obj !== 'object') {
-        return obj;
-    }
-    if (obj instanceof Date) {
-        return new Date(obj.getTime());
-    }
-    if (obj instanceof Array) {
-        return obj.map(item => deepClone(item));
-    }
-    if (obj instanceof Object) {
-        const copy = {};
-        for (const key in obj) {
-            if (Object.prototype.hasOwnProperty.call(obj, key)) {
-                copy[key] = deepClone(obj[key]);
-            }
-        }
-        return copy;
-    }
-    throw new Error('Unable to clone object! Its type is not supported.');
+function isValidDate(date) {
+    const datePattern = /^\d{4}-\d{2}-\d{2}$/;
+    if (!datePattern.test(date))
+        return false;
+    const [year, month, day] = date.split('-').map(Number);
+    const dateObj = new Date(year, month - 1, day);
+    return dateObj.getFullYear() === year && dateObj.getMonth() === month - 1 && dateObj.getDate() === day;
 }
+// Example usage:
+// console.log(isValidDate('2024-08-31')); // true
+// console.log(isValidDate('2024-02-30')); // false
 /**
- * Converts an object to a query string.
- * @param {Object} obj The object to convert.
- * @returns {string} The query string.
+ * Validates if a password meets certain strength criteria.
+ * @param {string} password The password to validate.
+ * @returns {boolean} True if the password is strong, otherwise false.
  */
-function objectToQueryString(obj) {
-    return Object.keys(obj)
-        .map(key => encodeURIComponent(key) + '=' + encodeURIComponent(obj[key]))
-        .join('&');
+function isStrongPassword(password) {
+    const minLength = 8;
+    const hasUpperCase = /[A-Z]/.test(password);
+    const hasLowerCase = /[a-z]/.test(password);
+    const hasNumbers = /[0-9]/.test(password);
+    const hasSpecialChars = /[!@#$%^&*(),.?":{}|<>]/.test(password);
+    return password.length >= minLength && hasUpperCase && hasLowerCase && hasNumbers && hasSpecialChars;
 }
 // Example usage:
-// objectToQueryString({ name: 'John Doe', age: 30 }); // 'name=John%20Doe&age=30'
+// console.log(isStrongPassword('Strong1@password')); // true
+// console.log(isStrongPassword('weakpass')); // false
 /**
- * Gets the differences between two objects.
- * @param {Object} object1 The first object.
- * @param {Object} object2 The second object.
- * @returns {Object} An object containing the differences.
+ * Validates a credit card number using the Luhn algorithm.
+ * @param {string} cardNumber The credit card number to validate.
+ * @returns {boolean} True if the credit card number is valid, otherwise false.
  */
-function getObjectDifferences(object1, object2) {
-    const differences = {};
-    const keys = new Set([...Object.keys(object1), ...Object.keys(object2)]);
-    for (const key of keys) {
-        if (object1[key] !== object2[key]) {
-            differences[key] = { object1: object1[key], object2: object2[key] };
+function isValidCreditCard(cardNumber) {
+    const sanitized = cardNumber.replace(/\D/g, '');
+    let sum = 0;
+    let shouldDouble = false;
+    for (let i = sanitized.length - 1; i >= 0; i--) {
+        let digit = parseInt(sanitized.charAt(i), 10);
+        if (shouldDouble) {
+            digit *= 2;
+            if (digit > 9)
+                digit -= 9;
         }
+        sum += digit;
+        shouldDouble = !shouldDouble;
     }
-    return differences;
+    return sum % 10 === 0;
 }
+// Example usage:
+// console.log(isValidCreditCard('4111111111111111')); // true
+// console.log(isValidCreditCard('1234567812345670')); // false
 /**
- * Filters an object by a list of keys.
- * @param {Object} obj The object to filter.
- * @param {Array<string>} keys The keys to keep.
- * @returns {Object} The filtered object.
+ * Validates if a string is a valid hex color code.
+ * @param {string} color The color code to validate.
+ * @returns {boolean} True if the color code is valid, otherwise false.
  */
-function filterObjectByKeys(obj, keys) {
-    const filteredObject = {};
-    for (const key of keys) {
-        if (key in obj) {
-            filteredObject[key] = obj[key];
-        }
-    }
-    return filteredObject;
+function isValidHexColor(color) {
+    const hexPattern = /^#([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})$/;
+    return hexPattern.test(color);
 }
 // Example usage:
-// filterObjectByKeys({ name: 'John', age: 30, job: 'Developer' }, ['name', 'job']); // { name: 'John', job: 'Developer' }
+// console.log(isValidHexColor('#FFFFFF')); // true
+// console.log(isValidHexColor('#FFF')); // true
+// console.log(isValidHexColor('#12345G')); // false
 /**
- * Deeply merges two objects.
- * @param {Object} target The target object to merge into.
- * @param {Object} source The source object to merge from.
- * @returns {Object} The merged object.
+ * Validates if a string is a valid time in HH:MM format.
+ * @param {string} time The time string to validate.
+ * @returns {boolean} True if the time is valid, otherwise false.
  */
-function deepMerge(target, source) {
-    if (target === null || typeof target !== 'object' || typeof source !== 'object') {
-        return target;
-    }
-    for (const key in source) {
-        if (Object.prototype.hasOwnProperty.call(source, key)) {
-            if (source[key] && typeof source[key] === 'object') {
-                if (target && !target[key]) {
-                    Object.assign(target, { [key]: {} });
-                }
-                deepMerge(target[key], source[key]);
-            }
-            else {
-                Object.assign(target, { [key]: source[key] });
-            }
-        }
-    }
-    return target;
+function isValidTime(time) {
+    const timePattern = /^([01]\d|2[0-3]):([0-5]\d)$/;
+    return timePattern.test(time);
+}
+// Example usage:
+// console.log(isValidTime('14:30')); // true
+// console.log(isValidTime('25:00')); // false
+/**
+ * Validates if a string is a valid IPv4 address.
+ * @param {string} ip The IP address to validate.
+ * @returns {boolean} True if the IP address is valid, otherwise false.
+ */
+function isValidIP(ip) {
+    const ipPattern = /^(25[0-5]|2[0-4][0-9]|[0-1]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[0-1]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[0-1]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[0-1]?[0-9][0-9]?)$/;
+    return ipPattern.test(ip);
 }
+// Example usage:
+// console.log(isValidIP('192.168.1.1')); // true
+// console.log(isValidIP('999.999.999.999')); // false
 /**
- * Checks if an object is empty.
- * @param {Object} obj The object to check.
- * @returns {boolean} True if the object is empty, otherwise false.
+ * Validates if a string is a valid U.S. Social Security Number (SSN).
+ * @param {string} ssn The SSN to validate.
+ * @returns {boolean} True if the SSN is valid, otherwise false.
  */
-function isEmptyObject(obj) {
-    return Object.keys(obj).length === 0;
+function isValidSSN(ssn) {
+    const ssnPattern = /^\d{3}-\d{2}-\d{4}$/;
+    return ssnPattern.test(ssn);
 }
+// Example usage:
+// console.log(isValidSSN('123-45-6789')); // true
+// console.log(isValidSSN('123-45-678')); // false
 /**
- * Safely accesses nested properties in an object.
- * @param {Object} obj The object to access.
- * @param {Array<string>} keys The array of keys representing the path.
- * @returns {any} The value at the nested path, or undefined if not found.
+ * Validates if a string is a valid U.S. ZIP code.
+ * @param {string} zip The ZIP code to validate.
+ * @returns {boolean} True if the ZIP code is valid, otherwise false.
  */
-function safeGet(obj, keys) {
-    return keys.reduce((acc, key) => (acc && acc[key] !== undefined) ? acc[key] : undefined, obj);
+function isValidZIP(zip) {
+    const zipPattern = /^\d{5}(-\d{4})?$/;
+    return zipPattern.test(zip);
 }
 // Example usage:
-// safeGet({ a: { b: { c: 10 } } }, ['a', 'b', 'c']); // 10
-// safeGet({ a: { b: { c: 10 } } }, ['a', 'x', 'c']); // undefined
+// console.log(isValidZIP('12345')); // true
+// console.log(isValidZIP('12345-6789')); // true
+// console.log(isValidZIP('1234')); // false
 /**
- * Removes empty properties (null, undefined, or empty string) from an object.
- * @param {Object} obj The object to clean.
- * @returns {Object} A new object without empty properties.
+ * Validates if a string is a valid credit card expiry date in MM/YY format.
+ * @param {string} expiryDate The expiry date to validate.
+ * @returns {boolean} True if the expiry date is valid, otherwise false.
  */
-function removeEmptyProperties(obj) {
-    return Object.keys(obj)
-        .filter(key => obj[key] !== null && obj[key] !== undefined && obj[key] !== '')
-        .reduce((acc, key) => {
-        acc[key] = obj[key];
-        return acc;
-    }, {});
+function isValidExpiryDate(expiryDate) {
+    const expiryPattern = /^(0[1-9]|1[0-2])\/\d{2}$/;
+    if (!expiryPattern.test(expiryDate))
+        return false;
+    const [month, year] = expiryDate.split('/').map(Number);
+    const currentYear = new Date().getFullYear() % 100;
+    const currentMonth = new Date().getMonth() + 1;
+    return (year > currentYear) || (year === currentYear && month >= currentMonth);
 }
 // Example usage:
-// removeEmptyProperties({ a: null, b: 2, c: undefined, d: '', e: 'hello' }); // { b: 2, e: 'hello' }
+// console.log(isValidExpiryDate('08/24')); // true
+// console.log(isValidExpiryDate('12/22')); // false
 /**
- * Retrieves all keys of an object as an array.
- * @param {Object} obj The object to retrieve keys from.
- * @returns {Array<string>} The array of keys.
+ * Validates if a string is a valid 8-character hexadecimal color code (including alpha).
+ * @param {string} color The color code to validate.
+ * @returns {boolean} True if the color code is valid, otherwise false.
  */
-function getObjectKeys(obj) {
-    return Object.keys(obj);
+function isValidHexColorAlpha(color) {
+    const hexPattern = /^#([0-9A-Fa-f]{8})$/;
+    return hexPattern.test(color);
 }
 // Example usage:
-// getObjectKeys({ name: 'John', age: 30 }); // ['name', 'age']
+// console.log(isValidHexColorAlpha('#RRGGBBAA')); // true
+// console.log(isValidHexColorAlpha('#FFFFFF')); // false
 /**
- * Checks if an object has nested properties.
- * @param {Object} obj The object to check.
- * @returns {boolean} True if there are nested properties, false otherwise.
+ * Validates if a username meets specific criteria.
+ * @param {string} username The username to validate.
+ * @returns {boolean} True if the username is valid, otherwise false.
  */
-function hasNestedProperties(obj) {
-    return Object.values(obj).some(value => typeof value === 'object' && value !== null);
+function isValidUsername(username) {
+    const usernamePattern = /^[a-zA-Z0-9_]{3,16}$/; // 3 to 16 characters, letters, numbers, and underscores only
+    return usernamePattern.test(username);
 }
 // Example usage:
-// hasNestedProperties({ a: 1, b: { c: 2 } }); // true
-// hasNestedProperties({ a: 1, b: 2 }); // false
+// console.log(isValidUsername('user_name123')); // true
+// console.log(isValidUsername('us')); // false
 /**
- * Converts an object to FormData, handling nested objects.
- * @param {Object} obj The object to convert.
- * @param {FormData} [formData] The FormData object to append to.
- * @param {string} [parentKey] The parent key for nested objects.
- * @returns {FormData} The FormData object.
+ * Validates if a string represents a valid age between 0 and 120.
+ * @param {string} age The age to validate.
+ * @returns {boolean} True if the age is valid, otherwise false.
  */
-function objectToFormDataEnhanced(obj, formData = new FormData(), parentKey = '') {
-    Object.entries(obj).forEach(([key, value]) => {
-        const finalKey = parentKey ? `${parentKey}[${key}]` : key;
-        if (value && typeof value === 'object' && !(value instanceof File)) {
-            objectToFormDataEnhanced(value, formData, finalKey);
-        }
-        else {
-            formData.append(finalKey, value);
-        }
-    });
-    return formData;
+function isValidAge(age) {
+    const ageNumber = parseInt(age, 10);
+    return !isNaN(ageNumber) && ageNumber >= 0 && ageNumber <= 120;
 }
 // Example usage:
-// objectToFormDataEnhanced({ user: { name: 'John', age: 30 } });
+// console.log(isValidAge('25')); // true
+// console.log(isValidAge('121')); // false
 /**
- * Converts a JavaScript object into FormData.
- *
- * @param obj - The object to be converted.
- * @param form - An optional FormData instance to use.
- * @param namespace - An optional namespace to use for nested objects.
- * @returns The FormData instance with the object's key-value pairs.
+ * Validates if a string is a valid hexadecimal number.
+ * @param {string} hex The hexadecimal number to validate.
+ * @returns {boolean} True if the number is valid, otherwise false.
  */
-const objectToFormData = function (obj, form, namespace) {
-    const fd = form || new FormData();
-    let formKey;
-    for (const property in obj) {
-        if (obj[property] === undefined) {
-            continue;
-        }
-        if (Object.prototype.hasOwnProperty.call(obj, property)) {
-            if (namespace) {
-                formKey = `${namespace}[${property}]`;
-            }
-            else {
-                formKey = property;
-            }
-            if (typeof obj[property] === 'object' && !(obj[property] instanceof File)) {
-                // Recursively handle nested objects
-                objectToFormData(obj[property], fd, formKey);
-            }
-            else {
-                // Convert boolean values to 1/0
-                const value = obj[property] === true || obj[property] === false ? Number(obj[property]) : obj[property];
-                fd.append(formKey, value);
-            }
-        }
-    }
-    return fd;
+function isValidHexNumber(hex) {
+    const hexPattern = /^[0-9A-Fa-f]+$/;
+    return hexPattern.test(hex);
+}
+// Example usage:
+// console.log(isValidHexNumber('1A3F')); // true
+// console.log(isValidHexNumber('GHIJ')); // false
+
+/**
+ * Object defining available screen sizes as constants.
+ * @readonly
+ */
+const sizeEnum = {
+    XS: 'XS',
+    SM: 'SM',
+    MD: 'MD',
+    LG: 'LG',
+    XL: 'XL',
+    XXL: 'XXL',
+};
+/**
+ * Object defining breakpoints for design based on screen width.
+ * Values are in pixels.
+ * @readonly
+ */
+const screenEnum = {
+    XS: 480,
+    SM: 576,
+    MD: 768,
+    LG: 992,
+    XL: 1200,
+    XXL: 1600,
+};
+/**
+ * Map that associates each screen size defined in `sizeEnum` with its corresponding pixel value from `screenEnum`.
+ * @type {Map<typeof sizeEnum[keyof typeof sizeEnum], number>}
+ */
+const screenMap = new Map();
+screenMap.set(sizeEnum.XS, screenEnum.XS);
+screenMap.set(sizeEnum.SM, screenEnum.SM);
+screenMap.set(sizeEnum.MD, screenEnum.MD);
+screenMap.set(sizeEnum.LG, screenEnum.LG);
+screenMap.set(sizeEnum.XL, screenEnum.XL);
+screenMap.set(sizeEnum.XXL, screenEnum.XXL);
+
+/**
+ * Object defining various exception codes.
+ * @readonly
+ */
+const ExceptionEnum = {
+    /**
+     * HTTP status code for page access forbidden.
+     */
+    PAGE_NOT_ACCESS: 403,
+    /**
+     * HTTP status code for page not found.
+     */
+    PAGE_NOT_FOUND: 404,
+    /**
+     * HTTP status code for general server error.
+     */
+    ERROR: 500,
+    /**
+     * HTTP status code for bad request.
+     */
+    BAD_REQUEST: 406,
+    /**
+     * Custom error code for network errors.
+     */
+    NET_WORK_ERROR: 10000,
+    /**
+     * Custom code indicating no data on the page, not actually an exception page.
+     */
+    PAGE_NOT_DATA: 10100,
+};
+
+/**
+ * Object defining various image MIME types.
+ * @readonly
+ */
+const ImageTypes = {
+    apng: 'image/apng',
+    bmp: 'image/bmp',
+    gif: 'image/gif',
+    jpeg: 'image/jpeg',
+    pjpeg: 'image/pjpeg',
+    png: 'image/png',
+    svg: 'image/svg+xml',
+    tiff: 'image/tiff',
+    webp: 'image/webp',
+    xicon: 'image/x-icon',
+};
+/**
+ * Object defining various file meta types.
+ * @readonly
+ */
+const FileMetaTypes = {
+    images: 'image/*',
+    audios: 'audio/*',
+    videos: 'video/*',
+};
+
+/**
+ * Object representing different content types for HTTP headers.
+ * @readonly
+ */
+const ContentTypeEnum = {
+    /**
+     * Content type for JSON.
+     * @constant
+     */
+    JSON: 'application/json;charset=UTF-8',
+    /**
+     * Content type for URL-encoded form data.
+     * @constant
+     */
+    FORM_URLENCODED: 'application/x-www-form-urlencoded;charset=UTF-8',
+    /**
+     * Content type for multipart form data with file uploads.
+     * @constant
+     */
+    FORM_DATA: 'multipart/form-data;charset=UTF-8',
 };
+
 /**
- * Flattens a nested object, bringing all properties to the top level.
- * @param {Object} obj The object to flatten.
- * @param {string} [parentKey] The parent key for nested properties.
- * @param {Object} [result] The resulting flattened object.
- * @returns {Object} The flattened object.
+ * Object defining various key codes for keyboard events.
+ * @readonly
  */
-function flattenObject(obj, parentKey = '', result = {}) {
-    for (const key in obj) {
-        if (obj.hasOwnProperty(key)) {
-            const propName = parentKey ? `${parentKey}.${key}` : key;
-            if (typeof obj[key] === 'object' && obj[key] !== null) {
-                flattenObject(obj[key], propName, result);
-            }
-            else {
-                result[propName] = obj[key];
-            }
-        }
-    }
-    return result;
-}
-// Example usage:
-// flattenObject({ a: 1, b: { c: 2, d: { e: 3 } } }); // { 'a': 1, 'b.c': 2, 'b.d.e': 3 }
+const KeyCodeEnum = {
+    UP: 38,
+    DOWN: 40,
+    ENTER: 13,
+    ESC: 27,
+};
 
 /**
- * Capitalizes the first character of a string.
- * @param {string} s The string to capitalize.
- * @returns {string} The capitalized string.
+ * Key used for storing the authentication token.
+ * @constant {string}
  */
-function upperFirst(s) {
-    return s.charAt(0).toUpperCase() + s.slice(1);
-}
-// Example usage:
-// console.log(upperFirst('hello')); // 'Hello'
+const TOKEN_KEY = 'TOKEN__';
 /**
- * Lowercases the first character of a string.
- * @param {string} s The string to lowercase.
- * @returns {string} The lowercased string.
+ * Key used for storing the locale information.
+ * @constant {string}
  */
-function lowerFirst(s) {
-    return s.charAt(0).toLowerCase() + s.slice(1);
-}
-// Example usage:
-// console.log(lowerFirst('Hello')); // 'hello'
+const LOCALE_KEY = 'LOCALE__';
 /**
- * Removes accents and special characters from a string and converts it to a URL-friendly format.
- * @param {string} input The string to process.
- * @returns {string} The processed string.
+ * Key used for storing user information.
+ * @constant {string}
  */
-function removeAccent(input) {
-    return input
-        .toLowerCase()
-        .trim()
-        .replace(/[\s_-]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .normalize("NFD")
-        .replace(/[\u0300-\u036f]/g, "");
-}
-// Example usage:
-// console.log(removeAccent('Café du Nord')); // 'cafe-du-nord'
+const USER_INFO_KEY = 'USER__INFO__';
 /**
- * Reverses a string.
- * @param {string} str The string to reverse.
- * @returns {string} The reversed string.
+ * Key used for storing role information.
+ * @constant {string}
  */
-function reverseString(str) {
-    return str.split('').reverse().join('');
+const ROLES_KEY = 'ROLES__KEY__';
+/**
+ * Key used for storing project configuration.
+ * @constant {string}
+ */
+const PROJ_CFG_KEY = 'PROJ__CFG__KEY__';
+/**
+ * Key used for storing lock information.
+ * @constant {string}
+ */
+const LOCK_INFO_KEY = 'LOCK__INFO__KEY__';
+/**
+ * Key used for base global local cache.
+ * @constant {string}
+ */
+const APP_LOCAL_CACHE_KEY = 'COMMON__LOCAL__KEY';
+/**
+ * Key used for base global session cache.
+ * @constant {string}
+ */
+const APP_SESSION_CACHE_KEY = 'COMMON__SESSION__KEY';
+/**
+ * Object defining types of cache storage.
+ * @readonly
+ */
+const CacheTypeEnum = {
+    /** Represents session storage */
+    SESSION: 0,
+    /** Represents local storage */
+    LOCAL: 1,
+};
+
+const ERROR_MESSAGES = {
+    warning: 'Algo no está del todo bien. Verifica y vuelve a intentar.',
+    error: 'Ocurrió un error inesperado.',
+    critical: 'Error crítico. Contacta al soporte técnico.',
+    validation: 'Hay errores en el formulario. Revisa los campos.',
+    component: 'Error en la carga del componente. Intenta recargar.',
+    network: 'Problema de conexión. Verifica tu internet.',
+    authentication: 'No tienes permisos para realizar esta acción.',
+    runtime: 'Error de ejecución. Intenta nuevamente.',
+    type: 'Tipo de error no identificado.',
+    reference: 'Referencia no válida.',
+    syntax: 'Error de sintaxis en el código.',
+    range: 'Error en el rango de valores.',
+    eval: 'Error en la evaluación.',
+    uri: 'URI no válida.',
+};
+const ERROR_STYLES = {
+    warning: 'color: orange; font-weight: bold;',
+    error: 'color: red; font-weight: bold;',
+    critical: 'color: white; background-color: red; font-weight: bold; padding: 2px;',
+    validation: 'color: blue; font-weight: bold;',
+    component: 'color: purple; font-weight: bold;',
+    network: 'color: cyan; font-weight: bold;',
+    authentication: 'color: brown; font-weight: bold;',
+    runtime: 'color: darkred; font-weight: bold;',
+    type: 'color: gray; font-weight: bold;',
+    reference: 'color: darkorange; font-weight: bold;',
+    syntax: 'color: darkblue; font-weight: bold;',
+    range: 'color: darkgreen; font-weight: bold;',
+    eval: 'color: darkviolet; font-weight: bold;',
+    uri: 'color: darkcyan; font-weight: bold;',
+};
+
+class RestStd {
+    static resource;
+    static isFormData = false;
+    static headers = {};
+    static fetchComposable;
+    /**
+     * Set global headers for all requests.
+     * @param headers Object containing headers to be set globally.
+     */
+    static setHeaders(headers) {
+        this.headers = { ...this.headers, ...headers };
+    }
+    /**
+     * Convert data to FormData if isFormData is true, otherwise return the data as is.
+     * @param data Data to be converted.
+     * @returns Data in FormData format or as is.
+     */
+    static transformData(data) {
+        if (this.isFormData) {
+            const formData = objectToFormData(data);
+            return formData;
+        }
+        return data;
+    }
+    /**
+     * Fetch a list of items from the server.
+     *
+     * @param params Query parameters for filtering the results.
+     * @param options Additional options for the fetch composable.
+     * @returns The result of the fetch composable (typically a promise).
+     */
+    static getMany(params, options = {}) {
+        return this.fetchComposable({
+            method: 'GET',
+            url: this.resource,
+            params,
+            headers: this.headers,
+        }, options);
+    }
+    /**
+     * Fetch a single item by ID from the server.
+     *
+     * @param id The ID of the item to fetch.
+     * @param params Additional query parameters for the request.
+     * @param options Additional options for the fetch composable.
+     * @returns The result of the fetch composable (typically a promise).
+     */
+    static getOne(id, params, options = {}) {
+        return this.fetchComposable({
+            method: 'GET',
+            url: `${this.resource}/${id}`,
+            params,
+            headers: this.headers,
+        }, options);
+    }
+    /**
+     * Create a new item on the server.
+     *
+     * @param data The data for the new item to create.
+     * @param options Additional options for the fetch composable.
+     * @returns The result of the fetch composable (typically a promise).
+     */
+    static create(data, options = {}) {
+        const transformedData = this.transformData(data);
+        return this.fetchComposable({
+            method: 'POST',
+            url: this.resource,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
+    /**
+     * Update an existing item on the server.
+     *
+     * @param id The ID of the item to update.
+     * @param data The updated data for the item.
+     * @param options Additional options for the fetch composable.
+     * @returns The result of the fetch composable (typically a promise).
+     */
+    static update(id, data, options = {}) {
+        const transformedData = this.transformData(data);
+        return this.fetchComposable({
+            method: 'PUT',
+            url: `${this.resource}/${id}`,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
+    /**
+     * Partially update an existing item on the server.
+     *
+     * @param id The ID of the item to update.
+     * @param data The updated data for the item.
+     * @param options Additional options for the fetch composable.
+     * @returns The result of the fetch composable (typically a promise).
+     */
+    static patch(id, data, options = {}) {
+        const transformedData = this.transformData(data);
+        return this.fetchComposable({
+            method: 'PATCH',
+            url: `${this.resource}/${id}`,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
+    /**
+     * Delete an item from the server.
+     *
+     * @param id The ID of the item to delete.
+     * @param options Additional options for the fetch composable.
+     * @returns The result of the fetch composable (typically a promise).
+     */
+    static delete(id, options = {}) {
+        return this.fetchComposable({
+            method: 'DELETE',
+            url: `${this.resource}/${id}`,
+            headers: this.headers,
+        }, options);
+    }
+    /**
+     * Custom request method for more flexibility.
+     *
+     * @param method HTTP method (GET, POST, etc.).
+     * @param params Query parameters.
+     * @param data Request body data.
+     * @param options Additional options for the fetch composable.
+     * @returns The result of the fetch composable (typically a promise).
+     */
+    static customRequest(method, params, data, options = {}) {
+        const transformedData = this.transformData(data);
+        return this.fetchComposable({
+            method: method,
+            url: this.resource,
+            params: params,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
+    /**
+     * Save method that decides whether to create or update based on the presence of 'id'.
+     * It calls either create or update based on the data.
+     *
+     * @param data The data for the item to create or update.
+     * @param options Additional options for the fetch composable.
+     * @returns The result of the fetch composable (typically a promise).
+     */
+    static save(data, options = {}) {
+        if (data.id) {
+            return this.update(data.id, data, options);
+        }
+        else {
+            return this.create(data, options);
+        }
+    }
 }
-// Example usage:
-// console.log(reverseString('hello')); // 'olleh'
+
 /**
- * Counts the number of words in a string.
- * @param {string} str The string to analyze.
- * @returns {number} The word count.
+ * Custom composable function for making API requests with Axios.
+ *
+ * @template T The expected return type of the API request.
+ * @param {AxiosInstance} axios - The Axios instance for making HTTP requests.
+ * @param {AxiosRequestConfig} axiosRequest - Configuration for the Axios request.
+ * @returns {Promise<T>} A promise with the result of the API request.
  */
-function countWords(str) {
-    return str.trim().split(/\s+/).length;
+async function axiosFetch(axios, axiosRequest) {
+    return axios(axiosRequest)
+        .then(response => response.data)
+        .catch(error => {
+        throw error;
+    });
 }
-// Example usage:
-// console.log(countWords('Hello world!')); // 2
+
 /**
- * Truncates a string to the specified length and adds ellipsis if necessary.
- * @param {string} str The string to truncate.
- * @param {number} maxLength The maximum length of the string.
- * @returns {string} The truncated string.
- */
-function truncateString(str, maxLength) {
-    return str.length > maxLength ? str.slice(0, maxLength) + '...' : str;
+ * Maneja y registra errores en la consola, además de permitir redirecciones configurables.
+ * @param error - Error capturado (string o Error)
+ * @param redirect - `true` si se quiere redirigir a una página de error
+ * @param route - Ruta personalizada para la página de error (por defecto: `/error`)
+ * @param passMethod - Método para pasar el error a la ruta (`query`, `localStorage`, `sessionStorage`)
+ * @returns Mensaje user-friendly del error
+ */
+function handleError(error, redirect = false, route = '/error', passMethod = 'query') {
+    if (!(error instanceof Error)) {
+        console.error("Unrecognized error:", error);
+        return;
+    }
+    const router = useRouter();
+    const type = inferErrorType(error);
+    const message = ERROR_MESSAGES[type] || 'Error desconocido.';
+    // Mostrar el error en la consola con estilos
+    console.log(`%c[${type.toUpperCase()}] ${message}`, ERROR_STYLES[type]);
+    // Pasar el error según el método elegido
+    if (redirect) {
+        if (passMethod === 'query') {
+            router.push({ path: route, query: { errorMessage: encodeURIComponent(message) } });
+        }
+        else if (passMethod === 'localStorage') {
+            localStorage.setItem('errorMessage', message);
+            router.push(route);
+        }
+        else if (passMethod === 'sessionStorage') {
+            sessionStorage.setItem('errorMessage', message);
+            router.push(route);
+        }
+    }
+    return message;
+}
+/**
+ * Infiera el tipo de error basado en su mensaje o nombre.
+ * @param error - El error que se desea analizar.
+ * @returns El tipo de error determinado.
+ */
+function inferErrorType(error) {
+    const msg = typeof error === 'string' ? error : error.message;
+    if (typeof error === 'string')
+        return 'error';
+    if (error.name === 'ValidationError')
+        return 'validation';
+    if (error.name === 'NetworkError' || msg.includes('Network'))
+        return 'network';
+    if (error.name === 'AuthenticationError' || msg.includes('Unauthorized'))
+        return 'authentication';
+    if (msg.includes('Component'))
+        return 'component';
+    if (msg.includes('Runtime'))
+        return 'runtime';
+    return 'error';
 }
-// Example usage:
-// console.log(truncateString('This is a long string', 10)); // 'This is a...'
+
+let tokenConfig = {
+    ACCESS_TOKEN: 'authToken',
+    REFRESH_TOKEN: 'refreshToken',
+};
 /**
- * Converts a string to camel case.
- * @param {string} str The string to convert.
- * @returns {string} The camel cased string.
+ * Función para configurar las claves globalmente.
+ * Esta función congela el objeto para evitar modificaciones posteriores.
+ * @param {string} accessTokenKey - Nombre de la clave del token de acceso
+ * @param {string} refreshTokenKey - Nombre de la clave del refresh token
  */
-function toCamelCase(str) {
-    return str
-        .toLowerCase()
-        .replace(/[^a-zA-Z0-9]+(.)/g, (match, chr) => chr.toUpperCase());
+function configureTokenKeys(accessTokenKey, refreshTokenKey) {
+    tokenConfig = Object.freeze({
+        ACCESS_TOKEN: accessTokenKey,
+        REFRESH_TOKEN: refreshTokenKey,
+    });
 }
-// Example usage:
-// console.log(toCamelCase('hello world example')); // 'helloWorldExample'
 /**
- * Converts a string to kebab case.
- * @param {string} str The string to convert.
- * @returns {string} The kebab cased string.
+ * Obtiene las claves configuradas para los tokens.
+ * El objeto está congelado, por lo que no se puede modificar directamente.
  */
-function toKebabCase(str) {
-    return str
-        .replace(/([a-z])([A-Z])/g, '$1-$2')
-        .replace(/[\s_]+/g, '-')
-        .toLowerCase();
+function getTokenConfig() {
+    return tokenConfig;
 }
-// Example usage:
-// console.log(toKebabCase('Hello World Example')); // 'hello-world-example'
+
+let endpointsConfig = {
+    LOGIN: '/login',
+    REFRESH: '/refresh',
+    LOGOUT: '/logout',
+};
 /**
- * Replaces all instances of a substring within a string.
- * @param {string} str The original string.
- * @param {string} find The substring to find.
- * @param {string} replace The substring to replace with.
- * @returns {string} The modified string.
+ * Configura las URLs de los endpoints de autenticación globalmente.
+ * Esta función congela el objeto para evitar modificaciones posteriores.
+ *
+ * @param {string} loginEndpoint - URL del endpoint para el login.
+ * @param {string} refreshEndpoint - URL del endpoint para el refresh token.
+ * @param {string} logoutEndpoint - URL del endpoint para el logout.
+ *
+ * @returns {void} No retorna nada, pero congela el objeto de configuración de endpoints.
  */
-function replaceAll(str, find, replace) {
-    return str.split(find).join(replace);
+function configureEndpoints(loginEndpoint, refreshEndpoint, logoutEndpoint) {
+    endpointsConfig = Object.freeze({
+        LOGIN: loginEndpoint,
+        REFRESH: refreshEndpoint,
+        LOGOUT: logoutEndpoint,
+    });
 }
-// Example usage:
-// console.log(replaceAll('hello world', 'o', 'a')); // 'hella warld'
 /**
- * Generates a random string of a specific length.
- * @param {number} length The length of the string to generate.
- * @returns {string} The random string.
+ * Obtiene las URLs de los endpoints de autenticación configurados.
+ *
+ * @returns {Object} Objeto con las URLs de los endpoints configurados.
+ * @returns {string} returns.LOGIN - URL del endpoint de login.
+ * @returns {string} returns.REFRESH - URL del endpoint de refresh token.
+ * @returns {string} returns.LOGOUT - URL del endpoint de logout.
  */
-function generateRandomString(length) {
-    const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-    return Array.from({ length }, () => characters.charAt(Math.floor(Math.random() * characters.length))).join('');
+function getEndpointsConfig() {
+    return endpointsConfig;
 }
-// Example usage:
-// console.log(generateRandomString(10)); // 'A1b2C3d4E5'
 
 /**
- * Validates if the key pressed is a valid letter or special character.
- * @param {KeyboardEvent} e The keyboard event.
- * @returns {boolean} True if the key is valid, otherwise false.
+ * AxiosService class encapsulates the Axios configuration and logic.
+ * It manages request and response interceptors and provides methods for making HTTP requests.
  */
-function validateLetters(e) {
-    const key = e.keyCode;
-    const validKeys = [
-        ...Array.from({ length: 26 }, (_, i) => i + 65), // Letters A-Z
-        ...Array.from({ length: 26 }, (_, i) => i + 97), // Letters a-z
-        45, // Hyphen
-        32, // Space
-        241, // ñ
-        209, // Ñ
-        225, // á
-        233, // é
-        237, // í
-        243, // ó
-        250, // ú
-        193, // Á
-        201, // É
-        205, // Í
-        211, // Ó
-        218 // Ú
-    ];
-    if (validKeys.includes(key)) {
-        return true;
+class AxiosService {
+    instance;
+    cancelTokenSource;
+    activeRequests = 0;
+    refreshTokenInProgress = false;
+    refreshTokenUrl;
+    /**
+     * Initializes the AxiosService instance by creating an Axios instance with default configuration
+     * and setting up request and response interceptors.
+     */
+    constructor(url, headers = {}) {
+        this.cancelTokenSource = axios.CancelToken.source();
+        this.instance = axios.create({
+            baseURL: url ?? '',
+            timeout: 300000,
+            headers: {
+                'Accept': 'application/json',
+                'Cache-Control': 'no-store, no-cache, must-revalidate, proxy-revalidate',
+                'Pragma': 'no-cache',
+                'Expires': '0',
+                ...headers,
+            },
+            withCredentials: false,
+        });
+        const endpointsConfig = getEndpointsConfig();
+        this.refreshTokenUrl = endpointsConfig.REFRESH;
+        this.initializeInterceptors();
     }
-    e.preventDefault();
-    return false;
-}
-// Example usage:
-// document.addEventListener('keydown', validateLetters);
-/**
- * Validates if the key pressed is a valid alphanumeric character.
- * @param {KeyboardEvent} e The keyboard event.
- * @returns {boolean} True if the key is valid, otherwise false.
- */
-function validateAlphanumeric(e) {
-    const key = e.keyCode;
-    const validKeys = [
-        ...Array.from({ length: 10 }, (_, i) => i + 48), // Numbers 0-9
-        ...Array.from({ length: 26 }, (_, i) => i + 65), // Letters A-Z
-        ...Array.from({ length: 26 }, (_, i) => i + 97), // Letters a-z
-        45, // Hyphen
-        95, // Underscore
-        32 // Space
-    ];
-    if (validKeys.includes(key)) {
-        return true;
+    /**
+     * Initializes request and response interceptors for the Axios instance.
+     */
+    initializeInterceptors() {
+        const { ACCESS_TOKEN, REFRESH_TOKEN } = getTokenConfig();
+        this.instance.interceptors.request.use((config) => {
+            const token = typeof window !== 'undefined' ? localStorage.getItem(ACCESS_TOKEN) : null;
+            if (token && config.headers) {
+                config.headers.Authorization = `Bearer ${token}`;
+            }
+            config.cancelToken = this.cancelTokenSource.token;
+            this.activeRequests++;
+            return config;
+        }, (error) => {
+            handleError(error, false);
+            this.activeRequests++;
+            return Promise.reject(error);
+        });
+        this.instance.interceptors.response.use((response) => {
+            this.activeRequests--;
+            return response;
+        }, async (error) => {
+            this.activeRequests--;
+            // Check for unauthorized access (401)
+            if (axios.isAxiosError(error) && error.response?.status === 401 && !this.refreshTokenInProgress) {
+                const refreshToken = localStorage.getItem(REFRESH_TOKEN);
+                if (refreshToken) {
+                    this.refreshTokenInProgress = true;
+                    try {
+                        // Attempt to refresh the token
+                        const refreshResponse = await axios.post(this.refreshTokenUrl, { refreshToken });
+                        const { token: newAccessToken } = refreshResponse.data;
+                        if (newAccessToken) {
+                            // Save the new access token
+                            localStorage.setItem(ACCESS_TOKEN, newAccessToken);
+                            // Retry the original request with the new token
+                            if (error.config && error.config.headers) {
+                                error.config.headers['Authorization'] = `Bearer ${newAccessToken}`;
+                            }
+                            this.refreshTokenInProgress = false;
+                            if (error.config) {
+                                return this.instance(error.config);
+                            }
+                        }
+                    }
+                    catch (refreshError) {
+                        handleError(refreshError, false);
+                        this.refreshTokenInProgress = false;
+                        localStorage.removeItem(ACCESS_TOKEN);
+                        localStorage.removeItem(REFRESH_TOKEN);
+                    }
+                }
+            }
+            handleError(error, false);
+            return Promise.reject(error);
+        });
     }
-    e.preventDefault();
-    return false;
-}
-// Example usage:
-// document.addEventListener('keydown', validateAlphanumeric);
-/**
- * Validates if the key pressed is a number.
- * @param {KeyboardEvent} e The keyboard event.
- * @returns {boolean} True if the key is a number, otherwise false.
- */
-function validateNumbers(e) {
-    const key = e.keyCode;
-    if ((key >= 48 && key <= 57) || key === 46 || key === 8 || key === 37 || key === 39) {
-        return true;
+    /**
+     * Returns the number of active requests.
+     */
+    getActiveRequests() {
+        return this.activeRequests;
     }
-    e.preventDefault();
-    return false;
-}
-// Example usage:
-// document.addEventListener('keydown', validateNumbers);
-/**
- * Validates if a phone number is valid.
- * @param {string} phoneNumber The phone number to validate.
- * @returns {boolean} True if the phone number is valid, otherwise false.
- */
-function isValidPhoneNumber(phoneNumber) {
-    const phonePattern = /^[0-9]{10}$/; // Example pattern for 10-digit phone numbers
-    return phonePattern.test(phoneNumber);
-}
-// Example usage:
-// console.log(isValidPhoneNumber('1234567890')); // true
-// console.log(isValidPhoneNumber('123-456-7890')); // false
-/**
- * Validates if a string is a valid email address.
- * @param {string} email The email address to validate.
- * @returns {boolean} True if the email address is valid, otherwise false.
- */
-function isValidEmail(email) {
-    const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-    return emailPattern.test(email);
-}
-// Example usage:
-// console.log(isValidEmail('example@domain.com')); // true
-// console.log(isValidEmail('invalid-email')); // false
-/**
- * Validates if a string is a valid URL.
- * @param {string} url The URL to validate.
- * @returns {boolean} True if the URL is valid, otherwise false.
- */
-function isValidURL(url) {
-    try {
-        new URL(url);
-        return true;
+    /**
+     * Returns the Axios instance with the configured settings and interceptors.
+     * @returns {AxiosInstance} The configured Axios instance.
+     */
+    getAxiosInstance() {
+        return this.instance;
     }
-    catch {
-        return false;
+    /**
+     * Cancels all ongoing requests.
+     */
+    cancelAllRequests() {
+        this.cancelTokenSource.cancel('Operation canceled by the user.');
+        this.cancelTokenSource = axios.CancelToken.source();
+    }
+    /**
+     * Sets a new header for the Axios instance.
+     * @param {string} key - The header key.
+     * @param {string} value - The header value.
+     */
+    setHeader(key, value) {
+        this.instance.defaults.headers.common[key] = value;
+    }
+    /**
+     * Removes a header from the Axios instance.
+     * @param {string} key - The header key to remove.
+     */
+    removeHeader(key) {
+        delete this.instance.defaults.headers.common[key];
     }
 }
-// Example usage:
-// console.log(isValidURL('https://www.example.com')); // true
-// console.log(isValidURL('invalid-url')); // false
-/**
- * Validates if a string is a valid date in YYYY-MM-DD format.
- * @param {string} date The date string to validate.
- * @returns {boolean} True if the date is valid, otherwise false.
- */
-function isValidDate(date) {
-    const datePattern = /^\d{4}-\d{2}-\d{2}$/;
-    if (!datePattern.test(date))
-        return false;
-    const [year, month, day] = date.split('-').map(Number);
-    const dateObj = new Date(year, month - 1, day);
-    return dateObj.getFullYear() === year && dateObj.getMonth() === month - 1 && dateObj.getDate() === day;
-}
-// Example usage:
-// console.log(isValidDate('2024-08-31')); // true
-// console.log(isValidDate('2024-02-30')); // false
+
+let axiosInstance;
 /**
- * Validates if a password meets certain strength criteria.
- * @param {string} password The password to validate.
- * @returns {boolean} True if the password is strong, otherwise false.
+ * Configures the global Axios instance with a base URL.
+ * @param {string} baseURL - The base URL for the Axios instance.
  */
-function isStrongPassword(password) {
-    const minLength = 8;
-    const hasUpperCase = /[A-Z]/.test(password);
-    const hasLowerCase = /[a-z]/.test(password);
-    const hasNumbers = /[0-9]/.test(password);
-    const hasSpecialChars = /[!@#$%^&*(),.?":{}|<>]/.test(password);
-    return password.length >= minLength && hasUpperCase && hasLowerCase && hasNumbers && hasSpecialChars;
-}
-// Example usage:
-// console.log(isStrongPassword('Strong1@password')); // true
-// console.log(isStrongPassword('weakpass')); // false
+const configureAxios = (baseURL) => {
+    axiosInstance = new AxiosService(baseURL);
+};
 /**
- * Validates a credit card number using the Luhn algorithm.
- * @param {string} cardNumber The credit card number to validate.
- * @returns {boolean} True if the credit card number is valid, otherwise false.
+ * Retrieves the configured Axios instance.
+ * @returns {AxiosService} The configured Axios instance.
+ * @throws Will throw an error if the Axios instance is not configured.
  */
-function isValidCreditCard(cardNumber) {
-    const sanitized = cardNumber.replace(/\D/g, '');
-    let sum = 0;
-    let shouldDouble = false;
-    for (let i = sanitized.length - 1; i >= 0; i--) {
-        let digit = parseInt(sanitized.charAt(i), 10);
-        if (shouldDouble) {
-            digit *= 2;
-            if (digit > 9)
-                digit -= 9;
-        }
-        sum += digit;
-        shouldDouble = !shouldDouble;
+const getAxiosInstance = () => {
+    if (!axiosInstance) {
+        throw new Error('Axios instance not configured. Call configureAxios first.');
     }
-    return sum % 10 === 0;
-}
-// Example usage:
-// console.log(isValidCreditCard('4111111111111111')); // true
-// console.log(isValidCreditCard('1234567812345670')); // false
-/**
- * Validates if a string is a valid hex color code.
- * @param {string} color The color code to validate.
- * @returns {boolean} True if the color code is valid, otherwise false.
- */
-function isValidHexColor(color) {
-    const hexPattern = /^#([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})$/;
-    return hexPattern.test(color);
-}
-// Example usage:
-// console.log(isValidHexColor('#FFFFFF')); // true
-// console.log(isValidHexColor('#FFF')); // true
-// console.log(isValidHexColor('#12345G')); // false
-/**
- * Validates if a string is a valid time in HH:MM format.
- * @param {string} time The time string to validate.
- * @returns {boolean} True if the time is valid, otherwise false.
- */
-function isValidTime(time) {
-    const timePattern = /^([01]\d|2[0-3]):([0-5]\d)$/;
-    return timePattern.test(time);
-}
-// Example usage:
-// console.log(isValidTime('14:30')); // true
-// console.log(isValidTime('25:00')); // false
-/**
- * Validates if a string is a valid IPv4 address.
- * @param {string} ip The IP address to validate.
- * @returns {boolean} True if the IP address is valid, otherwise false.
- */
-function isValidIP(ip) {
-    const ipPattern = /^(25[0-5]|2[0-4][0-9]|[0-1]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[0-1]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[0-1]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[0-1]?[0-9][0-9]?)$/;
-    return ipPattern.test(ip);
-}
-// Example usage:
-// console.log(isValidIP('192.168.1.1')); // true
-// console.log(isValidIP('999.999.999.999')); // false
+    return axiosInstance.getAxiosInstance();
+};
 /**
- * Validates if a string is a valid U.S. Social Security Number (SSN).
- * @param {string} ssn The SSN to validate.
- * @returns {boolean} True if the SSN is valid, otherwise false.
+ * Creates a new AxiosService instance with custom headers.
+ * @param {string} baseURL - The base URL for the Axios instance.
+ * @param {Record<string, string>} headers - Custom headers to set.
+ * @returns {AxiosService} The new AxiosService instance.
  */
-function isValidSSN(ssn) {
-    const ssnPattern = /^\d{3}-\d{2}-\d{4}$/;
-    return ssnPattern.test(ssn);
-}
-// Example usage:
-// console.log(isValidSSN('123-45-6789')); // true
-// console.log(isValidSSN('123-45-678')); // false
+const createCustomAxiosInstance = (baseURL, headers) => {
+    return new AxiosService(baseURL, headers).getAxiosInstance();
+};
+
 /**
- * Validates if a string is a valid U.S. ZIP code.
- * @param {string} zip The ZIP code to validate.
- * @returns {boolean} True if the ZIP code is valid, otherwise false.
+ * Creates a fetchComposable for Axios requests with an optional custom instance.
+ * @param fetchComposable - The composable to use for the request (can be any fetch function).
+ * @param axiosCustomInstance - An optional custom Axios instance to use for the request.
+ * @returns A function that handles the request using the provided composable.
  */
-function isValidZIP(zip) {
-    const zipPattern = /^\d{5}(-\d{4})?$/;
-    return zipPattern.test(zip);
+function createFetch(fetchComposable, axiosCustomInstance) {
+    const instance = axiosCustomInstance || getAxiosInstance();
+    return (axiosRequestConfig, options) => {
+        return fetchComposable(instance, axiosRequestConfig, options);
+    };
 }
-// Example usage:
-// console.log(isValidZIP('12345')); // true
-// console.log(isValidZIP('12345-6789')); // true
-// console.log(isValidZIP('1234')); // false
+
 /**
- * Validates if a string is a valid credit card expiry date in MM/YY format.
- * @param {string} expiryDate The expiry date to validate.
- * @returns {boolean} True if the expiry date is valid, otherwise false.
+ * Custom composable for integrating Axios requests with Vue Query.
+ *
+ * @template T - The type of data expected from the query.
+ * @param {AxiosInstance} axios - Axios instance used for making HTTP requests.
+ * @param {AxiosRequestConfig} axiosRequest - Initial Axios request configuration.
+ * @param {ExtendedQueryOptions<T>} [queryOptions] - Optional Vue Query options with server execution flag.
+ * @returns {object} Composable functions and query state for managing API requests.
  */
-function isValidExpiryDate(expiryDate) {
-    const expiryPattern = /^(0[1-9]|1[0-2])\/\d{2}$/;
-    if (!expiryPattern.test(expiryDate))
-        return false;
-    const [month, year] = expiryDate.split('/').map(Number);
-    const currentYear = new Date().getFullYear() % 100;
-    const currentMonth = new Date().getMonth() + 1;
-    return (year > currentYear) || (year === currentYear && month >= currentMonth);
+function useVueQuery(axios, axiosRequest, queryOptions) {
+    const key = ref([
+        queryOptions?.queryKey || `${axiosRequest.url}-${JSON.stringify(axiosRequest)}`
+    ]);
+    const axiosRequestRef = ref(axiosRequest);
+    const queryOptionsRef = ref(queryOptions);
+    const isInitialized = ref(false);
+    const errorCallbacks = ref([]);
+    const resultCallbacks = ref([]);
+    /**
+     * Vue Query instance for managing API requests.
+     */
+    const query = useQuery({
+        queryKey: key.value,
+        queryFn: async () => {
+            const response = await axios(axiosRequestRef.value);
+            return response.data;
+        },
+        ...(queryOptionsRef.value?.options ?? {})
+    });
+    /**
+     * Executes the query manually with optional new key and request parameters.
+     *
+     * @param {Array<any>} [newKey] - New query key to use.
+     * @param {object} [newRequestParams] - New request parameters to use.
+     * @param {ExtendedQueryOptions<T>} [newQueryOptions] - New Vue Query options to use.
+     */
+    function execute(newKey, newRequestParams, newQueryOptions) {
+        if (newKey) {
+            key.value = newKey;
+        }
+        if (newRequestParams) {
+            axiosRequestRef.value.data = newRequestParams;
+        }
+        if (newQueryOptions) {
+            queryOptionsRef.value = newQueryOptions;
+        }
+        query.refetch();
+    }
+    /**
+     * Registers a callback to be executed on successful request result.
+     * If data is already available, the callback will be executed immediately.
+     *
+     * @param {(data: T) => void} cb - Callback function to handle the result.
+     */
+    function onResult(cb) {
+        resultCallbacks.value.push(cb);
+        if (query.data.value !== undefined && query.data.value !== null) {
+            cb(query.data.value);
+        }
+    }
+    /**
+     * Registers a callback to be executed when the request results in an error.
+     * If an error is already present, the callback will be executed immediately.
+     *
+     * @param {(e: unknown) => void} callback - Callback function to handle errors.
+     */
+    function onError(callback) {
+        errorCallbacks.value.push(callback);
+        if (query.error.value !== undefined) {
+            callback(query.error.value);
+        }
+    }
+    /**
+     * Watches for changes in the query result and triggers result callbacks.
+     */
+    watch(query.data, (newData) => {
+        if (newData !== undefined && newData !== null && isInitialized.value) {
+            resultCallbacks.value.forEach((cb) => cb(newData));
+        }
+    });
+    /**
+     * Watches for changes in query errors and triggers error callbacks.
+     */
+    watch(query.error, (newError) => {
+        if (newError !== undefined && isInitialized.value) {
+            errorCallbacks.value.forEach((cb) => cb(newError));
+        }
+    });
+    /**
+     * Handles server-side prefetching for SSR.
+     * Ensures data is fetched before rendering on the server.
+     */
+    onServerPrefetch(async () => {
+        if (queryOptionsRef.value?.server !== false) {
+            await query.suspense();
+            if (query.data.value != null) {
+                resultCallbacks.value.forEach((cb) => cb(query.data.value));
+            }
+        }
+    });
+    /**
+     * Ensures callbacks are executed after the component is mounted on the client-side.
+     */
+    onMounted(() => {
+        isInitialized.value = true;
+        if (query.data.value != null) {
+            resultCallbacks.value.forEach((cb) => cb(query.data.value));
+        }
+        if (query.error.value !== undefined) {
+            errorCallbacks.value.forEach((cb) => cb(query.error.value));
+        }
+    });
+    return {
+        execute,
+        onResult,
+        onError,
+        ...query
+    };
 }
-// Example usage:
-// console.log(isValidExpiryDate('08/24')); // true
-// console.log(isValidExpiryDate('12/22')); // false
+
+let notified = false;
 /**
- * Validates if a string is a valid 8-character hexadecimal color code (including alpha).
- * @param {string} color The color code to validate.
- * @returns {boolean} True if the color code is valid, otherwise false.
+ * Composable to manage breakpoints using Tailwind CSS and shared window resize listener.
+ *
+ * @returns {Object} An object containing the breakpoints and their states.
  */
-function isValidHexColorAlpha(color) {
-    const hexPattern = /^#([0-9A-Fa-f]{8})$/;
-    return hexPattern.test(color);
+function useBreakpoint() {
+    const breakpoints = useBreakpoints(breakpointsTailwind);
+    const current = breakpoints.current();
+    const active = breakpoints.active();
+    // Define breakpoints
+    const sm_S = breakpoints.smaller('sm');
+    const sm_SE = breakpoints.smallerOrEqual('sm');
+    const sm_GE = breakpoints.greaterOrEqual('sm');
+    const sm_md = breakpoints.between('sm', 'md');
+    const sm_xl = breakpoints.between('sm', 'xl');
+    const sm_2xl = breakpoints.between('sm', '2xl');
+    const md_S = breakpoints.smaller('md');
+    const md_SE = breakpoints.smallerOrEqual('md');
+    const md_GE = breakpoints.greaterOrEqual('md');
+    const md_lg = breakpoints.between('md', 'lg');
+    const md_xl = breakpoints.between('md', 'xl');
+    const md_2xl = breakpoints.between('md', '2xl');
+    const lg_S = breakpoints.smaller('lg');
+    const lg_SE = breakpoints.smallerOrEqual('lg');
+    const lg_GE = breakpoints.greaterOrEqual('lg');
+    const lg_xl = breakpoints.between('lg', 'xl');
+    const lg_2xl = breakpoints.between('lg', '2xl');
+    const xl_S = breakpoints.smaller('xl');
+    const xl_SE = breakpoints.smallerOrEqual('xl');
+    const xl_GE = breakpoints.greaterOrEqual('xl');
+    const xl_2xl = breakpoints.between('xl', '2xl');
+    const _2xl_S = breakpoints.smaller('2xl');
+    const _2xl_SE = breakpoints.smallerOrEqual('2xl');
+    const _2xl_GE = breakpoints.greaterOrEqual('2xl');
+    const reactiveBreakpoint = ref('sm');
+    const isGreaterThanBreakpoint = breakpoints.greaterOrEqual(() => reactiveBreakpoint.value);
+    // Define device ranges
+    const mobile = breakpoints.smaller('md'); // <768px
+    const tablet = breakpoints.between('md', 'lg'); // 768px - 1024px
+    const laptop = breakpoints.between('lg', 'xl'); // 1024px - 1280px
+    const desktop = breakpoints.greaterOrEqual('xl'); // >=1280px
+    // Use VueUse for window size
+    const { width: windowWidth, height: windowHeight } = useWindowSize();
+    /**
+     * Logs a styled "chip" message to the console.
+     *
+     * @param {string} label - The label to display inside the chip.
+     * @param {string} backgroundColor - The background color of the chip.
+     * @param {string} textColor - The text color of the chip.
+     */
+    const logChip = (label, backgroundColor, textColor = 'white') => {
+        console.log(`%c ${label} `, `background-color: ${backgroundColor}; color: ${textColor}; border-radius: 16px; padding: 4px 8px;`);
+    };
+    // Singleton logic: Only notify once
+    const notifyOnce = () => {
+        if (notified)
+            return;
+        watch([mobile, tablet, laptop, desktop], ([isMobile, isTablet, isLaptop, isDesktop]) => {
+            if (isMobile) {
+                logChip('Mobile', '#ff6b6b');
+            }
+            else if (isTablet) {
+                logChip('Tablet', '#4ecdc4');
+            }
+            else if (isLaptop) {
+                logChip('Laptop', '#1a535c');
+            }
+            else if (isDesktop) {
+                logChip('Desktop', '#f7fff7', 'black');
+            }
+            notified = true; // Mark as notified
+        }, { immediate: true });
+    };
+    notifyOnce(); // Ensure the notification happens only once globally
+    return {
+        current,
+        active,
+        sm_S,
+        sm_SE,
+        sm_GE,
+        sm_md,
+        sm_xl,
+        sm_2xl,
+        md_S,
+        md_SE,
+        md_GE,
+        md_lg,
+        md_xl,
+        md_2xl,
+        lg_S,
+        lg_SE,
+        lg_GE,
+        lg_xl,
+        lg_2xl,
+        xl_S,
+        xl_SE,
+        xl_GE,
+        xl_2xl,
+        _2xl_S,
+        _2xl_SE,
+        _2xl_GE,
+        isGreaterThanBreakpoint,
+        reactiveBreakpoint,
+        breakpointsTailwind,
+        windowWidth,
+        windowHeight,
+        mobile,
+        tablet,
+        laptop,
+        desktop,
+        breakpoints,
+    };
 }
-// Example usage:
-// console.log(isValidHexColorAlpha('#RRGGBBAA')); // true
-// console.log(isValidHexColorAlpha('#FFFFFF')); // false
+
 /**
- * Validates if a username meets specific criteria.
- * @param {string} username The username to validate.
- * @returns {boolean} True if the username is valid, otherwise false.
+ * A composable function that filters objects based on a specific field and criteria.
+ *
+ * @param {Object[]} items - The list of objects to filter.
+ * @param {Object} filterConfig - Configuration for the filter, specifying the field, the data type to filter, and the criteria.
+ * @param {string} filterConfig.field - The field in the objects to filter.
+ * @param {string} filterConfig.type - The data type of the field ('date', 'string', 'number', 'boolean').
+ * @param {any} filterConfig.criteria - The criteria for filtering. Can be a date range, a string to search, a number range, or a boolean value.
+ *
+ * @returns {Object[]} - The filtered list of objects.
  */
-function isValidUsername(username) {
-    const usernamePattern = /^[a-zA-Z0-9_]{3,16}$/; // 3 to 16 characters, letters, numbers, and underscores only
-    return usernamePattern.test(username);
+function useFilter(items, filterConfig) {
+    // Ensure the filterConfig is correctly structured
+    const { field, type, criteria } = filterConfig;
+    // Define the filter functions
+    const filterByDate = (objects, field, { startDate, endDate }) => objects.filter(item => {
+        const date = new Date(item[field]);
+        return date >= new Date(startDate) && date <= new Date(endDate);
+    });
+    const filterByString = (objects, field, searchTerm) => {
+        const normalize = (str) => str.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
+        const words = normalize(searchTerm).split(/\s+/).filter(Boolean);
+        return objects.filter(item => {
+            const normalizedFieldValue = normalize(item[field]);
+            return words.every(word => normalizedFieldValue.includes(word));
+        });
+    };
+    const filterByNumber = (objects, field, { min, max }) => objects.filter(item => {
+        const value = item[field];
+        return value >= min && value <= max;
+    });
+    const filterByBoolean = (objects, field, expectedValue) => objects.filter(item => item[field] === expectedValue);
+    // Apply the appropriate filter and return the filtered objects
+    const filteredObjects = computed(() => {
+        if (!criteria ||
+            (type === 'date' && (!criteria.startDate || !criteria.endDate)) ||
+            (type === 'number' && (criteria.min == null || criteria.max == null)) ||
+            (type === 'boolean' && typeof criteria !== 'boolean')) {
+            return items; // Return all objects if criteria is not valid
+        }
+        // Apply the filter based on the type
+        switch (type) {
+            case 'date':
+                return filterByDate(items, field, criteria);
+            case 'string':
+                return filterByString(items, field, criteria);
+            case 'number':
+                return filterByNumber(items, field, criteria);
+            case 'boolean':
+                return filterByBoolean(items, field, criteria);
+            default:
+                return items;
+        }
+    });
+    return filteredObjects.value;
 }
-// Example usage:
-// console.log(isValidUsername('user_name123')); // true
-// console.log(isValidUsername('us')); // false
+
 /**
- * Validates if a string represents a valid age between 0 and 120.
- * @param {string} age The age to validate.
- * @returns {boolean} True if the age is valid, otherwise false.
+ * Composable to handle pagination logic.
+ *
+ * @param page - Reactive ref for the current page number.
+ * @param total - Reactive ref for total number of items.
+ * @param pageSize - Reactive ref for number of items per page.
+ * @returns An object with pagination controls.
  */
-function isValidAge(age) {
-    const ageNumber = parseInt(age, 10);
-    return !isNaN(ageNumber) && ageNumber >= 0 && ageNumber <= 120;
+function usePagination(page, total, pageSize) {
+    // Calculate the total number of pages
+    const totalPages = computed(() => Math.ceil(total.value / pageSize.value));
+    // Determine if the next page can be fetched
+    const canFetchNextPage = () => page.value < totalPages.value;
+    // Determine if the previous page can be fetched
+    const canFetchPreviousPage = () => page.value > 1;
+    return {
+        totalPages,
+        canFetchNextPage,
+        canFetchPreviousPage
+    };
 }
-// Example usage:
-// console.log(isValidAge('25')); // true
-// console.log(isValidAge('121')); // false
+
 /**
- * Validates if a string is a valid hexadecimal number.
- * @param {string} hex The hexadecimal number to validate.
- * @returns {boolean} True if the number is valid, otherwise false.
+ * Custom composable for sorting products based on a selected criterion.
+ * @param {Array} items - The array of products to sort.
+ * @param {Array} criteriaList - The list of available sorting criteria.
+ * @param {Number} selectedCriteria - The currently selected sorting criterion.
+ * @returns {ComputedRef<Array>} - The sorted array of products.
  */
-function isValidHexNumber(hex) {
-    const hexPattern = /^[0-9A-Fa-f]+$/;
-    return hexPattern.test(hex);
+function useSorter(items, criteriaList, selectedCriteria) {
+    return computed(() => {
+        const criteria = criteriaList.find(item => item.value === Number(selectedCriteria));
+        if (!criteria)
+            return items;
+        return [...items].sort((a, b) => {
+            const aValue = a[criteria.field];
+            const bValue = b[criteria.field];
+            if (criteria.type === 'number') {
+                const numA = typeof aValue === 'number' ? aValue : parseFloat(aValue) || 0;
+                const numB = typeof bValue === 'number' ? bValue : parseFloat(bValue) || 0;
+                return criteria.order === 'asc' ? numA - numB : numB - numA;
+            }
+            else if (criteria.type === 'date') {
+                const dateA = new Date(aValue).getTime();
+                const dateB = new Date(bValue).getTime();
+                return criteria.order === 'asc' ? dateA - dateB : dateB - dateA;
+            }
+            else if (criteria.type === 'boolean') {
+                const boolA = !!aValue;
+                const boolB = !!bValue;
+                return criteria.order === 'asc' ? (boolA === boolB ? 0 : boolA ? 1 : -1) : (boolA === boolB ? 0 : boolA ? -1 : 1);
+            }
+            else {
+                // Fallback for string sorting
+                const strA = (aValue || '').toString().toLowerCase();
+                const strB = (bValue || '').toString().toLowerCase();
+                return criteria.order === 'asc' ? strA.localeCompare(strB) : strB.localeCompare(strA);
+            }
+        });
+    }).value;
 }
-// Example usage:
-// console.log(isValidHexNumber('1A3F')); // true
-// console.log(isValidHexNumber('GHIJ')); // false
 
-export { APP_LOCAL_CACHE_KEY, APP_SESSION_CACHE_KEY, AxiosService, CacheTypeEnum, ContentTypeEnum, ExceptionEnum, FileMetaTypes, ImageTypes, KeyCodeEnum, LOCALE_KEY, LOCK_INFO_KEY, PROJ_CFG_KEY, ROLES_KEY, RestStd, TOKEN_KEY, USER_INFO_KEY, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, clickOutside, compareObject, copyToClipboard, countWords, createFetch, createKeyMap, customShortcut, daysBetween, daysToNextBirthday, debounce, debounceAsync, debounceAsyncValidator, debounceAsyncWithImmediate, debounceLeading, debounceLeadingTrailing, debounceTrailing, deepClone, deepEqual, deepMerge, detectKeyHold, disableCopy, disableF12Key, disableMouseButtons, disableRightClick, disableSpecificKeys, downloadBlob, enableMouseButtons, enableRightClick, enableSpecificKeys, exportToCSV, exportToExcel, exportToJSON, exportToText, exportToXML, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getEndOfMonth, getObjectDifferences, getObjectKeys, getQueryParam, getStartOfMonth, hasNestedProperties, isEmptyObject, isLeapYear, isStrongPassword, isValidAge, isValidCreditCard, isValidDate, isValidEmail, isValidExpiryDate, isValidHexColor, isValidHexColorAlpha, isValidHexNumber, isValidIP, isValidPhoneNumber, isValidSSN, isValidTime, isValidURL, isValidUsername, isValidZIP, lowerFirst, objectToFormData, objectToFormDataEnhanced, objectToQueryString, openWindow, parseDate, proxyToPlainObject, readFileAsDataURL, readFileAsText, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, reverseString, safeGet, screenEnum, screenMap, scrollToTop, simulateKeyPress, sizeEnum, stopDetectingKeyHold, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useBreakpoint, useFilter, usePagination, useSorter, useVueQuery, validateAlphanumeric, validateLetters, validateNumbers };
+export { APP_LOCAL_CACHE_KEY, APP_SESSION_CACHE_KEY, AxiosService, CacheTypeEnum, ContentTypeEnum, ERROR_MESSAGES, ERROR_STYLES, ExceptionEnum, FileMetaTypes, ImageTypes, KeyCodeEnum, LOCALE_KEY, LOCK_INFO_KEY, PROJ_CFG_KEY, ROLES_KEY, RestStd, TOKEN_KEY, USER_INFO_KEY, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, clickOutside, compareObject, configureAxios, configureEndpoints, configureTokenKeys, copyToClipboard, countWords, createCustomAxiosInstance, createFetch, createKeyMap, customShortcut, daysBetween, daysToNextBirthday, debounce, debounceAsync, debounceAsyncValidator, debounceAsyncWithImmediate, debounceLeading, debounceLeadingTrailing, debounceTrailing, deepClone, deepEqual, deepMerge, detectKeyHold, disableCopy, disableF12Key, disableMouseButtons, disableRightClick, disableSpecificKeys, downloadBlob, enableMouseButtons, enableRightClick, enableSpecificKeys, exportToCSV, exportToExcel, exportToJSON, exportToText, exportToXML, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAxiosInstance, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getQueryParam, getStartOfMonth, getTokenConfig, hasNestedProperties, isEmptyObject, isLeapYear, isStrongPassword, isValidAge, isValidCreditCard, isValidDate, isValidEmail, isValidExpiryDate, isValidHexColor, isValidHexColorAlpha, isValidHexNumber, isValidIP, isValidPhoneNumber, isValidSSN, isValidTime, isValidURL, isValidUsername, isValidZIP, lowerFirst, objectToFormData, objectToFormDataEnhanced, objectToQueryString, openWindow, parseDate, proxyToPlainObject, readFileAsDataURL, readFileAsText, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, reverseString, safeGet, screenEnum, screenMap, scrollToTop, simulateKeyPress, sizeEnum, stopDetectingKeyHold, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useBreakpoint, useFilter, usePagination, useSorter, useVueQuery, validateAlphanumeric, validateLetters, validateNumbers };