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 };