react-native-nitro-modules 0.20.1 → 0.22.0

package/cpp/utils/NitroDefines.hpp

@@ -9,7 +9,7 @@
 #define NitroDefines_h
 
 // Sets the version of the native Nitro core library
-#define NITRO_VERSION "0.20.1"
+#define NITRO_VERSION "0.22.0"
 
 // Sets whether to use debug or optimized production build flags
 #ifdef DEBUG
@@ -31,6 +31,7 @@
 #define _CXX_INTEROP_HAS_ATTRIBUTE(x) 0
 #endif
 
+// Closed/Final Enums
 #if _CXX_INTEROP_HAS_ATTRIBUTE(enum_extensibility)
 // Enum is marked as closed/not extensible
 #define CLOSED_ENUM __attribute__((enum_extensibility(closed)))
@@ -38,6 +39,7 @@
 #define CLOSED_ENUM
 #endif
 
+// Swift Support
 #if __has_include(<swift/bridging>)
 // Swift's bridging header defines those things
 #include <swift/bridging>
@@ -50,4 +52,14 @@
 #define SWIFT_NONCOPYABLE
 #endif
 
+// React Native Support
+#if __has_include(<cxxreact/ReactNativeVersion.h>)
+#include <cxxreact/ReactNativeVersion.h>
+#endif
+#ifndef REACT_NATIVE_VERSION_MINOR
+#define REACT_NATIVE_VERSION_MAJOR 0
+#define REACT_NATIVE_VERSION_MINOR 0
+#define REACT_NATIVE_VERSION_PATCH 0
+#endif
+
 #endif /* NitroDefines_h */

package/cpp/utils/NitroHash.hpp

@@ -9,6 +9,7 @@
 
 #include <cstddef>
 #include <cstdint>
+#include <string>
 
 namespace margelo::nitro {
 
@@ -40,4 +41,20 @@ constexpr uint64_t hashString(const char (&str)[N]) {
   return hashString(str, N - 1); // N includes the null terminator, so subtract 1
 }
 
+/**
+ * Hashes the given `string_view` using the FNV-1a hashing algorithm.
+ * This can be constexpr.
+ */
+constexpr uint64_t hashString(const std::string_view& string) {
+  return hashString(string.data(), string.length());
+}
+
+/**
+ * Hashes the given `string` using the FNV-1a hashing algorithm.
+ * This happens at runtime.
+ */
+inline uint64_t hashString(const std::string& string) {
+  return hashString(string.c_str(), string.length());
+}
+
 } // namespace margelo::nitro

package/cpp/utils/{TypeInfo.hpp → NitroTypeInfo.hpp}

@@ -1,5 +1,5 @@
 //
-//  TypeInfo.hpp
+//  NitroTypeInfo.hpp
 //  Nitro
 //
 //  Created by Marc Rousavy on 17.07.24.

package/cpp/utils/OwningReference.hpp

@@ -8,6 +8,7 @@
 #pragma once
 
 #include "BorrowingReference.hpp"
+#include "NitroDefines.hpp"
 #include "OwningLock.hpp"
 #include <atomic>
 #include <cstddef>
@@ -39,8 +40,10 @@ public:
   OwningReference(const OwningReference& ref)
       : _value(ref._value), _isDeleted(ref._isDeleted), _strongRefCount(ref._strongRefCount), _weakRefCount(ref._weakRefCount),
         _mutex(ref._mutex) {
-    // increment ref count after copy
-    (*_strongRefCount)++;
+    if (_strongRefCount != nullptr) {
+      // increment ref count after copy
+      (*_strongRefCount)++;
+    }
   }
 
   OwningReference(OwningReference&& ref)
@@ -161,10 +164,20 @@ public:
   }
 
   inline T& operator*() const {
+#ifdef NITRO_DEBUG
+    if (!hasValue()) [[unlikely]] {
+      throw std::runtime_error("Tried to dereference (*) nullptr OwningReference<T>!");
+    }
+#endif
     return *_value;
   }
 
   inline T* operator->() const {
+#ifdef NITRO_DEBUG
+    if (!hasValue()) [[unlikely]] {
+      throw std::runtime_error("Tried to dereference (->) nullptr OwningReference<T>!");
+    }
+#endif
     return _value;
   }
 

package/cpp/views/CachedProp.hpp

@@ -0,0 +1,43 @@
+//
+// Created by Marc Rousavy on 30.07.24.
+//
+
+#pragma once
+
+#include "JSIConverter.hpp"
+#include "NitroDefines.hpp"
+#include "OwningReference.hpp"
+#include <jsi/jsi.h>
+
+namespace margelo::nitro {
+
+using namespace facebook;
+
+template <typename T>
+struct CachedProp {
+public:
+  T value;
+  OwningReference<jsi::Value> jsiValue;
+  bool isDirty = false;
+
+public:
+  bool equals(jsi::Runtime& runtime, const jsi::Value& other) const {
+    if (!jsiValue)
+      return false;
+    return jsi::Value::strictEquals(runtime, *jsiValue, other);
+  }
+
+public:
+  static CachedProp<T> fromRawValue(jsi::Runtime& runtime, const jsi::Value& value, const CachedProp<T>& oldProp) {
+    if (oldProp.equals(runtime, value)) {
+      // jsi::Value hasn't changed - no need to convert it again!
+      return oldProp;
+    }
+    T converted = JSIConverter<T>::fromJSI(runtime, value);
+    JSICacheReference cache = JSICache::getOrCreateCache(runtime);
+    OwningReference<jsi::Value> cached = cache.makeShared(jsi::Value(runtime, value));
+    return CachedProp<T>(std::move(converted), std::move(cached), /* isDirty */ true);
+  }
+};
+
+} // namespace margelo::nitro

package/ios/core/ArrayBufferHolder.hpp

@@ -35,9 +35,9 @@ public:
    * Once the `ArrayBuffer` is no longer in use, the given `deleteFunc` will be called with the given `deleteFuncContext`
    * as an argument. The caller is responsible for deleting `data` once this is called.
    */
-  static ArrayBufferHolder makeBuffer(uint8_t* _Nonnull data, size_t size, SwiftClosure destroy) {
+  static ArrayBufferHolder wrap(uint8_t* _Nonnull data, size_t size, SwiftClosure destroy) {
     std::function<void()> deleteFunc = destroy.getFunction();
-    auto arrayBuffer = ArrayBuffer::makeBuffer(data, size, std::move(deleteFunc));
+    auto arrayBuffer = ArrayBuffer::wrap(data, size, std::move(deleteFunc));
     return ArrayBufferHolder(arrayBuffer);
   }
 
@@ -45,7 +45,7 @@ public:
   /**
    * Gets the raw bytes the underlying `ArrayBuffer` points to.
    */
-  void* _Nonnull getData() const SWIFT_COMPUTED_PROPERTY {
+  uint8_t* _Nonnull getData() const SWIFT_COMPUTED_PROPERTY {
     return _arrayBuffer->data();
   }
   /**

package/ios/core/ArrayBufferHolder.swift

@@ -15,6 +15,8 @@ import Foundation
  */
 public typealias ArrayBufferHolder = margelo.nitro.ArrayBufferHolder
 
+// pragma MARK: Wrap
+
 public extension ArrayBufferHolder {
   /**
    * Create a new `ArrayBufferHolder` that wraps the given `data` of the given `size`
@@ -28,9 +30,27 @@ public extension ArrayBufferHolder {
     // Convert escaping Swift closure to a `void*`
     let swiftClosure = SwiftClosure(wrappingClosure: delete)
     // Create ArrayBufferHolder with our wrapped Swift closure to make it callable as a C-function pointer
-    return ArrayBufferHolder.makeBuffer(data, size, swiftClosure)
+    return ArrayBufferHolder.wrap(data, size, swiftClosure)
   }
 
+  /**
+   * Create a new `ArrayBufferHolder` that wraps the given `data` of the given `size`
+   * without performing a copy.
+   * When the `ArrayBuffer` is no longer used, `onDelete` will be called, in which
+   * you as a caller are responsible for deleting `data`.
+   */
+  static func wrap(dataWithoutCopy data: UnsafeMutableRawPointer,
+                   size: Int,
+                   onDelete delete: @escaping () -> Void) -> ArrayBufferHolder {
+    return ArrayBufferHolder.wrap(dataWithoutCopy: data.assumingMemoryBound(to: UInt8.self),
+                                  size: size,
+                                  onDelete: delete)
+  }
+}
+
+// pragma MARK: Allocate
+
+public extension ArrayBufferHolder {
   /**
    * Allocate a new buffer of the given `size`.
    * If `initializeToZero` is `true`, all bytes are set to `0`, otherwise they are left untouched.
@@ -40,24 +60,92 @@ public extension ArrayBufferHolder {
     if initializeToZero {
       data.initialize(repeating: 0, count: size)
     }
-
     let deleteFunc = SwiftClosure {
       data.deallocate()
     }
-    return ArrayBufferHolder.makeBuffer(data, size, deleteFunc)
+    return ArrayBufferHolder.wrap(data, size, deleteFunc)
+  }
+}
+
+// pragma MARK: Copy
+
+public extension ArrayBufferHolder {
+  /**
+   * Copy the given `UnsafeMutablePointer<UInt8>` into a new **owning** `ArrayBufferHolder`.
+   */
+  static func copy(of other: UnsafeMutablePointer<UInt8>,
+                   size: Int) -> ArrayBufferHolder {
+    // 1. Create new `UnsafeMutablePointer<UInt8>`
+    let copy = UnsafeMutablePointer<UInt8>.allocate(capacity: size)
+    // 2. Copy over data
+    copy.initialize(from: other, count: size)
+    // 3. Create memory safe destroyer
+    let deleteFunc = SwiftClosure {
+      copy.deallocate()
+    }
+    return ArrayBufferHolder.wrap(copy, size, deleteFunc)
+  }
+
+  /**
+   * Copy the given `UnsafeMutableRawPointer` into a new **owning** `ArrayBufferHolder`.
+   */
+  static func copy(of other: UnsafeMutableRawPointer,
+                   size: Int) -> ArrayBufferHolder {
+    return ArrayBufferHolder.copy(of: other.assumingMemoryBound(to: UInt8.self),
+                                  size: size)
   }
 
   /**
    * Copy the given `ArrayBufferHolder` into a new **owning** `ArrayBufferHolder`.
    */
   static func copy(of other: ArrayBufferHolder) -> ArrayBufferHolder {
-    let data = UnsafeMutablePointer<UInt8>.allocate(capacity: other.size)
-    let pointer = other.data.assumingMemoryBound(to: UInt8.self)
-    data.initialize(from: pointer, count: other.size)
+    return ArrayBufferHolder.copy(of: other.data, size: other.size)
+  }
 
-    let deleteFunc = SwiftClosure {
-      data.deallocate()
+  /**
+   * Copy the given `Data` into a new **owning** `ArrayBufferHolder`.
+   */
+  static func copy(data: Data) throws -> ArrayBufferHolder {
+    // 1. Create new `ArrayBuffer` of same size
+    let size = data.count
+    let arrayBuffer = ArrayBufferHolder.allocate(size: size)
+    // 2. Copy all bytes from `Data` into our new `ArrayBuffer`
+    try data.withUnsafeBytes { rawPointer in
+      guard let baseAddress = rawPointer.baseAddress else {
+        throw RuntimeError.error(withMessage: "Cannot get baseAddress of Data!")
+      }
+      memcpy(arrayBuffer.data, baseAddress, size)
+    }
+    return arrayBuffer
+  }
+}
+
+
+// pragma MARK: Data
+
+public extension ArrayBufferHolder {
+  /**
+   * Wrap this `ArrayBufferHolder` in a `Data` instance, without performing a copy.
+   * - `copyIfNeeded`: If this `ArrayBuffer` is **non-owning**, the foreign
+   *                   data may needs to be copied to be safely used outside of the scope of the caller function.
+   *                   This flag controls that.
+   */
+  func toData(copyIfNeeded: Bool) -> Data {
+    let shouldCopy = copyIfNeeded && !self.isOwner
+    if shouldCopy {
+      // COPY DATA
+      return Data.init(bytes: self.data, count: self.size)
+    } else {
+      // WRAP DATA
+      // 1. Get the std::shared_ptr<ArrayBuffer>
+      var sharedPointer = self.getArrayBuffer()
+      // 2. Create a Data object WRAPPING our pointer
+      return Data(bytesNoCopy: self.data, count: self.size, deallocator: .custom({ buffer, size in
+        // 3. Capture the std::shared_ptr<ArrayBuffer> in the deallocator lambda so it stays alive.
+        //    As soon as this lambda gets called, the `sharedPointer` gets deleted causing the
+        //    underlying `ArrayBuffer` to be freed.
+        sharedPointer.reset()
+      }))
     }
-    return ArrayBufferHolder.makeBuffer(data, other.size, deleteFunc)
   }
 }

package/ios/core/HybridContext.hpp

@@ -13,7 +13,7 @@ class HybridObject;
 
 #include "HybridObject.hpp"
 #include "NitroLogger.hpp"
-#include "TypeInfo.hpp"
+#include "NitroTypeInfo.hpp"
 #include <memory>
 
 namespace margelo::nitro {

package/ios/core/{HybridObjectSpec.swift → HybridObject.swift}

@@ -1,5 +1,5 @@
 //
-//  HybridObjectSpec.swift
+//  HybridObject.swift
 //  NitroModules
 //
 //  Created by Marc Rousavy on 23.07.24.
@@ -10,7 +10,7 @@ import Foundation
 /**
  * A base protocol for all Swift-based Hybrid Objects.
  */
-public protocol HybridObjectSpec: AnyObject {
+public protocol HybridObject: AnyObject {
   /**
    * Get the memory size of the Swift instance (plus any external heap allocations),
    * in bytes.
@@ -29,6 +29,14 @@ public protocol HybridObjectSpec: AnyObject {
   var memorySize: Int { get }
 }
 
+public extension HybridObject {
+  // By default, this returns `0`.
+  var memorySize: Int { return 0 }
+}
+
+@available(*, deprecated, message: "HybridObjectSpec has been renamed to HybridObject. Update Nitrogen and re-generate your specs.")
+public typealias HybridObjectSpec = HybridObject
+
 public extension HybridObjectSpec {
   @available(*, deprecated, message: "getSizeOf(...) will now be default-computed. Please remove getSizeOf() from your code.")
   func getSizeOf<T: AnyObject>(_ instance: T) -> Int {

package/ios/core/PromiseHolder.hpp

@@ -1,5 +1,5 @@
 //
-//  ArrayBufferHolder.hpp
+//  PromiseHolder.hpp
 //  react-native-nitro
 //
 //  Created by Marc Rousavy on 14.08.24.

package/ios/utils/RuntimeError.hpp

@@ -7,7 +7,7 @@
 
 #pragma once
 
-#include "TypeInfo.hpp"
+#include "NitroTypeInfo.hpp"
 #include <exception>
 #include <string>
 

package/ios/views/HybridView.swift

@@ -0,0 +1,41 @@
+//
+//  HybridView.swift
+//  NitroModules
+//
+//  Created by Marc Rousavy on 13.01.25.
+//
+
+#if canImport(UIKit)
+
+import Foundation
+import UIKit
+
+/**
+ * A base protocol for all Swift-based Hybrid Views.
+ */
+public protocol HybridView: HybridObject {
+  /**
+   * Get the ``UIView`` this HybridView is holding.
+   *
+   * This value should not change during the lifetime of this ``HybridView``.
+   */
+  var view: UIView { get }
+
+  /**
+   * Called right before updating props.
+   * React props are updated in a single batch/transaction.
+   */
+  func beforeUpdate()
+  /**
+   * Called right after updating props.
+   * React props are updated in a single batch/transaction.
+   */
+  func afterUpdate()
+}
+
+public extension HybridView {
+  func beforeUpdate() { /* noop */ }
+  func afterUpdate() { /* noop */ }
+}
+
+#endif

package/lib/commonjs/index.js

@@ -47,4 +47,15 @@ Object.keys(_Constructor).forEach(function (key) {
     }
   });
 });
+var _HybridView = require("./views/HybridView");
+Object.keys(_HybridView).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _HybridView[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _HybridView[key];
+    }
+  });
+});
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_HybridObject","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_NitroModules","_AnyMap","_Constructor"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,aAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,aAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,aAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,aAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,aAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,aAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,aAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,OAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,OAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,OAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,OAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,YAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,YAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,YAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,YAAA,CAAAP,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}
+{"version":3,"names":["_HybridObject","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_NitroModules","_AnyMap","_Constructor","_HybridView"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,aAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,aAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,aAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,aAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,aAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,aAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,aAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,OAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,OAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,OAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,OAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,YAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,YAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,YAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,YAAA,CAAAP,GAAA;IAAA;EAAA;AAAA;AACA,IAAAQ,WAAA,GAAAZ,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAU,WAAA,EAAAT,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAQ,WAAA,CAAAR,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAI,WAAA,CAAAR,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/views/HybridView.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _getHostComponent = require("./getHostComponent");
+Object.keys(_getHostComponent).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _getHostComponent[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _getHostComponent[key];
+    }
+  });
+});
+//# sourceMappingURL=HybridView.js.map

package/lib/commonjs/views/HybridView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_getHostComponent","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sourceRoot":"../../../src","sources":["views/HybridView.ts"],"mappings":";;;;;AAoCA,IAAAA,iBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,iBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,iBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,iBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/views/getHostComponent.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getHostComponent = getHostComponent;
+var _reactNative = require("react-native");
+var NativeComponentRegistry = _interopRequireWildcard(require("react-native/Libraries/NativeComponent/NativeComponentRegistry"));
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// @ts-expect-error this unfortunately isn't typed or default-exported.
+
+/**
+ * Finds and returns a native view (aka {@linkcode HostComponent}) via the given {@linkcode name}.
+ */
+function getHostComponent(name, getViewConfig) {
+  if (NativeComponentRegistry == null) {
+    throw new Error(`NativeComponentRegistry is not available on ${_reactNative.Platform.OS}!`);
+  }
+  return NativeComponentRegistry.get(name, getViewConfig);
+}
+//# sourceMappingURL=getHostComponent.js.map

package/lib/commonjs/views/getHostComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","NativeComponentRegistry","_interopRequireWildcard","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","getHostComponent","name","getViewConfig","Error","Platform","OS"],"sourceRoot":"../../../src","sources":["views/getHostComponent.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA,IAAAC,uBAAA,GAAAC,uBAAA,CAAAF,OAAA;AAAyG,SAAAG,yBAAAC,CAAA,6BAAAC,OAAA,mBAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,CAAAC,CAAA,WAAAA,CAAA,GAAAG,CAAA,GAAAD,CAAA,KAAAF,CAAA;AAAA,SAAAF,wBAAAE,CAAA,EAAAE,CAAA,SAAAA,CAAA,IAAAF,CAAA,IAAAA,CAAA,CAAAI,UAAA,SAAAJ,CAAA,eAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,WAAAK,OAAA,EAAAL,CAAA,QAAAG,CAAA,GAAAJ,wBAAA,CAAAG,CAAA,OAAAC,CAAA,IAAAA,CAAA,CAAAG,GAAA,CAAAN,CAAA,UAAAG,CAAA,CAAAI,GAAA,CAAAP,CAAA,OAAAQ,CAAA,KAAAC,SAAA,UAAAC,CAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,CAAA,IAAAd,CAAA,oBAAAc,CAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAhB,CAAA,EAAAc,CAAA,SAAAG,CAAA,GAAAP,CAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAb,CAAA,EAAAc,CAAA,UAAAG,CAAA,KAAAA,CAAA,CAAAV,GAAA,IAAAU,CAAA,CAAAC,GAAA,IAAAP,MAAA,CAAAC,cAAA,CAAAJ,CAAA,EAAAM,CAAA,EAAAG,CAAA,IAAAT,CAAA,CAAAM,CAAA,IAAAd,CAAA,CAAAc,CAAA,YAAAN,CAAA,CAAAH,OAAA,GAAAL,CAAA,EAAAG,CAAA,IAAAA,CAAA,CAAAe,GAAA,CAAAlB,CAAA,EAAAQ,CAAA,GAAAA,CAAA;AADzG;;AAWA;AACA;AACA;AACO,SAASW,gBAAgBA,CAC9BC,IAAY,EACZC,aAAsC,EAChB;EACtB,IAAIxB,uBAAuB,IAAI,IAAI,EAAE;IACnC,MAAM,IAAIyB,KAAK,CACb,+CAA+CC,qBAAQ,CAACC,EAAE,GAC5D,CAAC;EACH;EACA,OAAO3B,uBAAuB,CAACU,GAAG,CAAQa,IAAI,EAAEC,aAAa,CAAC;AAChE","ignoreList":[]}

package/lib/module/index.js

@@ -4,4 +4,5 @@ export * from './HybridObject';
 export * from './NitroModules';
 export * from './AnyMap';
 export * from './Constructor';
+export * from './views/HybridView';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,cAAc,gBAAgB;AAC9B,cAAc,gBAAgB;AAC9B,cAAc,UAAU;AACxB,cAAc,eAAe","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,cAAc,gBAAgB;AAC9B,cAAc,gBAAgB;AAC9B,cAAc,UAAU;AACxB,cAAc,eAAe;AAC7B,cAAc,oBAAoB","ignoreList":[]}

package/lib/module/views/HybridView.js

@@ -0,0 +1,30 @@
+"use strict";
+
+/**
+ * Describes the languages this view will be implemented in.
+ */
+
+/**
+ * Represents a Nitro `HybridView` which is implemented in a native language
+ * like Swift or Kotlin.
+ *
+ * `HybridViews`s use the Nitro Tunnel for efficient, low-overhead JS <-> Native communication.
+ *
+ * All `HybridViews`s have a C++ Fabric View base with a backing Shadow Node.
+ *
+ * - TypeScript Properties (`name: Type`) will be React Props
+ * - TypeScript Methods (`name(): Type`) will be Ref Methods
+ *
+ * @example
+ * ```tsx
+ * export interface Camera extends HybridView {
+ *   zoom: number
+ *   flash: boolean
+ *   takePhoto(): Image
+ * }
+ * ```
+ */
+
+export * from './getHostComponent';
+export {};
+//# sourceMappingURL=HybridView.js.map

package/lib/module/views/HybridView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["views/HybridView.ts"],"mappings":";;AAEA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA,cAAc,oBAAoB;AAAA","ignoreList":[]}

package/lib/module/views/getHostComponent.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { Platform } from 'react-native';
+// @ts-expect-error this unfortunately isn't typed or default-exported.
+import * as NativeComponentRegistry from 'react-native/Libraries/NativeComponent/NativeComponentRegistry';
+/**
+ * Finds and returns a native view (aka {@linkcode HostComponent}) via the given {@linkcode name}.
+ */
+export function getHostComponent(name, getViewConfig) {
+  if (NativeComponentRegistry == null) {
+    throw new Error(`NativeComponentRegistry is not available on ${Platform.OS}!`);
+  }
+  return NativeComponentRegistry.get(name, getViewConfig);
+}
+//# sourceMappingURL=getHostComponent.js.map

package/lib/module/views/getHostComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","NativeComponentRegistry","getHostComponent","name","getViewConfig","Error","OS","get"],"sourceRoot":"../../../src","sources":["views/getHostComponent.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAA4B,cAAc;AAC3D;AACA,OAAO,KAAKC,uBAAuB,MAAM,gEAAgE;AAUzG;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAC9BC,IAAY,EACZC,aAAsC,EAChB;EACtB,IAAIH,uBAAuB,IAAI,IAAI,EAAE;IACnC,MAAM,IAAII,KAAK,CACb,+CAA+CL,QAAQ,CAACM,EAAE,GAC5D,CAAC;EACH;EACA,OAAOL,uBAAuB,CAACM,GAAG,CAAQJ,IAAI,EAAEC,aAAa,CAAC;AAChE","ignoreList":[]}