Se agrega FormLoader con compiler pass que detecta los bundles con rutas de formularios.

Author: estebandelaf

composer.json

@@ -28,7 +28,8 @@
         "php": "^8.5",
         "symfony/framework-bundle": "^8.0",
         "symfony/twig-bundle": "^8.0",
-        "derafu/form": "*"
+        "derafu/form": "*",
+        "derafu/data-processor": "*"
     },
     "require-dev": {
         "ext-xdebug": "*",

config/services.yaml

@@ -46,6 +46,37 @@ services:
         arguments:
             $typeResolver: '@Derafu\Form\Type\TypeResolver'
 
+    # ── Data Processor ────────────────────────────────────────────────
+    # Created via static factory with all default rules (cast, transform,
+    # sanitize, validate). Apps can swap this for a custom-configured
+    # processor by overriding the alias.
+
+    Derafu\DataProcessor\Contract\ProcessorInterface:
+        factory: ['Derafu\DataProcessor\ProcessorFactory', 'createDefault']
+
+    # ── Form Data Processor ───────────────────────────────────────────
+    # Bridges derafu/form schemas with derafu/data-processor rules.
+    # SchemaToRulesMapper converts JSON Schema constraints (minLength,
+    # format, required, etc.) into data-processor rule strings.
+
+    Derafu\Form\Processor\SchemaToRulesMapper: ~
+
+    Derafu\Form\Processor\FormDataProcessor:
+        arguments:
+            $mapper: '@Derafu\Form\Processor\SchemaToRulesMapper'
+            $processor: '@Derafu\DataProcessor\Contract\ProcessorInterface'
+
+    # ── Form Loader ───────────────────────────────────────────────────
+    # Uses PhpFormLoader from derafu/form. Files are .form.php scripts
+    # that return a Closure (dynamic, receives context) or a plain array.
+    # Paths are registered by FormPathsPass compiler pass:
+    #   1. Bundle resources/forms/ directories (auto-discovered)
+    #   2. App forms_path (highest priority, overrides bundles)
+
+    Derafu\Form\Loader\PhpFormLoader:
+        arguments:
+            $formFactory: '@Derafu\Form\Contract\Factory\FormFactoryInterface'
+
     # ── Interface Aliases ─────────────────────────────────────────────
 
     Derafu\Form\Contract\Factory\FormFactoryInterface:
@@ -56,3 +87,12 @@ services:
 
     Derafu\Form\Contract\Type\TypeResolverInterface:
         alias: Derafu\Form\Type\TypeResolver
+
+    Derafu\Form\Contract\Processor\FormDataProcessorInterface:
+        alias: Derafu\Form\Processor\FormDataProcessor
+
+    Derafu\Form\Contract\Processor\SchemaToRulesMapperInterface:
+        alias: Derafu\Form\Processor\SchemaToRulesMapper
+
+    Derafu\Form\Contract\Loader\FormLoaderInterface:
+        alias: Derafu\Form\Loader\PhpFormLoader

src/DependencyInjection/Compiler/FormPathsPass.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Derafu: Symfony Form Bundle - Integrates derafu/form with Symfony.
+ *
+ * Copyright (c) 2026 Esteban De La Fuente Rubio / Derafu <https://www.derafu.dev>
+ * Licensed under the MIT License.
+ * See LICENSE file for more details.
+ */
+
+namespace Derafu\FormBundle\DependencyInjection\Compiler;
+
+use Derafu\Form\Loader\PhpFormLoader;
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+
+/**
+ * Discovers form directories in registered bundles and wires them into
+ * the {@see PhpFormLoader}.
+ *
+ * Convention: any bundle that has a `resources/forms/` directory gets
+ * its forms auto-registered — zero configuration required.
+ *
+ * Priority (last `addPath()` wins):
+ *   1. Bundle paths (in bundle registration order)
+ *   2. App path (`derafu_form.forms_path`) — always highest priority
+ *
+ * This means the app can override any bundle-provided form by placing
+ * a file with the same name in its own `resources/forms/` directory.
+ */
+final class FormPathsPass implements CompilerPassInterface
+{
+    private const string FORMS_DIR = 'resources/forms';
+
+    public function process(ContainerBuilder $container): void
+    {
+        if (!$container->hasDefinition(PhpFormLoader::class)) {
+            return;
+        }
+
+        $loaderDefinition = $container->getDefinition(PhpFormLoader::class);
+
+        // 1. Add bundle paths (in registration order → lower priority).
+        //    kernel.bundles_metadata 'path' points to the namespace root
+        //    (e.g. src/), but resources/ is typically one level up at the
+        //    package root. Check both locations.
+        $bundlesMetadata = $container->getParameter('kernel.bundles_metadata');
+        foreach ($bundlesMetadata as $bundleMeta) {
+            $basePath = $bundleMeta['path'];
+            foreach ([$basePath, dirname($basePath)] as $candidate) {
+                $formsDir = $candidate . '/' . self::FORMS_DIR;
+                if (is_dir($formsDir)) {
+                    $loaderDefinition->addMethodCall('addPath', [$formsDir]);
+                    break;
+                }
+            }
+        }
+
+        // 2. Add app path last (highest priority → overrides bundles).
+        $appFormsPath = $container->getParameter('derafu_form.forms_path');
+        $loaderDefinition->addMethodCall('addPath', [$appFormsPath]);
+    }
+}

src/DependencyInjection/Configuration.php

@@ -31,6 +31,10 @@ public function getConfigTreeBuilder(): TreeBuilder
                     ->defaultValue('derafu_')
                     ->cannotBeEmpty()
                 ->end()
+                ->scalarNode('forms_path')
+                    ->info('Directory for app-level form definition files (highest priority).')
+                    ->defaultValue('%kernel.project_dir%/resources/forms')
+                ->end()
             ->end()
         ;
 

src/DependencyInjection/FormExtension.php

@@ -28,6 +28,7 @@ public function load(array $configs, ContainerBuilder $container): void
         $config = $this->processConfiguration($configuration, $configs);
 
         $container->setParameter('derafu_form.twig_prefix', $config['twig_prefix']);
+        $container->setParameter('derafu_form.forms_path', $config['forms_path']);
 
         $loader = new YamlFileLoader(
             $container,

src/FormBundle.php

@@ -12,7 +12,9 @@
 
 namespace Derafu\FormBundle;
 
+use Derafu\FormBundle\DependencyInjection\Compiler\FormPathsPass;
 use Derafu\FormBundle\DependencyInjection\FormExtension;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Extension\ExtensionInterface;
 use Symfony\Component\HttpKernel\Bundle\Bundle;
 
@@ -27,9 +29,19 @@
  * derafu/renderer) for form templates. A separate `FormTwigExtension`
  * is registered in Symfony's Twig with a prefix so page templates can
  * call `{{ derafu_form(form) }}` etc.
+ *
+ * A compiler pass auto-discovers `resources/forms/` directories in all
+ * registered bundles and wires them into the PhpFormLoader. The app's
+ * own forms directory has the highest priority (override pattern).
  */
 final class FormBundle extends Bundle
 {
+    public function build(ContainerBuilder $container): void
+    {
+        parent::build($container);
+        $container->addCompilerPass(new FormPathsPass());
+    }
+
     public function getContainerExtension(): ?ExtensionInterface
     {
         if ($this->extension === null) {