<?php

declare(strict_types=1);

namespace App\Models\FormBuilder;

use App\Enums\FormBuilder\FormFieldBindingMergeStrategy;
use App\Enums\FormBuilder\FormFieldBindingMode;
use App\Models\Scopes\FormFieldBindingScope;
use Illuminate\Database\Eloquent\Concerns\HasUlids;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\MorphTo;

/**
 * Relational home for what was `form_fields.binding` and
 * `form_field_library.default_binding` JSON. Polymorphic owner — morph
 * aliases `form_field` and `form_field_library`. See ARCH-FORM-BUILDER
 * §6.7 and ARCH-CONSOLIDATION-ADDENDUM-2026-04-24 §Q3.
 *
 * Pattern B (no binding) is represented by the absence of a row. Only
 * Pattern A (entity_owned) and Pattern C (mirrored) create rows.
 */
final class FormFieldBinding extends Model
{
    use HasFactory;
    use HasUlids;

    protected $table = 'form_field_bindings';

    protected static function booted(): void
    {
        static::addGlobalScope(new FormFieldBindingScope());
    }

    protected $fillable = [
        'owner_type',
        'owner_id',
        'target_entity',
        'target_attribute',
        'mode',
        'sync_direction',
        'merge_strategy',
        'trust_level',
        'is_identity_key',
    ];

    /** @var array<string, string> */
    protected $casts = [
        'mode' => FormFieldBindingMode::class,
        'merge_strategy' => FormFieldBindingMergeStrategy::class,
        'trust_level' => 'int',
        'is_identity_key' => 'bool',
    ];

    public function owner(): MorphTo
    {
        return $this->morphTo('owner', 'owner_type', 'owner_id');
    }

    public function isEntityOwned(): bool
    {
        return $this->mode === FormFieldBindingMode::EntityOwned;
    }

    public function isMirrored(): bool
    {
        return $this->mode === FormFieldBindingMode::Mirrored;
    }
}