putout 25.1.0 → 25.3.0

package/ChangeLog

@@ -1,3 +1,51 @@
+2022.03.07, v25.3.0
+
+feature:
+- (@putout/plugin-try-catch) renamed from @putout/plugin-apply-try-catch
+- (@putout/plugin-apply-try-catch) try-catch: add support of finalizer
+- (@putout/plugin-apply-try-catch) add expand-arguments from @putout/plugin-tape
+- (@putout/plugin-tape) expand-try-catch-arguments: add support of tryCatch with more then one argument
+- (@putout/plugin-regexp) convert-replace-to-replace-all: add support of decoding
+- (@putout/eslint-config) add newline-per-chained-call
+- (@putout/plugin-regexp) convert-replace-to-replace-all: replacer -> traverser: multiple operations on one node
+
+
+2022.03.06, v25.2.0
+
+fix:
+- (@putout/plugin-apply-try-catch) try-to-catch: report: await
+
+
+feature:
+- (package) @putout/plugin-remove-useless-escape v3.0.0
+- (putout) convert-replace-to-replace-all: enable since node v16 support
+- (@putout/plugin-remove-useless-escape) drop support of putout < 25
+- (@putout/plugin-regexp) apply-literal-notation: add support of \/
+- (@putout/plugin-remove-useless-escape) add support of \/
+
+
+2022.03.05, v25.1.1
+
+feature:
+- (package) @putout/plugin-apply-array-at v2.0.0
+- (@putout/plugin-apply-array-at) drop support of putout < 25
+- (@putout/plugin-apply-array-at) report
+- (@putout/plugin-apply-array-at) exclude left of AssignmentExpression
+- (@putout/plugin-promises) remove-useless-await: add support of OptionalCallExpression
+- (@putout/operator-declare) exclude TSDeclareMethod
+- (@putout/operator-declare) exclude TSFunctionType
+- (@putout/plugin-nodejs) declare: rm type
+- (@putout/operator-declare) exclude TSParameterProperty
+- (@putout/operator-declare) exclude TSMethodSignature
+- (@putout/plugin-promise) remove-useless-await: exclude `new await Promise()`
+- (eslint-plugin-putout) ts: disable warn on unsupported version (https://github.com/typescript-eslint/typescript-eslint/tree/main/packages/parser#parseroptionswarnonunsupportedtypescriptversion)
+- (@putout/plugin-apply-try-catch) try-catch: improve filtering of CallExpression
+- (@putout/plugin-apply-try-catch) try-to-catch: improve filtering Await Expressions
+- (eslint-plugin-putout) nonblock-statement-body-newline: add support of for, for-of, while
+- (eslint-plugin-putout) add nonblock-statement-body-newline
+- (eslint-plugin-putout) *.md{js}: enable quotes, quote-props'
+
+
 2022.03.01, v25.1.0
 
 feature:

package/README.md

@@ -7,96 +7,138 @@
 [CoverageURL]: https://coveralls.io/github/coderaiser/putout?branch=master
 [CoverageIMGURL]: https://coveralls.io/repos/coderaiser/putout/badge.svg?branch=master&service=github
 
+> **Perfection is finally attained not when there is no longer anything to add,
+> but when there is no longer anything to take away.**
+>
+> **(c) Antoine de Saint Exupéry**
+
 ![putout](https://github.com/coderaiser/putout/blob/master/images/putout-logo.svg)
 
-🐊[**Putout**](https://github.com/coderaiser/putout) find and fix problems in your `JavaScript`, `JSX`, `Typescript`, `Flow`, `Yaml, `Json`and`Markdown`. It can:
-
-- remove unused `variables`;
-- remove unused `for-of variables`;
-- remove unused `typescripts` types;
-- remove unreferenced `variables`;
-- remove unused `private fields`;
-- remove unused `expressions`;
-- remove useless `variables`;
-- remove useless `map`;
-- remove useless `mapped types`;
-- remove useless `mapping modifiers`;
-- remove useless `continue`;
-- remove useless `operand`;
-- remove useless `array constructor`;
-- remove useless `conditions`;
-- remove useless `type conversion`;
-- remove useless `functions`;
-- remove useless `Array.from`;
-- remove useless `spread`;
-- remove useless `arguments`;
-- remove useless `escape`;
-- remove useless `async`;
-- remove useless `await`;
-- remove useless `typeof`;
-- remove useless `template expressions`;
-- remove useless `for-of`;
-- remove useless `array.entries()`;
-- remove `debugger` statement;
-- remove `iife`;
-- remove nested blocks;
-- remove `process.exit` call;
-- remove `console.log` calls;
-- remove `empty block statements`;
-- remove `empty patterns`;
-- remove `strict mode` directive from `esm`;
-- remove `constant conditions`;
-- remove `boolean` from `assertion`;
-- remove `boolean` from `logical expressions`;
-- remove `duplicates` from `logical expressions`;
-- remove `duplicates` from TypeScript `Union`;
-- remove `unreachable code`;
-- remove `duplicate keys`;
-- remove useless `typescripts` types;
-- remove duplicate `typescripts` interface keys;
-- replace `test.only` to `test` calls;
-- replace `test.skip` to `test` calls;
-- reuse duplicate `init`;
-- split `variable declarations`;
-- split `nested destructuring`;
-- simplify `assignment`;
-- simplify `ternary`;
-- simplify `logical expressions`;
-- if absent `strict mode` directive in `commonjs` add it;
-- convert `apply` to `spread`;
-- convert `bitwise` to `logical` operator;
-- convert `concat` to `flat`;
-- convert `esm` to `commonjs` (enabled for `*.cjs`);
-- convert `commonjs` to `esm` (enabled for `*.mjs`);
-- convert `template` with one `expression` to `string`;
-- convert `equal` to `strict equal`;
-- convert `indexOf` to `includes`;
-- convert `replace` to `replaceAll` (disabled, [stage 4](https://github.com/tc39/proposal-string-replaceall));
-- convert `assignment` to `arrow function`;
-- convert `forEach` to `for-of`;
-- convert `map` to `for-of`;
-- extract sequence expressions;
-- extract object properties;
-- add `return await`;
-- remove useless `Promise.resolve`;
-- convert `Promise.reject` to `throw`;
-- declare `undefined variables`;
-- apply `as` type assertions;
-- apply `utility types`;
-- apply `array.at` ([not bundled](https://github.com/nodejs/node/blob/master/doc/changelogs/CHANGELOG_V16.md#2021-07-29-version-1660-current-bethgriggs));
-- apply `filter(Boolean)`;
-- apply [isArray](https://web.mit.edu/jwalden/www/isArray.html);
-- apply `if condition`;
-- apply `await import`;
-
-## Why?
-
-- because [eslint](https://eslint.org) avoids [fixes that could change the runtime behavior](https://eslint.org/docs/developer-guide/working-with-rules#applying-fixes).
-- because [babel](https://babeljs.io) produces [throw-away code](https://github.com/babel/babel/issues/5139);
-- because [pretier](https://github.com/prettier/prettier) it is a formatter;
-- because [jscodeshift](https://github.com/facebook/jscodeshift) has no `config` and `plugins` support.
-
-The main difference of `putout` is saving code transformation results directly into source code in a day-to-day baisis.
+🐊**Putout** is a pluggable and configurable code transformer with built-in ESLint and Babel plugins support for js, jsx, typescript and flow files. It has [a lot of transformations](#-built-in-transformations) that will keep your codebase in a clean state, transforming any code smell to readable code according to best practices.
+
+[![putout](https://asciinema.org/a/0akg9gkJdbmbGl6BbpaycgKZm.svg)](https://asciinema.org/a/0akg9gkJdbmbGl6BbpaycgKZm)
+
+## 🤷‍️ In doubt about using 🐊Putout?
+
+Check out couple variants of plugins that does the same: [**linting debugger statement**](https://putout.cloudcmd.io/#/gist/f61ba31fe534868d49eba9b946f3ed4b/5ef6863d9cf4826666782ae0eea5cb5def266bbd):
+
+- ❌ ESLint [no-debugger](https://github.com/eslint/eslint/blob/2dc38aa653f1d5137a9abf82024c67a11620bb7c/lib/rules/no-debugger.js): **43** lines;
+- ❌ SWCLint [no-debugger](https://github.com/swc-project/swc/blob/v1.2.138/crates/swc_ecma_lints/src/rules/no_debugger.rs): **49** lines;
+- ❌ Rome [no-debugger](https://github.com/rome/tools/blob/4d5a99ce98e987cbd03f3ab6b38fa22d00bbfe27/packages/%40romejs/js-compiler/transforms/lint/noDebugger.ts): **28** lines;
+- ❌ RSLint [no-debugger](https://github.com/rslint/rslint/blob/v0.3.0/crates/rslint_core/src/groups/errors/no_debugger.rs): **48** lines
+- ✅ 🐊**Putout** [remove-debugger](https://github.com/coderaiser/putout/blob/v24.6.0/packages/plugin-remove-debugger/lib/remove-debugger.js): **7** lines:
+
+*Choose wisely, competitors cannot even fix…* 🤫
+
+```js
+'use strict';
+
+module.exports.report = () => 'Unexpected "debugger" statement';
+
+module.exports.replace = () => ({
+    debugger: '',
+});
+```
+
+## 🙏 Whom should I thank for this project exist?
+
+> **If I have seen further, it is by standing upon the shoulders of giants.**
+>
+> **(c) Isaak Newton**
+
+- 💪 [**ESLint**](https://eslint.org) for stable releases and future proof `API`.
+- 💪 [**Babel**](https://babeljs.io) for amazing `API` documented in [`Handbook`](https://github.com/jamiebuilds/babel-handbook/blob/master/translations/en/plugin-handbook.md#babel-plugin-handbook) and responsiveness of a team.
+- 💪 [**Prettier**](https://github.com/prettier/prettier) for minimalistic options and uniform codestyle.
+- 💪 [**jscodeshift**](https://github.com/facebook/jscodeshift) for making codemods simple and popular.
+
+## 🤷 Why does this project exist?
+
+- ❌ [**ESLint**](https://eslint.org) avoids [fixes that could change the runtime behavior](https://eslint.org/docs/developer-guide/working-with-rules#applying-fixes).
+- ❌ [**Babel**](https://babeljs.io) produces [throw-away code](https://github.com/babel/babel/issues/5139).
+- ❌ [**Prettier**](https://github.com/prettier/prettier) is a formatter.
+- ❌ [**jscodeshift**](https://github.com/facebook/jscodeshift) has no `config` and `plugins` support.
+
+☝️ *🐊**Putout** on the other hand can make more drastic code transformations that directly affect your codebase making it a better place to code 💻.*
+
+[It can](https://github.com/coderaiser/putout#-built-in-transformations):
+
+- ✅ remove unused `variables`;
+- ✅ remove unused `for-of variables`;
+- ✅ remove unused `typescripts` types;
+- ✅ remove unreferenced `variables`;
+- ✅ remove unused `private fields`;
+- ✅ remove unused `expressions`;
+- ✅ remove useless `variables`;
+- ✅ remove useless `map`;
+- ✅ remove useless `mapped types`;
+- ✅ remove useless `mapping modifiers`;
+- ✅ remove useless `continue`;
+- ✅ remove useless `operand`;
+- ✅ remove useless `array constructor`;
+- ✅ remove useless `conditions`;
+- ✅ remove useless `type conversion`;
+- ✅ remove useless `functions`;
+- ✅ remove useless `Array.from`;
+- ✅ remove useless `spread`;
+- ✅ remove useless `arguments`;
+- ✅ remove useless `escape`;
+- ✅ remove useless `async`;
+- ✅ remove useless `await`;
+- ✅ remove useless `typeof`;
+- ✅ remove useless `template expressions`;
+- ✅ remove useless `for-of`;
+- ✅ remove useless `array.entries()`;
+- ✅ remove `debugger` statement;
+- ✅ remove `iife`;
+- ✅ remove nested blocks;
+- ✅ remove `process.exit` call;
+- ✅ remove `console.log` calls;
+- ✅ remove `empty block statements`;
+- ✅ remove `empty patterns`;
+- ✅ remove `strict mode` directive from `esm`;
+- ✅ remove `constant conditions`;
+- ✅ remove `boolean` from `assertion`;
+- ✅ remove `boolean` from `logical expressions`;
+- ✅ remove `duplicates` from `logical expressions`;
+- ✅ remove `duplicates` from TypeScript `Union`;
+- ✅ remove `unreachable code`;
+- ✅ remove `duplicate keys`;
+- ✅ remove useless `typescripts` types;
+- ✅ remove duplicate `typescripts` interface keys;
+- ✅ replace `test.only` to `test` calls;
+- ✅ replace `test.skip` to `test` calls;
+- ✅ reuse duplicate `init`;
+- ✅ split `variable declarations`;
+- ✅ split `nested destructuring`;
+- ✅ simplify `assignment`;
+- ✅ simplify `ternary`;
+- ✅ simplify `logical expressions`;
+- ✅ if absent `strict mode` directive in `commonjs` add it;
+- ✅ convert `apply` to `spread`;
+- ✅ convert `bitwise` to `logical` operator;
+- ✅ convert `concat` to `flat`;
+- ✅ convert `esm` to `commonjs` (enabled for `*.cjs`);
+- ✅ convert `commonjs` to `esm` (enabled for `*.mjs`);
+- ✅ convert `template` with one `expression` to `string`;
+- ✅ convert `equal` to `strict equal`;
+- ✅ convert `indexOf` to `includes`;
+- ✅ convert `replace` to `replaceAll` (disabled, [stage 4](https://github.com/tc39/proposal-string-replaceall));
+- ✅ convert `assignment` to `arrow function`;
+- ✅ convert `forEach` to `for-of`;
+- ✅ convert `map` to `for-of`;
+- ✅ extract sequence expressions;
+- ✅ extract object properties;
+- ✅ add `return await`;
+- ✅ remove useless `Promise.resolve`;
+- ✅ convert `Promise.reject` to `throw`;
+- ✅ declare `undefined variables`;
+- ✅ apply `as` type assertions;
+- ✅ apply `utility types`;
+- ✅ apply `array.at` ([not bundled](https://github.com/nodejs/node/blob/master/doc/changelogs/CHANGELOG_V16.md#2021-07-29-version-1660-current-bethgriggs));
+- ✅ apply `filter(Boolean)`;
+- ✅ apply [isArray](https://web.mit.edu/jwalden/www/isArray.html);
+- ✅ apply `if condition`;
+- ✅ apply `await import`;
 
 ## Install
 
@@ -130,7 +172,7 @@ Options:
    --no-cache                  disable the cache
 ```
 
-To find erros:
+To find errors:
 
 ```
 putout lib test
@@ -156,7 +198,7 @@ putout lib --plugins remove-debugger,remove-unused-variables
 
 - `PUTOUT_FILES` - files that should be processed by putout, divided by ",";
 - `PUTOUT_CONFIG_FILE` - path to 🐊**Putout** config file;
-- `ESLINT_CONFIG_FILE` - path to `ESLint` config file;
+- `ESLINT_CONFIG_FILE` - path to **ESLint** config file;
 
 ```sh
 PUTOUT_FILES=lib,test putout --fix
@@ -194,7 +236,12 @@ When you need to ignore some routes no metter what, you can use `ignore` section
 
 ## Plugins
 
-🐊**Putout** supports `plugins`, there is two types: with prefix official `@putout/plugin-` and user plugins with prefix `putout-plugin-`. To use your plugin create plugin as `npm` package with keywords `putout`, `putout-plugin` and add it to `.putout.json`.
+🐊**Putout** supports two types of `plugins`, prefix with:
+
+- ✅ `@putout/plugin-`;
+- ✅ `putout-plugin-`;
+
+To use your plugin create`npm` package with keywords `putout`, `putout-plugin` and add it to `.putout.json`.
 
 For example if you need to `remove-something` create 🐊[**Putout**](https://github.com/coderaiser/putout) plugin with name `putout-plugin-remove-something` and it to `package.json`:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "putout",
-  "version": "25.1.0",
+  "version": "25.3.0",
   "type": "commonjs",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "🐊 Pluggable and configurable code transformer with built-in eslint and babel plugins support of js, jsx typescript, flow files, markdown, yaml and json",
@@ -70,14 +70,13 @@
     "@putout/operator-add-args": "^3.0.0",
     "@putout/operator-declare": "^4.0.0",
     "@putout/operator-regexp": "^1.0.0",
-    "@putout/plugin-apply-array-at": "^1.0.0",
+    "@putout/plugin-apply-array-at": "^2.0.0",
     "@putout/plugin-apply-await-import": "^1.0.0",
     "@putout/plugin-apply-destructuring": "^5.0.0",
     "@putout/plugin-apply-if-condition": "^1.0.0",
     "@putout/plugin-apply-is-array": "^2.0.0",
     "@putout/plugin-apply-numeric-separators": "^1.0.0",
     "@putout/plugin-apply-optional-chaining": "^2.0.0",
-    "@putout/plugin-apply-try-catch": "^2.0.0",
     "@putout/plugin-browserlist": "^1.0.0",
     "@putout/plugin-convert-apply-to-spread": "^3.0.0",
     "@putout/plugin-convert-arguments-to-rest": "^1.0.0",
@@ -143,7 +142,7 @@
     "@putout/plugin-remove-useless-conditions": "^1.0.0",
     "@putout/plugin-remove-useless-constructor": "^1.0.0",
     "@putout/plugin-remove-useless-continue": "^1.0.0",
-    "@putout/plugin-remove-useless-escape": "^2.0.0",
+    "@putout/plugin-remove-useless-escape": "^3.0.0",
     "@putout/plugin-remove-useless-for-of": "^2.0.0",
     "@putout/plugin-remove-useless-functions": "^2.0.0",
     "@putout/plugin-remove-useless-map": "^1.0.0",
@@ -163,6 +162,7 @@
     "@putout/plugin-split-variable-declarations": "^2.0.0",
     "@putout/plugin-strict-mode": "^3.0.0",
     "@putout/plugin-tape": "^9.0.0",
+    "@putout/plugin-try-catch": "^1.0.0",
     "@putout/plugin-typescript": "^1.0.0",
     "@putout/plugin-webpack": "^1.0.0",
     "@putout/processor-css": "^3.0.0",

package/putout.json

@@ -119,7 +119,6 @@
         "github": "off",
         "tape": "off",
         "strict-mode": "off",
-        "regexp/convert-replace-to-replace-all": "off",
         "convert-mock-require-to-mock-import": "off"
     },
     "plugins": [
@@ -130,7 +129,6 @@
         "apply-optional-chaining",
         "apply-numeric-separators",
         "apply-if-condition",
-        "apply-try-catch",
         "extract-object-properties",
         "extract-sequence-expressions",
         "madrun",
@@ -217,6 +215,7 @@
         "regexp",
         "github",
         "tape",
+        "try-catch",
         "nodejs"
     ]
 }