|
- import { identity, pipe } from './function';
- import { flap as flap_ } from './Functor';
- // -------------------------------------------------------------------------------------
- // model
- // -------------------------------------------------------------------------------------
- /**
- * @since 2.5.0
- */
- export function fst(ea) {
- return ea[0];
- }
- /**
- * @since 2.5.0
- */
- export function snd(ea) {
- return ea[1];
- }
- /**
- * @since 2.5.0
- */
- export var swap = function (ea) { return [snd(ea), fst(ea)]; };
- /**
- * @category instances
- * @since 2.5.0
- */
- export function getApply(S) {
- return {
- URI: URI,
- _E: undefined,
- map: _map,
- ap: function (fab, fa) { return [fst(fab)(fst(fa)), S.concat(snd(fab), snd(fa))]; }
- };
- }
- var of = function (M) {
- return function (a) {
- return [a, M.empty];
- };
- };
- /**
- * @category instances
- * @since 2.5.0
- */
- export function getApplicative(M) {
- var A = getApply(M);
- return {
- URI: URI,
- _E: undefined,
- map: _map,
- ap: A.ap,
- of: of(M)
- };
- }
- /**
- * @category instances
- * @since 2.5.0
- */
- export function getChain(S) {
- var A = getApply(S);
- return {
- URI: URI,
- _E: undefined,
- map: _map,
- ap: A.ap,
- chain: function (ma, f) {
- var _a = f(fst(ma)), b = _a[0], s = _a[1];
- return [b, S.concat(snd(ma), s)];
- }
- };
- }
- /**
- * @category instances
- * @since 2.5.0
- */
- export function getMonad(M) {
- var C = getChain(M);
- return {
- URI: URI,
- _E: undefined,
- map: _map,
- ap: C.ap,
- chain: C.chain,
- of: of(M)
- };
- }
- /**
- * @category instances
- * @since 2.5.0
- */
- export function getChainRec(M) {
- var chainRec = function (a, f) {
- var result = f(a);
- var acc = M.empty;
- var s = fst(result);
- while (s._tag === 'Left') {
- acc = M.concat(acc, snd(result));
- result = f(s.left);
- s = fst(result);
- }
- return [s.right, M.concat(acc, snd(result))];
- };
- var C = getChain(M);
- return {
- URI: URI,
- _E: undefined,
- map: _map,
- ap: C.ap,
- chain: C.chain,
- chainRec: chainRec
- };
- }
- /* istanbul ignore next */
- var _compose = function (bc, ab) { return pipe(bc, compose(ab)); };
- /* istanbul ignore next */
- var _map = function (fa, f) { return pipe(fa, mapFst(f)); };
- /* istanbul ignore next */
- var _bimap = function (fa, f, g) { return pipe(fa, bimap(f, g)); };
- /* istanbul ignore next */
- var _mapLeft = function (fa, f) { return pipe(fa, mapSnd(f)); };
- /* istanbul ignore next */
- var _extend = function (wa, f) { return pipe(wa, extend(f)); };
- /* istanbul ignore next */
- var _reduce = function (fa, b, f) { return pipe(fa, reduce(b, f)); };
- /* istanbul ignore next */
- var _foldMap = function (M) {
- var foldMapM = foldMap(M);
- return function (fa, f) { return pipe(fa, foldMapM(f)); };
- };
- /* istanbul ignore next */
- var _reduceRight = function (fa, b, f) { return pipe(fa, reduceRight(b, f)); };
- /* istanbul ignore next */
- var _traverse = function (F) {
- var traverseF = traverse(F);
- return function (ta, f) { return pipe(ta, traverseF(f)); };
- };
- /**
- * Map a pair of functions over the two type arguments of the bifunctor.
- *
- * @category mapping
- * @since 2.5.0
- */
- export var bimap = function (f, g) { return function (fa) { return [g(fst(fa)), f(snd(fa))]; }; };
- /**
- * Map a function over the first component of a `ReadonlyTuple`.
- *
- * This is the `map` operation of the `Functor` instance.
- *
- * @category mapping
- * @since 2.10.0
- */
- export var mapFst = function (f) { return function (fa) {
- return [f(fst(fa)), snd(fa)];
- }; };
- /**
- * Map a function over the second component of a `ReadonlyTuple`.
- *
- * This is the `mapLeft` operation of the `Bifunctor` instance.
- *
- * @category mapping
- * @since 2.10.0
- */
- export var mapSnd = function (f) { return function (fa) {
- return [fst(fa), f(snd(fa))];
- }; };
- /**
- * @since 2.5.0
- */
- export var compose = function (ab) { return function (bc) {
- return [fst(bc), snd(ab)];
- }; };
- /**
- * @since 2.5.0
- */
- export var extend = function (f) { return function (wa) {
- return [f(wa), snd(wa)];
- }; };
- /**
- * @category Extract
- * @since 2.6.2
- */
- export var extract = fst;
- /**
- * @since 2.5.0
- */
- export var duplicate = /*#__PURE__*/ extend(identity);
- /**
- * @category folding
- * @since 2.5.0
- */
- export var reduce = function (b, f) { return function (fa) {
- return f(b, fst(fa));
- }; };
- /**
- * @category folding
- * @since 2.5.0
- */
- export var foldMap = function () {
- return function (f) { return function (fa) { return f(fst(fa)); }; };
- };
- /**
- * @category folding
- * @since 2.5.0
- */
- export var reduceRight = function (b, f) { return function (fa) {
- return f(fst(fa), b);
- }; };
- /**
- * @category traversing
- * @since 2.6.3
- */
- export var traverse = function (F) {
- return function (f) { return function (ta) { return F.map(f(fst(ta)), function (b) { return [b, snd(ta)]; }); }; };
- };
- /**
- * @category traversing
- * @since 2.6.3
- */
- export var sequence = function (F) {
- return function (fas) {
- return F.map(fst(fas), function (a) { return [a, snd(fas)]; });
- };
- };
- /**
- * @category type lambdas
- * @since 2.5.0
- */
- export var URI = 'ReadonlyTuple';
- /**
- * @category instances
- * @since 2.7.0
- */
- export var Functor = {
- URI: URI,
- map: _map
- };
- /**
- * @category mapping
- * @since 2.10.0
- */
- export var flap = /*#__PURE__*/ flap_(Functor);
- /**
- * Alias of [`mapFst`](#mapfst).
- *
- * @category mapping
- * @since 2.5.0
- */
- export var map = mapFst;
- /**
- * Alias of [`mapSnd`](#mapsnd).
- *
- * @category error handling
- * @since 2.5.0
- */
- export var mapLeft = mapSnd;
- /**
- * @category instances
- * @since 2.7.0
- */
- export var Bifunctor = {
- URI: URI,
- bimap: _bimap,
- mapLeft: _mapLeft
- };
- /**
- * @category instances
- * @since 2.7.0
- */
- export var Semigroupoid = {
- URI: URI,
- compose: _compose
- };
- /**
- * @category instances
- * @since 2.7.0
- */
- export var Comonad = {
- URI: URI,
- map: _map,
- extend: _extend,
- extract: extract
- };
- /**
- * @category instances
- * @since 2.7.0
- */
- export var Foldable = {
- URI: URI,
- reduce: _reduce,
- foldMap: _foldMap,
- reduceRight: _reduceRight
- };
- /**
- * @category instances
- * @since 2.7.0
- */
- export var Traversable = {
- URI: URI,
- map: _map,
- reduce: _reduce,
- foldMap: _foldMap,
- reduceRight: _reduceRight,
- traverse: _traverse,
- sequence: sequence
- };
- // -------------------------------------------------------------------------------------
- // deprecated
- // -------------------------------------------------------------------------------------
- /**
- * This instance is deprecated, use small, specific instances instead.
- * For example if a function needs a `Functor` instance, pass `RT.Functor` instead of `RT.readonlyTuple`
- * (where `RT` is from `import RT from 'fp-ts/ReadonlyTuple'`)
- *
- * @category zone of death
- * @since 2.5.0
- * @deprecated
- */
- export var readonlyTuple = {
- URI: URI,
- compose: _compose,
- map: _map,
- bimap: _bimap,
- mapLeft: _mapLeft,
- extract: extract,
- extend: _extend,
- reduce: _reduce,
- foldMap: _foldMap,
- reduceRight: _reduceRight,
- traverse: _traverse,
- sequence: sequence
- };
|