<?php

declare(strict_types=1);

namespace App\Enums\FormBuilder;

/**
 * Comparison operator catalogue for relational conditional-logic leaves
 * (ARCH-FORM-BUILDER §8, Phase A seed-scan confirmed catalogue parity
 * with the frontend evaluator in
 * `packages/form-schema/src/composables/useConditionalLogic.ts`).
 *
 * `Empty` / `NotEmpty` do not read the `value` column — the DB stores
 * null for those rows. The service layer enforces this contract.
 */
enum FormFieldConditionalLogicConditionOperator: string
{
    case Equals = 'equals';
    case NotEquals = 'not_equals';
    case Contains = 'contains';
    case NotContains = 'not_contains';
    case In = 'in';
    case NotIn = 'not_in';
    case GreaterThan = 'greater_than';
    case LessThan = 'less_than';
    case Empty = 'empty';
    case NotEmpty = 'not_empty';

    /**
     * Operators that do NOT consume `value`. Used by the service-layer
     * shape validator and by the backfill migration's null-coercion.
     *
     * @return array<int, self>
     */
    public static function valuelessCases(): array
    {
        return [self::Empty, self::NotEmpty];
    }

    public function isValueless(): bool
    {
        return in_array($this, self::valuelessCases(), true);
    }
}