Support array literal spread param transform

docs-new/docs/sql-file.md

@@ -59,7 +59,7 @@ A query can also contain multiple expansions if needed:
 SELECT FROM users WHERE age in :ages or name in :names;
 ```
 
-At the moment, PgTyped supports three expansion types:
+At the moment, PgTyped supports four expansion types:
 
 ### Array spread
 
@@ -91,6 +91,36 @@ selectSomeUsers.run(parameters, connection);
 SELECT FROM users WHERE age in ($1, $2, $3);
 ```
 
+### Array literal
+
+The array literal expansion allows to pass an array of scalars as parameter.
+
+#### Syntax:
+
+```
+@param paramName -> ARRAY[...]
+```
+
+#### Example:
+
+```sql title="Query definition:"
+/*
+  @name selectFunctionResult
+  @param values -> ARRAY[...]
+*/
+SELECT FROM my_function(:values);
+```
+
+```ts title="Execution:"
+const parameters = { values: ['a', 'b', 'c'] };
+selectSomeUsers.run(parameters, connection);
+```
+
+```sql title="Resulting query:"
+-- Parameters: ['a', 'b', 'c']
+SELECT FROM my_function(ARRAY[$1, $2, $3]);
+```
+
 ### Object pick
 
 The object pick expansion allows to pass an object as a parameter.

packages/parser/src/loader/sql/grammar/SQLLexer.g4

@@ -38,6 +38,8 @@ NAME_TAG  :  '@name';
 TYPE_TAG  :  '@param';
 OB: '(';
 CB: ')';
+OPEN_ARRAY: 'ARRAY[';
+CLOSE_ARRAY: ']';
 COMMA: ',';
 C_REQUIRED_MARK: '!';
 ANY: .+?;

packages/parser/src/loader/sql/grammar/SQLParser.g4

@@ -39,6 +39,7 @@ paramTransform: TRANSFORM_ARROW transformRule;
 transformRule
     : spreadTransform
     | pickTransform
+    | arrayLiteralTransform
     | spreadPickTransform;
 
 spreadTransform: OB SPREAD CB;
@@ -47,6 +48,8 @@ pickTransform: OB key (COMMA key)* COMMA? CB;
 
 spreadPickTransform: OB pickTransform SPREAD CB;
 
+arrayLiteralTransform: OPEN_ARRAY SPREAD CLOSE_ARRAY;
+
 key: ID C_REQUIRED_MARK?;
 
 queryName: ID;

packages/parser/src/loader/sql/index.ts

@@ -23,6 +23,7 @@ export enum TransformType {
   Scalar = 'scalar',
   PickTuple = 'pick_tuple',
   ArraySpread = 'array_spread',
+  ArrayLiteralSpread = 'array_literal_spread',
   PickArraySpread = 'pick_array_spread',
 }
 
@@ -38,6 +39,9 @@ export type ParamTransform =
   | {
       type: TransformType.ArraySpread;
     }
+  | {
+      type: TransformType.ArrayLiteralSpread;
+    }
   | {
       type: TransformType.PickTuple | TransformType.PickArraySpread;
       keys: ParamKey[];
@@ -168,6 +172,12 @@ class ParseListener implements SQLParserListener {
     };
   }
 
+  enterArrayLiteralTransform() {
+    this.currentTransform = {
+      type: TransformType.ArrayLiteralSpread,
+    };
+  }
+
   enterSpreadPickTransform() {
     this.currentTransform = {
       type: TransformType.PickArraySpread,