react-native-nitro-web-image 0.5.0-beta.5

package/nitrogen/generated/ios/swift/AsyncImagePriority.swift

@@ -0,0 +1,44 @@
+///
+/// AsyncImagePriority.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+/**
+ * Represents the JS union `AsyncImagePriority`, backed by a C++ enum.
+ */
+public typealias AsyncImagePriority = margelo.nitro.web.image.AsyncImagePriority
+
+public extension AsyncImagePriority {
+  /**
+   * Get a AsyncImagePriority for the given String value, or
+   * return `nil` if the given value was invalid/unknown.
+   */
+  init?(fromString string: String) {
+    switch string {
+      case "low":
+        self = .low
+      case "default":
+        self = .default
+      case "high":
+        self = .high
+      default:
+        return nil
+    }
+  }
+
+  /**
+   * Get the String value this AsyncImagePriority represents.
+   */
+  var stringValue: String {
+    switch self {
+      case .low:
+        return "low"
+      case .default:
+        return "default"
+      case .high:
+        return "high"
+    }
+  }
+}

package/nitrogen/generated/ios/swift/Func_void_std__exception_ptr.swift

@@ -0,0 +1,47 @@
+///
+/// Func_void_std__exception_ptr.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+
+/**
+ * Wraps a Swift `(_ error: Error) -> 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__exception_ptr {
+  public typealias bridge = margelo.nitro.web.image.bridge.swift
+
+  private let closure: (_ error: Error) -> Void
+
+  public init(_ closure: @escaping (_ error: Error) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(error: std.exception_ptr) -> Void {
+    self.closure(RuntimeError.from(cppError: error))
+  }
+
+  /**
+   * 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__exception_ptr`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_std__exception_ptr>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_std__exception_ptr {
+    return Unmanaged<Func_void_std__exception_ptr>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/Func_void_std__shared_ptr_margelo__nitro__image__HybridImageSpec_.swift

@@ -0,0 +1,51 @@
+///
+/// Func_void_std__shared_ptr_margelo__nitro__image__HybridImageSpec_.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+import NitroImage
+
+/**
+ * Wraps a Swift `(_ value: (any HybridImageSpec)) -> 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__shared_ptr_margelo__nitro__image__HybridImageSpec_ {
+  public typealias bridge = margelo.nitro.web.image.bridge.swift
+
+  private let closure: (_ value: (any HybridImageSpec)) -> Void
+
+  public init(_ closure: @escaping (_ value: (any HybridImageSpec)) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(value: bridge.std__shared_ptr_margelo__nitro__image__HybridImageSpec_) -> Void {
+    self.closure({ () -> HybridImageSpec in
+      let __unsafePointer = bridge.get_std__shared_ptr_margelo__nitro__image__HybridImageSpec_(value)
+      let __instance = HybridImageSpec_cxx.fromUnsafe(__unsafePointer)
+      return __instance.getHybridImageSpec()
+    }())
+  }
+
+  /**
+   * 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__shared_ptr_margelo__nitro__image__HybridImageSpec_`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_std__shared_ptr_margelo__nitro__image__HybridImageSpec_>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_std__shared_ptr_margelo__nitro__image__HybridImageSpec_ {
+    return Unmanaged<Func_void_std__shared_ptr_margelo__nitro__image__HybridImageSpec_>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/HybridWebImageFactorySpec.swift

@@ -0,0 +1,51 @@
+///
+/// HybridWebImageFactorySpec.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import Foundation
+import NitroModules
+import NitroImage
+
+/// See ``HybridWebImageFactorySpec``
+public protocol HybridWebImageFactorySpec_protocol: HybridObject {
+  // Properties
+  
+
+  // Methods
+  func createWebImageLoader(url: String, options: AsyncImageLoadOptions?) throws -> (any HybridImageLoaderSpec)
+  func loadFromURLAsync(url: String, options: AsyncImageLoadOptions?) throws -> Promise<(any HybridImageSpec)>
+}
+
+/// See ``HybridWebImageFactorySpec``
+open class HybridWebImageFactorySpec_base {
+  private weak var cxxWrapper: HybridWebImageFactorySpec_cxx? = nil
+  public init() { }
+  public func getCxxWrapper() -> HybridWebImageFactorySpec_cxx {
+  #if DEBUG
+    guard self is HybridWebImageFactorySpec else {
+      fatalError("`self` is not a `HybridWebImageFactorySpec`! Did you accidentally inherit from `HybridWebImageFactorySpec_base` instead of `HybridWebImageFactorySpec`?")
+    }
+  #endif
+    if let cxxWrapper = self.cxxWrapper {
+      return cxxWrapper
+    } else {
+      let cxxWrapper = HybridWebImageFactorySpec_cxx(self as! HybridWebImageFactorySpec)
+      self.cxxWrapper = cxxWrapper
+      return cxxWrapper
+    }
+  }
+}
+
+/**
+ * A Swift base-protocol representing the WebImageFactory HybridObject.
+ * Implement this protocol to create Swift-based instances of WebImageFactory.
+ * ```swift
+ * class HybridWebImageFactory : HybridWebImageFactorySpec {
+ *   // ...
+ * }
+ * ```
+ */
+public typealias HybridWebImageFactorySpec = HybridWebImageFactorySpec_protocol & HybridWebImageFactorySpec_base

package/nitrogen/generated/ios/swift/HybridWebImageFactorySpec_cxx.swift

@@ -0,0 +1,161 @@
+///
+/// HybridWebImageFactorySpec_cxx.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import Foundation
+import NitroModules
+import NitroImage
+
+/**
+ * A class implementation that bridges HybridWebImageFactorySpec 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 HybridWebImageFactorySpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::web::image::bridge::swift`)
+   * from `NitroWebImage-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.web.image.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridWebImageFactorySpec` Swift protocol.
+   */
+  private var __implementation: any HybridWebImageFactorySpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_margelo__nitro__web__image__HybridWebImageFactorySpec_
+
+  /**
+   * Create a new `HybridWebImageFactorySpec_cxx` that wraps the given `HybridWebImageFactorySpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridWebImageFactorySpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridWebImageFactorySpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridWebImageFactorySpec() -> any HybridWebImageFactorySpec {
+    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 `HybridWebImageFactorySpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridWebImageFactorySpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridWebImageFactorySpec_cxx {
+    return Unmanaged<HybridWebImageFactorySpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<margelo::nitro::web::image::HybridWebImageFactorySpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_margelo__nitro__web__image__HybridWebImageFactorySpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if cachedCxxPart.__convertToBool() {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_margelo__nitro__web__image__HybridWebImageFactorySpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_margelo__nitro__web__image__HybridWebImageFactorySpec_(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()
+  }
+
+  // Properties
+  
+
+  // Methods
+  @inline(__always)
+  public final func createWebImageLoader(url: std.string, options: bridge.std__optional_AsyncImageLoadOptions_) -> bridge.Result_std__shared_ptr_margelo__nitro__image__HybridImageLoaderSpec__ {
+    do {
+      let __result = try self.__implementation.createWebImageLoader(url: String(url), options: { () -> AsyncImageLoadOptions? in
+        if let __unwrapped = options.value {
+          return __unwrapped
+        } else {
+          return nil
+        }
+      }())
+      let __resultCpp = { () -> bridge.std__shared_ptr_margelo__nitro__image__HybridImageLoaderSpec_ in
+        let __cxxWrapped = __result.getCxxWrapper()
+        return __cxxWrapped.getCxxPart()
+      }()
+      return bridge.create_Result_std__shared_ptr_margelo__nitro__image__HybridImageLoaderSpec__(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_margelo__nitro__image__HybridImageLoaderSpec__(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func loadFromURLAsync(url: std.string, options: bridge.std__optional_AsyncImageLoadOptions_) -> bridge.Result_std__shared_ptr_Promise_std__shared_ptr_margelo__nitro__image__HybridImageSpec____ {
+    do {
+      let __result = try self.__implementation.loadFromURLAsync(url: String(url), options: { () -> AsyncImageLoadOptions? in
+        if let __unwrapped = options.value {
+          return __unwrapped
+        } else {
+          return nil
+        }
+      }())
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__shared_ptr_margelo__nitro__image__HybridImageSpec___ in
+        let __promise = bridge.create_std__shared_ptr_Promise_std__shared_ptr_margelo__nitro__image__HybridImageSpec___()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__shared_ptr_margelo__nitro__image__HybridImageSpec___(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve({ () -> bridge.std__shared_ptr_margelo__nitro__image__HybridImageSpec_ in
+              let __cxxWrapped = __result.getCxxWrapper()
+              return __cxxWrapped.getCxxPart()
+            }()) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_std__shared_ptr_margelo__nitro__image__HybridImageSpec____(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_std__shared_ptr_margelo__nitro__image__HybridImageSpec____(__exceptionPtr)
+    }
+  }
+}

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

@@ -0,0 +1,104 @@
+///
+/// AsyncImageLoadOptions.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 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
+
+// Forward declaration of `AsyncImagePriority` to properly resolve imports.
+namespace margelo::nitro::web::image { enum class AsyncImagePriority; }
+
+#include "AsyncImagePriority.hpp"
+#include <optional>
+#include <string>
+
+namespace margelo::nitro::web::image {
+
+  /**
+   * A struct which can be represented as a JavaScript object (AsyncImageLoadOptions).
+   */
+  struct AsyncImageLoadOptions {
+  public:
+    std::optional<AsyncImagePriority> priority     SWIFT_PRIVATE;
+    std::optional<bool> forceRefresh     SWIFT_PRIVATE;
+    std::optional<std::string> cacheKey     SWIFT_PRIVATE;
+    std::optional<bool> continueInBackground     SWIFT_PRIVATE;
+    std::optional<bool> allowInvalidSSLCertificates     SWIFT_PRIVATE;
+    std::optional<bool> scaleDownLargeImages     SWIFT_PRIVATE;
+    std::optional<bool> queryMemoryDataSync     SWIFT_PRIVATE;
+    std::optional<bool> queryDiskDataSync     SWIFT_PRIVATE;
+    std::optional<bool> decodeImage     SWIFT_PRIVATE;
+
+  public:
+    AsyncImageLoadOptions() = default;
+    explicit AsyncImageLoadOptions(std::optional<AsyncImagePriority> priority, std::optional<bool> forceRefresh, std::optional<std::string> cacheKey, std::optional<bool> continueInBackground, std::optional<bool> allowInvalidSSLCertificates, std::optional<bool> scaleDownLargeImages, std::optional<bool> queryMemoryDataSync, std::optional<bool> queryDiskDataSync, std::optional<bool> decodeImage): priority(priority), forceRefresh(forceRefresh), cacheKey(cacheKey), continueInBackground(continueInBackground), allowInvalidSSLCertificates(allowInvalidSSLCertificates), scaleDownLargeImages(scaleDownLargeImages), queryMemoryDataSync(queryMemoryDataSync), queryDiskDataSync(queryDiskDataSync), decodeImage(decodeImage) {}
+  };
+
+} // namespace margelo::nitro::web::image
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::web::image;
+
+  // C++ AsyncImageLoadOptions <> JS AsyncImageLoadOptions (object)
+  template <>
+  struct JSIConverter<AsyncImageLoadOptions> final {
+    static inline AsyncImageLoadOptions fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return AsyncImageLoadOptions(
+        JSIConverter<std::optional<AsyncImagePriority>>::fromJSI(runtime, obj.getProperty(runtime, "priority")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "forceRefresh")),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "cacheKey")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "continueInBackground")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "allowInvalidSSLCertificates")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "scaleDownLargeImages")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "queryMemoryDataSync")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "queryDiskDataSync")),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "decodeImage"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const AsyncImageLoadOptions& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "priority", JSIConverter<std::optional<AsyncImagePriority>>::toJSI(runtime, arg.priority));
+      obj.setProperty(runtime, "forceRefresh", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.forceRefresh));
+      obj.setProperty(runtime, "cacheKey", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.cacheKey));
+      obj.setProperty(runtime, "continueInBackground", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.continueInBackground));
+      obj.setProperty(runtime, "allowInvalidSSLCertificates", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.allowInvalidSSLCertificates));
+      obj.setProperty(runtime, "scaleDownLargeImages", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.scaleDownLargeImages));
+      obj.setProperty(runtime, "queryMemoryDataSync", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.queryMemoryDataSync));
+      obj.setProperty(runtime, "queryDiskDataSync", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.queryDiskDataSync));
+      obj.setProperty(runtime, "decodeImage", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.decodeImage));
+      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 (!JSIConverter<std::optional<AsyncImagePriority>>::canConvert(runtime, obj.getProperty(runtime, "priority"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "forceRefresh"))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "cacheKey"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "continueInBackground"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "allowInvalidSSLCertificates"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "scaleDownLargeImages"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "queryMemoryDataSync"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "queryDiskDataSync"))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "decodeImage"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,82 @@
+///
+/// AsyncImagePriority.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#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
+
+namespace margelo::nitro::web::image {
+
+  /**
+   * An enum which can be represented as a JavaScript union (AsyncImagePriority).
+   */
+  enum class AsyncImagePriority {
+    LOW      SWIFT_NAME(low) = 0,
+    DEFAULT      SWIFT_NAME(default) = 1,
+    HIGH      SWIFT_NAME(high) = 2,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::web::image
+
+namespace margelo::nitro {
+
+  using namespace margelo::nitro::web::image;
+
+  // C++ AsyncImagePriority <> JS AsyncImagePriority (union)
+  template <>
+  struct JSIConverter<AsyncImagePriority> final {
+    static inline AsyncImagePriority fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("low"): return AsyncImagePriority::LOW;
+        case hashString("default"): return AsyncImagePriority::DEFAULT;
+        case hashString("high"): return AsyncImagePriority::HIGH;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum AsyncImagePriority - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, AsyncImagePriority arg) {
+      switch (arg) {
+        case AsyncImagePriority::LOW: return JSIConverter<std::string>::toJSI(runtime, "low");
+        case AsyncImagePriority::DEFAULT: return JSIConverter<std::string>::toJSI(runtime, "default");
+        case AsyncImagePriority::HIGH: return JSIConverter<std::string>::toJSI(runtime, "high");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert AsyncImagePriority to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("low"):
+        case hashString("default"):
+        case hashString("high"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,22 @@
+///
+/// HybridWebImageFactorySpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridWebImageFactorySpec.hpp"
+
+namespace margelo::nitro::web::image {
+
+  void HybridWebImageFactorySpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("createWebImageLoader", &HybridWebImageFactorySpec::createWebImageLoader);
+      prototype.registerHybridMethod("loadFromURLAsync", &HybridWebImageFactorySpec::loadFromURLAsync);
+    });
+  }
+
+} // namespace margelo::nitro::web::image

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

@@ -0,0 +1,74 @@
+///
+/// HybridWebImageFactorySpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 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 `HybridImageLoaderSpec` to properly resolve imports.
+namespace margelo::nitro::image { class HybridImageLoaderSpec; }
+// Forward declaration of `AsyncImageLoadOptions` to properly resolve imports.
+namespace margelo::nitro::web::image { struct AsyncImageLoadOptions; }
+// Forward declaration of `HybridImageSpec` to properly resolve imports.
+namespace margelo::nitro::image { class HybridImageSpec; }
+
+#include <memory>
+#include <NitroImage/HybridImageLoaderSpec.hpp>
+#include <string>
+#include "AsyncImageLoadOptions.hpp"
+#include <optional>
+#include <NitroImage/HybridImageSpec.hpp>
+#include <NitroModules/Promise.hpp>
+
+namespace margelo::nitro::web::image {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `WebImageFactory`
+   * Inherit this class to create instances of `HybridWebImageFactorySpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridWebImageFactory: public HybridWebImageFactorySpec {
+   * public:
+   *   HybridWebImageFactory(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridWebImageFactorySpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridWebImageFactorySpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridWebImageFactorySpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<margelo::nitro::image::HybridImageLoaderSpec> createWebImageLoader(const std::string& url, const std::optional<AsyncImageLoadOptions>& options) = 0;
+      virtual std::shared_ptr<Promise<std::shared_ptr<margelo::nitro::image::HybridImageSpec>>> loadFromURLAsync(const std::string& url, const std::optional<AsyncImageLoadOptions>& options) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "WebImageFactory";
+  };
+
+} // namespace margelo::nitro::web::image