import { SortedMap, SortedSet } from '@rimbu/sorted'; import type { Stream, Streamable } from '@rimbu/stream'; import type { ArrowGraphSortedCreators, GraphElement, } from '@rimbu/graph/custom'; import { type ArrowGraphBase, GraphContext } from '@rimbu/graph/custom'; /** * A type-invariant immutable arrow (directed) graph. * The connections are internally maintained using sorted collections. * See the [Graph documentation](https://rimbu.org/docs/collections/graph) and the [ArrowGraphSorted API documentation](https://rimbu.org/api/rimbu/graph/ArrowGraphSorted/interface) * @typeparam N - the node type * @example * ```ts * const g1 = ArrowGraphSorted.empty() * const g2 = ArrowGraphSorted.of([1], [2, 3], [2, 4]) * ``` */ export interface ArrowGraphSorted extends ArrowGraphBase {} export namespace ArrowGraphSorted { /** * A non-empty type-invariant immutable arrow (directed) graph. * The connections are internally maintained using sorted collections. * See the [Graph documentation](https://rimbu.org/docs/collections/graph) and the [ArrowGraphSorted API documentation](https://rimbu.org/api/rimbu/graph/ArrowGraphSorted/interface) * @typeparam N - the node type */ export interface NonEmpty extends ArrowGraphBase.NonEmpty, Omit, keyof ArrowGraphBase.NonEmpty>, Streamable.NonEmpty> { /** * Returns a non-empty `Stream` containing all graph elements of this collection as single tuples for isolated nodes * and 2-valued tuples of nodes for connections. * @example * ```ts * ArrowGraphSorted.of([1], [2, 3]).stream().toArray() * // => [[1], [2, 3]] * ``` */ stream(): Stream.NonEmpty>; } /** * A mutable `ArrowGraphSorted` builder used to efficiently create new immutable instances. * See the [Graph documentation](https://rimbu.org/docs/collections/graph) and the [ArrowGraphSorted.Builder API documentation](https://rimbu.org/api/rimbu/graph/ArrowGraphSorted/Builder/interface) * @typeparam N - the node type */ export interface Builder extends ArrowGraphBase.Builder {} /** * The ArrowGraphSorted's Context instance that serves as a factory for all related immutable instances and builders. * @typeparam UN - the upper type limit for node types for which this context can create instances */ export interface Context extends ArrowGraphBase.Context { readonly typeTag: 'ArrowGraphSorted'; } /** * Utility interface that provides higher-kinded types for this collection. */ export interface Types extends ArrowGraphBase.Types { readonly normal: ArrowGraphSorted; readonly nonEmpty: ArrowGraphSorted.NonEmpty; readonly context: ArrowGraphSorted.Context; readonly builder: ArrowGraphSorted.Builder; readonly linkMap: SortedMap>; readonly linkMapNonEmpty: SortedMap.NonEmpty< this['_N'], SortedSet >; readonly linkMapContext: SortedMap.Context; readonly linkConnectionsContext: SortedSet.Context; readonly linkMapBuilder: SortedMap.Builder< this['_N'], SortedSet.Builder >; readonly linkConnectionsBuilder: SortedSet.Builder; readonly linkConnections: SortedSet; } } function createContext(options?: { linkMapContext?: SortedMap.Context; linkConnectionsContext?: SortedSet.Context; }): ArrowGraphSorted.Context { return Object.freeze( new GraphContext( true, 'ArrowGraphSorted', options?.linkMapContext ?? SortedMap.defaultContext(), options?.linkConnectionsContext ?? SortedSet.defaultContext() ) ); } const _defaultContext: ArrowGraphSorted.Context = createContext(); export const ArrowGraphSorted: ArrowGraphSortedCreators = Object.freeze({ ..._defaultContext, createContext, defaultContext(): ArrowGraphSorted.Context { return _defaultContext; }, });