🥭 w/ references

Author: wolfram77

README.md

@@ -29,9 +29,10 @@ function, [unspread] combines all parameters into the first parameter (array),
 [wrap] adds ignored parameters to the left/right of a function's parameters, and
 [unwrap] removes common prefix and suffix parameters to a function (by passing
 known constant values as prefix/suffix). If you want some **functional**
-**behavior**, [compose], [composeRight], [curry], and [curryRight] can be used. If
-you are unfamiliar, [Haskell] is a great purely functional language, and there
-is great [haskell beginner guide] to learn from.
+**behavior**, [compose], [composeRight], [curry], and [curryRight] can be used.
+[composeRight] is also known as [pipe-forward operator] or [function chaining].
+If you are unfamiliar, [Haskell] is a great purely functional language, and
+there is great [haskell beginner guide] to learn from.
 
 To control invocation **time** of a function, use [delay]. A function can be
 **rate controlled** with [limitUse], [debounce], [debounceEarly], [throttle],
@@ -47,16 +48,18 @@ refreshing a webpage]. Except [limitUse], all *rate/time control* methods can be
 *flushed* (`flush()`) to invoke the target function immediately, or *cleared*
 (`clear()`) to disable invocation of the target function.
 
-In addition, use [is], [isAsync], [isGenerator], [signature], [name],
-[parameters], and [arity] to obtain metadata (about) information on a function.
-A few generic functions are also included: [ARGUMENTS], [NOOP], [IDENTITY],
-[COMPARE].
+In addition, [is], [isAsync], [isGenerator], [signature], [name], [parameters],
+and [arity] obtain metadata (about) information on a function. To attach a
+`this` to a function, use [bind]. A few generic functions are also included:
+[ARGUMENTS], [NOOP], [IDENTITY], [COMPARE].
 
 This package is available in both *Node.js* and *Web* formats. The web format is
 exposed as `extra_function` standalone variable and can be loaded from [jsDelivr CDN].
 
 [(1)]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Functions
 [lambda calculus]: https://en.wikipedia.org/wiki/Lambda_calculus
+[pipe-forward operator]: https://stackoverflow.com/questions/1457140/haskell-composition-vs-fs-pipe-forward-operator
+[function chaining]: https://www.npmjs.com/package/chain-function
 [Haskell]: https://www.haskell.org
 [haskell beginner guide]: http://learnyouahaskell.com
 [constantly refreshing a webpage]: https://tenor.com/view/social-network-mark-zuckerberg-refresh-movie-jesse-eisenberg-gif-12095762
@@ -72,17 +75,17 @@ const funcxion = require('extra-function');
 // import * as funcxion from "extra-function";
 // import * as funcxion from "https://unpkg.com/extra-function/index.mjs"; (deno)
 
-funcxion.sum(1, 2, 3, 4);
-// → 10
+funcxion.composeRight(x => x*x, x => x+2);
+// → 102
 
-funcxion.median(1, 7, 8);
+funcxion.curry((x, y) => x+y);
 // → 7
 
-funcxion.variance(1, 2, 3, 4);
+funcxion.unspread(Math.max);
 // → 1.25
 
-funcxion.lcm(2, 3, 4);
-// → 12
+funcxion.parameters((x, y) => x+y);
+// → [ 'x', 'y' ]
 ```
 
 <br>
@@ -99,6 +102,7 @@ funcxion.lcm(2, 3, 4);
 | [COMPARE] | Compare two values. |
 |  |  |
 | [is] | Check if value is a function. |
+| [isAsync] | Check if value is an async function. |
 | [isGenerator] | Check if value is a generator function. |
 | [signature] | Get the signature of a function. |
 | [name] | Get the name of a function. |
@@ -136,20 +140,47 @@ funcxion.lcm(2, 3, 4);
 
 ## References
 
-- [Modulo operation](https://en.wikipedia.org/wiki/Modulo_operation)
+- [MDN Web docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference)
+- [Lodash documentation](https://lodash.com/docs/4.17.15)
+- [Underscore.js documentation](https://underscorejs.org/)
+- [Function composition](https://en.wikipedia.org/wiki/Function_composition)
+- [Debouncing and Throttling Explained Through Examples by David Corbacho](https://css-tricks.com/debouncing-throttling-explained-examples/)
+- [Learn You a Haskell for Great Good!: Higher order functions by Miran Lipovaca](http://learnyouahaskell.com/higher-order-functions)
+- [How to know if a function is async?](https://stackoverflow.com/questions/38508420/how-to-know-if-a-function-is-async)
+- [Check if function is a generator](https://stackoverflow.com/questions/16754956/check-if-function-is-a-generator)
+- [Haskell composition (.) vs F#'s pipe forward operator (|>)](https://stackoverflow.com/questions/1457140/haskell-composition-vs-fs-pipe-forward-operator)
+- [JavaScript Detect Async Function by David Walsh](https://davidwalsh.name/javascript-detect-async-function)
+- [is-function package by Stephen Sugden](https://www.npmjs.com/package/is-function)
+- [is-async-function package by Jordan Harband](https://www.npmjs.com/package/is-async-function)
+- [is-callback-function package by Charlike Mike Reagent](https://www.npmjs.com/package/is-callback-function)
+- [is-generator-fn package by Sindre Sorhus](https://www.npmjs.com/package/is-generator-fn)
+- [is-generator-function package by Jordan Harband](https://www.npmjs.com/package/is-generator-function)
+- [fn-name package by Sindre Sorhus](https://www.npmjs.com/package/fn-name)
+- [memoizee package by Mariusz Nowak](https://www.npmjs.com/package/memoizee)
+- [memoizerific package by @thinkloop](https://www.npmjs.com/package/memoizerific)
+- [compose-function package by Christoph Hermann](https://www.npmjs.com/package/compose-function)
+- [chain-function package by Jason Quense](https://www.npmjs.com/package/chain-function)
+- [@spudly/curry package by Stephen Sorensen](https://www.npmjs.com/package/@spudly/curry)
+- [one-time package by Arnout Kazemier](https://www.npmjs.com/package/one-time)
+- [onetime package by Sindre Sorhus](https://www.npmjs.com/package/onetime)
+- [once package by Isaac Z. Schlueter](https://www.npmjs.com/package/once)
+- [debounce package by @component](https://www.npmjs.com/package/debounce)
+- [throttle-debounce package by Ivan Nikolić](https://www.npmjs.com/package/throttle-debounce)
+- [throttleit package by @component](https://www.npmjs.com/package/throttleit)
 
 <br>
 <br>
 
 
-[![](https://img.youtube.com/vi/dW8Cy6WrO94/maxresdefault.jpg)](https://www.youtube.com/watch?v=dW8Cy6WrO94)<br>
+[![](https://img.youtube.com/vi/vzfy4EKwG_Y/maxresdefault.jpg)](https://www.youtube.com/watch?v=vzfy4EKwG_Y)<br>
 
 
 [ARGUMENTS]: https://nodef.github.io/extra-function/modules.html#ARGUMENTS
 [NOOP]: https://nodef.github.io/extra-function/modules.html#NOOP
 [IDENTITY]: https://nodef.github.io/extra-function/modules.html#IDENTITY
 [COMPARE]: https://nodef.github.io/extra-function/modules.html#COMPARE
 [is]: https://nodef.github.io/extra-function/modules.html#is
+[isAsync]: https://nodef.github.io/extra-function/modules.html#isAsync
 [isGenerator]: https://nodef.github.io/extra-function/modules.html#isGenerator
 [signature]: https://nodef.github.io/extra-function/modules.html#signature
 [name]: https://nodef.github.io/extra-function/modules.html#name

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "extra-function",
-  "version": "0.1.5",
+  "version": "1.0.0",
   "description": "A collection of ways for transforming functions.",
   "main": "index.js",
   "module": "index.mjs",