import type { BuildUtmUrlOptions, BuildUtmUrlResult } from './types.js';
/**
 * Builds a campaign URL by appending UTM or custom query parameters.
 *
 * Existing parameters are preserved by default and can be overwritten with
 * `overwriteExisting: true`. Throws `TypeError` for empty or invalid URLs.
 *
 * @param options - UTM URL builder options.
 * @returns Built URL plus metadata about added and skipped params.
 *
 * @example
 * buildUtmUrl({
 *   url: 'https://example.com/landing',
 *   params: {
 *     utm_source: 'newsletter',
 *     utm_medium: 'email',
 *     utm_campaign: 'spring-sale',
 *   },
 * });
 */
export declare const buildUtmUrl: ({ url, params, overwriteExisting, }: BuildUtmUrlOptions) => BuildUtmUrlResult;