/**
 * Joins multiple path segments into a single path,
 * normalizing slashes between segments.
 *
 * Leading slash of the first segment is preserved.
 * Trailing slash of the last segment is preserved.
 * All intermediate slashes are normalized to a single slash.
 *
 * @param segments - The path segments to join
 * @returns The joined and normalized path
 *
 * @example
 * ```typescript
 * joinPath("https://example.com/", "/api/", "/users");
 * // "https://example.com/api/users"
 *
 * joinPath("/a/", "/b/", "/c");
 * // "/a/b/c"
 *
 * joinPath("a", "b", "c");
 * // "a/b/c"
 * ```
 */
export declare const joinPath: (...segments: string[]) => string;