import type { Stream, Streamable } from '@rimbu/stream'; import { HashMap } from '@rimbu/hashed'; import type { EdgeValuedGraphHashedCreators, ValuedGraphElement, } from '@rimbu/graph/custom'; import { type EdgeValuedGraphBase, ValuedGraphContext, } from '@rimbu/graph/custom'; /** * A type-invariant immutable valued edge (undirected) graph. * The nodes are internally maintained using HashMaps * See the [Graph documentation](https://rimbu.org/docs/collections/graph) and the [EdgeValuedGraphHashed API documentation](https://rimbu.org/api/rimbu/graph/EdgeValuedGraphHashed/interface) * @typeparam N - the node type * @typeparam V - the connection value type * @example * ```ts * const g1 = EdgeValuedGraphHashed.empty() * const g2 = EdgeValuedGraphHashed.of([1], [2, 3, 'a'], [2, 4, 'b']) * ``` */ export interface EdgeValuedGraphHashed extends EdgeValuedGraphBase {} export namespace EdgeValuedGraphHashed { /** * A non-empty type-invariant immutable valued edge (undirected) graph. * The nodes are internally maintained using HashMaps * See the [Graph documentation](https://rimbu.org/docs/collections/graph) and the [EdgeValuedGraphHashed API documentation](https://rimbu.org/api/rimbu/graph/EdgeValuedGraphHashed/interface) * @typeparam N - the node type * @typeparam V - the connection value type */ export interface NonEmpty extends EdgeValuedGraphBase.NonEmpty, Omit< EdgeValuedGraphHashed, keyof EdgeValuedGraphBase.NonEmpty >, Streamable.NonEmpty> { /** * Returns a non-empty `Stream` containing all graph elements of this collection as single tuples for isolated nodes * and 3-valued tuples containing the source node, target node, and connection value for connections. * @example * ```ts * EdgeValuedGraphHashed.of([1, 2, 'a'], [2, 3, 'b']).stream().toArray() * // => [[1, 2, 'a'], [2, 3, 'b']] * ``` */ stream(): Stream.NonEmpty>; } /** * A mutable `EdgeValuedGraphHashed` builder used to efficiently create new immutable instances. * See the [Graph documentation](https://rimbu.org/docs/collections/graph) and the [EdgeValuedGraphHashed.Builder API documentation](https://rimbu.org/api/rimbu/graph/EdgeValuedGraphHashed/Builder/interface) * @typeparam N - the node type * @typeparam V - the connection value type */ export interface Builder extends EdgeValuedGraphBase.Builder {} /** * The EdgeValuedGraphHashed'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 EdgeValuedGraphBase.Context { readonly typeTag: 'EdgeValuedGraphHashed'; } /** * Utility interface that provides higher-kinded types for this collection. */ export interface Types extends EdgeValuedGraphBase.Types { readonly normal: EdgeValuedGraphHashed; readonly nonEmpty: EdgeValuedGraphHashed.NonEmpty; readonly context: EdgeValuedGraphHashed.Context; readonly builder: EdgeValuedGraphHashed.Builder; readonly linkMap: HashMap>; readonly linkMapNonEmpty: HashMap.NonEmpty< this['_N'], HashMap >; readonly linkMapContext: HashMap.Context; readonly linkConnectionsContext: HashMap.Context; readonly linkMapBuilder: HashMap.Builder< this['_N'], HashMap.Builder >; readonly linkConnectionsBuilder: HashMap.Builder; readonly linkConnections: HashMap; } } function createContext(options?: { linkMapContext?: HashMap.Context; linkConnectionsContext?: HashMap.Context; }): EdgeValuedGraphHashed.Context { return Object.freeze( new ValuedGraphContext( false, 'EdgeValuedGraphHashed', options?.linkMapContext ?? HashMap.defaultContext(), options?.linkConnectionsContext ?? HashMap.defaultContext() ) ); } const _defaultContext: EdgeValuedGraphHashed.Context = createContext(); export const EdgeValuedGraphHashed: EdgeValuedGraphHashedCreators = Object.freeze({ ..._defaultContext, createContext, defaultContext(): EdgeValuedGraphHashed.Context { return _defaultContext; }, });