/common/internal.ts | rimbu@1.2.0

import * as rimbu from "https://deno.land/x/rimbu@1.2.0/common/internal.ts";

Namespaces

N AsyncOptLazy
N CollectFun
N Comp
N Eq
N ErrBase
N IndexRange
N Range

Classes

c ErrBase.CustomError abstract	A custom error instance.
c ErrBase.ForcedError

Variables

v CollectFun.Skip	Indicates, when returned from a collect function, to skip the value.
v Eq.objectIs	An Eq instance that uses `Object.is` to determine if two objects are equal.

Functions

f AsyncOptLazy.toMaybePromise	Returns the value or promised value contained in an `AsyncOptLazy` instance of type T.
f AsyncOptLazy.toPromise	Returns the value contained in an `AsyncOptLazy` instance of type T as a promise.
f Comp.anyDeepComp	Returns a Comp instance that compares any value using default comparison functions. For Iterables and objects, their elements are compared recursively.
f Comp.anyFlatComp	Returns a Comp instance that compares any value using default comparison functions, but never recursively compares Iterables or objects. In those cases, it will use the stringComp instance.
f Comp.anyShallowComp	Returns a Comp instance that compares any value using default comparison functions. For Iterables and objects, their elements are compared only one level deep for performance and to avoid infinite recursion.
f Comp.anyStringJSONComp	Returns a Comp instance converts values to string with JSON.stringify, and orders the resulting string naturally.
f Comp.anyToStringComp	Returns a any Comp instance that orders any according to their toString values.
f Comp.bigIntComp	Returns a default bigint Comp instance that orders bigint numbers naturally.
f Comp.booleanComp	Returns a default boolean Comp instance that orders booleans according to false < true.
f Comp.createValueOfComp	Returns a Comp instance that orders objects with a `valueOf` method according to the given `valueComp` instance for the valueOf values.
f Comp.dateComp	Returns a Date Comp instance that orders Dates according to their `.valueOf` value.
f Comp.defaultComp	Returns the default Comp instance, which is the Comp.anyDeepComp() instance.
f Comp.invert	Returns a Comp instance the reverses the order of the given `comp` instance.
f Comp.iterableComp	Returns a Comp instance for Iterable objects that orders the Iterables by comparing the elements with the given `itemComp` Comp instance.
f Comp.numberComp	Returns a default number Comp instance that orders numbers naturally.
f Comp.objectComp	Returns a Comp instance for objects that orders the object keys according to the given `keyComp`, and then compares the corresponding values using the given `valueComp`. Objects are then compared as follows: starting with the smallest key of either object: if only one of the objects has the key, the object with the key is considered to be larger than the other if both objects have the key, the values are compared with `valueComp`. If the values are not equal, this result is returned.
f Comp.stringCaseInsensitiveComp	Returns a `Comp` instance that compares strings in a case-insensitive way.
f Comp.stringCharCodeComp	Returns a string Comp instance that orders strings according to their indexed char codes.
f Comp.stringComp	Returns a `Comp` instance that compares strings based on the string's `localeCompare` method.
f Comp.toEq	Returns an `Eq` equality instance thet will return true when the given `comp` comparable instance returns 0.
f Comp.withNull	Returns a Comp instance that extends the given `comp` instance with the capability to handle `null` values, where null is considered to be smaller than any other value, and equal to another null.
f Comp.withUndefined	Returns a Comp instance that extends the given `comp` instance with the capability to handle `undefined` values, where undefined is considered to be smaller than any other value, and equal to another undefined.
f Eq.anyDeepEq	Returns an Eq instance that checks equality of any values. For composed values (objects and iterables) it will recursively compare the contained values.
f Eq.anyFlatEq	Returns an Eq instance that checks equality of any values. For composed values (objects and iterables) it will compare with Object.is.
f Eq.anyJsonEq	Returns an Eq instance that considers values equal their JSON.stringify values are equal.
f Eq.anyShallowEq	Returns an Eq instance that checks equality of any values. For composed values (objects and iterables) it will enter 1 level, and if again compound values are found, they are compared with Object.is.
f Eq.anyToStringEq
f Eq.convertAnyToString
f Eq.createStringCollatorEq	Returns an Eq instance that considers strings equal taking the given or default locale into account.
f Eq.dateEq	Returns an Eq instance that compares Date objects according to their `valueOf` value.
f Eq.defaultEq	Returns the default Eq instance, which is the Eq.anyDeepEq() instance.
f Eq.iterableEq	Returns an Eq instance that compares Iterables by comparing their elements with the given `itemEq` Eq instance.
f Eq.objectEq	Returns an Eq instance that checks equality of objects containing property values of type V by iteratively applying given `valueEq` to each of the object's property values.
f Eq.stringCaseInsentitiveEq	Returns an Eq instance that considers strings equal regardless of their case.
f Eq.stringCharCodeEq	Returns an Eq instance that considers strings equal when all their charcodes are equal.
f Eq.tupleSymmetric	Returns an `Eq` instance for tuples that considers two tuples [A, B] and [C, D] equal if [A, B] equals [C, D], or if [A, B] equals [D, C]
f Eq.valueOfEq	Returns an Eq instance for objects that have a `valueOf` method. It returns true if the `.valueOf` values of both given objects are equal.
f Err	Throws an `Err.ForcedError` error when called.
f ErrBase.msg	Returns a function that, when called, throws an `Err.ForcedError` with the given `message` string.
f IndexRange.getIndexRangeIndices	Returns, given the `range` `IndexRange`, a normalized tuple containing the start index, and optionally an end index.
f IndexRange.getIndicesFor	Returns, given the `range` `IndexRange`, and a target maximum `length`, the actual index range. This can be one of three options: 'empty': there are no elements within the range 'all': all elements are within the range [start: number, end: number]: an inclusive range of element indices within the given range
f OptLazy	Returns the value contained in an `OptLazy` instance of type T.
f OptLazyOr	Returns the value contained in an `OptLazyOr` instance of type T, or the given `otherValue` if the lazy function returns it.
f Range.getNormalizedRange	Simplifies a given `range` `Range` input for easier processing, by returning optional start and end ranges including whether they are inclusive or exclusive
f TraverseState	Returns a new `TraverseState` instance, using optionally given `startIndex` as a start index value.
f Update	Returns the result of given `update` parameter, where it can either directly give a new value, or it is a function receiving the given `value`, and returns a new value.

Interfaces

I Comp	An object providing methods to compare two values of type `K`.
I ToJSON	Utility type to convert some object to a JSON serializable format.
I TraverseState	An object used to track the state of a traversal, e.g. a `forEach`.

Type Aliases

T ArrayNonEmpty	Accepts all arrays with at least one element.
T AsyncCollectFun	A potentially asynchronous function used in `collect` methods to collect values from a collection. This is basically a single-pass map and filter.
T AsyncOptLazy	A potentially lazy and/or asynchronous value of type T.
T CollectFun	A function used in `collect` methods to collect values from a collection. This is basically a single-pass map and filter.
T CollectFun.Skip	Indicates, when returned from a collect function, to skip the value.
T Eq	A function returning true if given `v1` and `v2` should be considered equal.
T IndexRange	A flexible range specification for numeric indices. If a start or end is defined, a tuple can be used where the second item is a boolean indicating whether that end is inclusive or exclusive. An IndexRange can have one of the following forms: { amount: number } { start: number } { start: number, amount: number } { start: number, end: number } { start: number, end: [number, boolean] } { start: [number, boolean] } { start: [number, boolean], amount: number } { start: [number, boolean], end: number } { start: [number, boolean], end: [number, boolean] } { end: number } { end: [number, boolean] }
T MaybePromise	A type that is either a value T or a promise yielding a value of type T.
T OptLazy	A potentially lazy value of type T.
T OptLazyOr	A potentially lazy value that, in case of a lazy function, received a default value that it can return.
T Range	A range definition for any type of (orderable) value. If a start or end is defined, a tuple can be used where the second item is a boolean indicating whether that end is inclusive (true) or exclusive (false). A Range of type T can have one of the following forms: { end: T } { end: [T, boolean] } { start: T } { start: T, end: T } { start: T, end: [T, boolean] } { start: [T, boolean] } { start: [T, boolean], end: T } { start: [T, boolean], end: [T, boolean] }
T RelatedTo	Accepts all types of T and U where T extends U or U extends T.
T StringNonEmpty	Accepts all strings with at least one character.
T SubOf	Accepts all types of T and S where S extends T, and results in the lower bound S.
T SuperOf	Accepts all types of T and U where T extends U, and result in the upper bound U.
T Update	A value of type T, or a function taking a value of type T and returning a new value of type T.