/**
 * Returns the player’s current playback state.
 *
 * This hook provides a reactive way to observe and respond to changes in the player’s
 * **state** — e.g., whether it’s playing, buffering, paused, or ended.
 *
 * ⚠️ Must be used within a {@link PlayerProvider} or
 * [AVPlayerViewControllerProvider](../../ios-avplayerviewcontroller-plugin-api/variables/AVPlayerViewControllerProvider.md) component.
 *
 * @returns {@link PlayerState} The current player state.
 *
 * @example
 * ```tsx
 * const player = usePlayer();
 * const playerState = usePlayerState();
 *
 * const onPress = useCallback(() => {
 *   if (playerState === PlayerState.Ended) {
 *     player?.replay();
 *   }
 * }, [player, playerState]);
 * ```
 *
 * @group Hooks
 */
export default function usePlayerState(): import("../models/PlayerState").default;