JSON Schema for Tact configuration

grammar/configSchema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/schema#",
+  "$id": "http://raw.githubusercontent.com/tact-lang/tact/main/grammar/configSchema.json",
+  "title": "Tact configuration schema",
+  "description": "JSON Schema for Tact configuration file",
+  "type": "object",
+  "required": ["projects"],
+  "properties": {
+    "projects": {
+      "type": "array",
+      "description": "The list of all projects with compiler parameters",
+      "items": {
+        "type": "object",
+        "required": ["name", "path", "output"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "The name of a project. All generated files are prefixed with this name"
+          },
+          "path": {
+            "type": "string",
+            "description": "The path to the root Tact file"
+          },
+          "output": {
+            "type": "string",
+            "description": "The path to a directory where all generated files will be placed"
+          },
+          "options": {
+            "type": "object",
+            "description": "Additional project properties",
+            "properties": {
+              "debug": {
+                "type": "boolean",
+                "description": "Enables debug output of a contract. It is useful for debugging purposes. Enabling this contract would report that it was compiled in debug mode using the supported_interfaces method"
+              },
+              "masterchain": {
+                "type": "boolean",
+                "description": "Enables masterchain support in the contract"
+              },
+              "external": {
+                "type": "boolean",
+                "description": "Allows the contract to call external functions"
+              },
+              "experimental": {
+                "type": "object",
+                "description": "Experimental project properties. Might be removed in the future",
+                "properties": {
+                  "inline": {
+                    "type": "boolean",
+                    "description": "Enables inlining of all functions in contracts. Could reduce gas usage at the cost of a bigger contract"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package.json

@@ -59,6 +59,7 @@
     "@types/qs": "^6.9.7",
     "@typescript-eslint/eslint-plugin": "^7.0.2",
     "@typescript-eslint/parser": "^7.0.2",
+    "ajv": "^8.12.0",
     "cross-env": "^7.0.3",
     "eslint": "^8.56.0",
     "glob": "^8.1.0",

src/config/parseConfig.ts

@@ -17,6 +17,7 @@ const projectSchema = z.object({
 }).strict();
 
 const configSchema = z.object({
+    $schema: z.string().optional(),
     projects: z.array(projectSchema)
 }).strict();
 
@@ -31,4 +32,4 @@ export function parseConfig(src: string) {
 
 export function verifyConfig(config: Config) {
     return configSchema.parse(config);
-}
+}

src/test/schema.spec.ts

@@ -0,0 +1,31 @@
+import fs from 'fs';
+import path from 'path';
+import Ajv from 'ajv';
+import { __DANGER_resetNodeId } from '../grammar/ast';
+
+describe('configuration schema', () => {
+  const ajv = new Ajv();
+  const schema = JSON.parse(fs.readFileSync(path.join(__dirname, '..', '..', 'grammar', 'configSchema.json'), 'utf8'));
+
+  beforeEach(() => {
+    __DANGER_resetNodeId();
+  });
+
+  it('should validate Tact config', () => {
+    const tactConfig = JSON.parse(fs.readFileSync(path.join(__dirname, '..', '..', 'tact.config.json'), 'utf8'));
+
+    const validate = ajv.compile(schema);
+    validate(tactConfig);
+
+    expect(validate.errors).toBeNull();
+  });
+
+  it('should validate test config', () => {
+    const testConfig = JSON.parse(fs.readFileSync(path.join(__dirname, 'test-tact.config.json'), 'utf8'));
+
+    const validate = ajv.compile(schema);
+    validate(testConfig);
+
+    expect(validate.errors).toBeNull();
+  });
+});

src/test/test-tact.config.json

@@ -1,12 +1,13 @@
 {
-    "projects": [
-      {
-        "name": "implicit-init-2",
-        "path": "./features/implicit-init-2.tact",
-        "output": "./features/output",
-        "options": {
-          "debug": true
-        }
+  "$schema": "http://raw.githubusercontent.com/tact-lang/tact/main/grammar/configSchema.json",
+  "projects": [
+    {
+      "name": "implicit-init-2",
+      "path": "./features/implicit-init-2.tact",
+      "output": "./features/output",
+      "options": {
+        "debug": true
       }
-    ]
-  }
+    }
+  ]
+}

tact.config.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "http://raw.githubusercontent.com/tact-lang/tact/main/grammar/configSchema.json",
   "projects": [
     {
       "name": "echo",
@@ -269,4 +270,4 @@
       }
     }
   ]
-}
+}

yarn.lock

@@ -1323,6 +1323,16 @@ ajv@^6.12.4:
     json-schema-traverse "^0.4.1"
     uri-js "^4.2.2"
 
+ajv@^8.12.0:
+  version "8.12.0"
+  resolved "https://registry.yarnpkg.com/ajv/-/ajv-8.12.0.tgz#d1a0527323e22f53562c567c00991577dfbe19d1"
+  integrity sha512-sRu1kpcO9yLtYxBKvqfTeh9KzZEwO3STyX1HT+4CaDzC6HpTGYhIhPIzj9XuKU7KYDwnaeh5hcOwjy1QuJzBPA==
+  dependencies:
+    fast-deep-equal "^3.1.1"
+    json-schema-traverse "^1.0.0"
+    require-from-string "^2.0.2"
+    uri-js "^4.2.2"
+
 ansi-align@^3.0.1:
   version "3.0.1"
   resolved "https://registry.yarnpkg.com/ansi-align/-/ansi-align-3.0.1.tgz#0cdf12e111ace773a86e9a1fad1225c43cb19a59"
@@ -4139,6 +4149,11 @@ json-schema-traverse@^0.4.1:
   resolved "https://registry.yarnpkg.com/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz#69f6a87d9513ab8bb8fe63bdb0979c448e684660"
   integrity sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==
 
+json-schema-traverse@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz#ae7bcb3656ab77a73ba5c49bf654f38e6b6860e2"
+  integrity sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==
+
 json-stable-stringify-without-jsonify@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz#9db7b59496ad3f3cfef30a75142d2d930ad72651"
@@ -5095,6 +5110,11 @@ require-directory@^2.1.1:
   resolved "https://registry.yarnpkg.com/require-directory/-/require-directory-2.1.1.tgz#8c64ad5fd30dab1c976e2344ffe7f792a6a6df42"
   integrity sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==
 
+require-from-string@^2.0.2:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/require-from-string/-/require-from-string-2.0.2.tgz#89a7fdd938261267318eafe14f9c32e598c36909"
+  integrity sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==
+
 resolve-alpn@^1.2.0:
   version "1.2.1"
   resolved "https://registry.yarnpkg.com/resolve-alpn/-/resolve-alpn-1.2.1.tgz#b7adbdac3546aaaec20b45e7d8265927072726f9"