<?php

/*
 * @copyright   Copyright (C) 2010-2025 Combodo SAS
 * @license     http://opensource.org/licenses/AGPL-3.0
 */

namespace Combodo\iTop\Forms\IO;

/**
 * Abstract form binding.
 *
 * @package Combodo\iTop\Forms\IO
 * @since 3.3.0
 */
class FormBinding
{
	public readonly AbstractFormIO $oSourceIO;
	public readonly AbstractFormIO $oDestinationIO;

	/**
	 * @param AbstractFormIO $oSourceIO
	 * @param AbstractFormIO $oDestinationIO
	 *
	 * @throws \Combodo\iTop\Forms\IO\FormBlockIOException
	 */
	public function __construct(AbstractFormIO $oSourceIO, AbstractFormIO $oDestinationIO)
	{
		// Check IOFormat validity
		$sSourceDataType = $oSourceIO->GetDataType();
		$sDestinationDataType = $oDestinationIO->GetDataType();
		if (!$oDestinationIO->IsCompatibleWith($oSourceIO)) {
			throw new FormBlockIOException('binding '.json_encode($sSourceDataType).' to '.json_encode($sDestinationDataType).' is not supported');
		}
		$this->oDestinationIO = $oDestinationIO;
		$this->oSourceIO = $oSourceIO;
		$oDestinationIO->Attach($this);
	}

	/**
	 * Propagate binding values.
	 *
	 * @return void
	 */
	public function PropagateValues(): void
	{
		$this->oDestinationIO->SetValues($this->oSourceIO->GetValues());
		$this->oDestinationIO->GetOwnerBlock()->BindingReceivedEvent($this->oDestinationIO);
	}
}