import { IterableX } from '../iterablex.js'; import { identity } from '../../util/identity.js'; import { createGrouping } from './_grouping.js'; import { OperatorFunction } from '../../interfaces.js'; /** @ignore */ /** @ignore */ export class GroupedIterable extends IterableX { public readonly key: TKey; private _source: Iterable; constructor(key: TKey, source: Iterable) { super(); this.key = key; this._source = source; } *[Symbol.iterator]() { for (const item of this._source) { yield item; } } } /** @ignore */ export class GroupByIterable extends IterableX< GroupedIterable > { private _source: Iterable; private _keySelector: (value: TSource) => TKey; private _elementSelector: (value: TSource) => TValue; constructor( source: Iterable, keySelector: (value: TSource) => TKey, elementSelector: (value: TSource) => TValue ) { super(); this._source = source; this._keySelector = keySelector; this._elementSelector = elementSelector; } *[Symbol.iterator]() { const map = createGrouping(this._source, this._keySelector, this._elementSelector); for (const [key, values] of map) { yield new GroupedIterable(key, values); } } } export function groupBy( keySelector: (value: TSource) => TKey ): OperatorFunction>; export function groupBy( keySelector: (value: TSource) => TKey, elementSelector?: (value: TSource) => TValue ): OperatorFunction>; /** * Groups the elements of an async-iterable sequence and selects the resulting elements by using a specified function. * * @template TSource The type of the elements in the source sequence. * @template TKey The type of the grouping key computed for each element in the source sequence. * @template TValue The type of the elements within the groups computed for each element in the source sequence. * @param {((value: TSource) => TKey)} keySelector A function to extract the key for each element. * @param {((value: TSource) => TValue)} [elementSelector=identity] A function to map each source element to an element in an async-enumerable group. * @returns {OperatorFunction} A sequence of async-iterable groups, each of which corresponds to a unique key value, * containing all elements that share that same key value. */ export function groupBy( keySelector: (value: TSource) => TKey, elementSelector: (value: TSource) => TValue = identity ): OperatorFunction> { return function groupByOperatorFunction( source: Iterable ): IterableX> { return new GroupByIterable(source, keySelector, elementSelector); }; }