@putout/plugin-declare [![NPM version][NPMIMGURL]][NPMURL]

[NPMIMGURL]: https://img.shields.io/npm/v/@putout/plugin-declare.svg?style=flat&longCache=true
[NPMURL]: https://npmjs.org/package/@putout/plugin-declare "npm"

🐊Putout plugin adds ability to declare variable that was not defined before, including:

- maybe: maybeArray, maybeFn, maybeEmptyArray;
- wrap: not,id, returns;
- fresh-import: freshImport, freshImportDefault;
- fixtures: readFixture;
- properties of Object;
- wraptile;
- fullstore;
- currify;
- pipe-io;
- pullout;
- wait;
- chalk;
- jessy;
- nessy;
- table;

Install

``
npm i putout @putout/plugin-declare -D
`

Add .putout.json with:

`json
{
"plugins": {
"declare": "on"
}
}
`

Rules

Use options:

- ✅ dismiss for variables you don't want to declare;
- ✅ declarations to declare variables;

`json
{
"rules": {
"declare": ["on", {
"declarations": {
"hello": "import {hello} from 'world'"
},
"dismiss": [
"assert",
"entries",
"parse",
"stringify",
"defineProperty",
"noop",
"join",
"keys",
"values",
"stopAll",
"once",
"putout"
]
}]
}
}
`

assign

$3

`js
const hello = 'world';
const object = {};

assign(object, {
hello,
});
`

$3

`js
const hello = 'world';
const object = {};
const {assign} = Object;

assign(object, {
hello,
});
`

keys

$3

`js
const hello = 'world';
const object = {};

const allKeys = keys(object);
`

$3

`js
const hello = 'world';
const object = {};
const {keys} = Object;

const allKeys = keys(object);
`

values

$3

`js
const object = {};
const allValues = values(object);
`

✅ Example of correct code

`js
const {values} = Object;

const object = {};
const allValues = values(object);
`

noop

$3

`js
noop();
`

$3

`js
const noop = () => {};
noop();
`

Types

$3

`js
const isFn = (a) => typeof a === 'function';

if (isFn(fn))
fn();
`

$3

`js
const isFn = (a) => typeof a === 'function';

if (isFn(fn))
fn();
`

Maybe

$3

`js
const a = maybeArray(b);
`

$3

`js
const {isArray} = Array;
const maybeArray = (a) => isArray(a) ? a : [a];

const a = maybeArray(b);
`

entries

$3

`js
entries([1, 2, 3]);
`

$3

`js
const {entries} = Object;

entries([1, 2, 3]);
`

fromEntries

$3

`js
fromEntries(['hello', 'world']);
`

$3

`js
const {fromEntries} = Object;

fromEntries(['hello', 'world']);
`

fromCharCode

$3

`js
const encoded = new TextEncoder().encode(str);
fromCharCode(...encoded);
`

$3

`js
const {fromCharCode} = String;
const encoded = new TextEncoder().encode(str);

fromCharCode(...encoded);
``

License

MIT