/** * RefArray is a collection of helpers for working with Refs that manage an array. * @since 0.11.0 */ import { Endomorphism } from 'fp-ts/Endomorphism' import { Eq } from 'fp-ts/Eq' import * as O from 'fp-ts/Option' import { Ord } from 'fp-ts/Ord' import { Predicate } from 'fp-ts/Predicate' import * as RA from 'fp-ts/ReadonlyArray' import * as E from './Env' import { flow, pipe } from './function' import * as Ref from './Ref' /** * RefArray is an abstraction of Refs that will track an array of values. * @since 0.11.0 * @category Model */ export interface RefArray extends Ref.Ref {} /** * @since 0.11.0 * @category Combinator */ export const append = (value: A) => (ra: RefArray): E.Env => ra.update(flow(RA.append(value), E.of)) /** * @since 0.12.0 * @category Combinator */ export const concat = (end: ReadonlyArray) => (ra: RefArray): E.Env => ra.update(flow(RA.concat(end), E.of)) /** * @since 0.14.0 * @category Combinator */ export const deleteAt = (index: number) => (ra: RefArray): E.Env => ra.update((list) => pipe( list, RA.deleteAt(index), O.getOrElse(() => list), E.of, ), ) /** * @since 0.11.0 * @category Combinator */ export const filter = (p: Predicate) => (ra: RefArray): E.Env => ra.update(flow(RA.filter(p), E.of)) /** * @since 0.11.0 * @category Combinator */ export const insertAt = (index: number, value: A) => (ra: RefArray): E.Env => ra.update((list) => pipe( list, RA.insertAt(index, value), O.getOrElse(() => list), E.of, ), ) /** * @since 0.11.0 * @category Combinator */ export const modifyAt = (index: number, f: Endomorphism) => (ra: RefArray): E.Env => ra.update((list) => pipe( list, RA.modifyAt(index, f), O.getOrElse(() => list), E.of, ), ) /** * @since 0.11.0 * @category Combinator */ export const prepend = (value: A) => (ra: RefArray): E.Env => ra.update(flow(RA.prepend(value), E.of)) /** * @since 0.11.0 * @category Combinator */ export const reverse = (ra: RefArray): E.Env => ra.update(flow(RA.reverse, E.of)) /** * @since 0.11.0 * @category Combinator */ export const rotate = (n: number) => (ra: RefArray): E.Env => ra.update(flow(RA.rotate(n), E.of)) /** * @since 0.11.0 * @category Combinator */ export const sort = (O: Ord) => (ra: RefArray): E.Env => ra.update(flow(RA.sort(O), E.of)) /** * @since 0.11.0 * @category Combinator */ export const sortBy = (O: readonly Ord[]) => (ra: RefArray): E.Env => ra.update(flow(RA.sortBy(O), E.of)) /** * @since 0.11.0 * @category Combinator */ export const uniq = (Eq: Eq) => (ra: RefArray): E.Env => ra.update(flow(RA.uniq(Eq), E.of)) /** * @since 0.11.0 * @category Combinator */ export const updateAt = (index: number, a: A) => (ra: RefArray): E.Env => ra.update((list) => pipe( list, RA.updateAt(index, a), O.getOrElse(() => list), E.of, ), ) /** * @since 0.11.0 * @category Combinator */ export const endoMap = (f: Endomorphism) => (ra: RefArray): E.Env => ra.update(flow(RA.map(f), E.of))