Refactor trailing comma comment adjustment (#10380)

* Refactor trailing comment adjustment

Following up from https://github.com/babel/babel/pull/10369

- Unify the logic for adjusting trailing comments into a separate
  function
- Use it for all three cases, which fixes a bug for ObjectExpressions
  and CallExpressions
- Update tests to check for the fixed bug

* Fix tests

- Only modify trailingComments if necessary
- Update snapshots of a couple of affected tests

* Drop the underscore in adjustCommentsAfterTrailingComma_

* Handle ArrayPattern

* Handle ObjectPattern

* Handle import and export declarations

These have to be handled a bit differently, because the  node is visited after the  and before the declaration. So we intercept when we are going from the last specifier to the source node.

* Remove unnecessary check

packages/babel-parser/test/fixtures/comments/basic/function-trailing-comma/input.js

@@ -1 +1 @@
-fn(a, b, /* comment */);
+fn(a, b, /* comment 1 */) /* comment 2*/;

packages/babel-parser/test/fixtures/comments/basic/function-trailing-comma/output.json

@@ -1,7 +1,7 @@
 {
   "type": "File",
   "start": 0,
-  "end": 24,
+  "end": 41,
   "loc": {
     "start": {
       "line": 1,
@@ -9,13 +9,13 @@
     },
     "end": {
       "line": 1,
-      "column": 24
+      "column": 41
     }
   },
   "program": {
     "type": "Program",
     "start": 0,
-    "end": 24,
+    "end": 41,
     "loc": {
       "start": {
         "line": 1,
@@ -23,7 +23,7 @@
       },
       "end": {
         "line": 1,
-        "column": 24
+        "column": 41
       }
     },
     "sourceType": "script",
@@ -32,7 +32,7 @@
       {
         "type": "ExpressionStatement",
         "start": 0,
-        "end": 24,
+        "end": 41,
         "loc": {
           "start": {
             "line": 1,
@@ -40,13 +40,13 @@
           },
           "end": {
             "line": 1,
-            "column": 24
+            "column": 41
           }
         },
         "expression": {
           "type": "CallExpression",
           "start": 0,
-          "end": 23,
+          "end": 25,
           "loc": {
             "start": {
               "line": 1,
@@ -54,7 +54,7 @@
             },
             "end": {
               "line": 1,
-              "column": 23
+              "column": 25
             }
           },
           "callee": {
@@ -111,9 +111,9 @@
               "trailingComments": [
                 {
                   "type": "CommentBlock",
-                  "value": " comment ",
+                  "value": " comment 1 ",
                   "start": 9,
-                  "end": 22,
+                  "end": 24,
                   "loc": {
                     "start": {
                       "line": 1,
@@ -121,12 +121,30 @@
                     },
                     "end": {
                       "line": 1,
-                      "column": 22
+                      "column": 24
                     }
                   }
                 }
               ]
             }
+          ],
+          "trailingComments": [
+            {
+              "type": "CommentBlock",
+              "value": " comment 2",
+              "start": 26,
+              "end": 40,
+              "loc": {
+                "start": {
+                  "line": 1,
+                  "column": 26
+                },
+                "end": {
+                  "line": 1,
+                  "column": 40
+                }
+              }
+            }
           ]
         }
       }
@@ -136,9 +154,9 @@
   "comments": [
     {
       "type": "CommentBlock",
-      "value": " comment ",
+      "value": " comment 1 ",
       "start": 9,
-      "end": 22,
+      "end": 24,
       "loc": {
         "start": {
           "line": 1,
@@ -146,7 +164,23 @@
         },
         "end": {
           "line": 1,
-          "column": 22
+          "column": 24
+        }
+      }
+    },
+    {
+      "type": "CommentBlock",
+      "value": " comment 2",
+      "start": 26,
+      "end": 40,
+      "loc": {
+        "start": {
+          "line": 1,
+          "column": 26
+        },
+        "end": {
+          "line": 1,
+          "column": 40
         }
       }
     }