veffect
Version:
powerful TypeScript validation library built on the robust foundation of Effect combining exceptional type safety, high performance, and developer experience. Taking inspiration from Effect's functional principles, VEffect delivers a balanced approach tha
898 lines (896 loc) • 26.3 kB
JavaScript
"use strict";
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.values = exports.union = exports.toEntries = exports.some = exports.size = exports.singleton = exports.set = exports.separate = exports.replaceOption = exports.replace = exports.remove = exports.reduce = exports.pop = exports.partitionMap = exports.partition = exports.modifyOption = exports.modify = exports.mapKeys = exports.mapEntries = exports.map = exports.keys = exports.isSubrecordBy = exports.isSubrecord = exports.isEmptyRecord = exports.isEmptyReadonlyRecord = exports.intersection = exports.has = exports.getSomes = exports.getRights = exports.getLefts = exports.getEquivalence = exports.get = exports.fromIterableWith = exports.fromIterableBy = exports.fromEntries = exports.filterMap = exports.filter = exports.every = exports.empty = exports.difference = exports.collect = void 0;
var E = /*#__PURE__*/_interopRequireWildcard( /*#__PURE__*/require("./Either.js"));
var Equal = /*#__PURE__*/_interopRequireWildcard( /*#__PURE__*/require("./Equal.js"));
var _Function = /*#__PURE__*/require("./Function.js");
var Option = /*#__PURE__*/_interopRequireWildcard( /*#__PURE__*/require("./Option.js"));
function _getRequireWildcardCache(e) {
if ("function" != typeof WeakMap) return null;
var r = new WeakMap(),
t = new WeakMap();
return (_getRequireWildcardCache = function (e) {
return e ? t : r;
})(e);
}
function _interopRequireWildcard(e, r) {
if (!r && e && e.__esModule) return e;
if (null === e || "object" != typeof e && "function" != typeof e) return {
default: e
};
var t = _getRequireWildcardCache(r);
if (t && t.has(e)) return t.get(e);
var n = {
__proto__: null
},
a = Object.defineProperty && Object.getOwnPropertyDescriptor;
for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) {
var i = a ? Object.getOwnPropertyDescriptor(e, u) : null;
i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u];
}
return n.default = e, t && t.set(e, n), n;
}
/**
* This module provides utility functions for working with records in TypeScript.
*
* @since 2.0.0
*/
/**
* Creates a new, empty record.
*
* @category constructors
* @since 2.0.0
*/
const empty = () => ({});
/**
* Determine if a record is empty.
*
* @param self - record to test for emptiness.
*
* @example
* import { isEmptyRecord } from "effect/ReadonlyRecord"
*
* assert.deepStrictEqual(isEmptyRecord({}), true);
* assert.deepStrictEqual(isEmptyRecord({ a: 3 }), false);
*
* @category guards
* @since 2.0.0
*/
exports.empty = empty;
const isEmptyRecord = self => keys(self).length === 0;
/**
* Determine if a record is empty.
*
* @param self - record to test for emptiness.
*
* @example
* import { isEmptyReadonlyRecord } from "effect/ReadonlyRecord"
*
* assert.deepStrictEqual(isEmptyReadonlyRecord({}), true);
* assert.deepStrictEqual(isEmptyReadonlyRecord({ a: 3 }), false);
*
* @category guards
* @since 2.0.0
*/
exports.isEmptyRecord = isEmptyRecord;
const isEmptyReadonlyRecord = exports.isEmptyReadonlyRecord = isEmptyRecord;
/**
* Takes an iterable and a projection function and returns a record.
* The projection function maps each value of the iterable to a tuple of a key and a value, which is then added to the resulting record.
*
* @param self - An iterable of values to be mapped to a record.
* @param f - A projection function that maps values of the iterable to a tuple of a key and a value.
*
* @example
* import { fromIterableWith } from "effect/ReadonlyRecord"
*
* const input = [1, 2, 3, 4]
*
* assert.deepStrictEqual(
* fromIterableWith(input, a => [String(a), a * 2]),
* { '1': 2, '2': 4, '3': 6, '4': 8 }
* )
*
* @category constructors
* @since 2.0.0
*/
const fromIterableWith = exports.fromIterableWith = /*#__PURE__*/(0, _Function.dual)(2, (self, f) => {
const out = empty();
for (const a of self) {
const [k, b] = f(a);
out[k] = b;
}
return out;
});
/**
* Creates a new record from an iterable, utilizing the provided function to determine the key for each element.
*
* @param items - An iterable containing elements.
* @param f - A function that extracts the key for each element.
*
* @example
* import { fromIterableBy } from "effect/ReadonlyRecord"
*
* const users = [
* { id: "2", name: "name2" },
* { id: "1", name: "name1" }
* ]
*
* assert.deepStrictEqual(
* fromIterableBy(users, user => user.id),
* {
* "2": { id: "2", name: "name2" },
* "1": { id: "1", name: "name1" }
* }
* )
*
* @category constructors
* @since 2.0.0
*/
const fromIterableBy = (items, f) => fromIterableWith(items, a => [f(a), a]);
/**
* Builds a record from an iterable of key-value pairs.
*
* If there are conflicting keys when using `fromEntries`, the last occurrence of the key/value pair will overwrite the
* previous ones. So the resulting record will only have the value of the last occurrence of each key.
*
* @param self - The iterable of key-value pairs.
*
* @example
* import { fromEntries } from "effect/ReadonlyRecord"
*
* const input: Array<[string, number]> = [["a", 1], ["b", 2]]
*
* assert.deepStrictEqual(fromEntries(input), { a: 1, b: 2 })
*
* @since 2.0.0
* @category constructors
*/
exports.fromIterableBy = fromIterableBy;
const fromEntries = exports.fromEntries = Object.fromEntries;
/**
* Transforms the values of a record into an `Array` with a custom mapping function.
*
* @param self - The record to transform.
* @param f - The custom mapping function to apply to each key/value of the record.
*
* @example
* import { collect } from "effect/ReadonlyRecord"
*
* const x = { a: 1, b: 2, c: 3 }
* assert.deepStrictEqual(collect(x, (key, n) => [key, n]), [["a", 1], ["b", 2], ["c", 3]])
*
* @category conversions
* @since 2.0.0
*/
const collect = exports.collect = /*#__PURE__*/(0, _Function.dual)(2, (self, f) => {
const out = [];
for (const key of keys(self)) {
out.push(f(key, self[key]));
}
return out;
});
/**
* Takes a record and returns an array of tuples containing its keys and values.
*
* @param self - The record to transform.
*
* @example
* import { toEntries } from "effect/ReadonlyRecord"
*
* const x = { a: 1, b: 2, c: 3 }
* assert.deepStrictEqual(toEntries(x), [["a", 1], ["b", 2], ["c", 3]])
*
* @category conversions
* @since 2.0.0
*/
const toEntries = exports.toEntries = /*#__PURE__*/collect((key, value) => [key, value]);
/**
* Returns the number of key/value pairs in a record.
*
* @param self - A record to calculate the number of key/value pairs in.
*
* @example
* import { size } from "effect/ReadonlyRecord";
*
* assert.deepStrictEqual(size({ a: "a", b: 1, c: true }), 3);
*
* @since 2.0.0
*/
const size = self => keys(self).length;
/**
* Check if a given `key` exists in a record.
*
* @param self - the record to look in.
* @param key - the key to look for in the record.
*
* @example
* import { empty, has } from "effect/ReadonlyRecord"
*
* assert.deepStrictEqual(has({ a: 1, b: 2 }, "a"), true);
* assert.deepStrictEqual(has(empty<string>(), "c"), false);
*
* @since 2.0.0
*/
exports.size = size;
const has = exports.has = /*#__PURE__*/(0, _Function.dual)(2, (self, key) => Object.prototype.hasOwnProperty.call(self, key));
/**
* Retrieve a value at a particular key from a record, returning it wrapped in an `Option`.
*
* @param self - The record to retrieve value from.
* @param key - Key to retrieve from record.
*
* @example
* import { get } from "effect/ReadonlyRecord"
* import { some, none } from "effect/Option"
*
* const person: Record<string, unknown> = { name: "John Doe", age: 35 }
*
* assert.deepStrictEqual(get(person, "name"), some("John Doe"))
* assert.deepStrictEqual(get(person, "email"), none())
*
* @since 2.0.0
*/
const get = exports.get = /*#__PURE__*/(0, _Function.dual)(2, (self, key) => has(self, key) ? Option.some(self[key]) : Option.none());
/**
* Apply a function to the element at the specified key, creating a new record.
* If the key does not exist, the record is returned unchanged.
*
* @param self - The record to be updated.
* @param key - The key of the element to modify.
* @param f - The function to apply to the element.
*
* @example
* import { modify } from "effect/ReadonlyRecord"
* import { some, none } from "effect/Option"
*
* const f = (x: number) => x * 2
*
* assert.deepStrictEqual(
* modify({ a: 3 }, 'a', f),
* { a: 6 }
* )
* assert.deepStrictEqual(
* modify({ a: 3 } as Record<string, number>, 'b', f),
* { a: 3 }
* )
*
* @since 2.0.0
*/
const modify = exports.modify = /*#__PURE__*/(0, _Function.dual)(3, (self, key, f) => {
if (!has(self, key)) {
return {
...self
};
}
return {
...self,
[key]: f(self[key])
};
});
/**
* Apply a function to the element at the specified key, creating a new record,
* or return `None` if the key doesn't exist.
*
* @param self - The record to be updated.
* @param key - The key of the element to modify.
* @param f - The function to apply to the element.
*
* @example
* import { modifyOption } from "effect/ReadonlyRecord"
* import { some, none } from "effect/Option"
*
* const f = (x: number) => x * 2
*
* assert.deepStrictEqual(
* modifyOption({ a: 3 }, 'a', f),
* some({ a: 6 })
* )
* assert.deepStrictEqual(
* modifyOption({ a: 3 } as Record<string, number>, 'b', f),
* none()
* )
*
* @since 2.0.0
*/
const modifyOption = exports.modifyOption = /*#__PURE__*/(0, _Function.dual)(3, (self, key, f) => {
if (!has(self, key)) {
return Option.none();
}
return Option.some({
...self,
[key]: f(self[key])
});
});
/**
* Replaces a value in the record with the new value passed as parameter.
*
* @param self - The record to be updated.
* @param key - The key to search for in the record.
* @param b - The new value to replace the existing value with.
*
* @example
* import { empty, replaceOption } from "effect/ReadonlyRecord"
* import { some, none } from "effect/Option"
*
* assert.deepStrictEqual(
* replaceOption({ a: 1, b: 2, c: 3 }, 'a', 10),
* some({ a: 10, b: 2, c: 3 })
* )
* assert.deepStrictEqual(replaceOption(empty<string>(), 'a', 10), none())
*
* @since 2.0.0
*/
const replaceOption = exports.replaceOption = /*#__PURE__*/(0, _Function.dual)(3, (self, key, b) => modifyOption(self, key, () => b));
/**
* If the given key exists in the record, returns a new record with the key removed,
* otherwise returns a copy of the original record.
*
* @param self - the record to remove the key from.
* @param key - the key to remove from the record.
*
* @example
* import { remove } from "effect/ReadonlyRecord"
*
* assert.deepStrictEqual(remove({ a: 1, b: 2 }, "a"), { b: 2 })
*
* @since 2.0.0
*/
const remove = exports.remove = /*#__PURE__*/(0, _Function.dual)(2, (self, key) => {
if (!has(self, key)) {
return {
...self
};
}
const out = {
...self
};
delete out[key];
return out;
});
/**
* Retrieves the value of the property with the given `key` from a record and returns an `Option`
* of a tuple with the value and the record with the removed property.
* If the key is not present, returns `O.none`.
*
* @param self - The input record.
* @param key - The key of the property to retrieve.
*
* @example
* import { pop } from "effect/ReadonlyRecord"
* import { some, none } from 'effect/Option'
*
* assert.deepStrictEqual(pop({ a: 1, b: 2 }, "a"), some([1, { b: 2 }]))
* assert.deepStrictEqual(pop({ a: 1, b: 2 } as Record<string, number>, "c"), none())
*
* @category record
* @since 2.0.0
*/
const pop = exports.pop = /*#__PURE__*/(0, _Function.dual)(2, (self, key) => has(self, key) ? Option.some([self[key], remove(self, key)]) : Option.none());
/**
* Maps a record into another record by applying a transformation function to each of its values.
*
* @param self - The record to be mapped.
* @param f - A transformation function that will be applied to each of the values in the record.
*
* @example
* import { map } from "effect/ReadonlyRecord"
*
* const f = (n: number) => `-${n}`
*
* assert.deepStrictEqual(map({ a: 3, b: 5 }, f), { a: "-3", b: "-5" })
*
* const g = (n: number, key: string) => `${key.toUpperCase()}-${n}`
*
* assert.deepStrictEqual(map({ a: 3, b: 5 }, g), { a: "A-3", b: "B-5" })
*
* @category mapping
* @since 2.0.0
*/
const map = exports.map = /*#__PURE__*/(0, _Function.dual)(2, (self, f) => {
const out = {
...self
};
for (const key of keys(self)) {
out[key] = f(self[key], key);
}
return out;
});
/**
* Maps the keys of a `ReadonlyRecord` while preserving the corresponding values.
*
* @example
* import { mapKeys } from "effect/ReadonlyRecord"
*
* assert.deepStrictEqual(mapKeys({ a: 3, b: 5 }, (key) => key.toUpperCase()), { A: 3, B: 5 })
*
* @category mapping
* @since 2.0.0
*/
const mapKeys = exports.mapKeys = /*#__PURE__*/(0, _Function.dual)(2, (self, f) => {
const out = {};
for (const key of keys(self)) {
const a = self[key];
out[f(key, a)] = a;
}
return out;
});
/**
* Maps entries of a `ReadonlyRecord` using the provided function, allowing modification of both keys and corresponding values.
*
* @example
* import { mapEntries } from "effect/ReadonlyRecord"
*
* assert.deepStrictEqual(mapEntries({ a: 3, b: 5 }, (a, key) => [key.toUpperCase(), a + 1]), { A: 4, B: 6 })
*
* @category mapping
* @since 2.0.0
*/
const mapEntries = exports.mapEntries = /*#__PURE__*/(0, _Function.dual)(2, (self, f) => {
const out = {};
for (const key of keys(self)) {
const [k, b] = f(self[key], key);
out[k] = b;
}
return out;
});
/**
* Transforms a record into a record by applying the function `f` to each key and value in the original record.
* If the function returns `Some`, the key-value pair is included in the output record.
*
* @param self - The input record.
* @param f - The transformation function.
*
* @example
* import { filterMap } from "effect/ReadonlyRecord"
* import { some, none } from 'effect/Option'
*
* const x = { a: 1, b: 2, c: 3 }
* const f = (a: number, key: string) => a > 2 ? some(a * 2) : none()
* assert.deepStrictEqual(filterMap(x, f), { c: 6 })
*
* @since 2.0.0
*/
const filterMap = exports.filterMap = /*#__PURE__*/(0, _Function.dual)(2, (self, f) => {
const out = empty();
for (const key of keys(self)) {
const o = f(self[key], key);
if (Option.isSome(o)) {
out[key] = o.value;
}
}
return out;
});
/**
* Selects properties from a record whose values match the given predicate.
*
* @param self - The record to filter.
* @param predicate - A function that returns a `boolean` value to determine if the entry should be included in the new record.
*
* @example
* import { filter } from "effect/ReadonlyRecord"
*
* const x = { a: 1, b: 2, c: 3, d: 4 }
* assert.deepStrictEqual(filter(x, (n) => n > 2), { c: 3, d: 4 })
*
* @category filtering
* @since 2.0.0
*/
const filter = exports.filter = /*#__PURE__*/(0, _Function.dual)(2, (self, predicate) => {
const out = empty();
for (const key of keys(self)) {
if (predicate(self[key], key)) {
out[key] = self[key];
}
}
return out;
});
/**
* Given a record with `Option` values, returns a new record containing only the `Some` values, preserving the original keys.
*
* @param self - A record with `Option` values.
*
* @example
* import { getSomes } from "effect/ReadonlyRecord"
* import { some, none } from "effect/Option"
*
* assert.deepStrictEqual(
* getSomes({ a: some(1), b: none(), c: some(2) }),
* { a: 1, c: 2 }
* )
*
* @category filtering
* @since 2.0.0
*/
const getSomes = exports.getSomes = /*#__PURE__*/filterMap(_Function.identity);
/**
* Given a record with `Either` values, returns a new record containing only the `Left` values, preserving the original keys.
*
* @example
* import { getLefts } from "effect/ReadonlyRecord"
* import { right, left } from "effect/Either"
*
* assert.deepStrictEqual(
* getLefts({ a: right(1), b: left("err"), c: right(2) }),
* { b: "err" }
* )
*
* @category filtering
* @since 2.0.0
*/
const getLefts = self => {
const out = empty();
for (const key of keys(self)) {
const value = self[key];
if (E.isLeft(value)) {
out[key] = value.left;
}
}
return out;
};
/**
* Given a record with `Either` values, returns a new record containing only the `Right` values, preserving the original keys.
*
* @example
* import { getRights } from "effect/ReadonlyRecord"
* import { right, left } from "effect/Either"
*
* assert.deepStrictEqual(
* getRights({ a: right(1), b: left("err"), c: right(2) }),
* { a: 1, c: 2 }
* )
*
* @category filtering
* @since 2.0.0
*/
exports.getLefts = getLefts;
const getRights = self => {
const out = empty();
for (const key of keys(self)) {
const value = self[key];
if (E.isRight(value)) {
out[key] = value.right;
}
}
return out;
};
/**
* Partitions the elements of a record into two groups: those that match a predicate, and those that don't.
*
* @param self - The record to partition.
* @param f - The predicate function to apply to each element.
*
* @example
* import { partitionMap } from "effect/ReadonlyRecord"
* import { left, right } from 'effect/Either'
*
* const x = { a: 1, b: 2, c: 3 }
* const f = (n: number) => (n % 2 === 0 ? right(n) : left(n))
* assert.deepStrictEqual(partitionMap(x, f), [{ a: 1, c: 3 }, { b: 2}])
*
* @category filtering
* @since 2.0.0
*/
exports.getRights = getRights;
const partitionMap = exports.partitionMap = /*#__PURE__*/(0, _Function.dual)(2, (self, f) => {
const left = empty();
const right = empty();
for (const key of keys(self)) {
const e = f(self[key], key);
if (E.isLeft(e)) {
left[key] = e.left;
} else {
right[key] = e.right;
}
}
return [left, right];
});
/**
* Partitions a record of `Either` values into two separate records,
* one with the `Left` values and one with the `Right` values.
*
* @param self - the record to partition.
*
* @example
* import { separate } from "effect/ReadonlyRecord"
* import { left, right } from 'effect/Either'
*
* assert.deepStrictEqual(
* separate({ a: left("e"), b: right(1) }),
* [{ a: "e" }, { b: 1 }]
* )
*
* @category filtering
* @since 2.0.0
*/
const separate = exports.separate = /*#__PURE__*/partitionMap(_Function.identity);
/**
* Partitions a record into two separate records based on the result of a predicate function.
*
* @param self - The input record to partition.
* @param predicate - The partitioning function to determine the partitioning of each value of the record.
*
* @example
* import { partition } from "effect/ReadonlyRecord"
*
* assert.deepStrictEqual(
* partition({ a: 1, b: 3 }, (n) => n > 2),
* [{ a: 1 }, { b: 3 }]
* )
*
* @category filtering
* @since 2.0.0
*/
const partition = exports.partition = /*#__PURE__*/(0, _Function.dual)(2, (self, predicate) => {
const left = empty();
const right = empty();
for (const key of keys(self)) {
if (predicate(self[key], key)) {
right[key] = self[key];
} else {
left[key] = self[key];
}
}
return [left, right];
});
/**
* Retrieve the keys of a given record as an array.
*
* @param self - The object for which you want to get the keys.
*
* @since 2.0.0
*/
const keys = self => Object.keys(self);
/**
* Retrieve the values of a given record as an array.
*
* @param self - The object for which you want to get the values.
*
* @since 2.0.0
*/
exports.keys = keys;
const values = self => collect(self, (_, a) => a);
/**
* Add a new key-value pair or update an existing key's value in a record.
*
* @param self - The record to which you want to add or update a key-value pair.
* @param key - The key you want to add or update.
* @param values - The value you want to associate with the key.
*
* @example
* import { set } from "effect/ReadonlyRecord"
*
* assert.deepStrictEqual(set("a", 5)({ a: 1, b: 2 }), { a: 5, b: 2 });
* assert.deepStrictEqual(set("c", 5)({ a: 1, b: 2 }), { a: 1, b: 2, c: 5 });
*
* @since 2.0.0
*/
exports.values = values;
const set = exports.set = /*#__PURE__*/(0, _Function.dual)(3, (self, key, value) => {
return {
...self,
[key]: value
};
});
/**
* Replace a key's value in a record and return the updated record.
* If the key does not exist in the record, a copy of the original record is returned.
*
* @param self - The original record.
* @param key - The key to replace.
* @param value - The new value to associate with the key.
*
* @example
* import { replace } from "effect/ReadonlyRecord"
* import { some, none } from "effect/Option"
*
* assert.deepStrictEqual(replace("a", 3)({ a: 1, b: 2 }), { a: 3, b: 2 });
* assert.deepStrictEqual(replace("c", 3)({ a: 1, b: 2 }), { a: 1, b: 2 });
*
* @since 2.0.0
*/
const replace = exports.replace = /*#__PURE__*/(0, _Function.dual)(3, (self, key, value) => {
if (has(self, key)) {
return {
...self,
[key]: value
};
}
return {
...self
};
});
/**
* Check if all the keys and values in one record are also found in another record.
*
* @param self - The first record to check.
* @param that - The second record to compare against.
* @param equivalence - A function to compare values.
*
* @since 2.0.0
*/
const isSubrecordBy = equivalence => (0, _Function.dual)(2, (self, that) => {
for (const key of keys(self)) {
if (!has(that, key) || !equivalence(self[key], that[key])) {
return false;
}
}
return true;
});
/**
* Check if one record is a subrecord of another, meaning it contains all the keys and values found in the second record.
* This comparison uses default equality checks (`Equal.equivalence()`).
*
* @param self - The first record to check.
* @param that - The second record to compare against.
*
* @since 2.0.0
*/
exports.isSubrecordBy = isSubrecordBy;
const isSubrecord = exports.isSubrecord = /*#__PURE__*/isSubrecordBy( /*#__PURE__*/Equal.equivalence());
/**
* Reduce a record to a single value by combining its entries with a specified function.
*
* @param self - The record to reduce.
* @param zero - The initial value of the accumulator.
* @param f - The function to combine entries (accumulator, value, key).
*
* @category folding
* @since 2.0.0
*/
const reduce = exports.reduce = /*#__PURE__*/(0, _Function.dual)(3, (self, zero, f) => {
let out = zero;
for (const key of keys(self)) {
out = f(out, self[key], key);
}
return out;
});
/**
* Check if all entries in a record meet a specific condition.
*
* @param self - The record to check.
* @param predicate - The condition to test entries (value, key).
*
* @since 2.0.0
*/
const every = exports.every = /*#__PURE__*/(0, _Function.dual)(2, (self, refinement) => {
for (const key of keys(self)) {
if (!refinement(self[key], key)) {
return false;
}
}
return true;
});
/**
* Check if any entry in a record meets a specific condition.
*
* @param self - The record to check.
* @param predicate - The condition to test entries (value, key).
*
* @since 2.0.0
*/
const some = exports.some = /*#__PURE__*/(0, _Function.dual)(2, (self, predicate) => {
for (const key of keys(self)) {
if (predicate(self[key], key)) {
return true;
}
}
return false;
});
/**
* Merge two records, preserving entries that exist in either of the records.
*
* @param self - The first record.
* @param that - The second record to combine with the first.
* @param combine - A function to specify how to merge entries with the same key.
*
* @since 2.0.0
*/
const union = exports.union = /*#__PURE__*/(0, _Function.dual)(3, (self, that, combine) => {
if (isEmptyRecord(self)) {
return {
...that
};
}
if (isEmptyRecord(that)) {
return {
...self
};
}
const out = empty();
for (const key of keys(self)) {
if (has(that, key)) {
out[key] = combine(self[key], that[key]);
} else {
out[key] = self[key];
}
}
for (const key of keys(that)) {
if (!has(out, key)) {
out[key] = that[key];
}
}
return out;
});
/**
* Merge two records, retaining only the entries that exist in both records.
*
* @param self - The first record.
* @param that - The second record to merge with the first.
* @param combine - A function to specify how to merge entries with the same key.
*
* @since 2.0.0
*/
const intersection = exports.intersection = /*#__PURE__*/(0, _Function.dual)(3, (self, that, combine) => {
const out = empty();
if (isEmptyRecord(self) || isEmptyRecord(that)) {
return out;
}
for (const key of keys(self)) {
if (has(that, key)) {
out[key] = combine(self[key], that[key]);
}
}
return out;
});
/**
* Merge two records, preserving only the entries that are unique to each record.
*
* @param self - The first record.
* @param that - The second record to compare with the first.
*
* @since 2.0.0
*/
const difference = exports.difference = /*#__PURE__*/(0, _Function.dual)(2, (self, that) => {
if (isEmptyRecord(self)) {
return {
...that
};
}
if (isEmptyRecord(that)) {
return {
...self
};
}
const out = {};
for (const key of keys(self)) {
if (!has(that, key)) {
out[key] = self[key];
}
}
for (const key of keys(that)) {
if (!has(self, key)) {
out[key] = that[key];
}
}
return out;
});
/**
* Create an `Equivalence` for records using the provided `Equivalence` for values.
*
* @param equivalence - An `Equivalence` for the values contained in the records.
*
* @category instances
* @since 2.0.0
*/
const getEquivalence = equivalence => {
const is = isSubrecordBy(equivalence);
return (self, that) => is(self, that) && is(that, self);
};
/**
* Create a non-empty record from a single element.
*
* @param key - The key for the element.
* @param value - The value associated with the key.
*
* @category constructors
* @since 2.0.0
*/
exports.getEquivalence = getEquivalence;
const singleton = (key, value) => ({
[key]: value
});
exports.singleton = singleton;
//# sourceMappingURL=ReadonlyRecord.js.map