Project restructuring (fixes macOS builds) (#198)

- Create `Include/` folder for all main projects
- Fix some issues here and there (found while moving things)
- All includes are now in `Tactility/` subfolder and must be included with that prefix. This fixes issues with clashing POSIX headers (e.g. `<semaphore.h>` versus Tactility's `Semaphore.h`)

Tactility/Include/Tactility/app/App.h

@@ -0,0 +1,97 @@
+#pragma once
+
+#include "Tactility/app/AppContext.h"
+
+#include <Tactility/Bundle.h>
+#include <Tactility/Mutex.h>
+
+#include <string>
+
+// Forward declarations
+typedef struct _lv_obj_t lv_obj_t;
+
+namespace tt::app {
+
+// Forward declarations
+class AppContext;
+enum class Result;
+
+class App {
+
+private:
+
+    Mutex mutex;
+
+    struct ResultHolder {
+        Result result;
+        std::unique_ptr<Bundle> resultData;
+
+        explicit ResultHolder(Result result) : result(result), resultData(nullptr) {}
+
+        ResultHolder(Result result, std::unique_ptr<Bundle> resultData) :
+            result(result),
+            resultData(std::move(resultData)) {}
+    };
+
+    std::unique_ptr<ResultHolder> resultHolder;
+
+public:
+
+    App() = default;
+    virtual ~App() = default;
+
+    virtual void onCreate(AppContext& appContext) {}
+    virtual void onDestroy(AppContext& appContext) {}
+    virtual void onShow(AppContext& appContext, lv_obj_t* parent) {}
+    virtual void onHide(AppContext& appContext) {}
+    virtual void onResult(AppContext& appContext, Result result, std::unique_ptr<Bundle> _Nullable resultData) {}
+
+    Mutex& getMutex() { return mutex; }
+
+    bool hasResult() const { return resultHolder != nullptr; }
+
+    void setResult(Result result, std::unique_ptr<Bundle> resultData = nullptr) {
+        auto lockable = getMutex().scoped();
+        lockable->lock(portMAX_DELAY);
+        resultHolder = std::make_unique<ResultHolder>(result, std::move(resultData));
+    }
+
+    /**
+     * Used by system to extract the result data when this application is finished.
+     * Note that this removes the data from the class!
+     */
+    bool moveResult(Result& outResult, std::unique_ptr<Bundle>& outBundle) {
+        auto lockable = getMutex().scoped();
+        lockable->lock(portMAX_DELAY);
+
+        if (resultHolder != nullptr) {
+            outResult = resultHolder->result;
+            outBundle = std::move(resultHolder->resultData);
+            resultHolder = nullptr;
+            return true;
+        } else {
+            return false;
+        }
+    }
+};
+
+template<typename T>
+std::shared_ptr<App> create() { return std::shared_ptr<T>(new T); }
+
+/**
+ * @brief Start an app
+ * @param[in] id application name or id
+ * @param[in] parameters optional parameters to pass onto the application
+ */
+void start(const std::string& id, std::shared_ptr<const Bundle> _Nullable parameters = nullptr);
+
+/** @brief Stop the currently showing app. Show the previous app if any app was still running. */
+void stop();
+
+/** @return the currently running app context (it is only ever null before the splash screen is shown) */
+std::shared_ptr<app::AppContext> _Nullable getCurrentAppContext();
+
+/** @return the currently running app (it is only ever null before the splash screen is shown) */
+std::shared_ptr<app::App> _Nullable getCurrentApp();
+
+}