Add a twig function for generating twig hooks names

composer.json

@@ -65,5 +65,10 @@
             "symfony/runtime": true
         },
         "sort-packages": true
+    },
+    "extra": {
+        "symfony": {
+            "require": "6.4.*"
+        }
     }
 }

src/TwigHooks/src/Twig/HooksExtension.php

@@ -15,6 +15,7 @@ final class HooksExtension extends AbstractExtension
     public function getFunctions(): array
     {
         return [
+            new TwigFunction('hook_name', [HooksRuntime::class, 'createHookName']),
             new TwigFunction('hookable_data', [HooksRuntime::class, 'getHookableData'], ['needs_context' => true]),
             new TwigFunction('hookable_configuration', [HooksRuntime::class, 'getHookableConfiguration'], ['needs_context' => true]),
         ];

src/TwigHooks/src/Twig/Runtime/HooksRuntime.php

@@ -30,8 +30,35 @@ public function __construct (
         }
     }
 
+    public function createHookName(string $base, string ...$parts): string
+    {
+        if ([] === $parts) {
+            return $this->formatBaseString($base);
+        }
+
+        return sprintf(
+            '%s.%s',
+            $this->formatBaseString($base),
+            implode('.', $parts),
+        );
+    }
+
+    private function formatBaseString(string $base): string
+    {
+        $parts = explode('/', $base);
+        $resultParts = [];
+
+        foreach ($parts as $part) {
+            $resultPart = trim($part, '_');
+            $resultPart = str_replace(['@', '.html.twig'], '', $resultPart);
+            $resultPart = strtolower(preg_replace('/(?<!^)[A-Z]/', '_$0', $resultPart));
+            $resultParts[] = $resultPart;
+        }
+
+        return implode('.', $resultParts);
+    }
+
     /**
-     * @param array{hookable_data?: array<string, string>} $context
      * @return array<string, string>
      */
     public function getHookableData(array $context): array
@@ -40,7 +67,6 @@ public function getHookableData(array $context): array
     }
 
     /**
-     * @param array{hookable_configuration?: array<string, string>} $context
      * @return array<string, string>
      */
     public function getHookableConfiguration(array $context): array

src/TwigHooks/tests/Integration/Twig/Runtime/HooksRuntimeTest.php

@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Sylius\TwigHooks\Integration\Twig\Runtime;
+
+use Sylius\TwigHooks\Twig\Runtime\HooksRuntime;
+use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
+
+final class HooksRuntimeTest extends KernelTestCase
+{
+    /**
+     * @dataProvider getHookNameConversionData
+     */
+    public function testItConvertsStringsToHookNames(string $input, string $expectedOutput, array $suffix = []): void
+    {
+        $this->assertSame($expectedOutput, $this->getTestSubject()->createHookName($input, ...$suffix));
+    }
+
+    public function testItReturnsHookableData(): void
+    {
+        $context = [
+            'hookable_data' => ['foo' => 'bar'],
+            'other' => 'data',
+        ];
+
+        $this->assertSame(
+            ['foo' => 'bar'],
+            $this->getTestSubject()->getHookableData($context)
+        );
+    }
+
+    public function testItReturnsHookableConfiguration(): void
+    {
+        $context = [
+            'hookable_configuration' => ['foo' => 'bar'],
+            'other' => 'data',
+        ];
+
+        $this->assertSame(
+            ['foo' => 'bar'],
+            $this->getTestSubject()->getHookableConfiguration($context)
+        );
+    }
+
+    public function testItRendersHook(): void
+    {
+        $this->markTestSkipped('Not implemented yet.');
+    }
+
+    public function testItRendersHookable(): void
+    {
+        $this->markTestSkipped('Not implemented yet.');
+    }
+
+    /**
+     * @return array
+     */
+    public function getHookNameConversionData(): array
+    {
+        return [
+            'simple' => ['@SyliusShop/_product.html.twig', 'sylius_shop.product'],
+            'with slash' => ['@SyliusShop/_product/variant.html.twig', 'sylius_shop.product.variant'],
+            'with camel case' => ['@SyliusShop/_product/variant/optionValue.html.twig', 'sylius_shop.product.variant.option_value'],
+            'without bundle prefix' => ['some_template.html.twig', 'some_template'],
+            'with single suffix part' => ['@SyliusShop/_product.html.twig', 'sylius_shop.product.suffix', ['suffix']],
+            'with multiple suffix parts' => ['@SyliusShop/_product.html.twig', 'sylius_shop.product.suffix.part', ['suffix', 'part']],
+        ];
+    }
+
+    private function getTestSubject(): HooksRuntime
+    {
+        return $this->getContainer()->get(HooksRuntime::class);
+    }
+}