TASK: Turn abstract Matcher class into interface

...and move the (rule -> matcher) cache concern over to the Scanner
class.

src/Language/Lexer/Matcher/Characters/Characters.php

@@ -23,9 +23,9 @@
 namespace PackageFactory\ComponentEngine\Language\Lexer\Matcher\Characters;
 
 use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Result;
-use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Matcher;
+use PackageFactory\ComponentEngine\Language\Lexer\Matcher\MatcherInterface;
 
-final class Characters extends Matcher
+final class Characters implements MatcherInterface
 {
     public function __construct(
         private readonly string $allowedCharacters,

src/Language/Lexer/Matcher/Exact/Exact.php

@@ -23,9 +23,9 @@
 namespace PackageFactory\ComponentEngine\Language\Lexer\Matcher\Exact;
 
 use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Result;
-use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Matcher;
+use PackageFactory\ComponentEngine\Language\Lexer\Matcher\MatcherInterface;
 
-final class Exact extends Matcher
+final class Exact implements MatcherInterface
 {
     private int $length;
 

src/Language/Lexer/Matcher/Fixed/Fixed.php

@@ -23,13 +23,13 @@
 namespace PackageFactory\ComponentEngine\Language\Lexer\Matcher\Fixed;
 
 use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Result;
-use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Matcher;
+use PackageFactory\ComponentEngine\Language\Lexer\Matcher\MatcherInterface;
 
-final class Fixed extends Matcher
+final class Fixed implements MatcherInterface
 {
     public function __construct(
         private readonly int $fixedLength,
-        private readonly Matcher $innerMatcher
+        private readonly MatcherInterface $innerMatcher
     ) {
         assert($this->fixedLength > 0);
     }

src/Language/Lexer/Matcher/MatcherInterface.php

@@ -0,0 +1,28 @@
+<?php
+
+/**
+ * PackageFactory.ComponentEngine - Universal View Components for PHP
+ *   Copyright (C) 2023 Contributors of PackageFactory.ComponentEngine
+ *
+ *   This program is free software: you can redistribute it and/or modify
+ *   it under the terms of the GNU General Public License as published by
+ *   the Free Software Foundation, either version 3 of the License, or
+ *   (at your option) any later version.
+ *
+ *   This program is distributed in the hope that it will be useful,
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *   GNU General Public License for more details.
+ *
+ *   You should have received a copy of the GNU General Public License
+ *   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace PackageFactory\ComponentEngine\Language\Lexer\Matcher;
+
+interface MatcherInterface
+{
+    public function match(?string $character, int $offset): Result;
+}

src/Language/Lexer/Matcher/Not/Not.php

@@ -23,11 +23,11 @@
 namespace PackageFactory\ComponentEngine\Language\Lexer\Matcher\Not;
 
 use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Result;
-use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Matcher;
+use PackageFactory\ComponentEngine\Language\Lexer\Matcher\MatcherInterface;
 
-final class Not extends Matcher
+final class Not implements MatcherInterface
 {
-    public function __construct(private readonly Matcher $innerMatcher)
+    public function __construct(private readonly MatcherInterface $innerMatcher)
     {
     }
 

src/Language/Lexer/Matcher/Optional/Optional.php

@@ -23,11 +23,11 @@
 namespace PackageFactory\ComponentEngine\Language\Lexer\Matcher\Optional;
 
 use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Result;
-use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Matcher;
+use PackageFactory\ComponentEngine\Language\Lexer\Matcher\MatcherInterface;
 
-final class Optional extends Matcher
+final class Optional implements MatcherInterface
 {
-    public function __construct(private readonly Matcher $innerMatcher)
+    public function __construct(private readonly MatcherInterface $innerMatcher)
     {
     }
 

src/Language/Lexer/Matcher/Sequence/Sequence.php

@@ -23,20 +23,20 @@
 namespace PackageFactory\ComponentEngine\Language\Lexer\Matcher\Sequence;
 
 use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Result;
-use PackageFactory\ComponentEngine\Language\Lexer\Matcher\Matcher;
+use PackageFactory\ComponentEngine\Language\Lexer\Matcher\MatcherInterface;
 
-final class Sequence extends Matcher
+final class Sequence implements MatcherInterface
 {
     private int $lastStop = 0;
     private int $matcherIndex = 0;
     private int $numberOfMatchers;
 
     /**
-     * @var Matcher[]
+     * @var MatcherInterface[]
      */
     private readonly array $matchers;
 
-    public function __construct(Matcher ...$matchers)
+    public function __construct(MatcherInterface ...$matchers)
     {
         $this->matchers = $matchers;
         $this->numberOfMatchers = count($matchers);