Add static HydePage::get() method to get pages from the page collection

packages/framework/src/Framework/Actions/SourceFileParser.php

@@ -26,6 +26,9 @@ class SourceFileParser
     protected string $identifier;
     protected HydePage $page;
 
+    /**
+     * @throws \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist.
+     */
     public function __construct(string $pageClass, string $identifier)
     {
         $this->validateExistence($pageClass, $identifier);

packages/framework/src/Pages/Concerns/HydePage.php

@@ -75,11 +75,26 @@ public function __construct(string $identifier = '', FrontMatter|array $matter =
 
     // Section: Query
 
+    /**
+     * Get a page instance from the Kernel's page index by its identifier.
+     *
+     * @param  string  $identifier
+     * @return \Hyde\Pages\Concerns\HydePage
+     *
+     * @throws \Hyde\Framework\Exceptions\FileNotFoundException If the page does not exist.
+     */
+    public static function get(string $identifier): HydePage
+    {
+        return Hyde::pages()->getPage(static::sourcePath($identifier));
+    }
+
     /**
      * Parse a source file into a page model instance.
      *
      * @param  string  $identifier  The identifier of the page to parse.
      * @return static New page model instance for the parsed source file.
+     *
+     * @throws \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist.
      */
     public static function parse(string $identifier): HydePage
     {

packages/framework/tests/Feature/HydePageTest.php

@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Hyde;
 use Hyde\Markdown\Models\Markdown;
 use Hyde\Pages\BladePage;
@@ -208,6 +209,17 @@ public function test_get_identifier_returns_identifier_property()
         $this->assertEquals('foo', $page->getIdentifier());
     }
 
+    public function test_static_get_method_returns_discovered_page()
+    {
+        $this->assertEquals(BladePage::parse('index'), BladePage::get('index'));
+    }
+
+    public function test_static_get_method_throws_exception_if_page_not_found()
+    {
+        $this->expectException(FileNotFoundException::class);
+        BladePage::get('foo');
+    }
+
     public function test_parse_parses_supplied_slug_into_a_page_model()
     {
         Hyde::touch(('_pages/foo.md'));