feat(form-builder): MergeStrategy enum methods + binding value objects (WS-6)

- FormFieldBindingMergeStrategy::nullWinnerBehaviour() and
  isValidForScalarTargets() encode the per-strategy null-winner matrix
  (RFC Q7) and the collection-only restriction (RFC V1).
- ResolvedBinding/BindingApplicationResult/BindingPassResult readonly
  DTOs for the binding pipeline. Construction-time validation for
  trust level. Apply-status derived from result aggregate.

Note: the existing enum is named FormFieldBindingMergeStrategy (not
MergeStrategy as the prompt sketched). Methods added to it directly.

Refs: RFC-WS-6.md §3 (Q4, Q7), §4 (V1)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-25 22:38:55 +02:00
parent 447511634d
commit b2e9ef8824
8 changed files with 463 additions and 0 deletions

View File

@@ -0,0 +1,27 @@
<?php
declare(strict_types=1);
namespace Tests\Unit\Enums\FormBuilder;
use App\Enums\FormBuilder\FormFieldBindingMergeStrategy;
use PHPUnit\Framework\TestCase;
final class MergeStrategyTest extends TestCase
{
public function test_null_winner_behaviour_per_strategy(): void
{
$this->assertSame('write', FormFieldBindingMergeStrategy::Overwrite->nullWinnerBehaviour());
$this->assertSame('noop', FormFieldBindingMergeStrategy::Append->nullWinnerBehaviour());
$this->assertSame('noop', FormFieldBindingMergeStrategy::Replace->nullWinnerBehaviour());
$this->assertSame('conditional', FormFieldBindingMergeStrategy::FirstWriteWins->nullWinnerBehaviour());
}
public function test_is_valid_for_scalar_targets_only_append_returns_false(): void
{
$this->assertTrue(FormFieldBindingMergeStrategy::Overwrite->isValidForScalarTargets());
$this->assertFalse(FormFieldBindingMergeStrategy::Append->isValidForScalarTargets());
$this->assertTrue(FormFieldBindingMergeStrategy::Replace->isValidForScalarTargets());
$this->assertTrue(FormFieldBindingMergeStrategy::FirstWriteWins->isValidForScalarTargets());
}
}