<?php
/**
 * What the texts are and where they come from, for AI providers: site, page
 * title and type, the whole page text, the style guide and one note per text
 * ("Button", "Hero heading"). Classic engines ignore it.
 */

declare( strict_types = 1 );

namespace AddBlack\Lang\MachineTranslation;

defined( 'ABSPATH' ) || exit;

final class Context {

	/**
	 * @param string[] $notes One note per text, aligned with the texts sent.
	 */
	public function __construct(
		public readonly string $site = '',
		public readonly string $title = '',
		public readonly string $type = '',
		public readonly string $outline = '',
		public readonly string $style = '',
		public readonly array $notes = array()
	) {}

	/** Anything to tell the model about the page (notes and style aside)? */
	public function has_page(): bool {
		return '' !== $this->site || '' !== $this->title || '' !== $this->type || '' !== $this->outline;
	}

	/** @param string[] $notes */
	public function with_notes( array $notes ): self {
		return new self( $this->site, $this->title, $this->type, $this->outline, $this->style, array_values( $notes ) );
	}

	/** @return array<string, string> Non-empty fields; the shape the legacy API used. */
	public function to_array(): array {
		return array_filter(
			array(
				'site'    => $this->site,
				'title'   => $this->title,
				'type'    => $this->type,
				'outline' => $this->outline,
				'style'   => $this->style,
			),
			static fn( string $s ): bool => '' !== $s
		);
	}
}