<?php
/**
 * File Path: includes/helpers/class-mbs-pro-gate.php
 *
 * My Book Showroom — PRO Gate Helper
 *
 * Static helper for emitting PRO-gate HTML comments. Extracted from the
 * global mbs_pro_comment() function (RF-013) so it is autoloadable and
 * follows the MBS_ class-prefix architecture.
 *
 * @package MyBookShowroom
 * @since   1.0.0
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class MBS_Pro_Gate { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedClassFound -- mbs_/MBS_ prefix is correct; scanner not configured with plugin prefix

	/**
	 * Emit the standard PRO-gate HTML comment and return false.
	 *
	 * Use wherever a PRO-only feature would otherwise render visible output.
	 * The HTML comment is immediately echoed; the return value is always false,
	 * making the following pattern safe in any context:
	 *
	 *   return MBS_Pro_Gate::comment( 'Book Club' );
	 *
	 * @param string $feature Human-readable feature name, e.g. 'Book Club'.
	 * @return false Always returns false.
	 */
	public static function comment( string $feature ): false {
		echo '<!-- MBS: ' . esc_html( $feature ) . ' requires PRO license -->';
		return false;
	}
}
