import type { IsomorphicIterable } from "@vangware/types";
import type { ReducerOutput } from "./types/ReducerOutput.js";
/**
 * Takes a `separator` string and a iterable or asynchronous iterable and
 * returns a string with the concatenation of all the elements separated by the
 * `separator`.
 *
 * @category Reducers
 * @example
 * ```typescript
 * const joinWithSpaces = join(" ");
 * joinWithSpaces([1, 2, 3]); // "1 2 3"
 * ```
 * @param separator String to use as separator.
 * @returns Curried function with `separator` in context.
 */
export declare const join: (
	separator: string,
) => <Iterable_1 extends IsomorphicIterable>(
	iterable: Iterable_1,
) => ReducerOutput<Iterable_1, string>;