Crafter.Build/interfaces/Crafter.Build-Platform.cppm

/*
Crafter® Build
Copyright (C) 2026 Catcrafts®
Catcrafts.net

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License version 3.0 as published by the Free Software Foundation;

This library 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
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA
*/

module;
#include "Crafter.Build-Api.h"
export module Crafter.Build:Platform;
import std;
namespace fs = std::filesystem;

namespace Crafter {
    struct Configuration;
    struct CommandResult {
        int exitCode = 0;
        std::string output;
        bool crashed = false;
        bool timedOut = false;
        int signal = 0;
    };
    std::string BuildStdPcm(const Configuration& config, fs::path stdPcm);
    fs::path GetCacheDir();
    std::string RunCommand(const std::string_view command);
    CommandResult RunCommandChecked(std::string_view command);
    export CRAFTER_API CommandResult RunCommandWithTimeout(std::string_view command, std::chrono::seconds timeout);
    std::string GetBaseCommand(const Configuration& config);
    export CRAFTER_API Configuration LoadProject(const fs::path& projectFile, std::span<const std::string_view> args);
    // Resolves the directory holding distributed runtime assets (Crafter.Build
    // module sources, wasi-runtime/, etc). Honors CRAFTER_BUILD_HOME; otherwise
    // derives <prefix>/share/crafter-build from the running executable's path.
    export CRAFTER_API fs::path GetCrafterBuildHome();
}