Kelsidavis-WoWee/tools/editor/cli_item_flags_catalog.cpp

#include "cli_item_flags_catalog.hpp"
#include "cli_arg_parse.hpp"
#include "cli_box_emitter.hpp"

#include "pipeline/wowee_item_flags.hpp"
#include <nlohmann/json.hpp>

#include <cstdint>
#include <cstdio>
#include <cstring>
#include <fstream>
#include <string>
#include <vector>

namespace wowee {
namespace editor {
namespace cli {

namespace {

std::string stripWifsExt(std::string base) {
    stripExt(base, ".wifs");
    return base;
}

bool saveOrError(const wowee::pipeline::WoweeItemFlags& c,
                 const std::string& base, const char* cmd) {
    if (!wowee::pipeline::WoweeItemFlagsLoader::save(c, base)) {
        std::fprintf(stderr, "%s: failed to save %s.wifs\n",
                     cmd, base.c_str());
        return false;
    }
    return true;
}

void printGenSummary(const wowee::pipeline::WoweeItemFlags& c,
                     const std::string& base) {
    std::printf("Wrote %s.wifs\n", base.c_str());
    std::printf("  catalog : %s\n", c.name.c_str());
    std::printf("  flags   : %zu\n", c.entries.size());
}

int handleGenStandard(int& i, int argc, char** argv) {
    std::string base = argv[++i];
    std::string name = "StandardItemFlags";
    if (parseOptArg(i, argc, argv)) name = argv[++i];
    base = stripWifsExt(base);
    auto c = wowee::pipeline::WoweeItemFlagsLoader::makeStandard(name);
    if (!saveOrError(c, base, "gen-ifs")) return 1;
    printGenSummary(c, base);
    return 0;
}

int handleGenBinding(int& i, int argc, char** argv) {
    std::string base = argv[++i];
    std::string name = "BindingItemFlags";
    if (parseOptArg(i, argc, argv)) name = argv[++i];
    base = stripWifsExt(base);
    auto c = wowee::pipeline::WoweeItemFlagsLoader::makeBinding(name);
    if (!saveOrError(c, base, "gen-ifs-binding")) return 1;
    printGenSummary(c, base);
    return 0;
}

int handleGenServer(int& i, int argc, char** argv) {
    std::string base = argv[++i];
    std::string name = "ServerCustomItemFlags";
    if (parseOptArg(i, argc, argv)) name = argv[++i];
    base = stripWifsExt(base);
    auto c = wowee::pipeline::WoweeItemFlagsLoader::makeServer(name);
    if (!saveOrError(c, base, "gen-ifs-server")) return 1;
    printGenSummary(c, base);
    return 0;
}

int handleInfo(int& i, int argc, char** argv) {
    std::string base = argv[++i];
    bool jsonOut = consumeJsonFlag(i, argc, argv);
    base = stripWifsExt(base);
    if (!wowee::pipeline::WoweeItemFlagsLoader::exists(base)) {
        std::fprintf(stderr, "WIFS not found: %s.wifs\n", base.c_str());
        return 1;
    }
    auto c = wowee::pipeline::WoweeItemFlagsLoader::load(base);
    if (jsonOut) {
        nlohmann::json j;
        j["wifs"] = base + ".wifs";
        j["name"] = c.name;
        j["count"] = c.entries.size();
        nlohmann::json arr = nlohmann::json::array();
        for (const auto& e : c.entries) {
            arr.push_back({
                {"flagId", e.flagId},
                {"name", e.name},
                {"description", e.description},
                {"bitMask", e.bitMask},
                {"flagKind", e.flagKind},
                {"flagKindName", wowee::pipeline::WoweeItemFlags::flagKindName(e.flagKind)},
                {"isPositive", e.isPositive != 0},
                {"iconColorRGBA", e.iconColorRGBA},
            });
        }
        j["entries"] = arr;
        std::printf("%s\n", j.dump(2).c_str());
        return 0;
    }
    std::printf("WIFS: %s.wifs\n", base.c_str());
    std::printf("  catalog : %s\n", c.name.c_str());
    std::printf("  flags   : %zu\n", c.entries.size());
    if (c.entries.empty()) return 0;
    std::printf("    id    bitMask        kind        +/-   name\n");
    for (const auto& e : c.entries) {
        std::printf("  %4u   0x%08x     %-9s   %s    %s\n",
                    e.flagId, e.bitMask,
                    wowee::pipeline::WoweeItemFlags::flagKindName(e.flagKind),
                    e.isPositive ? "+" : "-",
                    e.name.c_str());
    }
    return 0;
}

int handleValidate(int& i, int argc, char** argv) {
    std::string base = argv[++i];
    bool jsonOut = consumeJsonFlag(i, argc, argv);
    base = stripWifsExt(base);
    if (!wowee::pipeline::WoweeItemFlagsLoader::exists(base)) {
        std::fprintf(stderr,
            "validate-wifs: WIFS not found: %s.wifs\n", base.c_str());
        return 1;
    }
    auto c = wowee::pipeline::WoweeItemFlagsLoader::load(base);
    std::vector<std::string> errors;
    std::vector<std::string> warnings;
    if (c.entries.empty()) {
        warnings.push_back("catalog has zero entries");
    }
    std::vector<uint32_t> idsSeen;
    std::vector<uint32_t> bitsSeen;
    for (size_t k = 0; k < c.entries.size(); ++k) {
        const auto& e = c.entries[k];
        std::string ctx = "entry " + std::to_string(k) +
                          " (id=" + std::to_string(e.flagId);
        if (!e.name.empty()) ctx += " " + e.name;
        ctx += ")";
        if (e.flagId == 0)
            errors.push_back(ctx + ": flagId is 0");
        if (e.name.empty())
            errors.push_back(ctx + ": name is empty");
        if (e.flagKind > wowee::pipeline::WoweeItemFlags::Misc) {
            errors.push_back(ctx + ": flagKind " +
                std::to_string(e.flagKind) + " not in 0..6");
        }
        if (e.bitMask == 0) {
            errors.push_back(ctx +
                ": bitMask is 0 — flag will never match anything");
        }
        // bitMask should typically be a single bit (power
        // of 2). Multi-bit masks are valid but unusual —
        // warn so author can confirm.
        if (e.bitMask != 0 && (e.bitMask & (e.bitMask - 1)) != 0) {
            warnings.push_back(ctx +
                ": bitMask 0x" + std::to_string(e.bitMask) +
                " is not a single bit (multi-bit flags are "
                "unusual; usually you want one of the "
                "individual bits)");
        }
        for (uint32_t prev : idsSeen) {
            if (prev == e.flagId) {
                errors.push_back(ctx + ": duplicate flagId");
                break;
            }
        }
        idsSeen.push_back(e.flagId);
        // Two flags claiming the same bit is a serious
        // collision — engine would only match the first
        // entry's name when decoding.
        if (e.bitMask != 0) {
            for (uint32_t prevBit : bitsSeen) {
                if (prevBit == e.bitMask) {
                    errors.push_back(ctx +
                        ": duplicate bitMask 0x" +
                        std::to_string(e.bitMask) +
                        " — collides with another entry");
                    break;
                }
            }
            bitsSeen.push_back(e.bitMask);
        }
    }
    bool ok = errors.empty();
    if (jsonOut) {
        nlohmann::json j;
        j["wifs"] = base + ".wifs";
        j["ok"] = ok;
        j["errors"] = errors;
        j["warnings"] = warnings;
        std::printf("%s\n", j.dump(2).c_str());
        return ok ? 0 : 1;
    }
    std::printf("validate-wifs: %s.wifs\n", base.c_str());
    if (ok && warnings.empty()) {
        std::printf("  OK — %zu flags, all flagIds + bitMasks unique\n",
                    c.entries.size());
        return 0;
    }
    if (!warnings.empty()) {
        std::printf("  warnings (%zu):\n", warnings.size());
        for (const auto& w : warnings)
            std::printf("    - %s\n", w.c_str());
    }
    if (!errors.empty()) {
        std::printf("  ERRORS (%zu):\n", errors.size());
        for (const auto& e : errors)
            std::printf("    - %s\n", e.c_str());
    }
    return ok ? 0 : 1;
}

} // namespace

bool handleItemFlagsCatalog(int& i, int argc, char** argv,
                            int& outRc) {
    if (std::strcmp(argv[i], "--gen-ifs") == 0 && i + 1 < argc) {
        outRc = handleGenStandard(i, argc, argv); return true;
    }
    if (std::strcmp(argv[i], "--gen-ifs-binding") == 0 && i + 1 < argc) {
        outRc = handleGenBinding(i, argc, argv); return true;
    }
    if (std::strcmp(argv[i], "--gen-ifs-server") == 0 && i + 1 < argc) {
        outRc = handleGenServer(i, argc, argv); return true;
    }
    if (std::strcmp(argv[i], "--info-wifs") == 0 && i + 1 < argc) {
        outRc = handleInfo(i, argc, argv); return true;
    }
    if (std::strcmp(argv[i], "--validate-wifs") == 0 && i + 1 < argc) {
        outRc = handleValidate(i, argc, argv); return true;
    }
    return false;
}

} // namespace cli
} // namespace editor
} // namespace wowee