<?php
namespace JVBase\meta;

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

/**
 * Data container for a single WordPress object (post, term, user, or options)
 * Holds the WP object reference and a collection of Field instances
 */
final class Item
{
	public int|string|null $id;
	public string $objectType;      // post, term, user, options
	public ?string $contentType;    // tattoo, artist, style (without BASE prefix)
	public ?object $wpObject;       // WP_Post, WP_Term, WP_User

	/** @var array<string, Field> Loaded fields */
	public array $fields = [];

	/** @var array<string, array> Raw field configs from registry */
	public array $fieldConfigs = [];

	/** @var string|null Base key for options storage */
	public ?string $baseKey = null;

	/**
	 * WordPress default fields by object type
	 */
	public const WP_DEFAULTS = [
		'post' => [
			'post_title',
			'post_excerpt',
			'post_content',
			'post_date',
			'post_status',
			'post_modified',
			'post_thumbnail',
			'menu_order'
		],
		'user' => [
			'first_name',
			'last_name',
			'display_name',
			'description',
			'user_email',
		],
		'term' => [
			'name',
			'description'
		]
	];

	public function __construct(
		int|string|null $id,
		string $objectType,
		?string $contentType = null
	) {
		$this->id = $id;
		$this->objectType = $objectType;
		$this->contentType = $contentType;
	}

	/**
	 * Check if field exists in configs
	 */
	public function hasField(string $name): bool
	{
		return isset($this->fields[$name]) || isset($this->fieldConfigs[$name]);
	}

	/**
	 * Get loaded field instance
	 */
	public function getField(string $name): ?Field
	{
		return $this->fields[$name] ?? null;
	}

	/**
	 * Set/add a field instance
	 */
	public function setField(Field $field): self
	{
		$this->fields[$field->name] = $field;
		return $this;
	}

	/**
	 * Remove a field instance
	 */
	public function removeField(string $name): self
	{
		unset($this->fields[$name]);
		return $this;
	}

	/**
	 * Get field configuration
	 */
	public function getFieldConfig(string $name): ?array
	{
		if (isset($this->fieldConfigs[$name])) {
			return $this->fieldConfigs[$name];
		}

		// Search nested fields (repeaters, groups)
		foreach ($this->fieldConfigs as $config) {
			if (isset($config['fields'][$name])) {
				return $config['fields'][$name];
			}
		}

		return null;
	}

	/**
	 * Check if field is a WordPress default
	 */
	public function isWpDefault(string $name): bool
	{
		$defaults = self::WP_DEFAULTS[$this->objectType] ?? [];
		return in_array($name, $defaults, true);
	}

	/**
	 * Get all dirty (changed) fields
	 * @return array<string, Field>
	 */
	public function getDirtyFields(): array
	{
		return array_filter($this->fields, fn(Field $f) => $f->isDirty);
	}

	/**
	 * Get all invalid fields
	 * @return array<string, Field>
	 */
	public function getInvalidFields(): array
	{
		return array_filter($this->fields, fn(Field $f) => !$f->isValid);
	}

	/**
	 * Mark all loaded fields as clean
	 */
	public function markAllClean(): self
	{
		foreach ($this->fields as $field) {
			$field->markClean();
		}
		return $this;
	}

	/**
	 * Reset all fields to original values
	 */
	public function resetAll(): self
	{
		foreach ($this->fields as $field) {
			$field->reset();
		}
		return $this;
	}

	/**
	 * Check if any fields are dirty
	 */
	public function hasDirtyFields(): bool
	{
		return !empty($this->getDirtyFields());
	}

	/**
	 * Check if all fields are valid
	 */
	public function isValid(): bool
	{
		return empty($this->getInvalidFields());
	}

	/**
	 * Get all field names from configs
	 */
	public function getFieldNames(): array
	{
		return array_keys($this->fieldConfigs);
	}

	/**
	 * Get loaded field values as array
	 */
	public function toArray(): array
	{
		$data = [];
		foreach ($this->fields as $name => $field) {
			$data[$name] = $field->value;
		}
		return $data;
	}
}