chore: fix javadocs issues

Author: dieppa

src/main/java/io/flamingock/template/sql/util/SqlSplitterFactory.java

@@ -66,6 +66,9 @@ public class SqlSplitterFactory {
     /**
      * Registers a custom splitter for a given dialect, overriding the built-in one.
      * Useful for extending support to new dialects without modifying this factory.
+     *
+     * @param dialect the SQL dialect to register
+     * @param supplier the supplier that creates the splitter instance
      */
     public static void registerSplitter(SqlDialect dialect, Supplier<SqlSplitter> supplier) {
         customSplitters.put(dialect, supplier);
@@ -74,6 +77,8 @@ public static void registerSplitter(SqlDialect dialect, Supplier<SqlSplitter> su
     /**
      * Removes a previously registered custom splitter for the given dialect,
      * restoring the built-in behaviour. Intended for use in tests.
+     *
+     * @param dialect the SQL dialect to deregister
      */
     public static void deregisterSplitter(SqlDialect dialect) {
         customSplitters.remove(dialect);

src/main/java/io/flamingock/template/sql/util/SqlStatement.java

@@ -51,7 +51,7 @@ public SqlStatement(String sql) {
      * Creates a SQL statement with specified repeat count.
      *
      * @param sql the SQL statement text
-     * @param repeatCount number of times to execute (must be >= 1)
+     * @param repeatCount number of times to execute (must be >= 1)
      * @throws IllegalArgumentException if repeatCount is less than 1
      */
     public SqlStatement(String sql, int repeatCount) {
@@ -75,7 +75,7 @@ public String getSql() {
      * Returns the number of times this statement should be executed.
      * Default is 1 for normal statements.
      *
-     * @return the repeat count (>= 1)
+     * @return the repeat count (>= 1)
      */
     public int getRepeatCount() {
         return repeatCount;

src/main/java/io/flamingock/template/sql/util/splitter/AbstractSqlSplitter.java

@@ -109,7 +109,7 @@ protected boolean supportsEStrings() {
     /**
      * Override to enable hash (#) line comments (MySQL/MariaDB-style).
      * When false (default), '#' is treated as a regular character.
-     * When true, '#' (not followed by '>') starts a line comment.
+     * When true, '#' (not followed by '>') starts a line comment.
      * @return true if hash should be treated as a line comment starter
      */
     protected boolean supportsHashComments() {
@@ -169,6 +169,8 @@ protected String checkAdditionalDelimiter(String remaining, ParserState state) {
      * implicit reference to the enclosing {@code AbstractSqlSplitter} instance to invoke
      * those methods. Handlers with no such dependency are declared {@code static} to avoid
      * the unnecessary enclosing reference. This is an intentional design choice.
+     *
+     * @return ordered list of character handlers
      */
     protected List<CharacterHandler> buildHandlers() {
         List<CharacterHandler> handlers = new ArrayList<>();
@@ -323,6 +325,12 @@ protected KeywordHandlingResult handleDialectKeywords(String sql, int index, Par
     /**
      * Generic keyword handling for BEGIN, CASE, END.
      * Subclasses should call this for standard keyword processing.
+     *
+     * @param sql the full SQL string being parsed
+     * @param index the current position in the SQL string
+     * @param state the current parser state
+     * @param output the output buffer for the current statement
+     * @return the updated index after processing
      */
     protected int handleGenericKeywords(String sql, int index, ParserState state, StringBuilder output) {
         String remaining = sql.substring(index).toUpperCase();
@@ -557,7 +565,7 @@ public int handle(String sql, int index, ParserState state, StringBuilder output
 
     /**
      * Handles line comments: -- and #
-     * Respects JSON operators like #>, #>>, ->, and ->> (not treated as comments).
+     * Respects JSON operators like {@code #>}, {@code #>>}, {@code ->}, and {@code ->>} (not treated as comments).
      */
     protected class LineCommentHandler implements CharacterHandler {
         @Override