/** * The `Record` module enables dealing with Typescript's `Record` * type in a functional way, basically treating it as a `Functor` in `T`. * * @since 2.0.0 */ import { Applicative, Applicative1, Applicative2, Applicative2C, Applicative3, Applicative3C, Applicative4 } from './Applicative' import { Compactable1 } from './Compactable' import { Either } from './Either' import { Eq } from './Eq' import { Filterable1 } from './Filterable' import { FilterableWithIndex1, PredicateWithIndex, RefinementWithIndex } from './FilterableWithIndex' import { Foldable as FoldableHKT, Foldable1, Foldable2, Foldable3 } from './Foldable' import { FoldableWithIndex1 } from './FoldableWithIndex' import { Functor1 } from './Functor' import { FunctorWithIndex1 } from './FunctorWithIndex' import { HKT, Kind, Kind2, Kind3, Kind4, URIS, URIS2, URIS3, URIS4 } from './HKT' import { Magma } from './Magma' import { Monoid } from './Monoid' import { Option } from './Option' import { Ord } from './Ord' import { Predicate } from './Predicate' import { Refinement } from './Refinement' import * as Se from './Semigroup' import { Separated } from './Separated' import { Show } from './Show' import { Traversable1 } from './Traversable' import { TraversableWithIndex1 } from './TraversableWithIndex' import { Unfoldable, Unfoldable1 } from './Unfoldable' import { PipeableWilt1, PipeableWither1, Witherable1 } from './Witherable' import Semigroup = Se.Semigroup /** * Calculate the number of key/value pairs in a `Record`. * * @example * import { size } from "fp-ts/Record"; * * assert.deepStrictEqual(size({ a: true, b: 2, c: "three" }), 3); * * @since 2.0.0 */ export declare const size: (r: Record) => number /** * Test whether a `Record` is empty. * * @example * import { isEmpty } from "fp-ts/Record"; * * assert.deepStrictEqual(isEmpty({}), true); * assert.deepStrictEqual(isEmpty({ a: 3 }), false); * * @since 2.0.0 */ export declare const isEmpty: (r: Record) => boolean /** * The keys of a `Record`, sorted alphabetically. * * @example * import { keys } from "fp-ts/Record"; * * assert.deepStrictEqual(keys({ c: 1, a: 2, b: 3 }), ["a", "b", "c"]); * * @since 2.0.0 */ export declare const keys: (r: Record) => Array /** * Map a `Record` into an `Array`. * It passes each key/value pair to the iterating function and collects * the results in an array, sorted alphabetically by the original key. * * @example * import { collect } from 'fp-ts/Record' * import { Ord } from 'fp-ts/string' * * const f = (k: string, a: A) => `${k.toUpperCase()}-${a}`; * const x = { c: 3, a: "foo", b: false }; * assert.deepStrictEqual( * collect(Ord)(f)(x), * [ * "A-foo", * "B-false", * "C-3", * ] * ); * * @since 2.0.0 */ export declare function collect( O: Ord ): (f: (k: K, a: A) => B) => (r: Record) => Array /** * Use the overload constrained by `Ord` instead. * * @deprecated */ export declare function collect(f: (k: K, a: A) => B): (r: Record) => Array /** * Get a sorted `Array` of the key/value pairs contained in a `Record`. * Sorted alphabetically by key. * * @example * import { toArray } from 'fp-ts/Record' * * const x = { c: 3, a: "foo", b: false }; * assert.deepStrictEqual(toArray(x), [ * ["a", "foo"], * ["b", false], * ["c", 3], * ]); * * @category conversions * @since 2.0.0 */ export declare const toArray: (r: Record) => Array<[K, A]> /** * Unfolds a `Record` into a list of key/value pairs. * * Given an `Unfoldable` class type `U` such as `array` or `readonlyArray`, * it uses the `unfold` function to create an instance of `U`, * providing an iterating function that iterates over each * key/value pair in the record sorted alphabetically by key. * * @example * import { array, readonlyArray } from 'fp-ts' * import { toUnfoldable } from 'fp-ts/Record' * * assert.deepStrictEqual(toUnfoldable(array)({ b: 2, a: 1 }),[ [ 'a', 1 ], [ 'b', 2 ]]) * assert.deepStrictEqual(toUnfoldable(readonlyArray)({ b: 2, a: 1 }),[ [ 'a', 1 ], [ 'b', 2 ]]) * * @since 2.0.0 */ export declare function toUnfoldable( U: Unfoldable1 ): (r: Record) => Kind export declare function toUnfoldable(U: Unfoldable): (r: Record) => HKT /** * Insert or replace a key/value pair in a `Record`. * * @example * import { upsertAt } from 'fp-ts/Record' * * assert.deepStrictEqual(upsertAt("a", 5)({ a: 1, b: 2 }), { a: 5, b: 2 }); * assert.deepStrictEqual(upsertAt("c", 5)({ a: 1, b: 2 }), { a: 1, b: 2, c: 5 }); * * @since 2.10.0 */ export declare const upsertAt: (k: string, a: A) => (r: Record) => Record /** * Test whether or not a key exists in a `Record`. * * Note. This function is not pipeable because is a `Refinement`. * * @example * import { has } from 'fp-ts/Record' * * assert.deepStrictEqual(has("a", { a: 1, b: 2 }), true); * assert.deepStrictEqual(has("c", { a: 1, b: 2 }), false); * * @since 2.10.0 */ export declare const has: (k: string, r: Record) => k is K /** * Delete a key and value from a `Record`. * * @example * import { deleteAt } from 'fp-ts/Record' * * assert.deepStrictEqual(deleteAt("a")({ a: 1, b: 2 }), { b: 2 }); * assert.deepStrictEqual(deleteAt("c")({ a: 1, b: 2 }), { a: 1, b: 2 }); * * @since 2.0.0 */ export declare function deleteAt( k: K ): (r: Record) => Record, A> /** * Replace a key/value pair in a `Record`. * * @returns If the specified key exists it returns an `Option` containing a new `Record` * with the entry updated, otherwise it returns `None` * * @example * import { updateAt } from 'fp-ts/Record' * import { option } from 'fp-ts' * * assert.deepStrictEqual(updateAt("a", 3)({ a: 1, b: 2 }), option.some({ a: 3, b: 2 })); * assert.deepStrictEqual(updateAt("c", 3)({ a: 1, b: 2 }), option.none); * * @since 2.0.0 */ export declare const updateAt: (k: string, a: A) => (r: Record) => Option> /** * Applies a mapping function to one spcific key/value pair in a `Record`. * * @returns If the specified key exists it returns an `Option` containing a new `Record` * with the entry updated, otherwise it returns `None` * * @example * import { modifyAt } from 'fp-ts/Record' * import { option } from 'fp-ts' * * assert.deepStrictEqual(modifyAt("a", (x: number) => x * 3)({ a: 1, b: 2 }), option.some({ a: 3, b: 2 })); * assert.deepStrictEqual(modifyAt("c", (x: number) => x * 3)({ a: 1, b: 2 }), option.none); * * @since 2.0.0 */ export declare const modifyAt: ( k: string, f: (a: A) => A ) => (r: Record) => Option> /** * Delete a key and value from a `Record`, returning the value as well as the subsequent `Record`. * * @returns If the specified key exists it returns an `Option` containing a new `Record` * with the entry removed, otherwise it returns `None` * * @example * import { pop } from 'fp-ts/Record' * import { option } from 'fp-ts' * * assert.deepStrictEqual(pop("a")({ a: 1, b: 2, c: 3 }), option.some([1, { b: 2, c: 3 }])); * assert.deepStrictEqual(pop("x")({ a: 1, b: 2, c: 3 }), option.none); * * @since 2.0.0 */ export declare function pop( k: K ): (r: Record) => Option<[A, Record, A>]> /** * Test whether one `Record` contains all of the keys and values * contained in another `Record`. * * @example * import { isSubrecord } from 'fp-ts/Record' * import { string } from 'fp-ts' * * assert.deepStrictEqual( * isSubrecord(string.Eq)({ a: "foo", b: "bar", c: "baz" })({ a: "foo", b: "bar", c: "baz" }), * true * ); * assert.deepStrictEqual( * isSubrecord(string.Eq)({ a: "foo", b: "bar", c: "baz" })({ a: "foo", c: "baz" }), * true * ); * assert.deepStrictEqual( * isSubrecord(string.Eq)({ a: "foo", b: "bar", c: "baz" })({ a: "foo", b: "not-bar", c: "baz" }), * false * ); * assert.deepStrictEqual( * isSubrecord(string.Eq)({ a: "foo", b: "bar" })({ a: "foo", b: "bar", c: "baz" }), * false * ); * * @since 2.0.0 */ export declare const isSubrecord: (E: Eq) => { (that: Record): (me: Record) => boolean (me: Record, that: Record): boolean } /** * Lookup the value for a key in a `Record`. * * @returns If the specified key exists it returns an `Option` containing the value, * otherwise it returns `None` * * @example * import { lookup } from 'fp-ts/Record' * import { option } from 'fp-ts' * * assert.deepStrictEqual(lookup("b")({ a: "foo", b: "bar" }), option.some("bar")); * assert.deepStrictEqual(lookup("c")({ a: "foo", b: "bar" }), option.none); * * @since 2.0.0 */ export declare const lookup: { (k: string): (r: Record) => Option (k: string, r: Record): Option } /** * Map a `Record` passing the key/value pairs to the iterating function. * * @example * import { mapWithIndex } from "fp-ts/Record"; * * const f = (k: string, n: number) => `${k.toUpperCase()}-${n}`; * assert.deepStrictEqual(mapWithIndex(f)({ a: 3, b: 5 }), { a: "A-3", b: "B-5" }); * * @since 2.0.0 */ export declare const mapWithIndex: (f: (k: K, a: A) => B) => (fa: Record) => Record /** * Map a `Record` passing the values to the iterating function. * * @example * import { map } from "fp-ts/Record"; * * const f = (n: number) => `-${n}-`; * assert.deepStrictEqual(map(f)({ a: 3, b: 5 }), { a: "-3-", b: "-5-" }); * * @category mapping * @since 2.0.0 */ export declare const map: (f: (a: A) => B) => (fa: Record) => Record /** * Reduces a `Record` passing each key/value pair to the iterating function. * Entries are processed in the order, sorted by key according to * the given `Ord`. * * @example * import { reduceWithIndex } from "fp-ts/Record"; * import { Ord } from "fp-ts/string"; * * const x = { c: 3, a: "foo", b: false }; * assert.deepStrictEqual(reduceWithIndex(Ord)([] as string[], (k, b, a) => [...b, `${k}-${a}`])(x), [ * "a-foo", * "b-false", * "c-3", * ]); * * @since 2.0.0 */ export declare function reduceWithIndex( O: Ord ): (b: B, f: (k: K, b: B, a: A) => B) => (fa: Record) => B /** * Use the overload constrained by `Ord` instead. * * @deprecated */ export declare function reduceWithIndex( b: B, f: (k: K, b: B, a: A) => B ): (fa: Record) => B /** * Map and fold a `Record`. * Map the `Record` passing each key/value pair to the iterating function. * Then fold the results using the provided `Monoid`. * * @example * import { foldMapWithIndex } from "fp-ts/Record"; * import { Ord } from "fp-ts/string"; * import { Monoid } from "fp-ts/Monoid"; * * const m: Monoid = { empty: "", concat: (x: string, y: string) => (x ? `${x} -> ${y}` : `${y}`) }; * const f = (k:string, a: number) => `${k}-${a}` * const x = { c: 3, a: 1, b: 2 }; * assert.deepStrictEqual(foldMapWithIndex(Ord)(m)(f)(x), "a-1 -> b-2 -> c-3"); * * @since 2.0.0 */ export declare function foldMapWithIndex( O: Ord ): (M: Monoid) => (f: (k: K, a: A) => M) => (fa: Record) => M /** * Use the overload constrained by `Ord` instead. * * @deprecated */ export declare function foldMapWithIndex( M: Monoid ): (f: (k: K, a: A) => M) => (fa: Record) => M /** * Same as `reduceWithIndex`, but reduce starting from the right * (i.e. in reverse order, from the last to the first entry according to * the given `Ord`). * * @example * import { reduceRightWithIndex } from "fp-ts/Record"; * import { Ord } from "fp-ts/string"; * * const x = { c: 3, a: "foo", b: false }; * assert.deepStrictEqual(reduceRightWithIndex(Ord)([] as string[], (k, a, b) => [...b, `${k}-${a}`])(x), [ * "c-3", * "b-false", * "a-foo", * ]); * * @since 2.0.0 */ export declare function reduceRightWithIndex( O: Ord ): (b: B, f: (k: K, a: A, b: B) => B) => (fa: Record) => B /** * Use the overload constrained by `Ord` instead. * * @deprecated */ export declare function reduceRightWithIndex( b: B, f: (k: K, a: A, b: B) => B ): (fa: Record) => B /** * Create a `Record` with one key/value pair. * * @example * import { singleton } from "fp-ts/Record"; * * assert.deepStrictEqual(singleton("a", 1), { a: 1 }); * * @since 2.0.0 */ export declare const singleton: (k: string, a: A) => Record /** * @since 2.0.0 */ export declare function traverseWithIndex( F: Applicative4 ): ( f: (k: K, a: A) => Kind4 ) => (ta: Record) => Kind4> export declare function traverseWithIndex( F: Applicative3 ): ( f: (k: K, a: A) => Kind3 ) => (ta: Record) => Kind3> export declare function traverseWithIndex( F: Applicative3C ): ( f: (k: K, a: A) => Kind3 ) => (ta: Record) => Kind3> export declare function traverseWithIndex( F: Applicative2 ): (f: (k: K, a: A) => Kind2) => (ta: Record) => Kind2> export declare function traverseWithIndex( F: Applicative2C ): (f: (k: K, a: A) => Kind2) => (ta: Record) => Kind2> export declare function traverseWithIndex( F: Applicative1 ): (f: (k: K, a: A) => Kind) => (ta: Record) => Kind> export declare function traverseWithIndex( F: Applicative ): (f: (k: K, a: A) => HKT) => (ta: Record) => HKT> /** * @since 2.0.0 */ export declare function traverse( F: Applicative4 ): ( f: (a: A) => Kind4 ) => (ta: Record) => Kind4> export declare function traverse( F: Applicative3 ): (f: (a: A) => Kind3) => (ta: Record) => Kind3> export declare function traverse( F: Applicative3C ): (f: (a: A) => Kind3) => (ta: Record) => Kind3> export declare function traverse( F: Applicative2 ): (f: (a: A) => Kind2) => (ta: Record) => Kind2> export declare function traverse( F: Applicative2C ): (f: (a: A) => Kind2) => (ta: Record) => Kind2> export declare function traverse( F: Applicative1 ): (f: (a: A) => Kind) => (ta: Record) => Kind> export declare function traverse( F: Applicative ): (f: (a: A) => HKT) => (ta: Record) => HKT> /** * `Record` sequencing, * i.e., take a `Record` in which elements are monads * and return a monad of a `Record` of the base types. * The following example for instance shows sequencing * a `Record>` * into an `Option>`. * * `sequence` in `Record` is equivalent to `sequenceS` in `Apply.ts`. * * @example * import { sequence } from "fp-ts/Record"; * import { option } from "fp-ts"; * import { sequenceS } from "fp-ts/Apply"; * * assert.deepStrictEqual( * sequence(option.Applicative)({ a: option.some(1), b: option.some(2) }), * option.some({ a: 1, b: 2 }) * ); * assert.deepStrictEqual(sequence(option.Applicative)({ a: option.some(1), b: option.none }), option.none); * assert.deepStrictEqual( * sequence(option.Applicative)({ a: option.some(1), b: option.some(2) }), * sequenceS(option.Applicative)({ a: option.some(1), b: option.some(2) }) * ); * * @since 2.0.0 */ export declare function sequence( F: Applicative3 ): (ta: Record>) => Kind3> export declare function sequence( F: Applicative3C ): (ta: Record>) => Kind3> export declare function sequence( F: Applicative2 ): (ta: Record>) => Kind2> export declare function sequence( F: Applicative2C ): (ta: Record>) => Kind2> export declare function sequence( F: Applicative1 ): (ta: Record>) => Kind> export declare function sequence( F: Applicative ): (ta: Record>) => HKT> /** * @category filtering * @since 2.6.5 */ export declare const wither: PipeableWither1 /** * @category filtering * @since 2.6.5 */ export declare const wilt: PipeableWilt1 /** * Maps a `Record` with a function returning an `Either` and * partitions the resulting `Record` into `Left`s and `Right`s. * * @example * import { partitionMapWithIndex } from "fp-ts/Record" * import { either } from "fp-ts" * * const f = (key: string, a: number) => * a >= 0 ? either.right(`${key} is >= 0 (${a})`) : either.left(`${key} is < 0 (${a})`); * assert.deepStrictEqual(partitionMapWithIndex(f)({ a: -1, b: 2, c: 123 }), { * left: { * a: "a is < 0 (-1)", * }, * right: { * b: "b is >= 0 (2)", * c: "c is >= 0 (123)", * }, * }); * * @since 2.0.0 */ export declare const partitionMapWithIndex: ( f: (key: K, a: A) => Either ) => (fa: Record) => Separated, Record> /** * Partition a `Record` into two parts according to a predicate * that takes a key and a value. * * @example * import { partitionWithIndex } from "fp-ts/Record" * * assert.deepStrictEqual( * partitionWithIndex((key: string, a: number) => key.length <= 1 && a > 0)({ a: -1, b: 2, ccc: 7 }), * { * left: { * a: -1, * ccc: 7, * }, * right: { * b: 2, * }, * } * ); * * @since 2.0.0 */ export declare function partitionWithIndex( refinementWithIndex: RefinementWithIndex ): (fa: Record) => Separated, Record> export declare function partitionWithIndex( predicateWithIndex: PredicateWithIndex ): (fb: Record) => Separated, Record> export declare function partitionWithIndex( predicateWithIndex: PredicateWithIndex ): (fa: Record) => Separated, Record> /** * Maps a `Record` with an iterating function that takes key and value and * returns an `Option`, keeping only the `Some` values and discarding `None`s. * * @example * import { filterMapWithIndex } from "fp-ts/Record" * import { option } from "fp-ts" * * const f = (key: string, a: number) => (a >= 0 ? option.some(`${key}${a}`) : option.none); * assert.deepStrictEqual(filterMapWithIndex(f)({ a: -1, b: 2, c: 3 }), { * b: "b2", * c: "c3", * }); * * @since 2.0.0 */ export declare const filterMapWithIndex: ( f: (key: K, a: A) => Option ) => (fa: Record) => Record /** * Produce a new `Record` keeping only the entries that satisfy * a predicate taking key and value as input. * * @example * import { filterWithIndex } from "fp-ts/Record" * * assert.deepStrictEqual( * filterWithIndex((s: string, v: number) => s.length <= 1 && v > 0)({ a: 1, b: -2, ccc: 3 }), * { * a: 1, * } * ); * * @since 2.0.0 */ export declare function filterWithIndex( refinementWithIndex: RefinementWithIndex ): (fa: Record) => Record export declare function filterWithIndex( predicateWithIndex: PredicateWithIndex ): (fb: Record) => Record export declare function filterWithIndex( predicateWithIndex: PredicateWithIndex ): (fa: Record) => Record /** * Create a `Record` from a foldable collection of key/value pairs, using the * specified `Magma` to combine values for duplicate keys. * * @since 2.0.0 */ export declare function fromFoldable( M: Magma, F: Foldable3 ): (fka: Kind3) => Record export declare function fromFoldable( M: Magma, F: Foldable2 ): (fka: Kind2) => Record export declare function fromFoldable( M: Magma, F: Foldable1 ): (fka: Kind) => Record export declare function fromFoldable( M: Magma, F: FoldableHKT ): (fka: HKT) => Record /** * Alias of [`toArray`](#toArray). * * @example * import { toEntries } from 'fp-ts/Record' * * assert.deepStrictEqual(toEntries({ b: 2, a: 1 }), [['a', 1], ['b', 2]]) * * @since 2.12.0 * @category conversions */ export declare const toEntries: (r: Record) => [K, A][] /** * Converts an `Array` of `[key, value]` tuples into a `Record`. * * @example * import { fromEntries } from 'fp-ts/Record' * * assert.deepStrictEqual(fromEntries([['a', 1], ['b', 2], ['a', 3]]), { b: 2, a: 3 }) * * @since 2.12.0 * @category conversions */ export declare const fromEntries: (fa: [string, A][]) => Record /** * Create a `Record` from a foldable collection using the specified functions to * * - map to key/value pairs * - combine values for duplicate keys. * * @example * import { last } from 'fp-ts/Semigroup' * import { Foldable, zip } from 'fp-ts/Array' * import { identity } from 'fp-ts/function' * import { fromFoldableMap } from 'fp-ts/Record' * * export const zipObject = (keys: Array, values: Array): Record => * fromFoldableMap(last(), Foldable)(zip(keys, values), identity) * * assert.deepStrictEqual(zipObject(['a', 'b'], [1, 2, 3]), { a: 1, b: 2 }) * * interface User { * readonly id: string * readonly name: string * } * * const users: Array = [ * { id: 'id1', name: 'name1' }, * { id: 'id2', name: 'name2' }, * { id: 'id1', name: 'name3' } * ] * * assert.deepStrictEqual(fromFoldableMap(last(), Foldable)(users, user => [user.id, user]), { * id1: { id: 'id1', name: 'name3' }, * id2: { id: 'id2', name: 'name2' } * }) * * @since 2.0.0 */ export declare function fromFoldableMap( M: Magma, F: Foldable3 ): (fa: Kind3, f: (a: A) => [string, B]) => Record export declare function fromFoldableMap( M: Magma, F: Foldable2 ): (fa: Kind2, f: (a: A) => [string, B]) => Record export declare function fromFoldableMap( M: Magma, F: Foldable1 ): (fa: Kind, f: (a: A) => [string, B]) => Record export declare function fromFoldableMap( M: Magma, F: FoldableHKT ): (fa: HKT, f: (a: A) => [string, B]) => Record /** * Test if every value in a `Record` satisfies the predicate. * * @example * import { every } from "fp-ts/Record" * * assert.deepStrictEqual(every((n: number) => n >= 0)({ a: 1, b: 2 }), true); * assert.deepStrictEqual(every((n: number) => n >= 0)({ a: 1, b: -1 }), false); * * @since 2.0.0 */ export declare const every: { (refinement: Refinement): Refinement, Record> (predicate: Predicate): Predicate> } /** * Test if at least one value in a `Record` satisfies the predicate. * * @example * import { some } from "fp-ts/Record" * * assert.deepStrictEqual(some((n: number) => n >= 0)({ a: 1, b: -2 }), true); * assert.deepStrictEqual(some((n: number) => n >= 0)({ a: -1, b: -2 }), false); * * @since 2.0.0 */ export declare const some: (predicate: (a: A) => boolean) => (r: Record) => boolean /** * Given an `Eq` checks if a `Record` contains an entry with * value equal to a provided value. * * @example * import { elem } from "fp-ts/Record" * import { number } from "fp-ts" * * assert.deepStrictEqual(elem(number.Eq)(123, { foo: 123, bar: 234 }), true); * assert.deepStrictEqual(elem(number.Eq)(-7, { foo: 123, bar: 234 }), false); * * @since 2.0.0 */ export declare const elem: (E: Eq) => { (a: A): (fa: Record) => boolean (a: A, fa: Record): boolean } /** * Union of two `Record`s. * Takes two `Record`s and produces a `Record` combining all the * entries of the two inputs. * It uses the `concat` function of the provided `Magma` to * combine the elements with the same key. * * @example * import { union } from "fp-ts/Record"; * import { Magma } from "fp-ts/Magma"; * * const m1: Magma = { concat: (x: number, y: number) => x + y }; * assert.deepStrictEqual(union(m1)({ a: 3, c: 3 })({ a: 1, b: 2 }), { a: 4, b: 2, c: 3 }); * const m2: Magma = { concat: (x: number) => x }; * assert.deepStrictEqual(union(m2)({ a: 3, c: 3 })({ a: 1, b: 2 }), { a: 1, b: 2, c: 3 }); * * @since 2.11.0 */ export declare const union: ( M: Magma ) => (second: Record) => (first: Record) => Record /** * Intersection of two `Record`s. * Takes two `Record`s and produces a `Record` combining only the * entries of the two inputswith the same key. * It uses the `concat` function of the provided `Magma` to * combine the elements. * * @example * import { intersection } from "fp-ts/Record"; * import { Magma } from "fp-ts/Magma"; * * const m1: Magma = { concat: (x: number, y: number) => x + y }; * assert.deepStrictEqual(intersection(m1)({ a: 3, c: 3 })({ a: 1, b: 2 }), { a: 4}); * const m2: Magma = { concat: (x: number) => x }; * assert.deepStrictEqual(intersection(m2)({ a: 3, c: 3 })({ a: 1, b: 2 }), { a: 1}); * * @since 2.11.0 */ export declare const intersection: ( M: Magma ) => (second: Record) => (first: Record) => Record /** * Difference between two `Record`s. * Takes two `Record`s and produces a `Record` composed by the * entries of the two inputs, removing the entries with the same * key in both inputs. * * @example * import { difference } from "fp-ts/Record"; * * assert.deepStrictEqual(difference({ a: 1 })({ a: 1, b: 2 }), { b: 2 }); * assert.deepStrictEqual(difference({ a: 3 })({ a: 1, b: 2 }), { b: 2 }); * assert.deepStrictEqual(difference({ a: 3, c: 3 })({ a: 1, b: 2 }), { b: 2, c: 3 }); * * @since 2.11.0 */ export declare const difference: (second: Record) => (first: Record) => Record /** * Given a `Predicate`, it produces a new `Record` keeping only the entries with a * value that satisfies the provided predicate. * * @example * import { filter } from "fp-ts/Record" * * assert.deepStrictEqual(filter((s: string) => s.length < 4)({ a: "foo", b: "bar", c: "verylong" }), { * a: "foo", * b: "bar", * }); * * @category filtering * @since 2.0.0 */ export declare const filter: { (refinement: Refinement): (fa: Record) => Record (predicate: Predicate): (fb: Record) => Record (predicate: Predicate): (fa: Record) => Record } /** * Maps a `Record` with an iterating function that returns an `Option` * and it keeps only the `Some` values discarding the `None`s. * * @example * import { filterMap } from "fp-ts/Record" * import { option } from "fp-ts" * * const f = (s: string) => s.length < 4 ? option.some(`${s} is short`): option.none * assert.deepStrictEqual(filterMap(f)({ a: "foo", b: "bar", c: "verylong" }), { * a: "foo is short", * b: "bar is short", * }); * * @category filtering * @since 2.0.0 */ export declare const filterMap: (f: (a: A) => Option) => (fa: Record) => Record /** * Partition a `Record` into two parts according to a `Predicate`. * * @example * import { partition } from "fp-ts/Record" * * assert.deepStrictEqual(partition((s: string) => s.length < 4)({ a: "foo", b: "bar", c: "verylong" }), { * left:{ * c: "verylong" * }, * right: { * a: "foo", * b: "bar", * }, * }); * * @category filtering * @since 2.0.0 */ export declare const partition: { (refinement: Refinement): ( fa: Record ) => Separated, Record> (predicate: Predicate): (fb: Record) => Separated, Record> (predicate: Predicate): (fa: Record) => Separated, Record> } /** * Maps a `Record` with a function returning an `Either` and * partitions the resulting `Record` into `Left`s and `Right`s. * * @example * import { partitionMap } from "fp-ts/Record" * import { either } from "fp-ts" * * const f = (s: string) => (s.length < 4 ? either.right(`${s} is short`) : either.left(`${s} is not short`)); * assert.deepStrictEqual(partitionMap(f)({ a: "foo", b: "bar", c: "verylong" }), { * left: { * c: "verylong is not short", * }, * right: { * a: "foo is short", * b: "bar is short", * }, * }); * * @category filtering * @since 2.0.0 */ export declare const partitionMap: ( f: (a: A) => Either ) => (fa: Record) => Separated, Record> /** * Reduces a `Record` passing each value to the iterating function. * Entries are processed in order, sorted by key according to * the given `Ord`. * * @example * import { reduce } from "fp-ts/Record"; * import { Ord } from "fp-ts/string"; * * const x = { c: 3, a: "foo", b: false }; * assert.deepStrictEqual(reduce(Ord)([] as string[], (b, a) => [...b, `-${a}-`])(x), [ * "-foo-", * "-false-", * "-3-", * ]); * * @category folding * @since 2.0.0 */ export declare function reduce(O: Ord): (b: B, f: (b: B, a: A) => B) => (fa: Record) => B /** * Use the overload constrained by `Ord` instead. * * @deprecated */ export declare function reduce(b: B, f: (b: B, a: A) => B): (fa: Record) => B /** * Map and fold a `Record`. * Map the `Record` passing each value to the iterating function. * Then fold the results using the provided `Monoid`. * * @example * import { foldMap } from "fp-ts/Record"; * import { Ord } from "fp-ts/string"; * import { Monoid } from "fp-ts/Monoid"; * * const m: Monoid = { empty: "", concat: (x: string, y: string) => (x ? `${x} -> ${y}` : `${y}`) }; * const f = (a: number) => `-${a}-`; * const x = { c: 3, a: 1, b: 2 }; * assert.deepStrictEqual(foldMap(Ord)(m)(f)(x), "-1- -> -2- -> -3-"); * * @category folding * @since 2.0.0 */ export declare function foldMap( O: Ord ): (M: Monoid) => (f: (a: A) => M) => (fa: Record) => M /** * Use the overload constrained by `Ord` instead. * * @deprecated */ export declare function foldMap(M: Monoid): (f: (a: A) => M) => (fa: Record) => M /** * Same as `reduce` but entries are processed _from the right_, * i.e. in reverse order, from the last to the first entry, according to * the given `Ord`. * * @example * import { reduceRight } from "fp-ts/Record"; * import { Ord } from "fp-ts/string"; * * const x = { c: 3, a: "foo", b: false }; * assert.deepStrictEqual(reduceRight(Ord)([] as string[], (a, b) => [...b, `-${a}-`])(x), [ * "-3-", * "-false-", * "-foo-", * ]); * * @category folding * @since 2.0.0 */ export declare function reduceRight(O: Ord): (b: B, f: (a: A, b: B) => B) => (fa: Record) => B /** * Use the overload constrained by `Ord` instead. * * @deprecated */ export declare function reduceRight(b: B, f: (a: A, b: B) => B): (fa: Record) => B /** * Compact a `Record` of `Option`s discarding the `None` values and * keeping the `Some` values. * * @example * import { compact } from 'fp-ts/Record' * import { option } from 'fp-ts' * * assert.deepStrictEqual(compact({ a: option.some("foo"), b: option.none, c: option.some("bar") }), { * a: "foo", * c: "bar", * }); * * @category filtering * @since 2.0.0 */ export declare const compact: (fa: Record>) => Record /** * Separate a `Record` of `Either`s into `Left`s and `Right`s. * * @example * import { separate } from 'fp-ts/Record' * import { either } from 'fp-ts' * * assert.deepStrictEqual( * separate({ a: either.right("foo"), b: either.left("bar"), c: either.right("baz") }), * { * right: { * a: "foo", * c: "baz", * }, * left: { * b: "bar", * }, * } * ); * * @category filtering * @since 2.0.0 */ export declare const separate: ( fa: Record> ) => Separated, Record> /** * @category type lambdas * @since 2.0.0 */ export declare const URI = 'Record' /** * @category type lambdas * @since 2.0.0 */ export type URI = typeof URI declare module './HKT' { interface URItoKind { readonly [URI]: Record } } /** * Produces a `Show` for a `Record`, given a `Show` for the base type * (a `Show` produces a human-readable representation of an instance). * `Record` entries are sorted by key with the provided `Ord`. * * @example * import { getShow } from "fp-ts/Record" * import { Show } from "fp-ts/Show" * import { Ord } from "fp-ts/string" * * const sNumber: Show = { show: (n: number) => `${n}` }; * const sRecord: Show> = getShow(Ord)(sNumber); * assert.deepStrictEqual(sRecord.show({ b: 2, a: 1 }), '{ "a": 1, "b": 2 }'); * * @category instances * @since 2.0.0 */ export declare function getShow(O: Ord): (S: Show) => Show> /** * Use the overload constrained by `Ord` instead. * * @category zone of death * @deprecated */ export declare function getShow(S: Show): Show> /** * Given an `Eq` for the base type, it produces an `Eq` * for a `Record` of that base type. * * @example * import { getEq } from "fp-ts/Record"; * import { string } from "fp-ts"; * import { Eq } from "fp-ts/Eq"; * * const eq: Eq> = getEq(string.Eq); * assert.deepStrictEqual(eq.equals({ a: "foo" }, { b: "bar" }), false); * assert.deepStrictEqual(eq.equals({ a: "foo" }, { a: "foo" }), true); * * @category instances * @since 2.0.0 */ export declare const getEq: (E: Eq) => Eq> /** * Returns a `Monoid` instance for `Record`s, given a `Semigroup` * instance for the base type. * The `Monoid` makes the union of two `Record`s comining the * overlapping entries with the provided `Semigroup`. * * @example * import { SemigroupSum } from 'fp-ts/number' * import { getMonoid } from 'fp-ts/Record' * * const M = getMonoid(SemigroupSum); * assert.deepStrictEqual(M.concat({ foo: 123, bar: 234 }, { foo: 456, baz: 567 }), { foo: 579 , bar: 234, baz: 567 }); * * @category instances * @since 2.0.0 */ export declare const getMonoid: (S: Semigroup) => Monoid> /** * @category instances * @since 2.7.0 */ export declare const Functor: Functor1 /** * Takes a value and a `Record` of functions and returns a * `Record` by applying each function to the input value. * * @example * import { flap } from "fp-ts/Record" * * const fab = { x: (n: number) => `${n} times 2`, y: (n: number) => `${n * 2}` }; * assert.deepStrictEqual(flap(3)(fab), { * x: "3 times 2", * y: "6", * }); * * @category mapping * @since 2.10.0 */ export declare const flap: (a: A) => (fab: Record B>) => Record /** * @category instances * @since 2.7.0 */ export declare const FunctorWithIndex: FunctorWithIndex1 /** * Produces a `Foldable` instance for a `Record`, using the * provided `Ord` to sort the `Record`'s entries by key. * * @category folding * @since 2.11.0 */ export declare const getFoldable: (O: Ord) => Foldable1 /** * Produces a `FoldableWithIndex1` instance for a `Record`, using the * provided `Ord` to sort the `Record`'s entries by key. * * @category folding * @since 2.11.0 */ export declare const getFoldableWithIndex: (O: Ord) => FoldableWithIndex1 /** * @category instances * @since 2.7.0 */ export declare const Compactable: Compactable1 /** * @category instances * @since 2.7.0 */ export declare const Filterable: Filterable1 /** * @category instances * @since 2.7.0 */ export declare const FilterableWithIndex: FilterableWithIndex1 /** * Produces a `Traversable` instance for a `Record`, using the * provided `Ord` to sort the `Record`'s entries by key. * * @category traversing * @since 2.11.0 */ export declare const getTraversable: (O: Ord) => Traversable1 /** * Produces a `TraversableWithIndex` instance for a `Record`, using the * provided `Ord` to sort the `Record`'s entries by key. * * @category traversing * @since 2.11.0 */ export declare const getTraversableWithIndex: (O: Ord) => TraversableWithIndex1 /** * @category filtering * @since 2.11.0 */ export declare const getWitherable: (O: Ord) => Witherable1 /** * Given a `Semigroup` in the base type, it produces a `Semigroup` * in the `Record` of the base type. * The resulting `Semigroup` concatenates two `Record`s by * `union`. * * @example * import { getUnionSemigroup } from "fp-ts/Record" * import { Semigroup } from "fp-ts/Semigroup" * * const sNumber: Semigroup = { concat: (x, y) => x - y }; * const sRecord: Semigroup> = getUnionSemigroup(sNumber); * assert.deepStrictEqual(sRecord.concat({ a: 1, b: 2 }, { b: 3, c: 4 }), { a: 1, b: -1, c: 4 }); * * @category instances * @since 2.11.0 */ export declare const getUnionSemigroup: (S: Se.Semigroup) => Se.Semigroup> /** * Same as `getMonoid`. * Returns a `Monoid` instance for `Record`s given a `Semigroup` * instance for the base type. * The `Monoid` makes the union of two `Record`s combining the * entries that have the same key with the provided `Semigroup`. * * @example * import { SemigroupSum } from 'fp-ts/number' * import { getUnionMonoid } from 'fp-ts/Record' * * const M = getUnionMonoid(SemigroupSum); * assert.deepStrictEqual(M.concat({ foo: 123, bar: 234 }, { foo: 456, baz: 567 }), { foo: 579 , bar: 234, baz: 567 }); * * @category instances * @since 2.11.0 */ export declare const getUnionMonoid: (S: Se.Semigroup) => Monoid> /** * Given a `Semigroup` in the base type, it produces a `Semigroup` * in the `Record` of the base type. * The resulting `Semigroup` concatenates two `Record`s by * `intersection`. * * @example * import { getIntersectionSemigroup } from "fp-ts/Record" * import { Semigroup } from "fp-ts/Semigroup" * * const sNumber: Semigroup = { concat: (x, y) => x - y }; * const sRecord: Semigroup> = getIntersectionSemigroup(sNumber); * assert.deepStrictEqual(sRecord.concat({ a: 1, b: 2 }, { b: 3, c: 4 }), { b: -1 }); * * @category instances * @since 2.11.0 */ export declare const getIntersectionSemigroup: (S: Se.Semigroup) => Se.Semigroup> /** * Produces a `Magma` with a `concat` function that combines * two `Record`s by making the `difference`. * * @example * import { getDifferenceMagma, difference } from "fp-ts/Record" * import { Magma } from "fp-ts/Magma" * * const r1 = { a: 3, c: 3 }; * const r2 = { a: 1, b: 2 }; * const m: Magma> = getDifferenceMagma(); * assert.deepStrictEqual(m.concat(r1, r2), difference(r2)(r1)); * assert.deepStrictEqual(m.concat(r1, r2), { c: 3, b: 2 }); * * @category instances * @since 2.11.0 */ export declare const getDifferenceMagma: () => Magma> /** * Use `getFoldable` instead. * * @category zone of death * @since 2.7.0 * @deprecated */ export declare const Foldable: Foldable1 /** * Use `getFoldableWithIndex` instead. * * @category zone of death * @since 2.7.0 * @deprecated */ export declare const FoldableWithIndex: FoldableWithIndex1 /** * Use `getTraversable` instead. * * @category zone of death * @since 2.7.0 * @deprecated */ export declare const Traversable: Traversable1 /** * Use the `getTraversableWithIndex` instead. * * @category zone of death * @since 2.7.0 * @deprecated */ export declare const TraversableWithIndex: TraversableWithIndex1 /** * Use `getWitherable` instead. * * @category zone of death * @since 2.7.0 * @deprecated */ export declare const Witherable: Witherable1 /** * Use a new `{}` instead. * * @category zone of death * @since 2.0.0 * @deprecated */ export declare const empty: Record /** * Use [`upsertAt`](#upsertat) instead. * * @category zone of death * @since 2.0.0 * @deprecated */ export declare const insertAt: (k: string, a: A) => (r: Record) => Record /** * Use [`has`](#has) instead. * * @category zone of death * @since 2.0.0 * @deprecated */ export declare const hasOwnProperty: (k: string, r: Record) => k is K /** * This instance is deprecated, use small, specific instances instead. * For example if a function needs a `Functor` instance, pass `R.Functor` instead of `R.record` * (where `R` is from `import R from 'fp-ts/Record'`) * * @category zone of death * @since 2.0.0 * @deprecated */ export declare const record: FunctorWithIndex1 & FoldableWithIndex1 & FilterableWithIndex1 & TraversableWithIndex1 & Witherable1