react-native-nitro-mlx 0.3.0 → 0.4.0

package/nitrogen/generated/ios/swift/HybridTTSSpec_cxx.swift

@@ -0,0 +1,229 @@
+///
+/// HybridTTSSpec_cxx.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
+
+/**
+ * A class implementation that bridges HybridTTSSpec over to C++.
+ * In C++, we cannot use Swift protocols - so we need to wrap it in a class to make it strongly defined.
+ *
+ * Also, some Swift types need to be bridged with special handling:
+ * - Enums need to be wrapped in Structs, otherwise they cannot be accessed bi-directionally (Swift bug: https://github.com/swiftlang/swift/issues/75330)
+ * - Other HybridObjects need to be wrapped/unwrapped from the Swift TCxx wrapper
+ * - Throwing methods need to be wrapped with a Result<T, Error> type, as exceptions cannot be propagated to C++
+ */
+open class HybridTTSSpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::mlxreactnative::bridge::swift`)
+   * from `MLXReactNative-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.mlxreactnative.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridTTSSpec` Swift protocol.
+   */
+  private var __implementation: any HybridTTSSpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_HybridTTSSpec_
+
+  /**
+   * Create a new `HybridTTSSpec_cxx` that wraps the given `HybridTTSSpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridTTSSpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridTTSSpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridTTSSpec() -> any HybridTTSSpec {
+    return __implementation
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `HybridTTSSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridTTSSpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridTTSSpec_cxx {
+    return Unmanaged<HybridTTSSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<HybridTTSSpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridTTSSpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if Bool(fromCxx: cachedCxxPart) {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_HybridTTSSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridTTSSpec_(newCxxPart)
+      return newCxxPart
+    }
+  }
+
+  
+
+  /**
+   * Get the memory size of the Swift class (plus size of any other allocations)
+   * so the JS VM can properly track it and garbage-collect the JS object if needed.
+   */
+  @inline(__always)
+  public var memorySize: Int {
+    return MemoryHelper.getSizeOf(self.__implementation) + self.__implementation.memorySize
+  }
+
+  /**
+   * Call dispose() on the Swift class.
+   * This _may_ be called manually from JS.
+   */
+  @inline(__always)
+  public func dispose() {
+    self.__implementation.dispose()
+  }
+
+  /**
+   * Call toString() on the Swift class.
+   */
+  @inline(__always)
+  public func toString() -> String {
+    return self.__implementation.toString()
+  }
+
+  // Properties
+  public final var isLoaded: Bool {
+    @inline(__always)
+    get {
+      return self.__implementation.isLoaded
+    }
+  }
+  
+  public final var isGenerating: Bool {
+    @inline(__always)
+    get {
+      return self.__implementation.isGenerating
+    }
+  }
+  
+  public final var modelId: std.string {
+    @inline(__always)
+    get {
+      return std.string(self.__implementation.modelId)
+    }
+  }
+  
+  public final var sampleRate: Double {
+    @inline(__always)
+    get {
+      return self.__implementation.sampleRate
+    }
+  }
+
+  // Methods
+  @inline(__always)
+  public final func load(modelId: std.string, options: bridge.std__optional_TTSLoadOptions_) -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.load(modelId: String(modelId), options: options.value)
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func generate(text: std.string, options: bridge.std__optional_TTSGenerateOptions_) -> bridge.Result_std__shared_ptr_Promise_std__shared_ptr_ArrayBuffer____ {
+    do {
+      let __result = try self.__implementation.generate(text: String(text), options: options.value)
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__shared_ptr_ArrayBuffer___ in
+        let __promise = bridge.create_std__shared_ptr_Promise_std__shared_ptr_ArrayBuffer___()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__shared_ptr_ArrayBuffer___(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(__result.getArrayBuffer()) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_std__shared_ptr_ArrayBuffer____(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_std__shared_ptr_ArrayBuffer____(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func stream(text: std.string, onAudioChunk: bridge.Func_void_std__shared_ptr_ArrayBuffer_, options: bridge.std__optional_TTSGenerateOptions_) -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.stream(text: String(text), onAudioChunk: { () -> (ArrayBuffer) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_std__shared_ptr_ArrayBuffer_(onAudioChunk)
+        return { (__audio: ArrayBuffer) -> Void in
+          __wrappedFunction.call(__audio)
+        }
+      }(), options: options.value)
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func stop() -> bridge.Result_void_ {
+    do {
+      try self.__implementation.stop()
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func unload() -> bridge.Result_void_ {
+    do {
+      try self.__implementation.unload()
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+}

package/nitrogen/generated/ios/swift/STTLoadOptions.swift

@@ -0,0 +1,66 @@
+///
+/// STTLoadOptions.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 `STTLoadOptions`, backed by a C++ struct.
+ */
+public typealias STTLoadOptions = margelo.nitro.mlxreactnative.STTLoadOptions
+
+public extension STTLoadOptions {
+  private typealias bridge = margelo.nitro.mlxreactnative.bridge.swift
+
+  /**
+   * Create a new instance of `STTLoadOptions`.
+   */
+  init(onProgress: ((_ progress: Double) -> Void)?) {
+    self.init({ () -> bridge.std__optional_std__function_void_double____progress______ in
+      if let __unwrappedValue = onProgress {
+        return bridge.create_std__optional_std__function_void_double____progress______({ () -> bridge.Func_void_double in
+          let __closureWrapper = Func_void_double(__unwrappedValue)
+          return bridge.create_Func_void_double(__closureWrapper.toUnsafe())
+        }())
+      } else {
+        return .init()
+      }
+    }())
+  }
+
+  var onProgress: ((_ progress: Double) -> Void)? {
+    @inline(__always)
+    get {
+      return { () -> ((_ progress: Double) -> Void)? in
+        if bridge.has_value_std__optional_std__function_void_double____progress______(self.__onProgress) {
+          let __unwrapped = bridge.get_std__optional_std__function_void_double____progress______(self.__onProgress)
+          return { () -> (Double) -> Void in
+            let __wrappedFunction = bridge.wrap_Func_void_double(__unwrapped)
+            return { (__progress: Double) -> Void in
+              __wrappedFunction.call(__progress)
+            }
+          }()
+        } else {
+          return nil
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__onProgress = { () -> bridge.std__optional_std__function_void_double____progress______ in
+        if let __unwrappedValue = newValue {
+          return bridge.create_std__optional_std__function_void_double____progress______({ () -> bridge.Func_void_double in
+            let __closureWrapper = Func_void_double(__unwrappedValue)
+            return bridge.create_Func_void_double(__closureWrapper.toUnsafe())
+          }())
+        } else {
+          return .init()
+        }
+      }()
+    }
+  }
+}

package/nitrogen/generated/ios/swift/TTSGenerateOptions.swift

@@ -0,0 +1,78 @@
+///
+/// TTSGenerateOptions.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 `TTSGenerateOptions`, backed by a C++ struct.
+ */
+public typealias TTSGenerateOptions = margelo.nitro.mlxreactnative.TTSGenerateOptions
+
+public extension TTSGenerateOptions {
+  private typealias bridge = margelo.nitro.mlxreactnative.bridge.swift
+
+  /**
+   * Create a new instance of `TTSGenerateOptions`.
+   */
+  init(voice: String?, speed: Double?) {
+    self.init({ () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = voice {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_double_ in
+      if let __unwrappedValue = speed {
+        return bridge.create_std__optional_double_(__unwrappedValue)
+      } else {
+        return .init()
+      }
+    }())
+  }
+
+  var voice: String? {
+    @inline(__always)
+    get {
+      return { () -> String? in
+        if bridge.has_value_std__optional_std__string_(self.__voice) {
+          let __unwrapped = bridge.get_std__optional_std__string_(self.__voice)
+          return String(__unwrapped)
+        } else {
+          return nil
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__voice = { () -> bridge.std__optional_std__string_ in
+        if let __unwrappedValue = newValue {
+          return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+        } else {
+          return .init()
+        }
+      }()
+    }
+  }
+  
+  var speed: Double? {
+    @inline(__always)
+    get {
+      return self.__speed.value
+    }
+    @inline(__always)
+    set {
+      self.__speed = { () -> bridge.std__optional_double_ in
+        if let __unwrappedValue = newValue {
+          return bridge.create_std__optional_double_(__unwrappedValue)
+        } else {
+          return .init()
+        }
+      }()
+    }
+  }
+}

package/nitrogen/generated/ios/swift/TTSLoadOptions.swift

@@ -0,0 +1,66 @@
+///
+/// TTSLoadOptions.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 `TTSLoadOptions`, backed by a C++ struct.
+ */
+public typealias TTSLoadOptions = margelo.nitro.mlxreactnative.TTSLoadOptions
+
+public extension TTSLoadOptions {
+  private typealias bridge = margelo.nitro.mlxreactnative.bridge.swift
+
+  /**
+   * Create a new instance of `TTSLoadOptions`.
+   */
+  init(onProgress: ((_ progress: Double) -> Void)?) {
+    self.init({ () -> bridge.std__optional_std__function_void_double____progress______ in
+      if let __unwrappedValue = onProgress {
+        return bridge.create_std__optional_std__function_void_double____progress______({ () -> bridge.Func_void_double in
+          let __closureWrapper = Func_void_double(__unwrappedValue)
+          return bridge.create_Func_void_double(__closureWrapper.toUnsafe())
+        }())
+      } else {
+        return .init()
+      }
+    }())
+  }
+
+  var onProgress: ((_ progress: Double) -> Void)? {
+    @inline(__always)
+    get {
+      return { () -> ((_ progress: Double) -> Void)? in
+        if bridge.has_value_std__optional_std__function_void_double____progress______(self.__onProgress) {
+          let __unwrapped = bridge.get_std__optional_std__function_void_double____progress______(self.__onProgress)
+          return { () -> (Double) -> Void in
+            let __wrappedFunction = bridge.wrap_Func_void_double(__unwrapped)
+            return { (__progress: Double) -> Void in
+              __wrappedFunction.call(__progress)
+            }
+          }()
+        } else {
+          return nil
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__onProgress = { () -> bridge.std__optional_std__function_void_double____progress______ in
+        if let __unwrappedValue = newValue {
+          return bridge.create_std__optional_std__function_void_double____progress______({ () -> bridge.Func_void_double in
+            let __closureWrapper = Func_void_double(__unwrappedValue)
+            return bridge.create_Func_void_double(__closureWrapper.toUnsafe())
+          }())
+        } else {
+          return .init()
+        }
+      }()
+    }
+  }
+}

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

@@ -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

@@ -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

@@ -69,6 +69,7 @@ namespace margelo::nitro::mlxreactnative {
       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, 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++/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