skip markdown doc comments for java <23

Author: Lulu13022002

src/main/java/io/papermc/typewriter/context/SourcesMetadata.java

@@ -1,5 +1,6 @@
 package io.papermc.typewriter.context;
 
+import com.google.common.base.Preconditions;
 import org.checkerframework.checker.nullness.qual.NonNull;
 import org.checkerframework.framework.qual.DefaultQualifier;
 import org.jetbrains.annotations.Contract;
@@ -14,9 +15,11 @@
  *
  * @param importLayout the import layout used
  * @param indentUnit the default indent unit used if no one is found in the source file
+ * @param classpath the targeted classpath to resolve class reference during import parsing
+ * @param javaVersion the version of java the generated code must be compliant to
  */
 @DefaultQualifier(NonNull.class)
-public record SourcesMetadata(ImportLayout importLayout, IndentUnit indentUnit, Set<Path> classpath) {
+public record SourcesMetadata(ImportLayout importLayout, IndentUnit indentUnit, Set<Path> classpath, int javaVersion) {
 
     /**
      * Constructs a file metadata with the default import layout and
@@ -33,11 +36,16 @@ public static SourcesMetadata of(IndentUnit indentUnit) {
         return of(indentUnit, UnaryOperator.identity());
     }
 
+    public boolean canSkipMarkdownDocComments() {
+        return Boolean.getBoolean("typewriter.lexer.ignoreMarkdownDocComments") || this.javaVersion < 23;
+    }
+
     public static class Builder {
 
         private final IndentUnit indentUnit;
         private ImportLayout layout = ImportLayout.DEFAULT;
         private Set<Path> classpath = Collections.emptySet();
+        private int javaVersion = Runtime.version().feature();
 
         Builder(IndentUnit indentUnit) {
             this.indentUnit = indentUnit;
@@ -55,11 +63,19 @@ public Builder classpath(Set<Path> classpath) {
             return this;
         }
 
+        @Contract(value = "_ -> this", mutates = "this")
+        public Builder javaVersion(int featureVersion) {
+            Preconditions.checkArgument(featureVersion >= 0, "Feature version must be non-negative");
+            this.javaVersion = featureVersion;
+            return this;
+        }
+
         SourcesMetadata complete() {
             return new SourcesMetadata(
                 this.layout,
                 this.indentUnit,
-                this.classpath
+                this.classpath,
+                this.javaVersion
             );
         }
     }

src/main/java/io/papermc/typewriter/parser/Lexer.java

@@ -22,12 +22,13 @@
 
 public class Lexer extends UnicodeTranslator implements Tokenizer {
 
-    private static final boolean CHECK_MARKDOWN_DOC_COMMENTS = !Boolean.getBoolean("typewriter.lexer.ignoreMarkdownDocComments");
-
     private final StringBuilder buffer; // generic buffer for single line element or used as temporary storage before being pushed into line buffer
     private final List<String> lineBuffer; // line buffer for multi line block
     private RelativeTextBlock textBlock; // text block support
 
+    // toggleable features
+    public boolean checkMarkdownDocComments = true;
+
     public Lexer(char[] input) {
         super(input);
         this.buffer = new StringBuilder();
@@ -448,7 +449,7 @@ public Token readToken() {
                     tokenPos.begin();
                     this.incrCursor();
                     if (match('/')) {
-                        if (CHECK_MARKDOWN_DOC_COMMENTS && match('/')) {
+                        if (this.checkMarkdownDocComments && match('/')) {
                             type = TokenType.MARKDOWN_JAVADOC;
                             this.readMarkdownJavadoc(tokenPos);
                         } else {

src/main/java/io/papermc/typewriter/replace/SearchReplaceRewriterBase.java

@@ -52,6 +52,7 @@ public void writeToFile(Path parent, SourcesMetadata sourcesMetadata, ClassResol
             final Lexer lex;
             try (BufferedReader buffer = Files.newBufferedReader(path, StandardCharsets.UTF_8)) {
                 lex = Lexer.fromReader(buffer);
+                lex.checkMarkdownDocComments = !sourcesMetadata.canSkipMarkdownDocComments();
             } catch (ReaderException ex) {
                 throw ex.withAdditionalContext(file);
             }