Fix SQL formatting rules for JSON columns

[xterao]

Overview

• Fixed an issue where unnecessary spaces were inserted between operators (such as ->>, @>, etc.) when accessing properties from JSON columns.
• Improved the formatting logic for array parameters. Specifically, when writing arrays like ARRAY['p1', 'p2'], ensured that the array closing bracket ] is not treated as an escape character, so that arrays are formatted correctly.

Example

Before:

SELECT id
       , json_data - > > 'name' AS name
       , json_data - > 'address' - > > 'city' AS city -- Incorrect spaces
       , jsonb_data @ > '{"active": true}' AS is_active
       , jsonb_data < @ '{"role": "admin"}' AS has_admin_role
       , jsonb_data ? 'email' AS has_email
       , jsonb_data ? & array [ /* property1 */'name'
       , /* property2 */'age' ]AS has_required_fields -- Incorrect line break

After:

SELECT id
      , json_data ->> 'name' AS name
      , json_data -> 'address' ->> 'city' AS city
      , jsonb_data @> '{"active": true}' AS is_active
      , jsonb_data <@ '{"role": "admin"}' AS has_admin_role
      , jsonb_data ? 'email' AS has_email
      , jsonb_data ?& array[/* property1 */'name', /* property2 */'age'] AS has_required_fields

• These changes improve the accuracy and readability of SQL formatting when working with JSON columns and array parameters.

[Copilot]

Pull Request Overview

This PR fixes SQL formatting issues specifically for JSON columns and array parameters by improving how operators and array brackets are handled.

• Fixed unnecessary spaces being inserted between JSON operators (->>, @>, etc.) when accessing properties from JSON columns
• Improved array parameter formatting by ensuring array closing brackets ] are handled correctly and not treated as escape characters
• Added specific handling for ARRAY expressions with proper indentation and spacing

Reviewed Changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
src/test/testData/sql/formatter/*.sql	Test data files showing before/after formatting with JSON operators and array parameters
src/test/kotlin/.../SqlFormatterTest.kt	Added test case for comparison operators formatting
src/main/kotlin/.../SqlBlockGenerator.kt	Added logic to detect ARRAY keywords and create proper block types
src/main/kotlin/.../CommaRawClauseHandler.kt	Added handling for commas within array list groups
src/main/kotlin/.../SqlArrayWordBlock.kt	New block type for ARRAY keywords with proper indentation logic
src/main/kotlin/.../SqlArrayListGroupBlock.kt	New group block for array parameter lists
src/main/kotlin/.../SqlEscapeBlock.kt	Modified to handle array closing brackets correctly
src/main/kotlin/.../SqlFileBlock.kt	Updated spacing rules for JSON/SQL operators and array constructs
src/main/kotlin/.../comment/*.kt	Refactored comment block handling with improved utility methods

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}