react-native-orientation-director 2.0.0 → 2.2.0

package/README.md

@@ -89,6 +89,7 @@ This library exports a class called: [RNOrientationDirector](https://github.com/
 | setHumanReadableOrientations             | Sets the mapping needed to convert orientation values to human readable strings   |
 | setHumanReadableAutoRotations            | Sets the mapping needed to convert auto rotation values to human readable strings |
 | resetSupportedInterfaceOrientations      | Resets the supported interface orientations to settings                           |
+| isLockableOrientation                    | Determines if orientation is lockable                                             |
 
 In addition, the library exposes the following hooks:
 
@@ -100,6 +101,26 @@ In addition, the library exposes the following hooks:
 
 Head over to the [example project](example) to see how to use the library.
 
+### Warning
+
+Please be aware that there is a subtle difference between the device orientation
+and the interface orientation.
+
+When you device is either in landscape left or right orientation, your interface
+is inverted, this is why lockTo method needs a second parameter to discriminate
+which type of orientation your are supplying.
+
+To match developers expectations, if you supply a device orientation and
+OrientationType.device, lockTo switches landscapeRight with left and vice versa
+to property align the interface orientation.
+
+This behavior comes from the native API, you can find more information in their
+documentation:
+
+1. [iOS - UIInterfaceOrientation](https://developer.apple.com/documentation/uikit/uiinterfaceorientation)
+2. [iOS - UIDeviceOrientation](https://developer.apple.com/documentation/uikit/uideviceorientation)
+3. [Android - getRotation](<https://developer.android.com/reference/android/view/Display#getRotation()>)
+
 ### Android
 
 Since on Android we need to deal with sensors and their usage, it is worth noting that the device orientation computation works

package/android/src/main/java/com/orientationdirector/implementation/Orientation.kt

@@ -9,6 +9,7 @@ enum class Orientation {
   LANDSCAPE_RIGHT,
   PORTRAIT_UPSIDE_DOWN,
   LANDSCAPE_LEFT,
+  LANDSCAPE,
   FACE_UP,
   FACE_DOWN,
 }

package/android/src/main/java/com/orientationdirector/implementation/OrientationDirectorModuleImpl.kt

@@ -82,7 +82,22 @@ class OrientationDirectorModuleImpl internal constructor(private val context: Re
     context.currentActivity?.requestedOrientation = screenOrientation
 
     updateIsLockedTo(true)
-    updateLastInterfaceOrientationTo(jsOrientation)
+
+    val orientationCanBeUpdatedDirectly = jsOrientation != Orientation.LANDSCAPE;
+    if (orientationCanBeUpdatedDirectly) {
+      updateLastInterfaceOrientationTo(jsOrientation)
+      return
+    }
+
+    val lastInterfaceOrientationIsAlreadyInLandscape = lastInterfaceOrientation == Orientation.LANDSCAPE_RIGHT
+      || lastInterfaceOrientation == Orientation.LANDSCAPE_LEFT
+      if (lastInterfaceOrientationIsAlreadyInLandscape) {
+        updateLastInterfaceOrientationTo(lastInterfaceOrientation)
+        return;
+      }
+
+    val systemDefaultLandscapeOrientation = Orientation.LANDSCAPE_RIGHT
+      updateLastInterfaceOrientationTo(systemDefaultLandscapeOrientation)
   }
 
   fun unlock() {
@@ -150,7 +165,8 @@ class OrientationDirectorModuleImpl internal constructor(private val context: Re
       return
     }
 
-    if (isLocked) {
+    val supportsLandscape = mUtils.getRequestedOrientation() == ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE;
+    if (isLocked && !supportsLandscape) {
       return
     }
 
@@ -167,6 +183,20 @@ class OrientationDirectorModuleImpl internal constructor(private val context: Re
       newInterfaceOrientation = mUtils.convertToOrientationFromScreenRotation(rotation)
     }
 
+    /**
+     * This differs from iOS because we can't read the actual orientation of the interface,
+     * we read its rotation.
+     * This means that even if the requestedOrientation of the currentActivity is locked to landscape
+     * it reads every possible orientation and this is not what we want.
+     * Instead, we check that its value is either LANDSCAPE_RIGHT or LANDSCAPE_LEFT, otherwise we
+     * exit
+     */
+    val newInterfaceOrientationIsNotLandscape = newInterfaceOrientation != Orientation.LANDSCAPE_RIGHT
+      && newInterfaceOrientation != Orientation.LANDSCAPE_LEFT;
+    if (supportsLandscape && newInterfaceOrientationIsNotLandscape) {
+      return
+    }
+
     if (newInterfaceOrientation == lastInterfaceOrientation) {
       return
     }

package/android/src/main/java/com/orientationdirector/implementation/Utils.kt

@@ -53,6 +53,7 @@ class Utils(private val context: ReactContext) {
       Orientation.LANDSCAPE_RIGHT -> ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
       Orientation.PORTRAIT_UPSIDE_DOWN -> ActivityInfo.SCREEN_ORIENTATION_REVERSE_PORTRAIT
       Orientation.LANDSCAPE_LEFT -> ActivityInfo.SCREEN_ORIENTATION_REVERSE_LANDSCAPE
+      Orientation.LANDSCAPE -> ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE
       else -> ActivityInfo.SCREEN_ORIENTATION_PORTRAIT
     }
   }
@@ -62,6 +63,7 @@ class Utils(private val context: ReactContext) {
       2 -> Orientation.LANDSCAPE_RIGHT
       3 -> Orientation.PORTRAIT_UPSIDE_DOWN
       4 -> Orientation.LANDSCAPE_LEFT
+      5 -> Orientation.LANDSCAPE
       else -> Orientation.PORTRAIT
     }
   }
@@ -84,4 +86,12 @@ class Utils(private val context: ReactContext) {
       else -> Orientation.UNKNOWN
     }
   }
+
+  fun getRequestedOrientation(): Int {
+    if (context.currentActivity?.requestedOrientation == null) {
+      return ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED;
+    }
+
+    return context.currentActivity!!.requestedOrientation;
+  }
 }

package/android/src/test/java/com/orientationdirector/implementation/OrientationDirectorModuleImplTest.kt

@@ -144,6 +144,17 @@ class OrientationDirectorModuleImplTest {
     )
   }
 
+  @Test
+  fun assert_interface_orientation_matches_locked_to_landscape() {
+    mModule.lockTo(5)
+
+    assertEquals(
+      "When the interface is locked to landscape, getInterfaceOrientation should return landscape right",
+      Orientation.LANDSCAPE_RIGHT,
+      mModule.getInterfaceOrientation()
+    )
+  }
+
   @Test
   fun assert_is_locked_reset_when_unlock_is_executed() {
     mModule.lockTo(1)

package/ios/implementation/EventManager.swift

@@ -7,15 +7,15 @@
 
 import Foundation
 
-@objc public class EventManager : NSObject {
-    @objc public weak var delegate: OrientationEventEmitterDelegate? = nil
+@objc public class EventManager: NSObject {
+    @objc public weak var delegate: OrientationEventEmitterDelegate?
 
     func sendDeviceOrientationDidChange(orientationValue: Int) {
         guard let delegate = delegate else {
             return
         }
 
-        if (!delegate.isJsListening) {
+        if !delegate.isJsListening {
             return
         }
 
@@ -28,20 +28,20 @@ import Foundation
             return
         }
 
-        if (!delegate.isJsListening) {
+        if !delegate.isJsListening {
             return
         }
 
         let params = Dictionary(dictionaryLiteral: ("orientation", orientationValue))
         delegate.sendEvent(name: Event.InterfaceOrientationDidChange.rawValue, params: params as NSDictionary)
     }
-    
+
     func sendLockDidChange(value: Bool) {
         guard let delegate = delegate else {
             return
         }
 
-        if (!delegate.isJsListening) {
+        if !delegate.isJsListening {
             return
         }
 
@@ -65,6 +65,6 @@ public extension EventManager {
   }
 
   @objc static var supportedEvents: [String] {
-    return Event.allCases.map(\.rawValue);
+    return Event.allCases.map(\.rawValue)
   }
 }

package/ios/implementation/Orientation.swift

@@ -8,5 +8,5 @@
 import Foundation
 
 @objc public enum Orientation: Int {
-  case UNKNOWN, PORTRAIT, LANDSCAPE_RIGHT, PORTRAIT_UPSIDE_DOWN, LANDSCAPE_LEFT, FACE_UP, FACE_DOWN
+  case UNKNOWN, PORTRAIT, LANDSCAPE_RIGHT, PORTRAIT_UPSIDE_DOWN, LANDSCAPE_LEFT, LANDSCAPE, FACE_UP, FACE_DOWN
 }

package/ios/implementation/OrientationDirectorImpl.swift

@@ -8,7 +8,7 @@
 import Foundation
 import UIKit
 
-@objc public class OrientationDirectorImpl : NSObject {
+@objc public class OrientationDirectorImpl: NSObject {
     private static let TAG = "OrientationDirectorImpl"
 
     private let bundleManager: BundleManager = BundleManager()
@@ -50,7 +50,7 @@ import UIKit
     @objc public func getDeviceOrientation() -> Orientation {
         return lastDeviceOrientation
     }
-    
+
     @objc public func getIsLocked() -> Bool {
         return isLocked
     }
@@ -61,7 +61,21 @@ import UIKit
         self.requestInterfaceUpdateTo(mask: mask)
 
         updateIsLockedTo(value: true)
-        updateLastInterfaceOrientationTo(value: jsOrientation)
+
+        let orientationCanBeUpdatedDirectly = jsOrientation != Orientation.LANDSCAPE
+        if orientationCanBeUpdatedDirectly {
+            updateLastInterfaceOrientationTo(value: jsOrientation)
+            return
+        }
+
+        let lastInterfaceOrientationIsAlreadyInLandscape = lastInterfaceOrientation == Orientation.LANDSCAPE_RIGHT || lastInterfaceOrientation == Orientation.LANDSCAPE_LEFT
+        if lastInterfaceOrientationIsAlreadyInLandscape {
+            updateLastInterfaceOrientationTo(value: lastInterfaceOrientation)
+            return
+        }
+
+        let systemDefaultLandscapeOrientation = Orientation.LANDSCAPE_RIGHT
+        updateLastInterfaceOrientationTo(value: systemDefaultLandscapeOrientation)
     }
 
     @objc public func unlock() {
@@ -78,20 +92,20 @@ import UIKit
 
         let lastMask = utils.convertToMaskFrom(jsOrientation: lastInterfaceOrientation)
         let isLastMaskSupported = self.supportedInterfaceOrientations.contains(lastMask)
-        if (isLastMaskSupported) {
+        if isLastMaskSupported {
             return
         }
 
         let supportedInterfaceOrientations = bundleManager.getSupportedInterfaceOrientations()
-        if (supportedInterfaceOrientations.contains(UIInterfaceOrientationMask.portrait)) {
+        if supportedInterfaceOrientations.contains(UIInterfaceOrientationMask.portrait) {
             self.updateLastInterfaceOrientationTo(value: Orientation.PORTRAIT)
             return
         }
-        if (supportedInterfaceOrientations.contains(UIInterfaceOrientationMask.landscapeRight)) {
+        if supportedInterfaceOrientations.contains(UIInterfaceOrientationMask.landscapeRight) {
             self.updateLastInterfaceOrientationTo(value: Orientation.LANDSCAPE_RIGHT)
             return
         }
-        if (supportedInterfaceOrientations.contains(UIInterfaceOrientationMask.landscapeLeft)) {
+        if supportedInterfaceOrientations.contains(UIInterfaceOrientationMask.landscapeLeft) {
             self.updateLastInterfaceOrientationTo(value: Orientation.LANDSCAPE_LEFT)
             return
         }
@@ -104,10 +118,8 @@ import UIKit
         return supportedInterfaceOrientations.reduce(UIInterfaceOrientationMask()) { $0.union($1) }
     }
 
-    // TODO: FIX BECAUSE IT ALWAYS RETURNS PORTRAIT AND ITS BROKEN
     private func initInterfaceOrientation() -> Orientation {
-        let interfaceOrientation = utils.getInterfaceOrientation()
-        return utils.convertToOrientationFrom(uiInterfaceOrientation: interfaceOrientation)
+        return self.getOrientationFromInterface()
     }
 
     private func initDeviceOrientation() -> Orientation {
@@ -116,7 +128,7 @@ import UIKit
 
     private func initIsLocked() -> Bool {
         let supportedOrientations = bundleManager.getSupportedInterfaceOrientations()
-        if (supportedOrientations.count > 1) {
+        if supportedOrientations.count > 1 {
             return false
         }
 
@@ -156,25 +168,16 @@ import UIKit
     }
 
     private func adaptInterfaceTo(deviceOrientation: Orientation) {
-        if (isLocked) {
+        let supportsLandscape = self.supportedInterfaceOrientations.contains(.landscape)
+        if isLocked && !supportsLandscape {
             return
         }
 
-        if (deviceOrientation == Orientation.FACE_UP || deviceOrientation == Orientation.FACE_DOWN) {
-            return
-        }
-
-        let newInterfaceOrientationMask = utils.convertToMaskFrom(deviceOrientation: deviceOrientation)
-        let isSupported = self.supportedInterfaceOrientations.contains(newInterfaceOrientationMask)
-        if (!isSupported) {
-            return
-        }
-
-        let newInterfaceOrientation = utils.convertToOrientationFrom(mask: newInterfaceOrientationMask)
-        if (newInterfaceOrientation == lastInterfaceOrientation) {
+        if deviceOrientation == Orientation.FACE_UP || deviceOrientation == Orientation.FACE_DOWN {
             return
         }
 
+        let newInterfaceOrientation = self.getOrientationFromInterface()
         updateLastInterfaceOrientationTo(value: newInterfaceOrientation)
     }
 
@@ -187,4 +190,9 @@ import UIKit
         self.eventManager.sendInterfaceOrientationDidChange(orientationValue: value.rawValue)
         lastInterfaceOrientation = value
     }
+
+    private func getOrientationFromInterface() -> Orientation {
+        let interfaceOrientation = utils.getInterfaceOrientation()
+        return utils.convertToOrientationFrom(uiInterfaceOrientation: interfaceOrientation)
+    }
 }

package/ios/implementation/SensorListener.swift

@@ -8,7 +8,7 @@
 import Foundation
 
 public class SensorListener {
-    private var onOrientationDidChangeCallback: ((_ deviceOrientation: UIDeviceOrientation) -> Void)? = nil
+    private var onOrientationDidChangeCallback: ((_ deviceOrientation: UIDeviceOrientation) -> Void)?
 
     init() {
         NotificationCenter.default.addObserver(

package/ios/implementation/Utils.swift

@@ -13,7 +13,7 @@ class Utils {
 
     // TODO: Add .unknown
     public func convertToOrientationFrom(uiInterfaceOrientation: UIInterfaceOrientation) -> Orientation {
-        switch(uiInterfaceOrientation) {
+        switch uiInterfaceOrientation {
         case .landscapeRight:
             return .LANDSCAPE_RIGHT
         case .portraitUpsideDown:
@@ -26,7 +26,7 @@ class Utils {
     }
 
     public func convertToOrientationFrom(deviceOrientation: UIDeviceOrientation) -> Orientation {
-        switch(deviceOrientation) {
+        switch deviceOrientation {
         case .landscapeRight:
             return .LANDSCAPE_RIGHT
         case .portraitUpsideDown:
@@ -43,26 +43,15 @@ class Utils {
     }
 
     public func convertToOrientationFrom(jsValue: NSNumber) -> Orientation {
-        switch(jsValue) {
+        switch jsValue {
         case 2:
             return .LANDSCAPE_RIGHT
         case 3:
             return .PORTRAIT_UPSIDE_DOWN
         case 4:
             return .LANDSCAPE_LEFT
-        default:
-            return .PORTRAIT
-        }
-    }
-
-    public func convertToOrientationFrom(mask: UIInterfaceOrientationMask) -> Orientation {
-        switch(mask) {
-        case .portraitUpsideDown:
-            return .PORTRAIT_UPSIDE_DOWN
-        case .landscapeRight:
-            return .LANDSCAPE_RIGHT
-        case .landscapeLeft:
-            return .LANDSCAPE_LEFT
+        case 5:
+            return .LANDSCAPE
         default:
             return .PORTRAIT
         }
@@ -73,7 +62,7 @@ class Utils {
      https://developer.apple.com/documentation/uikit/uiviewcontroller/1621435-supportedinterfaceorientations
      */
     public func convertToMaskFrom(jsOrientation: Orientation) -> UIInterfaceOrientationMask {
-        switch(jsOrientation) {
+        switch jsOrientation {
         case .PORTRAIT:
             return .portrait
         case .LANDSCAPE_RIGHT:
@@ -82,25 +71,8 @@ class Utils {
             return .portraitUpsideDown
         case .LANDSCAPE_LEFT:
             return .landscapeLeft
-        default:
-            return .all
-        }
-    }
-
-    /**
-     Note: .portraitUpsideDown only works for devices with home button and iPads
-     https://developer.apple.com/documentation/uikit/uiviewcontroller/1621435-supportedinterfaceorientations
-     */
-    public func convertToMaskFrom(deviceOrientation: Orientation) -> UIInterfaceOrientationMask {
-        switch(deviceOrientation) {
-        case .PORTRAIT:
-            return .portrait
-        case .LANDSCAPE_RIGHT:
-            return .landscapeLeft
-        case .PORTRAIT_UPSIDE_DOWN:
-            return .portraitUpsideDown
-        case .LANDSCAPE_LEFT:
-            return .landscapeRight
+        case .LANDSCAPE:
+          return .landscape
         default:
             return .all
         }
@@ -111,7 +83,7 @@ class Utils {
             return UIInterfaceOrientation.unknown
         }
 
-        return windowScene.interfaceOrientation;
+        return windowScene.interfaceOrientation
     }
 
     /* This function is needed to get the current available window.

package/lib/commonjs/RNOrientationDirector.js

@@ -8,6 +8,7 @@ var _reactNative = require("react-native");
 var _module = _interopRequireDefault(require("./module"));
 var _Orientation = require("./types/Orientation.enum");
 var _AutoRotation = require("./types/AutoRotation.enum");
+var _OrientationType = require("./types/OrientationType.enum");
 var _EventEmitter = _interopRequireDefault(require("./EventEmitter"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 class RNOrientationDirector {
@@ -17,6 +18,7 @@ class RNOrientationDirector {
     [_Orientation.Orientation.portraitUpsideDown]: 'Portrait Upside Down',
     [_Orientation.Orientation.landscapeLeft]: 'Landscape Left',
     [_Orientation.Orientation.landscapeRight]: 'Landscape Right',
+    [_Orientation.Orientation.landscape]: 'Landscape',
     [_Orientation.Orientation.faceUp]: 'Face Up',
     [_Orientation.Orientation.faceDown]: 'Face Down'
   };
@@ -37,7 +39,38 @@ class RNOrientationDirector {
   static getDeviceOrientation() {
     return _module.default.getDeviceOrientation();
   }
-  static lockTo(orientation) {
+
+  /**
+   * Please be aware that device orientation is not the
+   * same as interface orientation.
+   *
+   * Specifically, landscape left and right are inverted:
+   *
+   * - landscapeLeft in device orientation is landscapeRight in interface orientation
+   * - landscapeRight in device orientation is landscapeLeft in interface orientation
+   *
+   * This is a behavior of the native API.
+   *
+   * When you pass an orientation value, do provide orientationType
+   * as well if the orientation value is not an interface orientation.
+   * Example: when using listenForDeviceOrientationChanges.
+   *
+   * @param orientation any lockable orientation enum value
+   * @param orientationType any orientation type enum value
+   */
+  static lockTo(orientation, orientationType = _OrientationType.OrientationType.interface) {
+    if (orientationType === _OrientationType.OrientationType.interface) {
+      _module.default.lockTo(orientation);
+      return;
+    }
+    if (orientation === _Orientation.Orientation.landscapeLeft) {
+      _module.default.lockTo(_Orientation.Orientation.landscapeRight);
+      return;
+    }
+    if (orientation === _Orientation.Orientation.landscapeRight) {
+      _module.default.lockTo(_Orientation.Orientation.landscapeLeft);
+      return;
+    }
     _module.default.lockTo(orientation);
   }
   static unlock() {
@@ -70,6 +103,25 @@ class RNOrientationDirector {
   static convertAutoRotationToHumanReadableString(autoRotation) {
     return RNOrientationDirector._humanReadableAutoRotationsResource[autoRotation];
   }
+
+  /**
+   * This method checks if the given orientation is lockable
+   * by interface perspective.
+   *
+   * All orientations are lockable except for unknown, faceUp
+   * and faceDown.
+   *
+   * This method is useful when you want to lock the interface
+   * orientation from a given device orientation.
+   *
+   * Example: with listenForDeviceOrientationChanges
+   *
+   * @param orientation any orientation enum value
+   * @returns true if the orientation is lockable
+   */
+  static isLockableOrientation(orientation) {
+    return !(orientation === _Orientation.Orientation.unknown || orientation === _Orientation.Orientation.faceUp || orientation === _Orientation.Orientation.faceDown);
+  }
 }
 var _default = exports.default = RNOrientationDirector;
 //# sourceMappingURL=RNOrientationDirector.js.map

package/lib/commonjs/RNOrientationDirector.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_module","_interopRequireDefault","_Orientation","_AutoRotation","_EventEmitter","e","__esModule","default","RNOrientationDirector","_humanReadableOrientationsResource","Orientation","unknown","portrait","portraitUpsideDown","landscapeLeft","landscapeRight","faceUp","faceDown","_humanReadableAutoRotationsResource","AutoRotation","enabled","disabled","setHumanReadableOrientations","resource","setHumanReadableAutoRotations","getInterfaceOrientation","Module","getDeviceOrientation","lockTo","orientation","unlock","isLocked","isAutoRotationEnabled","Platform","OS","resetSupportedInterfaceOrientations","listenForDeviceOrientationChanges","callback","EventEmitter","addDeviceOrientationDidChangeListener","listenForInterfaceOrientationChanges","addInterfaceOrientationDidChangeListener","listenForLockChanges","addLockDidChangeListener","convertOrientationToHumanReadableString","convertAutoRotationToHumanReadableString","autoRotation","_default","exports"],"sourceRoot":"../../src","sources":["RNOrientationDirector.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_module","_interopRequireDefault","_Orientation","_AutoRotation","_OrientationType","_EventEmitter","e","__esModule","default","RNOrientationDirector","_humanReadableOrientationsResource","Orientation","unknown","portrait","portraitUpsideDown","landscapeLeft","landscapeRight","landscape","faceUp","faceDown","_humanReadableAutoRotationsResource","AutoRotation","enabled","disabled","setHumanReadableOrientations","resource","setHumanReadableAutoRotations","getInterfaceOrientation","Module","getDeviceOrientation","lockTo","orientation","orientationType","OrientationType","interface","unlock","isLocked","isAutoRotationEnabled","Platform","OS","resetSupportedInterfaceOrientations","listenForDeviceOrientationChanges","callback","EventEmitter","addDeviceOrientationDidChangeListener","listenForInterfaceOrientationChanges","addInterfaceOrientationDidChangeListener","listenForLockChanges","addLockDidChangeListener","convertOrientationToHumanReadableString","convertAutoRotationToHumanReadableString","autoRotation","isLockableOrientation","_default","exports"],"sourceRoot":"../../src","sources":["RNOrientationDirector.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/index.js

@@ -15,6 +15,12 @@ Object.defineProperty(exports, "Orientation", {
     return _Orientation.Orientation;
   }
 });
+Object.defineProperty(exports, "OrientationType", {
+  enumerable: true,
+  get: function () {
+    return _OrientationType.OrientationType;
+  }
+});
 exports.default = void 0;
 Object.defineProperty(exports, "useDeviceOrientation", {
   enumerable: true,
@@ -36,6 +42,7 @@ Object.defineProperty(exports, "useIsInterfaceOrientationLocked", {
 });
 var _Orientation = require("./types/Orientation.enum");
 var _AutoRotation = require("./types/AutoRotation.enum");
+var _OrientationType = require("./types/OrientationType.enum");
 var _useDeviceOrientation = _interopRequireDefault(require("./hooks/useDeviceOrientation.hook"));
 var _useInterfaceOrientation = _interopRequireDefault(require("./hooks/useInterfaceOrientation.hook"));
 var _useIsInterfaceOrientationLocked = _interopRequireDefault(require("./hooks/useIsInterfaceOrientationLocked.hook"));

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_Orientation","require","_AutoRotation","_useDeviceOrientation","_interopRequireDefault","_useInterfaceOrientation","_useIsInterfaceOrientationLocked","_RNOrientationDirector","e","__esModule","default","_default","exports","RNOrientationDirector"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AAEA,IAAAE,qBAAA,GAAAC,sBAAA,CAAAH,OAAA;AAGA,IAAAI,wBAAA,GAAAD,sBAAA,CAAAH,OAAA;AAGA,IAAAK,gCAAA,GAAAF,sBAAA,CAAAH,OAAA;AAGA,IAAAM,sBAAA,GAAAH,sBAAA,CAAAH,OAAA;AAA4D,SAAAG,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAAA,IAAAG,QAAA,GAAAC,OAAA,CAAAF,OAAA,GAC7CG,8BAAqB","ignoreList":[]}
+{"version":3,"names":["_Orientation","require","_AutoRotation","_OrientationType","_useDeviceOrientation","_interopRequireDefault","_useInterfaceOrientation","_useIsInterfaceOrientationLocked","_RNOrientationDirector","e","__esModule","default","_default","exports","RNOrientationDirector"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AACA,IAAAE,gBAAA,GAAAF,OAAA;AAEA,IAAAG,qBAAA,GAAAC,sBAAA,CAAAJ,OAAA;AAGA,IAAAK,wBAAA,GAAAD,sBAAA,CAAAJ,OAAA;AAGA,IAAAM,gCAAA,GAAAF,sBAAA,CAAAJ,OAAA;AAGA,IAAAO,sBAAA,GAAAH,sBAAA,CAAAJ,OAAA;AAA4D,SAAAI,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAAA,IAAAG,QAAA,GAAAC,OAAA,CAAAF,OAAA,GAC7CG,8BAAqB","ignoreList":[]}

package/lib/commonjs/types/Orientation.enum.js

@@ -10,8 +10,9 @@ let Orientation = exports.Orientation = /*#__PURE__*/function (Orientation) {
   Orientation[Orientation["landscapeRight"] = 2] = "landscapeRight";
   Orientation[Orientation["portraitUpsideDown"] = 3] = "portraitUpsideDown";
   Orientation[Orientation["landscapeLeft"] = 4] = "landscapeLeft";
-  Orientation[Orientation["faceUp"] = 5] = "faceUp";
-  Orientation[Orientation["faceDown"] = 6] = "faceDown";
+  Orientation[Orientation["landscape"] = 5] = "landscape";
+  Orientation[Orientation["faceUp"] = 6] = "faceUp";
+  Orientation[Orientation["faceDown"] = 7] = "faceDown";
   return Orientation;
 }({});
 //# sourceMappingURL=Orientation.enum.js.map

package/lib/commonjs/types/Orientation.enum.js.map

@@ -1 +1 @@
-{"version":3,"names":["Orientation","exports"],"sourceRoot":"../../../src","sources":["types/Orientation.enum.ts"],"mappings":";;;;;;IAAYA,WAAW,GAAAC,OAAA,CAAAD,WAAA,0BAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA","ignoreList":[]}
+{"version":3,"names":["Orientation","exports"],"sourceRoot":"../../../src","sources":["types/Orientation.enum.ts"],"mappings":";;;;;;IAAYA,WAAW,GAAAC,OAAA,CAAAD,WAAA,0BAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA","ignoreList":[]}

package/lib/commonjs/types/OrientationType.enum.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OrientationType = void 0;
+let OrientationType = exports.OrientationType = /*#__PURE__*/function (OrientationType) {
+  OrientationType["device"] = "device";
+  OrientationType["interface"] = "interface";
+  return OrientationType;
+}({});
+//# sourceMappingURL=OrientationType.enum.js.map

package/lib/commonjs/types/OrientationType.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OrientationType","exports"],"sourceRoot":"../../../src","sources":["types/OrientationType.enum.ts"],"mappings":";;;;;;IAAYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA","ignoreList":[]}

package/lib/module/RNOrientationDirector.js

@@ -2,6 +2,7 @@ import { Platform } from 'react-native';
 import Module from './module';
 import { Orientation } from './types/Orientation.enum';
 import { AutoRotation } from './types/AutoRotation.enum';
+import { OrientationType } from './types/OrientationType.enum';
 import EventEmitter from './EventEmitter';
 class RNOrientationDirector {
   static _humanReadableOrientationsResource = {
@@ -10,6 +11,7 @@ class RNOrientationDirector {
     [Orientation.portraitUpsideDown]: 'Portrait Upside Down',
     [Orientation.landscapeLeft]: 'Landscape Left',
     [Orientation.landscapeRight]: 'Landscape Right',
+    [Orientation.landscape]: 'Landscape',
     [Orientation.faceUp]: 'Face Up',
     [Orientation.faceDown]: 'Face Down'
   };
@@ -30,7 +32,38 @@ class RNOrientationDirector {
   static getDeviceOrientation() {
     return Module.getDeviceOrientation();
   }
-  static lockTo(orientation) {
+
+  /**
+   * Please be aware that device orientation is not the
+   * same as interface orientation.
+   *
+   * Specifically, landscape left and right are inverted:
+   *
+   * - landscapeLeft in device orientation is landscapeRight in interface orientation
+   * - landscapeRight in device orientation is landscapeLeft in interface orientation
+   *
+   * This is a behavior of the native API.
+   *
+   * When you pass an orientation value, do provide orientationType
+   * as well if the orientation value is not an interface orientation.
+   * Example: when using listenForDeviceOrientationChanges.
+   *
+   * @param orientation any lockable orientation enum value
+   * @param orientationType any orientation type enum value
+   */
+  static lockTo(orientation, orientationType = OrientationType.interface) {
+    if (orientationType === OrientationType.interface) {
+      Module.lockTo(orientation);
+      return;
+    }
+    if (orientation === Orientation.landscapeLeft) {
+      Module.lockTo(Orientation.landscapeRight);
+      return;
+    }
+    if (orientation === Orientation.landscapeRight) {
+      Module.lockTo(Orientation.landscapeLeft);
+      return;
+    }
     Module.lockTo(orientation);
   }
   static unlock() {
@@ -63,6 +96,25 @@ class RNOrientationDirector {
   static convertAutoRotationToHumanReadableString(autoRotation) {
     return RNOrientationDirector._humanReadableAutoRotationsResource[autoRotation];
   }
+
+  /**
+   * This method checks if the given orientation is lockable
+   * by interface perspective.
+   *
+   * All orientations are lockable except for unknown, faceUp
+   * and faceDown.
+   *
+   * This method is useful when you want to lock the interface
+   * orientation from a given device orientation.
+   *
+   * Example: with listenForDeviceOrientationChanges
+   *
+   * @param orientation any orientation enum value
+   * @returns true if the orientation is lockable
+   */
+  static isLockableOrientation(orientation) {
+    return !(orientation === Orientation.unknown || orientation === Orientation.faceUp || orientation === Orientation.faceDown);
+  }
 }
 export default RNOrientationDirector;
 //# sourceMappingURL=RNOrientationDirector.js.map

package/lib/module/RNOrientationDirector.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","Module","Orientation","AutoRotation","EventEmitter","RNOrientationDirector","_humanReadableOrientationsResource","unknown","portrait","portraitUpsideDown","landscapeLeft","landscapeRight","faceUp","faceDown","_humanReadableAutoRotationsResource","enabled","disabled","setHumanReadableOrientations","resource","setHumanReadableAutoRotations","getInterfaceOrientation","getDeviceOrientation","lockTo","orientation","unlock","isLocked","isAutoRotationEnabled","OS","resetSupportedInterfaceOrientations","listenForDeviceOrientationChanges","callback","addDeviceOrientationDidChangeListener","listenForInterfaceOrientationChanges","addInterfaceOrientationDidChangeListener","listenForLockChanges","addLockDidChangeListener","convertOrientationToHumanReadableString","convertAutoRotationToHumanReadableString","autoRotation"],"sourceRoot":"../../src","sources":["RNOrientationDirector.ts"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,MAAM,MAAM,UAAU;AAE7B,SAASC,WAAW,QAAQ,0BAA0B;AACtD,SAASC,YAAY,QAAQ,2BAA2B;AAKxD,OAAOC,YAAY,MAAM,gBAAgB;AAEzC,MAAMC,qBAAqB,CAAC;EAC1B,OAAeC,kCAAkC,GAC/C;IACE,CAACJ,WAAW,CAACK,OAAO,GAAG,SAAS;IAChC,CAACL,WAAW,CAACM,QAAQ,GAAG,UAAU;IAClC,CAACN,WAAW,CAACO,kBAAkB,GAAG,sBAAsB;IACxD,CAACP,WAAW,CAACQ,aAAa,GAAG,gBAAgB;IAC7C,CAACR,WAAW,CAACS,cAAc,GAAG,iBAAiB;IAC/C,CAACT,WAAW,CAACU,MAAM,GAAG,SAAS;IAC/B,CAACV,WAAW,CAACW,QAAQ,GAAG;EAC1B,CAAC;EAEH,OAAeC,mCAAmC,GAChD;IACE,CAACX,YAAY,CAACI,OAAO,GAAG,SAAS;IACjC,CAACJ,YAAY,CAACY,OAAO,GAAG,SAAS;IACjC,CAACZ,YAAY,CAACa,QAAQ,GAAG;EAC3B,CAAC;EAEHC,4BAA4BA,CAACC,QAA2C,EAAE;IACxEb,qBAAqB,CAACC,kCAAkC,GAAGY,QAAQ;EACrE;EAEAC,6BAA6BA,CAACD,QAA4C,EAAE;IAC1Eb,qBAAqB,CAACS,mCAAmC,GAAGI,QAAQ;EACtE;EAEA,OAAOE,uBAAuBA,CAAA,EAAyB;IACrD,OAAOnB,MAAM,CAACmB,uBAAuB,CAAC,CAAC;EACzC;EAEA,OAAOC,oBAAoBA,CAAA,EAAyB;IAClD,OAAOpB,MAAM,CAACoB,oBAAoB,CAAC,CAAC;EACtC;EAEA,OAAOC,MAAMA,CAACC,WAAgC,EAAE;IAC9CtB,MAAM,CAACqB,MAAM,CAACC,WAAW,CAAC;EAC5B;EAEA,OAAOC,MAAMA,CAAA,EAAG;IACdvB,MAAM,CAACuB,MAAM,CAAC,CAAC;EACjB;EAEA,OAAOC,QAAQA,CAAA,EAAG;IAChB,OAAOxB,MAAM,CAACwB,QAAQ,CAAC,CAAC;EAC1B;EAEA,OAAOC,qBAAqBA,CAAA,EAAG;IAC7B,IAAI1B,QAAQ,CAAC2B,EAAE,KAAK,SAAS,EAAE;MAC7B,OAAOxB,YAAY,CAACI,OAAO;IAC7B;IACA,OAAON,MAAM,CAACyB,qBAAqB,CAAC,CAAC,GACjCvB,YAAY,CAACY,OAAO,GACpBZ,YAAY,CAACa,QAAQ;EAC3B;EAEA,OAAOY,mCAAmCA,CAAA,EAAG;IAC3C3B,MAAM,CAAC2B,mCAAmC,CAAC,CAAC;EAC9C;EAEA,OAAOC,iCAAiCA,CACtCC,QAAiD,EACjD;IACA,OAAO1B,YAAY,CAAC2B,qCAAqC,CAACD,QAAQ,CAAC;EACrE;EAEA,OAAOE,oCAAoCA,CACzCF,QAAiD,EACjD;IACA,OAAO1B,YAAY,CAAC6B,wCAAwC,CAACH,QAAQ,CAAC;EACxE;EAEA,OAAOI,oBAAoBA,CAACJ,QAAsC,EAAE;IAClE,OAAO1B,YAAY,CAAC+B,wBAAwB,CAACL,QAAQ,CAAC;EACxD;EAEA,OAAOM,uCAAuCA,CAACb,WAAwB,EAAE;IACvE,OAAOlB,qBAAqB,CAACC,kCAAkC,CAC7DiB,WAAW,CACZ;EACH;EAEA,OAAOc,wCAAwCA,CAACC,YAA0B,EAAE;IAC1E,OAAOjC,qBAAqB,CAACS,mCAAmC,CAC9DwB,YAAY,CACb;EACH;AACF;AAEA,eAAejC,qBAAqB","ignoreList":[]}
+{"version":3,"names":["Platform","Module","Orientation","AutoRotation","OrientationType","EventEmitter","RNOrientationDirector","_humanReadableOrientationsResource","unknown","portrait","portraitUpsideDown","landscapeLeft","landscapeRight","landscape","faceUp","faceDown","_humanReadableAutoRotationsResource","enabled","disabled","setHumanReadableOrientations","resource","setHumanReadableAutoRotations","getInterfaceOrientation","getDeviceOrientation","lockTo","orientation","orientationType","interface","unlock","isLocked","isAutoRotationEnabled","OS","resetSupportedInterfaceOrientations","listenForDeviceOrientationChanges","callback","addDeviceOrientationDidChangeListener","listenForInterfaceOrientationChanges","addInterfaceOrientationDidChangeListener","listenForLockChanges","addLockDidChangeListener","convertOrientationToHumanReadableString","convertAutoRotationToHumanReadableString","autoRotation","isLockableOrientation"],"sourceRoot":"../../src","sources":["RNOrientationDirector.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -1,5 +1,6 @@
 export { Orientation } from './types/Orientation.enum';
 export { AutoRotation } from './types/AutoRotation.enum';
+export { OrientationType } from './types/OrientationType.enum';
 import useDeviceOrientation from './hooks/useDeviceOrientation.hook';
 export { useDeviceOrientation };
 import useInterfaceOrientation from './hooks/useInterfaceOrientation.hook';

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Orientation","AutoRotation","useDeviceOrientation","useInterfaceOrientation","useIsInterfaceOrientationLocked","RNOrientationDirector"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,WAAW,QAAQ,0BAA0B;AACtD,SAASC,YAAY,QAAQ,2BAA2B;AAExD,OAAOC,oBAAoB,MAAM,mCAAmC;AACpE,SAASA,oBAAoB;AAE7B,OAAOC,uBAAuB,MAAM,sCAAsC;AAC1E,SAASA,uBAAuB;AAEhC,OAAOC,+BAA+B,MAAM,8CAA8C;AAC1F,SAASA,+BAA+B;AAExC,OAAOC,qBAAqB,MAAM,yBAAyB;AAC3D,eAAeA,qBAAqB","ignoreList":[]}
+{"version":3,"names":["Orientation","AutoRotation","OrientationType","useDeviceOrientation","useInterfaceOrientation","useIsInterfaceOrientationLocked","RNOrientationDirector"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,WAAW,QAAQ,0BAA0B;AACtD,SAASC,YAAY,QAAQ,2BAA2B;AACxD,SAASC,eAAe,QAAQ,8BAA8B;AAE9D,OAAOC,oBAAoB,MAAM,mCAAmC;AACpE,SAASA,oBAAoB;AAE7B,OAAOC,uBAAuB,MAAM,sCAAsC;AAC1E,SAASA,uBAAuB;AAEhC,OAAOC,+BAA+B,MAAM,8CAA8C;AAC1F,SAASA,+BAA+B;AAExC,OAAOC,qBAAqB,MAAM,yBAAyB;AAC3D,eAAeA,qBAAqB","ignoreList":[]}

package/lib/module/types/Orientation.enum.js

@@ -4,8 +4,9 @@ export let Orientation = /*#__PURE__*/function (Orientation) {
   Orientation[Orientation["landscapeRight"] = 2] = "landscapeRight";
   Orientation[Orientation["portraitUpsideDown"] = 3] = "portraitUpsideDown";
   Orientation[Orientation["landscapeLeft"] = 4] = "landscapeLeft";
-  Orientation[Orientation["faceUp"] = 5] = "faceUp";
-  Orientation[Orientation["faceDown"] = 6] = "faceDown";
+  Orientation[Orientation["landscape"] = 5] = "landscape";
+  Orientation[Orientation["faceUp"] = 6] = "faceUp";
+  Orientation[Orientation["faceDown"] = 7] = "faceDown";
   return Orientation;
 }({});
 //# sourceMappingURL=Orientation.enum.js.map

package/lib/module/types/Orientation.enum.js.map

@@ -1 +1 @@
-{"version":3,"names":["Orientation"],"sourceRoot":"../../../src","sources":["types/Orientation.enum.ts"],"mappings":"AAAA,WAAYA,WAAW,0BAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA","ignoreList":[]}
+{"version":3,"names":["Orientation"],"sourceRoot":"../../../src","sources":["types/Orientation.enum.ts"],"mappings":"AAAA,WAAYA,WAAW,0BAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA","ignoreList":[]}

package/lib/module/types/OrientationType.enum.js

@@ -0,0 +1,6 @@
+export let OrientationType = /*#__PURE__*/function (OrientationType) {
+  OrientationType["device"] = "device";
+  OrientationType["interface"] = "interface";
+  return OrientationType;
+}({});
+//# sourceMappingURL=OrientationType.enum.js.map

package/lib/module/types/OrientationType.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OrientationType"],"sourceRoot":"../../../src","sources":["types/OrientationType.enum.ts"],"mappings":"AAAA,WAAYA,eAAe,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA","ignoreList":[]}

package/lib/typescript/src/RNOrientationDirector.d.ts

@@ -1,6 +1,7 @@
 import type { HumanReadableOrientationsResource } from './types/HumanReadableOrientationsResource.type';
 import { Orientation } from './types/Orientation.enum';
 import { AutoRotation } from './types/AutoRotation.enum';
+import { OrientationType } from './types/OrientationType.enum';
 import type { OrientationEvent } from './types/OrientationEvent.interface';
 import type { LockableOrientation } from './types/LockableOrientation.type';
 import type { LockedEvent } from './types/LockedEvent.interface';
@@ -12,7 +13,25 @@ declare class RNOrientationDirector {
     setHumanReadableAutoRotations(resource: HumanReadableAutoRotationsResource): void;
     static getInterfaceOrientation(): Promise<Orientation>;
     static getDeviceOrientation(): Promise<Orientation>;
-    static lockTo(orientation: LockableOrientation): void;
+    /**
+     * Please be aware that device orientation is not the
+     * same as interface orientation.
+     *
+     * Specifically, landscape left and right are inverted:
+     *
+     * - landscapeLeft in device orientation is landscapeRight in interface orientation
+     * - landscapeRight in device orientation is landscapeLeft in interface orientation
+     *
+     * This is a behavior of the native API.
+     *
+     * When you pass an orientation value, do provide orientationType
+     * as well if the orientation value is not an interface orientation.
+     * Example: when using listenForDeviceOrientationChanges.
+     *
+     * @param orientation any lockable orientation enum value
+     * @param orientationType any orientation type enum value
+     */
+    static lockTo(orientation: LockableOrientation, orientationType?: OrientationType): void;
     static unlock(): void;
     static isLocked(): boolean;
     static isAutoRotationEnabled(): AutoRotation;
@@ -22,6 +41,22 @@ declare class RNOrientationDirector {
     static listenForLockChanges(callback: (event: LockedEvent) => void): import("react-native").EmitterSubscription;
     static convertOrientationToHumanReadableString(orientation: Orientation): string;
     static convertAutoRotationToHumanReadableString(autoRotation: AutoRotation): string;
+    /**
+     * This method checks if the given orientation is lockable
+     * by interface perspective.
+     *
+     * All orientations are lockable except for unknown, faceUp
+     * and faceDown.
+     *
+     * This method is useful when you want to lock the interface
+     * orientation from a given device orientation.
+     *
+     * Example: with listenForDeviceOrientationChanges
+     *
+     * @param orientation any orientation enum value
+     * @returns true if the orientation is lockable
+     */
+    static isLockableOrientation(orientation: Orientation): orientation is LockableOrientation;
 }
 export default RNOrientationDirector;
 //# sourceMappingURL=RNOrientationDirector.d.ts.map

package/lib/typescript/src/RNOrientationDirector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RNOrientationDirector.d.ts","sourceRoot":"","sources":["../../../src/RNOrientationDirector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gDAAgD,CAAC;AACxG,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,iDAAiD,CAAC;AAG1G,cAAM,qBAAqB;IACzB,OAAO,CAAC,MAAM,CAAC,kCAAkC,CAS7C;IAEJ,OAAO,CAAC,MAAM,CAAC,mCAAmC,CAK9C;IAEJ,4BAA4B,CAAC,QAAQ,EAAE,iCAAiC;IAIxE,6BAA6B,CAAC,QAAQ,EAAE,kCAAkC;IAI1E,MAAM,CAAC,uBAAuB,IAAI,OAAO,CAAC,WAAW,CAAC;IAItD,MAAM,CAAC,oBAAoB,IAAI,OAAO,CAAC,WAAW,CAAC;IAInD,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,mBAAmB;IAI9C,MAAM,CAAC,MAAM;IAIb,MAAM,CAAC,QAAQ;IAIf,MAAM,CAAC,qBAAqB;IAS5B,MAAM,CAAC,mCAAmC;IAI1C,MAAM,CAAC,iCAAiC,CACtC,QAAQ,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,IAAI;IAKnD,MAAM,CAAC,oCAAoC,CACzC,QAAQ,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,IAAI;IAKnD,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAIlE,MAAM,CAAC,uCAAuC,CAAC,WAAW,EAAE,WAAW;IAMvE,MAAM,CAAC,wCAAwC,CAAC,YAAY,EAAE,YAAY;CAK3E;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"RNOrientationDirector.d.ts","sourceRoot":"","sources":["../../../src/RNOrientationDirector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gDAAgD,CAAC;AACxG,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,iDAAiD,CAAC;AAG1G,cAAM,qBAAqB;IACzB,OAAO,CAAC,MAAM,CAAC,kCAAkC,CAU7C;IAEJ,OAAO,CAAC,MAAM,CAAC,mCAAmC,CAK9C;IAEJ,4BAA4B,CAAC,QAAQ,EAAE,iCAAiC;IAIxE,6BAA6B,CAAC,QAAQ,EAAE,kCAAkC;IAI1E,MAAM,CAAC,uBAAuB,IAAI,OAAO,CAAC,WAAW,CAAC;IAItD,MAAM,CAAC,oBAAoB,IAAI,OAAO,CAAC,WAAW,CAAC;IAInD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,MAAM,CACX,WAAW,EAAE,mBAAmB,EAChC,eAAe,GAAE,eAA2C;IAoB9D,MAAM,CAAC,MAAM;IAIb,MAAM,CAAC,QAAQ;IAIf,MAAM,CAAC,qBAAqB;IAS5B,MAAM,CAAC,mCAAmC;IAI1C,MAAM,CAAC,iCAAiC,CACtC,QAAQ,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,IAAI;IAKnD,MAAM,CAAC,oCAAoC,CACzC,QAAQ,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,IAAI;IAKnD,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAIlE,MAAM,CAAC,uCAAuC,CAAC,WAAW,EAAE,WAAW;IAMvE,MAAM,CAAC,wCAAwC,CAAC,YAAY,EAAE,YAAY;IAM1E;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,qBAAqB,CAC1B,WAAW,EAAE,WAAW,GACvB,WAAW,IAAI,mBAAmB;CAOtC;AAED,eAAe,qBAAqB,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,5 +1,6 @@
 export { Orientation } from './types/Orientation.enum';
 export { AutoRotation } from './types/AutoRotation.enum';
+export { OrientationType } from './types/OrientationType.enum';
 import useDeviceOrientation from './hooks/useDeviceOrientation.hook';
 export { useDeviceOrientation };
 import useInterfaceOrientation from './hooks/useInterfaceOrientation.hook';

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,oBAAoB,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,OAAO,uBAAuB,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC,OAAO,+BAA+B,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,+BAA+B,EAAE,CAAC;AAE3C,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,oBAAoB,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,OAAO,uBAAuB,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC,OAAO,+BAA+B,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,+BAA+B,EAAE,CAAC;AAE3C,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,eAAe,qBAAqB,CAAC"}

package/lib/typescript/src/types/LockableOrientation.type.d.ts

@@ -1,3 +1,3 @@
 import { Orientation } from './Orientation.enum';
-export type LockableOrientation = Orientation.portrait | Orientation.portraitUpsideDown | Orientation.landscapeLeft | Orientation.landscapeRight;
+export type LockableOrientation = Orientation.portrait | Orientation.portraitUpsideDown | Orientation.landscapeLeft | Orientation.landscapeRight | Orientation.landscape;
 //# sourceMappingURL=LockableOrientation.type.d.ts.map

package/lib/typescript/src/types/LockableOrientation.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LockableOrientation.type.d.ts","sourceRoot":"","sources":["../../../../src/types/LockableOrientation.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAC3B,WAAW,CAAC,QAAQ,GACpB,WAAW,CAAC,kBAAkB,GAC9B,WAAW,CAAC,aAAa,GACzB,WAAW,CAAC,cAAc,CAAC"}
+{"version":3,"file":"LockableOrientation.type.d.ts","sourceRoot":"","sources":["../../../../src/types/LockableOrientation.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAC3B,WAAW,CAAC,QAAQ,GACpB,WAAW,CAAC,kBAAkB,GAC9B,WAAW,CAAC,aAAa,GACzB,WAAW,CAAC,cAAc,GAC1B,WAAW,CAAC,SAAS,CAAC"}

package/lib/typescript/src/types/Orientation.enum.d.ts

@@ -4,7 +4,8 @@ export declare enum Orientation {
     landscapeRight = 2,
     portraitUpsideDown = 3,
     landscapeLeft = 4,
-    faceUp = 5,
-    faceDown = 6
+    landscape = 5,
+    faceUp = 6,
+    faceDown = 7
 }
 //# sourceMappingURL=Orientation.enum.d.ts.map

package/lib/typescript/src/types/Orientation.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Orientation.enum.d.ts","sourceRoot":"","sources":["../../../../src/types/Orientation.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,cAAc,IAAI;IAClB,kBAAkB,IAAI;IACtB,aAAa,IAAI;IACjB,MAAM,IAAI;IACV,QAAQ,IAAI;CACb"}
+{"version":3,"file":"Orientation.enum.d.ts","sourceRoot":"","sources":["../../../../src/types/Orientation.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,cAAc,IAAI;IAClB,kBAAkB,IAAI;IACtB,aAAa,IAAI;IACjB,SAAS,IAAI;IACb,MAAM,IAAI;IACV,QAAQ,IAAI;CACb"}

package/lib/typescript/src/types/OrientationType.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum OrientationType {
+    device = "device",
+    interface = "interface"
+}
+//# sourceMappingURL=OrientationType.enum.d.ts.map

package/lib/typescript/src/types/OrientationType.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrientationType.enum.d.ts","sourceRoot":"","sources":["../../../../src/types/OrientationType.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-orientation-director",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "A Modern React Native library that allows you to access orientation",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/RNOrientationDirector.ts

@@ -3,6 +3,7 @@ import Module from './module';
 import type { HumanReadableOrientationsResource } from './types/HumanReadableOrientationsResource.type';
 import { Orientation } from './types/Orientation.enum';
 import { AutoRotation } from './types/AutoRotation.enum';
+import { OrientationType } from './types/OrientationType.enum';
 import type { OrientationEvent } from './types/OrientationEvent.interface';
 import type { LockableOrientation } from './types/LockableOrientation.type';
 import type { LockedEvent } from './types/LockedEvent.interface';
@@ -17,6 +18,7 @@ class RNOrientationDirector {
       [Orientation.portraitUpsideDown]: 'Portrait Upside Down',
       [Orientation.landscapeLeft]: 'Landscape Left',
       [Orientation.landscapeRight]: 'Landscape Right',
+      [Orientation.landscape]: 'Landscape',
       [Orientation.faceUp]: 'Face Up',
       [Orientation.faceDown]: 'Face Down',
     };
@@ -44,7 +46,43 @@ class RNOrientationDirector {
     return Module.getDeviceOrientation();
   }
 
-  static lockTo(orientation: LockableOrientation) {
+  /**
+   * Please be aware that device orientation is not the
+   * same as interface orientation.
+   *
+   * Specifically, landscape left and right are inverted:
+   *
+   * - landscapeLeft in device orientation is landscapeRight in interface orientation
+   * - landscapeRight in device orientation is landscapeLeft in interface orientation
+   *
+   * This is a behavior of the native API.
+   *
+   * When you pass an orientation value, do provide orientationType
+   * as well if the orientation value is not an interface orientation.
+   * Example: when using listenForDeviceOrientationChanges.
+   *
+   * @param orientation any lockable orientation enum value
+   * @param orientationType any orientation type enum value
+   */
+  static lockTo(
+    orientation: LockableOrientation,
+    orientationType: OrientationType = OrientationType.interface
+  ) {
+    if (orientationType === OrientationType.interface) {
+      Module.lockTo(orientation);
+      return;
+    }
+
+    if (orientation === Orientation.landscapeLeft) {
+      Module.lockTo(Orientation.landscapeRight);
+      return;
+    }
+
+    if (orientation === Orientation.landscapeRight) {
+      Module.lockTo(Orientation.landscapeLeft);
+      return;
+    }
+
     Module.lockTo(orientation);
   }
 
@@ -96,6 +134,31 @@ class RNOrientationDirector {
       autoRotation
     ];
   }
+
+  /**
+   * This method checks if the given orientation is lockable
+   * by interface perspective.
+   *
+   * All orientations are lockable except for unknown, faceUp
+   * and faceDown.
+   *
+   * This method is useful when you want to lock the interface
+   * orientation from a given device orientation.
+   *
+   * Example: with listenForDeviceOrientationChanges
+   *
+   * @param orientation any orientation enum value
+   * @returns true if the orientation is lockable
+   */
+  static isLockableOrientation(
+    orientation: Orientation
+  ): orientation is LockableOrientation {
+    return !(
+      orientation === Orientation.unknown ||
+      orientation === Orientation.faceUp ||
+      orientation === Orientation.faceDown
+    );
+  }
 }
 
 export default RNOrientationDirector;

package/src/index.tsx

@@ -1,5 +1,6 @@
 export { Orientation } from './types/Orientation.enum';
 export { AutoRotation } from './types/AutoRotation.enum';
+export { OrientationType } from './types/OrientationType.enum';
 
 import useDeviceOrientation from './hooks/useDeviceOrientation.hook';
 export { useDeviceOrientation };

package/src/types/LockableOrientation.type.ts

@@ -4,4 +4,5 @@ export type LockableOrientation =
   | Orientation.portrait
   | Orientation.portraitUpsideDown
   | Orientation.landscapeLeft
-  | Orientation.landscapeRight;
+  | Orientation.landscapeRight
+  | Orientation.landscape;

package/src/types/Orientation.enum.ts

@@ -4,6 +4,7 @@ export enum Orientation {
   landscapeRight = 2,
   portraitUpsideDown = 3,
   landscapeLeft = 4,
-  faceUp = 5,
-  faceDown = 6,
+  landscape = 5,
+  faceUp = 6,
+  faceDown = 7,
 }

package/src/types/OrientationType.enum.ts

@@ -0,0 +1,4 @@
+export enum OrientationType {
+  device = 'device',
+  interface = 'interface',
+}