Add an option to stop treating blank lines as a statement separator

Three consecutive newlines end a statement, like `;`. Add
Feature.allowBlankLinesAsStatementSeparator (enabled by default) and
withBlankLinesAsSeparator(boolean) so callers can parse blank lines as
plain whitespace instead. Default behaviour is unchanged.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Author: edeadington

src/main/java/net/sf/jsqlparser/parser/AbstractJSqlParser.java

@@ -194,6 +194,11 @@ public P withHashLineComments(boolean allowHashLineComments) {
         return withFeature(Feature.allowHashLineComments, allowHashLineComments);
     }
 
+    public P withBlankLinesAsSeparator(boolean allowBlankLinesAsStatementSeparator) {
+        return withFeature(Feature.allowBlankLinesAsStatementSeparator,
+                allowBlankLinesAsStatementSeparator);
+    }
+
     public P withUnparenthesizedSubSelects() {
         return withFeature(Feature.allowUnparenthesizedSubSelects, true);
     }

src/main/java/net/sf/jsqlparser/parser/SimpleCharStream.java

@@ -208,6 +208,14 @@ public final char BeginToken() throws java.io.IOException {
                 && AbstractJSqlParser.Dialect.MYSQL.name()
                         .equals(featureConfiguration.getValue(Feature.dialect))) {
             c = mySqlCommentBoundary(c);
+        } else if (c == '\n' && featureConfiguration != null
+                && !featureConfiguration
+                        .getAsBoolean(Feature.allowBlankLinesAsStatementSeparator)
+                && peekCharacters(2).equals("\n\n")) {
+            // Blanking the first newline of the run stops ST_SEMICOLON matching "\n\n\n";
+            // line and column tracking was already updated when the newline was read.
+            buffer[bufpos] = ' ';
+            c = ' ';
         }
         return c;
     }

src/main/java/net/sf/jsqlparser/parser/feature/Feature.java

@@ -889,6 +889,13 @@ public enum Feature {
      */
     allowHashLineComments(false),
 
+    /**
+     * treats three consecutive newlines as a statement separator, like `;`; enabled by default.
+     * When disabled, blank lines are plain whitespace, so a statement containing them is parsed
+     * whole instead of being cut off at the first run of blank lines
+     */
+    allowBlankLinesAsStatementSeparator(true),
+
     /**
      * allows sub selects without parentheses, e.g. `select * from dual where 1 = select 1`
      */

src/test/java/net/sf/jsqlparser/parser/CCJSqlParserUtilTest.java

@@ -41,6 +41,7 @@
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.TimeoutException;
 import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.function.Consumer;
 
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 import static org.junit.jupiter.api.Assertions.assertEquals;
@@ -578,6 +579,44 @@ void testSingleStatementWithEmptyLines() throws JSQLParserException {
                 + "where id=?", true);
     }
 
+    @Test
+    void testBlankLinesAsSeparatorDisabled() throws JSQLParserException {
+        Consumer<CCJSqlParser> blankLinesAsWhitespace = p -> p.withBlankLinesAsSeparator(false);
+
+        assertEquals("SELECT a FROM dual WHERE x = ? AND y = ?",
+                CCJSqlParserUtil.parse("SELECT a FROM dual WHERE x = ?\n\n\n AND y = ?",
+                        blankLinesAsWhitespace).toString());
+        assertEquals("SELECT a, b FROM t",
+                CCJSqlParserUtil.parse("SELECT a,\n\n\n\nb FROM t", blankLinesAsWhitespace)
+                        .toString());
+        assertEquals("SELECT a FROM t WHERE a > 1",
+                CCJSqlParserUtil.parse("SELECT a FROM t\n\n\nWHERE a > 1", blankLinesAsWhitespace)
+                        .toString());
+        assertEquals("SELECT a FROM t UNION SELECT a FROM u",
+                CCJSqlParserUtil.parse("SELECT a FROM t\n\n\n\n\nUNION\n\n\nSELECT a FROM u",
+                        blankLinesAsWhitespace).toString());
+        assertEquals("SELECT a FROM t JOIN u ON t.id = u.id",
+                CCJSqlParserUtil.parse("SELECT a FROM t\n\n\nJOIN u ON t.id = u.id",
+                        blankLinesAsWhitespace).toString());
+        assertEquals("SELECT a FROM dual",
+                CCJSqlParserUtil.parse("SELECT a FROM dual\n\n\n", blankLinesAsWhitespace)
+                        .toString());
+        assertEquals("SELECT 'a\n\n\nb' FROM dual",
+                CCJSqlParserUtil.parse("SELECT 'a\n\n\nb' FROM dual", blankLinesAsWhitespace)
+                        .toString());
+
+        assertEquals(1, CCJSqlParserUtil.parseStatements(
+                "SELECT a FROM t\n\n\nWHERE a > 1", blankLinesAsWhitespace).size());
+        assertEquals(3, CCJSqlParserUtil.parseStatements(
+                "SELECT 1 FROM dual;\n\n\nSELECT 2 FROM dual\ngo\nSELECT 3 FROM dual\n/\n",
+                blankLinesAsWhitespace).size());
+
+        JSQLParserException exception = assertThrows(JSQLParserException.class,
+                () -> CCJSqlParserUtil.parse("SELECT a\n\n\n\nFROM", blankLinesAsWhitespace));
+        assertTrue(exception.getCause().getMessage().contains("at line 5, column 1"),
+                exception.getCause().getMessage());
+    }
+
     @Test
     public void testHashLineCommentsFeature() throws Exception {
         // with the flag: MySQL line comments, `#` to end of line,