@mwm/functional

You're looking at an experimental, extremely-minimal, functional library with a focus on clear source-code and readable function signatures. I've tried to design each function so that browsers and IDEs will generate readable function signatures and easy to debug code. Further, every exported function has an even simpler, haskell-style, <function>.signature string that you can examine.

Rational

Some of the challenges I've encountered learning Functional Programming in JavaScript are obtuse function signatures and implementations that are hard to debug. This project is designed to remedy these issues.

The goal is to provide simple, debuggable, functional programming building blocks that anyone can use while learning FP concepts. Implementations should be largely stand-alone, easy to read, and easy to debug. As a consequence, many of the included functions will contain duplicate and unoptimized code, but easier reading and reduced cognitive load should make the trade-off worthwhile.

This library is not meant to replace well-tested and engineered libraries like lodash/fp or Ramda. Instead, it's primarily meant to be a learning aid. I'll be using this library as part of the tutorials you can find at my website and GitHub profile. Please check them out … eventually!

Compatibility

Functional implements a subset of the Ramda API, but not the entire API. When you're ready, you can easily replace the Functional dependency with Ramda, without needing to refactor your code.

Credits

To keep this library simple and easily debuggable, I'll occasionally copy code from projects that have a compatible license into this project (instead of importing it as a dependency). When this is done, I'll include the original license with the source-code for that module, and (with permission) I'll give credit both here and in package.json's contributor field. Programming is hard work, and I can't thank the open-source community enough for the enormity of their multitudinous efforts!

Special Thanks To:

• Tim Davis, clone was based heavily on his deep-clone implementation.
• Pierre-Antoine Mills, for his How to master advanced TypeScript patterns article on freeCodeCamp and ts-toolbelt library. His step-by-step guide on advanced TypeScript types is invaluable.