/**
 * @file URL parsing helpers — `parseUrl` (safe `new URL(...)` wrapper that
 *   returns `undefined` instead of throwing) and `createRelativeUrl` (compose a
 *   relative path against an optional base).
 */
import type { CreateRelativeUrlOptions } from './types';
/**
 * Create a relative URL for testing.
 *
 * @example
 *   ;```typescript
 *   createRelativeUrl('/api/test') // 'api/test'
 *   createRelativeUrl('/api/test', { base: 'https://example.com' }) // 'https://example.com/api/test'
 *   ```
 */
export declare function createRelativeUrl(path: string, options?: CreateRelativeUrlOptions | undefined): string;
/**
 * Parse a value as a URL.
 *
 * @example
 *   ;```typescript
 *   parseUrl('https://example.com') // URL { href: 'https://example.com/' }
 *   parseUrl('invalid') // undefined
 *   ```
 */
export declare function parseUrl(value: string | URL): URL | undefined;
