BehaviorTreeProject.h

Go to the documentation of this file.

#pragma once
 
#include "Types/Types.h"
#include <map>
#include <memory>
#include <nlohmann/json.hpp>
#include <set>
#include <vector>
 
namespace EmberCore {

struct TreeImplementationStatus {
    String tree_id;                          
    bool is_implemented = false;             
    bool has_root_node = false;              
    String defined_in_file;                  
    std::vector<String> referenced_in_files; 
 
    TreeImplementationStatus() = default;
    explicit TreeImplementationStatus(const String &id) : tree_id(id) {}
};

struct ResourceValidationStatus {
    String filepath;                  
    bool exists = false;              
    bool is_valid_xml = false;        
    bool has_behavior_trees = false;  
    int tree_count = 0;               
    std::vector<String> tree_ids;     
    std::vector<String> subtree_refs; 
    std::vector<String> errors;       
    std::vector<String> warnings;     
 
    // Blackboard tracking
    bool has_blackboards = false;            
    int blackboard_count = 0;                
    std::vector<String> blackboard_ids;      
    std::vector<String> blackboard_includes; 
 
    bool IsValid() const { return exists && is_valid_xml && (has_behavior_trees || has_blackboards) && errors.empty(); }
};

struct ProjectValidationReport {
    bool is_valid = false;                                    
    std::vector<ResourceValidationStatus> resource_statuses;  
    std::map<String, TreeImplementationStatus> tree_statuses; 
    std::vector<String> errors;                               
    std::vector<String> warnings;                             
    std::vector<String> unimplemented_trees;                  
    std::vector<String> circular_references;                  
 
    // Blackboard validation
    std::vector<String> unresolved_blackboard_includes; 
    std::vector<String> duplicate_blackboard_ids;       
 
    int GetValidFileCount() const;
    int GetTotalTreeCount() const;
    int GetImplementedTreeCount() const;
    String GenerateReport() const;
};

class BehaviorTreeProject {
  public:
    BehaviorTreeProject();
    explicit BehaviorTreeProject(const String &name, const String &description = "");
    ~BehaviorTreeProject() = default;
 
    // Project metadata
    String GetName() const { return name_; }
    void SetName(const String &name);
 
    String GetDescription() const { return description_; }
    void SetDescription(const String &description);
 
    String GetVersion() const { return version_; }
    void SetVersion(const String &version) { version_ = version; }
 
    int64_t GetCreatedTimestamp() const { return created_timestamp_; }
    int64_t GetModifiedTimestamp() const { return modified_timestamp_; }
    void UpdateModifiedTimestamp();
 
    // Parser profile association
    String GetParserProfileName() const { return parser_profile_name_; }
    void SetParserProfileName(const String &profile_name);
 
    // Resource management
    bool AddResource(const String &filepath);
    bool RemoveResource(const String &filepath);
    bool HasResource(const String &filepath) const;
    void ClearResources();
    const std::vector<String> &GetResources() const { return resources_; }
    size_t GetResourceCount() const { return resources_.size(); }
 
    // Project file path (where the .btproj file is saved)
    String GetProjectFilePath() const { return project_filepath_; }
    void SetProjectFilePath(const String &filepath) { project_filepath_ = filepath; }
 
    // Get the base directory for resolving relative resource paths
    String GetBaseDirectory() const;
 
    // Resolve a resource path (relative to project file or absolute)
    String ResolveResourcePath(const String &resource_path) const;
 
    // Convert an absolute path to relative (for storage)
    String MakeRelativePath(const String &absolute_path) const;
 
    // Validation
    ProjectValidationReport ValidateResources() const;
    ProjectValidationReport ValidateWithParser(class LibXMLBehaviorTreeParser *parser) const;
    bool IsValid() const;
 
    // Tree implementation tracking (populated after parsing)
    void SetTreeImplementationStatus(const std::map<String, TreeImplementationStatus> &statuses);
    const std::map<String, TreeImplementationStatus> &GetTreeImplementationStatuses() const { return tree_statuses_; }
    std::vector<String> GetUnimplementedReferences() const;
    std::vector<String> GetImplementedTrees() const;
    bool IsTreeImplemented(const String &tree_id) const;
 
    // JSON serialization/deserialization
    nlohmann::json ToJson() const;
    void FromJson(const nlohmann::json &json);
 
    // File I/O
    bool SaveToFile(const String &filepath);
    bool LoadFromFile(const String &filepath);
 
    // Cloning
    std::shared_ptr<BehaviorTreeProject> Clone(const String &new_name = "") const;
 
    // Factory methods
    static std::shared_ptr<BehaviorTreeProject> CreateEmpty(const String &name);
 
  private:
    // Helper to get current timestamp
    static int64_t GetCurrentTimestamp();
 
    // Validate a single resource file
    ResourceValidationStatus ValidateSingleResource(const String &filepath) const;
 
  private:
    String name_;
    String description_;
    String version_;
    int64_t created_timestamp_;
    int64_t modified_timestamp_;
 
    String parser_profile_name_; 
    String project_filepath_;    
 
    std::vector<String> resources_; 
 
    // Tree implementation tracking (populated after full parsing)
    std::map<String, TreeImplementationStatus> tree_statuses_;
};
 
} // namespace EmberCore