<?php

declare(strict_types=1);

namespace App\Models\FormBuilder;

use App\Enums\FormBuilder\FormFieldConditionalLogicGroupOperator;
use App\Models\Scopes\OrganisationScope;
use Illuminate\Database\Eloquent\Concerns\HasUlids;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;

/**
 * A node in the relational conditional-logic tree for a form field
 * (ARCH-FORM-BUILDER §8). The root group carries the outer boolean
 * operator (`all` / `any`); nested sub-groups link via
 * `parent_group_id`. Leaves live in `FormFieldConditionalLogicCondition`.
 *
 * Multi-tenancy uses the Q2 declarative FK-chain resolver via
 * `tenantScopeStrategy()`. The chain (group → field → schema →
 * organisation_id) is 3 hops — comfortably inside the cap (5 hops as of
 * WS-5c).
 */
final class FormFieldConditionalLogicGroup extends Model
{
    use HasFactory;
    use HasUlids;

    protected $table = 'form_field_conditional_logic_groups';

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

    /** @return array{via: class-string, fk: string} */
    public static function tenantScopeStrategy(): array
    {
        return ['via' => FormField::class, 'fk' => 'form_field_id'];
    }

    protected $fillable = [
        'form_field_id',
        'parent_group_id',
        'operator',
        'sort_order',
    ];

    /** @var array<string, string> */
    protected $casts = [
        'operator' => FormFieldConditionalLogicGroupOperator::class,
        'sort_order' => 'int',
    ];

    public function formField(): BelongsTo
    {
        return $this->belongsTo(FormField::class, 'form_field_id');
    }

    public function parentGroup(): BelongsTo
    {
        return $this->belongsTo(self::class, 'parent_group_id');
    }

    public function childGroups(): HasMany
    {
        return $this->hasMany(self::class, 'parent_group_id');
    }

    public function conditions(): HasMany
    {
        return $this->hasMany(FormFieldConditionalLogicCondition::class, 'group_id');
    }
}