<?php declare( strict_types=1 );

namespace KadenceWP\KadenceBlocks\LiquidWeb\Harbor\View;

use KadenceWP\KadenceBlocks\LiquidWeb\Harbor\View\Exceptions\FileNotFoundException;

use Throwable;

/**
 * Loads and renders PHP view files.
 */
final class WordPress_View implements Contracts\View {

	/**
	 * The server path to the views folder.
	 *
	 * @var string
	 *
	 * @example /app/views/
	 */
	private $directory;

	/**
	 * The file extension of view files.
	 *
	 * @var string
	 *
	 * @example .php
	 */
	private $extension;

	/**
	 * @param string $directory The server path to the views folder.
	 * @param string $extension The file extension of view files.
	 */
	public function __construct( string $directory, string $extension = '.php' ) {
		$real            = realpath( $directory );
		$this->directory = trailingslashit( $real !== false ? $real : $directory );
		$this->extension = $extension;
	}

	/**
	 * Renders a view and returns it as a string to be echoed.
	 *
	 * @example If the server path is /app/views, and you wish to load /app/views/admin/notice.php,
	 * pass `admin/notice` as the view name.
	 *
	 * @param string  $name  The relative path/name of the view file without extension.
	 *
	 * @param mixed[] $args  Arguments to be extracted and passed to the view.
	 *
	 * @throws Throwable If the view file cannot be found or the template throws an exception.
	 *
	 * @return string
	 */
	public function render( string $name, array $args = [] ): string {
		$file = $this->get_path( $name );

		try {
			$level = ob_get_level();
			ob_start();

			extract( $args );
			include $file;

			return (string) ob_get_clean();
		} catch ( Throwable $e ) {
			while ( ob_get_level() > $level ) {
				ob_end_clean();
			}

			throw $e;
		}
	}

	/**
	 * Render a view directly to output.
	 *
	 * @param string  $name  The relative path/name of the view file without extension.
	 * @param mixed[] $args  Arguments to be extracted and passed to the view.
	 *
	 * @return void
	 */
	public function display( string $name, array $args = [] ): void {
		$file = $this->get_path( $name );

		extract( $args );
		include $file;
	}

	/**
	 * Get the absolute server path to a view file.
	 *
	 * @param string $name  The relative view path/name, e.g. `admin/notice`.
	 *
	 * @throws FileNotFoundException If the view file cannot be found.
	 *
	 * @return string The absolute path to the view file.
	 */
	private function get_path( string $name ): string {
		$file = $this->directory . $name . $this->extension;
		$path = realpath( $file );

		if ( $path === false ) {
			throw new FileNotFoundException(
				sprintf(
					/* translators: %s: Absolute path to the missing view file. */
					__( 'View file "%s" not found or not readable.', 'kadence-blocks' ),
					$file
				)
			);
		}

		return $path;
	}
}
