@types/rx-lite-experimental/index.d.ts

// Type definitions for rx-lite-experimental 4.0
// Project: https://github.com/Reactive-Extensions/RxJS
// Definitions by: Igor Oleinikov <https://github.com/Igorbek>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped

/// <reference types="rx-lite"/>

declare namespace Rx {
    interface Observable<T> {
        /**
         *  Returns an observable sequence that is the result of invoking the selector on the source sequence, without sharing subscriptions.
         *  This operator allows for a fluent style of writing queries that use the same sequence multiple times.
         *
         * @param selector Selector function which can use the source sequence as many times as needed, without sharing subscriptions to the source sequence.
         * @returns An observable sequence that contains the elements of a sequence produced by multicasting the source sequence within a selector function.
         */
        let<TResult>(selector: (source: Observable<T>) => Observable<TResult>): Observable<TResult>;

        /**
         *  Returns an observable sequence that is the result of invoking the selector on the source sequence, without sharing subscriptions.
         *  This operator allows for a fluent style of writing queries that use the same sequence multiple times.
         *
         * @param selector Selector function which can use the source sequence as many times as needed, without sharing subscriptions to the source sequence.
         * @returns An observable sequence that contains the elements of a sequence produced by multicasting the source sequence within a selector function.
         */
        letBind<TResult>(selector: (source: Observable<T>) => Observable<TResult>): Observable<TResult>;

        /**
         *  Repeats source as long as condition holds emulating a do while loop.
         * @param condition The condition which determines if the source will be repeated.
         * @returns An observable sequence which is repeated as long as the condition holds.
         */
        doWhile(condition: () => boolean): Observable<T>;

        /**
         *  Expands an observable sequence by recursively invoking selector.
         *
         * @param selector Selector function to invoke for each produced element, resulting in another sequence to which the selector will be invoked recursively again.
         * @param [scheduler] Scheduler on which to perform the expansion. If not provided, this defaults to the current thread scheduler.
         * @returns An observable sequence containing all the elements produced by the recursive expansion.
         */
        expand(selector: (item: T) => Observable<T>, scheduler?: IScheduler): Observable<T>;

        /**
         *  Runs two observable sequences in parallel and combines their last elemenets.
         *
         * @param second Second observable sequence or promise.
         * @param resultSelector Result selector function to invoke with the last elements of both sequences.
         * @returns An observable sequence with the result of calling the selector function with the last elements of both input sequences.
         */
        forkJoin<TSecond, TResult>(second: Observable<TSecond>, resultSelector: (left: T, right: TSecond) => TResult): Observable<TResult>;
        forkJoin<TSecond, TResult>(second: IPromise<TSecond>, resultSelector: (left: T, right: TSecond) => TResult): Observable<TResult>;

        /**
         * Comonadic bind operator.
         * @param selector A transform function to apply to each element.
         * @param [scheduler] Scheduler used to execute the operation. If not specified, defaults to the ImmediateScheduler.
         * @returns An observable sequence which results from the comonadic bind operation.
         */
        manySelect<TResult>(selector: (item: Observable<T>, index: number, source: Observable<T>) => TResult, scheduler?: IScheduler): Observable<TResult>;
    }

    interface ObservableStatic {
        /**
         *  Determines whether an observable collection contains values. There is an alias for this method called 'ifThen' for browsers <IE9
         *
         * @example
         * res = Rx.Observable.if(condition, obs1, obs2);
         * @param condition The condition which determines if the thenSource or elseSource will be run.
         * @param thenSource The observable sequence or promise that will be run if the condition function returns true.
         * @param elseSource The observable sequence or promise that will be run if the condition function returns false.
         * @returns An observable sequence which is either the thenSource or elseSource.
         */
        if<T>(condition: () => boolean, thenSource: Observable<T>, elseSource: Observable<T>): Observable<T>;
        if<T>(condition: () => boolean, thenSource: Observable<T>, elseSource: IPromise<T>): Observable<T>;
        if<T>(condition: () => boolean, thenSource: IPromise<T>, elseSource: Observable<T>): Observable<T>;
        if<T>(condition: () => boolean, thenSource: IPromise<T>, elseSource: IPromise<T>): Observable<T>;

        /**
         *  Determines whether an observable collection contains values. There is an alias for this method called 'ifThen' for browsers <IE9
         *
         * @example
         * res = Rx.Observable.if(condition, obs1, scheduler);
         * @param condition The condition which determines if the thenSource or empty sequence will be run.
         * @param thenSource The observable sequence or promise that will be run if the condition function returns true.
         * @param scheduler Scheduler used to create Rx.Observabe.Empty.
         * @returns An observable sequence which is either the thenSource or empty sequence.
         */
        if<T>(condition: () => boolean, thenSource: Observable<T>, scheduler?: IScheduler): Observable<T>;
        if<T>(condition: () => boolean, thenSource: IPromise<T>, scheduler?: IScheduler): Observable<T>;

        /**
         *  Determines whether an observable collection contains values. There is an alias for this method called 'ifThen' for browsers <IE9
         *
         * @example
         * res = Rx.Observable.if(condition, obs1, obs2);
         * @param condition The condition which determines if the thenSource or elseSource will be run.
         * @param thenSource The observable sequence or promise that will be run if the condition function returns true.
         * @param elseSource The observable sequence or promise that will be run if the condition function returns false.
         * @returns An observable sequence which is either the thenSource or elseSource.
         */
        ifThen<T>(condition: () => boolean, thenSource: Observable<T>, elseSource: Observable<T>): Observable<T>;
        ifThen<T>(condition: () => boolean, thenSource: Observable<T>, elseSource: IPromise<T>): Observable<T>;
        ifThen<T>(condition: () => boolean, thenSource: IPromise<T>, elseSource: Observable<T>): Observable<T>;
        ifThen<T>(condition: () => boolean, thenSource: IPromise<T>, elseSource: IPromise<T>): Observable<T>;

        /**
         *  Determines whether an observable collection contains values. There is an alias for this method called 'ifThen' for browsers <IE9
         *
         * @example
         * res = Rx.Observable.if(condition, obs1, scheduler);
         * @param condition The condition which determines if the thenSource or empty sequence will be run.
         * @param thenSource The observable sequence or promise that will be run if the condition function returns true.
         * @param scheduler Scheduler used to create Rx.Observabe.Empty.
         * @returns An observable sequence which is either the thenSource or empty sequence.
         */
        ifThen<T>(condition: () => boolean, thenSource: Observable<T>, scheduler?: IScheduler): Observable<T>;
        ifThen<T>(condition: () => boolean, thenSource: IPromise<T>, scheduler?: IScheduler): Observable<T>;

        /**
         *  Concatenates the observable sequences obtained by running the specified result selector for each element in source.
         * There is an alias for this method called 'forIn' for browsers <IE9
         * @param sources An array of values to turn into an observable sequence.
         * @param resultSelector A function to apply to each item in the sources array to turn it into an observable sequence.
         * @returns An observable sequence from the concatenated observable sequences.
         */
        for<T, TResult>(sources: T[], resultSelector: (item: T) => Observable<TResult>): Observable<TResult>;

        /**
         *  Concatenates the observable sequences obtained by running the specified result selector for each element in source.
         * There is an alias for this method called 'forIn' for browsers <IE9
         * @param sources An array of values to turn into an observable sequence.
         * @param resultSelector A function to apply to each item in the sources array to turn it into an observable sequence.
         * @returns An observable sequence from the concatenated observable sequences.
         */
        forIn<T, TResult>(sources: T[], resultSelector: (item: T) => Observable<TResult>): Observable<TResult>;

        /**
         *  Repeats source as long as condition holds emulating a while loop.
         * There is an alias for this method called 'whileDo' for browsers <IE9
         * @param condition The condition which determines if the source will be repeated.
         * @param source The observable sequence or promise that will be run if the condition function returns true.
         * @returns An observable sequence which is repeated as long as the condition holds.
         */
        while<T>(condition: () => boolean, source: Observable<T>): Observable<T>;
        while<T>(condition: () => boolean, source: IPromise<T>): Observable<T>;

        /**
         *  Repeats source as long as condition holds emulating a while loop.
         * There is an alias for this method called 'whileDo' for browsers <IE9
         * @param condition The condition which determines if the source will be repeated.
         * @param source The observable sequence or promise that will be run if the condition function returns true.
         * @returns An observable sequence which is repeated as long as the condition holds.
         */
        whileDo<T>(condition: () => boolean, source: Observable<T>): Observable<T>;
        whileDo<T>(condition: () => boolean, source: IPromise<T>): Observable<T>;

        /**
         *  Uses selector to determine which source in sources to use.
         *  There is an alias 'switchCase' for browsers <IE9.
         *
         * @example
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 }, obs0);
         * @param selector The function which extracts the value for to test in a case statement.
         * @param sources A object which has keys which correspond to the case statement labels.
         * @param elseSource The observable sequence or promise that will be run if the sources are not matched.
         *
         * @returns An observable sequence which is determined by a case statement.
         */
        case<T>(selector: () => string, sources: { [key: string]: Observable<T>; }, elseSource: Observable<T>): Observable<T>;
        case<T>(selector: () => string, sources: { [key: string]: IPromise<T>; }, elseSource: Observable<T>): Observable<T>;
        case<T>(selector: () => string, sources: { [key: string]: Observable<T>; }, elseSource: IPromise<T>): Observable<T>;
        case<T>(selector: () => string, sources: { [key: string]: IPromise<T>; }, elseSource: IPromise<T>): Observable<T>;

        /**
         *  Uses selector to determine which source in sources to use.
         *  There is an alias 'switchCase' for browsers <IE9.
         *
         * @example
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 });
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 }, scheduler);
         *
         * @param selector The function which extracts the value for to test in a case statement.
         * @param sources A object which has keys which correspond to the case statement labels.
         * @param scheduler Scheduler used to create Rx.Observabe.Empty.
         *
         * @returns An observable sequence which is determined by a case statement.
         */
        case<T>(selector: () => string, sources: { [key: string]: Observable<T>; }, scheduler?: IScheduler): Observable<T>;
        case<T>(selector: () => string, sources: { [key: string]: IPromise<T>; }, scheduler?: IScheduler): Observable<T>;

        /**
         *  Uses selector to determine which source in sources to use.
         *  There is an alias 'switchCase' for browsers <IE9.
         *
         * @example
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 }, obs0);
         * @param selector The function which extracts the value for to test in a case statement.
         * @param sources A object which has keys which correspond to the case statement labels.
         * @param elseSource The observable sequence or promise that will be run if the sources are not matched.
         *
         * @returns An observable sequence which is determined by a case statement.
         */
        case<T>(selector: () => number, sources: { [key: number]: Observable<T>; }, elseSource: Observable<T>): Observable<T>;
        case<T>(selector: () => number, sources: { [key: number]: IPromise<T>; }, elseSource: Observable<T>): Observable<T>;
        case<T>(selector: () => number, sources: { [key: number]: Observable<T>; }, elseSource: IPromise<T>): Observable<T>;
        case<T>(selector: () => number, sources: { [key: number]: IPromise<T>; }, elseSource: IPromise<T>): Observable<T>;

        /**
         *  Uses selector to determine which source in sources to use.
         *  There is an alias 'switchCase' for browsers <IE9.
         *
         * @example
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 });
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 }, scheduler);
         *
         * @param selector The function which extracts the value for to test in a case statement.
         * @param sources A object which has keys which correspond to the case statement labels.
         * @param scheduler Scheduler used to create Rx.Observabe.Empty.
         *
         * @returns An observable sequence which is determined by a case statement.
         */
        case<T>(selector: () => number, sources: { [key: number]: Observable<T>; }, scheduler?: IScheduler): Observable<T>;
        case<T>(selector: () => number, sources: { [key: number]: IPromise<T>; }, scheduler?: IScheduler): Observable<T>;

        /**
         *  Uses selector to determine which source in sources to use.
         *  There is an alias 'switchCase' for browsers <IE9.
         *
         * @example
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 }, obs0);
         * @param selector The function which extracts the value for to test in a case statement.
         * @param sources A object which has keys which correspond to the case statement labels.
         * @param elseSource The observable sequence or promise that will be run if the sources are not matched.
         *
         * @returns An observable sequence which is determined by a case statement.
         */
        switchCase<T>(selector: () => string, sources: { [key: string]: Observable<T>; }, elseSource: Observable<T>): Observable<T>;
        switchCase<T>(selector: () => string, sources: { [key: string]: IPromise<T>; }, elseSource: Observable<T>): Observable<T>;
        switchCase<T>(selector: () => string, sources: { [key: string]: Observable<T>; }, elseSource: IPromise<T>): Observable<T>;
        switchCase<T>(selector: () => string, sources: { [key: string]: IPromise<T>; }, elseSource: IPromise<T>): Observable<T>;

        /**
         *  Uses selector to determine which source in sources to use.
         *  There is an alias 'switchCase' for browsers <IE9.
         *
         * @example
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 });
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 }, scheduler);
         *
         * @param selector The function which extracts the value for to test in a case statement.
         * @param sources A object which has keys which correspond to the case statement labels.
         * @param scheduler Scheduler used to create Rx.Observabe.Empty.
         *
         * @returns An observable sequence which is determined by a case statement.
         */
        switchCase<T>(selector: () => string, sources: { [key: string]: Observable<T>; }, scheduler?: IScheduler): Observable<T>;
        switchCase<T>(selector: () => string, sources: { [key: string]: IPromise<T>; }, scheduler?: IScheduler): Observable<T>;

        /**
         *  Uses selector to determine which source in sources to use.
         *  There is an alias 'switchCase' for browsers <IE9.
         *
         * @example
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 }, obs0);
         * @param selector The function which extracts the value for to test in a case statement.
         * @param sources A object which has keys which correspond to the case statement labels.
         * @param elseSource The observable sequence or promise that will be run if the sources are not matched.
         *
         * @returns An observable sequence which is determined by a case statement.
         */
        switchCase<T>(selector: () => number, sources: { [key: number]: Observable<T>; }, elseSource: Observable<T>): Observable<T>;
        switchCase<T>(selector: () => number, sources: { [key: number]: IPromise<T>; }, elseSource: Observable<T>): Observable<T>;
        switchCase<T>(selector: () => number, sources: { [key: number]: Observable<T>; }, elseSource: IPromise<T>): Observable<T>;
        switchCase<T>(selector: () => number, sources: { [key: number]: IPromise<T>; }, elseSource: IPromise<T>): Observable<T>;

        /**
         *  Uses selector to determine which source in sources to use.
         *  There is an alias 'switchCase' for browsers <IE9.
         *
         * @example
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 });
         *  res = Rx.Observable.case(selector, { '1': obs1, '2': obs2 }, scheduler);
         *
         * @param selector The function which extracts the value for to test in a case statement.
         * @param sources A object which has keys which correspond to the case statement labels.
         * @param scheduler Scheduler used to create Rx.Observabe.Empty.
         *
         * @returns An observable sequence which is determined by a case statement.
         */
        switchCase<T>(selector: () => number, sources: { [key: number]: Observable<T>; }, scheduler?: IScheduler): Observable<T>;
        switchCase<T>(selector: () => number, sources: { [key: number]: IPromise<T>; }, scheduler?: IScheduler): Observable<T>;

        /**
         *  Runs all observable sequences in parallel and collect their last elements.
         *
         * @example
         * res = Rx.Observable.forkJoin([obs1, obs2]);
         * @param sources Array of source sequences or promises.
         * @returns An observable sequence with an array collecting the last elements of all the input sequences.
         */
        forkJoin<T>(sources: Array<Observable<T>>): Observable<T[]>;
        forkJoin<T>(sources: Array<IPromise<T>>): Observable<T[]>;

        /**
         *  Runs all observable sequences in parallel and collect their last elements.
         *
         * @example
         * res = Rx.Observable.forkJoin(obs1, obs2, ...);
         * @param args Source sequences or promises.
         * @returns An observable sequence with an array collecting the last elements of all the input sequences.
         */
        forkJoin<T>(...args: Array<Observable<T>>): Observable<T[]>;
        forkJoin<T>(...args: Array<IPromise<T>>): Observable<T[]>;
    }
}

declare module "rx-lite-experimental" {
    export = Rx;
}