import type { IsomorphicIterable, Unary } from "@vangware/types";
import type { ReadOnlyAsyncIterable } from "./types/ReadOnlyAsyncIterable.js";
import type { ReadOnlyAsyncIterableIterator } from "./types/ReadOnlyAsyncIterableIterator.js";
import type { ReadOnlyIterableIterator } from "./types/ReadOnlyIterableIterator.js";
/**
 * Map for iterables and asynchronous iterables.
 *
 * @category Generators
 * @example
 * ```
 * const double = value => value * 2;
 * const mapDouble = map(double);
 *
 * mapDouble([1, 2, 3]); // [2, 4, 6]
 * ```
 * @param mapper Mapper function.
 * @returns Generator function with `mapper` function set in context.
 */
export declare const map: <Item, MappedItem>(
	mapper: Unary<Item, MappedItem>,
) => <Iterable_1 extends IsomorphicIterable<Item>>(
	iterable: Iterable_1,
) => Iterable_1 extends {
	readonly [Symbol.asyncIterator]: () => AsyncIterator<Item, any, undefined>;
}
	? {
			readonly [Symbol.asyncIterator]: () => AsyncIterableIterator<MappedItem>;
			readonly next: (
				...args: [] | [undefined]
			) => Promise<IteratorResult<MappedItem, any>>;
			readonly return?:
				| ((value?: any) => Promise<IteratorResult<MappedItem, any>>)
				| undefined;
			readonly throw?:
				| ((e?: any) => Promise<IteratorResult<MappedItem, any>>)
				| undefined;
	  }
	: {
			readonly [Symbol.iterator]: () => IterableIterator<MappedItem>;
			readonly next: (
				...args: [] | [undefined]
			) => IteratorResult<MappedItem, any>;
			readonly return?:
				| ((value?: any) => IteratorResult<MappedItem, any>)
				| undefined;
			readonly throw?:
				| ((e?: any) => IteratorResult<MappedItem, any>)
				| undefined;
	  };