json: enrich Simple token containers + fix int64/ll ambiguity

Keep public API stable while adding vector-like helpers for array_t/kvs (reserve, push, erase, typed set/get, iteration).

Fix ambiguous conversion when passing long long into token/object initializers on platforms where int64_t is not long long.

Document JSON helpers consistently (build/convert/jpath/loads/dumps/json.hpp) and add Simple examples under examples/json_simple/.

Author: GaspardKirira

examples/json_simple/01_basic_values.cpp

@@ -0,0 +1,21 @@
+#include <vix/json/Simple.hpp>
+#include <iostream>
+
+using namespace vix::json;
+
+int main()
+{
+  token t1;           // null
+  token t2 = true;    // bool
+  token t3 = 42;      // int -> int64
+  token t4 = 3.14;    // double
+  token t5 = "hello"; // string
+
+  std::cout << "is_null=" << t1.is_null() << "\n";
+  std::cout << "bool=" << t2.as_bool_or(false) << "\n";
+  std::cout << "int64=" << t3.as_i64_or(-1) << "\n";
+  std::cout << "double=" << t4.as_f64_or(0.0) << "\n";
+  std::cout << "string=" << t5.as_string_or("empty") << "\n";
+
+  return 0;
+}

examples/json_simple/02_arrays.cpp

@@ -0,0 +1,27 @@
+#include <vix/json/Simple.hpp>
+#include <iostream>
+
+using namespace vix::json;
+
+int main()
+{
+  array_t arr;
+
+  arr.push_int(1);
+  arr.push_int(2);
+  arr.push_string("three");
+  arr.push_bool(true);
+
+  arr.reserve(10);
+  arr.ensure(6).set_string("auto-filled");
+
+  for (std::size_t i = 0; i < arr.size(); ++i)
+  {
+    if (arr[i].is_string())
+      std::cout << "string: " << arr[i].as_string_or("") << "\n";
+    else if (arr[i].is_i64())
+      std::cout << "int: " << arr[i].as_i64_or(0) << "\n";
+  }
+
+  return 0;
+}

examples/json_simple/03_objects.cpp

@@ -0,0 +1,19 @@
+#include <vix/json/Simple.hpp>
+#include <iostream>
+
+using namespace vix::json;
+
+int main()
+{
+  kvs user;
+
+  user.set_string("name", "Alice");
+  user.set_int("age", 30);
+  user.set_bool("active", true);
+
+  std::cout << user.get_string_or("name", "unknown") << "\n";
+  std::cout << user.get_i64_or("age", 0) << "\n";
+  std::cout << user.get_bool_or("active", false) << "\n";
+
+  return 0;
+}

examples/json_simple/04_nested.cpp

@@ -0,0 +1,23 @@
+#include <vix/json/Simple.hpp>
+#include <iostream>
+
+using namespace vix::json;
+
+int main()
+{
+  kvs root;
+
+  kvs &user = root.ensure_object("user");
+  user.set_string("name", "Gaspard");
+  user.set_int("id", 42);
+
+  array_t &skills = user.ensure_array("skills");
+  skills.push_string("C++");
+  skills.push_string("P2P");
+  skills.push_string("Systems");
+
+  std::cout << user.get_string_or("name", "") << "\n";
+  std::cout << skills[0].as_string_or("") << "\n";
+
+  return 0;
+}

examples/json_simple/05_mutation.cpp

@@ -0,0 +1,26 @@
+#include <vix/json/Simple.hpp>
+#include <iostream>
+
+using namespace vix::json;
+
+int main()
+{
+  token root;
+
+  // Transforme dynamiquement en objet
+  kvs &obj = root.ensure_object();
+  obj.set_string("mode", "dev");
+
+  // Puis en array
+  array_t &logs = obj.ensure_array("logs");
+  logs.push_string("boot");
+  logs.push_string("init");
+  logs.push_string("ready");
+
+  logs.erase_at(1);
+
+  for (const auto &t : logs)
+    std::cout << t.as_string_or("") << "\n";
+
+  return 0;
+}

examples/json_simple/06_iteration.cpp

@@ -0,0 +1,24 @@
+#include <vix/json/Simple.hpp>
+#include <iostream>
+
+using namespace vix::json;
+
+int main()
+{
+  kvs cfg = obj({"host", "localhost",
+                 "port", 8080,
+                 "secure", false});
+
+  cfg.for_each_pair([](std::string_view key, const token &value)
+                    {
+    std::cout << key << " -> ";
+    if (value.is_string())
+      std::cout << value.as_string_or("");
+    else if (value.is_i64())
+      std::cout << value.as_i64_or(0);
+    else if (value.is_bool())
+      std::cout << value.as_bool_or(false);
+    std::cout << "\n"; });
+
+  return 0;
+}

examples/json_simple/07_merge_and_erase.cpp

@@ -0,0 +1,22 @@
+#include <vix/json/Simple.hpp>
+#include <iostream>
+
+using namespace vix::json;
+
+int main()
+{
+  kvs base = obj({"env", "prod",
+                  "debug", false});
+
+  kvs override = obj({"debug", true,
+                      "trace", true});
+
+  base.merge_from(override, true);
+
+  base.erase("env");
+
+  for (auto &k : base.keys())
+    std::cout << "key=" << k << "\n";
+
+  return 0;
+}

examples/json_simple/README.md

@@ -0,0 +1,21 @@
+# Simple.json examples
+
+These examples demonstrate the usage of `vix::json::Simple`,
+a lightweight in-memory JSON-like model.
+
+## When to use Simple.json
+- Internal data exchange
+- No JSON parsing/serialization needed
+- Predictable memory layout
+- Cheap copies and mutations
+
+## Files
+- `01_basic_values.cpp` – primitive values
+- `02_arrays.cpp` – array container API
+- `03_objects.cpp` – object container API
+- `04_nested.cpp` – nested structures
+- `05_mutation.cpp` – dynamic mutation
+- `06_iteration.cpp` – iteration helpers
+- `07_merge_and_erase.cpp` – advanced object ops
+
+If you need parsing or dumping JSON text, use `<vix/json.hpp>` instead.