feat(ios): add HTML renderer (#110)

* feat(renderer): add html/plaintext rendering pipeline

* feat(example): add tabbed demo screens

* feat(ios): expand native fragment handling

* chore: update lockfiles

* docs: add html renderer usage

Author: patrickkabwe

README.md

@@ -83,6 +83,26 @@ export function SelectionExample() {
 }
 ```
 
+## HTML rendering
+
+NitroText can parse HTML string children and inline CSS when you pass `renderer="html"`.
+
+```tsx
+import { NitroText } from 'react-native-nitro-text'
+
+export function HtmlExample() {
+  const html = `
+    <div>
+      <h2>Renderer demo</h2>
+      <p>This text comes from <strong>HTML</strong> with <em>semantic</em> tags.</p>
+      <p><span style="color: #ff6347; font-weight: bold;">Inline CSS works too.</span></p>
+    </div>
+  `
+
+  return <NitroText renderer="html">{html}</NitroText>
+}
+```
+
 ## Platform Support
 
 - iOS

bun.lock

@@ -0,0 +1,96 @@
+//
+// NitroTextLogger.hpp
+// 
+//
+
+#pragma once
+
+#include <string>
+#include <sstream>
+#include <iostream>
+
+// Check if we're in debug mode
+#ifndef NDEBUG
+#define NITRO_TEXT_DEBUG_LOGGING 1
+#else
+#define NITRO_TEXT_DEBUG_LOGGING 0
+#endif
+
+namespace margelo::nitro::nitrotext::logger {
+
+/**
+ * @brief Logs an informational message
+ * @param message The message to log
+ * @param tag Optional tag identifier for categorization
+ * 
+ * Only logs in debug builds to avoid performance overhead in production
+ */
+inline void info(
+    const std::string& message,
+    const std::string& tag = "") {
+#if NITRO_TEXT_DEBUG_LOGGING
+  std::ostringstream oss;
+  oss << "[NitroText]";
+  if (!tag.empty()) {
+    oss << " [" << tag << "]";
+  }
+  oss << " " << message;
+  std::cout << oss.str() << std::endl;
+#else
+  // No-op in release builds
+  (void)message;
+  (void)tag;
+#endif
+}
+
+/**
+ * @brief Logs a warning message
+ * @param message The warning message to log
+ * @param tag Optional tag identifier for categorization
+ * 
+ * Only logs in debug builds to avoid performance overhead in production
+ */
+inline void warn(
+    const std::string& message,
+    const std::string& tag = "") {
+#if NITRO_TEXT_DEBUG_LOGGING
+  std::ostringstream oss;
+  oss << "[NitroText] [WARN]";
+  if (!tag.empty()) {
+    oss << " [" << tag << "]";
+  }
+  oss << " " << message;
+  std::cerr << oss.str() << std::endl;
+#else
+  // No-op in release builds
+  (void)message;
+  (void)tag;
+#endif
+}
+
+/**
+ * @brief Logs an error message
+ * @param message The error message to log
+ * @param tag Optional tag identifier for categorization
+ * 
+ * Only logs in debug builds to avoid performance overhead in production
+ */
+inline void error(
+    const std::string& message,
+    const std::string& tag = "") {
+#if NITRO_TEXT_DEBUG_LOGGING
+  std::ostringstream oss;
+  oss << "[NitroText] [ERROR]";
+  if (!tag.empty()) {
+    oss << " [" << tag << "]";
+  }
+  oss << " " << message;
+  std::cerr << oss.str() << std::endl;
+#else
+  // No-op in release builds
+  (void)message;
+  (void)tag;
+#endif
+}
+
+} // namespace margelo::nitro::nitrotext::logger