@putout/printer 12.28.0 → 12.30.0

package/ChangeLog

@@ -1,3 +1,13 @@
+2025.02.09, v12.30.0
+
+feature:
+- a47b560 @putout/printer: introduce Comments Printer so each node can handle printing comments
+
+2025.02.09, v12.29.0
+
+feature:
+- 6d8a215 @putout/printer: ParenthesizedExpression: add
+
 2025.02.08, v12.28.0
 
 feature:

package/lib/tokenize/comment/comments-printer/comments-printer.js

@@ -0,0 +1,19 @@
+'use strict';
+
+const createPrintComment = (fn, value) => () => fn(`//${value}`);
+
+module.exports.hasCommentsPrinter = (currentTraverse) => currentTraverse.printLeadingCommentLine;
+
+module.exports.printComments = (path, printer, semantics, {currentTraverse}) => {
+    const {print} = printer;
+    const {leadingComments} = path.node;
+    const {printLeadingCommentLine} = currentTraverse;
+    
+    for (const [index, {type, value}] of leadingComments.entries()) {
+        if (type === 'CommentLine')
+            printLeadingCommentLine(path, printer, semantics, {
+                index,
+                printComment: createPrintComment(print, value),
+            });
+    }
+};

package/lib/tokenize/comment/parse-leading-comments.js

@@ -10,6 +10,11 @@ const {
 const {markBefore} = require('../mark');
 const {maybeInsideFn} = require('./maybe-inside-fn');
 
+const {
+    hasCommentsPrinter,
+    printComments,
+} = require('./comments-printer/comments-printer');
+
 const {
     isArrowFunctionExpression,
     isObjectProperty,
@@ -47,9 +52,6 @@ const hasDecoratorsWithComments = (path) => {
     if (isDecorator(path))
         return false;
     
-    if (path.node.decorators)
-        return true;
-    
     return path?.parentPath.node?.decorators;
 };
 
@@ -90,7 +92,13 @@ const isFirst = (path) => {
     return false;
 };
 
-module.exports.parseLeadingComments = (path, {print, maybe, indent}, semantics) => {
+module.exports.parseLeadingComments = (path, printer, semantics, {currentTraverse = {}} = {}) => {
+    const {
+        print,
+        maybe,
+        indent,
+    } = printer;
+    
     if (!semantics.comments)
         return;
     
@@ -99,6 +107,11 @@ module.exports.parseLeadingComments = (path, {print, maybe, indent}, semantics)
     if (!leadingComments?.length)
         return;
     
+    if (hasCommentsPrinter(currentTraverse))
+        return printComments(path, printer, semantics, {
+            currentTraverse,
+        });
+    
     if (hasDecoratorsWithComments(path))
         return;
     

package/lib/tokenize/expressions/index.js

@@ -42,6 +42,7 @@ const {StaticBlock} = require('./class/static-block');
 const {RecordExpression} = require('./object-expression/record-expression');
 const {TupleExpression} = require('./array-expression/tuple-expression');
 const {ImportExpression} = require('./import-expression');
+const {ParenthesizedExpression} = require('./parenthesized-expression/parenthesized-expression');
 
 module.exports = {
     ...functions,
@@ -65,6 +66,7 @@ module.exports = {
     ObjectExpression,
     ObjectProperty,
     ObjectPattern,
+    ParenthesizedExpression,
     PrivateName,
     RestElement,
     ImportExpression,

package/lib/tokenize/expressions/parenthesized-expression/parenthesized-expression.js

@@ -0,0 +1,22 @@
+'use strict';
+
+const {types} = require('@putout/babel');
+const {isJSXElement} = types;
+
+const condition = (path) => {
+    const {expression} = path.node;
+    return !isJSXElement(expression);
+};
+
+module.exports.ParenthesizedExpression = {
+    before(path, {print}) {
+        print('(');
+    },
+    condition,
+    print(path, {print}) {
+        print('__expression');
+    },
+    after(path, {print}) {
+        print(')');
+    },
+};

package/lib/tokenize/jsx/jsx-element.js

@@ -48,6 +48,9 @@ function condition(path) {
     if (path.parentPath.isReturnStatement())
         return true;
     
+    if (path.parentPath.isParenthesizedExpression())
+        return true;
+    
     if (path.node.extra?.parenthesized)
         return true;
     

package/lib/tokenize/tokenize.js

@@ -219,7 +219,10 @@ module.exports.tokenize = (ast, overrides) => {
         maybeThrow(!currentTraverse, path, `☝️ Node type '{{ type }}' is not supported yet by @putout/printer: '{{ path }}'`);
         
         const currentIndent = i;
-        parseLeadingComments(path, printer, semantics);
+        parseLeadingComments(path, printer, semantics, {
+            currentTraverse,
+        });
+        
         // this is main thing
         maybeVisitor(currentTraverse, path, printer, semantics);
         parseTrailingComments(path, printer, semantics);

package/lib/tokenize/typescript/ts-parameter-property/ts-parameter-property.js

@@ -40,5 +40,19 @@ module.exports.TSParameterProperty = (path, {print, maybe, indent}) => {
     }
     
     print('__parameter');
-    maybe.print.breakline(decoratorsLength);
+    
+    if (hasLeadingComment(path) && !path.node.decorators)
+        print.breakline();
+};
+module.exports.TSParameterProperty.printLeadingCommentLine = (path, printer, semantics, {printComment}) => {
+    const {indent, print} = printer;
+    
+    if (path.parentPath.isClassMethod() && !path.node.decorators) {
+        indent.inc();
+        print.breakline();
+        
+        printComment();
+        print.breakline();
+        indent.dec();
+    }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@putout/printer",
-  "version": "12.28.0",
+  "version": "12.30.0",
   "type": "commonjs",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "Simplest possible opinionated Babel AST printer for 🐊Putout",