/** * Options for configuring file extension extraction behavior. */ export interface GetFileExtensionOptions { /** * If true, returns extension without the dot prefix (default: false) */ withoutDot?: boolean; } /** * Extracts the file extension from a provided string (filename or file path). * * @param filePath - The file path or filename string to extract extension from * @param {GetFileExtensionOptions} options - Optional configuration for extraction behavior * @returns The file extension with or without dot, or empty string if no extension found * * @example * ```typescript * getFileExtension('document.pdf') // Returns '.pdf' * getFileExtension('document.pdf', { withoutDot: true }) // Returns 'pdf' * getFileExtension('/path/to/file.txt') // Returns '.txt' * getFileExtension('file') // Returns '' * getFileExtension('archive.tar.gz') // Returns '.gz' * ``` */ export declare function getFileExtension(filePath: string, options?: GetFileExtensionOptions): string;