@putout/engine-loader 7.1.2 → 8.0.0

package/README.md

@@ -3,7 +3,7 @@
 [NPMIMGURL]: https://img.shields.io/npm/v/@putout/engine-loader.svg?style=flat&longCache=true
 [NPMURL]: https://npmjs.org/package/@putout/engine-loader"npm"
 
-Load 🐊[**Putout**](https://github.com/coderaiser/putout) `Plugins` and `Processors`.
+🐊[**Putout**](https://github.com/coderaiser/putout) loader for `plugins` and `processors`.
 
 ## Install
 
@@ -11,12 +11,33 @@ Load 🐊[**Putout**](https://github.com/coderaiser/putout) `Plugins` and `Proce
 npm i @putout/engine-loader
 ```
 
+## Plugins
+
+Loader supports two kinds of plugins:
+
+- ☝️ [**Onerule Plugin**](#simple-plugin)
+- ☝️ [**Multirule Plugin**](#multirule-plugin)
+
+### Onerule Plugin
+
+Simplest type of plugin support by [`@putout/engine-runner`](https://github.com/coderaiser/putout/tree/master/packages/engine-runner#supported-plugin-types), contains one rule.
+
+### Multirule Plugin
+
+Nested contains one or more rules:
+
+```js
+module.exports.rules = {
+    'remove-unused-variables': require('@putout/plugin-remove-unused-variables'),
+};
+```
+
 ## Env Variables
 
 When you need to get things working with Yarn PnP, and using custom `plugins` `formatters` or `processers`, add env variable
 `PUTOUT_YARN_PNP` with name of a package that contains dependencies you need.
 
-## Code Example
+## API
 
 ### loadPlugins
 

package/lib/index.js

@@ -93,11 +93,11 @@ module.exports.loadPlugins = (options) => {
     // but we can't because of a way multi-rule plugins
     // works. We can't determine count and names of all
     // rules of a plugin before load.
-    for (const plugin of plugins) {
-        if (!isEnabled(plugin, cookedRules))
+    for (const [name, plugin] of plugins) {
+        if (!isEnabled(name, cookedRules))
             continue;
         
-        result.push(mergeRules(plugin, cookedRules));
+        result.push(mergeRules([name, plugin], cookedRules));
     }
     
     return result;

package/lib/is-enabled.js

@@ -1,23 +1,16 @@
 'use strict';
 
-const {isArray} = Array;
-
-const isBool = (a) => typeof a === 'boolean';
-
 module.exports = (name, rules) => {
-    if (isArray(name))
-        [name] = name;
-    
-    if (isBool(rules[name]))
-        return rules[name];
-    
-    let resultState = true;
+    for (const {rule, state} of rules) {
+        if (rule === name)
+            return state;
+    }
     
     for (const {rule, state} of rules) {
         if (RegExp(`^${rule}`).test(name))
-            resultState = state;
+            return state;
     }
     
-    return resultState;
+    return true;
 };
 

package/lib/validate-plugin.js

@@ -7,6 +7,7 @@ const supportedKeys = [
     'include',
     'exclude',
     'rules',
+    'declare',
 ];
 
 module.exports = ({plugin, rule}) => {

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@putout/engine-loader",
-  "version": "7.1.2",
+  "version": "8.0.0",
   "type": "commonjs",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "load plugins and prepare them to run",
   "homepage": "https://github.com/coderaiser/putout/tree/master/packages/engine-loader#readme",
   "main": "lib/index.js",
-  "commitType": "colon",
   "release": false,
   "tag": false,
   "changelog": false,
@@ -53,6 +52,7 @@
     "eslint-plugin-n": "^15.2.4",
     "eslint-plugin-putout": "^16.0.0",
     "estrace": "*",
+    "babel-plugin-angularjs-annotate": "https://github.com/putoutjs/babel-plugin-angularjs-annotate",
     "just-camel-case": "^4.0.2",
     "lerna": "^6.0.1",
     "madrun": "^9.0.0",