@gmessier/nitro-speech 0.0.1

package/nitrogen/generated/ios/c++/HybridNitroSpeechSpecSwift.hpp

@@ -0,0 +1,77 @@
+///
+/// HybridNitroSpeechSpecSwift.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include "HybridNitroSpeechSpec.hpp"
+
+// Forward declaration of `HybridNitroSpeechSpec_cxx` to properly resolve imports.
+namespace NitroSpeech { class HybridNitroSpeechSpec_cxx; }
+
+// Forward declaration of `HybridRecognizerSpec` to properly resolve imports.
+namespace margelo::nitro::nitrospeech { class HybridRecognizerSpec; }
+
+#include <memory>
+#include "HybridRecognizerSpec.hpp"
+
+#include "NitroSpeech-Swift-Cxx-Umbrella.hpp"
+
+namespace margelo::nitro::nitrospeech {
+
+  /**
+   * The C++ part of HybridNitroSpeechSpec_cxx.swift.
+   *
+   * HybridNitroSpeechSpecSwift (C++) accesses HybridNitroSpeechSpec_cxx (Swift), and might
+   * contain some additional bridging code for C++ <> Swift interop.
+   *
+   * Since this obviously introduces an overhead, I hope at some point in
+   * the future, HybridNitroSpeechSpec_cxx can directly inherit from the C++ class HybridNitroSpeechSpec
+   * to simplify the whole structure and memory management.
+   */
+  class HybridNitroSpeechSpecSwift: public virtual HybridNitroSpeechSpec {
+  public:
+    // Constructor from a Swift instance
+    explicit HybridNitroSpeechSpecSwift(const NitroSpeech::HybridNitroSpeechSpec_cxx& swiftPart):
+      HybridObject(HybridNitroSpeechSpec::TAG),
+      _swiftPart(swiftPart) { }
+
+  public:
+    // Get the Swift part
+    inline NitroSpeech::HybridNitroSpeechSpec_cxx& getSwiftPart() noexcept {
+      return _swiftPart;
+    }
+
+  public:
+    inline size_t getExternalMemorySize() noexcept override {
+      return _swiftPart.getMemorySize();
+    }
+    void dispose() noexcept override {
+      _swiftPart.dispose();
+    }
+    std::string toString() override {
+      return _swiftPart.toString();
+    }
+
+  public:
+    // Properties
+    inline std::shared_ptr<HybridRecognizerSpec> getRecognizer() noexcept override {
+      auto __result = _swiftPart.getRecognizer();
+      return __result;
+    }
+    inline void setRecognizer(const std::shared_ptr<HybridRecognizerSpec>& recognizer) noexcept override {
+      _swiftPart.setRecognizer(recognizer);
+    }
+
+  public:
+    // Methods
+    
+
+  private:
+    NitroSpeech::HybridNitroSpeechSpec_cxx _swiftPart;
+  };
+
+} // namespace margelo::nitro::nitrospeech

package/nitrogen/generated/ios/c++/HybridRecognizerSpecSwift.cpp

@@ -0,0 +1,11 @@
+///
+/// HybridRecognizerSpecSwift.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#include "HybridRecognizerSpecSwift.hpp"
+
+namespace margelo::nitro::nitrospeech {
+} // namespace margelo::nitro::nitrospeech

package/nitrogen/generated/ios/c++/HybridRecognizerSpecSwift.hpp

@@ -0,0 +1,126 @@
+///
+/// HybridRecognizerSpecSwift.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include "HybridRecognizerSpec.hpp"
+
+// Forward declaration of `HybridRecognizerSpec_cxx` to properly resolve imports.
+namespace NitroSpeech { class HybridRecognizerSpec_cxx; }
+
+// Forward declaration of `SpeechToTextParams` to properly resolve imports.
+namespace margelo::nitro::nitrospeech { struct SpeechToTextParams; }
+
+#include <functional>
+#include <optional>
+#include <string>
+#include <vector>
+#include "SpeechToTextParams.hpp"
+
+#include "NitroSpeech-Swift-Cxx-Umbrella.hpp"
+
+namespace margelo::nitro::nitrospeech {
+
+  /**
+   * The C++ part of HybridRecognizerSpec_cxx.swift.
+   *
+   * HybridRecognizerSpecSwift (C++) accesses HybridRecognizerSpec_cxx (Swift), and might
+   * contain some additional bridging code for C++ <> Swift interop.
+   *
+   * Since this obviously introduces an overhead, I hope at some point in
+   * the future, HybridRecognizerSpec_cxx can directly inherit from the C++ class HybridRecognizerSpec
+   * to simplify the whole structure and memory management.
+   */
+  class HybridRecognizerSpecSwift: public virtual HybridRecognizerSpec {
+  public:
+    // Constructor from a Swift instance
+    explicit HybridRecognizerSpecSwift(const NitroSpeech::HybridRecognizerSpec_cxx& swiftPart):
+      HybridObject(HybridRecognizerSpec::TAG),
+      _swiftPart(swiftPart) { }
+
+  public:
+    // Get the Swift part
+    inline NitroSpeech::HybridRecognizerSpec_cxx& getSwiftPart() noexcept {
+      return _swiftPart;
+    }
+
+  public:
+    inline size_t getExternalMemorySize() noexcept override {
+      return _swiftPart.getMemorySize();
+    }
+    void dispose() noexcept override {
+      _swiftPart.dispose();
+    }
+    std::string toString() override {
+      return _swiftPart.toString();
+    }
+
+  public:
+    // Properties
+    inline std::optional<std::function<void()>> getOnReadyForSpeech() noexcept override {
+      auto __result = _swiftPart.getOnReadyForSpeech();
+      return __result;
+    }
+    inline void setOnReadyForSpeech(const std::optional<std::function<void()>>& onReadyForSpeech) noexcept override {
+      _swiftPart.setOnReadyForSpeech(onReadyForSpeech);
+    }
+    inline std::optional<std::function<void()>> getOnRecordingStopped() noexcept override {
+      auto __result = _swiftPart.getOnRecordingStopped();
+      return __result;
+    }
+    inline void setOnRecordingStopped(const std::optional<std::function<void()>>& onRecordingStopped) noexcept override {
+      _swiftPart.setOnRecordingStopped(onRecordingStopped);
+    }
+    inline std::optional<std::function<void(const std::vector<std::string>& /* resultBatches */)>> getOnResult() noexcept override {
+      auto __result = _swiftPart.getOnResult();
+      return __result;
+    }
+    inline void setOnResult(const std::optional<std::function<void(const std::vector<std::string>& /* resultBatches */)>>& onResult) noexcept override {
+      _swiftPart.setOnResult(onResult);
+    }
+    inline std::optional<std::function<void(double /* timeLeftMs */)>> getOnAutoFinishProgress() noexcept override {
+      auto __result = _swiftPart.getOnAutoFinishProgress();
+      return __result;
+    }
+    inline void setOnAutoFinishProgress(const std::optional<std::function<void(double /* timeLeftMs */)>>& onAutoFinishProgress) noexcept override {
+      _swiftPart.setOnAutoFinishProgress(onAutoFinishProgress);
+    }
+    inline std::optional<std::function<void(const std::string& /* message */)>> getOnError() noexcept override {
+      auto __result = _swiftPart.getOnError();
+      return __result;
+    }
+    inline void setOnError(const std::optional<std::function<void(const std::string& /* message */)>>& onError) noexcept override {
+      _swiftPart.setOnError(onError);
+    }
+    inline std::optional<std::function<void()>> getOnPermissionDenied() noexcept override {
+      auto __result = _swiftPart.getOnPermissionDenied();
+      return __result;
+    }
+    inline void setOnPermissionDenied(const std::optional<std::function<void()>>& onPermissionDenied) noexcept override {
+      _swiftPart.setOnPermissionDenied(onPermissionDenied);
+    }
+
+  public:
+    // Methods
+    inline void startListening(const SpeechToTextParams& params) override {
+      auto __result = _swiftPart.startListening(std::forward<decltype(params)>(params));
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
+    inline void stopListening() override {
+      auto __result = _swiftPart.stopListening();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
+
+  private:
+    NitroSpeech::HybridRecognizerSpec_cxx _swiftPart;
+  };
+
+} // namespace margelo::nitro::nitrospeech

package/nitrogen/generated/ios/swift/Func_void.swift

@@ -0,0 +1,47 @@
+///
+/// Func_void.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
+
+/**
+ * Wraps a Swift `() -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void {
+  public typealias bridge = margelo.nitro.nitrospeech.bridge.swift
+
+  private let closure: () -> Void
+
+  public init(_ closure: @escaping () -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call() -> Void {
+    self.closure()
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void {
+    return Unmanaged<Func_void>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/Func_void_double.swift

@@ -0,0 +1,47 @@
+///
+/// Func_void_double.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
+
+/**
+ * Wraps a Swift `(_ timeLeftMs: Double) -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void_double {
+  public typealias bridge = margelo.nitro.nitrospeech.bridge.swift
+
+  private let closure: (_ timeLeftMs: Double) -> Void
+
+  public init(_ closure: @escaping (_ timeLeftMs: Double) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(timeLeftMs: Double) -> Void {
+    self.closure(timeLeftMs)
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void_double`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_double>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_double {
+    return Unmanaged<Func_void_double>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/Func_void_std__string.swift

@@ -0,0 +1,47 @@
+///
+/// Func_void_std__string.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
+
+/**
+ * Wraps a Swift `(_ message: String) -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void_std__string {
+  public typealias bridge = margelo.nitro.nitrospeech.bridge.swift
+
+  private let closure: (_ message: String) -> Void
+
+  public init(_ closure: @escaping (_ message: String) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(message: std.string) -> Void {
+    self.closure(String(message))
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void_std__string`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_std__string>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_std__string {
+    return Unmanaged<Func_void_std__string>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/Func_void_std__vector_std__string_.swift

@@ -0,0 +1,47 @@
+///
+/// Func_void_std__vector_std__string_.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
+
+/**
+ * Wraps a Swift `(_ resultBatches: [String]) -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void_std__vector_std__string_ {
+  public typealias bridge = margelo.nitro.nitrospeech.bridge.swift
+
+  private let closure: (_ resultBatches: [String]) -> Void
+
+  public init(_ closure: @escaping (_ resultBatches: [String]) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(resultBatches: bridge.std__vector_std__string_) -> Void {
+    self.closure(resultBatches.map({ __item in String(__item) }))
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void_std__vector_std__string_`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_std__vector_std__string_>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_std__vector_std__string_ {
+    return Unmanaged<Func_void_std__vector_std__string_>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/HybridNitroSpeechSpec.swift

@@ -0,0 +1,56 @@
+///
+/// HybridNitroSpeechSpec.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
+
+/// See ``HybridNitroSpeechSpec``
+public protocol HybridNitroSpeechSpec_protocol: HybridObject {
+  // Properties
+  var recognizer: (any HybridRecognizerSpec) { get set }
+
+  // Methods
+  
+}
+
+public extension HybridNitroSpeechSpec_protocol {
+  /// Default implementation of ``HybridObject.toString``
+  func toString() -> String {
+    return "[HybridObject NitroSpeech]"
+  }
+}
+
+/// See ``HybridNitroSpeechSpec``
+open class HybridNitroSpeechSpec_base {
+  private weak var cxxWrapper: HybridNitroSpeechSpec_cxx? = nil
+  public init() { }
+  public func getCxxWrapper() -> HybridNitroSpeechSpec_cxx {
+  #if DEBUG
+    guard self is HybridNitroSpeechSpec else {
+      fatalError("`self` is not a `HybridNitroSpeechSpec`! Did you accidentally inherit from `HybridNitroSpeechSpec_base` instead of `HybridNitroSpeechSpec`?")
+    }
+  #endif
+    if let cxxWrapper = self.cxxWrapper {
+      return cxxWrapper
+    } else {
+      let cxxWrapper = HybridNitroSpeechSpec_cxx(self as! HybridNitroSpeechSpec)
+      self.cxxWrapper = cxxWrapper
+      return cxxWrapper
+    }
+  }
+}
+
+/**
+ * A Swift base-protocol representing the NitroSpeech HybridObject.
+ * Implement this protocol to create Swift-based instances of NitroSpeech.
+ * ```swift
+ * class HybridNitroSpeech : HybridNitroSpeechSpec {
+ *   // ...
+ * }
+ * ```
+ */
+public typealias HybridNitroSpeechSpec = HybridNitroSpeechSpec_protocol & HybridNitroSpeechSpec_base

package/nitrogen/generated/ios/swift/HybridNitroSpeechSpec_cxx.swift

@@ -0,0 +1,137 @@
+///
+/// HybridNitroSpeechSpec_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 HybridNitroSpeechSpec 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 HybridNitroSpeechSpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::nitrospeech::bridge::swift`)
+   * from `NitroSpeech-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.nitrospeech.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridNitroSpeechSpec` Swift protocol.
+   */
+  private var __implementation: any HybridNitroSpeechSpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_HybridNitroSpeechSpec_
+
+  /**
+   * Create a new `HybridNitroSpeechSpec_cxx` that wraps the given `HybridNitroSpeechSpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridNitroSpeechSpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridNitroSpeechSpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridNitroSpeechSpec() -> any HybridNitroSpeechSpec {
+    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 `HybridNitroSpeechSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridNitroSpeechSpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridNitroSpeechSpec_cxx {
+    return Unmanaged<HybridNitroSpeechSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<HybridNitroSpeechSpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridNitroSpeechSpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if Bool(fromCxx: cachedCxxPart) {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_HybridNitroSpeechSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridNitroSpeechSpec_(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 recognizer: bridge.std__shared_ptr_HybridRecognizerSpec_ {
+    @inline(__always)
+    get {
+      return { () -> bridge.std__shared_ptr_HybridRecognizerSpec_ in
+        let __cxxWrapped = self.__implementation.recognizer.getCxxWrapper()
+        return __cxxWrapped.getCxxPart()
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__implementation.recognizer = { () -> HybridRecognizerSpec in
+        let __unsafePointer = bridge.get_std__shared_ptr_HybridRecognizerSpec_(newValue)
+        let __instance = HybridRecognizerSpec_cxx.fromUnsafe(__unsafePointer)
+        return __instance.getHybridRecognizerSpec()
+      }()
+    }
+  }
+
+  // Methods
+  
+}

package/nitrogen/generated/ios/swift/HybridRecognizerSpec.swift

@@ -0,0 +1,62 @@
+///
+/// HybridRecognizerSpec.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
+
+/// See ``HybridRecognizerSpec``
+public protocol HybridRecognizerSpec_protocol: HybridObject {
+  // Properties
+  var onReadyForSpeech: (() -> Void)? { get set }
+  var onRecordingStopped: (() -> Void)? { get set }
+  var onResult: ((_ resultBatches: [String]) -> Void)? { get set }
+  var onAutoFinishProgress: ((_ timeLeftMs: Double) -> Void)? { get set }
+  var onError: ((_ message: String) -> Void)? { get set }
+  var onPermissionDenied: (() -> Void)? { get set }
+
+  // Methods
+  func startListening(params: SpeechToTextParams) throws -> Void
+  func stopListening() throws -> Void
+}
+
+public extension HybridRecognizerSpec_protocol {
+  /// Default implementation of ``HybridObject.toString``
+  func toString() -> String {
+    return "[HybridObject Recognizer]"
+  }
+}
+
+/// See ``HybridRecognizerSpec``
+open class HybridRecognizerSpec_base {
+  private weak var cxxWrapper: HybridRecognizerSpec_cxx? = nil
+  public init() { }
+  public func getCxxWrapper() -> HybridRecognizerSpec_cxx {
+  #if DEBUG
+    guard self is HybridRecognizerSpec else {
+      fatalError("`self` is not a `HybridRecognizerSpec`! Did you accidentally inherit from `HybridRecognizerSpec_base` instead of `HybridRecognizerSpec`?")
+    }
+  #endif
+    if let cxxWrapper = self.cxxWrapper {
+      return cxxWrapper
+    } else {
+      let cxxWrapper = HybridRecognizerSpec_cxx(self as! HybridRecognizerSpec)
+      self.cxxWrapper = cxxWrapper
+      return cxxWrapper
+    }
+  }
+}
+
+/**
+ * A Swift base-protocol representing the Recognizer HybridObject.
+ * Implement this protocol to create Swift-based instances of Recognizer.
+ * ```swift
+ * class HybridRecognizer : HybridRecognizerSpec {
+ *   // ...
+ * }
+ * ```
+ */
+public typealias HybridRecognizerSpec = HybridRecognizerSpec_protocol & HybridRecognizerSpec_base