@putout/printer 15.16.0 → 15.18.0

package/ChangeLog

@@ -1,3 +1,13 @@
+2025.08.04, v15.18.0
+
+feature:
+- 3357c63 @putout/printer: AssignmentExpression: leadingComments: CommentBlock
+
+2025.08.04, v15.17.0
+
+feature:
+- da01c40 @putout/printer: AssignmentExpression: inside ReturnStatement with leadingComments (coderaiser/putout#235)
+
 2025.08.01, v15.16.0
 
 feature:

package/lib/tokenize/expressions/assignment-expression/assignment-expression-comments.js

@@ -0,0 +1,37 @@
+'use strict';
+
+const {types} = require('@putout/babel');
+const {hasLeadingComment} = require('#is');
+const {isReturnStatement} = types;
+
+module.exports.printLeadingCommentLine = ({parentPath}) => !isReturnStatement(parentPath);
+
+module.exports.maybeInsideReturnWithCommentStart = (path, {print, indent}) => {
+    const {parentPath} = path;
+    
+    if (isReturnStatement(parentPath) && hasLeadingComment(path)) {
+        indent.inc();
+        const {leadingComments} = path.node;
+        
+        print.breakline();
+        for (const {type, value} of leadingComments) {
+            if (type === 'CommentLine')
+                print(`//${value}`);
+            else
+                print(`/*${value}*/`);
+            
+            print.breakline();
+        }
+    }
+};
+
+module.exports.maybeInsideReturnWithCommentEnd = (path, {print, indent}) => {
+    const {parentPath} = path;
+    
+    if (!isReturnStatement(parentPath) || !hasLeadingComment(path))
+        return;
+    
+    indent.dec();
+    print.breakline();
+};
+

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

@@ -1,11 +1,18 @@
 'use strict';
 
 const {types} = require('@putout/babel');
+
 const {
     maybePrintLeftBrace,
     maybePrintRightBrace,
 } = require('./maybe-write-brace');
 
+const {
+    printLeadingCommentLine,
+    maybeInsideReturnWithCommentEnd,
+    maybeInsideReturnWithCommentStart,
+} = require('./assignment-expression-comments');
+
 const {
     isExpressionStatement,
     isAssignmentExpression,
@@ -18,6 +25,8 @@ module.exports.AssignmentExpression = (path, printer, semantics) => {
     const {operator} = path.node;
     
     maybePrintLeftBrace(path, printer, semantics);
+    maybeInsideReturnWithCommentStart(path, printer);
+    
     print('__left');
     print.space();
     print(operator);
@@ -34,9 +43,13 @@ module.exports.AssignmentExpression = (path, printer, semantics) => {
         print.breakline();
     }
     
+    maybeInsideReturnWithCommentEnd(path, printer);
+    
     maybePrintRightBrace(path, printer, semantics);
 };
 
+module.exports.AssignmentExpression.printLeadingCommentLine = printLeadingCommentLine;
+
 function isMultiline(path) {
     const {right} = path.node;
     

package/lib/tokenize/expressions/assignment-expression/maybe-write-brace.js

@@ -1,5 +1,6 @@
 'use strict';
 
+const {hasLeadingComment} = require('#is');
 const {isParens} = require('../../maybe/maybe-parens');
 
 module.exports.maybePrintLeftBrace = (path, printer, semantics) => {
@@ -40,7 +41,7 @@ function maybeWriteBrace(path, printer, semantics, {brace}) {
         return;
     }
     
-    if (!roundBraces.assign)
+    if (!roundBraces.assign && !hasLeadingComment(path))
         return;
     
     if (!isParens(path))

package/package.json

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