v1.4.8: Add recursive JSON-safe serialization utilities

- Introduced extension methods for recursive serialization and deserialization of nested maps/lists: `toJsonValue()`, `fromJsonValue()`, `toJsonMap()`, `fromJsonMap()`, `toJsonList()`, and `fromJsonList()`.
- Updated README.md to include new utilities.
- Added tests for JSON value extensions.
- Bumped version to 1.4.8.

Signed-off-by: Hans Kokx <hans.d.kokx@gmail.com>

test/extensions/json_value_test.dart

@@ -0,0 +1,62 @@
+import "package:arcane_helper_utils/arcane_helper_utils.dart";
+import "package:test/test.dart";
+
+void main() {
+  group("JsonValue extensions", () {
+    test("toJsonList serializes nested list values", () {
+      final List<Object?> nested = <Object?>[
+        <Object?>[
+          1,
+          2,
+          <Object?, Object?>{"ok": true},
+        ],
+      ];
+
+      final result = nested.toJsonList();
+
+      expect(result, isA<List<Object?>>());
+      expect((result.first as List<Object?>)[0], 1);
+      expect(
+        ((result.first as List<Object?>)[2] as Map<String, Object?>)["ok"],
+        isTrue,
+      );
+    });
+
+    test("toJsonMap serializes map keys and nested values", () {
+      final map = <Object?, Object?>{
+        123: "value",
+        "nested": <Object?, Object?>{"a": 1},
+      };
+
+      expect(map.toJsonMap().containsKey("123"), isTrue);
+      expect(
+        (map.toJsonMap()["nested"] as Map<String, Object?>)["a"],
+        1,
+      );
+    });
+
+    test("fromJsonMap decodes nested structures from Object?", () {
+      final Object value = <String, Object?>{
+        "meta": <String, Object?>{
+          "list": <Object?>[
+            <String, Object?>{"x": 1},
+          ],
+        },
+      };
+
+      final decoded = value.fromJsonMap();
+      final meta = decoded!["meta"]! as Map<String, Object?>;
+      final list = meta["list"]! as List<Object?>;
+
+      expect((list.first as Map<String, Object?>)["x"], 1);
+    });
+
+    test("toJsonValue and fromJsonValue round-trip primitives", () {
+      const Object original = 42;
+      final jsonValue = original.toJsonValue();
+      final decoded = jsonValue.fromJsonValue();
+
+      expect(decoded, 42);
+    });
+  });
+}

test/utils/json_converter_test.dart

@@ -48,4 +48,55 @@ void main() {
       expect(converter.toJson(null), null);
     });
   });
+
+  group("Json value extensions", () {
+    test("toJsonValue recursively encodes nested maps and lists", () {
+      final input = <Object?, Object?>{
+        "user": <Object?, Object?>{
+          "name": "Hans",
+          "stats": <Object?>[1, 2, true],
+        },
+        42: <Object?>[
+          <Object?, Object?>{"nested": "value"},
+        ],
+      };
+
+      final result = input.toJsonValue() as Map<String, Object?>;
+
+      expect(result["42"], isA<List<Object?>>());
+      expect(result["user"], isA<Map<String, Object?>>());
+      final user = result["user"]! as Map<String, Object?>;
+      expect(user["name"], "Hans");
+      expect(user["stats"], <Object?>[1, 2, true]);
+    });
+
+    test("toJsonValue stringifies unsupported leaves", () {
+      final now = DateTime.utc(2026, 1, 1);
+
+      expect(now.toJsonValue(), now.toString());
+    });
+
+    test("fromJsonValue recursively decodes nested maps and lists", () {
+      final input = <String, Object?>{
+        "metadata": <String, Object?>{
+          "list": <Object?>[
+            <String, Object?>{"ok": true},
+            7,
+          ],
+        },
+      };
+
+      final result = input.fromJsonValue() as Map<String, Object?>;
+      final metadata = result["metadata"]! as Map<String, Object?>;
+      final list = metadata["list"]! as List<Object?>;
+
+      expect((list.first as Map<String, Object?>)["ok"], isTrue);
+      expect(list[1], 7);
+    });
+
+    test("fromJsonMap returns null when value is not a map", () {
+      expect(("not a map" as Object?).fromJsonMap(), isNull);
+      expect((null as Object?).fromJsonMap(), isNull);
+    });
+  });
 }