StillHammer
fad105afb2
Major feature: Unified config/data/runtime tree system
**New System Architecture:**
- Unified data tree for config, persistent data, and runtime state
- Three separate roots: config/ (read-only + hot-reload), data/ (read-write + save), runtime/ (temporary)
- Support for modding, saves, and hot-reload in single system
**Interfaces:**
- IDataValue: Abstract data value interface (type-safe access)
- IDataNode: Tree node with navigation, search, and modification
- IDataTree: Root container with config/data/runtime management
**Concrete Implementations:**
- JsonDataValue: nlohmann::json backed value
- JsonDataNode: Full tree navigation with pattern matching & queries
- JsonDataTree: File-based JSON storage with hot-reload
**Features:**
- Pattern matching search (wildcards support)
- Property-based queries with predicates
- SHA256 hashing for validation/sync
- Hot-reload for config/ directory
- Save operations for data/ persistence
- Read-only enforcement for config/
**API Changes:**
- All namespaces changed from 'warfactory' to 'grove'
- IDataTree: Added getConfigRoot(), getDataRoot(), getRuntimeRoot()
- IDataTree: Added saveData(), saveNode() for persistence
- IDataNode: Added setChild(), removeChild(), clearChildren()
- CMakeLists.txt: Added OpenSSL dependency for hashing
**Usage:**
```cpp
auto tree = DataTreeFactory::create("json", "./gamedata");
auto config = tree->getConfigRoot(); // Read-only game config
auto data = tree->getDataRoot(); // Player saves
auto runtime = tree->getRuntimeRoot(); // Temporary state
// Hot-reload config on file changes
if (tree->reloadIfChanged()) { /* refresh modules */ }
// Save player progress
data->setChild("progress", progressNode);
tree->saveData();
```
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
89 lines
2.3 KiB
C++
89 lines
2.3 KiB
C++
#pragma once
|
|
|
|
#include <random>
|
|
#include <cstdint>
|
|
|
|
namespace grove {
|
|
|
|
/**
|
|
* @brief Centralized random number generator singleton
|
|
*
|
|
* Provides consistent, seedable random number generation across all modules.
|
|
* Ensures reproducibility for testing and debugging while maintaining
|
|
* high-quality random distribution.
|
|
*/
|
|
class RandomGenerator {
|
|
private:
|
|
std::mt19937 gen;
|
|
|
|
RandomGenerator() : gen(std::random_device{}()) {}
|
|
|
|
public:
|
|
// Singleton access
|
|
static RandomGenerator& getInstance() {
|
|
static RandomGenerator instance;
|
|
return instance;
|
|
}
|
|
|
|
// Delete copy/move constructors and operators
|
|
RandomGenerator(const RandomGenerator&) = delete;
|
|
RandomGenerator& operator=(const RandomGenerator&) = delete;
|
|
RandomGenerator(RandomGenerator&&) = delete;
|
|
RandomGenerator& operator=(RandomGenerator&&) = delete;
|
|
|
|
/**
|
|
* @brief Seed the random generator for reproducible sequences
|
|
* @param seed Seed value (use same seed for identical results)
|
|
*/
|
|
void seed(uint32_t seed) {
|
|
gen.seed(seed);
|
|
}
|
|
|
|
/**
|
|
* @brief Generate uniform float in range [min, max]
|
|
*/
|
|
float uniform(float min, float max) {
|
|
std::uniform_real_distribution<float> dis(min, max);
|
|
return dis(gen);
|
|
}
|
|
|
|
/**
|
|
* @brief Generate uniform int in range [min, max] (inclusive)
|
|
*/
|
|
int uniformInt(int min, int max) {
|
|
std::uniform_int_distribution<int> dis(min, max);
|
|
return dis(gen);
|
|
}
|
|
|
|
/**
|
|
* @brief Generate normal distribution float
|
|
*/
|
|
float normal(float mean, float stddev) {
|
|
std::normal_distribution<float> dis(mean, stddev);
|
|
return dis(gen);
|
|
}
|
|
|
|
/**
|
|
* @brief Generate uniform float in range [0.0, 1.0]
|
|
*/
|
|
float unit() {
|
|
return uniform(0.0f, 1.0f);
|
|
}
|
|
|
|
/**
|
|
* @brief Generate boolean with given probability
|
|
* @param probability Probability of returning true [0.0, 1.0]
|
|
*/
|
|
bool boolean(float probability = 0.5f) {
|
|
return unit() < probability;
|
|
}
|
|
|
|
/**
|
|
* @brief Direct access to underlying generator for custom distributions
|
|
*/
|
|
std::mt19937& getGenerator() {
|
|
return gen;
|
|
}
|
|
};
|
|
|
|
} // namespace grove
|