@capgo/capacitor-screen-orientation 8.1.21 → 8.3.0

package/dist/esm/definitions.d.ts

@@ -107,6 +107,258 @@ export interface StartOrientationTrackingOptions {
      */
     bypassOrientationLock?: boolean;
 }
+/**
+ * How open a foldable is.
+ *
+ * `closed` is reserved. A device shut onto its cover display reports `flat`.
+ *
+ * @since 8.2.0
+ */
+export type FoldStateValue = 'flat' | 'half-opened';
+/**
+ * How a half-open foldable is held.
+ *
+ * `tabletop` is a horizontal hinge, like a laptop. `book` is a vertical hinge.
+ *
+ * @since 8.2.0
+ */
+export type FoldPosture = 'flat' | 'tabletop' | 'book';
+/**
+ * Direction of the hinge relative to the window.
+ *
+ * @since 8.2.0
+ */
+export type HingeOrientation = 'horizontal' | 'vertical';
+/**
+ * A rectangle in CSS pixels, relative to the web view.
+ *
+ * @since 8.2.0
+ */
+export interface FoldBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Current fold of the window.
+ *
+ * Phones that do not fold, and iOS before 27.1, resolve to a flat state.
+ * iPhone Duo reports `book`, `tabletop`, or `flat`, and which display is in front.
+ *
+ * @since 8.2.0
+ */
+export interface FoldState {
+    /**
+     * Posture of the fold.
+     *
+     * @since 8.2.0
+     */
+    state: FoldStateValue;
+    /**
+     * Whether the fold splits the web view into two areas.
+     *
+     * @since 8.2.0
+     */
+    isSeparating: boolean;
+    /**
+     * How the device is held.
+     *
+     * @since 8.2.0
+     */
+    posture: FoldPosture;
+    /**
+     * Direction of the hinge. Omitted when there is no fold.
+     *
+     * @since 8.2.0
+     */
+    hingeOrientation?: HingeOrientation;
+    /**
+     * Position of the fold in CSS pixels. Omitted when there is no fold.
+     *
+     * @since 8.2.0
+     */
+    hingeBounds?: FoldBounds;
+    /**
+     * Area the hinge covers. Present when the hinge has a physical gap.
+     *
+     * @since 8.2.0
+     */
+    occludedBounds?: FoldBounds;
+    /**
+     * Which display is showing the app on iPhone Duo. Omitted on Android, web, and iOS before 27.1.
+     *
+     * @since 8.2.0
+     */
+    activeDisplay?: 'inner' | 'outer';
+    /**
+     * Space the system keeps clear around the fold, in CSS pixels. iPhone Duo reports 20 on each side of a vertical fold.
+     *
+     * @since 8.2.0
+     */
+    hingeMargins?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /**
+     * Areas covering the display, such as the iPhone Duo camera. Omitted when there are none.
+     *
+     * @since 8.2.0
+     */
+    cameraBounds?: FoldBounds[];
+}
+/**
+ * Whether this device can fold.
+ *
+ * @since 8.2.0
+ */
+export interface DeviceFoldableResult {
+    /**
+     * Whether the device has a fold.
+     *
+     * @since 8.2.0
+     */
+    foldable: boolean;
+    /**
+     * Whether it can stand half-open like a laptop.
+     *
+     * @since 8.2.0
+     */
+    supportsTabletop: boolean;
+}
+/**
+ * Angle between the two halves of a foldable, in degrees.
+ *
+ * `0` is closed and `180` is flat. `angle` is `null` when the device has no hinge sensor.
+ *
+ * @since 8.2.0
+ */
+export interface HingeAngleResult {
+    /**
+     * Hinge angle in degrees, or `null` when no sensor is available.
+     *
+     * @since 8.2.0
+     */
+    angle: number | null;
+    /**
+     * How far open iPhone Duo is, as the system sees it. `null` on Android and web.
+     *
+     * @since 8.2.0
+     */
+    status?: 'closed' | 'partiallyOpen' | 'fullyOpen' | null;
+}
+/**
+ * A region the system reserves on iPhone Duo.
+ *
+ * `division` is the fold. `occlusion` is something covering the display, such as the camera.
+ *
+ * @since 8.2.0
+ */
+export interface ReservedRegion {
+    /**
+     * What the region is.
+     *
+     * @since 8.2.0
+     */
+    kind: 'division' | 'occlusion';
+    /**
+     * Whether the region applies right now. An inactive division is a flat fold.
+     *
+     * @since 8.2.0
+     */
+    isActive: boolean;
+    /**
+     * Left edge, in CSS pixels.
+     *
+     * @since 8.2.0
+     */
+    x: number;
+    /**
+     * Top edge, in CSS pixels.
+     *
+     * @since 8.2.0
+     */
+    y: number;
+    /**
+     * Width in CSS pixels.
+     *
+     * @since 8.2.0
+     */
+    width: number;
+    /**
+     * Height in CSS pixels.
+     *
+     * @since 8.2.0
+     */
+    height: number;
+    /**
+     * Space to keep clear around the region, in CSS pixels.
+     *
+     * @since 8.2.0
+     */
+    margins: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+/**
+ * Where iPhone Duo places native bars.
+ *
+ * @since 8.2.0
+ */
+export interface BarPlacement {
+    /**
+     * The edge the system moves tab bars and toolbars to. `null` when they stay horizontal.
+     *
+     * @since 8.2.0
+     */
+    verticalBarEdge: 'leading' | 'trailing' | null;
+    /**
+     * How much room the vertical bar takes, in points. `0` when bars stay horizontal.
+     *
+     * @since 8.2.0
+     */
+    inset: number;
+}
+/**
+ * Window size classes.
+ *
+ * `horizontal` and `vertical` follow Apple's compact/regular split.
+ * On Android and web, `regular` starts at 600 CSS pixels wide and 480 tall.
+ * `widthClass` and `heightClass` follow Material window size classes.
+ *
+ * @since 8.2.0
+ */
+export interface SizeClass {
+    /**
+     * Width size class. `compact` on a phone, `regular` on the inner display of a foldable, a tablet, or a window at least 600 CSS pixels wide.
+     *
+     * @since 8.2.0
+     */
+    horizontal: 'compact' | 'regular';
+    /**
+     * Height size class. `regular` starts at 480 CSS pixels.
+     *
+     * @since 8.2.0
+     */
+    vertical: 'compact' | 'regular';
+    /**
+     * Material window width class.
+     *
+     * @since 8.2.0
+     */
+    widthClass: 'compact' | 'medium' | 'expanded' | 'large' | 'extraLarge';
+    /**
+     * Material window height class.
+     *
+     * @since 8.2.0
+     */
+    heightClass: 'compact' | 'medium' | 'expanded';
+}
 /**
  * Capacitor Screen Orientation Plugin interface.
  *
@@ -267,7 +519,130 @@ export interface CapacitorScreenOrientationPlugin {
      * await listener.remove();
      * ```
      */
+    /**
+     * Whether this device folds, and whether it can stand half-open like a laptop.
+     *
+     * Both flags are `false` on web, on Android phones that do not fold, and on iOS except iPhone Duo (iOS 27.1 or later).
+     *
+     * @since 8.2.0
+     * @returns {Promise<DeviceFoldableResult>} Fold capability of this device.
+     *
+     * @example
+     * ```typescript
+     * const { foldable, supportsTabletop } = await ScreenOrientation.isDeviceFoldable();
+     * ```
+     */
+    isDeviceFoldable(): Promise<DeviceFoldableResult>;
+    /**
+     * Read the current fold.
+     *
+     * Resolves to a flat state when the device has no fold.
+     *
+     * @since 8.2.0
+     * @returns {Promise<FoldState>} The current fold state.
+     *
+     * @example
+     * ```typescript
+     * const { posture, hingeOrientation } = await ScreenOrientation.getFoldState();
+     * ```
+     */
+    getFoldState(): Promise<FoldState>;
+    /**
+     * Read the hinge angle in degrees.
+     *
+     * `0` is closed and `180` is flat. `angle` is `null` without a hinge sensor.
+     *
+     * @since 8.2.0
+     * @returns {Promise<HingeAngleResult>} The latest hinge angle.
+     *
+     * @example
+     * ```typescript
+     * const { angle } = await ScreenOrientation.getHingeAngle();
+     * ```
+     */
+    getHingeAngle(): Promise<HingeAngleResult>;
+    /**
+     * Read the fold and anything covering the screen.
+     *
+     * iPhone Duo reports the fold, the vertical status bar area, and the under-display camera.
+     * Resolves to an empty list on Android, web, and iOS before 27.1.
+     *
+     * @since 8.2.0
+     * @returns {Promise<{ regions: ReservedRegion[] }>} The reserved regions.
+     */
+    getReservedRegions(): Promise<{
+        regions: ReservedRegion[];
+    }>;
+    /**
+     * Read where iPhone Duo puts native tab bars and toolbars.
+     *
+     * `verticalBarEdge` is `null` when bars stay horizontal, and always on Android and web.
+     *
+     * @since 8.2.0
+     * @returns {Promise<BarPlacement>} The current bar placement.
+     */
+    getBarPlacement(): Promise<BarPlacement>;
+    /**
+     * Choose whether iPhone Duo may move this app's bars to the side.
+     *
+     * Resolves to `{ applied: false }` unless the app's bridge view controller opts in.
+     * Android and web always resolve to `{ applied: false }`.
+     *
+     * @since 8.2.0
+     * @param options `automatic` lets the system move bars. `disabled` keeps them horizontal.
+     * @returns {Promise<{ applied: boolean }>} Whether the app applied the choice.
+     */
+    setVerticalBarBehavior(options: {
+        behavior: 'automatic' | 'disabled';
+    }): Promise<{
+        applied: boolean;
+    }>;
+    /**
+     * Read the window size classes.
+     *
+     * @since 8.2.0
+     * @returns {Promise<SizeClass>} Apple and Material size classes for the current window.
+     *
+     * @example
+     * ```typescript
+     * const { horizontal, widthClass } = await ScreenOrientation.getSizeClass();
+     * ```
+     */
+    getSizeClass(): Promise<SizeClass>;
     addListener(eventName: 'screenOrientationChange', listenerFunc: (result: ScreenOrientationResult) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listen for fold changes.
+     *
+     * On a foldable this also fires when the device rotates, because the hinge
+     * bounds rotate with the window.
+     *
+     * @since 8.2.0
+     * @param eventName The event name. Must be 'foldStateChange'.
+     * @param listenerFunc Callback invoked with the new fold state.
+     * @returns {Promise<PluginListenerHandle>} A promise that resolves to a listener handle.
+     */
+    addListener(eventName: 'foldStateChange', listenerFunc: (state: FoldState) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listen for hinge angle changes.
+     *
+     * On Android the hinge sensor runs only while at least one listener is registered.
+     * On iOS this fires on iPhone Duo (iOS 27.1 or later). Never fires on web.
+     *
+     * @since 8.2.0
+     * @param eventName The event name. Must be 'hingeAngleChange'.
+     * @param listenerFunc Callback invoked with the angle in degrees.
+     * @returns {Promise<PluginListenerHandle>} A promise that resolves to a listener handle.
+     */
+    addListener(eventName: 'hingeAngleChange', listenerFunc: (event: HingeAngleResult) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listen for size class changes, such as unfolding, rotating, or resizing.
+     *
+     * @since 8.2.0
+     * @param eventName The event name. Must be 'sizeClassChange'.
+     * @param listenerFunc Callback invoked with the new size class.
+     * @returns {Promise<PluginListenerHandle>} A promise that resolves to a listener handle.
+     */
+    addListener(eventName: 'sizeClassChange', listenerFunc: (sizeClass: SizeClass) => void): Promise<PluginListenerHandle>;
     /**
      * Remove all listeners for this plugin.
      *

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\n/**\n * Orientation type that describes the orientation state of the device.\n *\n * @since 1.0.0\n */\nexport type OrientationType = 'portrait-primary' | 'portrait-secondary' | 'landscape-primary' | 'landscape-secondary';\n\n/**\n * Orientation lock type that can be used to lock the device orientation.\n *\n * @since 1.0.0\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\n/**\n * Result returned by the orientation() method.\n *\n * @since 1.0.0\n */\nexport interface ScreenOrientationResult {\n  /**\n   * The current orientation type.\n   *\n   * @since 1.0.0\n   */\n  type: OrientationType;\n}\n\n/**\n * Result returned by the isOrientationLocked() method.\n *\n * @since 1.0.0\n */\nexport interface OrientationLockStatusResult {\n  /**\n   * Whether the device orientation lock is currently enabled.\n   *\n   * This is determined by comparing the physical device orientation\n   * (from motion sensors) with the UI orientation. If they differ,\n   * orientation lock is enabled.\n   *\n   * Available on iOS (Core Motion) and Android (Accelerometer) when motion tracking is active.\n   *\n   * @since 1.0.0\n   */\n  locked: boolean;\n\n  /**\n   * The physical orientation of the device from motion sensors.\n   * Available when motion tracking is active (iOS and Android).\n   *\n   * @since 1.0.0\n   */\n  physicalOrientation?: OrientationType;\n\n  /**\n   * The current UI orientation reported by the system.\n   *\n   * @since 1.0.0\n   */\n  uiOrientation: OrientationType;\n}\n\n/**\n * Options for locking the screen orientation.\n *\n * @since 1.0.0\n */\nexport interface OrientationLockOptions {\n  /**\n   * The orientation type to lock to.\n   *\n   * @since 1.0.0\n   */\n  orientation: OrientationLockType;\n\n  /**\n   * Whether to track physical device orientation using motion sensors.\n   * When true, uses device motion sensors to detect the true physical\n   * orientation of the device, even when the device orientation lock is enabled.\n   *\n   * **Important:** This does NOT bypass the UI orientation lock.\n   * The screen will still respect the user's orientation lock setting.\n   * This option only affects orientation detection/tracking - you'll receive\n   * orientation change events based on how the device is physically held,\n   * but the UI will not rotate if orientation lock is enabled.\n   *\n   * Supported on iOS (Core Motion) and Android (Accelerometer).\n   *\n   * @default false\n   * @since 1.0.0\n   */\n  bypassOrientationLock?: boolean;\n}\n\n/**\n * Options for starting orientation tracking using motion sensors.\n *\n * @since 1.0.0\n */\nexport interface StartOrientationTrackingOptions {\n  /**\n   * Whether to track physical device orientation using motion sensors.\n   * When true, uses device motion sensors to detect the true physical\n   * orientation of the device, even when the device orientation lock is enabled.\n   *\n   * **Important:** This does NOT bypass the UI orientation lock.\n   * This only enables detection of the physical orientation.\n   *\n   * Supported on iOS (Core Motion) and Android (Accelerometer).\n   *\n   * @default false\n   * @since 1.0.0\n   */\n  bypassOrientationLock?: boolean;\n}\n\n/**\n * Capacitor Screen Orientation Plugin interface.\n *\n * Provides methods to detect and control screen orientation,\n * with support for detecting true physical device orientation using motion sensors.\n *\n * @since 1.0.0\n */\nexport interface CapacitorScreenOrientationPlugin {\n  /**\n   * Get the current screen orientation.\n   *\n   * Returns the current orientation of the device screen.\n   *\n   * @since 1.0.0\n   * @returns {Promise<ScreenOrientationResult>} A promise that resolves with the current orientation.\n   *\n   * @example\n   * ```typescript\n   * const result = await ScreenOrientation.orientation();\n   * console.log('Current orientation:', result.type);\n   * ```\n   */\n  orientation(): Promise<ScreenOrientationResult>;\n\n  /**\n   * Lock the screen orientation to a specific type.\n   *\n   * Locks the screen to the specified orientation.\n   * On iOS, if bypassOrientationLock is true, it will also start\n   * tracking physical device orientation using motion sensors.\n   *\n   * Note: The UI will still respect the user's orientation lock setting.\n   * Motion tracking allows you to detect how the device is physically held\n   * even when the UI doesn't rotate.\n   *\n   * @since 1.0.0\n   * @param options Options for locking the orientation.\n   * @returns {Promise<void>} A promise that resolves when the orientation is locked.\n   *\n   * @example\n   * ```typescript\n   * // Standard lock\n   * await ScreenOrientation.lock({ orientation: 'landscape' });\n   *\n   * // Lock with motion tracking on iOS\n   * await ScreenOrientation.lock({\n   *   orientation: 'portrait',\n   *   bypassOrientationLock: true\n   * });\n   * ```\n   */\n  lock(options: OrientationLockOptions): Promise<void>;\n\n  /**\n   * Unlock the screen orientation.\n   *\n   * Allows the screen to rotate freely based on device position.\n   * Also stops any motion-based orientation tracking if it was enabled.\n   *\n   * @since 1.0.0\n   * @returns {Promise<void>} A promise that resolves when the orientation is unlocked.\n   *\n   * @example\n   * ```typescript\n   * await ScreenOrientation.unlock();\n   * ```\n   */\n  unlock(): Promise<void>;\n\n  /**\n   * Start tracking device orientation using motion sensors.\n   *\n   * This method is useful when you want to track the device's physical\n   * orientation independently from the screen orientation lock.\n   * It uses Core Motion on iOS to detect orientation changes.\n   *\n   * @since 1.0.0\n   * @param options Options for starting orientation tracking.\n   * @returns {Promise<void>} A promise that resolves when tracking starts.\n   *\n   * @example\n   * ```typescript\n   * await ScreenOrientation.startOrientationTracking({\n   *   bypassOrientationLock: true\n   * });\n   *\n   * // Listen for changes\n   * ScreenOrientation.addListener('screenOrientationChange', (result) => {\n   *   console.log('Orientation changed:', result.type);\n   * });\n   * ```\n   */\n  startOrientationTracking(options?: StartOrientationTrackingOptions): Promise<void>;\n\n  /**\n   * Stop tracking device orientation using motion sensors.\n   *\n   * Stops the motion-based orientation tracking if it was started.\n   *\n   * @since 1.0.0\n   * @returns {Promise<void>} A promise that resolves when tracking stops.\n   *\n   * @example\n   * ```typescript\n   * await ScreenOrientation.stopOrientationTracking();\n   * ```\n   */\n  stopOrientationTracking(): Promise<void>;\n\n  /**\n   * Check if device orientation lock is currently enabled.\n   *\n   * This method compares the physical device orientation (from motion sensors)\n   * with the UI orientation. If they differ, orientation lock is enabled.\n   *\n   * Note: This requires motion tracking to be active via\n   * startOrientationTracking() or lock() with bypassOrientationLock: true.\n   * Works on both iOS (Core Motion) and Android (Accelerometer).\n   *\n   * @since 1.0.0\n   * @returns {Promise<OrientationLockStatusResult>} A promise that resolves with the lock status.\n   *\n   * @example\n   * ```typescript\n   * // Start motion tracking first\n   * await ScreenOrientation.startOrientationTracking({\n   *   bypassOrientationLock: true\n   * });\n   *\n   * // Check lock status\n   * const status = await ScreenOrientation.isOrientationLocked();\n   * if (status.locked) {\n   *   console.log('Orientation lock is ON');\n   *   console.log('Physical:', status.physicalOrientation);\n   *   console.log('UI:', status.uiOrientation);\n   * }\n   * ```\n   */\n  isOrientationLocked(): Promise<OrientationLockStatusResult>;\n\n  /**\n   * Listen for screen orientation changes.\n   *\n   * Registers a listener that will be called whenever the screen orientation changes.\n   * If motion-based tracking is enabled, this will also fire for orientation changes\n   * detected by motion sensors even when orientation lock is enabled.\n   *\n   * @since 1.0.0\n   * @param eventName The event name. Must be 'screenOrientationChange'.\n   * @param listenerFunc Callback function invoked when orientation changes.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves to a listener handle.\n   *\n   * @example\n   * ```typescript\n   * const listener = await ScreenOrientation.addListener(\n   *   'screenOrientationChange',\n   *   (result) => {\n   *     console.log('New orientation:', result.type);\n   *   }\n   * );\n   *\n   * // To remove the listener:\n   * await listener.remove();\n   * ```\n   */\n  addListener(\n    eventName: 'screenOrientationChange',\n    listenerFunc: (result: ScreenOrientationResult) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * Removes all registered event listeners.\n   *\n   * @since 1.0.0\n   * @returns {Promise<void>} A promise that resolves when all listeners are removed.\n   *\n   * @example\n   * ```typescript\n   * await ScreenOrientation.removeAllListeners();\n   * ```\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Get the native plugin version.\n   *\n   * Returns the current version of the native plugin implementation.\n   *\n   * @since 1.0.0\n   * @returns {Promise<{ version: string }>} A promise that resolves with the version string.\n   *\n   * @example\n   * ```typescript\n   * const { version } = await ScreenOrientation.getPluginVersion();\n   * console.log('Plugin version:', version);\n   * ```\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Orientation type that describes the orientation state of the device.\n *\n * @since 1.0.0\n */\nexport type OrientationType = 'portrait-primary' | 'portrait-secondary' | 'landscape-primary' | 'landscape-secondary';\n\n/**\n * Orientation lock type that can be used to lock the device orientation.\n *\n * @since 1.0.0\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\n/**\n * Result returned by the orientation() method.\n *\n * @since 1.0.0\n */\nexport interface ScreenOrientationResult {\n  /**\n   * The current orientation type.\n   *\n   * @since 1.0.0\n   */\n  type: OrientationType;\n}\n\n/**\n * Result returned by the isOrientationLocked() method.\n *\n * @since 1.0.0\n */\nexport interface OrientationLockStatusResult {\n  /**\n   * Whether the device orientation lock is currently enabled.\n   *\n   * This is determined by comparing the physical device orientation\n   * (from motion sensors) with the UI orientation. If they differ,\n   * orientation lock is enabled.\n   *\n   * Available on iOS (Core Motion) and Android (Accelerometer) when motion tracking is active.\n   *\n   * @since 1.0.0\n   */\n  locked: boolean;\n\n  /**\n   * The physical orientation of the device from motion sensors.\n   * Available when motion tracking is active (iOS and Android).\n   *\n   * @since 1.0.0\n   */\n  physicalOrientation?: OrientationType;\n\n  /**\n   * The current UI orientation reported by the system.\n   *\n   * @since 1.0.0\n   */\n  uiOrientation: OrientationType;\n}\n\n/**\n * Options for locking the screen orientation.\n *\n * @since 1.0.0\n */\nexport interface OrientationLockOptions {\n  /**\n   * The orientation type to lock to.\n   *\n   * @since 1.0.0\n   */\n  orientation: OrientationLockType;\n\n  /**\n   * Whether to track physical device orientation using motion sensors.\n   * When true, uses device motion sensors to detect the true physical\n   * orientation of the device, even when the device orientation lock is enabled.\n   *\n   * **Important:** This does NOT bypass the UI orientation lock.\n   * The screen will still respect the user's orientation lock setting.\n   * This option only affects orientation detection/tracking - you'll receive\n   * orientation change events based on how the device is physically held,\n   * but the UI will not rotate if orientation lock is enabled.\n   *\n   * Supported on iOS (Core Motion) and Android (Accelerometer).\n   *\n   * @default false\n   * @since 1.0.0\n   */\n  bypassOrientationLock?: boolean;\n}\n\n/**\n * Options for starting orientation tracking using motion sensors.\n *\n * @since 1.0.0\n */\nexport interface StartOrientationTrackingOptions {\n  /**\n   * Whether to track physical device orientation using motion sensors.\n   * When true, uses device motion sensors to detect the true physical\n   * orientation of the device, even when the device orientation lock is enabled.\n   *\n   * **Important:** This does NOT bypass the UI orientation lock.\n   * This only enables detection of the physical orientation.\n   *\n   * Supported on iOS (Core Motion) and Android (Accelerometer).\n   *\n   * @default false\n   * @since 1.0.0\n   */\n  bypassOrientationLock?: boolean;\n}\n\n/**\n * How open a foldable is.\n *\n * `closed` is reserved. A device shut onto its cover display reports `flat`.\n *\n * @since 8.2.0\n */\nexport type FoldStateValue = 'flat' | 'half-opened';\n\n/**\n * How a half-open foldable is held.\n *\n * `tabletop` is a horizontal hinge, like a laptop. `book` is a vertical hinge.\n *\n * @since 8.2.0\n */\nexport type FoldPosture = 'flat' | 'tabletop' | 'book';\n\n/**\n * Direction of the hinge relative to the window.\n *\n * @since 8.2.0\n */\nexport type HingeOrientation = 'horizontal' | 'vertical';\n\n/**\n * A rectangle in CSS pixels, relative to the web view.\n *\n * @since 8.2.0\n */\nexport interface FoldBounds {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/**\n * Current fold of the window.\n *\n * Phones that do not fold, and iOS before 27.1, resolve to a flat state.\n * iPhone Duo reports `book`, `tabletop`, or `flat`, and which display is in front.\n *\n * @since 8.2.0\n */\nexport interface FoldState {\n  /**\n   * Posture of the fold.\n   *\n   * @since 8.2.0\n   */\n  state: FoldStateValue;\n\n  /**\n   * Whether the fold splits the web view into two areas.\n   *\n   * @since 8.2.0\n   */\n  isSeparating: boolean;\n\n  /**\n   * How the device is held.\n   *\n   * @since 8.2.0\n   */\n  posture: FoldPosture;\n\n  /**\n   * Direction of the hinge. Omitted when there is no fold.\n   *\n   * @since 8.2.0\n   */\n  hingeOrientation?: HingeOrientation;\n\n  /**\n   * Position of the fold in CSS pixels. Omitted when there is no fold.\n   *\n   * @since 8.2.0\n   */\n  hingeBounds?: FoldBounds;\n\n  /**\n   * Area the hinge covers. Present when the hinge has a physical gap.\n   *\n   * @since 8.2.0\n   */\n  occludedBounds?: FoldBounds;\n\n  /**\n   * Which display is showing the app on iPhone Duo. Omitted on Android, web, and iOS before 27.1.\n   *\n   * @since 8.2.0\n   */\n  activeDisplay?: 'inner' | 'outer';\n\n  /**\n   * Space the system keeps clear around the fold, in CSS pixels. iPhone Duo reports 20 on each side of a vertical fold.\n   *\n   * @since 8.2.0\n   */\n  hingeMargins?: { top: number; right: number; bottom: number; left: number };\n\n  /**\n   * Areas covering the display, such as the iPhone Duo camera. Omitted when there are none.\n   *\n   * @since 8.2.0\n   */\n  cameraBounds?: FoldBounds[];\n}\n\n/**\n * Whether this device can fold.\n *\n * @since 8.2.0\n */\nexport interface DeviceFoldableResult {\n  /**\n   * Whether the device has a fold.\n   *\n   * @since 8.2.0\n   */\n  foldable: boolean;\n\n  /**\n   * Whether it can stand half-open like a laptop.\n   *\n   * @since 8.2.0\n   */\n  supportsTabletop: boolean;\n}\n\n/**\n * Angle between the two halves of a foldable, in degrees.\n *\n * `0` is closed and `180` is flat. `angle` is `null` when the device has no hinge sensor.\n *\n * @since 8.2.0\n */\nexport interface HingeAngleResult {\n  /**\n   * Hinge angle in degrees, or `null` when no sensor is available.\n   *\n   * @since 8.2.0\n   */\n  angle: number | null;\n\n  /**\n   * How far open iPhone Duo is, as the system sees it. `null` on Android and web.\n   *\n   * @since 8.2.0\n   */\n  status?: 'closed' | 'partiallyOpen' | 'fullyOpen' | null;\n}\n\n/**\n * A region the system reserves on iPhone Duo.\n *\n * `division` is the fold. `occlusion` is something covering the display, such as the camera.\n *\n * @since 8.2.0\n */\nexport interface ReservedRegion {\n  /**\n   * What the region is.\n   *\n   * @since 8.2.0\n   */\n  kind: 'division' | 'occlusion';\n\n  /**\n   * Whether the region applies right now. An inactive division is a flat fold.\n   *\n   * @since 8.2.0\n   */\n  isActive: boolean;\n\n  /**\n   * Left edge, in CSS pixels.\n   *\n   * @since 8.2.0\n   */\n  x: number;\n\n  /**\n   * Top edge, in CSS pixels.\n   *\n   * @since 8.2.0\n   */\n  y: number;\n\n  /**\n   * Width in CSS pixels.\n   *\n   * @since 8.2.0\n   */\n  width: number;\n\n  /**\n   * Height in CSS pixels.\n   *\n   * @since 8.2.0\n   */\n  height: number;\n\n  /**\n   * Space to keep clear around the region, in CSS pixels.\n   *\n   * @since 8.2.0\n   */\n  margins: { top: number; right: number; bottom: number; left: number };\n}\n\n/**\n * Where iPhone Duo places native bars.\n *\n * @since 8.2.0\n */\nexport interface BarPlacement {\n  /**\n   * The edge the system moves tab bars and toolbars to. `null` when they stay horizontal.\n   *\n   * @since 8.2.0\n   */\n  verticalBarEdge: 'leading' | 'trailing' | null;\n\n  /**\n   * How much room the vertical bar takes, in points. `0` when bars stay horizontal.\n   *\n   * @since 8.2.0\n   */\n  inset: number;\n}\n\n/**\n * Window size classes.\n *\n * `horizontal` and `vertical` follow Apple's compact/regular split.\n * On Android and web, `regular` starts at 600 CSS pixels wide and 480 tall.\n * `widthClass` and `heightClass` follow Material window size classes.\n *\n * @since 8.2.0\n */\nexport interface SizeClass {\n  /**\n   * Width size class. `compact` on a phone, `regular` on the inner display of a foldable, a tablet, or a window at least 600 CSS pixels wide.\n   *\n   * @since 8.2.0\n   */\n  horizontal: 'compact' | 'regular';\n\n  /**\n   * Height size class. `regular` starts at 480 CSS pixels.\n   *\n   * @since 8.2.0\n   */\n  vertical: 'compact' | 'regular';\n\n  /**\n   * Material window width class.\n   *\n   * @since 8.2.0\n   */\n  widthClass: 'compact' | 'medium' | 'expanded' | 'large' | 'extraLarge';\n\n  /**\n   * Material window height class.\n   *\n   * @since 8.2.0\n   */\n  heightClass: 'compact' | 'medium' | 'expanded';\n}\n\n/**\n * Capacitor Screen Orientation Plugin interface.\n *\n * Provides methods to detect and control screen orientation,\n * with support for detecting true physical device orientation using motion sensors.\n *\n * @since 1.0.0\n */\nexport interface CapacitorScreenOrientationPlugin {\n  /**\n   * Get the current screen orientation.\n   *\n   * Returns the current orientation of the device screen.\n   *\n   * @since 1.0.0\n   * @returns {Promise<ScreenOrientationResult>} A promise that resolves with the current orientation.\n   *\n   * @example\n   * ```typescript\n   * const result = await ScreenOrientation.orientation();\n   * console.log('Current orientation:', result.type);\n   * ```\n   */\n  orientation(): Promise<ScreenOrientationResult>;\n\n  /**\n   * Lock the screen orientation to a specific type.\n   *\n   * Locks the screen to the specified orientation.\n   * On iOS, if bypassOrientationLock is true, it will also start\n   * tracking physical device orientation using motion sensors.\n   *\n   * Note: The UI will still respect the user's orientation lock setting.\n   * Motion tracking allows you to detect how the device is physically held\n   * even when the UI doesn't rotate.\n   *\n   * @since 1.0.0\n   * @param options Options for locking the orientation.\n   * @returns {Promise<void>} A promise that resolves when the orientation is locked.\n   *\n   * @example\n   * ```typescript\n   * // Standard lock\n   * await ScreenOrientation.lock({ orientation: 'landscape' });\n   *\n   * // Lock with motion tracking on iOS\n   * await ScreenOrientation.lock({\n   *   orientation: 'portrait',\n   *   bypassOrientationLock: true\n   * });\n   * ```\n   */\n  lock(options: OrientationLockOptions): Promise<void>;\n\n  /**\n   * Unlock the screen orientation.\n   *\n   * Allows the screen to rotate freely based on device position.\n   * Also stops any motion-based orientation tracking if it was enabled.\n   *\n   * @since 1.0.0\n   * @returns {Promise<void>} A promise that resolves when the orientation is unlocked.\n   *\n   * @example\n   * ```typescript\n   * await ScreenOrientation.unlock();\n   * ```\n   */\n  unlock(): Promise<void>;\n\n  /**\n   * Start tracking device orientation using motion sensors.\n   *\n   * This method is useful when you want to track the device's physical\n   * orientation independently from the screen orientation lock.\n   * It uses Core Motion on iOS to detect orientation changes.\n   *\n   * @since 1.0.0\n   * @param options Options for starting orientation tracking.\n   * @returns {Promise<void>} A promise that resolves when tracking starts.\n   *\n   * @example\n   * ```typescript\n   * await ScreenOrientation.startOrientationTracking({\n   *   bypassOrientationLock: true\n   * });\n   *\n   * // Listen for changes\n   * ScreenOrientation.addListener('screenOrientationChange', (result) => {\n   *   console.log('Orientation changed:', result.type);\n   * });\n   * ```\n   */\n  startOrientationTracking(options?: StartOrientationTrackingOptions): Promise<void>;\n\n  /**\n   * Stop tracking device orientation using motion sensors.\n   *\n   * Stops the motion-based orientation tracking if it was started.\n   *\n   * @since 1.0.0\n   * @returns {Promise<void>} A promise that resolves when tracking stops.\n   *\n   * @example\n   * ```typescript\n   * await ScreenOrientation.stopOrientationTracking();\n   * ```\n   */\n  stopOrientationTracking(): Promise<void>;\n\n  /**\n   * Check if device orientation lock is currently enabled.\n   *\n   * This method compares the physical device orientation (from motion sensors)\n   * with the UI orientation. If they differ, orientation lock is enabled.\n   *\n   * Note: This requires motion tracking to be active via\n   * startOrientationTracking() or lock() with bypassOrientationLock: true.\n   * Works on both iOS (Core Motion) and Android (Accelerometer).\n   *\n   * @since 1.0.0\n   * @returns {Promise<OrientationLockStatusResult>} A promise that resolves with the lock status.\n   *\n   * @example\n   * ```typescript\n   * // Start motion tracking first\n   * await ScreenOrientation.startOrientationTracking({\n   *   bypassOrientationLock: true\n   * });\n   *\n   * // Check lock status\n   * const status = await ScreenOrientation.isOrientationLocked();\n   * if (status.locked) {\n   *   console.log('Orientation lock is ON');\n   *   console.log('Physical:', status.physicalOrientation);\n   *   console.log('UI:', status.uiOrientation);\n   * }\n   * ```\n   */\n  isOrientationLocked(): Promise<OrientationLockStatusResult>;\n\n  /**\n   * Listen for screen orientation changes.\n   *\n   * Registers a listener that will be called whenever the screen orientation changes.\n   * If motion-based tracking is enabled, this will also fire for orientation changes\n   * detected by motion sensors even when orientation lock is enabled.\n   *\n   * @since 1.0.0\n   * @param eventName The event name. Must be 'screenOrientationChange'.\n   * @param listenerFunc Callback function invoked when orientation changes.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves to a listener handle.\n   *\n   * @example\n   * ```typescript\n   * const listener = await ScreenOrientation.addListener(\n   *   'screenOrientationChange',\n   *   (result) => {\n   *     console.log('New orientation:', result.type);\n   *   }\n   * );\n   *\n   * // To remove the listener:\n   * await listener.remove();\n   * ```\n   */\n  /**\n   * Whether this device folds, and whether it can stand half-open like a laptop.\n   *\n   * Both flags are `false` on web, on Android phones that do not fold, and on iOS except iPhone Duo (iOS 27.1 or later).\n   *\n   * @since 8.2.0\n   * @returns {Promise<DeviceFoldableResult>} Fold capability of this device.\n   *\n   * @example\n   * ```typescript\n   * const { foldable, supportsTabletop } = await ScreenOrientation.isDeviceFoldable();\n   * ```\n   */\n  isDeviceFoldable(): Promise<DeviceFoldableResult>;\n\n  /**\n   * Read the current fold.\n   *\n   * Resolves to a flat state when the device has no fold.\n   *\n   * @since 8.2.0\n   * @returns {Promise<FoldState>} The current fold state.\n   *\n   * @example\n   * ```typescript\n   * const { posture, hingeOrientation } = await ScreenOrientation.getFoldState();\n   * ```\n   */\n  getFoldState(): Promise<FoldState>;\n\n  /**\n   * Read the hinge angle in degrees.\n   *\n   * `0` is closed and `180` is flat. `angle` is `null` without a hinge sensor.\n   *\n   * @since 8.2.0\n   * @returns {Promise<HingeAngleResult>} The latest hinge angle.\n   *\n   * @example\n   * ```typescript\n   * const { angle } = await ScreenOrientation.getHingeAngle();\n   * ```\n   */\n  getHingeAngle(): Promise<HingeAngleResult>;\n\n  /**\n   * Read the fold and anything covering the screen.\n   *\n   * iPhone Duo reports the fold, the vertical status bar area, and the under-display camera.\n   * Resolves to an empty list on Android, web, and iOS before 27.1.\n   *\n   * @since 8.2.0\n   * @returns {Promise<{ regions: ReservedRegion[] }>} The reserved regions.\n   */\n  getReservedRegions(): Promise<{ regions: ReservedRegion[] }>;\n\n  /**\n   * Read where iPhone Duo puts native tab bars and toolbars.\n   *\n   * `verticalBarEdge` is `null` when bars stay horizontal, and always on Android and web.\n   *\n   * @since 8.2.0\n   * @returns {Promise<BarPlacement>} The current bar placement.\n   */\n  getBarPlacement(): Promise<BarPlacement>;\n\n  /**\n   * Choose whether iPhone Duo may move this app's bars to the side.\n   *\n   * Resolves to `{ applied: false }` unless the app's bridge view controller opts in.\n   * Android and web always resolve to `{ applied: false }`.\n   *\n   * @since 8.2.0\n   * @param options `automatic` lets the system move bars. `disabled` keeps them horizontal.\n   * @returns {Promise<{ applied: boolean }>} Whether the app applied the choice.\n   */\n  setVerticalBarBehavior(options: { behavior: 'automatic' | 'disabled' }): Promise<{ applied: boolean }>;\n\n  /**\n   * Read the window size classes.\n   *\n   * @since 8.2.0\n   * @returns {Promise<SizeClass>} Apple and Material size classes for the current window.\n   *\n   * @example\n   * ```typescript\n   * const { horizontal, widthClass } = await ScreenOrientation.getSizeClass();\n   * ```\n   */\n  getSizeClass(): Promise<SizeClass>;\n\n  addListener(\n    eventName: 'screenOrientationChange',\n    listenerFunc: (result: ScreenOrientationResult) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for fold changes.\n   *\n   * On a foldable this also fires when the device rotates, because the hinge\n   * bounds rotate with the window.\n   *\n   * @since 8.2.0\n   * @param eventName The event name. Must be 'foldStateChange'.\n   * @param listenerFunc Callback invoked with the new fold state.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves to a listener handle.\n   */\n  addListener(eventName: 'foldStateChange', listenerFunc: (state: FoldState) => void): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for hinge angle changes.\n   *\n   * On Android the hinge sensor runs only while at least one listener is registered.\n   * On iOS this fires on iPhone Duo (iOS 27.1 or later). Never fires on web.\n   *\n   * @since 8.2.0\n   * @param eventName The event name. Must be 'hingeAngleChange'.\n   * @param listenerFunc Callback invoked with the angle in degrees.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves to a listener handle.\n   */\n  addListener(\n    eventName: 'hingeAngleChange',\n    listenerFunc: (event: HingeAngleResult) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for size class changes, such as unfolding, rotating, or resizing.\n   *\n   * @since 8.2.0\n   * @param eventName The event name. Must be 'sizeClassChange'.\n   * @param listenerFunc Callback invoked with the new size class.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves to a listener handle.\n   */\n  addListener(\n    eventName: 'sizeClassChange',\n    listenerFunc: (sizeClass: SizeClass) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * Removes all registered event listeners.\n   *\n   * @since 1.0.0\n   * @returns {Promise<void>} A promise that resolves when all listeners are removed.\n   *\n   * @example\n   * ```typescript\n   * await ScreenOrientation.removeAllListeners();\n   * ```\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Get the native plugin version.\n   *\n   * Returns the current version of the native plugin implementation.\n   *\n   * @since 1.0.0\n   * @returns {Promise<{ version: string }>} A promise that resolves with the version string.\n   *\n   * @example\n   * ```typescript\n   * const { version } = await ScreenOrientation.getPluginVersion();\n   * console.log('Plugin version:', version);\n   * ```\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -1,8 +1,10 @@
 import { WebPlugin } from '@capacitor/core';
-import type { CapacitorScreenOrientationPlugin, OrientationLockOptions, OrientationType, ScreenOrientationResult, StartOrientationTrackingOptions } from './definitions';
+import type { BarPlacement, CapacitorScreenOrientationPlugin, DeviceFoldableResult, FoldState, HingeAngleResult, ReservedRegion, OrientationLockOptions, OrientationType, ScreenOrientationResult, SizeClass, StartOrientationTrackingOptions } from './definitions';
+export declare function sizeClassOf(width: number, height: number): SizeClass;
 export declare class CapacitorScreenOrientationWeb extends WebPlugin implements CapacitorScreenOrientationPlugin {
     private readonly pluginVersion;
     constructor();
+    private lastSizeClass;
     orientation(): Promise<ScreenOrientationResult>;
     lock(options: OrientationLockOptions): Promise<void>;
     unlock(): Promise<void>;
@@ -13,8 +15,20 @@ export declare class CapacitorScreenOrientationWeb extends WebPlugin implements
         physicalOrientation?: OrientationType;
         uiOrientation: OrientationType;
     }>;
+    isDeviceFoldable(): Promise<DeviceFoldableResult>;
+    getFoldState(): Promise<FoldState>;
+    getHingeAngle(): Promise<HingeAngleResult>;
+    getReservedRegions(): Promise<{
+        regions: ReservedRegion[];
+    }>;
+    getBarPlacement(): Promise<BarPlacement>;
+    setVerticalBarBehavior(): Promise<{
+        applied: boolean;
+    }>;
+    getSizeClass(): Promise<SizeClass>;
     getPluginVersion(): Promise<{
         version: string;
     }>;
+    private readSizeClass;
     private mapOrientationType;
 }

package/dist/esm/web.js

@@ -1,9 +1,29 @@
 import { WebPlugin } from '@capacitor/core';
+const FLAT_FOLD = { state: 'flat', isSeparating: false, posture: 'flat' };
+export function sizeClassOf(width, height) {
+    const widthClass = width >= 1600
+        ? 'extraLarge'
+        : width >= 1200
+            ? 'large'
+            : width >= 840
+                ? 'expanded'
+                : width >= 600
+                    ? 'medium'
+                    : 'compact';
+    const heightClass = height >= 900 ? 'expanded' : height >= 480 ? 'medium' : 'compact';
+    return {
+        horizontal: width >= 600 ? 'regular' : 'compact',
+        vertical: height >= 480 ? 'regular' : 'compact',
+        widthClass,
+        heightClass,
+    };
+}
 export class CapacitorScreenOrientationWeb extends WebPlugin {
     constructor() {
         var _a;
         super();
         this.pluginVersion = '1.0.0';
+        this.lastSizeClass = null;
         if ((_a = window.screen) === null || _a === void 0 ? void 0 : _a.orientation) {
             window.screen.orientation.addEventListener('change', () => {
                 this.notifyListeners('screenOrientationChange', {
@@ -11,6 +31,14 @@ export class CapacitorScreenOrientationWeb extends WebPlugin {
                 });
             });
         }
+        window.addEventListener('resize', () => {
+            const next = this.readSizeClass();
+            const previous = JSON.stringify(this.lastSizeClass);
+            if (previous === JSON.stringify(next))
+                return;
+            this.lastSizeClass = next;
+            this.notifyListeners('sizeClassChange', next);
+        });
     }
     async orientation() {
         var _a;
@@ -60,9 +88,33 @@ export class CapacitorScreenOrientationWeb extends WebPlugin {
             uiOrientation: orientationResult.type,
         };
     }
+    async isDeviceFoldable() {
+        return { foldable: false, supportsTabletop: false };
+    }
+    async getFoldState() {
+        return FLAT_FOLD;
+    }
+    async getHingeAngle() {
+        return { angle: null, status: null };
+    }
+    async getReservedRegions() {
+        return { regions: [] };
+    }
+    async getBarPlacement() {
+        return { verticalBarEdge: null, inset: 0 };
+    }
+    async setVerticalBarBehavior() {
+        return { applied: false };
+    }
+    async getSizeClass() {
+        return this.readSizeClass();
+    }
     async getPluginVersion() {
         return { version: this.pluginVersion };
     }
+    readSizeClass() {
+        return sizeClassOf(window.innerWidth, window.innerHeight);
+    }
     mapOrientationType(type) {
         if (type.includes('portrait-primary') || type === 'portrait-primary') {
             return 'portrait-primary';

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"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","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  CapacitorScreenOrientationPlugin,\n  OrientationLockOptions,\n  OrientationType,\n  ScreenOrientationResult,\n  StartOrientationTrackingOptions,\n} from './definitions';\n\nexport class CapacitorScreenOrientationWeb extends WebPlugin implements CapacitorScreenOrientationPlugin {\n  private readonly pluginVersion = '1.0.0';\n\n  constructor() {\n    super();\n    if (window.screen?.orientation) {\n      window.screen.orientation.addEventListener('change', () => {\n        this.notifyListeners('screenOrientationChange', {\n          type: this.mapOrientationType(window.screen.orientation.type),\n        });\n      });\n    }\n  }\n\n  async orientation(): Promise<ScreenOrientationResult> {\n    if (!window.screen?.orientation) {\n      throw this.unavailable('Screen Orientation API not available');\n    }\n    return {\n      type: this.mapOrientationType(window.screen.orientation.type),\n    };\n  }\n\n  async lock(options: OrientationLockOptions): Promise<void> {\n    const screenOrientation = window.screen?.orientation as any;\n    if (!screenOrientation?.lock) {\n      throw this.unavailable('Screen Orientation lock not available');\n    }\n\n    // bypassOrientationLock is only supported on iOS native platform\n    // Silently ignore it on web\n\n    try {\n      await screenOrientation.lock(options.orientation);\n    } catch (error) {\n      throw new Error(`Failed to lock orientation: ${error}`);\n    }\n  }\n\n  async unlock(): Promise<void> {\n    const screenOrientation = window.screen?.orientation as any;\n    if (!screenOrientation?.unlock) {\n      throw this.unavailable('Screen Orientation unlock not available');\n    }\n    screenOrientation.unlock();\n  }\n\n  async startOrientationTracking(_options?: StartOrientationTrackingOptions): Promise<void> {\n    // Motion-based orientation tracking is only supported on iOS\n    // Silently ignore on web\n    console.warn('Motion-based orientation tracking is not available on web platform', _options);\n  }\n\n  async stopOrientationTracking(): Promise<void> {\n    // Motion-based orientation tracking is only supported on iOS\n    // Silently ignore on web\n  }\n\n  async isOrientationLocked(): Promise<{\n    locked: boolean;\n    physicalOrientation?: OrientationType;\n    uiOrientation: OrientationType;\n  }> {\n    const orientationResult = await this.orientation();\n    return {\n      locked: false,\n      uiOrientation: orientationResult.type,\n    };\n  }\n\n  async getPluginVersion(): Promise<{ version: string }> {\n    return { version: this.pluginVersion };\n  }\n\n  private mapOrientationType(type: string): OrientationType {\n    if (type.includes('portrait-primary') || type === 'portrait-primary') {\n      return 'portrait-primary';\n    }\n    if (type.includes('portrait-secondary') || type === 'portrait-secondary') {\n      return 'portrait-secondary';\n    }\n    if (type.includes('landscape-primary') || type === 'landscape-primary') {\n      return 'landscape-primary';\n    }\n    if (type.includes('landscape-secondary') || type === 'landscape-secondary') {\n      return 'landscape-secondary';\n    }\n    return 'portrait-primary'; // default fallback\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"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","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  BarPlacement,\n  CapacitorScreenOrientationPlugin,\n  DeviceFoldableResult,\n  FoldState,\n  HingeAngleResult,\n  ReservedRegion,\n  OrientationLockOptions,\n  OrientationType,\n  ScreenOrientationResult,\n  SizeClass,\n  StartOrientationTrackingOptions,\n} from './definitions';\n\nconst FLAT_FOLD: FoldState = { state: 'flat', isSeparating: false, posture: 'flat' };\n\nexport function sizeClassOf(width: number, height: number): SizeClass {\n  const widthClass =\n    width >= 1600\n      ? 'extraLarge'\n      : width >= 1200\n        ? 'large'\n        : width >= 840\n          ? 'expanded'\n          : width >= 600\n            ? 'medium'\n            : 'compact';\n  const heightClass = height >= 900 ? 'expanded' : height >= 480 ? 'medium' : 'compact';\n  return {\n    horizontal: width >= 600 ? 'regular' : 'compact',\n    vertical: height >= 480 ? 'regular' : 'compact',\n    widthClass,\n    heightClass,\n  };\n}\n\nexport class CapacitorScreenOrientationWeb extends WebPlugin implements CapacitorScreenOrientationPlugin {\n  private readonly pluginVersion = '1.0.0';\n\n  constructor() {\n    super();\n    if (window.screen?.orientation) {\n      window.screen.orientation.addEventListener('change', () => {\n        this.notifyListeners('screenOrientationChange', {\n          type: this.mapOrientationType(window.screen.orientation.type),\n        });\n      });\n    }\n    window.addEventListener('resize', () => {\n      const next = this.readSizeClass();\n      const previous = JSON.stringify(this.lastSizeClass);\n      if (previous === JSON.stringify(next)) return;\n      this.lastSizeClass = next;\n      this.notifyListeners('sizeClassChange', next);\n    });\n  }\n\n  private lastSizeClass: SizeClass | null = null;\n\n  async orientation(): Promise<ScreenOrientationResult> {\n    if (!window.screen?.orientation) {\n      throw this.unavailable('Screen Orientation API not available');\n    }\n    return {\n      type: this.mapOrientationType(window.screen.orientation.type),\n    };\n  }\n\n  async lock(options: OrientationLockOptions): Promise<void> {\n    const screenOrientation = window.screen?.orientation as any;\n    if (!screenOrientation?.lock) {\n      throw this.unavailable('Screen Orientation lock not available');\n    }\n\n    // bypassOrientationLock is only supported on iOS native platform\n    // Silently ignore it on web\n\n    try {\n      await screenOrientation.lock(options.orientation);\n    } catch (error) {\n      throw new Error(`Failed to lock orientation: ${error}`);\n    }\n  }\n\n  async unlock(): Promise<void> {\n    const screenOrientation = window.screen?.orientation as any;\n    if (!screenOrientation?.unlock) {\n      throw this.unavailable('Screen Orientation unlock not available');\n    }\n    screenOrientation.unlock();\n  }\n\n  async startOrientationTracking(_options?: StartOrientationTrackingOptions): Promise<void> {\n    // Motion-based orientation tracking is only supported on iOS\n    // Silently ignore on web\n    console.warn('Motion-based orientation tracking is not available on web platform', _options);\n  }\n\n  async stopOrientationTracking(): Promise<void> {\n    // Motion-based orientation tracking is only supported on iOS\n    // Silently ignore on web\n  }\n\n  async isOrientationLocked(): Promise<{\n    locked: boolean;\n    physicalOrientation?: OrientationType;\n    uiOrientation: OrientationType;\n  }> {\n    const orientationResult = await this.orientation();\n    return {\n      locked: false,\n      uiOrientation: orientationResult.type,\n    };\n  }\n\n  async isDeviceFoldable(): Promise<DeviceFoldableResult> {\n    return { foldable: false, supportsTabletop: false };\n  }\n\n  async getFoldState(): Promise<FoldState> {\n    return FLAT_FOLD;\n  }\n\n  async getHingeAngle(): Promise<HingeAngleResult> {\n    return { angle: null, status: null };\n  }\n\n  async getReservedRegions(): Promise<{ regions: ReservedRegion[] }> {\n    return { regions: [] };\n  }\n\n  async getBarPlacement(): Promise<BarPlacement> {\n    return { verticalBarEdge: null, inset: 0 };\n  }\n\n  async setVerticalBarBehavior(): Promise<{ applied: boolean }> {\n    return { applied: false };\n  }\n\n  async getSizeClass(): Promise<SizeClass> {\n    return this.readSizeClass();\n  }\n\n  async getPluginVersion(): Promise<{ version: string }> {\n    return { version: this.pluginVersion };\n  }\n\n  private readSizeClass(): SizeClass {\n    return sizeClassOf(window.innerWidth, window.innerHeight);\n  }\n\n  private mapOrientationType(type: string): OrientationType {\n    if (type.includes('portrait-primary') || type === 'portrait-primary') {\n      return 'portrait-primary';\n    }\n    if (type.includes('portrait-secondary') || type === 'portrait-secondary') {\n      return 'portrait-secondary';\n    }\n    if (type.includes('landscape-primary') || type === 'landscape-primary') {\n      return 'landscape-primary';\n    }\n    if (type.includes('landscape-secondary') || type === 'landscape-secondary') {\n      return 'landscape-secondary';\n    }\n    return 'portrait-primary'; // default fallback\n  }\n}\n"]}