<?php

namespace DWS_QRWC_Deps\DeepWebSolutions\Framework\Helpers;

use DWS_QRWC_Deps\DeepWebSolutions\Framework\Helpers\DataTypes\Arrays;
\defined( 'ABSPATH' ) || exit;
/**
 * A collection of very useful WP misc helpers to be used throughout the projects.
 *
 * @since   1.0.0
 * @version 1.7.2
 * @author  Antonius Hegyes <a.hegyes@deep-web-solutions.com>
 * @package DeepWebSolutions\WP-Framework\Helpers
 */
final class Misc {

	/**
	 * Recursive version of WordPress' own 'wp_parse_args' in order to handle multidimensional arrays.
	 * In this implementation, non-associative arrays are also leaves.
	 *
	 * @since   1.0.0
	 * @version 1.7.2
	 *
	 * @param   array   $args       The arguments to parse.
	 * @param   array   $defaults   The default arguments.
	 *
	 * @see     https://mekshq.com/recursive-wp-parse-args-wordpress-function/
	 *
	 * @return  array
	 */
	public static function wp_parse_args_recursive( array &$args, array $defaults ) : array {
		$result = $defaults;
		foreach ( $args as $key => &$value ) {
			$result[ $key ] = \is_array( $value ) && isset( $result[ $key ] ) && \is_array( $result[ $key ] ) && \true !== Arrays::is_list( $result[ $key ] ) ? self::wp_parse_args_recursive( $value, $result[ $key ] ) : $value;
		}
		return $result;
	}
	/**
	 * Returns the UNIX timestamp of today's midnight adjusted to a specific timezone.
	 *
	 * @since   1.0.0
	 * @version 1.7.0
	 *
	 * @param   string|null     $timezone_string    Optional timezone string. If not provided, will use the website's own timezone.
	 *
	 * @return  int
	 */
	public static function get_midnight_unix_timestamp( ?string $timezone_string = null ) : int {
		$timezone_string = $timezone_string ?: \wp_timezone_string();
		try {
			$midnight_datetime = new \DateTimeImmutable( 'today midnight', new \DateTimeZone( $timezone_string ) );
			return $midnight_datetime->getTimestamp();
		} catch ( \Exception $e ) {
			return \strtotime( \wp_sprintf( 'today midnight %s', $timezone_string ) ) ?: \strtotime( 'today midnight' );
		}
	}
}
