/** * @since 1.0.0 */ import type { Chunk } from "@effect/data/Chunk" import type { Equal } from "@effect/data/Equal" import type { Inspectable } from "@effect/data/Inspectable" import * as RBT from "@effect/data/internal/RedBlackTree" import * as RBTI from "@effect/data/internal/RedBlackTree/iterator" import type { Option } from "@effect/data/Option" import type { Order } from "@effect/data/Order" import type { Pipeable } from "@effect/data/Pipeable" const TypeId: unique symbol = RBT.RedBlackTreeTypeId as TypeId /** * @since 1.0.0 * @category symbol */ export type TypeId = typeof TypeId /** * @since 1.0.0 * @category constants */ export const Direction = RBTI.Direction /** * A Red-Black Tree. * * @since 1.0.0 * @category models */ export interface RedBlackTree extends Iterable, Equal, Pipeable, Inspectable { readonly [TypeId]: TypeId } /** * @since 1.0.0 */ export declare namespace RedBlackTree { /** * @since 1.0.0 */ export type Direction = number & { readonly Direction: unique symbol } } /** * @since 1.0.0 * @category refinements */ export const isRedBlackTree: { (u: Iterable): u is RedBlackTree (u: unknown): u is RedBlackTree } = RBT.isRedBlackTree /** * Creates an empty `RedBlackTree`. * * @since 1.0.0 * @category constructors */ export const empty: (ord: Order) => RedBlackTree = RBT.empty /** * Constructs a new tree from an iterable of key-value pairs. * * @since 1.0.0 * @category constructors */ export const fromIterable: (ord: Order) => (entries: Iterable) => RedBlackTree = RBT.fromIterable /** * Constructs a new `RedBlackTree` from the specified entries. * * @since 1.0.0 * @category constructors */ export const make: ( ord: Order ) => >( ...entries: Entries ) => RedBlackTree = RBT.make /** * Returns an iterator that points to the element at the specified index of the * tree. * * **Note**: The iterator will run through elements in order. * * @since 1.0.0 * @category traversing */ export const at: { (index: number): (self: RedBlackTree) => Iterable (self: RedBlackTree, index: number): Iterable } = RBT.atForwards /** * Returns an iterator that points to the element at the specified index of the * tree. * * **Note**: The iterator will run through elements in reverse order. * * @since 1.0.0 * @category traversing */ export const atReversed: { (index: number): (self: RedBlackTree) => Iterable (self: RedBlackTree, index: number): Iterable } = RBT.atBackwards /** * Finds all values in the tree associated with the specified key. * * @since 1.0.0 * @category elements */ export const findAll: { (key: K): (self: RedBlackTree) => Chunk (self: RedBlackTree, key: K): Chunk } = RBT.findAll /** * Finds the first value in the tree associated with the specified key, if it exists. * * @category elements * @since 1.0.0 */ export const findFirst: { (key: K): (self: RedBlackTree) => Option (self: RedBlackTree, key: K): Option } = RBT.findFirst /** * Returns the first entry in the tree, if it exists. * * @since 1.0.0 * @category getters */ export const first: (self: RedBlackTree) => Option = RBT.first /** * Returns the element at the specified index within the tree or `None` if the * specified index does not exist. * * @since 1.0.0 * @category elements */ export const getAt: { (index: number): (self: RedBlackTree) => Option (self: RedBlackTree, index: number): Option } = RBT.getAt /** * Gets the `Order` that the `RedBlackTree` is using. * * @since 1.0.0 * @category getters */ export const getOrder: (self: RedBlackTree) => Order = RBT.getOrder /** * Returns an iterator that traverse entries in order with keys greater than the * specified key. * * @since 1.0.0 * @category traversing */ export const greaterThan: { (key: K): (self: RedBlackTree) => Iterable (self: RedBlackTree, key: K): Iterable } = RBT.greaterThanForwards /** * Returns an iterator that traverse entries in reverse order with keys greater * than the specified key. * * @since 1.0.0 * @category traversing */ export const greaterThanReversed: { (key: K): (self: RedBlackTree) => Iterable (self: RedBlackTree, key: K): Iterable } = RBT.greaterThanBackwards /** * Returns an iterator that traverse entries in order with keys greater than or * equal to the specified key. * * @since 1.0.0 * @category traversing */ export const greaterThanEqual: { (key: K): (self: RedBlackTree) => Iterable (self: RedBlackTree, key: K): Iterable } = RBT.greaterThanEqualForwards /** * Returns an iterator that traverse entries in reverse order with keys greater * than or equal to the specified key. * * @since 1.0.0 * @category traversing */ export const greaterThanEqualReversed: { (key: K): (self: RedBlackTree) => Iterable (self: RedBlackTree, key: K): Iterable } = RBT.greaterThanEqualBackwards /** * Finds the item with key, if it exists. * * @since 1.0.0 * @category elements */ export const has: { (key: K): (self: RedBlackTree) => boolean (self: RedBlackTree, key: K): boolean } = RBT.has /** * Insert a new item into the tree. * * @since 1.0.0 */ export const insert: { (key: K, value: V): (self: RedBlackTree) => RedBlackTree (self: RedBlackTree, key: K, value: V): RedBlackTree } = RBT.insert /** * Get all the keys present in the tree in order. * * @since 1.0.0 * @category getters */ export const keys: (self: RedBlackTree) => IterableIterator = RBT.keysForward /** * Get all the keys present in the tree in reverse order. * * @since 1.0.0 * @category getters */ export const keysReversed: (self: RedBlackTree) => IterableIterator = RBT.keysBackward /** * Returns the last entry in the tree, if it exists. * * @since 1.0.0 * @category getters */ export const last: (self: RedBlackTree) => Option = RBT.last /** * Returns an iterator that traverse entries in order with keys less than the * specified key. * * @since 1.0.0 * @category traversing */ export const lessThan: { (key: K): (self: RedBlackTree) => Iterable (self: RedBlackTree, key: K): Iterable } = RBT.lessThanForwards /** * Returns an iterator that traverse entries in reverse order with keys less * than the specified key. * * @since 1.0.0 * @category traversing */ export const lessThanReversed: { (key: K): (self: RedBlackTree) => Iterable (self: RedBlackTree, key: K): Iterable } = RBT.lessThanBackwards /** * Returns an iterator that traverse entries in order with keys less than or * equal to the specified key. * * @since 1.0.0 * @category traversing */ export const lessThanEqual: { (key: K): (self: RedBlackTree) => Iterable (self: RedBlackTree, key: K): Iterable } = RBT.lessThanEqualForwards /** * Returns an iterator that traverse entries in reverse order with keys less * than or equal to the specified key. * * @since 1.0.0 * @category traversing */ export const lessThanEqualReversed: { (key: K): (self: RedBlackTree) => Iterable (self: RedBlackTree, key: K): Iterable } = RBT.lessThanEqualBackwards /** * Execute the specified function for each node of the tree, in order. * * @since 1.0.0 * @category traversing */ export const forEach: { (f: (key: K, value: V) => void): (self: RedBlackTree) => void (self: RedBlackTree, f: (key: K, value: V) => void): void } = RBT.forEach /** * Visit each node of the tree in order with key greater then or equal to max. * * @since 1.0.0 * @category traversing */ export const forEachGreaterThanEqual: { (min: K, f: (key: K, value: V) => void): (self: RedBlackTree) => void (self: RedBlackTree, min: K, f: (key: K, value: V) => void): void } = RBT.forEachGreaterThanEqual /** * Visit each node of the tree in order with key lower then max. * * @since 1.0.0 * @category traversing */ export const forEachLessThan: { (max: K, f: (key: K, value: V) => void): (self: RedBlackTree) => void (self: RedBlackTree, max: K, f: (key: K, value: V) => void): void } = RBT.forEachLessThan /** * Visit each node of the tree in order with key lower than max and greater * than or equal to min. * * @since 1.0.0 * @category traversing */ export const forEachBetween: { ( options: { readonly min: K readonly max: K readonly body: (key: K, value: V) => void } ): (self: RedBlackTree) => void ( self: RedBlackTree, options: { readonly min: K readonly max: K readonly body: (key: K, value: V) => void } ): void } = RBT.forEachBetween /** * Reduce a state over the entries of the tree. * * @since 1.0.0 * @category folding */ export const reduce: { (zero: Z, f: (accumulator: Z, value: V, key: K) => Z): (self: RedBlackTree) => Z (self: RedBlackTree, zero: Z, f: (accumulator: Z, value: V, key: K) => Z): Z } = RBT.reduce /** * Removes the entry with the specified key, if it exists. * * @since 1.0.0 */ export const removeFirst: { (key: K): (self: RedBlackTree) => RedBlackTree (self: RedBlackTree, key: K): RedBlackTree } = RBT.removeFirst /** * Traverse the tree in reverse order. * * @since 1.0.0 * @category traversing */ export const reversed: (self: RedBlackTree) => Iterable = RBT.reversed /** * Returns the size of the tree. * * @since 1.0.0 * @category getters */ export const size: (self: RedBlackTree) => number = RBT.size /** * Get all values present in the tree in order. * * @since 1.0.0 * @category getters */ export const values: (self: RedBlackTree) => IterableIterator = RBT.valuesForward /** * Get all values present in the tree in reverse order. * * @since 1.0.0 * @category getters */ export const valuesReversed: (self: RedBlackTree) => IterableIterator = RBT.valuesBackward