core/hwe/sammo/LazyVarUpdater.php

<?php
namespace sammo;

trait LazyVarUpdater{
    protected $raw = [];
    protected $updatedVar = [];

    function getRaw():array{
        return $this->raw;
    }

    function getVar(string|\BackedEnum $key){
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        return $this->raw[$key];
    }

    function getVars(string|\BackedEnum ...$keys){
        return array_map([$this, 'getVar'], $keys);
    }

    function touchVar(string|\BackedEnum $key):bool{
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        if(key_exists($key, $this->raw)){
            return false;
        }
        $this->raw[$key] = null;

        return true;
    }

    function setVar(string|\BackedEnum $key, $value){
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        return $this->updateVar($key, $value);
    }

    function updateVar(string|\BackedEnum $key, $value){
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        if(($this->raw[$key]??null) === $value){
            return;
        }
        if(!key_exists($key, $this->updatedVar)){
            $this->updatedVar[$key] = true;
        }
        $this->raw[$key] = $value;
    }

    function updateVarWithLimit(string|\BackedEnum $key, $value, $min = null, $max = null){
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        if($min !== null && $value < $min){
            $value = $min;
        }
        if($max !== null && $value > $max){
            $value = $max;
        }
        $this->updateVar($key, $value);
    }

    function increaseVar(string|\BackedEnum $key, $value)
    {
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        if($value === 0){
            return;
        }
        $targetValue = $this->raw[$key] + $value;
        $this->updateVar($key, $targetValue);
    }

    function increaseVarWithLimit(string|\BackedEnum $key, $value, $min = null, $max = null){
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        $targetValue = $this->raw[$key] + $value;
        if($min !== null && $targetValue < $min){
            $targetValue = $min;
        }
        if($max !== null && $targetValue > $max){
            $targetValue = $max;
        }
        $this->updateVar($key, $targetValue);
    }

    function multiplyVar(string|\BackedEnum $key, $value)
    {
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        if($value === 1){
            return;
        }
        $targetValue = $this->raw[$key] * $value;
        $this->updateVar($key, $targetValue);
    }

    function multiplyVarWithLimit(string|\BackedEnum $key, $value, $min = null, $max = null){
        if($key instanceof \BackedEnum){
            $key = $key->value;
        }
        $targetValue = $this->raw[$key] * $value;
        if($min !== null && $targetValue < $min){
            $targetValue = $min;
        }
        if($max !== null && $targetValue > $max){
            $targetValue = $max;
        }
        $this->updateVar($key, $targetValue);
    }

    function getUpdatedValues():array {
        $updateVals = [];
        foreach(array_keys($this->updatedVar) as $key){
            $updateVals[$key] = $this->raw[$key];
        }
        return $updateVals;
    }

    function flushUpdateValues():void {
        $this->updatedVar = [];
    }
}