From 0fcf2f6fe211c704db1995ce90500ea9c98dd380 Mon Sep 17 00:00:00 2001
From: Roland Conybeare <rconybeare@gmail.com>
Date: Sun, 15 Feb 2026 13:03:48 -0500
Subject: [PATCH] xo-arena: + ArenaHashMapConfig with functional mutators

---
 include/xo/arena/ArenaHashMapConfig.hpp | 58 +++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 include/xo/arena/ArenaHashMapConfig.hpp

diff --git a/include/xo/arena/ArenaHashMapConfig.hpp b/include/xo/arena/ArenaHashMapConfig.hpp
new file mode 100644
index 0000000..6917414
--- /dev/null
+++ b/include/xo/arena/ArenaHashMapConfig.hpp
@@ -0,0 +1,58 @@
+/** @file ArenaHashMapConfig.hpp
+ *
+ *  @author Roland Conybeare, Feb 2026
+ **/
+
+#pragma once
+
+#include <string>
+#include <cstdint>
+
+namespace xo {
+    namespace map {
+        /** @class ArenaHashMapConfig
+         *
+         *  @brief configuration for a @ref DArenaHashMap instance
+         **/
+        struct ArenaHashMapConfig {
+            /** @defgroup map-arenahashmapconfig-ctors **/
+            ///@{
+
+            ArenaHashMapConfig with_name(std::string name) const {
+                ArenaHashMapConfig copy(*this);
+                copy.name_ = name;
+                return copy;
+            }
+
+            ArenaHashMapConfig with_hint_max_capacity(std::size_t z) const {
+                ArenaHashMapConfig copy(*this);
+                copy.hint_max_capacity_ = z;
+                return copy;
+            }
+
+            ArenaHashMapConfig with_debug_flag(bool x) const {
+                ArenaHashMapConfig copy(*this);
+                copy.debug_flag_ = x;
+                return copy;
+            }
+
+            ///@}
+            /** @defgroup mm-arenahashmapconfig-instance-vars ArenaHashMapConfig members **/
+            ///@{
+
+            /** optional name, for diagnostics **/
+            std::string name_;
+            /** desired hard max hashmap size -> reserved virtual memory
+             *  hint: actual max may be larger, because of power-of-2 considerations.
+             **/
+            std::size_t hint_max_capacity_ = 0;
+            /** true to enable debug logging **/
+            bool debug_flag_ = false;
+
+            ///@}
+        };
+
+    } /*namespace map*/
+} /*namespace xo*/
+
+/* end ArenaHashMapConfig.hpp */