@arex95/vue-core 1.0.0

package/dist/rest/RestStd.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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.
+ */
+export default class RestStd {
+    static resource: string;
+    static fetchComposable: Function;
+    /**
+     * 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<T>(params?: Record<string, any>, options?: object): any;
+    /**
+     * 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<T>(id: string | number, params?: Record<string, any>, options?: object): any;
+    /**
+     * 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<T>(data: any, options?: object): any;
+    /**
+     * 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<T>(id: string | number, data: any, options?: object): any;
+    /**
+     * 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<T>(id: string | number, data: any, options?: object): any;
+    /**
+     * 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<T>(id: string | number, options?: object): any;
+    /**
+     * 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<T>(method: string, params?: Record<string, any>, data?: any, options?: object): any;
+}

package/dist/rest/index.d.ts

@@ -0,0 +1 @@
+export * from './RestStd';

package/dist/types/AxiosOptionsParameter.d.ts

@@ -0,0 +1,31 @@
+import { MaybeRef } from 'vue';
+import { AxiosRequestConfig } from 'axios';
+/**
+ * Type for options passed to an Axios fetch request.
+ */
+export type AxiosOptionsParameter<T = any> = {
+    /**
+     * A boolean or a reactive reference to a boolean indicating if the request is enabled by default.
+     */
+    immediate?: MaybeRef<boolean>;
+    /**
+     * A default value to be used if the request does not return data.
+     */
+    defaultValue?: T;
+    /**
+     * Axios configuration options for the request.
+     */
+    axiosOptionFetch?: AxiosRequestConfig;
+    /**
+     * Delay in milliseconds to debounce the request.
+     */
+    debounce?: number;
+    /**
+     * Maximum number of retries for the request on failure.
+     */
+    maxRetries?: number;
+    /**
+     * Delay in milliseconds between retry attempts.
+     */
+    retryDelay?: number;
+};

package/dist/types/ExtendedQueryOptions.d.ts

@@ -0,0 +1,6 @@
+import { UseQueryOptions } from '@tanstack/vue-query';
+export type ExtendedQueryOptions = {
+    options?: UseQueryOptions;
+    server?: boolean;
+    queryKey?: string;
+};

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './AxiosOptionsParameter';
+export * from './ExtendedQueryOptions';

package/dist/utils/browser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+export declare function openWindow(url: string, opt?: {
+    target?: string;
+    noopener?: boolean;
+    noreferrer?: boolean;
+}): void;
+/**
+ * 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.
+ */
+export declare function copyToClipboard(text: string): Promise<void>;
+/**
+ * Scrolls the window to the top smoothly.
+ * @param {number} [duration=300] Duration of the scroll animation in milliseconds.
+ */
+export declare function scrollToTop(duration?: number): void;
+/**
+ * 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.
+ */
+export declare function getQueryParam(paramName: string): string | null;

package/dist/utils/dates.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 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.
+ */
+export declare function parseDate(dateString: string): Date | null;
+/**
+ * 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.
+ */
+export declare function formatDate(date: Date, format: string): string;
+/**
+ * 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.
+ */
+export declare function daysBetween(startDate: Date, endDate: Date): number;
+/**
+ * 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.
+ */
+export declare function addDays(date: Date, days: number): Date;
+/**
+ * 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.
+ */
+export declare function subtractDays(date: Date, days: number): Date;
+/**
+ * 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.
+ */
+export declare function isLeapYear(year: number): boolean;
+/**
+ * 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.
+ */
+export declare function getStartOfMonth(date: Date): Date;
+/**
+ * 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.
+ */
+export declare function getEndOfMonth(date: Date): Date;
+/**
+ * Calculates age from a given birth date.
+ * @param {Date} birthDate The birth date.
+ * @returns {number} The calculated age.
+ */
+export declare function calculateAge(birthDate: Date): number;
+/**
+ * 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.
+ */
+export declare function daysToNextBirthday(birthDate: Date): number;
+/**
+ * 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.
+ */
+export declare function ageAtDate(birthDate: Date, atDate: Date): number;

package/dist/utils/debounces.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ */
+export declare function debounceAsyncValidator(validator: (value: any, debounce: () => Promise<void>) => Promise<void>, delay: number): (value: any) => Promise<void>;
+/**
+ * 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.
+ */
+export declare function debounceAsync<T extends (...args: any[]) => Promise<any>>(func: T, wait: number): (...args: Parameters<T>) => Promise<ReturnType<T>>;
+/**
+ * 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.
+ */
+export declare function debounceAsyncWithImmediate<T extends (...args: any[]) => Promise<any>>(func: T, wait: number): (...args: Parameters<T>) => Promise<ReturnType<T>>;
+/**
+ * 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.
+ */
+export declare function debounceLeading<T extends (...args: any[]) => void>(func: T, wait: number): T;
+/**
+ * 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.
+ */
+export declare function debounceTrailing<T extends (...args: any[]) => void>(func: T, wait: number): T;
+/**
+ * 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.
+ */
+export declare function debounceLeadingTrailing<T extends (...args: any[]) => void>(func: T, wait: number): T;
+/**
+ * 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.
+ */
+export declare function debounce<T extends (...args: any[]) => void>(func: T, wait: number): T;
+/**
+ * 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.
+ */
+export declare function throttle<T extends (...args: any[]) => void>(func: T, limit: number): T;

package/dist/utils/exports.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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.
+ */
+export declare function exportToCSV(headers: string[], data: any[][], fileName: string): void;
+/**
+ * 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.
+ */
+export declare function exportToExcel(headers: string[], data: any[][], fileName: string): void;
+/**
+ * Exports data to a JSON file.
+ * @param {any[]} data The data to export.
+ * @param {string} fileName The name of the file to create.
+ */
+export declare function exportToJSON(data: any[], fileName: string): void;
+/**
+ * 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.
+ */
+export declare function exportToXML(headers: string[], data: any[][], fileName: string): void;
+/**
+ * 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.
+ */
+export declare function exportToText(headers: string[], data: any[][], fileName: string): void;

package/dist/utils/files.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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.
+ */
+export declare function formDataToObject(formData: FormData): Record<string, any>;
+/**
+ * Reads a file as text.
+ * @param {File} file The file to read.
+ * @returns {Promise<string>} A promise that resolves with the file content.
+ */
+export declare function readFileAsText(file: File): Promise<string>;
+/**
+ * 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.
+ */
+export declare function readFileAsDataURL(file: File): Promise<string>;
+/**
+ * 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.
+ */
+export declare function stringToBlob(content: string, type?: string): Blob;
+/**
+ * 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.
+ */
+export declare function bufferToBlob(buffer: ArrayBuffer, type?: string): Blob;
+/**
+ * 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.
+ */
+export declare function downloadBlob(blob: Blob, fileName: string): void;
+/**
+ * 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.
+ */
+export declare function blobToFormData(blob: Blob, name: string, fileName?: string): FormData;

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from './exports';
+export * from './browser';
+export * from './io';
+export * from './dates';
+export * from './debounces';
+export * from './files';
+export * from './objects';
+export * from './strings';
+export * from './validations';

package/dist/utils/io.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Disables the right-click context menu on the window.
+ */
+export declare function disableRightClick(): void;
+export declare namespace disableRightClick {
+    var handler: any;
+}
+/**
+ * Enables the right-click context menu on the window.
+ */
+export declare function enableRightClick(): void;
+/**
+ * Disables specific mouse buttons.
+ * @param {Array<number>} buttons Array of mouse button codes to disable (0 for left, 1 for middle, 2 for right).
+ */
+export declare function disableMouseButtons(buttons: number[]): void;
+export declare namespace disableMouseButtons {
+    var handlers: ((event: MouseEvent) => void)[];
+}
+/**
+ * Enables all previously disabled mouse buttons.
+ */
+export declare function enableMouseButtons(): void;
+/**
+ * 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.
+ */
+export declare function addDoubleClickListener(element: HTMLElement, callback: (event: MouseEvent) => void): void;
+/**
+ * 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.
+ */
+export declare function removeDoubleClickListener(element: HTMLElement, callback: (event: MouseEvent) => void): void;
+/**
+ * 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.
+ */
+export declare function clickOutside(element: HTMLElement, callback: () => void): void;
+export declare namespace clickOutside {
+    var handlers: {
+        element: HTMLElement;
+        handler: (event: MouseEvent) => void;
+    }[];
+}
+/**
+ * Removes the click outside listener for a specific element.
+ * @param {HTMLElement} element The element to stop detecting clicks outside of.
+ */
+export declare function removeClickOutside(element: HTMLElement): void;
+/**
+ * Disables the F12 key and certain key combinations for developer tools.
+ */
+export declare function disableF12Key(): void;
+/**
+ * Enables or disables the tab navigation (Tab key) on the page.
+ * @param {boolean} enable Whether to enable or disable tab navigation.
+ */
+export declare function toggleTabNavigation(enable: boolean): void;
+/**
+ * Disables the copy (Ctrl + C) functionality on the page.
+ */
+export declare function disableCopy(): void;
+/**
+ * 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.
+ */
+export declare function addCustomKeyboardShortcut(key: string, callback: () => void, ctrlKey?: boolean, shiftKey?: boolean): void;
+/**
+ * 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.
+ */
+export declare function removeCustomKeyboardShortcut(key: string, ctrlKey?: boolean, shiftKey?: boolean): void;
+/**
+ * Disables specific keys or key combinations.
+ * @param {Array<string>} keys Array of key names to disable (e.g., ['F1', 'F5', 'Control+S']).
+ */
+export declare function disableSpecificKeys(keys: string[]): void;
+export declare namespace disableSpecificKeys {
+    var handlers: ((event: KeyboardEvent) => void)[];
+}
+/**
+ * Enables keys that were previously disabled using disableSpecificKeys.
+ */
+export declare function enableSpecificKeys(): void;
+/**
+ * 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.
+ */
+export declare function registerKeyboardShortcuts(shortcuts: {
+    key: string;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    callback: () => void;
+}[]): void;
+export declare namespace registerKeyboardShortcuts {
+    var handlers: ((event: KeyboardEvent) => void)[];
+}
+/**
+ * Unregisters all keyboard shortcuts that were registered with registerKeyboardShortcuts.
+ */
+export declare function unregisterKeyboardShortcuts(): void;
+/**
+ * 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.
+ */
+export declare function addKeyListener(key: string, callback: () => void): void;
+export declare namespace addKeyListener {
+    var handlers: ((event: KeyboardEvent) => void)[];
+}
+/**
+ * Removes all custom key listeners added by addKeyListener.
+ */
+export declare function removeKeyListeners(): void;
+/**
+ * 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.
+ */
+export declare function detectKeyHold(key: string, onHold: () => void): void;
+export declare namespace detectKeyHold {
+    var handlers: ((event: KeyboardEvent) => void)[];
+}
+/**
+ * Stops detecting if a specific key is held down.
+ */
+export declare function stopDetectingKeyHold(): void;
+/**
+ * Tracks currently pressed keys and provides a map of active keys.
+ * @returns {Set<string>} A set of currently pressed keys.
+ */
+export declare function createKeyMap(): Set<string>;
+export declare namespace createKeyMap {
+    var clearListeners: () => void;
+}
+/**
+ * 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.
+ */
+export declare function customShortcut(keys: string[], callback: () => void): void;
+export declare namespace customShortcut {
+    var handlers: {
+        keyDownHandler: (event: KeyboardEvent) => void;
+        keyUpHandler: (event: KeyboardEvent) => void;
+    }[];
+}
+/**
+ * Removes all custom keyboard shortcuts added by customShortcut.
+ */
+export declare function removeCustomShortcuts(): void;
+/**
+ * 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.
+ */
+export declare function simulateKeyPress(key: string, ctrlKey?: boolean, shiftKey?: boolean, altKey?: boolean): void;

package/dist/utils/objects.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Converts a Proxy object to a plain object.
+ * @param {ProxyConstructor} proxy The Proxy object to convert.
+ * @returns {Object} The plain object.
+ */
+export declare function proxyToPlainObject(proxy: ProxyConstructor): any;
+/**
+ * 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.
+ */
+export declare function compareObject(object1: Record<string, any>, object2: Record<string, any>): boolean;
+/**
+ * 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.
+ */
+export declare function deepEqual(object1: Record<string, any>, object2: Record<string, any>): boolean;
+/**
+ * Deeply clones an object.
+ * @param {Object} obj The object to clone.
+ * @returns {Object} The cloned object.
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Converts an object to a query string.
+ * @param {Object} obj The object to convert.
+ * @returns {string} The query string.
+ */
+export declare function objectToQueryString(obj: Record<string, any>): string;
+/**
+ * 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.
+ */
+export declare function getObjectDifferences(object1: Record<string, any>, object2: Record<string, any>): Record<string, any>;
+/**
+ * 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.
+ */
+export declare function filterObjectByKeys(obj: Record<string, any>, keys: string[]): Record<string, any>;
+/**
+ * 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.
+ */
+export declare function deepMerge<T>(target: T, source: Partial<T>): T;
+/**
+ * Checks if an object is empty.
+ * @param {Object} obj The object to check.
+ * @returns {boolean} True if the object is empty, otherwise false.
+ */
+export declare function isEmptyObject(obj: Record<string, any>): boolean;
+/**
+ * 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.
+ */
+export declare function safeGet(obj: Record<string, any>, keys: string[]): any;
+/**
+ * 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.
+ */
+export declare function removeEmptyProperties(obj: Record<string, any>): Record<string, any>;
+/**
+ * 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.
+ */
+export declare function getObjectKeys(obj: Record<string, any>): string[];
+/**
+ * Checks if an object has nested properties.
+ * @param {Object} obj The object to check.
+ * @returns {boolean} True if there are nested properties, false otherwise.
+ */
+export declare function hasNestedProperties(obj: Record<string, any>): boolean;
+/**
+ * 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.
+ */
+export declare function objectToFormDataEnhanced(obj: Record<string, any>, formData?: FormData, parentKey?: string): FormData;
+/**
+ * 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.
+ */
+export declare const objectToFormData: (obj: any, form?: FormData, namespace?: string) => FormData;
+/**
+ * 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.
+ */
+export declare function flattenObject(obj: Record<string, any>, parentKey?: string, result?: Record<string, any>): Record<string, any>;