feat: Trailing commas for with ... lists and init() parameters

CHANGELOG.md

@@ -19,7 +19,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - Update the `dump` function to handle addresses: PR [#175](https://github.com/tact-lang/tact/pull/175)
-- Support trailing commas for struct fields and function arguments: PR [#179](https://github.com/tact-lang/tact/pull/179)
+- Support trailing commas in all comma-separated lists (struct instance fields, `initOf` arguments, `init()` parameters, inherited traits via `with`, function arguments and parameters): PR [#179](https://github.com/tact-lang/tact/pull/179) and PR [#246](https://github.com/tact-lang/tact/pull/246)
 - The implicit empty `init` function is now present by default in the contract if not declared: PR [#167](https://github.com/tact-lang/tact/pull/167)
 - `@stdlib/stoppable` now imports `@stdlib/ownable` so the programmer does not have to do it separately: PR [#193](https://github.com/tact-lang/tact/pull/193)
 - Support escape sequences for strings (`\\`, `\"`, `\n`, `\r`, `\t`, `\v`, `\b`, `\f`, `\u{0}` through `\u{FFFFFF}`, `\u0000` through `\uFFFF`, `\x00` through `\xFF`): PR [#192](https://github.com/tact-lang/tact/pull/192)

jest.config.js

@@ -2,7 +2,7 @@ module.exports = {
     preset: "ts-jest",
     testEnvironment: "node",
     testPathIgnorePatterns: ["/node_modules/", "/dist/"],
-    maxWorkers: 1,
+    maxWorkers: "50%",
     globalSetup: "./jest.setup.js",
     globalTeardown: "./jest.teardown.js",
     snapshotSerializers: ["@tact-lang/ton-jest/serializers"],

src/grammar/__snapshots__/grammar.spec.ts.snap

@@ -254,6 +254,34 @@ Line 2, col 31:
 "
 `;
 
+exports[`grammar should fail case-27 1`] = `
+"<unknown>:1:19: Empty inherited traits list should not have a dangling comma.
+Line 1, col 19:
+> 1 | contract Name with, {}
+                        ^
+  2 | 
+"
+`;
+
+exports[`grammar should fail case-28 1`] = `
+"<unknown>:1:16: Empty inherited traits list should not have a dangling comma.
+Line 1, col 16:
+> 1 | trait Name with, {}
+                     ^
+  2 | 
+"
+`;
+
+exports[`grammar should fail case-29 1`] = `
+"<unknown>:2:10: Empty parameter list should not have a dangling comma.
+Line 2, col 10:
+  1 | contract Name {
+> 2 |     init(,) {}
+               ^
+  3 | }
+"
+`;
+
 exports[`grammar should parse case-0 1`] = `
 {
   "entries": [
@@ -2727,8 +2755,8 @@ exports[`grammar should parse case-22 1`] = `
           "id": 3,
           "init": null,
           "kind": "def_field",
-          "name": "a",
-          "ref": a: Int;,
+          "name": "c",
+          "ref": c: Int;,
           "type": {
             "id": 2,
             "kind": "type_ref_simple",
@@ -2740,10 +2768,10 @@ exports[`grammar should parse case-22 1`] = `
       ],
       "id": 4,
       "kind": "def_trait",
-      "name": "SomeTrait",
+      "name": "OtherTrait",
       "origin": "user",
-      "ref": trait SomeTrait {
-    a: Int;
+      "ref": trait OtherTrait {
+    c: Int;
 },
       "traits": [],
     },
@@ -2755,8 +2783,8 @@ exports[`grammar should parse case-22 1`] = `
           "id": 6,
           "init": null,
           "kind": "def_field",
-          "name": "b",
-          "ref": b: Int;,
+          "name": "a",
+          "ref": a: Int;,
           "type": {
             "id": 5,
             "kind": "type_ref_simple",
@@ -2767,23 +2795,58 @@ exports[`grammar should parse case-22 1`] = `
         },
       ],
       "id": 8,
+      "kind": "def_trait",
+      "name": "SomeTrait",
+      "origin": "user",
+      "ref": trait SomeTrait with OtherTrait, {
+    a: Int;
+},
+      "traits": [
+        {
+          "id": 7,
+          "kind": "id",
+          "ref": OtherTrait,
+          "value": "OtherTrait",
+        },
+      ],
+    },
+    {
+      "attributes": [],
+      "declarations": [
+        {
+          "as": null,
+          "id": 10,
+          "init": null,
+          "kind": "def_field",
+          "name": "b",
+          "ref": b: Int;,
+          "type": {
+            "id": 9,
+            "kind": "type_ref_simple",
+            "name": "Int",
+            "optional": false,
+            "ref": Int,
+          },
+        },
+      ],
+      "id": 12,
       "kind": "def_contract",
       "name": "Main",
       "origin": "user",
-      "ref": contract Main with SomeTrait {
+      "ref": contract Main with SomeTrait, {
     b: Int;
 },
       "traits": [
         {
-          "id": 7,
+          "id": 11,
           "kind": "id",
           "ref": SomeTrait,
           "value": "SomeTrait",
         },
       ],
     },
   ],
-  "id": 9,
+  "id": 13,
   "kind": "program",
 }
 `;
@@ -3669,7 +3732,10 @@ exports[`grammar should parse case-25 1`] = `
           ],
           "id": 76,
           "kind": "def_init_function",
-          "ref": init(arg1: Int, arg2: Int) {},
+          "ref": init(
+        arg1: Int,
+        arg2: Int,
+    ) {},
           "statements": [],
         },
       ],
@@ -3678,7 +3744,10 @@ exports[`grammar should parse case-25 1`] = `
       "name": "TestContract",
       "origin": "user",
       "ref": contract TestContract {
-    init(arg1: Int, arg2: Int) {}
+    init(
+        arg1: Int,
+        arg2: Int,
+    ) {}
 },
       "traits": [],
     },

src/grammar/grammar.ohm

@@ -45,8 +45,8 @@ Tact {
 
     // Contract
     Contract = ContractAttribute* contract id "{" ContractBody* "}" --simple
-             | ContractAttribute* contract id with ListOf<id,","> "{" ContractBody* "}" --withTraits
-    ContractInit = "init" "(" ListOf<FunctionArg,","> ")" "{" Statement* "}"
+             | ContractAttribute* contract id with ListOf<id,","> ","? "{" ContractBody* "}" --withTraits
+    ContractInit = "init" "(" ListOf<FunctionArg,","> ","? ")" "{" Statement* "}"
     ContractBody = Field
                  | ContractInit
                  | ReceiveFunction
@@ -55,7 +55,7 @@ Tact {
 
     // Trait
     Trait = ContractAttribute* trait id "{" TraitBody* "}" --originary
-          | ContractAttribute* trait id with ListOf<id,","> "{" TraitBody* "}" --withTraits
+          | ContractAttribute* trait id with ListOf<id,","> ","? "{" TraitBody* "}" --withTraits
     TraitBody = Field
               | ReceiveFunction
               | Function

src/grammar/grammar.ohm-bundle.d.ts

@@ -43,12 +43,12 @@ export interface TactActionDict<T> extends ActionDict<T> {
   Struct?: (this: NonterminalNode, arg0: NonterminalNode) => T;
   StructBody?: (this: NonterminalNode, arg0: NonterminalNode) => T;
   Contract_simple?: (this: NonterminalNode, arg0: IterationNode, arg1: NonterminalNode, arg2: NonterminalNode, arg3: TerminalNode, arg4: IterationNode, arg5: TerminalNode) => T;
-  Contract_withTraits?: (this: NonterminalNode, arg0: IterationNode, arg1: NonterminalNode, arg2: NonterminalNode, arg3: NonterminalNode, arg4: NonterminalNode, arg5: TerminalNode, arg6: IterationNode, arg7: TerminalNode) => T;
+  Contract_withTraits?: (this: NonterminalNode, arg0: IterationNode, arg1: NonterminalNode, arg2: NonterminalNode, arg3: NonterminalNode, arg4: NonterminalNode, arg5: IterationNode, arg6: TerminalNode, arg7: IterationNode, arg8: TerminalNode) => T;
   Contract?: (this: NonterminalNode, arg0: NonterminalNode) => T;
-  ContractInit?: (this: NonterminalNode, arg0: TerminalNode, arg1: TerminalNode, arg2: NonterminalNode, arg3: TerminalNode, arg4: TerminalNode, arg5: IterationNode, arg6: TerminalNode) => T;
+  ContractInit?: (this: NonterminalNode, arg0: TerminalNode, arg1: TerminalNode, arg2: NonterminalNode, arg3: IterationNode, arg4: TerminalNode, arg5: TerminalNode, arg6: IterationNode, arg7: TerminalNode) => T;
   ContractBody?: (this: NonterminalNode, arg0: NonterminalNode) => T;
   Trait_originary?: (this: NonterminalNode, arg0: IterationNode, arg1: NonterminalNode, arg2: NonterminalNode, arg3: TerminalNode, arg4: IterationNode, arg5: TerminalNode) => T;
-  Trait_withTraits?: (this: NonterminalNode, arg0: IterationNode, arg1: NonterminalNode, arg2: NonterminalNode, arg3: NonterminalNode, arg4: NonterminalNode, arg5: TerminalNode, arg6: IterationNode, arg7: TerminalNode) => T;
+  Trait_withTraits?: (this: NonterminalNode, arg0: IterationNode, arg1: NonterminalNode, arg2: NonterminalNode, arg3: NonterminalNode, arg4: NonterminalNode, arg5: IterationNode, arg6: TerminalNode, arg7: IterationNode, arg8: TerminalNode) => T;
   Trait?: (this: NonterminalNode, arg0: NonterminalNode) => T;
   TraitBody?: (this: NonterminalNode, arg0: NonterminalNode) => T;
   ContractAttribute_interface?: (this: NonterminalNode, arg0: TerminalNode, arg1: TerminalNode, arg2: NonterminalNode, arg3: TerminalNode) => T;

src/grammar/grammar.ts

@@ -107,7 +107,24 @@ semantics.addOperation<ASTNode>("resolve_program_item", {
             ref: createRef(this),
         });
     },
-    Contract_withTraits(arg0, _arg1, arg2, _arg3, arg4, _arg5, arg6, _arg7) {
+    Contract_withTraits(
+        arg0,
+        _arg1,
+        arg2,
+        _arg3,
+        arg4,
+        arg5,
+        _arg6,
+        arg7,
+        _arg8,
+    ) {
+        if (arg4.source.contents === "" && arg5.sourceString === ",") {
+            throwError(
+                "Empty inherited traits list should not have a dangling comma.",
+                createRef(arg5),
+            );
+        }
+
         checkVariableName(arg2.sourceString, createRef(arg2));
         return createNode({
             kind: "def_contract",
@@ -116,7 +133,7 @@ semantics.addOperation<ASTNode>("resolve_program_item", {
             attributes: arg0.children.map((v) =>
                 v.resolve_contract_attributes(),
             ),
-            declarations: arg6.children.map((v) => v.resolve_declaration()),
+            declarations: arg7.children.map((v) => v.resolve_declaration()),
             traits: arg4
                 .asIteration()
                 .children.map((v) => v.resolve_expression()),
@@ -137,7 +154,14 @@ semantics.addOperation<ASTNode>("resolve_program_item", {
             ref: createRef(this),
         });
     },
-    Trait_withTraits(arg0, _arg1, arg2, _arg3, arg4, _arg5, arg6, _arg7) {
+    Trait_withTraits(arg0, _arg1, arg2, _arg3, arg4, arg5, _arg6, arg7, _arg8) {
+        if (arg4.source.contents === "" && arg5.sourceString === ",") {
+            throwError(
+                "Empty inherited traits list should not have a dangling comma.",
+                createRef(arg5),
+            );
+        }
+
         checkVariableName(arg2.sourceString, createRef(arg2));
         return createNode({
             kind: "def_trait",
@@ -146,7 +170,7 @@ semantics.addOperation<ASTNode>("resolve_program_item", {
             attributes: arg0.children.map((v) =>
                 v.resolve_contract_attributes(),
             ),
-            declarations: arg6.children.map((v) => v.resolve_declaration()),
+            declarations: arg7.children.map((v) => v.resolve_declaration()),
             traits: arg4
                 .asIteration()
                 .children.map((v) => v.resolve_expression()),
@@ -539,13 +563,20 @@ semantics.addOperation<ASTNode>("resolve_declaration", {
             ref: createRef(this),
         });
     },
-    ContractInit(_arg0, _arg1, arg2, _arg3, _arg4, arg5, _arg6) {
+    ContractInit(_arg0, _arg1, arg2, arg3, _arg4, _arg5, arg6, _arg7) {
+        if (arg2.source.contents === "" && arg3.sourceString === ",") {
+            throwError(
+                "Empty parameter list should not have a dangling comma.",
+                createRef(arg3),
+            );
+        }
+
         return createNode({
             kind: "def_init_function",
             args: arg2
                 .asIteration()
                 .children.map((v) => v.resolve_declaration()),
-            statements: arg5.children.map((v) => v.resolve_statement()),
+            statements: arg6.children.map((v) => v.resolve_statement()),
             ref: createRef(this),
         });
     },

src/grammar/test-failed/case-27.tact

@@ -0,0 +1 @@
+contract Name with, {}

src/grammar/test-failed/case-28.tact

@@ -0,0 +1 @@
+trait Name with, {}

src/grammar/test-failed/case-29.tact

@@ -0,0 +1,3 @@
+contract Name {
+    init(,) {}
+}

src/grammar/test/case-22.tact

@@ -1,9 +1,13 @@
 primitive Int;
 
-trait SomeTrait {
+trait OtherTrait {
+    c: Int;
+}
+
+trait SomeTrait with OtherTrait, {
     a: Int;
 }
 
-contract Main with SomeTrait {
+contract Main with SomeTrait, {
     b: Int;
-}
+}

src/grammar/test/case-25.tact

@@ -36,7 +36,10 @@ fun oneMoreFunction(
 }
 
 contract TestContract {
-    init(arg1: Int, arg2: Int) {}
+    init(
+        arg1: Int,
+        arg2: Int,
+    ) {}
 }
 
 fun test() {