<?php
/**
 * Page-number helpers.
 *
 * @package AdminPowerups
 */

namespace SmartWP\AdminPowerups\Support;

defined( 'ABSPATH' ) || exit;

/**
 * Page numbers from requests, kept small enough that the row offset stays an int.
 *
 * @since 1.0.0
 */
final class Paging {

	/**
	 * A page number (from 1) whose offset `( page - 1 ) * per_page` (and the "first row" number
	 * `offset + 1`) never overflows to a float. Anything that isn't a positive number is page 1.
	 *
	 * @since 1.0.0
	 * @param mixed $paged    Requested page (int, numeric string, float, anything).
	 * @param int   $per_page Rows per page (values below 1 count as 1).
	 * @return int
	 */
	public static function page( $paged, int $per_page ): int {
		$max = intdiv( PHP_INT_MAX, max( 1, $per_page ) );
		if ( is_string( $paged ) && is_numeric( trim( $paged ) ) ) {
			$paged = trim( $paged ) + 0; // Int or float, no cast warning ("1e999" is INF).
		}
		if ( is_float( $paged ) ) {
			if ( is_nan( $paged ) || $paged < 1 ) {
				return 1;
			}
			return $paged >= $max ? $max : (int) $paged;
		}
		return is_int( $paged ) ? min( max( 1, $paged ), $max ) : 1;
	}
}