<?php

declare(strict_types=1);

namespace LIT\MCP\Abilities;

defined('ABSPATH') || exit;

/**
 * The MCP annotations of an ability (Ability::annotations()), in three presets. "readonly"
 * drives the "nur lesen" group switch (ExposurePolicy::disabledByReadonly()) and, with
 * "destructive", the Art column of the Tools tab (ruling S47).
 */
final class Annotations
{
    /** @return array{readonly: bool, destructive: bool, idempotent: bool} Reads only. */
    public static function read(): array
    {
        return ['readonly' => true, 'destructive' => false, 'idempotent' => true];
    }

    /** @return array{readonly: bool, destructive: bool, idempotent: bool} Writes, removes or overwrites nothing. */
    public static function write(bool $idempotent): array
    {
        return ['readonly' => false, 'destructive' => false, 'idempotent' => $idempotent];
    }

    /** @return array{readonly: bool, destructive: bool, idempotent: bool} Removes or overwrites something. */
    public static function destructive(bool $idempotent): array
    {
        return ['readonly' => false, 'destructive' => true, 'idempotent' => $idempotent];
    }
}