react-native-nitro-modal 0.1.0

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

@@ -0,0 +1,84 @@
+///
+/// SheetDetent.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/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::nitromodal {
+
+  /**
+   * An enum which can be represented as a JavaScript union (SheetDetent).
+   */
+  enum class SheetDetent {
+    SMALL      SWIFT_NAME(small) = 0,
+    MEDIUM      SWIFT_NAME(medium) = 1,
+    LARGE      SWIFT_NAME(large) = 2,
+    FITCONTENT      SWIFT_NAME(fitcontent) = 3,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::nitromodal
+
+namespace margelo::nitro {
+
+  // C++ SheetDetent <> JS SheetDetent (union)
+  template <>
+  struct JSIConverter<margelo::nitro::nitromodal::SheetDetent> final {
+    static inline margelo::nitro::nitromodal::SheetDetent 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("small"): return margelo::nitro::nitromodal::SheetDetent::SMALL;
+        case hashString("medium"): return margelo::nitro::nitromodal::SheetDetent::MEDIUM;
+        case hashString("large"): return margelo::nitro::nitromodal::SheetDetent::LARGE;
+        case hashString("fitContent"): return margelo::nitro::nitromodal::SheetDetent::FITCONTENT;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum SheetDetent - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::nitromodal::SheetDetent arg) {
+      switch (arg) {
+        case margelo::nitro::nitromodal::SheetDetent::SMALL: return JSIConverter<std::string>::toJSI(runtime, "small");
+        case margelo::nitro::nitromodal::SheetDetent::MEDIUM: return JSIConverter<std::string>::toJSI(runtime, "medium");
+        case margelo::nitro::nitromodal::SheetDetent::LARGE: return JSIConverter<std::string>::toJSI(runtime, "large");
+        case margelo::nitro::nitromodal::SheetDetent::FITCONTENT: return JSIConverter<std::string>::toJSI(runtime, "fitContent");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert SheetDetent 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("small"):
+        case hashString("medium"):
+        case hashString("large"):
+        case hashString("fitContent"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,74 @@
+///
+/// HybridNitroModalComponent.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridNitroModalComponent.hpp"
+
+#include <NitroModules/NitroHash.hpp>
+#include <NitroModules/ReactProp.hpp>
+
+namespace margelo::nitro::nitromodal::views {
+
+  using namespace facebook;
+
+  extern const char HybridNitroModalComponentName[] = "NitroModal";
+
+  HybridNitroModalProps::HybridNitroModalProps(const react::PropsParserContext& context,
+                                               const HybridNitroModalProps& sourceProps,
+                                               const react::RawProps& rawProps):
+    react::ViewProps(context, sourceProps, rawProps, filterObjectKeys),
+    isOpen(nitro::ReactProp<bool>::fromRawValue("NitroModal", "isOpen", rawProps, sourceProps.isOpen)),
+    mode(nitro::ReactProp<ModalMode>::fromRawValue("NitroModal", "mode", rawProps, sourceProps.mode)),
+    detents(nitro::ReactProp<std::vector<SheetDetent>>::fromRawValue("NitroModal", "detents", rawProps, sourceProps.detents)),
+    initialDetentIndex(nitro::ReactProp<double>::fromRawValue("NitroModal", "initialDetentIndex", rawProps, sourceProps.initialDetentIndex)),
+    backdropColor(nitro::ReactProp<double>::fromRawValue("NitroModal", "backdropColor", rawProps, sourceProps.backdropColor)),
+    backdropOpacity(nitro::ReactProp<double>::fromRawValue("NitroModal", "backdropOpacity", rawProps, sourceProps.backdropOpacity)),
+    backdropBlurRadius(nitro::ReactProp<double>::fromRawValue("NitroModal", "backdropBlurRadius", rawProps, sourceProps.backdropBlurRadius)),
+    dismissOnBackdropPress(nitro::ReactProp<bool>::fromRawValue("NitroModal", "dismissOnBackdropPress", rawProps, sourceProps.dismissOnBackdropPress)),
+    dismissOnSwipe(nitro::ReactProp<bool>::fromRawValue("NitroModal", "dismissOnSwipe", rawProps, sourceProps.dismissOnSwipe)),
+    dismissOnBackButton(nitro::ReactProp<bool>::fromRawValue("NitroModal", "dismissOnBackButton", rawProps, sourceProps.dismissOnBackButton)),
+    grabberVisible(nitro::ReactProp<bool>::fromRawValue("NitroModal", "grabberVisible", rawProps, sourceProps.grabberVisible)),
+    cornerRadius(nitro::ReactProp<double>::fromRawValue("NitroModal", "cornerRadius", rawProps, sourceProps.cornerRadius)),
+    contentBackgroundColor(nitro::ReactProp<std::optional<double>>::fromRawValue("NitroModal", "contentBackgroundColor", rawProps, sourceProps.contentBackgroundColor)),
+    keyboardBehavior(nitro::ReactProp<KeyboardBehavior>::fromRawValue("NitroModal", "keyboardBehavior", rawProps, sourceProps.keyboardBehavior)),
+    popupAnimation(nitro::ReactProp<PopupAnimation>::fromRawValue("NitroModal", "popupAnimation", rawProps, sourceProps.popupAnimation)),
+    onPresent(nitro::ReactProp<std::optional<std::function<void()>>>::fromRawValue("NitroModal", "onPresent", rawProps, sourceProps.onPresent)),
+    onDismiss(nitro::ReactProp<std::optional<std::function<void(DismissReason /* reason */)>>>::fromRawValue("NitroModal", "onDismiss", rawProps, sourceProps.onDismiss)),
+    onDetentChange(nitro::ReactProp<std::optional<std::function<void(double /* index */)>>>::fromRawValue("NitroModal", "onDetentChange", rawProps, sourceProps.onDetentChange)),
+    onBackdropPress(nitro::ReactProp<std::optional<std::function<void()>>>::fromRawValue("NitroModal", "onBackdropPress", rawProps, sourceProps.onBackdropPress)),
+    onBackButtonPress(nitro::ReactProp<std::optional<std::function<void()>>>::fromRawValue("NitroModal", "onBackButtonPress", rawProps, sourceProps.onBackButtonPress)),
+    onContentAreaChange(nitro::ReactProp<std::optional<std::function<void(const ModalContentArea& /* area */)>>>::fromRawValue("NitroModal", "onContentAreaChange", rawProps, sourceProps.onContentAreaChange)),
+    hybridRef(nitro::ReactProp<std::optional<std::function<void(const std::shared_ptr<HybridNitroModalSpec>& /* ref */)>>>::fromRawValue("NitroModal", "hybridRef", rawProps, sourceProps.hybridRef)) { }
+
+  bool HybridNitroModalProps::filterObjectKeys(const std::string& propName) {
+    switch (hashString(propName)) {
+      case hashString("isOpen"): return true;
+      case hashString("mode"): return true;
+      case hashString("detents"): return true;
+      case hashString("initialDetentIndex"): return true;
+      case hashString("backdropColor"): return true;
+      case hashString("backdropOpacity"): return true;
+      case hashString("backdropBlurRadius"): return true;
+      case hashString("dismissOnBackdropPress"): return true;
+      case hashString("dismissOnSwipe"): return true;
+      case hashString("dismissOnBackButton"): return true;
+      case hashString("grabberVisible"): return true;
+      case hashString("cornerRadius"): return true;
+      case hashString("contentBackgroundColor"): return true;
+      case hashString("keyboardBehavior"): return true;
+      case hashString("popupAnimation"): return true;
+      case hashString("onPresent"): return true;
+      case hashString("onDismiss"): return true;
+      case hashString("onDetentChange"): return true;
+      case hashString("onBackdropPress"): return true;
+      case hashString("onBackButtonPress"): return true;
+      case hashString("onContentAreaChange"): return true;
+      case hashString("hybridRef"): return true;
+      default: return false;
+    }
+  }
+
+} // namespace margelo::nitro::nitromodal::views

package/nitrogen/generated/shared/c++/views/HybridNitroModalComponent.hpp

@@ -0,0 +1,151 @@
+///
+/// HybridNitroModalComponent.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <NitroModules/ReactProp.hpp>
+#include <NitroModules/ViewComponentDescriptor.hpp>
+#include <NitroModules/ViewPropsHolderState.hpp>
+#include <react/renderer/components/view/ConcreteViewShadowNode.h>
+#include <react/renderer/components/view/ViewProps.h>
+#include <react/renderer/core/PropsParserContext.h>
+#include <react/renderer/core/RawProps.h>
+
+#include <string>
+
+#include "ModalMode.hpp"
+#include "SheetDetent.hpp"
+#include <vector>
+#include <optional>
+#include "KeyboardBehavior.hpp"
+#include "PopupAnimation.hpp"
+#include <functional>
+#include "DismissReason.hpp"
+#include "ModalContentArea.hpp"
+#include <memory>
+#include "HybridNitroModalSpec.hpp"
+
+namespace margelo::nitro::nitromodal::views {
+
+  using namespace facebook;
+
+  /**
+   * The name of the actual native View.
+   */
+  extern const char HybridNitroModalComponentName[];
+
+  /**
+   * Props for the "NitroModal" View.
+   */
+  class HybridNitroModalProps final: public react::ViewProps {
+  public:
+    HybridNitroModalProps() = default;
+    HybridNitroModalProps(const react::PropsParserContext& context,
+                          const HybridNitroModalProps& sourceProps,
+                          const react::RawProps& rawProps);
+
+  public:
+    nitro::ReactProp<bool> isOpen;
+    nitro::ReactProp<ModalMode> mode;
+    nitro::ReactProp<std::vector<SheetDetent>> detents;
+    nitro::ReactProp<double> initialDetentIndex;
+    nitro::ReactProp<double> backdropColor;
+    nitro::ReactProp<double> backdropOpacity;
+    nitro::ReactProp<double> backdropBlurRadius;
+    nitro::ReactProp<bool> dismissOnBackdropPress;
+    nitro::ReactProp<bool> dismissOnSwipe;
+    nitro::ReactProp<bool> dismissOnBackButton;
+    nitro::ReactProp<bool> grabberVisible;
+    nitro::ReactProp<double> cornerRadius;
+    nitro::ReactProp<std::optional<double>> contentBackgroundColor;
+    nitro::ReactProp<KeyboardBehavior> keyboardBehavior;
+    nitro::ReactProp<PopupAnimation> popupAnimation;
+    nitro::ReactProp<std::optional<std::function<void()>>> onPresent;
+    nitro::ReactProp<std::optional<std::function<void(DismissReason /* reason */)>>> onDismiss;
+    nitro::ReactProp<std::optional<std::function<void(double /* index */)>>> onDetentChange;
+    nitro::ReactProp<std::optional<std::function<void()>>> onBackdropPress;
+    nitro::ReactProp<std::optional<std::function<void()>>> onBackButtonPress;
+    nitro::ReactProp<std::optional<std::function<void(const ModalContentArea& /* area */)>>> onContentAreaChange;
+    nitro::ReactProp<std::optional<std::function<void(const std::shared_ptr<HybridNitroModalSpec>& /* ref */)>>> hybridRef;
+
+    [[nodiscard]]
+    bool hasSameProps(const HybridNitroModalProps& other) const noexcept {
+      return isOpen.hasSameValue(other.isOpen) &&
+             mode.hasSameValue(other.mode) &&
+             detents.hasSameValue(other.detents) &&
+             initialDetentIndex.hasSameValue(other.initialDetentIndex) &&
+             backdropColor.hasSameValue(other.backdropColor) &&
+             backdropOpacity.hasSameValue(other.backdropOpacity) &&
+             backdropBlurRadius.hasSameValue(other.backdropBlurRadius) &&
+             dismissOnBackdropPress.hasSameValue(other.dismissOnBackdropPress) &&
+             dismissOnSwipe.hasSameValue(other.dismissOnSwipe) &&
+             dismissOnBackButton.hasSameValue(other.dismissOnBackButton) &&
+             grabberVisible.hasSameValue(other.grabberVisible) &&
+             cornerRadius.hasSameValue(other.cornerRadius) &&
+             contentBackgroundColor.hasSameValue(other.contentBackgroundColor) &&
+             keyboardBehavior.hasSameValue(other.keyboardBehavior) &&
+             popupAnimation.hasSameValue(other.popupAnimation) &&
+             onPresent.hasSameValue(other.onPresent) &&
+             onDismiss.hasSameValue(other.onDismiss) &&
+             onDetentChange.hasSameValue(other.onDetentChange) &&
+             onBackdropPress.hasSameValue(other.onBackdropPress) &&
+             onBackButtonPress.hasSameValue(other.onBackButtonPress) &&
+             onContentAreaChange.hasSameValue(other.onContentAreaChange) &&
+             hybridRef.hasSameValue(other.hybridRef);
+    }
+
+    [[nodiscard]]
+    bool hasAnyProvidedProps() const noexcept {
+      return isOpen.isProvided() ||
+             mode.isProvided() ||
+             detents.isProvided() ||
+             initialDetentIndex.isProvided() ||
+             backdropColor.isProvided() ||
+             backdropOpacity.isProvided() ||
+             backdropBlurRadius.isProvided() ||
+             dismissOnBackdropPress.isProvided() ||
+             dismissOnSwipe.isProvided() ||
+             dismissOnBackButton.isProvided() ||
+             grabberVisible.isProvided() ||
+             cornerRadius.isProvided() ||
+             contentBackgroundColor.isProvided() ||
+             keyboardBehavior.isProvided() ||
+             popupAnimation.isProvided() ||
+             onPresent.isProvided() ||
+             onDismiss.isProvided() ||
+             onDetentChange.isProvided() ||
+             onBackdropPress.isProvided() ||
+             onBackButtonPress.isProvided() ||
+             onContentAreaChange.isProvided() ||
+             hybridRef.isProvided();
+    }
+
+  private:
+    static bool filterObjectKeys(const std::string& propName);
+  };
+
+  /**
+   * State for the "NitroModal" View.
+   */
+  using HybridNitroModalState = nitro::ViewPropsHolderState<HybridNitroModalProps>;
+
+  /**
+   * The Shadow Node for the "NitroModal" View.
+   */
+  using HybridNitroModalShadowNode = react::ConcreteViewShadowNode<HybridNitroModalComponentName /* "HybridNitroModal" */,
+                                                                   HybridNitroModalProps /* custom props */,
+                                                                   react::ViewEventEmitter /* default */,
+                                                                   HybridNitroModalState /* custom state */>;
+
+  /**
+   * The Component Descriptor for the "NitroModal" View.
+   */
+  using HybridNitroModalComponentDescriptor = nitro::ViewComponentDescriptor<HybridNitroModalShadowNode>;
+
+  /* The actual view for "NitroModal" needs to be implemented in platform-specific code. */
+
+} // namespace margelo::nitro::nitromodal::views

package/nitrogen/generated/shared/json/NitroModalConfig.json

@@ -0,0 +1,30 @@
+{
+  "uiViewClassName": "NitroModal",
+  "supportsRawText": false,
+  "bubblingEventTypes": {},
+  "directEventTypes": {},
+  "validAttributes": {
+    "isOpen": true,
+    "mode": true,
+    "detents": true,
+    "initialDetentIndex": true,
+    "backdropColor": true,
+    "backdropOpacity": true,
+    "backdropBlurRadius": true,
+    "dismissOnBackdropPress": true,
+    "dismissOnSwipe": true,
+    "dismissOnBackButton": true,
+    "grabberVisible": true,
+    "cornerRadius": true,
+    "contentBackgroundColor": true,
+    "keyboardBehavior": true,
+    "popupAnimation": true,
+    "onPresent": true,
+    "onDismiss": true,
+    "onDetentChange": true,
+    "onBackdropPress": true,
+    "onBackButtonPress": true,
+    "onContentAreaChange": true,
+    "hybridRef": true
+  }
+}

package/package.json

@@ -0,0 +1,183 @@
+{
+  "name": "react-native-nitro-modal",
+  "version": "0.1.0",
+  "description": "react native native modal",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native-nitro-modal-source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-nitro-modal-example",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mohamadnavabi/react-native-nitro-modal.git"
+  },
+  "author": "Mohammad Navabi <7navabi@gmail.com> (https://github.com/mohamadnavabi)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/mohamadnavabi/react-native-nitro-modal/issues"
+  },
+  "homepage": "https://github.com/mohamadnavabi/react-native-nitro-modal#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^21.2.0",
+    "@eslint/compat": "^2.1.0",
+    "@eslint/eslintrc": "^3.3.6",
+    "@eslint/js": "^9.39.5",
+    "@jest/globals": "^29.7.0",
+    "@react-native/babel-preset": "0.86.2",
+    "@react-native/eslint-config": "0.86.2",
+    "@react-native/jest-preset": "0.86.2",
+    "@release-it/conventional-changelog": "^12.0.0",
+    "@types/react": "^19.2.0",
+    "commitlint": "^21.2.1",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.6",
+    "jest": "^29.7.0",
+    "lefthook": "^2.1.10",
+    "nitrogen": "^0.37.1",
+    "prettier": "^3.9.6",
+    "react": "19.2.3",
+    "react-native": "0.86.3",
+    "react-native-builder-bob": "^0.43.1",
+    "react-native-nitro-modules": "^0.37.1",
+    "release-it": "^21.0.1",
+    "turbo": "^2.10.8",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "^0.37.1"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "testEnvironmentOptions": {
+      "customExportConditions": [
+        "require",
+        "react-native",
+        "<%- project.sourceCondition -%>"
+      ]
+    },
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "nitro-view",
+    "languages": "kotlin-swift",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.63.1"
+  }
+}

package/src/NitroModal.nitro.ts

@@ -0,0 +1,92 @@
+import type {
+  HybridView,
+  HybridViewMethods,
+  HybridViewProps,
+} from 'react-native-nitro-modules';
+
+/**
+ * How the modal is presented.
+ * - `bottomSheet`: native sheet (iOS `UISheetPresentationController`,
+ *   Android `BottomSheetBehavior`) with detents and swipe-to-dismiss.
+ * - `popup`: centered dialog with a native fade/scale transition.
+ */
+export type ModalMode = 'bottomSheet' | 'popup';
+
+/**
+ * Resting heights of a `bottomSheet`.
+ * - `small`: ~25% of the available height.
+ * - `medium`: ~50% of the available height.
+ * - `large`: the full available height.
+ * - `fitContent`: the measured height of the React content.
+ */
+export type SheetDetent = 'small' | 'medium' | 'large' | 'fitContent';
+
+/**
+ * How the modal reacts to the software keyboard.
+ * - `pan`: the sheet/card is translated above the keyboard, in sync with the
+ *   keyboard animation. The content keeps its size.
+ * - `resize`: like `pan`, and the area reported to the content shrinks so
+ *   scrollable content can fit above the keyboard.
+ * - `none`: the keyboard is ignored.
+ */
+export type KeyboardBehavior = 'pan' | 'resize' | 'none';
+
+/** Enter/exit transition of a `popup`. */
+export type PopupAnimation = 'scale' | 'fade' | 'none';
+
+/** What caused the modal to close. */
+export type DismissReason =
+  'programmatic' | 'swipe' | 'backdrop' | 'backButton';
+
+/** Size (dp/pt) available to the React content inside the presented modal. */
+export interface ModalContentArea {
+  width: number;
+  height: number;
+}
+
+export interface NitroModalProps extends HybridViewProps {
+  /** Whether the modal should be presented. */
+  isOpen: boolean;
+  mode: ModalMode;
+  /** Detents of a `bottomSheet`, smallest first. At most 3 are used on Android. */
+  detents: SheetDetent[];
+  /** Index into `detents` that the sheet opens at. */
+  initialDetentIndex: number;
+  /** Backdrop color as a processed ARGB color (see `processColor`). */
+  backdropColor: number;
+  /** Opacity of the backdrop color, 0-1. */
+  backdropOpacity: number;
+  /** Blur radius (dp/pt) applied behind the modal. 0 disables the blur. */
+  backdropBlurRadius: number;
+  dismissOnBackdropPress: boolean;
+  dismissOnSwipe: boolean;
+  dismissOnBackButton: boolean;
+  grabberVisible: boolean;
+  /** Corner radius of the sheet/card. A negative value uses the platform default. */
+  cornerRadius: number;
+  /** Sheet/card background as a processed ARGB color. Omit for the system background. */
+  contentBackgroundColor?: number;
+  keyboardBehavior: KeyboardBehavior;
+  popupAnimation: PopupAnimation;
+
+  /** The present transition finished. */
+  onPresent?: () => void;
+  /** The modal is fully gone. Fired exactly once for every presentation request. */
+  onDismiss?: (reason: DismissReason) => void;
+  /** A `bottomSheet` settled on a different detent. */
+  onDetentChange?: (index: number) => void;
+  onBackdropPress?: () => void;
+  /** Android hardware/gesture back. */
+  onBackButtonPress?: () => void;
+  /** The area available to the content changed (rotation, keyboard, sheet sizing). */
+  onContentAreaChange?: (area: ModalContentArea) => void;
+}
+
+export interface NitroModalMethods extends HybridViewMethods {
+  present(): void;
+  dismiss(): void;
+  /** Animates a `bottomSheet` to `detents[index]`. */
+  snapToDetent(index: number): void;
+}
+
+export type NitroModal = HybridView<NitroModalProps, NitroModalMethods>;