@capacitor/screen-orientation 8.0.0-nightly-20250908T150558.0 → 8.0.0-nightly-20250910T150534.0

package/README.md

@@ -69,6 +69,12 @@ lock(options: OrientationLockOptions) => Promise<void>
 
 Locks the screen orientation.
 
+Starting in Android targetSdk 36, this method has no effect for large screens (e.g. tablets) on Android 16 an higher.
+You may opt-out of this behavior in your app by adding `&lt;property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" /&gt;` to your `AndroidManifest.xml` inside `&lt;application&gt;` or `&lt;activity&gt;`.
+Keep in mind though that this opt-out is temporary will no longer work for Android 17. Android discourages setting specific orientations for large screens.
+Regular Android phones are unaffected by this change.
+For more information check the Android docs at https://developer.android.com/about/versions/16/behavior-changes-16#adaptive-layouts
+
 | Param         | Type                                                                      |
 | ------------- | ------------------------------------------------------------------------- |
 | **`options`** | <code><a href="#orientationlockoptions">OrientationLockOptions</a></code> |

package/dist/docs.json

@@ -39,7 +39,7 @@
             "text": "4.0.0"
           }
         ],
-        "docs": "Locks the screen orientation.",
+        "docs": "Locks the screen orientation.\n\nStarting in Android targetSdk 36, this method has no effect for large screens (e.g. tablets) on Android 16 an higher.\nYou may opt-out of this behavior in your app by adding `<property android:name=\"android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY\" android:value=\"true\" />` to your `AndroidManifest.xml` inside `<application>` or `<activity>`.\nKeep in mind though that this opt-out is temporary will no longer work for Android 17. Android discourages setting specific orientations for large screens.\nRegular Android phones are unaffected by this change.\nFor more information check the Android docs at https://developer.android.com/about/versions/16/behavior-changes-16#adaptive-layouts",
         "complexTypes": [
           "OrientationLockOptions"
         ],

package/dist/esm/definitions.d.ts

@@ -19,6 +19,12 @@ export interface ScreenOrientationPlugin {
     /**
      * Locks the screen orientation.
      *
+     * Starting in Android targetSdk 36, this method has no effect for large screens (e.g. tablets) on Android 16 an higher.
+     * You may opt-out of this behavior in your app by adding `<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />` to your `AndroidManifest.xml` inside `<application>` or `<activity>`.
+     * Keep in mind though that this opt-out is temporary will no longer work for Android 17. Android discourages setting specific orientations for large screens.
+     * Regular Android phones are unaffected by this change.
+     * For more information check the Android docs at https://developer.android.com/about/versions/16/behavior-changes-16#adaptive-layouts
+     *
      * @since 4.0.0
      */
     lock(options: OrientationLockOptions): Promise<void>;

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface OrientationLockOptions {\n  /**\n   * Note: Typescript v5.2+ users should import OrientationLockType from @capacitor/screen-orientation.\n   */\n  orientation: OrientationLockType;\n}\n\nexport type OrientationLockType =\n  | 'any'\n  | 'natural'\n  | 'landscape'\n  | 'portrait'\n  | 'portrait-primary'\n  | 'portrait-secondary'\n  | 'landscape-primary'\n  | 'landscape-secondary';\n\nexport interface ScreenOrientationResult {\n  type: OrientationType;\n}\n\nexport interface ScreenOrientationPlugin {\n  /**\n   * Returns the current screen orientation.\n   *\n   * @since 4.0.0\n   */\n  orientation(): Promise<ScreenOrientationResult>;\n\n  /**\n   * Locks the screen orientation.\n   *\n   * @since 4.0.0\n   */\n  lock(options: OrientationLockOptions): Promise<void>;\n\n  /**\n   * Unlocks the screen's orientation.\n   *\n   * @since 4.0.0\n   */\n  unlock(): Promise<void>;\n\n  /**\n   * Listens for screen orientation changes.\n   *\n   * @since 4.0.0\n   */\n  addListener(\n    eventName: 'screenOrientationChange',\n    listenerFunc: (orientation: ScreenOrientationResult) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Removes all listeners.\n   *\n   * @since 4.0.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface OrientationLockOptions {\n  /**\n   * Note: Typescript v5.2+ users should import OrientationLockType from @capacitor/screen-orientation.\n   */\n  orientation: OrientationLockType;\n}\n\nexport type OrientationLockType =\n  | 'any'\n  | 'natural'\n  | 'landscape'\n  | 'portrait'\n  | 'portrait-primary'\n  | 'portrait-secondary'\n  | 'landscape-primary'\n  | 'landscape-secondary';\n\nexport interface ScreenOrientationResult {\n  type: OrientationType;\n}\n\nexport interface ScreenOrientationPlugin {\n  /**\n   * Returns the current screen orientation.\n   *\n   * @since 4.0.0\n   */\n  orientation(): Promise<ScreenOrientationResult>;\n\n  /**\n   * Locks the screen orientation.\n   *\n   * Starting in Android targetSdk 36, this method has no effect for large screens (e.g. tablets) on Android 16 an higher.\n   * You may opt-out of this behavior in your app by adding `<property android:name=\"android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY\" android:value=\"true\" />` to your `AndroidManifest.xml` inside `<application>` or `<activity>`.\n   * Keep in mind though that this opt-out is temporary will no longer work for Android 17. Android discourages setting specific orientations for large screens.\n   * Regular Android phones are unaffected by this change.\n   * For more information check the Android docs at https://developer.android.com/about/versions/16/behavior-changes-16#adaptive-layouts\n   *\n   * @since 4.0.0\n   */\n  lock(options: OrientationLockOptions): Promise<void>;\n\n  /**\n   * Unlocks the screen's orientation.\n   *\n   * @since 4.0.0\n   */\n  unlock(): Promise<void>;\n\n  /**\n   * Listens for screen orientation changes.\n   *\n   * @since 4.0.0\n   */\n  addListener(\n    eventName: 'screenOrientationChange',\n    listenerFunc: (orientation: ScreenOrientationResult) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Removes all listeners.\n   *\n   * @since 4.0.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capacitor/screen-orientation",
-  "version": "8.0.0-nightly-20250908T150558.0",
+  "version": "8.0.0-nightly-20250910T150534.0",
   "description": "The Screen Orientation API provides methods to lock and unlock the screen orientation.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -81,5 +81,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "4c2f39a8fc78578c919a81ba410d6a37e70152d0"
+  "gitHead": "c0151b2fd21f3b4c6a5efe675ef81f0202b356ec"
 }