Improve the error handling while failure on an expression parsing

composer.json

@@ -14,8 +14,8 @@
         }
     ],
     "require": {
-        "laminas/laminas-stdlib": "^3.18",
         "php": "^8.1",
+        "laminas/laminas-stdlib": "^3.18",
         "symfony/config": "^5.4 || ^6.0",
         "symfony/dependency-injection": "^5.4 || ^6.0",
         "symfony/expression-language": "^5.4 || ^6.0",
@@ -58,7 +58,8 @@
         }
     },
     "replace": {
-        "sylius/twig-event": "self.version"
+        "sylius/twig-event": "self.version",
+        "sylius/twig-hooks": "self.version"
     },
     "config": {
         "allow-plugins": {

src/TwigHooks/src/Provider/ComponentDataProvider.php

@@ -5,6 +5,7 @@
 namespace Sylius\TwigHooks\Provider;
 
 use Sylius\TwigHooks\Hookable\AbstractHookable;
+use Sylius\TwigHooks\Provider\Exception\InvalidExpressionException;
 use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
 
 final class ComponentDataProvider implements DataProviderInterface
@@ -16,9 +17,22 @@ public function __construct (
 
     public function provide(AbstractHookable $hookable, array $hookData): array
     {
-        return $this->mapArrayRecursively(function (mixed $value) use ($hookData): mixed {
+        return $this->mapArrayRecursively(function (mixed $value) use ($hookData, $hookable): mixed {
             if (is_string($value) && str_starts_with($value, '@=')) {
-                return $this->expressionLanguage->evaluate(substr($value, 2), $hookData);
+                try {
+                    return $this->expressionLanguage->evaluate(substr($value, 2), $hookData);
+                } catch (\Throwable $e) {
+                    throw new InvalidExpressionException(
+                        sprintf(
+                            'Failed to evaluate the "%s" expression while rendering the "%s" hookable in the "%s" hook. Error: %s".',
+                            $value,
+                            $hookable->getName(),
+                            $hookable->getHookName(),
+                            $e->getMessage(),
+                        ),
+                        previous: $e,
+                    );
+                }
             }
 
             return $value;

src/TwigHooks/src/Provider/Exception/InvalidExpressionException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sylius\TwigHooks\Provider\Exception;
+
+class InvalidExpressionException extends \Exception
+{
+}

src/TwigHooks/tests/Unit/Provider/ComponentDataProviderTest.php

@@ -7,6 +7,7 @@
 use PHPUnit\Framework\TestCase;
 use Sylius\TwigHooks\Provider\ComponentDataProvider;
 use Sylius\TwigHooks\Provider\DataProviderInterface;
+use Sylius\TwigHooks\Provider\Exception\InvalidExpressionException;
 use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
 use Tests\Sylius\TwigHooks\Utils\MotherObject\BaseHookableMotherObject;
 
@@ -41,6 +42,20 @@ public function testItPassesTemplateLevelDataToExpressionLanguage(): void
         $this->assertSame(['some_key' => 'data'], $dataProvider->provide($hookable, ['some' => 'data', 'another' => 'data']));
     }
 
+    public function testItThrowsCustomExceptionWhenEvaluatingAnExpressionFails(): void
+    {
+        $hookable = BaseHookableMotherObject::withData(['some_key' => '@=some.nonExistingMethod()']);
+
+        $dataProvider = $this->createTestSubject();
+
+        $this->expectException(InvalidExpressionException::class);
+        $this->expectExceptionMessage(
+            'Failed to evaluate the "@=some.nonExistingMethod()" expression while rendering the "some_name" hookable in the "some_hook" hook. Error: Unable to call method "nonExistingMethod" of non-object "some".".',
+        );
+
+        $dataProvider->provide($hookable, ['some' => 'data', 'another' => 'data']);
+    }
+
     private function createTestSubject(): DataProviderInterface
     {
         return new ComponentDataProvider(