Feat: Normalize template name using regex to allow capitalized prefixes

  * prefixes in format `PREFIX_` for template name can now be used
  * it will normalize the template name to lower case - `prefix_`
  * motivation is to allowed `UNSTABLE_` prefix name for our components

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 <!-- There should always be "Unreleased" section at the beginning. -->
 ## Unreleased
+- Feat: Normalize template name using regex to allow capitalized prefixes
 
 ## 3.2.1 - 2023-03-30
 - Fix: Negative lookahead breaks parsing of element closing bracket

src/Compiler/ComponentTagCompiler.php

@@ -83,7 +83,13 @@ function (array $matches) {
 
     protected function componentStartString(string $component, string $attributes): string
     {
-        return "{% embed \"@" . $this->twigPathAlias . "/" . lcfirst($component) . ".twig\" with { props: $attributes } %}";
+        return sprintf(
+            // another `%` is used for escaping the `%`, e. g. `%%` -> `%`
+            "{%% embed \"@%s/%s.twig\" with { props: %s } %%}",
+            $this->twigPathAlias,
+            $this->normalizeComponentPathName($component),
+            $attributes
+        );
     }
 
     /**
@@ -146,6 +152,13 @@ function (array $matches) {
         );
     }
 
+    private function normalizeComponentPathName(string $name): string
+    {
+        return preg_replace_callback('/^[A-Z]+_?/', function ($matches) {
+            return strtolower($matches[0]);
+        }, $name) ?: $name;
+    }
+
     private function valueParser(?string $value, string $attribute): string
     {
         if ($value === null) {

tests/Compiler/ComponentTagCompilerTest.php

@@ -15,6 +15,13 @@ public function testShouldCompile(): void
         $this->assertSame('{% embed "@alias/alert.twig" with { props: {\'color\': "primary"} } %}{% endembed %}', $compiler->compile());
     }
 
+    public function testShouldCompileUnstable(): void
+    {
+        $compiler = new ComponentTagCompiler('<UNSTABLE_Alert color="primary" />', 'alias');
+
+        $this->assertSame('{% embed "@alias/unstable_Alert.twig" with { props: {\'color\': "primary"} } %}{% endembed %}', $compiler->compile());
+    }
+
     public function testShouldCompileClosingTag(): void
     {
         $compiler = new ComponentTagCompiler('<Alert color="primary">test</Alert>', 'alias');