@cycle/core
Version:
The Cycle run() function meant to be used with RxJS v4
62 lines (61 loc) • 2.52 kB
TypeScript
import { CycleSetup, DisposeFunction } from '@cycle/base';
/**
* Takes a `main` function and circularly connects it to the given collection
* of driver functions.
*
* **Example:**
* ```js
* import {run} from '@cycle/rx-run';
* const dispose = Cycle.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<Sources, Sinks>(main: (sources: Sources) => Sinks, drivers: {
[name: string]: Function;
}): 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, `Cycle()` 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 Cycle from '@cycle/rx-run';
* const {sources, sinks, run} = Cycle(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 Cycle
*/
declare const Cycle: CycleSetup;
export default Cycle;