@putout/engine-parser 5.6.0 → 6.1.0

package/README.md

@@ -1,7 +1,7 @@
 # @putout/engine-parser [![NPM version][NPMIMGURL]][NPMURL]
 
 [NPMIMGURL]: https://img.shields.io/npm/v/@putout/engine-parser.svg?style=flat&longCache=true
-[NPMURL]: https://npmjs.org/package/@putout/engine-parser"npm"
+[NPMURL]: https://npmjs.org/package/@putout/engine-parser "npm"
 
 🐊[**Putout**](https://github.com/coderaiser/putout) engine that parses input.
 
@@ -27,11 +27,35 @@ You can avoid using [`recast`](https://github.com/putoutjs/recast) and speed up
 
 ```js
 const ast = parse(source, {
-    recast: false,
+    printer: 'babel',
 });
 
 const code = print(ast, {
-    recast: false,
+    printer: 'babel',
+});
+```
+
+You can use brand new [`@putout/printer`](https://github.com/putoutjs/printer) which formats code according to [`eslint-plugin-putout`](https://github.com/coderaiser/putout/tree/master/packages/eslint-plugin-putout#readme) rules but without using **ESLint**.
+
+```js
+const ast = parse(source, {
+    printer: 'putout',
+});
+
+const code = print(ast, {
+    printer: 'putout',
+});
+```
+
+When you need to pass options, use:
+
+```js
+const code = print(ast, {
+    printer: ['putout', {
+        format: {
+            indent: '    ',
+        },
+    }],
 });
 ```
 
@@ -66,11 +90,14 @@ You have two ways to benefit from source map generation:
 
 ```js
 const source = `const hello = 'world';`;
+
 const ast = parse(source, {
     sourceFileName: 'hello.js',
 });
 
-print(ast, {sourceMapName: 'hello.map'});
+print(ast, {
+    sourceMapName: 'hello.map',
+});
 // returns
 `const hello = 'world';
 {"version":3,"sources":["hello.js"],"names":[],"mappings":"AAAA...","file":"hello.map","sourcesContent":["const hello = 'world';"]}`;
@@ -89,11 +116,17 @@ const ast = babel.parse(source, {
     sourceFilename: 'hello.js',
 });
 
-generate(ast, {sourceMaps: true}, {
+generate(ast, {
+    sourceMaps: true,
+}, {
     'hello.js': source,
 });
+
 // returns
-({code, map});
+({
+    code,
+    map,
+});
 ```
 
 ## Example

package/lib/custom-parser.js

@@ -7,7 +7,6 @@ const esprima = require('./parsers/esprima');
 const tenko = require('./parsers/tenko');
 const hermes = require('./parsers/hermes');
 const secondChance = require('./second-chance');
-
 const isObject = (a) => typeof a === 'object';
 
 module.exports = (source, parser, {isTS, isFlow, isJSX}) => {
@@ -55,4 +54,3 @@ function customParse(source, {parser, isTS, isFlow, isJSX}) {
     
     return require(parser).parse(source);
 }
-

package/lib/generate.js

@@ -9,4 +9,3 @@ module.exports = (node, options, sourceMaps) => {
         ...options,
     }, sourceMaps);
 };
-

package/lib/parse.js

@@ -1,18 +1,17 @@
 'use strict';
 
-const {parse} = require('@putout/recast');
+const recast = require('@putout/recast');
 const toBabel = require('estree-to-babel');
-
 const customParser = require('./custom-parser');
 
 module.exports = (source, options) => {
     const {
         parser,
+        printer = 'recast',
         isTS,
         isFlow,
         isJSX,
         sourceFileName,
-        recast = true,
     } = options || {};
     
     const cookedParser = getParser({
@@ -23,10 +22,10 @@ module.exports = (source, options) => {
         sourceFileName,
     });
     
-    if (!recast)
+    if (printer !== 'recast')
         return cookedParser.parse(source);
     
-    return parse(source, {
+    return recast.parse(source, {
         sourceFileName,
         parser: cookedParser,
     });

package/lib/parser.js

@@ -9,4 +9,3 @@ module.exports.print = print;
 module.exports.parse = parse;
 module.exports.generate = generate;
 module.exports.template = template;
-

package/lib/parsers/acorn.js

@@ -12,6 +12,7 @@ const initAcorn = once(() => {
 
 module.exports.parse = function acornParse(source) {
     const parser = initAcorn();
+    
     const options = {
         locations: true,
         comment: true,
@@ -30,4 +31,3 @@ module.exports.parse = function acornParse(source) {
         tokens: tokensToAvoidEsprima,
     };
 };
-

package/lib/parsers/babel/index.js

@@ -11,9 +11,7 @@ process.env.BABEL_TYPES_8_BREAKING = true;
 
 const plugins = require('./plugins');
 const options = require('./options');
-
 const moveOutDirectives = require('./move-out-directives');
-
 const getFlow = (a) => a.includes('// @flow');
 const clean = (a) => a.filter(Boolean);
 const initBabel = once(() => require('@babel/parser'));
@@ -24,6 +22,7 @@ const {assign} = Object;
 // babel, putout: sourceFilename
 module.exports.parse = function babelParse(source, {sourceFilename, isTS, isJSX = true, isFlow = getFlow(source)}) {
     const {parse} = initBabel();
+    
     const parserOptions = {
         sourceType: 'module',
         tokens: true,
@@ -43,7 +42,6 @@ module.exports.parse = function babelParse(source, {sourceFilename, isTS, isJSX
     });
     
     const ast = parse(source, parserOptions);
-    
     moveOutDirectives(ast);
     
     return ast;
@@ -55,16 +53,10 @@ function getBabelLangExts({isTS, isFlow, isJSX}) {
     ];
     
     if (isTS)
-        return langs.concat([
-            'typescript',
-        ]);
+        return langs.concat(['typescript']);
     
     if (isFlow)
-        return langs.concat([
-            'flow',
-            'flowComments',
-        ]);
+        return langs.concat(['flow', 'flowComments']);
     
     return langs;
 }
-

package/lib/parsers/babel/move-out-directives.js

@@ -18,12 +18,8 @@ module.exports = (ast) => {
     
     for (const directive of directives) {
         const {value} = directive.value;
-        
-        body.unshift(
-            ExpressionStatement(StringLiteral(value)),
-        );
+        body.unshift(ExpressionStatement(StringLiteral(value)));
     }
     
     return ast;
 };
-

package/lib/parsers/babel/options.js

@@ -5,4 +5,3 @@ module.exports = {
     allowUndeclaredExports: true,
     allowImportExportEverywhere: true,
 };
-

package/lib/parsers/babel/plugins.js

@@ -15,4 +15,3 @@ module.exports = [
     'throwExpressions',
     'recordAndTuple',
 ];
-

package/lib/parsers/espree.js

@@ -18,4 +18,3 @@ module.exports.parse = function espreeParse(source) {
         },
     });
 };
-

package/lib/parsers/esprima.js

@@ -14,4 +14,3 @@ module.exports.parse = function esprimaParse(source) {
         jsx: true,
     });
 };
-

package/lib/parsers/hermes.js

@@ -1,11 +1,11 @@
 'use strict';
 
 const once = require('once');
-
 const initHermes = once(() => require('hermes-parser'));
 
 module.exports.parse = function hermesParse(source) {
     const parser = initHermes();
+    
     const options = {
         babel: true,
         allowReturnOutsideFunction: true,
@@ -18,4 +18,3 @@ module.exports.parse = function hermesParse(source) {
     
     return result;
 };
-

package/lib/parsers/tenko.js

@@ -5,6 +5,7 @@ const initTenko = once(() => require('tenko'));
 
 module.exports.parse = (source) => {
     const {Tenko} = initTenko();
+    
     const {ast} = Tenko(source, {
         goalMode: 'module',
         allowGlobalReturn: true,
@@ -13,4 +14,3 @@ module.exports.parse = (source) => {
     
     return ast;
 };
-

package/lib/print.js

@@ -1,52 +1,47 @@
 'use strict';
 
-const {print} = require('@putout/recast');
+const recast = require('@putout/recast');
+const putoutPrinter = require('@putout/printer');
 const generate = require('@babel/generator').default;
-const tryCatch = require('try-catch');
 
-const parse = require('./parse');
 const {stringify} = JSON;
+const {isArray} = Array;
+
+const maybeArray = (a) => isArray(a) ? a : [a, {}];
 const btoa = (a) => Buffer.from(a, 'binary').toString('base64');
-const {assign} = Object;
+
 const addSourceMap = (sourceMapName, {code, map}) => !sourceMapName ? code : `${code}\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,${btoa(stringify(map))}\n`;
 const fixStrictMode = (a) => a.replace(`\n\n\n'use strict'`, `\n\n'use strict'`);
 
 module.exports = (ast, options = {}) => {
-    const {
-        recast = true,
-        sourceMapName,
-    } = options;
+    const {sourceMapName} = options;
     
-    const printOptions = {
-        quote: 'single',
-        objectCurlySpacing: false,
-        wrapColumn: Infinity,
-        ...options,
-    };
-    const printed = print(ast, printOptions);
+    const [printer = 'recast', printerOptions] = maybeArray(options.printer);
     
-    if (!recast || !canParse(printed.code))
-        assign(printed, {
-            code: babelPrint(ast),
+    if (printer === 'recast') {
+        const printOptions = {
+            quote: 'single',
+            objectCurlySpacing: false,
+            wrapColumn: Infinity,
+            ...options,
+        };
+        
+        const printed = recast.print(ast, printOptions);
+        const {map} = printed;
+        const code = fixStrictMode(printed.code);
+        
+        return addSourceMap(sourceMapName, {
+            code,
+            map,
         });
+    }
     
-    const {map} = printed;
-    const code = fixStrictMode(printed.code);
+    if (printer === 'babel')
+        return babelPrint(ast);
     
-    return addSourceMap(sourceMapName, {
-        code,
-        map,
-    });
+    return putoutPrinter.print(ast, printerOptions);
 };
 
-function canParse(source) {
-    const [error] = tryCatch(parse, source, {
-        isTS: true,
-    });
-    
-    return !error;
-}
-
 function babelPrint(ast) {
     const {code} = generate(ast, {
         indent: {

package/lib/second-chance.js

@@ -15,4 +15,3 @@ module.exports = (fn, source, a, b) => {
     
     throw errorA;
 };
-

package/lib/template.js

@@ -2,7 +2,6 @@
 
 const template = require('@babel/template').default;
 const memo = require('nano-memoize');
-
 const plugins = require('./parsers/babel/plugins');
 const options = require('./parsers/babel/options');
 
@@ -59,4 +58,3 @@ module.exports.ast.fresh = (value, options) => {
     
     return result.expression || result;
 };
-

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@putout/engine-parser",
-  "version": "5.6.0",
+  "version": "6.1.0",
   "type": "commonjs",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "🐊Putout parser",
   "homepage": "https://github.com/coderaiser/putout/tree/master/packages/engine-parser#readme",
   "main": "./lib/parser.js",
-  "commitType": "colon",
   "release": false,
   "tag": false,
   "changelog": false,
@@ -38,6 +37,7 @@
     "@babel/parser": "^7.19.0",
     "@babel/template": "^7.18.10",
     "@babel/types": "^7.19.0",
+    "@putout/printer": "^1.20.0",
     "@putout/recast": "^1.12.1",
     "estree-to-babel": "^5.0.0",
     "nano-memoize": "^2.0.0",
@@ -55,7 +55,7 @@
     "c8": "^7.5.0",
     "eslint": "^8.0.1",
     "eslint-plugin-n": "^15.2.4",
-    "eslint-plugin-putout": "^16.0.0",
+    "eslint-plugin-putout": "^17.0.0",
     "espree": "^9.0.0",
     "esprima": "^4.0.1",
     "hermes-parser": "^0.9.0",