<?php
/**
 * Australcode Admin Kit — section header (Opción 2 / app-bar, decisión 8.121).
 *
 * Hermano de page-header.php. El page-header es la barra de identidad del
 * PLUGIN (icon-256 del producto + nombre EN constante + versión + tabs); este
 * parcial es el encabezado de la VISTA dentro del contenido: nombre de sección
 * (H2) + lede + acciones. Universal — funciona con o sin tabs (no depende del
 * tab activo, así que un plugin sin tabs lo usa igual).
 *
 * Va DESPUÉS del page-header + su <hr class="wp-header-end">.
 *
 * Espera (con defaults seguros):
 *   $acds_section_title   string  — nombre de la vista/sección (H2). Ya traducido por el caller.
 *   $acds_section_lede    string  — opcional: descripción 1 frase (ya traducida).
 *   $acds_section_actions string  — opcional: HTML de acciones (botones), ya escapado.
 *
 * SIN strings traducibles propios (recibe todo del caller ya traducido) → este
 * parcial NO lleva text domain, no toca el sentinel de build-kit.sh.
 *
 * Cuerpo en function-scope (IIFE + get_defined_vars): los locales del parcial
 * viven en el closure, NO en el scope global del include → 0
 * WordPress.NamingConventions.PrefixAllGlobals en el plugin consumidor (B-117),
 * igual que page-header.php. El host setea $acds_section_* y hace require;
 * get_defined_vars() se los pasa al closure como $acds_ctx.
 *
 * @package Australcode\AdminKit
 */

defined( 'ABSPATH' ) || exit;

( static function ( array $acds_ctx ): void {
	$acds_section_title   = isset( $acds_ctx['acds_section_title'] ) ? $acds_ctx['acds_section_title'] : '';
	$acds_section_lede    = isset( $acds_ctx['acds_section_lede'] ) ? $acds_ctx['acds_section_lede'] : '';
	$acds_section_actions = isset( $acds_ctx['acds_section_actions'] ) ? $acds_ctx['acds_section_actions'] : '';

	if ( '' === $acds_section_title && '' === $acds_section_actions ) {
		return; // Nada que renderear.
	}
	?>
	<div class="acds-section-head">
		<div class="acds-section-head__main">
			<?php if ( '' !== $acds_section_title ) : ?>
				<h2 class="acds-section-title"><?php echo esc_html( $acds_section_title ); ?></h2>
			<?php endif; ?>
			<?php if ( '' !== $acds_section_lede ) : ?>
				<p class="acds-section-lede"><?php echo esc_html( $acds_section_lede ); ?></p>
			<?php endif; ?>
		</div>
		<?php if ( '' !== $acds_section_actions ) : ?>
			<div class="acds-section-actions"><?php echo $acds_section_actions; // phpcs:ignore WordPress.Security.EscapeOutput -- pre-escaped by caller. ?></div>
		<?php endif; ?>
	</div>
	<?php
} )( get_defined_vars() );
