#pragma once

#include "tactility/device.h"
#include "tactility/module.h"
#include <Tactility/Dispatcher.h>
#include <Tactility/app/AppManifest.h>
#include <Tactility/hal/Configuration.h>
#include <Tactility/service/ServiceManifest.h>

namespace tt {

/** @brief The configuration for the operating system
 * It contains the hardware configuration, apps and services
 */
struct Configuration {
    /** HAL configuration (drivers) */
    const hal::Configuration* hardware = nullptr;
};

/**
 * @brief Main entry point for Tactility.
 * @param platformModule Platform module to start (non-null).
 * @param deviceModule Device module to start (non-null).
 * @param devicetreeDevices Null-terminated array where an entry { NULL, NULL } marks the end of the list.
 */
void run(const Configuration& config, Module* platformModule, Module* deviceModule, CompatibleDevice devicetreeDevices[]);

/**
 * While technically nullable, this instance is always set if tt_init() succeeds.
 * Could return nullptr if init was not called.
 * @return the Configuration instance that was passed on to tt_init() if init is successful
 */
const Configuration* getConfiguration();

/** Provides access to the dispatcher that runs on the main task.
 * @warning This dispatcher is used for WiFi and might block for some time during WiFi connection.
 * @return the dispatcher
 */
Dispatcher& getMainDispatcher();

namespace hal {

/** While technically this configuration is nullable, it's never null after initHeadless() is called. */
const Configuration* getConfiguration();

} // namespace hal

} // namespace tt
