Introduction

A powerful, fully-typed collections library for TypeScript, combining Laravel's collection elegance with advanced data processing capabilities. Features a fluent API, lazy evaluation, statistical analysis, machine learning operations, and comprehensive data manipulation tools—all with zero dependencies.

Features

• Lightweight & Dependency-free
• Type safe
• Laravel-inspired APIs

Core Operations (Laravel Collection API)

• Standard operations (map, filter, reduce)
• FlatMap and MapSpread operations (flatMap, mapSpread)
• Element access (first, firstOrFail, last, nth)
• Subset operations (take, skip, slice)
• Unique value handling (unique)
• Chunk operations (chunk)
• Tap and Pipe utilities (tap, pipe)
• Collection conversion (toArray, toMap, toSet)
• Collection inspection (count, isEmpty, isNotEmpty)
• Combine and collapse operations (combine, collapse)
• Contains checks (contains, containsOneItem)
• Each iterations (each, eachSpread)
• Only and except operations (only, except)
• Forget and random selection (forget, random)
• Push, prepend, and put operations (push, prepend, put)
• Skip and take variants (skipUntil, skipWhile, takeUntil, takeWhile)
• Sole item retrieval (sole)
• Conditional execution (when, unless)
• Wrap and unwrap operations (wrap, unwrap)

Advanced Array & Object Operations

• GroupBy with multiple key support (groupBy, groupByMultiple)
• Value extraction (pluck)
• Where clause variations
  • Basic where operations (where, whereIn, whereNotIn)
  • Range checks (whereBetween, whereNotBetween)
  • Null handling (whereNull, whereNotNull)
  • Pattern matching (whereLike, whereRegex)
  • Type checks (whereInstanceOf)
• Comprehensive sorting
  • Basic sort operations (sort)
  • Key-based sorting (sortBy, sortByDesc)
  • Key sorting (sortKeys, sortKeysDesc)
• Pagination & Cursor iteration
• Data partitioning
• Set operations (union, intersect, diff, symmetricDiff)
• Advanced products (cartesianProduct)
• Recursive operations (mergeRecursive, replaceRecursive)

Advanced Transformations

• Group transformations (mapToGroups)
• Array handling (mapSpread, mapWithKeys)
• Conditional mapping (mapUntil, mapOption)
• Data restructuring (transform)
• Type system integration (cast, mapInto)
• Property operations (pick, omit)
• Fuzzy matching algorithms
• Key-value transformations (flip, undot)

Statistical Operations

• Basic statistics
  • Sum and averages
  • Median and mode
  • Range (min, max)
  • Products
• Advanced statistics
  • Standard deviation
  • Variance analysis
  • Percentile calculations
  • Correlation coefficients
  • Entropy measures
  • Z-score computations
  • Distribution analysis (kurtosis, skewness)
  • Covariance calculations

Time Series Analysis

• Series conversion and formatting
• Moving average calculations
• Trend detection and analysis
• Seasonality identification
• Time-based forecasting
• Temporal grouping operations
• Time-based aggregations
• Interval handling

Machine Learning Operations

• Clustering algorithms
  • K-means implementation
  • Cluster analysis tools
• Regression analysis
  • Linear regression
  • Multi-variable regression
• Classification tools
  • K-nearest neighbors (KNN)
  • Naive Bayes classifier
• Anomaly detection systems
• Data preparation
  • Normalization
  • Outlier handling
  • Feature scaling

Async & Performance Optimization

• Asynchronous operations
  • Async mapping
  • Async filtering
  • Async reduction
• Parallel processing capabilities
• Batch processing systems
• Lazy evaluation strategies
• Caching mechanisms
• Performance tools
  • Profiling utilities
  • Memory optimization
  • Index management
  • Operation monitoring

Data Validation & Quality

• Validation framework
  • Schema validation
  • Custom rules
  • Async validation
• Data sanitization tools
• Quality metrics
• Constraint management
• Error handling
• Type enforcement

Text Processing

• String manipulation
  • Join operations
  • Implode functionality
  • Case transformation
• URL slug generation
• Text analysis
  • Word frequency
  • N-gram generation
  • Sentiment analysis
• Pattern matching
• String normalization

Serialization & Export

• Multiple format support
  • JSON serialization
  • CSV generation
  • XML export
• Query generation
  • SQL queries
  • GraphQL operations
• Integration formats
  • Elasticsearch bulk
  • Pandas DataFrame
• Custom formatting options

Streaming & I/O

• Stream operations
  • Stream creation
  • Stream consumption
• Batch streaming
• Memory-efficient processing
• Buffered operations

Advanced Mathematical Operations

• Signal processing
  • Fast Fourier Transform (FFT)
  • Signal interpolation
  • Convolution operations
• Calculus operations
  • Differentiation
  • Integration
• Numerical methods
• Mathematical optimizations

Special Data Types Support

• Geographic calculations
  • Distance computations
  • Coordinate handling
• Financial operations
  • Money formatting
  • Currency handling
• DateTime operations
  • Formatting
  • Timezone handling
• Complex number support
  • Basic operations
  • Advanced computations

Versioning & History

• Version management
  • Version tracking
  • History storage
• Change tracking
  • Diff generation
  • Change detection
• History operations
  • Rollback support
  • Version comparison

Development Tools

• Development aids
  • Playground environment
  • Debugging utilities
• Analysis tools
  • Pipeline visualization
  • Performance benchmarking
• Development modes
  • Debug mode
  • Strict mode

Utility Features

• System configuration
  • Configuration management
  • Environment handling
• Internationalization
  • Locale support
  • Timezone management
• Error handling
  • Error modes
  • Exception handling
• Resource management
  • Memory tracking
  • Resource cleanup

Available Methods

Please note, all of these methods may be chained to fluently manipulate the underlying data:

API Methods	API Methods	API Methods
aggregate	all	as
assertValid	avg	batch
benchmark	cache	cartesianProduct
cast	chunk	collapse
combine	configure	contains
containsAll	containsOneItem	convolve
correlate	count	countBy
crossJoin	cursor	dateTime
debug	dd	describe
detectAnomalies	differentiate	diffAssoc
diffKeys	diffUsing	doesntContain
dump	duplicates	each
eachSpread	entropy	everyAsync
explain	except	fft
filter	filterAsync	first
firstOrFail	firstWhere	flatten
flatMap	flip	forPage
forecast	forget	fromStream
fuzzyMatch	geoDistance	get
groupBy	groupByMultiple	has
having	impute	implode
index	instrument	integrate
intersect	isEmpty	isNotEmpty
join	kmeans	keyBy
keys	knn	kurtosis
last	lazy	leftJoin
linearRegression	lower	macro
make	map	mapAsync
mapInto	mapOption	mapSpread
mapToDictionary	mapToGroups	mapUntil
mapWithKeys	max	median
memoize	merge	mergeRecursive
metrics	min	mode
money	movingAverage	naiveBayes
ngrams	nth	normalize
omit	only	optimize
outliers	pad	paginate
parallel	partition	percentile
pick	pipe	pivot
pivotTable	pop	power
prefetch	prepend	product
profile	pull	push
put	query	random
reduce	reduceAsync	reject
removeOutliers	replace	replaceRecursive
reverse	sanitize	scan
search	seasonality	sentiment
shift	shuffle	skip
skipUntil	skipWhile	slice
slug	sole	someAsync
sort	sortBy	sortByDesc
sortDesc	sortKeys	sortKeysDesc
splice	split	standardDeviation
stream	sum	symmetricDiff
tap	take	takeUntil
takeWhile	timeSeries	times
toArray	toCSV	toElastic
toGraphQL	toJSON	toMap
toPandas	toSet	toSQL
toXML	transform	trend
union	unless	unlessEmpty
unlessNotEmpty	unfold	unwrap
upper	validate	validateSync
values	variance	when
whenEmpty	whenNotEmpty	where
whereBetween	whereIn	whereInstanceOf
whereLike	whereNotBetween	whereNotIn
whereNotNull	whereNull	whereRegex
wordFrequency	wrap	zscore

Changelog

Please see our releases page for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Stargazers

Community

For help, discussion about best practices, or any other conversation that would benefit from being searchable:

Discussions on GitHub

For casual chit-chat with others using this package:

Join the Stacks Discord Server

Credits

Thanks to...

• Laravel Collections for inspiration
• Chris Breuer for the initial implementation
• All Contributors for their contributions to Stacks & ts-collect

License

The MIT License (MIT). Please see LICENSE for more information.

Made with 💙