rexglue-sdk/include/rex/codegen/codegen.h

/**
 * @file        rex/codegen/codegen.h
 * @brief       Codegen pipeline orchestrator
 *
 * @copyright   Copyright (c) 2026 Tom Clay <tomc@tctechstuff.com>
 *              All rights reserved.
 *
 * @license     BSD 3-Clause License
 *              See LICENSE file in the project root for full license text.
 */

#pragma once

#include <rex/codegen/codegen_context.h>
#include <rex/result.h>
#include <filesystem>
#include <memory>

namespace rex {
class Runtime;
}

namespace rex::codegen {

/**
 * Pipeline orchestrator for code generation.
 *
 * Usage:
 *   auto pipeline = CodegenPipeline::Create(configPath);
 *   if (!pipeline) { handle error }
 *   auto result = pipeline->Run();
 */
class CodegenPipeline {
public:
    ~CodegenPipeline();

    // Non-copyable, movable
    CodegenPipeline(const CodegenPipeline&) = delete;
    CodegenPipeline& operator=(const CodegenPipeline&) = delete;
    CodegenPipeline(CodegenPipeline&&) noexcept;
    CodegenPipeline& operator=(CodegenPipeline&&) noexcept;

    /**
     * Create pipeline from config file path.
     * Loads XEX, creates Runtime and CodegenContext.
     *
     * @param configPath Path to TOML config file
     * @return Pipeline on success, error on failure
     */
    static Result<CodegenPipeline> Create(const std::filesystem::path& configPath);

    /**
     * Run the full pipeline: Analyze -> Recompile.
     *
     * @param force If true, generate output even with validation errors
     * @return Success or error with description
     */
    Result<void> Run(bool force = false);

    /// Access context for CLI needs (output path, project name, etc.)
    CodegenContext& context() { return *ctx_; }
    const CodegenContext& context() const { return *ctx_; }

private:
    CodegenPipeline() = default;

    std::unique_ptr<Runtime> runtime_;
    std::unique_ptr<CodegenContext> ctx_;
};

} // namespace rex::codegen