Crafter.Build/interfaces/Crafter.Build-Interface.cppm

// SPDX-License-Identifier: LGPL-3.0-only
// SPDX-FileCopyrightText: Copyright (C) 2026 Catcrafts®

export module Crafter.Build:Interface;
import std;
namespace fs = std::filesystem;

namespace Crafter {
    export class Module;
    export class ModulePartition {
        public:
        std::vector<Module*> moduleDependencies;
        std::vector<ModulePartition*> partitionDependencies;
        std::vector<std::pair<Module*, fs::path>> externalModuleDependencies;
        // Names from `import X;` that matched neither a module in this
        // Configuration nor one reachable through its dependencies at the time
        // the source was scanned. Retried by ResolvePendingImports (see
        // Crafter.Build:Clang) so a dependency wired up after
        // GetInterfacesAndImplementations still produces a staleness edge.
        // Names that never resolve (`std`, module-mapped externals) stay here.
        std::vector<std::string> pendingImports;
        std::atomic<bool> compiled;
        bool needsRecompiling = false;
        bool checked = false;
        std::string name;
        fs::path path;
        ModulePartition(std::string&& name, fs::path&& path);
        bool Check(const fs::path& pcmDir, fs::file_time_type sourceFloor = fs::file_time_type::min());
        void Compile(const std::string_view clang, const fs::path& pcmDir, const fs::path& buildDir, std::atomic<bool>& buildCancelled, std::string& buildError);
    };

    export class Module {
        public:
        // A primary module interface unit imports things too — `import Base;`
        // in `export module Widget;` is as much a layout dependency as the
        // same line in a partition. Recorded on the same three vectors, with
        // the same meanings, so Check() can see through them and Compile()
        // can order itself behind a sibling module in the same Configuration
        // (issue #26).
        std::vector<Module*> moduleDependencies;
        std::vector<std::pair<Module*, fs::path>> externalModuleDependencies;
        std::vector<std::string> pendingImports;
        std::atomic<bool> compiled;
        bool needsRecompiling = false;
        bool checked = false;
        std::vector<std::unique_ptr<ModulePartition>> partitions;
        std::string name;
        fs::path path;
        Module(std::string&& name, fs::path&& path);
        bool Check(const fs::path& pcmDir, fs::file_time_type sourceFloor = fs::file_time_type::min());
        void Compile(const std::string_view clang, const fs::path& pcmDir, const fs::path& buildDir, std::atomic<bool>& buildCancelled, std::string& buildError);
    };
}