UNPKG

@typed/fp

Version:

Data Structures and Resources for fp-ts

298 lines 8.98 kB
/** * @typed/fp/FxEnv is a generator-based do-notation for Env. * * @since 0.13.0 */ import { Applicative2 } from 'fp-ts/Applicative'; import * as Ap from 'fp-ts/Apply'; import * as Ch from 'fp-ts/Chain'; import { ChainRec2 } from 'fp-ts/ChainRec'; import { FromReader2 } from 'fp-ts/FromReader'; import * as F from 'fp-ts/Functor'; import * as IO from 'fp-ts/IO'; import { Monad2 } from 'fp-ts/Monad'; import { Pointed2 } from 'fp-ts/Pointed'; import * as R from 'fp-ts/Reader'; import * as T from 'fp-ts/Task'; import * as E from './Env'; import { Fx } from './Fx'; import * as FxT from './FxT'; import * as P from './Provide'; import * as Re from './Resume'; /** * @category Constructor * @since 0.13.0 */ export declare const of: <A, E = unknown>(value: A) => Fx<E.Env<E, A>, A, unknown>; /** * @category Combinator * @since 0.13.0 */ export declare const ap: <E1, A>(fa: Fx<E.Env<E1, unknown>, A, unknown>) => <E2, B>(fab: Fx<E.Env<E2, unknown>, import("./function").Arity1<A, B>, unknown>) => Fx<E.Env<E1 & E2, unknown>, B, unknown>; /** * @category Combinator * @since 0.13.0 */ export declare const chain: <A, E1, B>(f: (value: A) => Fx<E.Env<E1, unknown>, B, unknown>) => <E2>(fx: Fx<E.Env<E2, unknown>, A, unknown>) => Fx<E.Env<E1 & E2, unknown>, B, unknown>; /** * @category Combinator * @since 0.13.0 */ export declare const chainRec: <A, E, B>(f: import("./function").Arity1<A, Fx<E.Env<E, unknown>, import("fp-ts/Either").Either<A, B>, unknown>>) => (a: A) => Fx<E.Env<E, unknown>, B, unknown>; /** * @category Combinator * @since 0.13.0 */ export declare const doEnv: <Y extends E.Env<any, any>, R, N = unknown>(f: (lift: FxT.LiftFx2<"@typed/fp/Env">) => Generator<Y, R, N>) => Fx<Y, R, N>; /** * @category Combinator * @since 0.13.0 */ export declare const liftEnv: FxT.LiftFx2<"@typed/fp/Env">; /** * @category Combinator * @since 0.13.0 */ export declare const map: <A, B>(f: (value: A) => B) => <E>(fx: Fx<E.Env<E, unknown>, A, unknown>) => Fx<E.Env<E, unknown>, B, unknown>; /** * @category Interpreter * @since 0.13.0 */ export declare const toEnv: <Y extends E.Env<any, any>, R>(fx: Fx<Y, R, unknown>) => [Y] extends [E.Env<infer E, any>] ? E.Env<E, R> : never; /** * @category Interpreter * @since 0.13.0 */ export declare const Do: <Y extends E.Env<any, any>, R, N = unknown>(f: (lift: FxT.LiftFx2<"@typed/fp/Env">) => Generator<Y, R, N>) => [Y] extends [E.Env<infer E, any>] ? E.Env<E, R> : never; /** * @category Combinator * @since 0.13.0 */ export declare const useSome: <A>(provided: A) => <B, T>(fx: Fx<E.Env<A & B, unknown>, T, unknown>) => Fx<E.Env<B, unknown>, T, unknown>; /** * @category Combinator * @since 0.13.0 */ export declare const useAll: <A>(provided: A) => <T>(fx: Fx<E.Env<A, unknown>, T, unknown>) => Fx<E.Env<unknown, unknown>, T, unknown>; /** * @category Combinator * @since 0.13.0 */ export declare const provideSome: <A>(provided: A) => <B, T>(fx: Fx<E.Env<A & B, unknown>, T, unknown>) => Fx<E.Env<B, unknown>, T, unknown>; /** * @category Combinator * @since 0.13.0 */ export declare const provideAll: <A>(provided: A) => <T>(fx: Fx<E.Env<A, unknown>, T, unknown>) => Fx<E.Env<unknown, unknown>, T, unknown>; /** * @category Constructor * @since 0.13.0 */ export declare const fromIO: <A, E = unknown>(fa: IO.IO<A>) => Fx<E.Env<E, A>, A, unknown>; /** * @category Constructor * @since 0.13.0 */ export declare const fromResume: <A, E = unknown>(fa: Re.Resume<A>) => Fx<E.Env<E, A>, A, unknown>; /** * @category Constructor * @since 0.13.0 */ export declare const fromTask: <A, E = unknown>(fa: T.Task<A>) => Fx<E.Env<E, A>, A, unknown>; /** * @category ConstructorfromReader * @since 0.13.0 */ export declare const asks: <E, A>(fa: R.Reader<E, A>) => Fx<E.Env<E, A>, A, unknown>; /** * @category Constructor * @since 0.13.0 */ export declare const ask: <A>() => Fx<E.Env<A, A>, A, unknown>; /** * @category URI * @since 0.13.0 */ export declare const URI = "@typed/fp/Fx/Env"; /** * @category URI * @since 0.13.0 */ export declare type URI = typeof URI; /** * @category Model * @since 0.13.0 */ export interface FxEnv<E, A> extends Fx<E.Env<E, unknown>, A> { } /** * @category Type-level * @since 0.13.0 */ export declare type GetRequirements<A> = A extends FxEnv<infer E, any> ? E : never; /** * @category Type-level * @since 0.13.0 */ export declare type GetValue<A> = A extends FxEnv<any, infer R> ? R : never; declare module 'fp-ts/HKT' { interface URItoKind2<E, A> { [URI]: FxEnv<E, A>; } } /** * @category Instance * @since 0.13.0 */ export declare const Pointed: Pointed2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const Functor: F.Functor2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const Apply: Ap.Apply2<URI>; /** * @category Combinator * @since 0.13.0 */ export declare const apFirst: <E, B>(second: FxEnv<E, B>) => <A>(first: FxEnv<E, A>) => FxEnv<E, A>; /** * @category Combinator * @since 0.13.0 */ export declare const apFirstW: <E1, B>(second: FxEnv<E1, B>) => <E2, A>(first: FxEnv<E2, A>) => FxEnv<E1 & E2, A>; /** * @category Combinator * @since 0.13.0 */ export declare const apS: <N extends string, A, E, B>(name: Exclude<N, keyof A>, fb: FxEnv<E, B>) => (fa: FxEnv<E, A>) => FxEnv<E, { readonly [K in N | keyof A]: K extends keyof A ? A[K] : B; }>; /** * @category Combinator * @since 0.13.0 */ export declare const apSW: <N extends string, A, E1, B>(name: Exclude<N, keyof A>, fb: FxEnv<E1, B>) => <E2>(fa: FxEnv<E2, A>) => FxEnv<E1 & E2, { readonly [K in N | keyof A]: K extends keyof A ? A[K] : B; }>; /** * @category Combinator * @since 0.13.0 */ export declare const apSecond: <E, B>(second: FxEnv<E, B>) => <A>(first: FxEnv<E, A>) => FxEnv<E, B>; /** * @category Combinator * @since 0.13.0 */ export declare const apSecondW: <E1, B>(second: FxEnv<E1, B>) => <E2, A>(first: FxEnv<E2, A>) => FxEnv<E1 & E2, A>; /** * @category Combinator * @since 0.13.0 */ export declare const apT: <E, B>(fb: FxEnv<E, B>) => <A extends readonly unknown[]>(fas: FxEnv<E, A>) => FxEnv<E, readonly [...A, B]>; /** * @category Combinator * @since 0.13.0 */ export declare const apTW: <E1, B>(fb: FxEnv<E1, B>) => <E2, A extends readonly unknown[]>(fas: FxEnv<E2, A>) => FxEnv<E1 & E2, readonly [...A, B]>; /** * @category Combinator * @since 0.13.0 */ export declare const getApplySemigroup: <A, E>(S: import("fp-ts/Semigroup").Semigroup<A>) => import("fp-ts/Semigroup").Semigroup<FxEnv<E, A>>; /** * @category Instance * @since 0.13.0 */ export declare const Applicative: Applicative2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const Chain: Ch.Chain2<URI>; /** * @category Combinator * @since 0.13.0 */ export declare const bind: <N extends string, A, E, B>(name: Exclude<N, keyof A>, f: (a: A) => FxEnv<E, B>) => (ma: FxEnv<E, A>) => FxEnv<E, { readonly [K in N | keyof A]: K extends keyof A ? A[K] : B; }>; /** * @category Combinator * @since 0.13.0 */ export declare const chainFirst: <A, E, B>(f: (a: A) => FxEnv<E, B>) => (first: FxEnv<E, A>) => FxEnv<E, A>; /** * @category Instance * @since 0.13.0 */ export declare const Monad: Monad2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const ChainRec: ChainRec2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const UseSome: P.UseSome2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const UseAll: P.UseAll2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const ProvideSome: P.ProvideSome2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const ProvideAll: P.ProvideAll2<URI>; /** * @category Instance * @since 0.13.0 */ export declare const Provide: P.Provide2<URI>; /** * @since 0.13.0 * @category Constructor */ export declare const fromReader: <R, A>(ma: R.Reader<R, A>) => Fx<E.Env<R, A>, A, unknown>; /** * @category Instance * @since 0.13.0 */ export declare const FromReader: FromReader2<URI>; /** * @since 0.13.0 * @category Combinator */ export declare const provideAllWith: <R, A>(provider: FxEnv<R, A>) => <B>(hkt: FxEnv<A, B>) => FxEnv<R, B>; /** * @since 0.13.0 * @category Combinator */ export declare const useAllWith: <R, A>(provider: FxEnv<R, A>) => <B>(hkt: FxEnv<A, B>) => FxEnv<R, B>; /** * @since 0.13.0 * @category Combinator */ export declare const provideSomeWith: <E1, A>(provider: FxEnv<E1, A>) => P.Provider2<"@typed/fp/Fx/Env", A, E1>; /** * @since 0.13.0 * @category Combinator */ export declare const useSomeWith: <E1, A>(provider: FxEnv<E1, A>) => P.Provider2<"@typed/fp/Fx/Env", A, E1>; /** * @since 0.13.0 * @category Combinator */ export declare const askAndUse: <E, B>(hkt: FxEnv<E, B>) => FxEnv<E, FxEnv<unknown, B>>; /** * @since 0.13.0 * @category Combinator */ export declare const askAndProvide: <E, B>(hkt: FxEnv<E, B>) => FxEnv<E, FxEnv<unknown, B>>; //# sourceMappingURL=FxEnv.d.ts.map