fix(formatter): correct printing comments for the end of union type (#14498)

Author: Dunqing

crates/oxc_formatter/src/write/union_type.rs

@@ -130,7 +130,7 @@ pub struct FormatTSType<'a, 'b> {
 }
 
 impl<'a> Format<'a> for FormatTSType<'a, '_> {
-    fn fmt(&self, f: &mut crate::formatter::Formatter<'_, 'a>) -> FormatResult<()> {
+    fn fmt(&self, f: &mut Formatter<'_, 'a>) -> FormatResult<()> {
         let format_element = format_once(|f| {
             self.element.fmt(f)?;
             Ok(())
@@ -158,7 +158,7 @@ impl<'a> Format<'a> for FormatTSType<'a, '_> {
             // // comment
             // | B
             // ```
-            // If there is a leading own line comment between `|` and the next node, we need to put print comments
+            // If there is a leading own line comment between `|` and the next node, we need to put printing comments
             // before `|` instead of after it.
             if f.comments().has_leading_own_line_comment(next_node_span.start) {
                 let comments = f.context().comments().comments_before(next_node_span.start);
@@ -171,7 +171,9 @@ impl<'a> Format<'a> for FormatTSType<'a, '_> {
                 write!(f, [soft_line_break_or_space()])?;
             }
             write!(f, ["|"])
-        } else {
+        } else if let AstNodes::TSUnionType(parent) = self.element.parent
+            && parent.needs_parentheses(f)
+        {
             // ```ts
             // type Foo = (
             // | "thing1" // comment1
@@ -183,6 +185,8 @@ impl<'a> Format<'a> for FormatTSType<'a, '_> {
             let comments =
                 f.context().comments().end_of_line_comments_after(self.element.span().end);
             FormatTrailingComments::Comments(comments).fmt(f)
+        } else {
+            Ok(())
         }
     }
 }

crates/oxc_formatter/tests/fixtures/ts/comments/union.ts

@@ -0,0 +1,3 @@
+interface _KeywordDef {
+  type?: JSONType | JSONType[] // data types that keyword applies to
+}

crates/oxc_formatter/tests/fixtures/ts/comments/union.ts.snap

@@ -0,0 +1,14 @@
+---
+source: crates/oxc_formatter/tests/fixtures/mod.rs
+---
+==================== Input ====================
+interface _KeywordDef {
+  type?: JSONType | JSONType[] // data types that keyword applies to
+}
+
+==================== Output ====================
+interface _KeywordDef {
+  type?: JSONType | JSONType[]; // data types that keyword applies to
+}
+
+===================== End =====================