<?php

namespace Kirby\Cms;

use Closure;
use Kirby\Toolkit\BlockCollectionAccess;

/**
 * SiteActions
 *
 * @package   Kirby Cms
 * @author    Bastian Allgeier <bastian@getkirby.com>
 * @link      https://getkirby.com
 * @copyright Bastian Allgeier
 * @license   https://getkirby.com/license
 */
trait SiteActions
{
	/**
	 * Commits a site action, by following these steps
	 *
	 * 1. applies the `before` hook
	 * 2. checks the action rules
	 * 3. commits the store action
	 * 4. applies the `after` hook
	 * 5. returns the result
	 */
	protected function commit(
		string $action,
		array $arguments,
		Closure $callback
	): mixed {
		$commit = new ModelCommit(
			model: $this,
			action: $action
		);

		return $commit->call($arguments, $callback);
	}

	/**
	 * Change the site title
	 */
	#[BlockCollectionAccess]
	public function changeTitle(
		string $title,
		string|null $languageCode = null
	): static {
		$language = Language::ensure($languageCode ?? 'current');

		$arguments = [
			'site'         => $this,
			'title'        => trim($title),
			'languageCode' => $languageCode,
			'language'     => $language
		];

		return $this->commit('changeTitle', $arguments, function ($site, $title, $languageCode, $language) {

			// make sure to update the title in the changes version as well
			// otherwise the new title would be lost as soon as the changes are saved
			if ($site->version('changes')->exists($language) === true) {
				$site->version('changes')->update(['title' => $title], $language);
			}

			return $site->save(['title' => $title], $language->code());
		});
	}

	/**
	 * Creates a main page
	 */
	#[BlockCollectionAccess]
	public function createChild(array $props): Page
	{
		return Page::create([
			...$props,
			'url'    => null,
			'num'    => null,
			'parent' => null,
			'site'   => $this,
		]);
	}

	/**
	 * Clean internal caches
	 *
	 * @return $this
	 */
	#[BlockCollectionAccess]
	public function purge(): static
	{
		parent::purge();

		$this->blueprint         = null;
		$this->children          = null;
		$this->childrenAndDrafts = null;
		$this->drafts            = null;
		$this->files             = null;
		$this->inventory         = null;

		return $this;
	}
}