<?php

declare(strict_types=1);

namespace App\Enums\FormBuilder;

enum FormFieldBindingMergeStrategy: string
{
    case Overwrite = 'overwrite';
    case Append = 'append';
    case Replace = 'replace';
    case FirstWriteWins = 'first_write_wins';

    /**
     * RFC-WS-6 §3 (Q7) — what to do when the conflict-resolution winner
     * has a null value. Returns one of:
     *   - 'write'        write null to the target (intent: clear)
     *   - 'noop'         leave the target untouched
     *   - 'conditional'  write only when the target itself is null
     */
    public function nullWinnerBehaviour(): string
    {
        return match ($this) {
            self::Overwrite => 'write',
            self::Append => 'noop',
            self::Replace => 'noop',
            self::FirstWriteWins => 'conditional',
        };
    }

    /**
     * RFC-WS-6 §4 (V1) — Append is collection-only (idempotent retry only
     * with set semantics; scalar-append demands fingerprinting which is
     * an architectural smell).
     */
    public function isValidForScalarTargets(): bool
    {
        return $this !== self::Append;
    }
}