Feature: add MagicControl for dynamic component creation

Add MagicControl that allows dynamic creation of subcomponents based on
registered factories configured via Neon.

- Add MagicControl class for component registry and factory management
- Add MagicComponents trait for presenters/controls
- Add ApplicationExtension DI extension for Neon configuration
- Add nette/di as required dependency
- Add comprehensive tests and documentation

Usage in Neon:
  application:
    components:
      latestArticles: App\LatestArticlesControlFactory

Usage in Latte:
  {control magic-latestArticles}
  {control magic-latestArticles, count: 10}

Closes #2

Author: claude

.docs/README.md

@@ -7,6 +7,7 @@
 	- [Presenter](#presenter)
 		- [StructuredTemplates](#structured-templates)
 	- [Control](#control)
+		- [MagicControl](#magiccontrol)
 	- [Component](#component)
 - [Responses](#responses)
 	- [CSVResponse](#csvresponse)
@@ -58,6 +59,67 @@ class YourPresenter extends Presenter
 
 - NullControl - displays nothing
 
+#### MagicControl
+
+MagicControl allows dynamic creation of components based on registered factories. This is useful when you want to create reusable components that can be configured via Neon.
+
+**1. Register the DI extension:**
+
+```neon
+extensions:
+    application: Contributte\Application\DI\ApplicationExtension
+
+application:
+    components:
+        latestArticles: App\Components\LatestArticlesControlFactory
+        sidebar: App\Components\SidebarControlFactory
+```
+
+**2. Create your component factory interface:**
+
+```php
+namespace App\Components;
+
+interface LatestArticlesControlFactory
+{
+    public function create(): LatestArticlesControl;
+}
+```
+
+**3. Use the MagicComponents trait in your presenter:**
+
+```php
+use Contributte\Application\UI\MagicComponents;
+use Contributte\Application\UI\MagicControl;
+use Nette\Application\UI\Presenter;
+use Nette\ComponentModel\IComponent;
+
+class BasePresenter extends Presenter
+{
+    use MagicComponents;
+
+    public function injectMagicComponents(MagicControl $magicControl): void
+    {
+        $this->setMagicComponentFactories($magicControl->getFactories());
+    }
+
+    protected function createComponent(string $name): ?IComponent
+    {
+        return $this->tryCreateMagicComponent($name) ?? parent::createComponent($name);
+    }
+}
+```
+
+**4. Use in Latte templates:**
+
+```latte
+{* Basic usage *}
+{control magic-latestArticles}
+
+{* With parameters (passed to component's render method) *}
+{control magic-latestArticles, count: 10}
+```
+
 ### Component
 
 - NullComponent - displays nothing

composer.json

@@ -19,7 +19,8 @@
   ],
   "require": {
     "php": ">=8.2",
-    "nette/application": "^3.2.6 || ^4.0.0"
+    "nette/application": "^3.2.6 || ^4.0.0",
+    "nette/di": "^3.2.0 || ^4.0.0"
   },
   "require-dev": {
     "nette/http": "^3.3.2 || ^4.0.0",

phpstan.neon

@@ -17,3 +17,5 @@ parameters:
 		- .docs
 
 	ignoreErrors:
+		-
+			identifier: trait.unused

src/DI/ApplicationExtension.php

@@ -0,0 +1,83 @@
+<?php declare(strict_types = 1);
+
+namespace Contributte\Application\DI;
+
+use Contributte\Application\UI\MagicControl;
+use Nette\DI\CompilerExtension;
+use Nette\DI\ContainerBuilder;
+use Nette\DI\Definitions\ServiceDefinition;
+use Nette\Schema\Expect;
+use Nette\Schema\Schema;
+use stdClass;
+
+/**
+ * Contributte Application DI Extension
+ *
+ * Example configuration:
+ *   application:
+ *     components:
+ *       latestArticles: App\LatestArticlesControlFactory
+ *       sidebar: App\SidebarControlFactory
+ */
+class ApplicationExtension extends CompilerExtension
+{
+
+	public function getConfigSchema(): Schema
+	{
+		return Expect::structure([
+			'components' => Expect::arrayOf(
+				Expect::string()->required()
+			)->default([]),
+		]);
+	}
+
+	public function loadConfiguration(): void
+	{
+		$builder = $this->getContainerBuilder();
+		/** @var stdClass $config */
+		$config = $this->getConfig();
+
+		// Skip if no components configured
+		if ($config->components === []) {
+			return;
+		}
+
+		// Register MagicControl service
+		$magicControl = $builder->addDefinition($this->prefix('magicControl'))
+			->setFactory(MagicControl::class)
+			->setAutowired(true);
+
+		// Add factory references
+		foreach ($config->components as $name => $factoryClass) {
+			$this->addComponentFactory($magicControl, (string) $name, $factoryClass);
+		}
+	}
+
+	private function addComponentFactory(ServiceDefinition $magicControl, string $name, string $factoryClass): void
+	{
+		$builder = $this->getContainerBuilder();
+
+		// Get or register the factory service
+		$serviceName = $builder->getByType($factoryClass) ?? $this->registerFactory($factoryClass);
+
+		// Create a factory callback that uses the DI container to get the factory service
+		$magicControl->addSetup('addFactory', [
+			$name,
+			ContainerBuilder::literal('fn() => $this->getService(?)->create()', [$serviceName]),
+		]);
+	}
+
+	private function registerFactory(string $factoryClass): string
+	{
+		$builder = $this->getContainerBuilder();
+		$serviceName = $this->prefix('factory.' . md5($factoryClass));
+
+		if (!$builder->hasDefinition($serviceName)) {
+			$builder->addFactoryDefinition($serviceName)
+				->setImplement($factoryClass);
+		}
+
+		return $serviceName;
+	}
+
+}

src/UI/MagicComponents.php

@@ -0,0 +1,116 @@
+<?php declare(strict_types = 1);
+
+namespace Contributte\Application\UI;
+
+use Nette\Application\UI\Control;
+use Nette\Application\UI\Presenter;
+use Nette\ComponentModel\IComponent;
+
+/**
+ * Trait for enabling magic component creation in presenters and controls.
+ *
+ * Usage in presenter/control:
+ *   use MagicComponents;
+ *
+ *   public function injectMagicComponents(MagicControl $magicControl): void
+ *   {
+ *       $this->setMagicComponentFactories($magicControl->getFactories());
+ *   }
+ *
+ *   protected function createComponent(string $name): ?IComponent
+ *   {
+ *       return $this->tryCreateMagicComponent($name) ?? parent::createComponent($name);
+ *   }
+ *
+ * Usage in Latte:
+ *   {control magic-latestArticles}
+ *   {control magic-latestArticles, count: 10}
+ *
+ * @mixin Presenter
+ * @mixin Control
+ */
+trait MagicComponents
+{
+
+	public const MAGIC_PREFIX = 'magic-';
+
+	/** @var array<string, callable> */
+	private array $magicComponentFactories = [];
+
+	/**
+	 * Register a magic component factory
+	 */
+	public function addMagicComponentFactory(string $name, callable $factory): void
+	{
+		$this->magicComponentFactories[$name] = $factory;
+	}
+
+	/**
+	 * Set magic component factories in bulk
+	 *
+	 * @param array<string, callable> $factories
+	 */
+	public function setMagicComponentFactories(array $factories): void
+	{
+		$this->magicComponentFactories = $factories;
+	}
+
+	/**
+	 * Check if a magic component factory is registered
+	 */
+	public function hasMagicComponentFactory(string $name): bool
+	{
+		return isset($this->magicComponentFactories[$name]);
+	}
+
+	/**
+	 * Get all registered magic component factory names
+	 *
+	 * @return string[]
+	 */
+	public function getMagicComponentFactoryNames(): array
+	{
+		return array_keys($this->magicComponentFactories);
+	}
+
+	/**
+	 * Try to create a magic component by name.
+	 * Returns null if the name doesn't match the magic prefix or if no factory is registered.
+	 *
+	 * Call this from your createComponent() method:
+	 *   return $this->tryCreateMagicComponent($name) ?? parent::createComponent($name);
+	 */
+	protected function tryCreateMagicComponent(string $name): ?IComponent
+	{
+		if (!str_starts_with($name, self::MAGIC_PREFIX)) {
+			return null;
+		}
+
+		$componentName = substr($name, strlen(self::MAGIC_PREFIX));
+
+		if (!isset($this->magicComponentFactories[$componentName])) {
+			return null;
+		}
+
+		$factory = $this->magicComponentFactories[$componentName];
+
+		return $factory();
+	}
+
+	/**
+	 * Create a magic component by name with arguments
+	 *
+	 * @param mixed ...$args Arguments to pass to the factory
+	 */
+	protected function createMagicComponent(string $name, mixed ...$args): ?IComponent
+	{
+		if (!isset($this->magicComponentFactories[$name])) {
+			return null;
+		}
+
+		$factory = $this->magicComponentFactories[$name];
+
+		return $factory(...$args);
+	}
+
+}