<?php

declare( strict_types=1 );

namespace AcezSeo\Robots;

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

/**
 * Pure text-building logic, shared by the front-end robots.txt output and the
 * admin-side preview, so both are always guaranteed to match.
 *
 * NOTE: deliberately does NOT add a "Sitemap:" line — WP core already does
 * this itself (`WP_Sitemaps::add_robots()`, hooked to `robots_txt` whenever
 * sitemaps are enabled). An earlier version of this method added one too;
 * turned out to be a real, reproducible duplicate-line bug once sitemaps
 * were actually enabled on a test install, caught by testing on a live
 * request, not assumed from reading do_robots() in isolation (core's own
 * `Sitemap:` hook is registered conditionally inside WP_Sitemaps::init(),
 * easy to miss when sitemaps happen to be disabled at the time of reading).
 */
final class RobotsTxtBuilder
{
	/**
	 * @param array<string, mixed> $settings
	 */
	public static function build( array $settings ): string
	{
		$lines = array();

		foreach ( (array) $settings['blocked_bots'] as $agent )
		{
			$lines[] = 'User-agent: ' . $agent;
			$lines[] = 'Disallow: /';
			$lines[] = '';
		}

		$custom = trim( (string) $settings['custom_rules'] );

		if ( '' !== $custom )
		{
			$lines[] = $custom;
		}

		return trim( implode( "\n", $lines ) );
	}
}