Adjust the logic for class name generation, to reduce redundency in the name

src/Frame.php

@@ -36,15 +36,17 @@ public function getRootNode(): self
         return $node;
     }
 
-    public function getName(): string
+    public function getName(bool $emptyParent = false): string
     {
         if ($this->parent && str_contains($this->name, '$parent')) {
             $parent = $this;
             $parentName = '';
-            while ($parent = $parent->getParent()) {
-                $parentName = $parent->getName();
-                if ($parentName) {
-                    break;
+            if (!$emptyParent) {
+                while ($parent = $parent->getParent()) {
+                    $parentName = $parent->getName();
+                    if ($parentName) {
+                        break;
+                    }
                 }
             }
             return str_replace('$parent', $parentName, $this->name);
@@ -55,17 +57,16 @@ public function getName(): string
 
     public function getClassName(): ?string
     {
+        if ($this->getName() && $this->getRootNode()::class === Frame::class) {
+            return $this->sanitizeClassName($this->getName());
+        }
         $prefix = $this->parent?->getClassName() ?? '';
-        $name = $this->getName() ?: $this->getParentKey();
-        if (!$name) {
+        $name = $this->getName(true) ?: $this->getParentKey();
+        if (!$name || ($this->parent && !$prefix)) {
             return null;
         }
 
-        return str_replace(
-            ['$', ' ', '-', '.'],
-            ['', '_', '_', '_'],
-            $prefix === '' ? $name : $prefix . '_' . $name,
-        );
+        return $this->sanitizeClassName($prefix === '' ? $name : ($prefix . '_' . $name));
     }
 
     public function getParent(): ?self
@@ -140,7 +141,9 @@ public function getInherits(): array
         $inherits = (string) $this->xmlElement->attributes()['inherits'] ?? '';
         $inherits = str_replace(' ', '', $inherits);
 
-        return $inherits === '' ? [] : explode(',', $inherits);
+        return $inherits === ''
+            ? []
+            : array_map($this->sanitizeClassName(...), explode(',', $inherits));
     }
 
     /**
@@ -189,4 +192,13 @@ public function getLineNumber(): int
 
         return $node->getLineNo();
     }
+
+    private function sanitizeClassName(string $name): string
+    {
+        return str_replace(
+            ['$', ' ', '-', '.', '!'],
+            ['', '_', '_', '_', '_'],
+            $name,
+        );
+    }
 }

src/Registry.php

@@ -11,12 +11,12 @@
 class Registry
 {
     /**
-     * @var T[]
+     * @var array<string, (T&Frame)>
      */
     private array $items = [];
 
     /**
-     * @param T $template
+     * @param T&Frame $template
      */
     public function register(?string $name, Frame $template): void
     {
@@ -27,15 +27,15 @@ public function register(?string $name, Frame $template): void
     }
 
     /**
-     * @return T|null
+     * @return (T&Frame)|null
      */
     public function get(string $name): ?Frame
     {
         return $this->items[$name] ?? null;
     }
 
     /**
-     * @return T[]
+     * @return array<string, (T&Frame)>
      */
     public function all(): array
     {

src/XmlFileParser.php

@@ -103,7 +103,7 @@ private function parseNode(SimpleXMLElement $node, Registry $fileRegistry, ?Fram
             $this->frameRegistry->register($frame->getClassName(), $frame);
         }
         if (!empty($name)) {
-            $fileRegistry->register($name, $frame);
+            $fileRegistry->register($frame->getClassName(), $frame);
         }
         $parent?->addChild($frame);