Slope

Slope is a small, functional reactive programming (FRP) library.

With slope-react you can easily lift your slope streams into values inside React components - and React only has to diff and rerender the changed value.

Status: Not ready for production

• [x] ~Fix fork - possibly allow only one subscriber / stream before fork is called~
• [x] ~Fix combine - it currently flattens nested arrays~
• [ ] Error handling - not sure what would be the best way to implement this
• [ ] Performance - not necessary, but check if combine could be optimized
• [ ] Automatic currying - probably in the next version

Usage

npm i slope

// javascript
const {S, Action} = require('slope')

// typescript
import {S, Action} from 'slope'

API

Check src/index.ts for common types used below.

Action

interface Action<T> {
  (value: T) => void
  stream: Stream<T>
}

// example
const {S, Action} = require('slope')

const count   = Action()
const counter = S.scan((previous, next) => previous + next, 0)(count.stream)

const unsubscribe = counter(
  value => console.log(`The current value is ${value}`),
  end   => console.log('The stream has ended')
)
//logs 'The current value is 0'

count(10)
// logs 'The current value is 10'
count(-5)
// logs 'The current value is 5'
unsubscribe()
// logs 'The stream has ended'
count(1)
// nothing happens

S

combine = Array<Stream<any>> => Stream<Array<any>>

filter<T> = UnaryF<T, boolean> => Stream<T> => Stream<T>

flatMap<A, B> = UnaryF<A, Stream<B>> => Stream<A> => Stream<B>

flatMapLatest<A, B> = UnaryF<A, Stream<B>> => Stream<A> => Stream<B>

fork<T> = Stream<T> => Stream<T>

from<T> = T => Stream<T>

fromArray<T> = Array<T> => Stream<T>

fromPromise<T> = Promise<T> => Stream<T>

map<A, B> => UnaryF<A, B> => Stream<A> => Stream<B>

merge = Array<Stream<any>> => Stream<any>

pipe = Array<() => Stream<any>> => Stream<any>

sample<A, B> = (Stream<A>, Stream<B>) => Stream<A>

scan<A, B> = (BinaryF<B, A, B>, B) => Stream<A> => Stream<B>

skipDuplicates<T> = BinaryF<T, T, boolean> => Stream<T> => Stream<T>

startWith<T> = T => Stream<T> => Stream<T>

tap<T> = UnaryF<T, void> => Stream<T> => Stream<T>