added Container::getComponentTree()

Author: dg

src/ComponentModel/Container.php

@@ -196,6 +196,23 @@ final public function getComponents(bool $deep = false, ?string $filterType = nu
 	}
 
 
+	/**
+	 * Retrieves the entire hierarchy of components, including all nested child components (depth-first).
+	 * @return list<IComponent>
+	 */
+	final public function getComponentTree(): array
+	{
+		$res = [];
+		foreach ($this->components as $component) {
+			$res[] = $component;
+			if ($component instanceof self) {
+				$res = array_merge($res, $component->getComponentTree());
+			}
+		}
+		return $res;
+	}
+
+
 	/**
 	 * Descendant can override this method to disallow insert a child by throwing an Nette\InvalidStateException.
 	 * @throws Nette\InvalidStateException

tests/ComponentModel/Container.getComponentTree.phpt

@@ -0,0 +1,43 @@
+<?php
+
+/**
+ * Test: Nette\ComponentModel\Container::getComponentTree()
+ */
+
+declare(strict_types=1);
+
+use Nette\ComponentModel\Component;
+use Nette\ComponentModel\Container;
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+class Button extends Component
+{
+}
+
+class ComponentX extends Component
+{
+}
+
+$c = new Container;
+
+$c->addComponent(new Container, 'one');
+$c->addComponent(new ComponentX, 'two');
+$c->addComponent(new Button, 'button1');
+
+$c->getComponent('one')->addComponent(new ComponentX, 'inner');
+$c->getComponent('one')->addComponent(new Container, 'inner2');
+$c->getComponent('one')->getComponent('inner2')->addComponent(new Button, 'button2');
+
+
+$list = $c->getComponentTree();
+Assert::same([
+	'one',
+	'inner',
+	'inner2',
+	'button2',
+	'two',
+	'button1',
+], array_map(fn($c) => $c->getName(), $list));