<?php
/**
 * @package         FireBox
 * @version         3.1.13 Free
 * 
 * @author          FirePlugins <info@fireplugins.com>
 * @link            https://www.fireplugins.com
 * @copyright       Copyright © 2026 FirePlugins All Rights Reserved
 * @license         GNU GPLv3 <http://www.gnu.org/licenses/gpl.html> or later
*/

namespace FireBox\Core\Form\Fields;

if (!defined('ABSPATH'))
{
	exit; // Exit if accessed directly.
}

class Field
{
	/**
	 * Field type. Set by subclasses.
	 *
	 * @var  string
	 */
	protected $type = '';

	/**
	 * Field options.
	 *
	 * @var  array
	 */
	protected $options = [];

	/**
	 * Validation message that appears when a field fails validation.
	 * 
	 * @var  string
	 */
	protected $validation_message = '';

	/**
	 * The form data.
	 * 
	 * @var  array
	 */
	protected $data = [];

	public function __construct($options = [], $data = [])
	{
		// Merge default options with given options
		$this->options = array_merge($this->getDefaultOptions(), $options);

		// Then merge new options with each field options
		$this->options = array_merge($this->options, $this->getFieldOptions());

		$this->data = $data;
	}

	protected function getFieldOptions()
	{
		return [
			'required' => isset($this->options['required']) ? $this->options['required'] : true
		];
	}

	public function getType()
	{
		return $this->type;
	}

	/**
	 * Returns the default field options.
	 * 
	 * @return  array
	 */
	private function getDefaultOptions()
	{
		return [
			'type' => $this->type,
			'name' => '',
			'placeholder' => ''
		];
	}

	/**
	 * Validate the field.
	 * 
	 * @param   mixed  $value
	 *
	 * @return  bool
	 */
	public function validate(&$value = '')
	{
		if ($this->isRequired() && empty($value))
		{
			$this->validation_message = firebox()->_('FB_THIS_IS_A_REQUIRED_FIELD');
			return false;
		}
		
		return true;
	}

	/**
	 * Returns whether the field is required.
	 * 
	 * @return  bool
	 */
	public function isRequired()
	{
		return $this->options['required'];
	}

	/**
	 * Prepare value to be displayed to the user as plain text
	 *
	 * @param  mixed $value
	 *
	 * @return string
	 */
	public function prepareValue($value)
	{
		if (is_bool($value))
		{
			return $value ? '1' : '0';
		}

		if (is_array($value))
		{
			return implode(', ', array_map('\FireBox\Core\Helpers\Form\Field::escape', $value));
		}

		// Check if the value is a JSON string
		if (is_string($value) && ($json = json_decode($value, true)) && is_array($json))
		{
			return implode(', ', array_map('\FireBox\Core\Helpers\Form\Field::escape', $json));
		}

		// Strings and numbers
		return \FireBox\Core\Helpers\Form\Field::escape($value);
	}

	public function getValue()
	{
		return isset($this->options['value']) ? $this->options['value'] : null;
	}

	public function prepareValueHTML($value)
	{
		return $this->prepareValue($value);
	}

	public function prepareRawValue($value)
	{
		return $value;
	}

	public function getValueRaw()
	{
		return $this->getValue();
	}

	public function getValueHTML()
	{
		return $this->prepareValueHTML($this->getValueRaw());
	}

	public function getValidationMessage()
	{
		return $this->validation_message;
	}

	public function setValue($value = '')
	{
		if (!$value)
		{
			return;
		}

		$this->options['value'] = $value;
	}

	public function setOptionValue($key = '', $value = '')
	{
		if (!$key)
		{
			return;
		}

		$this->options[$key] = $value;
	}

	public function getOptionValue($key = '', $default = '')
	{
		if (!$key)
		{
			return $default;
		}

		return isset($this->options[$key]) ? $this->options[$key] : $default;
	}

	public function addInputCSSClass($css = '')
	{
		$this->options['input_css_class'][] = $css;
	}

	public function setData($data = [])
	{
		$this->data = $data;
	}

	public function getData()
	{
		return $this->data;
	}
	
	/**	
	 * Return the field label.
	 * 
	 * @return  string
	 */
	public function getLabel()
	{
		return $this->getOptionValue('label');
	}

	/**
	 * Returns the field input.
	 * 
	 * @return  void
	 */
	protected function getInput() {}

	public function render()
	{
		ob_start();
		$this->getInput();
		$input = ob_get_contents();
		ob_end_clean();

		$payload = array_merge(
			$this->options,
			[
				'input' => $input
			]
		);

		return fpframework()->renderer->render('form/fields/tmpl', $payload, true);
	}
}