feat: 调试器支持 DAP（WIP）

Author: Wing-summer

.gitmodules

@@ -23,3 +23,9 @@
 [submodule "3rdparty/angel-lsp"]
 	path = 3rdparty/angel-lsp
 	url = git@github.com:Wing-summer/angel-lsp.git
+[submodule "3rdparty/cppdap"]
+	path = 3rdparty/cppdap
+	url = git@github.com:Wing-summer/cppdap.git
+[submodule "3rdparty/fmt"]
+	path = 3rdparty/fmt
+	url = git@github.com:Wing-summer/fmt.git

3rdparty/AngelScript

@@ -0,0 +1,5 @@
+## as-debugger
+
+提供支持 DAP 的 AngelScript 调试器，开源协议为 MIT，来源于 https://github.com/Paril/quake2-angelscript，依赖`cppdap`和`fmt`，感谢[Paril](https://github.com/Paril)的贡献。
+
+Provides AngelScript debugger with DAP support, from https://github.com/Paril/quake2-angelscript. The license is MIT and its dependencies are `cppdap` and `fmt`. Thanks to [Paril](https://github.com/Paril) for his contribution.

3rdparty/as-debugger/README.md

@@ -0,0 +1,58 @@
+#include "as_dbg_state.h"
+
+as_dbg_state &as_dbg_state::instance() {
+    static as_dbg_state ins;
+    return ins;
+}
+
+void as_dbg_state::RegisterEvaluator(
+    int typeId, std::unique_ptr<asIDBTypeEvaluator> evaluator) {
+    typeId &= asTYPEID_MASK_OBJECT | asTYPEID_MASK_SEQNBR;
+    evaluators.insert_or_assign(typeId, std::move(evaluator));
+}
+
+void as_dbg_state::CheckDebugger(asIScriptContext *ctx) {
+    auto &debugger_state = instance();
+
+    // TODO
+    // check if the debugger needs to be changed
+    // if (debugger_state.active_type != debugger_state.cvar->integer) {
+    //     debugger_state.debugger.reset();
+    //     debugger_state.workspace.reset();
+    //     debugger_state.active_type = debugger_state.cvar->integer;
+    // }
+
+    // we don't want debugging
+    // if (!debugger_state.cvar->integer)
+    //     return;
+
+    // create the debugger
+    if (!debugger || debugger_state.outdated) {
+        debugger.reset();
+        debugger_state.workspace.reset();
+
+        // debugger_state.workspace = std::make_unique<asIDBFileWorkspace>(
+        //     std::filesystem::path(Q2AS_ScriptPath()).generic_string(),
+        //     std::initializer_list<asIScriptEngine *>{svas.engine,
+        //     cgas.engine});
+
+        // debugger = std::make_unique<q2as_asIDBDebuggerVSCode>(
+        //     debugger_state.workspace.get());
+        debugger_state.outdated = false;
+    }
+
+    // hook the context if the debugger
+    // has work to do (breakpoints, etc)
+    debugger->HookContext(ctx, debugger->HasWork());
+}
+
+void as_dbg_state::DebugBreak(asIScriptContext *ctx) {
+    if (!ctx)
+        ctx = asGetActiveContext();
+
+    if (!debugger)
+        CheckDebugger(ctx);
+
+    if (debugger)
+        debugger->DebugBreak(ctx);
+}

3rdparty/as-debugger/as_dbg_state.cpp

@@ -0,0 +1,45 @@
+// MIT Licensed
+// see https://github.com/Paril/angelscript-debugger
+
+#ifndef AS_DBG_STATE_H
+#define AS_DBG_STATE_H
+
+#include "as_debugger.h"
+
+class as_dbg_state {
+public:
+    static as_dbg_state &instance();
+
+public:
+    // set to true to re-set the workspace.
+    bool outdated = false;
+
+    std::unique_ptr<asIDBDebugger> debugger;
+    std::unique_ptr<asIDBWorkspace> workspace;
+
+    uint8_t current_tid = 0;
+
+    // evaluators don't take up much memory so we'll just
+    // always keep them around.
+    std::unordered_map<int, std::unique_ptr<asIDBTypeEvaluator>> evaluators;
+
+    // Register an evaluator.
+    void RegisterEvaluator(int typeId,
+                           std::unique_ptr<asIDBTypeEvaluator> evaluator);
+
+    // A quick shortcut to make a templated instantiation
+    // of T from the given type name.
+    template <typename T>
+    void RegisterEvaluator(asIScriptEngine *engine, const char *name) {
+        RegisterEvaluator(engine->GetTypeInfoByName(name)->GetTypeId(),
+                          std::make_unique<T>());
+    }
+
+    int active_type; // active debugger type
+    bool suspend_immediately = true;
+
+    void CheckDebugger(asIScriptContext *ctx);
+    void DebugBreak(asIScriptContext *ctx = nullptr);
+};
+
+#endif // AS_DBG_STATE_H