<?php
/**
 * One line of the "Not looked at" section (control 10).
 *
 * - code   string   Key of Catalogue::NOT_LOOKED.
 * - args   string[] Template arguments.
 * - text   string   English text, rendered.
 * - items  string[] Optional list (paths), at most 50.
 *
 * @package Timaub\AfterHackChecklist
 */

namespace Timaub\AfterHackChecklist\Domain;

final class NotLookedEntry {
	/** @var string */
	public $code = '';
	/** @var string[] */
	public $args = array();
	/** @var string */
	public $text = '';
	/** @var string[] */
	public $items = array();

	public static function make( string $code, array $args = array(), array $items = array() ): self {
		if ( ! isset( Catalogue::NOT_LOOKED[ $code ] ) ) {
			throw new \InvalidArgumentException( 'Unknown not-looked code: ' . $code ); // phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped -- programmer error, never displayed; the domain holds no WordPress function.
		}
		$e        = new self();
		$e->code  = $code;
		$e->args  = array_map( 'strval', array_values( $args ) );
		$e->text  = Catalogue::render( Catalogue::NOT_LOOKED[ $code ], $e->args );
		$e->items = array_values( $items );
		return $e;
	}

	public function toArray(): array {
		return get_object_vars( $this );
	}

	public static function fromArray( array $a ): self {
		$e        = new self();
		$e->code  = (string) $a['code'];
		$e->args  = isset( $a['args'] ) ? (array) $a['args'] : array();
		$e->text  = isset( $a['text'] ) ? (string) $a['text'] : '';
		$e->items = isset( $a['items'] ) ? (array) $a['items'] : array();
		return $e;
	}
}