|
- /**
- * The `FromEither` type class represents those data types which support errors.
- *
- * @since 2.10.0
- */
- import { Chain, Chain1, Chain2, Chain2C, Chain3, Chain3C, Chain4 } from './Chain'
- import { Either } from './Either'
- import { Lazy } from './function'
- import { HKT2, Kind, Kind2, Kind3, Kind4, URIS, URIS2, URIS3, URIS4 } from './HKT'
- import { Option } from './Option'
- import { Predicate } from './Predicate'
- import { Refinement } from './Refinement'
- /**
- * @category model
- * @since 2.10.0
- */
- export interface FromEither<F> {
- readonly URI: F
- readonly fromEither: <E, A>(e: Either<E, A>) => HKT2<F, E, A>
- }
- /**
- * @category model
- * @since 2.11.0
- */
- export interface FromEither1<F extends URIS> {
- readonly URI: F
- readonly fromEither: <A>(fa: Either<unknown, A>) => Kind<F, A>
- }
- /**
- * @category model
- * @since 2.10.0
- */
- export interface FromEither2<F extends URIS2> {
- readonly URI: F
- readonly fromEither: <E, A>(fa: Either<E, A>) => Kind2<F, E, A>
- }
- /**
- * @category model
- * @since 2.10.0
- */
- export interface FromEither2C<F extends URIS2, E> {
- readonly URI: F
- readonly _E: E
- readonly fromEither: <A>(fa: Either<E, A>) => Kind2<F, E, A>
- }
- /**
- * @category model
- * @since 2.10.0
- */
- export interface FromEither3<F extends URIS3> {
- readonly URI: F
- readonly fromEither: <E, A, R>(fa: Either<E, A>) => Kind3<F, R, E, A>
- }
- /**
- * @category model
- * @since 2.10.0
- */
- export interface FromEither3C<F extends URIS3, E> {
- readonly URI: F
- readonly _E: E
- readonly fromEither: <A, R>(fa: Either<E, A>) => Kind3<F, R, E, A>
- }
- /**
- * @category model
- * @since 2.10.0
- */
- export interface FromEither4<F extends URIS4> {
- readonly URI: F
- readonly fromEither: <E, A, S, R>(fa: Either<E, A>) => Kind4<F, S, R, E, A>
- }
- /**
- * @category constructors
- * @since 2.10.0
- */
- export declare function fromOption<F extends URIS4>(
- F: FromEither4<F>
- ): <E>(onNone: Lazy<E>) => <A, S, R>(fa: Option<A>) => Kind4<F, S, R, E, A>
- export declare function fromOption<F extends URIS3>(
- F: FromEither3<F>
- ): <E>(onNone: Lazy<E>) => <A, R>(fa: Option<A>) => Kind3<F, R, E, A>
- export declare function fromOption<F extends URIS3, E>(
- F: FromEither3C<F, E>
- ): (onNone: Lazy<E>) => <A, R>(fa: Option<A>) => Kind3<F, R, E, A>
- export declare function fromOption<F extends URIS2>(
- F: FromEither2<F>
- ): <E>(onNone: Lazy<E>) => <A>(fa: Option<A>) => Kind2<F, E, A>
- export declare function fromOption<F extends URIS2, E>(
- F: FromEither2C<F, E>
- ): (onNone: Lazy<E>) => <A>(fa: Option<A>) => Kind2<F, E, A>
- export declare function fromOption<F>(F: FromEither<F>): <E>(onNone: Lazy<E>) => <A>(ma: Option<A>) => HKT2<F, E, A>
- /**
- * @category lifting
- * @since 2.10.0
- */
- export declare function fromPredicate<F extends URIS4>(
- F: FromEither4<F>
- ): {
- <A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <S, R>(a: A) => Kind4<F, S, R, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <S, R, B extends A>(b: B) => Kind4<F, S, R, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <S, R>(a: A) => Kind4<F, S, R, E, A>
- }
- export declare function fromPredicate<F extends URIS3>(
- F: FromEither3<F>
- ): {
- <A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <R>(a: A) => Kind3<F, R, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <R, B extends A>(b: B) => Kind3<F, R, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <R>(a: A) => Kind3<F, R, E, A>
- }
- export declare function fromPredicate<F extends URIS3, E>(
- F: FromEither3C<F, E>
- ): {
- <A, B extends A>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <R>(a: A) => Kind3<F, R, E, B>
- <A>(predicate: Predicate<A>, onFalse: (a: A) => E): <R, B extends A>(b: B) => Kind3<F, R, E, B>
- <A>(predicate: Predicate<A>, onFalse: (a: A) => E): <R>(a: A) => Kind3<F, R, E, A>
- }
- export declare function fromPredicate<F extends URIS2>(
- F: FromEither2<F>
- ): {
- <A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (a: A) => Kind2<F, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(b: B) => Kind2<F, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): (a: A) => Kind2<F, E, A>
- }
- export declare function fromPredicate<F extends URIS2, E>(
- F: FromEither2C<F, E>
- ): {
- <A, B extends A>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (a: A) => Kind2<F, E, B>
- <A>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(b: B) => Kind2<F, E, B>
- <A>(predicate: Predicate<A>, onFalse: (a: A) => E): (a: A) => Kind2<F, E, A>
- }
- export declare function fromPredicate<F>(F: FromEither<F>): {
- <A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (a: A) => HKT2<F, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(b: B) => HKT2<F, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): (a: A) => HKT2<F, E, A>
- }
- /**
- * @since 2.10.0
- */
- export declare function fromOptionK<F extends URIS4>(
- F: FromEither4<F>
- ): <E>(
- onNone: Lazy<E>
- ) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => <S, R>(...a: A) => Kind4<F, S, R, E, B>
- export declare function fromOptionK<F extends URIS3>(
- F: FromEither3<F>
- ): <E>(
- onNone: Lazy<E>
- ) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => <R>(...a: A) => Kind3<F, R, E, B>
- export declare function fromOptionK<F extends URIS3, E>(
- F: FromEither3C<F, E>
- ): (
- onNone: Lazy<E>
- ) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => <R>(...a: A) => Kind3<F, R, E, B>
- export declare function fromOptionK<F extends URIS2>(
- F: FromEither2<F>
- ): <E>(
- onNone: Lazy<E>
- ) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => (...a: A) => Kind2<F, E, B>
- export declare function fromOptionK<F extends URIS2, E>(
- F: FromEither2C<F, E>
- ): (onNone: Lazy<E>) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => (...a: A) => Kind2<F, E, B>
- export declare function fromOptionK<F>(
- F: FromEither<F>
- ): <E>(
- onNone: Lazy<E>
- ) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => (...a: A) => HKT2<F, E, B>
- /**
- * @since 2.10.0
- */
- export declare function chainOptionK<F extends URIS4>(
- F: FromEither4<F>,
- M: Chain4<F>
- ): <E>(onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => <S, R>(ma: Kind4<F, S, R, E, A>) => Kind4<F, S, R, E, B>
- export declare function chainOptionK<F extends URIS3>(
- F: FromEither3<F>,
- M: Chain3<F>
- ): <E>(onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => <R>(ma: Kind3<F, R, E, A>) => Kind3<F, R, E, B>
- export declare function chainOptionK<F extends URIS3, E>(
- F: FromEither3C<F, E>,
- M: Chain3C<F, E>
- ): (onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => <R>(ma: Kind3<F, R, E, A>) => Kind3<F, R, E, B>
- export declare function chainOptionK<F extends URIS2>(
- F: FromEither2<F>,
- M: Chain2<F>
- ): <E>(onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => (ma: Kind2<F, E, A>) => Kind2<F, E, B>
- export declare function chainOptionK<F extends URIS2, E>(
- F: FromEither2C<F, E>,
- M: Chain2C<F, E>
- ): (onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => (ma: Kind2<F, E, A>) => Kind2<F, E, B>
- export declare function chainOptionK<F>(
- F: FromEither<F>,
- M: Chain<F>
- ): <E>(onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => (ma: HKT2<F, E, A>) => HKT2<F, E, B>
- /**
- * @since 2.10.0
- */
- export declare function fromEitherK<F extends URIS4>(
- F: FromEither4<F>
- ): <A extends ReadonlyArray<unknown>, E, B>(f: (...a: A) => Either<E, B>) => <S, R>(...a: A) => Kind4<F, S, R, E, B>
- export declare function fromEitherK<F extends URIS3>(
- F: FromEither3<F>
- ): <A extends ReadonlyArray<unknown>, E, B>(f: (...a: A) => Either<E, B>) => <R>(...a: A) => Kind3<F, R, E, B>
- export declare function fromEitherK<F extends URIS3, E>(
- F: FromEither3C<F, E>
- ): <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Either<E, B>) => <R>(...a: A) => Kind3<F, R, E, B>
- export declare function fromEitherK<F extends URIS2>(
- F: FromEither2<F>
- ): <A extends ReadonlyArray<unknown>, E, B>(f: (...a: A) => Either<E, B>) => (...a: A) => Kind2<F, E, B>
- export declare function fromEitherK<F extends URIS2, E>(
- F: FromEither2C<F, E>
- ): <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Either<E, B>) => (...a: A) => Kind2<F, E, B>
- export declare function fromEitherK<F extends URIS>(
- F: FromEither1<F>
- ): <E, A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Either<E, B>) => (...a: A) => Kind<F, B>
- export declare function fromEitherK<F>(
- F: FromEither<F>
- ): <A extends ReadonlyArray<unknown>, E, B>(f: (...a: A) => Either<E, B>) => (...a: A) => HKT2<F, E, B>
- /**
- * @since 2.10.0
- */
- export declare function chainEitherK<M extends URIS4>(
- F: FromEither4<M>,
- M: Chain4<M>
- ): <A, E, B>(f: (a: A) => Either<E, B>) => <S, R>(ma: Kind4<M, S, R, E, A>) => Kind4<M, S, R, E, B>
- export declare function chainEitherK<M extends URIS3>(
- F: FromEither3<M>,
- M: Chain3<M>
- ): <A, E, B>(f: (a: A) => Either<E, B>) => <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, B>
- export declare function chainEitherK<M extends URIS3, E>(
- F: FromEither3C<M, E>,
- M: Chain3C<M, E>
- ): <A, B>(f: (a: A) => Either<E, B>) => <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, B>
- export declare function chainEitherK<M extends URIS2>(
- F: FromEither2<M>,
- M: Chain2<M>
- ): <A, E, B>(f: (a: A) => Either<E, B>) => (ma: Kind2<M, E, A>) => Kind2<M, E, B>
- export declare function chainEitherK<M extends URIS2, E>(
- F: FromEither2C<M, E>,
- M: Chain2C<M, E>
- ): <A, B>(f: (a: A) => Either<E, B>) => (ma: Kind2<M, E, A>) => Kind2<M, E, B>
- export declare function chainEitherK<M extends URIS>(
- F: FromEither1<M>,
- M: Chain1<M>
- ): <E, A, B>(f: (a: A) => Either<E, B>) => (ma: Kind<M, A>) => Kind<M, B>
- export declare function chainEitherK<M>(
- F: FromEither<M>,
- M: Chain<M>
- ): <A, E, B>(f: (a: A) => Either<E, B>) => (ma: HKT2<M, E, A>) => HKT2<M, E, B>
- /**
- * @since 2.12.0
- */
- export declare function chainFirstEitherK<M extends URIS4>(
- F: FromEither4<M>,
- M: Chain4<M>
- ): <A, E, B>(f: (a: A) => Either<E, B>) => <S, R>(ma: Kind4<M, S, R, E, A>) => Kind4<M, S, R, E, A>
- export declare function chainFirstEitherK<M extends URIS3>(
- F: FromEither3<M>,
- M: Chain3<M>
- ): <A, E, B>(f: (a: A) => Either<E, B>) => <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, A>
- export declare function chainFirstEitherK<M extends URIS3, E>(
- F: FromEither3C<M, E>,
- M: Chain3C<M, E>
- ): <A, B>(f: (a: A) => Either<E, B>) => <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, A>
- export declare function chainFirstEitherK<M extends URIS2>(
- F: FromEither2<M>,
- M: Chain2<M>
- ): <A, E, B>(f: (a: A) => Either<E, B>) => (ma: Kind2<M, E, A>) => Kind2<M, E, A>
- export declare function chainFirstEitherK<M extends URIS2, E>(
- F: FromEither2C<M, E>,
- M: Chain2C<M, E>
- ): <A, B>(f: (a: A) => Either<E, B>) => (ma: Kind2<M, E, A>) => Kind2<M, E, A>
- export declare function chainFirstEitherK<M extends URIS>(
- F: FromEither1<M>,
- M: Chain1<M>
- ): <E, A, B>(f: (a: A) => Either<E, B>) => (ma: Kind<M, A>) => Kind<M, A>
- export declare function chainFirstEitherK<M>(
- F: FromEither<M>,
- M: Chain<M>
- ): <A, E, B>(f: (a: A) => Either<E, B>) => (ma: HKT2<M, E, A>) => HKT2<M, E, A>
- /**
- * @since 2.10.0
- */
- export declare function filterOrElse<M extends URIS4>(
- F: FromEither4<M>,
- M: Chain4<M>
- ): {
- <A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <S, R>(
- ma: Kind4<M, S, R, E, A>
- ) => Kind4<M, S, R, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <S, R, B extends A>(
- mb: Kind4<M, S, R, E, B>
- ) => Kind4<M, S, R, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <S, R>(ma: Kind4<M, S, R, E, A>) => Kind4<M, S, R, E, A>
- }
- export declare function filterOrElse<M extends URIS3>(
- F: FromEither3<M>,
- M: Chain3<M>
- ): {
- <A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <R>(
- ma: Kind3<M, R, E, A>
- ) => Kind3<M, R, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <R, B extends A>(mb: Kind3<M, R, E, B>) => Kind3<M, R, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, A>
- }
- export declare function filterOrElse<M extends URIS3, E>(
- F: FromEither3C<M, E>,
- M: Chain3C<M, E>
- ): {
- <A, B extends A>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, B>
- <A>(predicate: Predicate<A>, onFalse: (a: A) => E): <R, B extends A>(mb: Kind3<M, R, E, B>) => Kind3<M, R, E, B>
- <A>(predicate: Predicate<A>, onFalse: (a: A) => E): <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, A>
- }
- export declare function filterOrElse<M extends URIS2>(
- F: FromEither2<M>,
- M: Chain2<M>
- ): {
- <A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (ma: Kind2<M, E, A>) => Kind2<M, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(mb: Kind2<M, E, B>) => Kind2<M, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): (ma: Kind2<M, E, A>) => Kind2<M, E, A>
- }
- export declare function filterOrElse<M extends URIS2, E>(
- F: FromEither2C<M, E>,
- M: Chain2C<M, E>
- ): {
- <A, B extends A>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (ma: Kind2<M, E, A>) => Kind2<M, E, B>
- <A>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(mb: Kind2<M, E, B>) => Kind2<M, E, B>
- <A>(predicate: Predicate<A>, onFalse: (a: A) => E): (ma: Kind2<M, E, A>) => Kind2<M, E, A>
- }
- export declare function filterOrElse<M extends URIS2>(
- F: FromEither<M>,
- M: Chain<M>
- ): {
- <A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (ma: HKT2<M, E, A>) => HKT2<M, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(mb: HKT2<M, E, B>) => HKT2<M, E, B>
- <A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): (ma: HKT2<M, E, A>) => HKT2<M, E, A>
- }
|