@procedures/client 0.0.0-stage → 0.2.0

package/dist/collections/fx/collectors.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Collectors for Stream-style collection operations.
+ *
+ * Provides Java Stream API-style collectors for transforming iterables
+ * into various collection types. Inspired by java.util.stream.Collectors.
+ *
+ * @example
+ * import { collect, toList, groupingBy } from './collectors'
+ *
+ * const grouped = collect(users, groupingBy(u => u.age))
+ */
+import { type ArrayList } from "../impl/array-list.js";
+import { type HashMap } from "../impl/hash-map.js";
+import { type HashSet } from "../impl/hash-set.js";
+/**
+ * A Collector represents a mutable reduction operation.
+ *
+ * @template T - The type of input elements
+ * @template A - The mutable accumulation type
+ * @template R - The final result type
+ */
+export interface Collector<T, A, R> {
+    /**
+     * Creates the initial accumulator.
+     */
+    supplier: () => A;
+    /**
+     * Incorporates an element into the accumulator.
+     */
+    accumulator: (acc: A, element: T) => void;
+    /**
+     * Combines two accumulators (for parallel streams).
+     */
+    combiner?: (acc1: A, acc2: A) => A;
+    /**
+     * Transforms the accumulator into the final result.
+     */
+    finisher: (acc: A) => R;
+}
+/**
+ * Collects elements using a collector.
+ *
+ * @example
+ * const list = collect([1, 2, 3], toList())
+ * const set = collect([1, 2, 2, 3], toSet())
+ */
+export declare function collect<T, A, R>(iterable: Iterable<T>, collector: Collector<T, A, R>): R;
+/**
+ * Collects elements into an ArrayList.
+ */
+export declare function toList<T>(): Collector<T, ArrayList<T>, ArrayList<T>>;
+/**
+ * Collects elements into a HashSet.
+ */
+export declare function toSet<T>(): Collector<T, HashSet<T>, HashSet<T>>;
+/**
+ * Collects elements into a native Array.
+ */
+export declare function toArray<T>(): Collector<T, T[], T[]>;
+/**
+ * Collects elements into a HashMap using key and value extractors.
+ */
+export declare function toMap<T, K, V>(keyExtractor: (element: T) => K, valueExtractor: (element: T) => V): Collector<T, HashMap<K, V>, HashMap<K, V>>;
+/**
+ * Groups elements by a classifier function.
+ *
+ * @example
+ * const byAge = collect(users, groupingBy(u => u.age))
+ * // Map<number, ArrayList<User>>
+ */
+export declare function groupingBy<T, K>(classifier: (element: T) => K): Collector<T, HashMap<K, ArrayList<T>>, HashMap<K, ArrayList<T>>>;
+/**
+ * Groups and transforms with a downstream collector.
+ *
+ * @example
+ * const countByAge = collect(
+ *   users,
+ *   groupingBy(u => u.age, counting())
+ * )
+ * // Map<number, number>
+ */
+export declare function groupingByWith<T, K, A, D>(classifier: (element: T) => K, downstream: Collector<T, A, D>): Collector<T, HashMap<K, A>, HashMap<K, D>>;
+/**
+ * Partitions elements into two groups based on a predicate.
+ *
+ * @example
+ * const partitioned = collect(
+ *   numbers,
+ *   partitioningBy(n => n % 2 === 0)
+ * )
+ * // Map<boolean, ArrayList<number>>
+ */
+export declare function partitioningBy<T>(predicate: (element: T) => boolean): Collector<T, HashMap<boolean, ArrayList<T>>, HashMap<boolean, ArrayList<T>>>;
+/**
+ * Counts the number of elements.
+ */
+export declare function counting<T>(): Collector<T, number, number>;
+/**
+ * Sums numeric elements.
+ */
+export declare function summingNumber<T>(mapper: (element: T) => number): Collector<T, number, number>;
+/**
+ * Averages numeric elements.
+ */
+export declare function averagingNumber<T>(mapper: (element: T) => number): Collector<T, {
+    sum: number;
+    count: number;
+}, number>;
+/**
+ * Finds the minimum element.
+ */
+export declare function minBy<T>(comparator: (a: T, b: T) => number): Collector<T, T | undefined, T | undefined>;
+/**
+ * Finds the maximum element.
+ */
+export declare function maxBy<T>(comparator: (a: T, b: T) => number): Collector<T, T | undefined, T | undefined>;
+/**
+ * Joins elements into a string.
+ *
+ * @example
+ * const csv = collect(['a', 'b', 'c'], joining(', '))
+ * // "a, b, c"
+ *
+ * const bracketed = collect(
+ *   ['a', 'b', 'c'],
+ *   joining(', ', '[', ']')
+ * )
+ * // "[a, b, c]"
+ */
+export declare function joining<T>(delimiter?: string, prefix?: string, suffix?: string): Collector<T, string[], string>;
+/**
+ * Applies a mapping function before collecting.
+ *
+ * @example
+ * const names = collect(
+ *   users,
+ *   mapping(u => u.name, toList())
+ * )
+ */
+export declare function mapping<T, U, A, R>(mapper: (element: T) => U, downstream: Collector<U, A, R>): Collector<T, A, R>;
+/**
+ * Filters elements before collecting.
+ */
+export declare function filtering<T, A, R>(predicate: (element: T) => boolean, downstream: Collector<T, A, R>): Collector<T, A, R>;
+/**
+ * FlatMaps elements before collecting.
+ */
+export declare function flatMapping<T, U, A, R>(mapper: (element: T) => Iterable<U>, downstream: Collector<U, A, R>): Collector<T, A, R>;
+/**
+ * General reduction collector.
+ */
+export declare function reducing<T>(identity: T, reducer: (acc: T, element: T) => T): Collector<T, T, T>;
+/**
+ * Reducing with mapper.
+ */
+export declare function reducingWith<T, U>(identity: U, mapper: (element: T) => U, reducer: (acc: U, mapped: U) => U): Collector<T, U, U>;
+/**
+ * Collects with two collectors and combines results.
+ *
+ * @example
+ * const stats = collect(
+ *   numbers,
+ *   teeing(
+ *     summingNumber(n => n),
+ *     counting(),
+ *     (sum, count) => ({ sum, count, avg: sum / count })
+ *   )
+ * )
+ */
+export declare function teeing<T, A1, A2, R1, R2, R>(collector1: Collector<T, A1, R1>, collector2: Collector<T, A2, R2>, combiner: (r1: R1, r2: R2) => R): Collector<T, [A1, A2], R>;
+/**
+ * Collects the first element.
+ */
+export declare function first<T>(): Collector<T, T | undefined, T | undefined>;
+/**
+ * Collects the last element.
+ */
+export declare function last<T>(): Collector<T, T | undefined, T | undefined>;
+/**
+ * Creates summary statistics.
+ */
+export interface SummaryStatistics {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    average: number;
+}
+export declare function summarizingNumber<T>(mapper: (element: T) => number): Collector<T, Partial<SummaryStatistics>, SummaryStatistics>;
+//# sourceMappingURL=collectors.d.ts.map

package/dist/collections/fx/collectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectors.d.ts","sourceRoot":"","sources":["../../../src/collections/fx/collectors.ts"],"names":[],"mappings":"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"}

package/dist/collections/fx/collectors.js

@@ -0,0 +1,369 @@
+/**
+ * Collectors for Stream-style collection operations.
+ *
+ * Provides Java Stream API-style collectors for transforming iterables
+ * into various collection types. Inspired by java.util.stream.Collectors.
+ *
+ * @example
+ * import { collect, toList, groupingBy } from './collectors'
+ *
+ * const grouped = collect(users, groupingBy(u => u.age))
+ */
+import { arrayList } from "../impl/array-list.js";
+import { hashMap } from "../impl/hash-map.js";
+import { hashSet } from "../impl/hash-set.js";
+/**
+ * Collects elements using a collector.
+ *
+ * @example
+ * const list = collect([1, 2, 3], toList())
+ * const set = collect([1, 2, 2, 3], toSet())
+ */
+export function collect(iterable, collector) {
+    const acc = collector.supplier();
+    for (const element of iterable) {
+        collector.accumulator(acc, element);
+    }
+    return collector.finisher(acc);
+}
+// ============================================================================
+// Basic collectors
+// ============================================================================
+/**
+ * Collects elements into an ArrayList.
+ */
+export function toList() {
+    return {
+        supplier: () => arrayList(),
+        accumulator: (list, element) => list.add(element),
+        finisher: (list) => list,
+    };
+}
+/**
+ * Collects elements into a HashSet.
+ */
+export function toSet() {
+    return {
+        supplier: () => hashSet(),
+        accumulator: (set, element) => set.add(element),
+        finisher: (set) => set,
+    };
+}
+/**
+ * Collects elements into a native Array.
+ */
+export function toArray() {
+    return {
+        supplier: () => [],
+        accumulator: (arr, element) => arr.push(element),
+        finisher: (arr) => arr,
+    };
+}
+/**
+ * Collects elements into a HashMap using key and value extractors.
+ */
+export function toMap(keyExtractor, valueExtractor) {
+    return {
+        supplier: () => hashMap(),
+        accumulator: (map, element) => {
+            map.set(keyExtractor(element), valueExtractor(element));
+        },
+        finisher: (map) => map,
+    };
+}
+// ============================================================================
+// Grouping collectors
+// ============================================================================
+/**
+ * Groups elements by a classifier function.
+ *
+ * @example
+ * const byAge = collect(users, groupingBy(u => u.age))
+ * // Map<number, ArrayList<User>>
+ */
+export function groupingBy(classifier) {
+    return {
+        supplier: () => hashMap(),
+        accumulator: (map, element) => {
+            const key = classifier(element);
+            const list = map.computeIfAbsent(key, () => arrayList());
+            list.add(element);
+        },
+        finisher: (map) => map,
+    };
+}
+/**
+ * Groups and transforms with a downstream collector.
+ *
+ * @example
+ * const countByAge = collect(
+ *   users,
+ *   groupingBy(u => u.age, counting())
+ * )
+ * // Map<number, number>
+ */
+export function groupingByWith(classifier, downstream) {
+    return {
+        supplier: () => hashMap(),
+        accumulator: (map, element) => {
+            const key = classifier(element);
+            const acc = map.computeIfAbsent(key, () => downstream.supplier());
+            downstream.accumulator(acc, element);
+        },
+        finisher: (map) => {
+            const result = hashMap();
+            for (const entry of map.entries()) {
+                result.set(entry.key, downstream.finisher(entry.value));
+            }
+            return result;
+        },
+    };
+}
+/**
+ * Partitions elements into two groups based on a predicate.
+ *
+ * @example
+ * const partitioned = collect(
+ *   numbers,
+ *   partitioningBy(n => n % 2 === 0)
+ * )
+ * // Map<boolean, ArrayList<number>>
+ */
+export function partitioningBy(predicate) {
+    return groupingBy((element) => predicate(element));
+}
+// ============================================================================
+// Aggregation collectors
+// ============================================================================
+/**
+ * Counts the number of elements.
+ */
+export function counting() {
+    return {
+        supplier: () => 0,
+        accumulator: (count) => count + 1,
+        finisher: (count) => count,
+    };
+}
+/**
+ * Sums numeric elements.
+ */
+export function summingNumber(mapper) {
+    return {
+        supplier: () => 0,
+        accumulator: (sum, element) => sum + mapper(element),
+        finisher: (sum) => sum,
+    };
+}
+/**
+ * Averages numeric elements.
+ */
+export function averagingNumber(mapper) {
+    return {
+        supplier: () => ({ sum: 0, count: 0 }),
+        accumulator: (acc, element) => {
+            acc.sum += mapper(element);
+            acc.count++;
+        },
+        finisher: (acc) => (acc.count === 0 ? 0 : acc.sum / acc.count),
+    };
+}
+/**
+ * Finds the minimum element.
+ */
+export function minBy(comparator) {
+    return {
+        supplier: () => undefined,
+        accumulator: (min, element) => {
+            if (min === undefined || comparator(element, min) < 0) {
+                return element;
+            }
+            return min;
+        },
+        finisher: (min) => min,
+    };
+}
+/**
+ * Finds the maximum element.
+ */
+export function maxBy(comparator) {
+    return {
+        supplier: () => undefined,
+        accumulator: (max, element) => {
+            if (max === undefined || comparator(element, max) > 0) {
+                return element;
+            }
+            return max;
+        },
+        finisher: (max) => max,
+    };
+}
+// ============================================================================
+// String collectors
+// ============================================================================
+/**
+ * Joins elements into a string.
+ *
+ * @example
+ * const csv = collect(['a', 'b', 'c'], joining(', '))
+ * // "a, b, c"
+ *
+ * const bracketed = collect(
+ *   ['a', 'b', 'c'],
+ *   joining(', ', '[', ']')
+ * )
+ * // "[a, b, c]"
+ */
+export function joining(delimiter = "", prefix = "", suffix = "") {
+    return {
+        supplier: () => [],
+        accumulator: (parts, element) => parts.push(String(element)),
+        finisher: (parts) => prefix + parts.join(delimiter) + suffix,
+    };
+}
+// ============================================================================
+// Mapping collectors
+// ============================================================================
+/**
+ * Applies a mapping function before collecting.
+ *
+ * @example
+ * const names = collect(
+ *   users,
+ *   mapping(u => u.name, toList())
+ * )
+ */
+export function mapping(mapper, downstream) {
+    return {
+        supplier: downstream.supplier,
+        accumulator: (acc, element) => downstream.accumulator(acc, mapper(element)),
+        finisher: downstream.finisher,
+    };
+}
+/**
+ * Filters elements before collecting.
+ */
+export function filtering(predicate, downstream) {
+    return {
+        supplier: downstream.supplier,
+        accumulator: (acc, element) => {
+            if (predicate(element)) {
+                downstream.accumulator(acc, element);
+            }
+        },
+        finisher: downstream.finisher,
+    };
+}
+/**
+ * FlatMaps elements before collecting.
+ */
+export function flatMapping(mapper, downstream) {
+    return {
+        supplier: downstream.supplier,
+        accumulator: (acc, element) => {
+            for (const mapped of mapper(element)) {
+                downstream.accumulator(acc, mapped);
+            }
+        },
+        finisher: downstream.finisher,
+    };
+}
+// ============================================================================
+// Reducing collectors
+// ============================================================================
+/**
+ * General reduction collector.
+ */
+export function reducing(identity, reducer) {
+    return {
+        supplier: () => identity,
+        accumulator: (acc, element) => reducer(acc, element),
+        finisher: (acc) => acc,
+    };
+}
+/**
+ * Reducing with mapper.
+ */
+export function reducingWith(identity, mapper, reducer) {
+    return {
+        supplier: () => identity,
+        accumulator: (acc, element) => reducer(acc, mapper(element)),
+        finisher: (acc) => acc,
+    };
+}
+// ============================================================================
+// Composite collectors
+// ============================================================================
+/**
+ * Collects with two collectors and combines results.
+ *
+ * @example
+ * const stats = collect(
+ *   numbers,
+ *   teeing(
+ *     summingNumber(n => n),
+ *     counting(),
+ *     (sum, count) => ({ sum, count, avg: sum / count })
+ *   )
+ * )
+ */
+export function teeing(collector1, collector2, combiner) {
+    return {
+        supplier: () => [collector1.supplier(), collector2.supplier()],
+        accumulator: ([acc1, acc2], element) => {
+            collector1.accumulator(acc1, element);
+            collector2.accumulator(acc2, element);
+        },
+        finisher: ([acc1, acc2]) => {
+            return combiner(collector1.finisher(acc1), collector2.finisher(acc2));
+        },
+    };
+}
+// ============================================================================
+// Utility collectors
+// ============================================================================
+/**
+ * Collects the first element.
+ */
+export function first() {
+    return {
+        supplier: () => undefined,
+        accumulator: (first, element) => (first === undefined ? element : first),
+        finisher: (first) => first,
+    };
+}
+/**
+ * Collects the last element.
+ */
+export function last() {
+    return {
+        supplier: () => undefined,
+        accumulator: (_last, element) => element,
+        finisher: (last) => last,
+    };
+}
+export function summarizingNumber(mapper) {
+    return {
+        supplier: () => ({
+            count: 0,
+            sum: 0,
+            min: Infinity,
+            max: -Infinity,
+        }),
+        accumulator: (stats, element) => {
+            const value = mapper(element);
+            stats.count = (stats.count || 0) + 1;
+            stats.sum = (stats.sum || 0) + value;
+            stats.min = Math.min(stats.min || Infinity, value);
+            stats.max = Math.max(stats.max || -Infinity, value);
+        },
+        finisher: (stats) => ({
+            count: stats.count,
+            sum: stats.sum,
+            min: stats.min,
+            max: stats.max,
+            average: stats.count === 0 ? 0 : stats.sum / stats.count,
+        }),
+    };
+}
+//# sourceMappingURL=collectors.js.map

package/dist/collections/fx/collectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectors.js","sourceRoot":"","sources":["../../../src/collections/fx/collectors.ts"],"names":[],"mappings":"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"}