<?php
/**
 * AI 指令渲染：把 {{var}} 变量替换为实际值。
 *
 * 固定变量：{{language_from}} {{language_to}} {{translate_data}}。
 *
 * @package Aipogeo_Context_Translate
 */

defined( 'ABSPATH' ) || exit;

/**
 * Class APGT_Prompt
 */
class APGT_Prompt {

	/**
	 * 三个固定变量名（供界面提示，不允许用户改名）。
	 */
	const VARS = array( 'language_from', 'language_to', 'translate_data' );

	/**
	 * 找出指令里缺失的固定变量。
	 *
	 * 变量匹配规则必须和 render() 完全一致，否则会出现「校验说通过、渲染却
	 * 没替换」的情况。
	 *
	 * @param string $template 指令文本。
	 * @return array 缺失的变量名；都在时返回空数组。
	 */
	public static function missing_vars( $template ) {
		$template = (string) $template;
		$missing  = array();

		foreach ( self::VARS as $var ) {
			if ( ! preg_match( '/\{\{\s*' . preg_quote( $var, '/' ) . '\s*\}\}/iu', $template ) ) {
				$missing[] = $var;
			}
		}

		return $missing;
	}

	/**
	 * 渲染指令模板。
	 *
	 * @param string $template 指令文本（含 {{var}}）。
	 * @param array  $vars     变量值 [ name => value ]，数组值自动 json 编码。
	 * @return string
	 */
	public static function render( $template, array $vars ) {
		$text = (string) $template;
		foreach ( $vars as $k => $v ) {
			if ( is_array( $v ) ) {
				$v = wp_json_encode( $v, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES );
			}
			$text = preg_replace_callback(
				'/\{\{\s*' . preg_quote( $k, '/' ) . '\s*\}\}/iu',
				// 必须走 callback：待翻译文本里出现 $0、$1、\1 时，
				// preg_replace 会把它们当成反向引用替换掉，指令就被改坏了。
				function ( $matches ) use ( $v ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter
					return (string) $v;
				},
				$text
			);
		}
		return $text;
	}
}