feat: implement module system with imports and exports support

vscode-extension/README.md

@@ -10,11 +10,14 @@ VS Code extension for syntax highlighting of QuestLang - a specialized language
 - 🎨 **Color highlighting for strings and numbers**
 - 🔧 **Automatic bracket closing**
 - 📐 **Automatic indentation**
+- 📦 **Modules and imports** (`модуль`, `импорт`, `экспорт`, `из`)
+- 🧭 **Cross-module references** `@Модуль.узел`
 
 ## Supported Language Elements
 
 ### Keywords
 - `квест`, `цель`, `граф`, `узлы`, `начало`, `конец`
+- `модуль`, `импорт`, `экспорт`, `из`
 - `тип`, `описание`, `переходы`, `варианты`, `название`
 - `начальный`, `действие`, `концовка`
 
@@ -28,23 +31,30 @@ VS Code extension for syntax highlighting of QuestLang - a specialized language
 ## Code Example
 
 ```questlang
-квест MyQuest;
-    цель "Quest objective description";
+модуль Локации;
+узлы {
+    лес: { тип: концовка; название: "Лес"; описание: "Вы в лесу"; }
+}
+экспорт [лес];
+
+квест МойКвест;
+цель "Описание цели квеста";
+
+импорт Локации из "./locations.ql";
 
 граф {
     узлы {
         старт: {
             тип: начальный;
-            описание: "Beginning of the adventure";
+            описание: "Начало приключения";
             переходы: [выбор];
         }
 
         выбор: {
             тип: действие;
-            описание: "What will you do?";
+            описание: "Что вы будете делать?";
             варианты: [
-                ("Go right", правый_путь),
-                ("Go left", левый_путь)
+                ("Идти в лес", @Локации.лес)
             ];
         }
     }

vscode-extension/syntaxes/questlang.tmLanguage.json

@@ -6,6 +6,12 @@
     {
       "include": "#comments"
     },
+    {
+      "include": "#module-declaration"
+    },
+    {
+      "include": "#import-declaration"
+    },
     {
       "include": "#quest-declaration"
     },
@@ -27,11 +33,42 @@
     {
       "include": "#identifiers"
     },
+    {
+      "include": "#module-reference"
+    },
     {
       "include": "#punctuation"
     }
   ],
   "repository": {
+    "module-declaration": {
+      "patterns": [
+        {
+          "match": "(модуль)\\s+([а-яёА-ЯЁa-zA-Z_][а-яёА-ЯЁa-zA-Z0-9_]*)",
+          "captures": {
+            "1": { "name": "keyword.control.module.questlang" },
+            "2": { "name": "entity.name.namespace.module.questlang" }
+          }
+        }
+      ]
+    },
+    "import-declaration": {
+      "patterns": [
+        {
+          "begin": "(импорт)\\s+([а-яёА-ЯЁa-zA-Z_][а-яёА-ЯЁa-zA-Z0-9_]*)\\s+(из)\\s+(\")",
+          "end": "\"",
+          "beginCaptures": {
+            "1": { "name": "keyword.control.import.questlang" },
+            "2": { "name": "entity.name.namespace.import.questlang" },
+            "3": { "name": "keyword.control.from.questlang" },
+            "4": { "name": "punctuation.definition.string.begin.questlang" }
+          },
+          "endCaptures": { "0": { "name": "punctuation.definition.string.end.questlang" } },
+          "contentName": "string.quoted.double.path.questlang",
+          "patterns": [{ "match": "\\\\.", "name": "constant.character.escape.questlang" }]
+        }
+      ]
+    },
     "comments": {
       "patterns": [
         {
@@ -93,7 +130,7 @@
       "patterns": [
         {
           "name": "keyword.control.structure.questlang",
-          "match": "\\b(граф|узлы|начало|конец)\\b"
+          "match": "\\b(граф|узлы|начало|конец|модуль|импорт|экспорт|из)\\b"
         },
         {
           "name": "keyword.other.property.questlang",
@@ -105,6 +142,14 @@
         }
       ]
     },
+    "module-reference": {
+      "patterns": [
+        {
+          "name": "support.type.module.reference.questlang",
+          "match": "@([а-яёА-ЯЁa-zA-Z_][а-яёА-ЯЁa-zA-Z0-9_]*)\\.([а-яёА-ЯЁa-zA-Z_][а-яёА-ЯЁa-zA-Z0-9_]*)"
+        }
+      ]
+    },
     "strings": {
       "patterns": [
         {