import 'symbol-observable'; import { Stream } from 'xstream'; import { Observable } from 'rxjs'; import { DisposeFunction, Drivers, Main, Sources, Sinks, GetValidInputs, WidenStream } from '@cycle/run'; export declare type ToObservable = S extends Stream ? Observable : S; export declare type ToObservables = { [k in keyof S]: ToObservable; }; export declare type MatchingMain = (Main & { (so: ToObservables>): Sinks; }) | (Main & { (): Sinks; }); export declare type ToStream = S extends Observable ? Stream : S; export declare type MatchingDrivers = Drivers & { [k in string & keyof Sinks]: (() => Sources[k]) | ((si: Stream[k]>, GetValidInputs>>) => Sources[k]); }; export interface CycleProgram, M extends MatchingMain> { sources: ToObservables>; sinks: Sinks; run(): DisposeFunction; } export interface Engine { sources: Sources; run>(sinks: Sinks): DisposeFunction; dispose(): void; } /** * Takes a `main` function and circularly connects it to the given collection * of driver functions. * * **Example:** * ```js * import run from '@cycle/rxjs-run'; * const dispose = run(main, drivers); * // ... * dispose(); * ``` * * The `main` function expects a collection of "source" Observables (returned * from drivers) as input, and should return a collection of "sink" Observables * (to be given to drivers). A "collection of Observables" is a JavaScript * object where keys match the driver names registered by the `drivers` object, * and values are the Observables. Refer to the documentation of each driver to * see more details on what types of sources it outputs and sinks it receives. * * @param {Function} main a function that takes `sources` as input * and outputs a collection of `sinks` Observables. * @param {Object} drivers an object where keys are driver names and values * are driver functions. * @return {Function} a dispose function, used to terminate the execution of the * Cycle.js program, cleaning up resources used. * @function run */ export declare function run, M extends MatchingMain>(main: M, drivers: D): DisposeFunction; /** * A function that prepares the Cycle application to be executed. Takes a `main` * function and prepares to circularly connects it to the given collection of * driver functions. As an output, `setup()` returns an object with three * properties: `sources`, `sinks` and `run`. Only when `run()` is called will * the application actually execute. Refer to the documentation of `run()` for * more details. * * **Example:** * ```js * import {setup} from '@cycle/rxjs-run'; * const {sources, sinks, run} = setup(main, drivers); * // ... * const dispose = run(); // Executes the application * // ... * dispose(); * ``` * * @param {Function} main a function that takes `sources` as input * and outputs a collection of `sinks` Observables. * @param {Object} drivers an object where keys are driver names and values * are driver functions. * @return {Object} an object with three properties: `sources`, `sinks` and * `run`. `sources` is the collection of driver sources, `sinks` is the * collection of driver sinks, these can be used for debugging or testing. `run` * is the function that once called will execute the application. * @function setup */ export declare function setup, M extends MatchingMain>(main: M, drivers: D): CycleProgram; export default run;