feat(vscode): add action to attach to FunC debugger (#36)

Big thanks to TonTech for implementation in https://github.com/krigga/tvm-debugger

Fixes #35

Author: i582

README.md

@@ -42,6 +42,7 @@ FunC support includes:
 - Inlay hints for method id
 - On-the-fly inspections
 - Build and test projects based on Blueprint
+- Debug Blueprint-based projects
 
 Fift assembly support includes:
 
@@ -276,6 +277,11 @@ Setup steps:
 
 See [TROUBLESHOOTING.md](./docs/manual/troubleshooting.md).
 
-# License
+## Thanks
+
+- Big thanks to [TonTech](https://ton.tech) for [FunC debugger
+  implementation](https://github.com/krigga/tvm-debugger)!
+
+## License
 
 MIT

editors/code/README.md

@@ -42,6 +42,7 @@ FunC support includes:
 - Inlay hints for method id
 - On-the-fly inspections
 - Build and test projects based on Blueprint
+- Debug Blueprint-based projects
 
 Fift assembly support includes:
 

editors/code/src/debugging/index.ts

@@ -0,0 +1,30 @@
+import * as vscode from "vscode"
+import {DebugAdapterExecutable, DebugSession} from "vscode"
+
+export function configureDebugging(context: vscode.ExtensionContext): void {
+    context.subscriptions.push(
+        vscode.debug.registerDebugConfigurationProvider("tvm", {
+            provideDebugConfigurations() {
+                return [
+                    {
+                        type: "tvm",
+                        name: "Debug",
+                        request: "launch",
+                    },
+                ]
+            },
+        }),
+        vscode.debug.registerDebugAdapterDescriptorFactory("tvm", {
+            createDebugAdapterDescriptor(_s: DebugSession, _e: DebugAdapterExecutable | undefined) {
+                return new vscode.DebugAdapterServer(42_069)
+            },
+        }),
+        vscode.commands.registerCommand("ton.debug", () => {
+            void vscode.debug.startDebugging(undefined, {
+                type: "tvm",
+                name: "Debug",
+                request: "launch",
+            })
+        }),
+    )
+}

editors/code/src/extension.ts

@@ -29,6 +29,7 @@ import {BocDecompilerProvider} from "./providers/BocDecompilerProvider"
 import {registerSaveBocDecompiledCommand} from "./commands/saveBocDecompiledCommand"
 import {Range, Position, FileSystemWatcher} from "vscode"
 import {ToolchainConfig} from "@server/settings/settings"
+import {configureDebugging} from "./debugging"
 
 let client: LanguageClient | null = null
 let cachedToolchainInfo: SetToolchainVersionParams | null = null
@@ -40,6 +41,7 @@ export async function activate(context: vscode.ExtensionContext): Promise<void>
     await registerBuildTasks(context)
     registerOpenBocCommand(context)
     registerSaveBocDecompiledCommand(context)
+    configureDebugging(context)
 
     const config = vscode.workspace.getConfiguration("ton")
     const openDecompiled = config.get<boolean>("boc.openDecompiledOnOpen")
@@ -664,6 +666,7 @@ async function checkConflictingExtensions(): Promise<void> {
     const conflictingExtensions = [
         {id: "tonwhales.func-vscode", name: "FunC"},
         {id: "ton-core.tolk-vscode", name: "Tolk"},
+        {id: "krigga.tvm-debugger", name: "TVM Debugger"},
     ]
 
     const installedConflicting = conflictingExtensions.filter(ext => {

package.json

@@ -198,6 +198,17 @@
             }
         ],
         "snippets": [],
+        "debuggers": [
+            {
+                "type": "tvm",
+                "label": "TVM Debug"
+            }
+        ],
+        "breakpoints": [
+            {
+                "language": "func"
+            }
+        ],
         "commands": [
             {
                 "command": "tolk.build",
@@ -266,6 +277,10 @@
             {
                 "command": "tolk.getUnresolvedIdentifiers",
                 "title": "Tolk: Get Unresolved Identifiers"
+            },
+            {
+                "command": "ton.debug",
+                "title": "TON: Debug contract"
             }
         ],
         "keybindings": [