Extract experimental helper method to try parsing config values

Author: emmadesilva

packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php

@@ -67,14 +67,8 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
-            try {
-                return [$username => PostAuthor::create($author)];
-            } catch (Throwable $exception) {
-                throw new InvalidConfigurationException(
-                    'Invalid author configuration detected in the YAML config file. Please double check the syntax.',
-                    previous: $exception
-                );
-            }
+            $message = 'Invalid author configuration detected in the YAML config file. Please double check the syntax.';
+            return InvalidConfigurationException::try(fn ()=> [$username => PostAuthor::create($author)], $message);
         });
     }
 }

packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php

@@ -45,4 +45,17 @@ protected function findConfigLine(string $namespace, string $key): array
 
         return [$file, $line + 1];
     }
+
+    /**
+     * @internal
+     * @experimental
+     */
+    public static function try(callable $callback, ?string $message = null): mixed
+    {
+        try {
+            return $callback();
+        } catch (Throwable $exception) {
+            throw new static($message ?? $exception->getMessage(), previous: $exception);
+        }
+    }
 }

packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php

@@ -85,14 +85,9 @@ protected function generate(): void
         } else {
             collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $data): void {
                 /** @var array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $data */
-                try {
-                    $item = NavigationItem::create(...$data);
-                } catch (Throwable $exception) {
-                    throw new InvalidConfigurationException(
-                        'Invalid navigation item configuration detected the configuration file. Please double check the syntax.',
-                        previous: $exception
-                    );
-                }
+
+                $message = 'Invalid navigation item configuration detected the configuration file. Please double check the syntax.';
+                $item = InvalidConfigurationException::try(fn () => NavigationItem::create(...$data), $message);
 
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push($item);

packages/framework/tests/Unit/CustomExceptionsTest.php

@@ -210,4 +210,45 @@ public function testInvalidConfigurationExceptionWithPreviousThrowable()
         $this->assertSame('Invalid configuration.', $exception->getMessage());
         $this->assertSame($previous, $exception->getPrevious());
     }
+
+    public function testInvalidConfigurationExceptionTryMethodWithSuccessfulCallback()
+    {
+        $result = InvalidConfigurationException::try(function () {
+            return 'success';
+        });
+
+        $this->assertSame('success', $result);
+    }
+
+    public function testInvalidConfigurationExceptionTryMethodWithThrowingCallback()
+    {
+        $this->expectException(InvalidConfigurationException::class);
+        $this->expectExceptionMessage('Custom error message');
+
+        InvalidConfigurationException::try(function () {
+            throw new RuntimeException('Original error');
+        }, 'Custom error message');
+    }
+
+    public function testInvalidConfigurationExceptionTryMethodWithDefaultMessage()
+    {
+        $this->expectException(InvalidConfigurationException::class);
+        $this->expectExceptionMessage('Original error');
+
+        InvalidConfigurationException::try(function () {
+            throw new RuntimeException('Original error');
+        });
+    }
+
+    public function testInvalidConfigurationExceptionTryMethodPreservesPreviousException()
+    {
+        try {
+            InvalidConfigurationException::try(function () {
+                throw new RuntimeException('Original error');
+            }, 'Custom error message');
+        } catch (InvalidConfigurationException $e) {
+            $this->assertInstanceOf(RuntimeException::class, $e->getPrevious());
+            $this->assertSame('Original error', $e->getPrevious()->getMessage());
+        }
+    }
 }