revert(parser): remove RParen from trailing comment exclusion and add documentation

Co-authored-by: sapphi-red <[email protected]>

Author: Copilot

crates/oxc_codegen/tests/integration/comments.rs

@@ -187,7 +187,10 @@ catch (err) /* v8 ignore next */ { console.error(err); }",
             // Multiple comments between catch param and body
             "try { something(); }
 catch (err) /* c8 ignore next */ /* istanbul ignore next */ { handle(err); }",
-            // Line comment between catch param and body
+            // Line comment between catch param and body.
+            // NOTE: Line comments after `)` are classified as trailing comments by the parser,
+            // so they are not preserved. Use block comments instead.
+            // See: https://github.com/oxc-project/oxc/pull/16167#discussion_r2567604139
             "try { something(); }
 catch (err) // v8 ignore next
 { handle(err); }",

crates/oxc_codegen/tests/integration/snapshots/coverage.snap

@@ -137,8 +137,7 @@ catch (err) // v8 ignore next
 ----------
 try {
 	something();
-} catch (err) // v8 ignore next
-{
+} catch (err) {
 	handle(err);
 }
 

crates/oxc_parser/src/lexer/trivia_builder.rs

@@ -115,12 +115,9 @@ impl TriviaBuilder {
     /// function foo( // This should not be treated as trailing (follows `(`)
     ///     param
     /// ) {}
-    ///
-    /// catch (err) // This should not be treated as trailing (follows `)`)
-    /// { ... }
     /// ```
     fn should_be_treated_as_trailing_comment(&self) -> bool {
-        !self.saw_newline && !matches!(self.previous_kind, Kind::Eq | Kind::LParen | Kind::RParen)
+        !self.saw_newline && !matches!(self.previous_kind, Kind::Eq | Kind::LParen)
     }
 
     fn add_comment(&mut self, mut comment: Comment, source_text: &str) {