@putout/engine-parser 4.9.1 → 4.10.0

package/README.md

@@ -3,7 +3,7 @@
 [NPMIMGURL]: https://img.shields.io/npm/v/@putout/engine-parser.svg?style=flat&longCache=true
 [NPMURL]: https://npmjs.org/package/@putout/engine-parser"npm"
 
-`putout` engine that parses input.
+🐊[`Putout`](https://github.com/coderaiser/putout) engine that parses input.
 
 ## Install
 
@@ -43,6 +43,46 @@ create node using `memoization`.
 
 create node without `memoization`.
 
+### Sourcemaps
+
+You have two ways to benefit from source map generation:
+
+- using `Recast` print;
+- using `Babel` generator;
+
+#### Generate sourcemaps usign Recast
+
+```js
+const source = `const hello = 'world';`;
+const ast = parse(source, {
+    sourceFileName: 'hello.js',
+});
+print(ast, {sourceMapName: 'hello.map'});
+// returns
+`const hello = 'world';
+{"version":3,"sources":["hello.js"],"names":[],"mappings":"AAAA...","file":"hello.map","sourcesContent":["const hello = 'world';"]}`;
+```
+
+#### Generate sourcemaps usign Bebel
+
+To generate sourcemap usig babel generator, you should use babel parser before.
+This is low level transformation, because `Babel` doesn't preserve any formatting.
+
+```js
+const {generate} = require('@putout/engine-parser');
+const babel = require('@putout/engine-parser/babel');
+
+const ast = babel.parse(source, {
+    sourceFilename: 'hello.js',
+});
+
+generate(ast, {sourceMaps: true}, {
+    'hello.js': source,
+});
+// returns
+({code, map});
+```
+
 ## Example
 
 ```js

package/lib/generate.js

@@ -2,10 +2,11 @@
 
 const generate = require('@babel/generator').default;
 
-module.exports = (node) => {
+module.exports = (node, options, sourceMaps) => {
     return generate(node, {
         comments: false,
         recordAndTupleSyntaxType: 'hash',
-    });
+        ...options,
+    }, sourceMaps);
 };
 

package/lib/parse.js

@@ -13,14 +13,17 @@ function parse(source, options) {
         isTS,
         isFlow,
         isJSX,
+        sourceFileName,
     } = options || {};
     
     const ast = recast.parse(source, {
+        sourceFileName,
         parser: getParser({
             parser,
             isTS,
             isFlow,
             isJSX,
+            sourceFileName,
         }),
     });
     

package/lib/parsers/babel/index.js

@@ -18,12 +18,16 @@ const options = require('./options');
 
 const moveOutDirectives = require('./move-out-directives');
 
-module.exports.parse = function babelParse(source, {isTS, isJSX = true, isFlow = getFlow(source)}) {
+// There is a difference in options naming for babel and recast
+// recast -> sourceFileName
+// babel, putout: sourceFilename
+module.exports.parse = function babelParse(source, {sourceFilename, isTS, isJSX = true, isFlow = getFlow(source)}) {
     const {parse} = initBabel();
     
     const ast = parse(source, {
         sourceType: 'module',
         tokens: true,
+        sourceFilename,
         ...options,
         plugins: clean([
             ...plugins,

package/lib/print.js

@@ -3,17 +3,26 @@
 const {print} = require('@putout/recast');
 
 const fixStrictMode = (a) => a.replace(`\n\n\n'use strict'`, `\n\n'use strict'`);
+const addSourceMap = (sourceMapName, {code, map}) => !sourceMapName ? code : `${code}\n//${stringify(map)}\n`;
 
-module.exports = (ast) => {
+const {stringify} = JSON;
+
+module.exports = (ast, options = {}) => {
+    const {sourceMapName} = options;
     const printOptions = {
         quote: 'single',
         objectCurlySpacing: false,
         wrapColumn: Infinity,
+        ...options,
     };
     
-    const printed = print(ast, printOptions).code;
-    const code = fixStrictMode(printed);
+    const printed = print(ast, printOptions);
+    const {map} = printed;
+    const code = fixStrictMode(printed.code);
     
-    return code;
+    return addSourceMap(sourceMapName, {
+        code,
+        map,
+    });
 };
 

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@putout/engine-parser",
-  "version": "4.9.1",
+  "version": "4.10.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",
+  "homepage": "https://github.com/coderaiser/putout/tree/master/packages/engine-parser#readme",
   "main": "./lib/parser.js",
   "release": false,
   "tag": false,