Thread.h

/****************************************************************************
 * Platform Abstraction Layer
 * Daryl Borth 2026
 * Thread.h
 *
 * Generic - Everything platform-specific lives behind platform->getThread().
 ***************************************************************************/
#pragma once
 
#include <stdint.h>
 
#include "Mutex.h"
#include "Cond.h"

enum class ThreadPriority
{
    Idle,
    Low,
    Normal,
    High,
    TimeCritical
};

class Thread
{
    public:
        Thread() : handle(nullptr) {}
        ~Thread();
 
        Thread(const Thread &) = delete;
        Thread & operator=(const Thread &) = delete;

        bool start(ThreadEntry entry, void * arg = nullptr, uint32_t stackSize = 8192, ThreadPriority priority = ThreadPriority::Normal, void (*wake)(void) = nullptr);
        void join();
        void cancel();
        void suspend();
        void resume();
        bool isSuspended() const;
        bool isRunning() const { return handle != nullptr; }

        void requestStop();
        bool stopRequested() const { return stopFlag; }

        static void JoinAll();
 
    protected:
        void * handle = nullptr; 
        volatile bool stopFlag = false; 
        void (*wakeFn)(void) = nullptr; 
        Thread * registryNext = nullptr; 
};

class ThreadId
{
    public:
        ThreadId() : id(0) {}

        static ThreadId current();

        bool operator==(const ThreadId & other) const { return id == other.id; }
        bool operator!=(const ThreadId & other) const { return !(*this == other); }
 
    protected:
        explicit ThreadId(uintptr_t v) : id(v) {}
        uintptr_t id; 
};

struct ThreadSync
{
    Mutex mutex; 
    Cond  workCond; 
    Cond  idleCond; 
};