<?php
/**
 * Dashboard admin page.
 *
 * @package Postlinkly
 * @since   1.1.0
 */

declare(strict_types=1);

namespace Postlinkly\Admin\Pages;

use Postlinkly\Admin\AdminPage;
use Postlinkly\Capabilities\CapabilityMap;

/**
 * Dashboard admin page.
 *
 * The top-level overview screen. Displays four KPI stat cards
 * (total posts indexed, total internal links, link health score,
 * broken links), a monthly link-growth bar chart, and a quick-actions
 * panel for common maintenance tasks.
 *
 * Rendered from `templates/admin/dashboard.php`. All data is fetched
 * by {@see \Postlinkly\Admin\Dashboard\DashboardStatsProvider} which
 * keeps query logic out of the template.
 *
 * @since 1.1.0
 */
final class DashboardPage implements AdminPage {

	/**
	 * @since 1.1.0
	 * @since 1.3.0 Changed from 'postlinkly_dashboard' to 'postlinkly'.
	 */
	public function get_slug(): string {
		return 'postlinkly';
	}

	/**
	 * @since 1.1.0
	 */
	public function get_capability(): string {
		return CapabilityMap::for( 'view_dashboard' );
	}

	/**
	 * @since 1.1.0
	 */
	public function get_menu_title(): string {
		return __( 'Dashboard', 'postlinkly' );
	}

	/**
	 * @since 1.1.0
	 */
	public function get_page_title(): string {
		return __( 'Postlinkly — Dashboard', 'postlinkly' );
	}

	/**
	 * @since 1.1.0
	 *
	 * @return array<int, string>
	 */
	public function get_required_assets(): array {
		return array( \Postlinkly\Admin\Assets\AssetRegistrar::HANDLE_DASHBOARD_CSS );
	}

	/**
	 * @since 1.1.0
	 */
	public function render(): void {
		if ( ! current_user_can( $this->get_capability() ) ) {
			wp_die( esc_html__( 'You do not have permission to view this page.', 'postlinkly' ) );
		}

		$template = $this->template_path( 'dashboard.php' );
		if ( is_readable( $template ) ) {
			include $template;
		}
	}

	/**
	 * Returns the absolute path to a template file.
	 *
	 * @since 1.1.0
	 *
	 * @param string $file Template filename.
	 *
	 * @return string
	 */
	private function template_path( string $file ): string {
		$base = defined( 'POSTLINKLY_PLUGIN_DIR' ) ? (string) POSTLINKLY_PLUGIN_DIR : '';
		return $base . 'templates/admin/' . $file;
	}
}