import type { IsomorphicIterable } from "@vangware/types";
/**
 * Prepends one iterable or asynchronous iterable to another.
 *
 * @category Generators
 * @example
 * ```typescript
 * const prependNumbers = prepend([0, 1, 2, 3, 4]);
 * prependNumbers(["foo", "bar"]); // [0, 1, 2, 3, 4, "foo", "bar"]
 * ```
 * @param initialIterable Iterable to be appended.
 * @returns Curried generator function with `initialIterable` set in context.
 */
export declare const prepend: <InitialIterable extends IsomorphicIterable>(
	initialIterable: InitialIterable,
) => <TailIterable extends IsomorphicIterable>(
	tailIterable: TailIterable,
) => TailIterable extends IsomorphicIterable<infer TailItem>
	? InitialIterable extends IsomorphicIterable<infer InitialItem>
		? TailIterable extends {
				readonly [Symbol.asyncIterator]: () => AsyncIterator<
					TailItem,
					any,
					undefined
				>;
		  }
			? {
					readonly [Symbol.asyncIterator]: () => AsyncIterableIterator<
						TailItem | InitialItem
					>;
					readonly next: (
						...args: [] | [undefined]
					) => Promise<IteratorResult<TailItem | InitialItem, any>>;
					readonly return?:
						| ((
								value?: any,
						  ) => Promise<
								IteratorResult<TailItem | InitialItem, any>
						  >)
						| undefined;
					readonly throw?:
						| ((
								e?: any,
						  ) => Promise<
								IteratorResult<TailItem | InitialItem, any>
						  >)
						| undefined;
			  }
			: InitialIterable extends {
					readonly [Symbol.asyncIterator]: () => AsyncIterator<
						InitialItem,
						any,
						undefined
					>;
			  }
			? {
					readonly [Symbol.asyncIterator]: () => AsyncIterableIterator<
						TailItem | InitialItem
					>;
					readonly next: (
						...args: [] | [undefined]
					) => Promise<IteratorResult<TailItem | InitialItem, any>>;
					readonly return?:
						| ((
								value?: any,
						  ) => Promise<
								IteratorResult<TailItem | InitialItem, any>
						  >)
						| undefined;
					readonly throw?:
						| ((
								e?: any,
						  ) => Promise<
								IteratorResult<TailItem | InitialItem, any>
						  >)
						| undefined;
			  }
			: {
					readonly [Symbol.iterator]: () => IterableIterator<
						TailItem | InitialItem
					>;
					readonly next: (
						...args: [] | [undefined]
					) => IteratorResult<TailItem | InitialItem, any>;
					readonly return?:
						| ((
								value?: any,
						  ) => IteratorResult<TailItem | InitialItem, any>)
						| undefined;
					readonly throw?:
						| ((
								e?: any,
						  ) => IteratorResult<TailItem | InitialItem, any>)
						| undefined;
			  }
		: never
	: never;