<?php

namespace WPForms\Admin\Tools\Views;

use WPForms\Integrations\AiMcp\AiMcp as AiMcpIntegration;

/**
 * AI MCP Tools tab — promotes WPVibe MCP bridge and gates write access for Abilities API.
 *
 * @since 1.10.2
 */
class AiMcp extends View {

	/**
	 * View slug.
	 *
	 * @since 1.10.2
	 *
	 * @var string
	 */
	protected $slug = 'ai-mcp';

	/**
	 * Init the view. No-op because asset enqueuing and AJAX registration live
	 * on the Integration class so they run independently of which tab is open.
	 *
	 * @since 1.10.2
	 */
	public function init(): void {

		// Hooks live on the AiMcp Integration class so the AJAX handler can register regardless of which Tools tab is open.
	}

	/**
	 * Tab label used in the Tools navigation.
	 *
	 * @since 1.10.2
	 *
	 * @return string
	 */
	public function get_label(): string {

		return __( 'AI MCP', 'wpforms-lite' );
	}

	/**
	 * Gate the tab on admin-only capability. Same bar as Logs and CodeSnippets.
	 *
	 * @since 1.10.2
	 *
	 * @return bool
	 */
	public function check_capability(): bool {

		/**
		 * Filters whether the current user may view the AI MCP tab.
		 *
		 * @since 1.10.2
		 *
		 * @param bool $can Defaults to manage_options plus the Abilities API (WP 6.9+) being present.
		 *                  Without the Abilities API no WPForms ability registers, so the tab and its
		 *                  write toggle would have nothing to act on.
		 */
		return (bool) apply_filters(
			'wpforms_admin_tools_views_ai_mcp_check_capability',
			wpforms_current_user_can() && function_exists( 'wp_register_ability' )
		);
	}

	/**
	 * Resolve WPVibe state + the current toggle value and render the template.
	 *
	 * @since 1.10.2
	 */
	public function display(): void {

		echo wpforms_render( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
			'admin/tools/ai-mcp',
			AiMcpIntegration::get_template_data(),
			true
		);
	}
}