CFP - Home

"Helpful concepts like immutability are common in JavaScript and can be used without currying, knowing what an "identity function" is, or learning any theory. Those things may be useful for people wanting to learn them but pose a barrier for those who don't. Chaining feels natural until you want to call a function outside the prototype. Then you either need to modify the prototype and account for collisions or use a different approach, such as function composition."

"Common FP is opinionated and will throw errors when you use it in an unintended way. For example, mapValues requires you to pass a function, whereas Lodash provides a default. Calling mapValues without a function doesn't make sense to me; thus, I enforce that convention. This is one opinion of many that won't be shared by everyone - which is"

Common FP provides an opinionated JavaScript utility library that applies functional concepts without heavy jargon or advanced theory. Utilities operate generically across arrays, objects, Map, and Set, allowing functions like mapValues to return a new instance of the input data type. The design emphasizes readable implementation, predictability, and friendly errors that enforce deliberate usage patterns. The library favors immutability and composable approaches over prototype chaining, and it targets developers who want practical functional tools without deep FP learning. The library is intentional and may not suit users who prefer more permissive or fully theoretical functional libraries.

Read at Common-fp