atomic-fns

Read the Docs

Like Lodash, but in TypeScript and for ESNext.

Stop shipping code built for browsers from 2015.

You may prefer this library because:

• TypeScript & docs: Includes type declaration files and js with JSDocs for best in class experience.
• Zero deps: Built from scratch with no runtime dependencies or polyfills.
• ESNext: Uses modern idiomatic syntax, data structures, and control flow techniques.
• Modular: Pick what you need. Supports tree-shaking, no side effects, and works with all bundlers.
• Lazy: Leverage generators, iterators, and functional composition.
• Tests: All modules have comprehensive test suites and 100% test coverage.

Docs

📖 Available at atomic-fns

Get Started

This library is available as an npm package.

To install the package you need to have npm (or yarn) installed and then run:

npm install atomic-fns

How to use

Just import any function or class you need.

import { sorted, times, uniqueId } from 'atomic-fns'

times(5, (i) => i)
// -> [0, 1, 2, 3, 4]

sorted([4, 3, 2, 1])
// -> [1, 2, 3, 4]

uniqueId('user_')
// -> 'user_101225005'
...

See the full list of modules.

Data model

This library features a data model similar to Python but not always. Only the missing parts have been implemented, while respecting the JS standards.

For example, in Python collections, size() is a method, while in JS it's just a property. So this library uses size property instead of method. Similarly, the len function implementation checks for both length and size since many JS objects have a length property.

Special method names

This library adds support for operators using object methods such as:

• obj.eq(other) adds custom obj == other.
• obj.lt(other) adds custom obj < other.
• obj.lte(other) adds custom obj <= other.
• obj.gt(other) adds custom obj > other.
• obj.gte(other) adds custom obj >= other.
• obj.compare(other) overloads sorting operations.

When working with objects, functions in this library use these custom operators for equality and sorting. You can also apply operators to values like eq(x, y), lte(x, y), compare(x, y), etc.

New Types

Decimal provides support for correct rounded floating point arithmetic, with arbitrary precision.

This fixes precision issues with float arithmetic, for example:

0.1 + 0.1 + 0.1
// 0.30000000000000004

decimal('0.1').add('0.1').add('0.1').toNumber()
// 0.3

Some common base interfaces and typing patterns you may have seen like Optional, Result, Comparable, Iterator, and others.

Sorted Containers

• SortedSet
• SortedMap
• SortedTree

Other Containers

• Deque
• FrozenSet
• LRUCache

Contributing

If you want to contribute to the project and make it better, your help is very welcome. Contributing is also a great way to learn more about social coding on Github, new technologies and and their ecosystems and how to make constructive, helpful bug reports, feature requests and the noblest of all contributions: a good, clean pull request. You will be listed as a Champion on the official site as well.

License

Apache License 2.0