feat(rix): update debug facade integration

Author: GaspardKirira

README.md

@@ -9,8 +9,10 @@ It gives Vix C++ projects a single optional facade object:
 
 int main()
 {
-  rix.debug.print("Hello {}", "Rix");
+  rix.debug.print("Hello", "Rix");
+
   auto table = rix.csv.parse("name,language\nAda,C++\n");
+
   rix.debug.log("loaded {} rows", table.size());
 }
 ```
@@ -64,7 +66,7 @@ vix install
 
 int main()
 {
-  rix.debug.print("Hello {}", "Rix");
+  rix.debug.print("Hello", "Rix");
 
   const auto message = rix.debug.format("Package: {}", "rix/rix");
 
@@ -95,16 +97,15 @@ int main()
       "Gaspard,Vix\n";
 
   const auto table = rix.csv.parse(input);
+
   rix.debug.log("loaded {} rows", table.size());
 
   for (const auto &row : table)
   {
     for (const auto &field : row)
     {
-      rix.debug.print.inline_text("{} ", field);
+      rix.debug.print(field);
     }
-
-    rix.debug.print();
   }
 
   return 0;
@@ -118,7 +119,7 @@ int main()
 
 int main()
 {
-  rix.debug.print("Hello {}", "Rix");
+  rix.debug.print("Hello", "Rix");
 
   auto text = rix.debug.format("Package: {}", "rix/rix");
 
@@ -131,6 +132,37 @@ int main()
 }
 ```
 
+## Print and format
+
+`rix.debug.print` does not replace `{}` placeholders.
+
+It prints values separated by spaces:
+
+```cpp
+rix.debug.print("Hello", "Rix");
+rix.debug.print(1, 2, 3);
+```
+
+Output:
+
+```txt
+Hello Rix
+1 2 3
+```
+
+For placeholder formatting, use `rix.debug.format`:
+
+```cpp
+auto text = rix.debug.format("Hello {}", "Rix");
+rix.debug.print(text);
+```
+
+Or use `rix.debug.log` directly:
+
+```cpp
+rix.debug.log("Hello {}", "Rix");
+```
+
 ## Independent packages
 
 Each Rix module can also be used independently.
@@ -167,7 +199,9 @@ vix install
 int main()
 {
   rixlib::debug::Debug debug;
-  debug.print("Hello {}", "Rix");
+
+  debug.print("Hello", "Rix");
+  debug.log("loaded {} rows", 3);
 
   return 0;
 }

examples/basic.cpp

@@ -7,7 +7,7 @@
 
 int main()
 {
-  rix.debug.print("Hello {}", "Rix");
+  rix.debug.print("Hello", "Rix");
   rix.debug.log("facade is ready");
 
   return 0;

examples/csv.cpp

@@ -5,6 +5,7 @@
 
 #include <rix.hpp>
 
+#include <sstream>
 #include <string>
 
 namespace
@@ -13,12 +14,19 @@ namespace
   {
     for (const auto &row : table)
     {
-      for (const auto &field : row)
+      std::ostringstream line;
+
+      for (std::size_t i = 0; i < row.size(); ++i)
       {
-        rix.debug.print.inline_text("{} ", field);
+        if (i > 0)
+        {
+          line << " ";
+        }
+
+        line << row[i];
       }
 
-      rix.debug.print();
+      rix.debug.print(line.str());
     }
   }
 }

examples/debug.cpp

@@ -5,11 +5,9 @@
 
 #include <rix.hpp>
 
-#include <string>
-
 int main()
 {
-  rix.debug.print("Hello {}", "Rix");
+  rix.debug.print("Hello", "Rix");
 
   const std::string package = rix.debug.format("Package: {}", "rix/rix");
 

include/rix.hpp

@@ -12,7 +12,8 @@
  *
  * @code
  * auto table = rix.csv.parse("name,lang\nAda,C++\n");
- * rix.debug.print("loaded {} rows", table.size());
+ * rix.debug.print("loaded rows:", table.size());
+ * rix.debug.log("loaded {} rows", table.size());
  * @endcode
  *
  * @author Gaspard Kirira

packages/debug/README.md

@@ -1,83 +1,208 @@
-# rix/debug
+# @rix/debug
 
-Debug printing, formatting, logging, and inspection utilities for Rix.
+Debug utilities for Rix.
 
-`rix/debug` is part of Rix, the userland package layer for the Vix.cpp ecosystem.
+`@rix/debug` provides a small set of developer-focused tools for C++ projects:
 
-The source code lives in its own repository. This folder only keeps the official package entry used by the Rix umbrella repository.
+- formatted strings
+- simple logging
+- value inspection
+- print helpers
 
-## Install
+It can be used as an independent Rix package, or through the unified `@rix/rix` facade.
+
+## Installation
 
 ```bash
 vix add @rix/debug
 vix install
 ```
 
-## Use
+## Basic usage
 
 ```cpp
 #include <rix/debug.hpp>
 
 int main()
 {
-  rixlib::debug::Debug debug;
+  rixlib::debug::Debug debug{};
 
-  debug.print("Hello {}", "Rix");
+  debug.print("Hello", "Rix");
 
   auto text = debug.format("Package: {}", "rix/debug");
 
   debug.log("loaded {} rows", 3);
   debug.log.warn("slow request: {}ms", 120);
 
   debug.inspect(text);
+
+  return 0;
 }
 ```
 
-## Repository
+Output:
 
 ```txt
-https://github.com/rixcpp/debug
+Hello Rix
+[debug] loaded 3 rows
+[warn] slow request: 120ms
+Package: rix/debug
 ```
 
-## Package
+## Formatting
+
+`debug.format` supports simple placeholder-based formatting.
+
+```cpp
+auto message = debug.format("Hello {}", "Rix");
+auto result = debug.format("{0} + {0} = {1}", 2, 4);
+auto escaped = debug.format("{{ value }} = {}", 42);
+```
+
+Supported placeholders:
 
 ```txt
-rix/debug
+{}   automatic argument indexing
+{0}  explicit positional indexing
+{{   escaped opening brace
+}}   escaped closing brace
 ```
 
-## Namespace
+Format specifiers such as `{:>10}` or `{:.2f}` are intentionally not supported.
+
+## Logging
 
 ```cpp
-rixlib::debug
+debug.log("loaded {} rows", 3);
+debug.log.info("server started");
+debug.log.warn("slow request: {}ms", 120);
+debug.log.error("failed: {}", "timeout");
+```
+
+Output:
+
+```txt
+[debug] loaded 3 rows
+[info] server started
+[warn] slow request: 120ms
+[error] failed: timeout
 ```
 
-## CMake target
+## Printing
+
+`debug.print` is not a formatter.
+
+It prints values separated by spaces.
 
-```cmake
-rix::debug
+```cpp
+debug.print("Hello", "Rix");
+debug.print(1, 2, 3);
 ```
 
-## Manifest
+Output:
 
 ```txt
-packages/debug/vix.json
+Hello Rix
+1 2 3
 ```
 
-## Role in Rix
+For formatted strings, use `debug.format` or `debug.log`.
 
-Rix does not embed package source code.
+```cpp
+debug.print(debug.format("Hello {}", "Rix"));
+```
 
-The real library lives in:
+## Inspection
 
-```txt
-github.com/rixcpp/debug
+```cpp
+debug.inspect(42);
+
+auto value = debug.inspect.to_string(true);
+
+bool ok = debug.inspect.check(42, 42);
+```
+
+Inspection is useful for debugging values, containers, optional values, variants, and other supported C++ types.
+
+## Independent API
+
+You can also use the free functions directly.
+
+```cpp
+#include <rix/debug.hpp>
+
+int main()
+{
+  rixlib::print("Hello", "Rix");
+
+  auto text = rixlib::format("Package: {}", "rix/debug");
+
+  rixlib::inspect(text);
+
+  return 0;
+}
 ```
 
-The Rix facade mounts this package as:
+## Unified Rix facade
+
+When used through `@rix/rix`, the debug package is mounted under `rix.debug`.
 
 ```cpp
-rix.debug.print(...)
-rix.debug.format(...)
-rix.debug.log(...)
-rix.debug.inspect(...)
+#include <rix.hpp>
+
+int main()
+{
+  rix.debug.print("Hello", "Rix");
+  rix.debug.log("loaded {} rows", 3);
+
+  return 0;
+}
+```
+
+## Design
+
+`@rix/debug` is intentionally small and focused.
+
+It does not try to replace full logging frameworks or formatting libraries. Its role is to provide simple debugging primitives that are easy to use in Rix-based C++ projects.
+
+The package exposes two layers:
+
+```txt
+rixlib::format(...)
+rixlib::print(...)
+rixlib::inspect(...)
 ```
+
+and the object-style API:
+
+```txt
+rixlib::debug::Debug
+```
+
+This keeps the package usable on its own while allowing the unified Rix facade to mount it cleanly as:
+
+```txt
+rix.debug
+```
+
+## Build
+
+```bash
+vix build
+```
+
+## Run example
+
+```bash
+vix run
+```
+
+## Tests
+
+```bash
+vix tests
+```
+
+## License
+
+MIT