petrichor.h

/*
 * Petrichor public API
 * Copyright (C) 2026 Linifadomra Org.
 *
 * This file is part of Petrichor.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
#pragma once
#include <stdint.h>
#include <string>
#include <vector>

struct PetrichorManifest {
    char id[64];

    char name[128];

    char kind[16];

    char type[32];

    char entry[128];

    char author[128];

    char version[32];

    char hostVersion[32];

    char engineVersion[32];

    std::string desc;

    std::vector<std::string> conflicts;

    std::string dir;
};

enum class PetrichorLogLevel : uint8_t { Info = 0, Warn, Error, Debug };

struct IPetrichorHost {
    virtual void log(PetrichorLogLevel level, const char* tag, const char* msg) const = 0;

    virtual const char* mods_dir() const = 0;

    virtual const char* temp_dir() const = 0;

    virtual const char* store_dir() const { return nullptr; }

    virtual const char* version() const { return "unversioned"; }

    virtual void mod_ctx_enter(const char* dir, const char* id) {}

    virtual void mod_ctx_exit() {}

    virtual const char* project_name() const { return "unnamed"; }
 

    virtual ~IPetrichorHost() = default;
};

void petrichor_run(IPetrichorHost& host, std::vector<std::string> formats = {"prm","zip"});

void petrichor_tick(IPetrichorHost& host, float delta);

void petrichor_stop(IPetrichorHost& host);

void petrichor_unload_mod(const char* id);

void petrichor_reload_mod(const char* id);

std::vector<std::string> petrichor_poll_changes();

void petrichor_rescan_dir(IPetrichorHost& host, std::vector<std::string> formats = {"prm","zip"});

std::vector<PetrichorManifest> petrichor_get_mods();
 
#ifdef __cplusplus
struct lua_State;
namespace petrichor {

    using ModuleFactory = int(*)(lua_State*);

    void luau_register_module(const char* name, ModuleFactory factory);

    lua_State* lua_state();
 
}
#endif