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');