/**
 * Sitemap parser for web sources.
 *
 * Parses sitemap index files and individual sitemaps to extract URLs.
 * Supports both sitemap index files (<sitemapindex>) and flat sitemaps (<urlset>).
 */
import type { SitemapEntry } from './types.js';
/**
 * Parse a sitemap index and return all URLs from child sitemaps.
 *
 * This function handles both sitemap index files (with <sitemapindex>)
 * and flat sitemap files (with <urlset>).
 *
 * @param indexUrl - URL of the sitemap index or flat sitemap
 * @param includeFilter - Optional list of sitemap filenames to include (only for sitemap indexes)
 * @param visited - Internal guard set to prevent cyclic/self-referential sitemaps from looping forever
 * @returns Array of sitemap entries
 */
export declare function parseSitemapIndex(indexUrl: string, includeFilter?: string[], visited?: Set<string>): Promise<SitemapEntry[]>;
/**
 * Parse a single sitemap file.
 *
 * @param url - URL of the sitemap
 * @param visited - Internal guard set shared with parseSitemapIndex to break cycles
 * @returns Array of sitemap entries
 */
export declare function parseSitemap(url: string, visited?: Set<string>): Promise<SitemapEntry[]>;
/**
 * Filter URLs based on include and exclude patterns.
 *
 * @param entries - Array of sitemap entries
 * @param excludePatterns - URL patterns to exclude (supports * wildcards)
 * @param includePatterns - URL patterns to include (supports * wildcards). If specified, only matching URLs are kept.
 * @returns Filtered array of sitemap entries
 */
export declare function filterUrls(entries: SitemapEntry[], excludePatterns?: string[], includePatterns?: string[]): SitemapEntry[];
//# sourceMappingURL=sitemap.d.ts.map