<?php

namespace Kirby\Cms;

use Exception;
use Kirby\Data\Json;
use Kirby\Data\Yaml;
use Kirby\Parsley\Parsley;
use Kirby\Parsley\Schema\Blocks as BlockSchema;
use Kirby\Toolkit\A;
use Kirby\Toolkit\Str;
use Throwable;

/**
 * A collection of blocks
 * @since 3.5.0
 *
 * @package   Kirby Cms
 * @author    Bastian Allgeier <bastian@getkirby.com>
 * @link      https://getkirby.com
 * @copyright Bastian Allgeier
 * @license   https://getkirby.com/license
 *
 * @extends \Kirby\Cms\Items<\Kirby\Cms\Block>
 */
class Blocks extends Items
{
	public const ITEM_CLASS = Block::class;

	/**
	 * All registered blocks methods
	 */
	public static array $methods = [];

	/**
	 * Return HTML when the collection is
	 * converted to a string
	 */
	public function __toString(): string
	{
		return $this->toHtml();
	}

	/**
	 * Converts the blocks to HTML and then
	 * uses the Str::excerpt method to create
	 * a non-formatted, shortened excerpt from it
	 */
	public function excerpt(mixed ...$args): string
	{
		return Str::excerpt($this->toHtml(), ...$args);
	}

	/**
	 * Wrapper around the factory to
	 * catch blocks from layouts
	 */
	public static function factory(
		array|null $items = null,
		array $params = []
	): static {
		$items = static::extractFromLayouts($items);

		// @deprecated old editor format
		// @todo block.converter remove eventually
		// @codeCoverageIgnoreStart
		$items = BlockConverter::editorBlocks($items);
		// @codeCoverageIgnoreEnd

		return parent::factory($items, $params);
	}

	/**
	 * Pull out blocks from layouts
	 */
	protected static function extractFromLayouts(array $input): array
	{
		if ($input === []) {
			return [];
		}

		if (
			// no columns = no layout
			array_key_exists('columns', $input[0]) === false  ||
			// @deprecated checks if this is a block for the builder plugin
			// @todo block.converter remove eventually
			array_key_exists('_key', $input[0]) === true
		) {
			return $input;
		}

		$blocks = [];

		foreach ($input as $layout) {
			foreach (($layout['columns'] ?? []) as $column) {
				foreach (($column['blocks'] ?? []) as $block) {
					$blocks[] = $block;
				}
			}
		}

		return $blocks;
	}

	/**
	 * Checks if a given block type exists in the collection
	 * @since 3.6.0
	 */
	public function hasType(string $type): bool
	{
		return $this->filterBy('type', $type)->count() > 0;
	}

	/**
	 * Parse and sanitize various block formats
	 */
	public static function parse(array|string|null $input): array
	{
		if (
			empty($input) === false &&
			is_array($input) === false
		) {
			try {
				$input = Json::decode((string)$input);
			} catch (Throwable) {
				// @deprecated try to import the old YAML format
				// @todo block.converter remove eventually
				// @codeCoverageIgnoreStart
				try {
					$yaml  = Yaml::decode((string)$input);
					$first = A::first($yaml);

					// check for valid yaml
					if (
						$yaml === [] ||
						(
							isset($first['_key']) === false &&
							isset($first['type']) === false
						)
					) {
						throw new Exception(message: 'Invalid YAML');
					}

					$input = $yaml;
				} catch (Throwable) {
					// the next 2 lines remain after removing block.converter
					// @codeCoverageIgnoreEnd
					$parser = new Parsley((string)$input, new BlockSchema());
					$input  = $parser->blocks();
					// @codeCoverageIgnoreStart
				}
				// @codeCoverageIgnoreEnd
			}
		}

		if (empty($input) === true) {
			return [];
		}

		return $input;
	}

	/**
	 * Convert all blocks to HTML
	 */
	public function toHtml(): string
	{
		$html = A::map($this->data, fn ($block) => $block->toHtml());

		return implode($html);
	}
}