#pragma once #include #include #include namespace evo::world { inline constexpr std::uint32_t coordinate_contract_version = 1; inline constexpr std::int64_t voxel_limit = 1'048'576; // [-limit, limit), every axis inline constexpr std::int64_t cell_pitch_mm = 1'000; inline constexpr std::uint32_t fill_scale = 65'535; // Values are logical addresses, never native serialization records. Each API // validates raw input; constructing these aggregates does not validate them. struct VoxelAddress { std::int64_t x{}, y{}, z{}; auto operator<=>(const VoxelAddress&) const = default; }; struct ChunkAddress { std::int64_t x{}, y{}, z{}; auto operator<=>(const ChunkAddress&) const = default; }; struct LocalCell { std::uint32_t x{}, y{}, z{}; auto operator<=>(const LocalCell&) const = default; }; struct ChunkLocation { ChunkAddress chunk; LocalCell local; auto operator<=>(const ChunkLocation&) const = default; }; struct SignedMillimetres { std::int64_t value{}; auto operator<=>(const SignedMillimetres&) const = default; }; struct MetricCorner { SignedMillimetres x, y, z; auto operator<=>(const MetricCorner&) const = default; }; struct MaterialId { std::uint16_t value{}; // zero is void; table membership is checked elsewhere auto operator<=>(const MaterialId&) const = default; }; enum class WorldError : std::uint8_t { invalid_edge, voxel_out_of_range, chunk_out_of_range, local_out_of_range, ordinal_out_of_range, invalid_cell }; // Explicit edge candidate in {8,16,32,64}; coordinate API stays explicit; M5 storage selects 16. [[nodiscard]] std::expected split(VoxelAddress voxel, std::uint32_t edge) noexcept; [[nodiscard]] std::expected join(ChunkLocation location, std::uint32_t edge) noexcept; // Canonical logical enumeration, X fastest. Does not prescribe memory layout. [[nodiscard]] std::expected ordinal(LocalCell local, std::uint32_t edge) noexcept; [[nodiscard]] std::expected local_from_ordinal(std::uint32_t index, std::uint32_t edge) noexcept; [[nodiscard]] std::expected lower_corner_mm(VoxelAddress voxel) noexcept; // Occupied volume fraction only; not an SDF, density or biological inventory. // Trivial value copies/moves preserve validity. No material database dependency. class CellSample { public: [[nodiscard]] static std::expected create(MaterialId material, std::uint32_t fill) noexcept; [[nodiscard]] MaterialId material() const noexcept { return material_; } [[nodiscard]] std::uint16_t fill() const noexcept { return fill_; } auto operator<=>(const CellSample&) const = default; private: CellSample(MaterialId material, std::uint16_t fill) : material_{material}, fill_{fill} {} MaterialId material_; std::uint16_t fill_; }; } // namespace evo::world