TranslatableBundleState.php

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Extension\Translate\MessageGroupProcessing;
 
use InvalidArgumentException;
use JsonSerializable;
 
final class TranslatableBundleState implements JsonSerializable {
    public const UNSTABLE = 0;
    public const PROPOSE = 1;
    public const IGNORE = 2;
 
    private const STATE_MAP = [
        'unstable' => self::UNSTABLE,
        'proposed' => self::PROPOSE,
        'ignored' => self::IGNORE,
    ];
    private int $state;
 
    public function __construct( int $state ) {
        if ( !in_array( $state, self::STATE_MAP ) ) {
            throw new InvalidArgumentException( "Invalid translatable bundle state: $state" );
        }
        $this->state = $state;
    }
 
    public static function newFromText( string $stateName ): self {
        $state = self::STATE_MAP[ $stateName ] ?? null;
        if ( $state === null ) {
            throw new InvalidArgumentException( "Invalid translatable bundle state: $stateName" );
        }
        return new TranslatableBundleState( $state );
    }
 
    public function getStateId(): int {
        return $this->state;
    }
 
    public function getStateText(): string {
        return array_flip( self::STATE_MAP )[ $this->state ];
    }
 
    public function jsonSerialize(): array {
        return [
            'stateId' => $this->state
        ];
    }
 
    public static function fromJson( string $json ): self {
        $parsedJson = json_decode( $json, true );
        if ( !is_array( $parsedJson ) ) {
            throw new InvalidArgumentException( "Unexpected JSON value '$json'" );
        }
 
        $stateId = $parsedJson[ 'stateId' ] ?? null;
        if ( $stateId === null ) {
            throw new InvalidArgumentException( 'Provided JSON is missing required field stateId' );
        }
 
        return new TranslatableBundleState( (int)$stateId );
    }
}