julienmonnerie/kirby/src/Cms/Nest.php

<?php

namespace Kirby\Cms;

use Kirby\Content\Field;

/**
 * The Nest class converts any array type
 * into a Kirby style collection/object. This
 * can be used make any type of array compatible
 * with Kirby queries.
 *
 * REFACTOR: move this to the toolkit
 *
 * @package   Kirby Cms
 * @author    Bastian Allgeier <bastian@getkirby.com>
 * @link      https://getkirby.com
 * @copyright Bastian Allgeier
 * @license   https://getkirby.com/license
 */
class Nest
{
	public static function create(
		$data,
		object|null $parent = null
	): NestCollection|NestObject|Field {
		if (is_scalar($data) === true) {
			return new Field($parent, $data, $data);
		}

		$result = [];

		foreach ($data as $key => $value) {
			if (is_array($value) === true) {
				$result[$key] = static::create($value, $parent);
			} elseif (is_scalar($value) === true) {
				$result[$key] = new Field($parent, $key, $value);
			}
		}

		$key = key($data);

		if ($key === null || is_int($key) === true) {
			return new NestCollection($result);
		}

		return new NestObject($result);
	}
}