react-native-nitro-mlx 0.2.2 → 0.4.0

package/nitrogen/generated/ios/swift/ToolParameter.swift

@@ -0,0 +1,69 @@
+///
+/// ToolParameter.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+import Foundation
+import NitroModules
+
+/**
+ * Represents an instance of `ToolParameter`, backed by a C++ struct.
+ */
+public typealias ToolParameter = margelo.nitro.mlxreactnative.ToolParameter
+
+public extension ToolParameter {
+  private typealias bridge = margelo.nitro.mlxreactnative.bridge.swift
+
+  /**
+   * Create a new instance of `ToolParameter`.
+   */
+  init(name: String, type: String, description: String, required: Bool) {
+    self.init(std.string(name), std.string(type), std.string(description), required)
+  }
+
+  var name: String {
+    @inline(__always)
+    get {
+      return String(self.__name)
+    }
+    @inline(__always)
+    set {
+      self.__name = std.string(newValue)
+    }
+  }
+  
+  var type: String {
+    @inline(__always)
+    get {
+      return String(self.__type)
+    }
+    @inline(__always)
+    set {
+      self.__type = std.string(newValue)
+    }
+  }
+  
+  var description: String {
+    @inline(__always)
+    get {
+      return String(self.__description)
+    }
+    @inline(__always)
+    set {
+      self.__description = std.string(newValue)
+    }
+  }
+  
+  var required: Bool {
+    @inline(__always)
+    get {
+      return self.__required
+    }
+    @inline(__always)
+    set {
+      self.__required = newValue
+    }
+  }
+}

package/nitrogen/generated/shared/c++/GenerationStats.hpp

@@ -2,7 +2,7 @@
 /// GenerationStats.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once
@@ -38,10 +38,11 @@ namespace margelo::nitro::mlxreactnative {
     double tokensPerSecond     SWIFT_PRIVATE;
     double timeToFirstToken     SWIFT_PRIVATE;
     double totalTime     SWIFT_PRIVATE;
+    double toolExecutionTime     SWIFT_PRIVATE;
 
   public:
     GenerationStats() = default;
-    explicit GenerationStats(double tokenCount, double tokensPerSecond, double timeToFirstToken, double totalTime): tokenCount(tokenCount), tokensPerSecond(tokensPerSecond), timeToFirstToken(timeToFirstToken), totalTime(totalTime) {}
+    explicit GenerationStats(double tokenCount, double tokensPerSecond, double timeToFirstToken, double totalTime, double toolExecutionTime): tokenCount(tokenCount), tokensPerSecond(tokensPerSecond), timeToFirstToken(timeToFirstToken), totalTime(totalTime), toolExecutionTime(toolExecutionTime) {}
   };
 
 } // namespace margelo::nitro::mlxreactnative
@@ -57,7 +58,8 @@ namespace margelo::nitro {
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "tokenCount")),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "tokensPerSecond")),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "timeToFirstToken")),
-        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "totalTime"))
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "totalTime")),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "toolExecutionTime"))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::mlxreactnative::GenerationStats& arg) {
@@ -66,6 +68,7 @@ namespace margelo::nitro {
       obj.setProperty(runtime, "tokensPerSecond", JSIConverter<double>::toJSI(runtime, arg.tokensPerSecond));
       obj.setProperty(runtime, "timeToFirstToken", JSIConverter<double>::toJSI(runtime, arg.timeToFirstToken));
       obj.setProperty(runtime, "totalTime", JSIConverter<double>::toJSI(runtime, arg.totalTime));
+      obj.setProperty(runtime, "toolExecutionTime", JSIConverter<double>::toJSI(runtime, arg.toolExecutionTime));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -80,6 +83,7 @@ namespace margelo::nitro {
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "tokensPerSecond"))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "timeToFirstToken"))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "totalTime"))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "toolExecutionTime"))) return false;
       return true;
     }
   };

package/nitrogen/generated/shared/c++/HybridLLMSpec.cpp

@@ -2,7 +2,7 @@
 /// HybridLLMSpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridLLMSpec.hpp"
@@ -24,6 +24,7 @@ namespace margelo::nitro::mlxreactnative {
       prototype.registerHybridMethod("load", &HybridLLMSpec::load);
       prototype.registerHybridMethod("generate", &HybridLLMSpec::generate);
       prototype.registerHybridMethod("stream", &HybridLLMSpec::stream);
+      prototype.registerHybridMethod("streamWithEvents", &HybridLLMSpec::streamWithEvents);
       prototype.registerHybridMethod("stop", &HybridLLMSpec::stop);
       prototype.registerHybridMethod("unload", &HybridLLMSpec::unload);
       prototype.registerHybridMethod("getLastGenerationStats", &HybridLLMSpec::getLastGenerationStats);

package/nitrogen/generated/shared/c++/HybridLLMSpec.hpp

@@ -2,7 +2,7 @@
 /// HybridLLMSpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once
@@ -68,7 +68,8 @@ namespace margelo::nitro::mlxreactnative {
       // Methods
       virtual std::shared_ptr<Promise<void>> load(const std::string& modelId, const std::optional<LLMLoadOptions>& options) = 0;
       virtual std::shared_ptr<Promise<std::string>> generate(const std::string& prompt) = 0;
-      virtual std::shared_ptr<Promise<std::string>> stream(const std::string& prompt, const std::function<void(const std::string& /* token */)>& onToken) = 0;
+      virtual std::shared_ptr<Promise<std::string>> stream(const std::string& prompt, const std::function<void(const std::string& /* token */)>& onToken, const std::optional<std::function<void(const std::string& /* toolName */, const std::string& /* args */)>>& onToolCall) = 0;
+      virtual std::shared_ptr<Promise<std::string>> streamWithEvents(const std::string& prompt, const std::function<void(const std::string& /* eventJson */)>& onEvent) = 0;
       virtual void stop() = 0;
       virtual void unload() = 0;
       virtual GenerationStats getLastGenerationStats() = 0;

package/nitrogen/generated/shared/c++/HybridModelManagerSpec.cpp

@@ -2,7 +2,7 @@
 /// HybridModelManagerSpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #include "HybridModelManagerSpec.hpp"

package/nitrogen/generated/shared/c++/HybridModelManagerSpec.hpp

@@ -2,7 +2,7 @@
 /// HybridModelManagerSpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/nitrogen/generated/shared/c++/HybridSTTSpec.cpp

@@ -0,0 +1,32 @@
+///
+/// HybridSTTSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#include "HybridSTTSpec.hpp"
+
+namespace margelo::nitro::mlxreactnative {
+
+  void HybridSTTSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridGetter("isLoaded", &HybridSTTSpec::getIsLoaded);
+      prototype.registerHybridGetter("isTranscribing", &HybridSTTSpec::getIsTranscribing);
+      prototype.registerHybridGetter("isListening", &HybridSTTSpec::getIsListening);
+      prototype.registerHybridGetter("modelId", &HybridSTTSpec::getModelId);
+      prototype.registerHybridMethod("load", &HybridSTTSpec::load);
+      prototype.registerHybridMethod("transcribe", &HybridSTTSpec::transcribe);
+      prototype.registerHybridMethod("transcribeStream", &HybridSTTSpec::transcribeStream);
+      prototype.registerHybridMethod("startListening", &HybridSTTSpec::startListening);
+      prototype.registerHybridMethod("transcribeBuffer", &HybridSTTSpec::transcribeBuffer);
+      prototype.registerHybridMethod("stopListening", &HybridSTTSpec::stopListening);
+      prototype.registerHybridMethod("stop", &HybridSTTSpec::stop);
+      prototype.registerHybridMethod("unload", &HybridSTTSpec::unload);
+    });
+  }
+
+} // namespace margelo::nitro::mlxreactnative

package/nitrogen/generated/shared/c++/HybridSTTSpec.hpp

@@ -0,0 +1,78 @@
+///
+/// HybridSTTSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `STTLoadOptions` to properly resolve imports.
+namespace margelo::nitro::mlxreactnative { struct STTLoadOptions; }
+
+#include <string>
+#include <NitroModules/Promise.hpp>
+#include "STTLoadOptions.hpp"
+#include <optional>
+#include <NitroModules/ArrayBuffer.hpp>
+#include <functional>
+
+namespace margelo::nitro::mlxreactnative {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `STT`
+   * Inherit this class to create instances of `HybridSTTSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridSTT: public HybridSTTSpec {
+   * public:
+   *   HybridSTT(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridSTTSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridSTTSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridSTTSpec() override = default;
+
+    public:
+      // Properties
+      virtual bool getIsLoaded() = 0;
+      virtual bool getIsTranscribing() = 0;
+      virtual bool getIsListening() = 0;
+      virtual std::string getModelId() = 0;
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<void>> load(const std::string& modelId, const std::optional<STTLoadOptions>& options) = 0;
+      virtual std::shared_ptr<Promise<std::string>> transcribe(const std::shared_ptr<ArrayBuffer>& audio) = 0;
+      virtual std::shared_ptr<Promise<std::string>> transcribeStream(const std::shared_ptr<ArrayBuffer>& audio, const std::function<void(const std::string& /* token */)>& onToken) = 0;
+      virtual std::shared_ptr<Promise<void>> startListening() = 0;
+      virtual std::shared_ptr<Promise<std::string>> transcribeBuffer() = 0;
+      virtual std::shared_ptr<Promise<std::string>> stopListening() = 0;
+      virtual void stop() = 0;
+      virtual void unload() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "STT";
+  };
+
+} // namespace margelo::nitro::mlxreactnative

package/nitrogen/generated/shared/c++/HybridTTSSpec.cpp

@@ -0,0 +1,29 @@
+///
+/// HybridTTSSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#include "HybridTTSSpec.hpp"
+
+namespace margelo::nitro::mlxreactnative {
+
+  void HybridTTSSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridGetter("isLoaded", &HybridTTSSpec::getIsLoaded);
+      prototype.registerHybridGetter("isGenerating", &HybridTTSSpec::getIsGenerating);
+      prototype.registerHybridGetter("modelId", &HybridTTSSpec::getModelId);
+      prototype.registerHybridGetter("sampleRate", &HybridTTSSpec::getSampleRate);
+      prototype.registerHybridMethod("load", &HybridTTSSpec::load);
+      prototype.registerHybridMethod("generate", &HybridTTSSpec::generate);
+      prototype.registerHybridMethod("stream", &HybridTTSSpec::stream);
+      prototype.registerHybridMethod("stop", &HybridTTSSpec::stop);
+      prototype.registerHybridMethod("unload", &HybridTTSSpec::unload);
+    });
+  }
+
+} // namespace margelo::nitro::mlxreactnative

package/nitrogen/generated/shared/c++/HybridTTSSpec.hpp

@@ -0,0 +1,78 @@
+///
+/// HybridTTSSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `TTSLoadOptions` to properly resolve imports.
+namespace margelo::nitro::mlxreactnative { struct TTSLoadOptions; }
+// Forward declaration of `TTSGenerateOptions` to properly resolve imports.
+namespace margelo::nitro::mlxreactnative { struct TTSGenerateOptions; }
+
+#include <string>
+#include <NitroModules/Promise.hpp>
+#include "TTSLoadOptions.hpp"
+#include <optional>
+#include <NitroModules/ArrayBuffer.hpp>
+#include "TTSGenerateOptions.hpp"
+#include <functional>
+
+namespace margelo::nitro::mlxreactnative {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `TTS`
+   * Inherit this class to create instances of `HybridTTSSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridTTS: public HybridTTSSpec {
+   * public:
+   *   HybridTTS(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridTTSSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridTTSSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridTTSSpec() override = default;
+
+    public:
+      // Properties
+      virtual bool getIsLoaded() = 0;
+      virtual bool getIsGenerating() = 0;
+      virtual std::string getModelId() = 0;
+      virtual double getSampleRate() = 0;
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<void>> load(const std::string& modelId, const std::optional<TTSLoadOptions>& options) = 0;
+      virtual std::shared_ptr<Promise<std::shared_ptr<ArrayBuffer>>> generate(const std::string& text, const std::optional<TTSGenerateOptions>& options) = 0;
+      virtual std::shared_ptr<Promise<void>> stream(const std::string& text, const std::function<void(const std::shared_ptr<ArrayBuffer>& /* audio */)>& onAudioChunk, const std::optional<TTSGenerateOptions>& options) = 0;
+      virtual void stop() = 0;
+      virtual void unload() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "TTS";
+  };
+
+} // namespace margelo::nitro::mlxreactnative

package/nitrogen/generated/shared/c++/LLMLoadOptions.hpp

@@ -2,7 +2,7 @@
 /// LLMLoadOptions.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once
@@ -25,11 +25,14 @@
 
 // Forward declaration of `LLMMessage` to properly resolve imports.
 namespace margelo::nitro::mlxreactnative { struct LLMMessage; }
+// Forward declaration of `ToolDefinition` to properly resolve imports.
+namespace margelo::nitro::mlxreactnative { struct ToolDefinition; }
 
 #include <functional>
 #include <optional>
 #include "LLMMessage.hpp"
 #include <vector>
+#include "ToolDefinition.hpp"
 
 namespace margelo::nitro::mlxreactnative {
 
@@ -41,10 +44,11 @@ namespace margelo::nitro::mlxreactnative {
     std::optional<std::function<void(double /* progress */)>> onProgress     SWIFT_PRIVATE;
     std::optional<std::vector<LLMMessage>> additionalContext     SWIFT_PRIVATE;
     std::optional<bool> manageHistory     SWIFT_PRIVATE;
+    std::optional<std::vector<ToolDefinition>> tools     SWIFT_PRIVATE;
 
   public:
     LLMLoadOptions() = default;
-    explicit LLMLoadOptions(std::optional<std::function<void(double /* progress */)>> onProgress, std::optional<std::vector<LLMMessage>> additionalContext, std::optional<bool> manageHistory): onProgress(onProgress), additionalContext(additionalContext), manageHistory(manageHistory) {}
+    explicit LLMLoadOptions(std::optional<std::function<void(double /* progress */)>> onProgress, std::optional<std::vector<LLMMessage>> additionalContext, std::optional<bool> manageHistory, std::optional<std::vector<ToolDefinition>> tools): onProgress(onProgress), additionalContext(additionalContext), manageHistory(manageHistory), tools(tools) {}
   };
 
 } // namespace margelo::nitro::mlxreactnative
@@ -59,7 +63,8 @@ namespace margelo::nitro {
       return margelo::nitro::mlxreactnative::LLMLoadOptions(
         JSIConverter<std::optional<std::function<void(double)>>>::fromJSI(runtime, obj.getProperty(runtime, "onProgress")),
         JSIConverter<std::optional<std::vector<margelo::nitro::mlxreactnative::LLMMessage>>>::fromJSI(runtime, obj.getProperty(runtime, "additionalContext")),
-        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "manageHistory"))
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "manageHistory")),
+        JSIConverter<std::optional<std::vector<margelo::nitro::mlxreactnative::ToolDefinition>>>::fromJSI(runtime, obj.getProperty(runtime, "tools"))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::mlxreactnative::LLMLoadOptions& arg) {
@@ -67,6 +72,7 @@ namespace margelo::nitro {
       obj.setProperty(runtime, "onProgress", JSIConverter<std::optional<std::function<void(double)>>>::toJSI(runtime, arg.onProgress));
       obj.setProperty(runtime, "additionalContext", JSIConverter<std::optional<std::vector<margelo::nitro::mlxreactnative::LLMMessage>>>::toJSI(runtime, arg.additionalContext));
       obj.setProperty(runtime, "manageHistory", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.manageHistory));
+      obj.setProperty(runtime, "tools", JSIConverter<std::optional<std::vector<margelo::nitro::mlxreactnative::ToolDefinition>>>::toJSI(runtime, arg.tools));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -80,6 +86,7 @@ namespace margelo::nitro {
       if (!JSIConverter<std::optional<std::function<void(double)>>>::canConvert(runtime, obj.getProperty(runtime, "onProgress"))) return false;
       if (!JSIConverter<std::optional<std::vector<margelo::nitro::mlxreactnative::LLMMessage>>>::canConvert(runtime, obj.getProperty(runtime, "additionalContext"))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "manageHistory"))) return false;
+      if (!JSIConverter<std::optional<std::vector<margelo::nitro::mlxreactnative::ToolDefinition>>>::canConvert(runtime, obj.getProperty(runtime, "tools"))) return false;
       return true;
     }
   };

package/nitrogen/generated/shared/c++/LLMMessage.hpp

@@ -2,7 +2,7 @@
 /// LLMMessage.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/nitrogen/generated/shared/c++/STTLoadOptions.hpp

@@ -0,0 +1,76 @@
+///
+/// STTLoadOptions.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <functional>
+#include <optional>
+
+namespace margelo::nitro::mlxreactnative {
+
+  /**
+   * A struct which can be represented as a JavaScript object (STTLoadOptions).
+   */
+  struct STTLoadOptions {
+  public:
+    std::optional<std::function<void(double /* progress */)>> onProgress     SWIFT_PRIVATE;
+
+  public:
+    STTLoadOptions() = default;
+    explicit STTLoadOptions(std::optional<std::function<void(double /* progress */)>> onProgress): onProgress(onProgress) {}
+  };
+
+} // namespace margelo::nitro::mlxreactnative
+
+namespace margelo::nitro {
+
+  // C++ STTLoadOptions <> JS STTLoadOptions (object)
+  template <>
+  struct JSIConverter<margelo::nitro::mlxreactnative::STTLoadOptions> final {
+    static inline margelo::nitro::mlxreactnative::STTLoadOptions fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::mlxreactnative::STTLoadOptions(
+        JSIConverter<std::optional<std::function<void(double)>>>::fromJSI(runtime, obj.getProperty(runtime, "onProgress"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::mlxreactnative::STTLoadOptions& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "onProgress", JSIConverter<std::optional<std::function<void(double)>>>::toJSI(runtime, arg.onProgress));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::optional<std::function<void(double)>>>::canConvert(runtime, obj.getProperty(runtime, "onProgress"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/TTSGenerateOptions.hpp

@@ -0,0 +1,80 @@
+///
+/// TTSGenerateOptions.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+#include <optional>
+
+namespace margelo::nitro::mlxreactnative {
+
+  /**
+   * A struct which can be represented as a JavaScript object (TTSGenerateOptions).
+   */
+  struct TTSGenerateOptions {
+  public:
+    std::optional<std::string> voice     SWIFT_PRIVATE;
+    std::optional<double> speed     SWIFT_PRIVATE;
+
+  public:
+    TTSGenerateOptions() = default;
+    explicit TTSGenerateOptions(std::optional<std::string> voice, std::optional<double> speed): voice(voice), speed(speed) {}
+  };
+
+} // namespace margelo::nitro::mlxreactnative
+
+namespace margelo::nitro {
+
+  // C++ TTSGenerateOptions <> JS TTSGenerateOptions (object)
+  template <>
+  struct JSIConverter<margelo::nitro::mlxreactnative::TTSGenerateOptions> final {
+    static inline margelo::nitro::mlxreactnative::TTSGenerateOptions fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::mlxreactnative::TTSGenerateOptions(
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "voice")),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "speed"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::mlxreactnative::TTSGenerateOptions& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "voice", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.voice));
+      obj.setProperty(runtime, "speed", JSIConverter<std::optional<double>>::toJSI(runtime, arg.speed));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "voice"))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "speed"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro