<?php
/**
 * Resolves a user-configured title/description template string against a
 * fixed whitelist of {{variable}} tokens. The first template-placeholder
 * engine in the plugin — F2.2's Global tab and F2.3's per-type/taxonomy
 * templates are the first configurable-template UI this codebase has ever
 * had; ABDS_SEO_Meta_Builder::resolve_title()'s existing fallback
 * (hardcoded "{post_title} {sep} {site_name}" concatenation) stays exactly
 * as it is for the no-template-configured case.
 *
 * @package ABDS_SEO
 */

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

/**
 * Pure {{token}} substitution against a known variable whitelist.
 */
class ABDS_SEO_Template_Resolver {

	/**
	 * Resolves every {{known_variable}} token in $template against
	 * $variables. A token not present in $variables is left in the output
	 * untouched (not silently stripped) — a typo in a template string
	 * should be visible to whoever configured it, not eaten.
	 *
	 * @param string               $template  Template string, e.g. "{{title}} {{sep}} {{site_name}}".
	 * @param array<string,string> $variables Known variable name => value (without braces), e.g. ['title' => 'Post Title'].
	 * @return string
	 */
	public static function resolve( string $template, array $variables ): string {
		$search  = array();
		$replace = array();

		foreach ( $variables as $name => $value ) {
			$search[]  = '{{' . $name . '}}';
			$replace[] = $value;
		}

		return str_replace( $search, $replace, $template );
	}
}