Add ExecutableCode class

Author: adazem009

CMakeLists.txt

@@ -69,6 +69,7 @@ if (LIBSCRATCHCPP_USE_LLVM)
     target_compile_definitions(scratchcpp PUBLIC USE_LLVM)
     target_sources(scratchcpp
       PUBLIC
+        include/scratchcpp/dev/executablecode.h
         include/scratchcpp/dev/executioncontext.h
     )
 

include/scratchcpp/dev/executablecode.h

@@ -0,0 +1,43 @@
+// SPDX-License-Identifier: Apache-2.0
+
+#pragma once
+
+#include <memory>
+
+#include "../global.h"
+
+namespace libscratchcpp
+{
+
+class ExecutionContext;
+class Target;
+
+/*! \brief The ExecutableCode class represents the code of a compiled Scratch script. */
+class LIBSCRATCHCPP_EXPORT ExecutableCode
+{
+    public:
+        virtual ~ExecutableCode() { }
+
+        /*! Runs the script until it finishes or yields. */
+        virtual void run(ExecutionContext *context) = 0;
+
+        /*! Stops the code. isFinished() will return true. */
+        virtual void kill(ExecutionContext *context) = 0;
+
+        /*! Resets the code to run from the start. */
+        virtual void reset(ExecutionContext *context) = 0;
+
+        /*! Returns true if the code is stopped or finished. */
+        virtual bool isFinished(ExecutionContext *context) const = 0;
+
+        /*! Pauses the script (when it's executed using run() again) until resolvePromise() is called. */
+        virtual void promise() = 0;
+
+        /*! Resolves the promise and resumes the script. */
+        virtual void resolvePromise() = 0;
+
+        /*! Creates an execution context for the given Target. */
+        virtual std::shared_ptr<ExecutionContext> createExecutionContext(Target *target) const = 0;
+};
+
+} // namespace libscratchcpp