export type NormalizeUrlOptions = { /** * File extensions that should be ignored for index pages. * @example ['.html', '.htm'] or ['.php', '.jsp'] */ ignorableExtensions?: readonly string[]; }; /** * Normalizes a URL for comparison purposes. * * This function: * - Normalizes URL encoding (decodes for parsing, then encodes for output) * - Normalizes path segments (handled by `parseUrl`) * - Normalizes trailing slashes * - Normalizes index page variations (e.g., `/index`, `/index.html` → `/`) * - Normalizes query parameter order (handled by `parseUrl`) * - Removes hash segments * * Note: Authentication information is preserved in the normalized URL. * It should be ignored during comparison using `withoutHashAndAuth`. * @param url - The URL to normalize * @param options - Optional configuration for extension matching * @returns A normalized URL string suitable for comparison */ export declare function normalizeUrl(url: string, options?: NormalizeUrlOptions): string;