effect 2.0.0-next.4 → 2.0.0-next.41

package/dist/declarations/src/Either.d.ts

@@ -0,0 +1,437 @@
+/**
+ * @since 2.0.0
+ */
+import type * as Data from "./Data.js";
+import * as Equivalence from "./Equivalence.js";
+import type { LazyArg } from "./Function.js";
+import type { TypeLambda } from "./HKT.js";
+import type { Inspectable } from "./Inspectable.js";
+import type { Option } from "./Option.js";
+import type { Pipeable } from "./Pipeable.js";
+import type * as Unify from "./Unify.js";
+import * as Gen from "./Utils.js";
+/**
+ * @category models
+ * @since 2.0.0
+ */
+export type Either<E, A> = Left<E, A> | Right<E, A>;
+/**
+ * @category symbols
+ * @since 2.0.0
+ */
+export declare const TypeId: unique symbol;
+/**
+ * @category symbols
+ * @since 2.0.0
+ */
+export type TypeId = typeof TypeId;
+/**
+ * @category models
+ * @since 2.0.0
+ */
+export interface Left<E, A> extends Data.Case, Pipeable, Inspectable {
+    readonly _tag: "Left";
+    readonly _op: "Left";
+    readonly left: E;
+    readonly [TypeId]: {
+        readonly _A: (_: never) => A;
+        readonly _E: (_: never) => E;
+    };
+    [Unify.typeSymbol]?: unknown;
+    [Unify.unifySymbol]?: EitherUnify<this>;
+    [Unify.blacklistSymbol]?: EitherUnifyBlacklist;
+}
+/**
+ * @category models
+ * @since 2.0.0
+ */
+export interface Right<E, A> extends Data.Case, Pipeable, Inspectable {
+    readonly _tag: "Right";
+    readonly _op: "Right";
+    readonly right: A;
+    readonly [TypeId]: {
+        readonly _A: (_: never) => A;
+        readonly _E: (_: never) => E;
+    };
+    [Unify.typeSymbol]?: unknown;
+    [Unify.unifySymbol]?: EitherUnify<this>;
+    [Unify.blacklistSymbol]?: EitherUnifyBlacklist;
+}
+/**
+ * @category models
+ * @since 2.0.0
+ */
+export interface EitherUnify<A extends {
+    [Unify.typeSymbol]?: any;
+}> {
+    Either?: () => A[Unify.typeSymbol] extends Either<infer E0, infer A0> | infer _ ? Either<E0, A0> : never;
+}
+/**
+ * @category models
+ * @since 2.0.0
+ */
+export interface EitherUnifyBlacklist {
+}
+/**
+ * @category type lambdas
+ * @since 2.0.0
+ */
+export interface EitherTypeLambda extends TypeLambda {
+    readonly type: Either<this["Out1"], this["Target"]>;
+}
+/**
+ * Constructs a new `Either` holding a `Right` value. This usually represents a successful value due to the right bias
+ * of this structure.
+ *
+ * @category constructors
+ * @since 2.0.0
+ */
+export declare const right: <A>(a: A) => Either<never, A>;
+/**
+ * Constructs a new `Either` holding a `Left` value. This usually represents a failure, due to the right-bias of this
+ * structure.
+ *
+ * @category constructors
+ * @since 2.0.0
+ */
+export declare const left: <E>(e: E) => Either<E, never>;
+/**
+ * Takes a lazy default and a nullable value, if the value is not nully (`null` or `undefined`), turn it into a `Right`, if the value is nully use
+ * the provided default as a `Left`.
+ *
+ * @example
+ * import * as Either from 'effect/Either'
+ *
+ * assert.deepStrictEqual(Either.fromNullable(1, () => 'fallback'), Either.right(1))
+ * assert.deepStrictEqual(Either.fromNullable(null, () => 'fallback'), Either.left('fallback'))
+ *
+ * @category constructors
+ * @since 2.0.0
+ */
+export declare const fromNullable: {
+    <A, E>(onNullable: (a: A) => E): (self: A) => Either<E, NonNullable<A>>;
+    <A, E>(self: A, onNullable: (a: A) => E): Either<E, NonNullable<A>>;
+};
+/**
+ * @example
+ * import * as Either from 'effect/Either'
+ * import * as Option from 'effect/Option'
+ *
+ * assert.deepStrictEqual(Either.fromOption(Option.some(1), () => 'error'), Either.right(1))
+ * assert.deepStrictEqual(Either.fromOption(Option.none(), () => 'error'), Either.left('error'))
+ *
+ * @category constructors
+ * @since 2.0.0
+ */
+export declare const fromOption: {
+    <A, E>(self: Option<A>, onNone: () => E): Either<E, A>;
+    <E>(onNone: () => E): <A>(self: Option<A>) => Either<E, A>;
+};
+declare const try_: {
+    <A, E>(options: {
+        readonly try: LazyArg<A>;
+        readonly catch: (error: unknown) => E;
+    }): Either<E, A>;
+    <A>(evaluate: LazyArg<A>): Either<unknown, A>;
+};
+export { 
+/**
+ * Imports a synchronous side-effect into a pure `Either` value, translating any
+ * thrown exceptions into typed failed eithers creating with `Either.left`.
+ *
+ * @category constructors
+ * @since 2.0.0
+ */
+try_ as try };
+/**
+ * Tests if a value is a `Either`.
+ *
+ * @param input - The value to test.
+ *
+ * @example
+ * import { isEither, left, right } from 'effect/Either'
+ *
+ * assert.deepStrictEqual(isEither(right(1)), true)
+ * assert.deepStrictEqual(isEither(left("a")), true)
+ * assert.deepStrictEqual(isEither({ right: 1 }), false)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+export declare const isEither: (input: unknown) => input is Either<unknown, unknown>;
+/**
+ * Determine if a `Either` is a `Left`.
+ *
+ * @param self - The `Either` to check.
+ *
+ * @example
+ * import { isLeft, left, right } from 'effect/Either'
+ *
+ * assert.deepStrictEqual(isLeft(right(1)), false)
+ * assert.deepStrictEqual(isLeft(left("a")), true)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+export declare const isLeft: <E, A>(self: Either<E, A>) => self is Left<E, A>;
+/**
+ * Determine if a `Either` is a `Right`.
+ *
+ * @param self - The `Either` to check.
+ *
+ * @example
+ * import { isRight, left, right } from 'effect/Either'
+ *
+ * assert.deepStrictEqual(isRight(right(1)), true)
+ * assert.deepStrictEqual(isRight(left("a")), false)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+export declare const isRight: <E, A>(self: Either<E, A>) => self is Right<E, A>;
+/**
+ * Converts a `Either` to an `Option` discarding the `Left`.
+ *
+ * Alias of {@link toOption}.
+ *
+ * @example
+ * import * as O from 'effect/Option'
+ * import * as E from 'effect/Either'
+ *
+ * assert.deepStrictEqual(E.getRight(E.right('ok')), O.some('ok'))
+ * assert.deepStrictEqual(E.getRight(E.left('err')), O.none())
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const getRight: <E, A>(self: Either<E, A>) => Option<A>;
+/**
+ * Converts a `Either` to an `Option` discarding the value.
+ *
+ * @example
+ * import * as O from 'effect/Option'
+ * import * as E from 'effect/Either'
+ *
+ * assert.deepStrictEqual(E.getLeft(E.right('ok')), O.none())
+ * assert.deepStrictEqual(E.getLeft(E.left('err')), O.some('err'))
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const getLeft: <E, A>(self: Either<E, A>) => Option<E>;
+/**
+ * @category equivalence
+ * @since 2.0.0
+ */
+export declare const getEquivalence: <E, A>(EE: Equivalence.Equivalence<E>, EA: Equivalence.Equivalence<A>) => Equivalence.Equivalence<Either<E, A>>;
+/**
+ * @category mapping
+ * @since 2.0.0
+ */
+export declare const mapBoth: {
+    <E1, E2, A, B>(options: {
+        readonly onLeft: (e: E1) => E2;
+        readonly onRight: (a: A) => B;
+    }): (self: Either<E1, A>) => Either<E2, B>;
+    <E1, A, E2, B>(self: Either<E1, A>, options: {
+        readonly onLeft: (e: E1) => E2;
+        readonly onRight: (a: A) => B;
+    }): Either<E2, B>;
+};
+/**
+ * Maps the `Left` side of an `Either` value to a new `Either` value.
+ *
+ * @param self - The input `Either` value to map.
+ * @param f - A transformation function to apply to the `Left` value of the input `Either`.
+ *
+ * @category mapping
+ * @since 2.0.0
+ */
+export declare const mapLeft: {
+    <E, G>(f: (e: E) => G): <A>(self: Either<E, A>) => Either<G, A>;
+    <E, A, G>(self: Either<E, A>, f: (e: E) => G): Either<G, A>;
+};
+/**
+ * Maps the `Right` side of an `Either` value to a new `Either` value.
+ *
+ * @param self - An `Either` to map
+ * @param f - The function to map over the value of the `Either`
+ *
+ * @category mapping
+ * @since 2.0.0
+ */
+export declare const map: {
+    <A, B>(f: (a: A) => B): <E>(self: Either<E, A>) => Either<E, B>;
+    <E, A, B>(self: Either<E, A>, f: (a: A) => B): Either<E, B>;
+};
+/**
+ * Takes two functions and an `Either` value, if the value is a `Left` the inner value is applied to the `onLeft function,
+ * if the value is a `Right` the inner value is applied to the `onRight` function.
+ *
+ * @example
+ * import * as E from 'effect/Either'
+ * import { pipe } from 'effect/Function'
+ *
+ * const onLeft  = (strings: ReadonlyArray<string>): string => `strings: ${strings.join(', ')}`
+ *
+ * const onRight = (value: number): string => `Ok: ${value}`
+ *
+ * assert.deepStrictEqual(pipe(E.right(1), E.match({ onLeft, onRight })), 'Ok: 1')
+ * assert.deepStrictEqual(
+ *   pipe(E.left(['string 1', 'string 2']), E.match({ onLeft, onRight })),
+ *   'strings: string 1, string 2'
+ * )
+ *
+ * @category pattern matching
+ * @since 2.0.0
+ */
+export declare const match: {
+    <E, B, A, C = B>(options: {
+        readonly onLeft: (e: E) => B;
+        readonly onRight: (a: A) => C;
+    }): (self: Either<E, A>) => B | C;
+    <E, A, B, C = B>(self: Either<E, A>, options: {
+        readonly onLeft: (e: E) => B;
+        readonly onRight: (a: A) => C;
+    }): B | C;
+};
+/**
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const merge: <E, A>(self: Either<E, A>) => E | A;
+/**
+ * Returns the wrapped value if it's a `Right` or a default value if is a `Left`.
+ *
+ * @example
+ * import * as Either from 'effect/Either'
+ *
+ * assert.deepStrictEqual(Either.getOrElse(Either.right(1), (error) => error + "!"), 1)
+ * assert.deepStrictEqual(Either.getOrElse(Either.left("not a number"), (error) => error + "!"), "not a number!")
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const getOrElse: {
+    <E, B>(onLeft: (e: E) => B): <A>(self: Either<E, A>) => B | A;
+    <E, A, B>(self: Either<E, A>, onLeft: (e: E) => B): A | B;
+};
+/**
+ * @example
+ * import * as Either from 'effect/Either'
+ *
+ * assert.deepStrictEqual(Either.getOrNull(Either.right(1)), 1)
+ * assert.deepStrictEqual(Either.getOrNull(Either.left("a")), null)
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const getOrNull: <E, A>(self: Either<E, A>) => A | null;
+/**
+ * @example
+ * import * as Either from 'effect/Either'
+ *
+ * assert.deepStrictEqual(Either.getOrUndefined(Either.right(1)), 1)
+ * assert.deepStrictEqual(Either.getOrUndefined(Either.left("a")), undefined)
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const getOrUndefined: <E, A>(self: Either<E, A>) => A | undefined;
+/**
+ * Extracts the value of an `Either` or throws if the `Either` is `Left`.
+ *
+ * If a default error is sufficient for your use case and you don't need to configure the thrown error, see {@link getOrThrow}.
+ *
+ * @param self - The `Either` to extract the value from.
+ * @param onLeft - A function that will be called if the `Either` is `Left`. It returns the error to be thrown.
+ *
+ * @example
+ * import * as E from "effect/Either"
+ *
+ * assert.deepStrictEqual(
+ *   E.getOrThrowWith(E.right(1), () => new Error('Unexpected Left')),
+ *   1
+ * )
+ * assert.throws(() => E.getOrThrowWith(E.left("error"), () => new Error('Unexpected Left')))
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const getOrThrowWith: {
+    <E>(onLeft: (e: E) => unknown): <A>(self: Either<E, A>) => A;
+    <E, A>(self: Either<E, A>, onLeft: (e: E) => unknown): A;
+};
+/**
+ * Extracts the value of an `Either` or throws if the `Either` is `Left`.
+ *
+ * The thrown error is a default error. To configure the error thrown, see  {@link getOrThrowWith}.
+ *
+ * @param self - The `Either` to extract the value from.
+ * @throws `Error("getOrThrow called on a Left")`
+ *
+ * @example
+ * import * as E from "effect/Either"
+ *
+ * assert.deepStrictEqual(E.getOrThrow(E.right(1)), 1)
+ * assert.throws(() => E.getOrThrow(E.left("error")))
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const getOrThrow: <E, A>(self: Either<E, A>) => A;
+/**
+ * Returns `self` if it is a `Right` or `that` otherwise.
+ *
+ * @param self - The input `Either` value to check and potentially return.
+ * @param that - A function that takes the error value from `self` (if it's a `Left`) and returns a new `Either` value.
+ *
+ * @category error handling
+ * @since 2.0.0
+ */
+export declare const orElse: {
+    <E1, E2, B>(that: (e1: E1) => Either<E2, B>): <A>(self: Either<E1, A>) => Either<E2, A | B>;
+    <E1, A, E2, B>(self: Either<E1, A>, that: (e1: E1) => Either<E2, B>): Either<E2, A | B>;
+};
+/**
+ * @category combining
+ * @since 2.0.0
+ */
+export declare const flatMap: {
+    <A, E2, B>(f: (a: A) => Either<E2, B>): <E1>(self: Either<E1, A>) => Either<E1 | E2, B>;
+    <E1, A, E2, B>(self: Either<E1, A>, f: (a: A) => Either<E2, B>): Either<E1 | E2, B>;
+};
+/**
+ * Takes a structure of `Option`s and returns an `Option` of values with the same structure.
+ *
+ * - If a tuple is supplied, then the returned `Option` will contain a tuple with the same length.
+ * - If a struct is supplied, then the returned `Option` will contain a struct with the same keys.
+ * - If an iterable is supplied, then the returned `Option` will contain an array.
+ *
+ * @param fields - the struct of `Option`s to be sequenced.
+ *
+ * @example
+ * import * as Either from "effect/Either"
+ *
+ * assert.deepStrictEqual(Either.all([Either.right(1), Either.right(2)]), Either.right([1, 2]))
+ * assert.deepStrictEqual(Either.all({ a: Either.right(1), b: Either.right("hello") }), Either.right({ a: 1, b: "hello" }))
+ * assert.deepStrictEqual(Either.all({ a: Either.right(1), b: Either.left("error") }), Either.left("error"))
+ *
+ * @category combining
+ * @since 2.0.0
+ */
+export declare const all: <const I extends Iterable<Either<any, any>> | Record<string, Either<any, any>>>(input: I) => [I] extends [ReadonlyArray<Either<any, any>>] ? Either<I[number] extends never ? never : [I[number]] extends [Either<infer E, any>] ? E : never, {
+    -readonly [K in keyof I]: [I[K]] extends [Either<any, infer A>] ? A : never;
+}> : [I] extends [Iterable<Either<infer E, infer A>>] ? Either<E, Array<A>> : Either<I[keyof I] extends never ? never : [I[keyof I]] extends [Either<infer E, any>] ? E : never, {
+    -readonly [K in keyof I]: [I[K]] extends [Either<any, infer A>] ? A : never;
+}>;
+/**
+ * @since 2.0.0
+ */
+export declare const reverse: <E, A>(self: Either<E, A>) => Either<A, E>;
+/**
+ * @category generators
+ * @since 2.0.0
+ */
+export declare const gen: Gen.Gen<EitherTypeLambda, Gen.Adapter<EitherTypeLambda>>;
+//# sourceMappingURL=Either.d.ts.map

package/dist/declarations/src/Either.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Either.d.ts","sourceRoot":"../../../src","sources":["Either.ts"],"names":[],"mappings":"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"}

package/dist/declarations/src/Encoding.d.ts

@@ -0,0 +1,110 @@
+/**
+ * This module provides encoding & decoding functionality for:
+ *
+ * - base64 (RFC4648)
+ * - base64 (URL)
+ * - hex
+ *
+ * @since 2.0.0
+ */
+import * as Either from "./Either.js";
+/**
+ * Encodes the given value into a base64 (RFC4648) `string`.
+ *
+ * @category encoding
+ * @since 2.0.0
+ */
+export declare const encodeBase64: (input: Uint8Array | string) => string;
+/**
+ * Decodes a base64 (RFC4648) encoded `string` into a `Uint8Array`.
+ *
+ * @category decoding
+ * @since 2.0.0
+ */
+export declare const decodeBase64: (str: string) => Either.Either<DecodeException, Uint8Array>;
+/**
+ * Decodes a base64 (RFC4648) encoded `string` into a UTF-8 `string`.
+ *
+ * @category decoding
+ * @since 2.0.0
+ */
+export declare const decodeBase64String: (str: string) => Either.Either<DecodeException, string>;
+/**
+ * Encodes the given value into a base64 (URL) `string`.
+ *
+ * @category encoding
+ * @since 2.0.0
+ */
+export declare const encodeBase64Url: (input: Uint8Array | string) => string;
+/**
+ * Decodes a base64 (URL) encoded `string` into a `Uint8Array`.
+ *
+ * @category decoding
+ * @since 2.0.0
+ */
+export declare const decodeBase64Url: (str: string) => Either.Either<DecodeException, Uint8Array>;
+/**
+ * Decodes a base64 (URL) encoded `string` into a UTF-8 `string`.
+ *
+ * @category decoding
+ * @since 2.0.0
+ */
+export declare const decodeBase64UrlString: (str: string) => Either.Either<DecodeException, string>;
+/**
+ * Encodes the given value into a hex `string`.
+ *
+ * @category encoding
+ * @since 2.0.0
+ */
+export declare const encodeHex: (input: Uint8Array | string) => string;
+/**
+ * Decodes a hex encoded `string` into a `Uint8Array`.
+ *
+ * @category decoding
+ * @since 2.0.0
+ */
+export declare const decodeHex: (str: string) => Either.Either<DecodeException, Uint8Array>;
+/**
+ * Decodes a hex encoded `string` into a UTF-8 `string`.
+ *
+ * @category decoding
+ * @since 2.0.0
+ */
+export declare const decodeHexString: (str: string) => Either.Either<DecodeException, string>;
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export declare const DecodeExceptionTypeId: unique symbol;
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export type DecodeExceptionTypeId = typeof DecodeExceptionTypeId;
+/**
+ * Represents a checked exception which occurs when decoding fails.
+ *
+ * @since 2.0.0
+ * @category models
+ */
+export interface DecodeException {
+    readonly _tag: "DecodeException";
+    readonly [DecodeExceptionTypeId]: DecodeExceptionTypeId;
+    readonly input: string;
+    readonly message?: string;
+}
+/**
+ * Creates a checked exception which occurs when decoding fails.
+ *
+ * @since 2.0.0
+ * @category errors
+ */
+export declare const DecodeException: (input: string, message?: string) => DecodeException;
+/**
+ * Returns `true` if the specified value is an `DecodeException`, `false` otherwise.
+ *
+ * @since 2.0.0
+ * @category refinements
+ */
+export declare const isDecodeException: (u: unknown) => u is DecodeException;
+//# sourceMappingURL=Encoding.d.ts.map

package/dist/declarations/src/Encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Encoding.d.ts","sourceRoot":"../../../src","sources":["Encoding.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,oBAAgB;AAMlC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,KAAK,MACqC,CAAA;AAEhG;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,aAAa,CAAC,eAAe,EAAE,UAAU,CAAuB,CAAA;AAE3G;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAS,MAAM,2CAAmE,CAAA;AAEjH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,KAAK,MACwC,CAAA;AAEtG;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,MAAM,KAAG,aAAa,CAAC,eAAe,EAAE,UAAU,CAA0B,CAAA;AAEjH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAS,MAAM,2CAAsE,CAAA;AAEvH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,KAAK,MACkC,CAAA;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAS,MAAM,KAAG,aAAa,CAAC,eAAe,EAAE,UAAU,CAAoB,CAAA;AAErG;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,MAAM,2CAAgE,CAAA;AAE3G;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,MAAqC,CAAA;AAEhF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,eAAwC,CAAA;AAE3G;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,IAAI,eAA0C,CAAA"}

package/dist/declarations/src/Equal.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @since 2.0.0
+ */
+import type { Equivalence } from "./Equivalence.js";
+import * as Hash from "./Hash.js";
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export declare const symbol: unique symbol;
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export interface Equal extends Hash.Hash {
+    [symbol](that: Equal): boolean;
+}
+/**
+ * @since 2.0.0
+ * @category equality
+ */
+export declare function equals<B>(that: B): <A>(self: A) => boolean;
+export declare function equals<A, B>(self: A, that: B): boolean;
+/**
+ * @since 2.0.0
+ * @category guards
+ */
+export declare const isEqual: (u: unknown) => u is Equal;
+/**
+ * @since 2.0.0
+ * @category instances
+ */
+export declare const equivalence: <A>() => Equivalence<A>;
+//# sourceMappingURL=Equal.d.ts.map

package/dist/declarations/src/Equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Equal.d.ts","sourceRoot":"../../../src","sources":["Equal.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,yBAAqB;AAChD,OAAO,KAAK,IAAI,kBAAc;AAE9B;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,OAAO,MAAmC,CAAA;AAE/D;;;GAGG;AACH,MAAM,WAAW,KAAM,SAAQ,IAAI,CAAC,IAAI;IACtC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAA;CAC/B;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;AAC3D,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAA;AA4BvD;;;GAGG;AACH,eAAO,MAAM,OAAO,MAAO,OAAO,eAAmE,CAAA;AAErG;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,CAA4C,CAAA"}