/**
 * Determines whether Picture-in-Picture (PiP) mode is currently active.
 *
 * This hook provides a reactive way to observe and respond to changes in the player’s
 * **Picture-in-Picture mode** — i.e., whether the video is being displayed in a
 * floating, resizable overlay outside the main player view.
 *
 * ⚠️ Must be used within a {@link PlayerProvider} or
 * [AVPlayerViewControllerProvider](../../ios-avplayerviewcontroller-plugin-api/variables/AVPlayerViewControllerProvider.md) component.
 *
 * @returns `boolean` **true** if Picture-in-Picture mode is active, otherwise **false**.
 *
 * @example
 * ```tsx
 * function PiPStatus() {
 *   const pictureInPictureMode = usePictureInPictureMode();
 *
 *   return (
 *     <Text>
 *       {pictureInPictureMode ? 'PiP active' : 'PiP inactive'}
 *     </Text>
 *   );
 * }
 * ```
 *
 * @group Hooks
 */
export default function usePictureInPictureMode(): boolean;