feat: implement figurine algebraic notation

[KartikWatts]

closes #487

This PR implements FAN notation.

[KartikWatts]

@programarivm Would like to know your thoughts, will complete the development for this PR based on the knowledge. Regards.

[KartikWatts]

After some thought, I concluded it would be better to extend from SanMovetext as most of the logic could be reused.

[programarivm]

@KartikWatts, Chess\Movetext\FanMovetext can definitely be extended from Chess\Movetext\SanMovetext.

<?php

namespace Chess\Movetext;

class FanMovetext extends SanMovetext
{
    public function validate(): string
    {
        $validated = parent::validate();

        return $this->toFan($validated);
    }

    public function filtered($comments = true, $nags = true): string
    {
        $filtered = parent::filtered($comments, $nags);

        return $this->toFan($filtered);
    }

    protected function toFan(string $movetext)
    {
        // TODO
    }
}

Keep it up,

[KartikWatts]

Hi, after some thought, I realized that both $validated and $movetext are strings, so for cases where comments and nags are also included, simple conversion as in Js-utils won't work, but rather we have to traverse through the string with explode(' ', ... to convert only the pieces and not the whole string in toFan. I didn't find it optimum to traverse two times separately, for validate and filtered methods.

So, conversely, I found it better to have the implementation to convert the properties in proper format straight-way during insert, so that we won't be required to convert them separately later.
Instead, I maintained $sanMoves differently which can be utilized for validation purposes.

Though If we decide it better to call toFan two times rather, let me know, in that case we can traverse through the array: foreach (explode(' ', $this->validated) as $key => $val) { in toFan method, instead of insert as currently done.

[KartikWatts]

My most important question as discussed in the issue discussion as well was to understand, if this is the correct test case that satisfies the requirement, i.e. for standard notation provided the moves would be in FAN, if this is true I'll extend on to it to write more test cases based on the understanding.

[programarivm]

Probably the best thing to do is to extend from SanMovetext as described above.

[programarivm]

@KartikWatts FanMovetextTest has been updated with some changes. At this moment Q and K need to be replaced with miniature piece icons as well. Then, FanMovetext should be rewritten for the tests in FanMovetextTest to pass.

I hope this helps.

Keep it up,

[programarivm]

Also the changes in SanMovetext have been reverted back since this one should not be changed in order to implement FanMovetext.

Let's recap, this the way to proceed now:

1. Q and K need to be replaced with miniature piece icons in FanMovetextTest
2. Rewrite FanMovetext for the tests in FanMovetextTest to pass

Keep it up and happy learning!

[KartikWatts]

The fact that we have toFan method in our FanMoveText class, it only make more sense if the class has ability to receive SAN text as well in the constructor itself.
Likewise, having the ability to get SAN moves is nice.
So, I have implemented 2 tests for the scenarios, let me know your thoughts on this. If approved I can write more tests for other possible cases. Else I can remove the tests.