@procedures/collections 0.0.0-stage → 0.2.0

package/dist/fx/collectors.js

@@ -0,0 +1,375 @@
+/**
+ * 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) {
+    let acc = collector.supplier();
+    for (const element of iterable) {
+        acc = 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), list),
+        finisher: (list) => list,
+    };
+}
+/**
+ * Collects elements into a HashSet.
+ */
+export function toSet() {
+    return {
+        supplier: () => hashSet(),
+        accumulator: (set, element) => (set.add(element), set),
+        finisher: (set) => set,
+    };
+}
+/**
+ * Collects elements into a native Array.
+ */
+export function toArray() {
+    return {
+        supplier: () => [],
+        accumulator: (arr, element) => (arr.push(element), arr),
+        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));
+            return map;
+        },
+        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);
+            return map;
+        },
+        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.has(key) ? map.get(key) : downstream.supplier();
+            map.set(key, downstream.accumulator(acc, element));
+            return map;
+        },
+        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++;
+            return acc;
+        },
+        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)), parts),
+        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) => {
+            return predicate(element) ? downstream.accumulator(acc, element) : acc;
+        },
+        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)) {
+                acc = downstream.accumulator(acc, mapped);
+            }
+            return acc;
+        },
+        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);
+            // The supplier sets every field. (Before, `stats.min || Infinity` treated a minimum of 0
+            // as missing: BUGS-2026-07 L16.)
+            stats.count = stats.count + 1;
+            stats.sum = stats.sum + value;
+            stats.min = Math.min(stats.min, value);
+            stats.max = Math.max(stats.max, value);
+            return stats;
+        },
+        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/fx/collectors.js.map

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

package/dist/fx/iter.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Functional operations for iterables (lazy sync transforms).
+ *
+ * Provides Stream-like operations with lazy evaluation.
+ * All operations return generators for composability.
+ *
+ * @example
+ * const result = pipe(
+ *   [1, 2, 3, 4, 5],
+ *   map(x => x * 2),
+ *   filter(x => x > 5),
+ *   take(2),
+ *   toArray
+ * ) // [6, 8]
+ */
+/**
+ * Maps each element through a function.
+ *
+ * @example
+ * const doubled = map([1, 2, 3], x => x * 2) // [2, 4, 6]
+ */
+export declare function map<T, U>(iterable: Iterable<T>, fn: (value: T, index: number) => U): Generator<U>;
+/**
+ * Filters elements based on a predicate.
+ */
+export declare function filter<T>(iterable: Iterable<T>, predicate: (value: T, index: number) => boolean): Generator<T>;
+/**
+ * FlatMaps each element to an iterable and flattens.
+ */
+export declare function flatMap<T, U>(iterable: Iterable<T>, fn: (value: T, index: number) => Iterable<U>): Generator<U>;
+/**
+ * Flattens a nested iterable.
+ */
+export declare function flatten<T>(iterable: Iterable<Iterable<T>>): Generator<T>;
+/**
+ * Takes the first n elements.
+ */
+export declare function take<T>(iterable: Iterable<T>, n: number): Generator<T>;
+/**
+ * Skips the first n elements.
+ */
+export declare function skip<T>(iterable: Iterable<T>, n: number): Generator<T>;
+/**
+ * Takes elements while predicate is true.
+ */
+export declare function takeWhile<T>(iterable: Iterable<T>, predicate: (value: T) => boolean): Generator<T>;
+/**
+ * Skips elements while predicate is true.
+ */
+export declare function skipWhile<T>(iterable: Iterable<T>, predicate: (value: T) => boolean): Generator<T>;
+/**
+ * Concatenates multiple iterables.
+ */
+export declare function concat<T>(...iterables: Iterable<T>[]): Generator<T>;
+/**
+ * Zips multiple iterables together.
+ */
+export declare function zip<T extends any[]>(...iterables: {
+    [K in keyof T]: Iterable<T[K]>;
+}): Generator<T>;
+/**
+ * Zips with index.
+ */
+export declare function enumerate<T>(iterable: Iterable<T>): Generator<[number, T]>;
+/**
+ * Chunks elements into arrays of specified size.
+ */
+export declare function chunk<T>(iterable: Iterable<T>, size: number): Generator<T[]>;
+/**
+ * Creates a sliding window of specified size.
+ */
+export declare function window<T>(iterable: Iterable<T>, size: number): Generator<T[]>;
+/**
+ * Partitions elements into two arrays based on predicate.
+ */
+export declare function partition<T>(iterable: Iterable<T>, predicate: (value: T) => boolean): [T[], T[]];
+/**
+ * Reduces iterable to a single value.
+ */
+export declare function reduce<T, U>(iterable: Iterable<T>, fn: (acc: U, value: T, index: number) => U, initial: U): U;
+/**
+ * Scans (like reduce but emits intermediate results).
+ */
+export declare function scan<T, U>(iterable: Iterable<T>, fn: (acc: U, value: T) => U, initial: U): Generator<U>;
+/**
+ * Sorts elements (materializes the iterable).
+ */
+export declare function sort<T>(iterable: Iterable<T>, compare?: (a: T, b: T) => number): Generator<T>;
+/**
+ * Reverses elements (materializes the iterable).
+ */
+export declare function reverse<T>(iterable: Iterable<T>): Generator<T>;
+/**
+ * Removes duplicate elements (by reference or key function).
+ */
+export declare function distinct<T, K = T>(iterable: Iterable<T>, keyFn?: (value: T) => K): Generator<T>;
+/**
+ * Removes consecutive duplicates.
+ */
+export declare function distinctConsecutive<T, K = T>(iterable: Iterable<T>, keyFn?: (value: T) => K): Generator<T>;
+/**
+ * Performs a side effect for each element without modifying the stream.
+ */
+export declare function tap<T>(iterable: Iterable<T>, fn: (value: T, index: number) => void): Generator<T>;
+/**
+ * Returns true if any element matches the predicate.
+ */
+export declare function some<T>(iterable: Iterable<T>, predicate: (value: T) => boolean): boolean;
+/**
+ * Returns true if all elements match the predicate.
+ */
+export declare function every<T>(iterable: Iterable<T>, predicate: (value: T) => boolean): boolean;
+/**
+ * Returns true if no elements match the predicate.
+ */
+export declare function none<T>(iterable: Iterable<T>, predicate: (value: T) => boolean): boolean;
+/**
+ * Finds the first element matching the predicate.
+ */
+export declare function find<T>(iterable: Iterable<T>, predicate: (value: T) => boolean): T | undefined;
+/**
+ * Counts elements (optionally matching a predicate).
+ */
+export declare function count<T>(iterable: Iterable<T>, predicate?: (value: T) => boolean): number;
+/**
+ * Returns the minimum element.
+ */
+export declare function min<T>(iterable: Iterable<T>, compare?: (a: T, b: T) => number): T | undefined;
+/**
+ * Returns the maximum element.
+ */
+export declare function max<T>(iterable: Iterable<T>, compare?: (a: T, b: T) => number): T | undefined;
+/**
+ * Returns the sum of elements.
+ */
+export declare function sum(iterable: Iterable<number>): number;
+/**
+ * Returns the average of elements.
+ */
+export declare function average(iterable: Iterable<number>): number | undefined;
+/**
+ * Collects elements into an array.
+ */
+export declare function toArray<T>(iterable: Iterable<T>): T[];
+/**
+ * Collects elements into a Set.
+ */
+export declare function toSet<T>(iterable: Iterable<T>): Set<T>;
+/**
+ * Collects elements into a Map.
+ */
+export declare function toMap<T, K, V>(iterable: Iterable<T>, keyFn: (value: T) => K, valueFn: (value: T) => V): Map<K, V>;
+/**
+ * Pipes a value through a series of transformations.
+ *
+ * @example
+ * const result = pipe(
+ *   [1, 2, 3, 4, 5],
+ *   (it) => map(it, x => x * 2),
+ *   (it) => filter(it, x => x > 5),
+ *   (it) => take(it, 2),
+ *   toArray
+ * ) // [6, 8]
+ */
+export declare function pipe<T>(value: T, ...fns: Array<(value: any) => any>): any;
+//# sourceMappingURL=iter.d.ts.map

package/dist/fx/iter.d.ts.map

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