@fressh/react-native-terminal 0.1.0

package/nitrogen/generated/ios/c++/views/HybridTerminalComponent.mm

@@ -0,0 +1,132 @@
+///
+/// HybridTerminalComponent.mm
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#import "HybridTerminalComponent.hpp"
+#import <memory>
+#import <react/renderer/componentregistry/ComponentDescriptorProvider.h>
+#import <React/RCTViewComponentView.h>
+#import <React/RCTComponentViewFactory.h>
+#import <React/UIView+ComponentViewProtocol.h>
+#import <NitroModules/NitroDefines.hpp>
+#import <UIKit/UIKit.h>
+
+#import "HybridTerminalSpecSwift.hpp"
+#import "ReactNativeTerminal-Swift-Cxx-Umbrella.hpp"
+
+#if __has_include(<cxxreact/ReactNativeVersion.h>)
+#include <cxxreact/ReactNativeVersion.h>
+#if REACT_NATIVE_VERSION_MINOR >= 82
+#define ENABLE_RCT_COMPONENT_VIEW_INVALIDATE
+#endif
+#endif
+
+using namespace facebook;
+using namespace margelo::nitro::fressh;
+using namespace margelo::nitro::fressh::views;
+
+/**
+ * Represents the React Native View holder for the Nitro "Terminal" HybridView.
+ */
+@interface HybridTerminalComponent: RCTViewComponentView
++ (BOOL)shouldBeRecycled;
+@end
+
+@implementation HybridTerminalComponent {
+  std::shared_ptr<HybridTerminalSpecSwift> _hybridView;
+}
+
++ (void) load {
+  [super load];
+  [RCTComponentViewFactory.currentComponentViewFactory registerComponentViewClass:[HybridTerminalComponent class]];
+}
+
++ (react::ComponentDescriptorProvider) componentDescriptorProvider {
+  return react::concreteComponentDescriptorProvider<HybridTerminalComponentDescriptor>();
+}
+
+- (instancetype) init {
+  if (self = [super init]) {
+    std::shared_ptr<HybridTerminalSpec> hybridView = ReactNativeTerminal::ReactNativeTerminalAutolinking::createTerminal();
+    _hybridView = std::dynamic_pointer_cast<HybridTerminalSpecSwift>(hybridView);
+    [self updateView];
+  }
+  return self;
+}
+
+- (void) updateView {
+  // 1. Get Swift part
+  ReactNativeTerminal::HybridTerminalSpec_cxx& swiftPart = _hybridView->getSwiftPart();
+
+  // 2. Get UIView*
+  void* viewUnsafe = swiftPart.getView();
+  UIView* view = (__bridge_transfer UIView*) viewUnsafe;
+
+  // 3. Update RCTViewComponentView's [contentView]
+  [self setContentView:view];
+}
+
+- (void) updateProps:(const std::shared_ptr<const react::Props>&)props
+            oldProps:(const std::shared_ptr<const react::Props>&)oldProps {
+  // 1. Downcast props
+  const auto& newViewPropsConst = *std::static_pointer_cast<HybridTerminalProps const>(props);
+  auto& newViewProps = const_cast<HybridTerminalProps&>(newViewPropsConst);
+  ReactNativeTerminal::HybridTerminalSpec_cxx& swiftPart = _hybridView->getSwiftPart();
+
+  // 2. Update each prop individually
+  swiftPart.beforeUpdate();
+
+  // fontPath: string
+  if (newViewProps.fontPath.isDirty) {
+    swiftPart.setFontPath(newViewProps.fontPath.value);
+    newViewProps.fontPath.isDirty = false;
+  }
+  // configJson: optional
+  if (newViewProps.configJson.isDirty) {
+    swiftPart.setConfigJson(newViewProps.configJson.value);
+    newViewProps.configJson.isDirty = false;
+  }
+  // shellId: optional
+  if (newViewProps.shellId.isDirty) {
+    swiftPart.setShellId(newViewProps.shellId.value);
+    newViewProps.shellId.isDirty = false;
+  }
+
+  swiftPart.afterUpdate();
+
+  // 3. Update hybridRef if it changed
+  if (newViewProps.hybridRef.isDirty) {
+    // hybridRef changed - call it with new this
+    const auto& maybeFunc = newViewProps.hybridRef.value;
+    if (maybeFunc.has_value()) {
+      maybeFunc.value()(_hybridView);
+    }
+    newViewProps.hybridRef.isDirty = false;
+  }
+
+  // 4. Continue in base class
+  [super updateProps:props oldProps:oldProps];
+}
+
++ (BOOL)shouldBeRecycled {
+  return ReactNativeTerminal::ReactNativeTerminalAutolinking::isTerminalRecyclable();
+}
+
+- (void)prepareForRecycle {
+  [super prepareForRecycle];
+  ReactNativeTerminal::HybridTerminalSpec_cxx& swiftPart = _hybridView->getSwiftPart();
+  swiftPart.maybePrepareForRecycle();
+}
+
+#ifdef ENABLE_RCT_COMPONENT_VIEW_INVALIDATE
+- (void)invalidate {
+  ReactNativeTerminal::HybridTerminalSpec_cxx& swiftPart = _hybridView->getSwiftPart();
+  swiftPart.onDropView();
+  [super invalidate];
+}
+#endif
+
+@end

package/nitrogen/generated/ios/swift/HybridTerminalSpec.swift

@@ -0,0 +1,57 @@
+///
+/// HybridTerminalSpec.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/// See ``HybridTerminalSpec``
+public protocol HybridTerminalSpec_protocol: HybridObject, HybridView {
+  // Properties
+  var fontPath: String { get set }
+  var configJson: String? { get set }
+  var shellId: String? { get set }
+
+  // Methods
+  
+}
+
+public extension HybridTerminalSpec_protocol {
+  /// Default implementation of ``HybridObject.toString``
+  func toString() -> String {
+    return "[HybridObject Terminal]"
+  }
+}
+
+/// See ``HybridTerminalSpec``
+open class HybridTerminalSpec_base {
+  private weak var cxxWrapper: HybridTerminalSpec_cxx? = nil
+  public init() { }
+  public func getCxxWrapper() -> HybridTerminalSpec_cxx {
+  #if DEBUG
+    guard self is any HybridTerminalSpec else {
+      fatalError("`self` is not a `HybridTerminalSpec`! Did you accidentally inherit from `HybridTerminalSpec_base` instead of `HybridTerminalSpec`?")
+    }
+  #endif
+    if let cxxWrapper = self.cxxWrapper {
+      return cxxWrapper
+    } else {
+      let cxxWrapper = HybridTerminalSpec_cxx(self as! any HybridTerminalSpec)
+      self.cxxWrapper = cxxWrapper
+      return cxxWrapper
+    }
+  }
+}
+
+/**
+ * A Swift base-protocol representing the Terminal HybridObject.
+ * Implement this protocol to create Swift-based instances of Terminal.
+ * ```swift
+ * class HybridTerminal : HybridTerminalSpec {
+ *   // ...
+ * }
+ * ```
+ */
+public typealias HybridTerminalSpec = HybridTerminalSpec_protocol & HybridTerminalSpec_base

package/nitrogen/generated/ios/swift/HybridTerminalSpec_cxx.swift

@@ -0,0 +1,204 @@
+///
+/// HybridTerminalSpec_cxx.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * A class implementation that bridges HybridTerminalSpec 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 HybridTerminalSpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::fressh::bridge::swift`)
+   * from `ReactNativeTerminal-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.fressh.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridTerminalSpec` Swift protocol.
+   */
+  private var __implementation: any HybridTerminalSpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_HybridTerminalSpec_
+
+  /**
+   * Create a new `HybridTerminalSpec_cxx` that wraps the given `HybridTerminalSpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridTerminalSpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridTerminalSpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridTerminalSpec() -> any HybridTerminalSpec {
+    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 `HybridTerminalSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridTerminalSpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridTerminalSpec_cxx {
+    return Unmanaged<HybridTerminalSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<HybridTerminalSpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridTerminalSpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if Bool(fromCxx: cachedCxxPart) {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_HybridTerminalSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridTerminalSpec_(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
+  }
+
+  /**
+   * Compares this object with the given [other] object for reference equality.
+   */
+  @inline(__always)
+  public func equals(other: HybridTerminalSpec_cxx) -> Bool {
+    return self.__implementation === other.__implementation
+  }
+
+  /**
+   * 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 fontPath: std.string {
+    @inline(__always)
+    get {
+      return std.string(self.__implementation.fontPath)
+    }
+    @inline(__always)
+    set {
+      self.__implementation.fontPath = String(newValue)
+    }
+  }
+  
+  public final var configJson: bridge.std__optional_std__string_ {
+    @inline(__always)
+    get {
+      return { () -> bridge.std__optional_std__string_ in
+        if let __unwrappedValue = self.__implementation.configJson {
+          return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+        } else {
+          return .init()
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__implementation.configJson = { () -> String? in
+        if bridge.has_value_std__optional_std__string_(newValue) {
+          let __unwrapped = bridge.get_std__optional_std__string_(newValue)
+          return String(__unwrapped)
+        } else {
+          return nil
+        }
+      }()
+    }
+  }
+  
+  public final var shellId: bridge.std__optional_std__string_ {
+    @inline(__always)
+    get {
+      return { () -> bridge.std__optional_std__string_ in
+        if let __unwrappedValue = self.__implementation.shellId {
+          return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+        } else {
+          return .init()
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__implementation.shellId = { () -> String? in
+        if bridge.has_value_std__optional_std__string_(newValue) {
+          let __unwrapped = bridge.get_std__optional_std__string_(newValue)
+          return String(__unwrapped)
+        } else {
+          return nil
+        }
+      }()
+    }
+  }
+
+  // Methods
+  public final func getView() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(__implementation.view).toOpaque()
+  }
+  
+  public final func beforeUpdate() {
+    __implementation.beforeUpdate()
+  }
+  
+  public final func afterUpdate() {
+    __implementation.afterUpdate()
+  }
+  
+  public final func maybePrepareForRecycle() {
+    guard let recyclable = __implementation as? any RecyclableView else { return }
+    recyclable.prepareForRecycle()
+  }
+  
+  public final func onDropView() {
+    __implementation.onDropView()
+  }
+}

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

@@ -0,0 +1,26 @@
+///
+/// HybridTerminalSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridTerminalSpec.hpp"
+
+namespace margelo::nitro::fressh {
+
+  void HybridTerminalSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridGetter("fontPath", &HybridTerminalSpec::getFontPath);
+      prototype.registerHybridSetter("fontPath", &HybridTerminalSpec::setFontPath);
+      prototype.registerHybridGetter("configJson", &HybridTerminalSpec::getConfigJson);
+      prototype.registerHybridSetter("configJson", &HybridTerminalSpec::setConfigJson);
+      prototype.registerHybridGetter("shellId", &HybridTerminalSpec::getShellId);
+      prototype.registerHybridSetter("shellId", &HybridTerminalSpec::setShellId);
+    });
+  }
+
+} // namespace margelo::nitro::fressh

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

@@ -0,0 +1,68 @@
+///
+/// HybridTerminalSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 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
+
+
+
+#include <string>
+#include <optional>
+
+namespace margelo::nitro::fressh {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `Terminal`
+   * Inherit this class to create instances of `HybridTerminalSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridTerminal: public HybridTerminalSpec {
+   * public:
+   *   HybridTerminal(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridTerminalSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridTerminalSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridTerminalSpec() override = default;
+
+    public:
+      // Properties
+      virtual std::string getFontPath() = 0;
+      virtual void setFontPath(const std::string& fontPath) = 0;
+      virtual std::optional<std::string> getConfigJson() = 0;
+      virtual void setConfigJson(const std::optional<std::string>& configJson) = 0;
+      virtual std::optional<std::string> getShellId() = 0;
+      virtual void setShellId(const std::optional<std::string>& shellId) = 0;
+
+    public:
+      // Methods
+      
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "Terminal";
+  };
+
+} // namespace margelo::nitro::fressh

package/nitrogen/generated/shared/c++/views/HybridTerminalComponent.cpp

@@ -0,0 +1,110 @@
+///
+/// HybridTerminalComponent.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridTerminalComponent.hpp"
+
+#include <string>
+#include <exception>
+#include <utility>
+#include <NitroModules/NitroDefines.hpp>
+#include <NitroModules/JSIConverter.hpp>
+#include <NitroModules/PropNameIDCache.hpp>
+#include <react/renderer/core/RawValue.h>
+#include <react/renderer/core/ShadowNode.h>
+#include <react/renderer/core/ComponentDescriptor.h>
+#include <react/renderer/components/view/ViewProps.h>
+
+namespace margelo::nitro::fressh::views {
+
+  extern const char HybridTerminalComponentName[] = "Terminal";
+
+  HybridTerminalProps::HybridTerminalProps(const react::PropsParserContext& context,
+                                           const HybridTerminalProps& sourceProps,
+                                           const react::RawProps& rawProps):
+    react::ViewProps(context, sourceProps, rawProps, filterObjectKeys),
+    fontPath([&]() -> CachedProp<std::string> {
+      try {
+        const react::RawValue* rawValue = rawProps.at("fontPath", nullptr, nullptr);
+        if (rawValue == nullptr) return sourceProps.fontPath;
+        const auto& [runtime, value] = (std::pair<jsi::Runtime*, jsi::Value>)*rawValue;
+        return CachedProp<std::string>::fromRawValue(*runtime, value, sourceProps.fontPath);
+      } catch (const std::exception& exc) {
+        throw std::runtime_error(std::string("Terminal.fontPath: ") + exc.what());
+      }
+    }()),
+    configJson([&]() -> CachedProp<std::optional<std::string>> {
+      try {
+        const react::RawValue* rawValue = rawProps.at("configJson", nullptr, nullptr);
+        if (rawValue == nullptr) return sourceProps.configJson;
+        const auto& [runtime, value] = (std::pair<jsi::Runtime*, jsi::Value>)*rawValue;
+        return CachedProp<std::optional<std::string>>::fromRawValue(*runtime, value, sourceProps.configJson);
+      } catch (const std::exception& exc) {
+        throw std::runtime_error(std::string("Terminal.configJson: ") + exc.what());
+      }
+    }()),
+    shellId([&]() -> CachedProp<std::optional<std::string>> {
+      try {
+        const react::RawValue* rawValue = rawProps.at("shellId", nullptr, nullptr);
+        if (rawValue == nullptr) return sourceProps.shellId;
+        const auto& [runtime, value] = (std::pair<jsi::Runtime*, jsi::Value>)*rawValue;
+        return CachedProp<std::optional<std::string>>::fromRawValue(*runtime, value, sourceProps.shellId);
+      } catch (const std::exception& exc) {
+        throw std::runtime_error(std::string("Terminal.shellId: ") + exc.what());
+      }
+    }()),
+    hybridRef([&]() -> CachedProp<std::optional<std::function<void(const std::shared_ptr<HybridTerminalSpec>& /* ref */)>>> {
+      try {
+        const react::RawValue* rawValue = rawProps.at("hybridRef", nullptr, nullptr);
+        if (rawValue == nullptr) return sourceProps.hybridRef;
+        const auto& [runtime, value] = (std::pair<jsi::Runtime*, jsi::Value>)*rawValue;
+        return CachedProp<std::optional<std::function<void(const std::shared_ptr<HybridTerminalSpec>& /* ref */)>>>::fromRawValue(*runtime, value.asObject(*runtime).getProperty(*runtime, PropNameIDCache::get(*runtime, "f")), sourceProps.hybridRef);
+      } catch (const std::exception& exc) {
+        throw std::runtime_error(std::string("Terminal.hybridRef: ") + exc.what());
+      }
+    }()) { }
+
+  bool HybridTerminalProps::filterObjectKeys(const std::string& propName) {
+    switch (hashString(propName)) {
+      case hashString("fontPath"): return true;
+      case hashString("configJson"): return true;
+      case hashString("shellId"): return true;
+      case hashString("hybridRef"): return true;
+      default: return false;
+    }
+  }
+
+  HybridTerminalComponentDescriptor::HybridTerminalComponentDescriptor(const react::ComponentDescriptorParameters& parameters)
+    : ConcreteComponentDescriptor(parameters,
+                                  react::RawPropsParser()) {}
+
+  std::shared_ptr<const react::Props> HybridTerminalComponentDescriptor::cloneProps(const react::PropsParserContext& context,
+                                                                                    const std::shared_ptr<const react::Props>& props,
+                                                                                    react::RawProps rawProps) const {
+    // 1. Prepare raw props parser
+    rawProps.parse(rawPropsParser_);
+    // 2. Copy props with Nitro's cached copy constructor
+    return HybridTerminalShadowNode::Props(context, /* & */ rawProps, props);
+  }
+
+#ifdef ANDROID
+  void HybridTerminalComponentDescriptor::adopt(react::ShadowNode& shadowNode) const {
+    // This is called immediately after `ShadowNode` is created, cloned or in progress.
+    // On Android, we need to wrap props in our state, which gets routed through Java and later unwrapped in JNI/C++.
+    auto& concreteShadowNode = static_cast<HybridTerminalShadowNode&>(shadowNode);
+    // NOTE: `getConcreteSharedProps()` returns a DANGLING reference to a temporary
+    // shared_ptr (RN `ConcreteShadowNode::getConcreteSharedProps` returns
+    // `std::static_pointer_cast<...>(props_)` bound to a `const&` return type).
+    // Reading it is UB and yields freed/garbage props in some memory layouts. Cast
+    // the stable `getProps()` member into a local shared_ptr instead.
+    auto props = std::const_pointer_cast<HybridTerminalProps>(
+        std::static_pointer_cast<const HybridTerminalProps>(shadowNode.getProps()));
+    HybridTerminalState state{props};
+    concreteShadowNode.setStateData(std::move(state));
+  }
+#endif
+
+} // namespace margelo::nitro::fressh::views