Fix SQL formatting for multiple CASE expressions support

[xterao]

Description

This PR addresses issue #353 by improving SQL formatting behavior for multiple CASE expressions and enhancing overall SQL formatting consistency.

Related Issues

Fixes #353

Changes

1. Enhanced spacing rules within field blocks - Improved the implementation of spacing rules to ensure consistent formatting within SQL field blocks
2. Improved line-breaking and indentation behavior - Enhanced line-breaking logic and indentation to provide better readability for complex SQL statements
3. Added parent-child relationship validation - Implemented a method to validate parent-child relationships to determine appropriate
   line-breaking behavior
4. Block comment handling - Ensured that line breaks are always inserted before block comments for better code organization
5. Refactored block relationship management - Changed the class responsible for setting block parent-child relationships to a builder pattern for better maintainability

[Copilot]

Pull Request Overview

This PR enhances SQL formatting behavior to improve support for multiple CASE expressions and overall SQL formatting consistency. The changes focus on upgrading the formatter's handling of spacing, line-breaking, indentation, and block relationships.

• Improved SQL formatting for multiple CASE expressions and various SQL directive patterns
• Enhanced block relationship management using a builder pattern
• Better handling of conditional directives and comment block formatting

Reviewed Changes

Copilot reviewed 53 out of 55 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
test files (various *_format.sql)	Updated expected formatting output for various SQL patterns including bind variables, directives, and query structures
SqlFormatterTest.kt	Added comprehensive test cases for new SQL formatting scenarios
SqlBlockGenerator.kt	Enhanced block generation logic for handling conditional loops and query groups
SqlFormatPreProcessor.kt	Simplified SQL preprocessing by removing CREATE query type handling and improving comment formatting
NotQueryGroupHandler.kt	Streamlined group handling by removing dependency on group lists
SqlBlockRelationBuilder.kt	Refactored from SqlSetParentGroupProcessor to use builder pattern for managing block relationships
Various block classes	Enhanced indentation and spacing logic for conditional directives and sub-groups

Comments suppressed due to low confidence (4)

src/main/kotlin/org/domaframework/doma/intellij/formatter/processor/SqlFormatPreProcessor.kt:33

• This import statement references CreateQueryType which is no longer used in the file. The import should be removed as the related functionality has been eliminated.

import org.domaframework.doma.intellij.formatter.util.SqlKeywordUtil

src/main/kotlin/org/domaframework/doma/intellij/formatter/handler/NotQueryGroupHandler.kt:21

• This import is no longer used since the SqlElConditionLoopCommentBlock reference was removed from the lastGroupParentConditionKeywordGroup function. The import should be removed.

import org.domaframework.doma.intellij.formatter.block.conflict.SqlConflictClauseBlock

src/main/kotlin/org/domaframework/doma/intellij/formatter/block/group/keyword/top/SqlJoinQueriesGroupBlock.kt:21

• This import is unused since SqlJoinQueriesGroupBlock now extends SqlTopQueryGroupBlock instead of SqlKeywordGroupBlock. The import should be removed.

import org.domaframework.doma.intellij.formatter.block.group.keyword.with.SqlWithQuerySubGroupBlock

src/main/kotlin/org/domaframework/doma/intellij/formatter/block/group/keyword/top/SqlJoinQueriesGroupBlock.kt:22

• This import is unused since IndentType is no longer referenced in this file after the class hierarchy change. The import should be removed.

import org.domaframework.doma.intellij.formatter.util.SqlBlockFormattingContext