move support module into its own directory

Author: KtorZ

ch04.md

@@ -53,8 +53,14 @@ What's demonstrated here is the ability to "pre-load" a function with an argumen
 
 I encourage you to clone the Mostly Adequate repository (`git clone
 https://github.com/MostlyAdequate/mostly-adequate-guide.git`), copy the code above and have a
-go at it in the REPL. The curry function (and actually anything defined in the appendixes) has
-been made available from the `exercises/support.js` module. 
+go at it in the REPL. The curry function, as well as actually anything defined in the appendixes,
+are available in the `support/index.js` module.
+
+Alternatively, have a look at a published version on `npm`:
+
+```
+npm install @mostly-adequate/support
+```
 
 ## More Than a Pun / Special Sauce
 

exercises/README.md

@@ -0,0 +1,48 @@
+# Mostly Adequate Exercises
+
+## Overview
+
+All exercises from the book can be completed either:
+
+- in browser (using the version of the book published on [gitbook.io](https://mostly-adequate.gitbooks.io/mostly-adequate-guide/))
+- in your editor & terminal, using `npm`
+
+In every folder named `ch**` from this `exercises/` folder, you'll find three types of files:
+
+- exercises
+- solutions
+- validations
+
+Exercises are structured with a statement in comment, followed by an incomplete
+or incorrect function. For example, `exercise_a` from `ch04` looks like this:
+
+
+```js
+// Refactor to remove all arguments by partially applying the function.
+
+// words :: String -> [String]
+const words = str => split(' ', str);
+```
+
+Following the statement, your goal is to refactor the given function `words`. Once done, 
+your proposal can be verified by running:
+
+```
+npm run ch04
+```
+
+Alternatively, you can also have a peak at the corresponding solution file: in this case
+`solution_a.js`. 
+
+> The files `validation_*.js` aren't really part of the exercises but are used
+> internally to verify your proposal and, offer hints when adequate. The curious 
+> reader may have a look at them :).
+
+Now go and learn some functional programming λ!
+
+## About the Appendixes
+
+Important notice: the exercise runner takes care of bringing all
+data-structures and functions from the appendixes into scope. Therefore, you
+may assume that any function present in the appendix is just available for you
+to use! Amazing, isn't it? 

exercises/package.json

@@ -1,9 +1,8 @@
 {
-  "name": "@mostly-adequate/support",
-  "version": "1.1.0",
-  "description": "Support functions and data-structures from the Mostly Adequate Guide to Functional Programming",
+  "name": "@mostly-adequate/exercises",
+  "version": "1.0.0",
+  "description": "Exercises coming with the Mostly Adequate Guide to Functional Programming",
   "license": "MIT",
-  "main": "index.js",
   "repository": {
     "type": "git",
     "url": "https://github.com/MostlyAdequate/mostly-adequate-guide"
@@ -13,12 +12,6 @@
     "url": "https://github.com/MostlyAdequate/mostly-adequate-guide/issues"
   },
   "homepage": "https://github.com/MostlyAdequate/mostly-adequate-guide",
-  "keywords": [
-    "functional programming",
-    "mostly adequate",
-    "guide",
-    "fp"
-  ],
   "dependencies": {},
   "devDependencies": {
     "cli": "^1.0.1",

support/.eslintrc.js

@@ -0,0 +1,22 @@
+const globals = Object
+  .keys(require('./support'))
+  .reduce((o, k) => ({ ...o, [k]: true }), { requirejs: true, assert: true });
+
+module.exports = {
+  extends: 'airbnb',
+  env: {
+    browser: true,
+    amd: true,
+  },
+  globals,
+  rules: {
+    'import/no-amd': 0,
+    'import/no-dynamic-require': 0,
+    'no-unused-vars': 0,
+    'object-curly-newline': [2, {
+      multiline: true,
+      consistent: true,
+      minProperties: 5,
+    }],
+  },
+};

exercises/.npmignore renamed to support/.npmignore

@@ -0,0 +1,39 @@
+# Mostly Adequate Guide to Functional Programming - Support
+
+## Overview 
+
+This package contains all functions and data-structure referenced in the
+appendixes of the [Mostly Adequate Guide to Functional Programming](https://github.com/MostlyAdequate/mostly-adequate-guide).
+
+These functions have an educational purpose and aren't intended to be used in
+any production environment. They are however, a good learning material for anyone
+interested in functional programming.
+
+## How to install
+
+The package is available on `npm` and can be installed via the following incantation:
+
+```
+npm install @mostly-adequate/support
+```
+
+## How to use
+
+There's no particular structure to the module, everything is flat and exported
+from the root (the curious reader may have a quick glance at the `index.js` to
+get convinced about this). 
+
+Also, all top-level functions are curried so you don't have to worry about calling
+`curry` on any of them.
+
+For example:
+
+```js
+const { Maybe, liftA2, append, concat, reverse } = require('@mostly-adequate/support');
+
+const a = Maybe.of("yltsoM").map(reverse);
+const b = Maybe.of("Adequate").map(concat(" "));
+
+liftA2(append)(b)(a);
+// Just("Mostly Adequate")
+```

support/README.md

@@ -0,0 +1,33 @@
+{
+  "name": "@mostly-adequate/support",
+  "version": "1.2.0",
+  "description": "Support functions and data-structures from the Mostly Adequate Guide to Functional Programming",
+  "license": "MIT",
+  "main": "index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MostlyAdequate/mostly-adequate-guide"
+  },
+  "author": "@mostly-adequate",
+  "bugs": {
+    "url": "https://github.com/MostlyAdequate/mostly-adequate-guide/issues"
+  },
+  "homepage": "https://github.com/MostlyAdequate/mostly-adequate-guide/support",
+  "keywords": [
+    "functional programming",
+    "mostly adequate",
+    "guide",
+    "fp"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "eslint": "^5.9.0",
+    "eslint-config-airbnb": "^16.1.0",
+    "eslint-plugin-import": "^2.8.0",
+    "eslint-plugin-jsx-a11y": "^6.0.2",
+    "eslint-plugin-react": "^7.5.1"
+  },
+  "scripts": {
+    "lint": "eslint ."
+  }
+}