Begin sketching out the class

src/Actions/GeneratesDocumentationSearchIndexFile.php

@@ -3,6 +3,8 @@
 namespace Hyde\Framework\Actions;
 
 use Hyde\Framework\Contracts\ActionContract;
+use Hyde\Framework\Hyde;
+use Illuminate\Support\Collection;
 
 /**
  * Generate a JSON file that can be used as a search index for documentation pages.
@@ -11,8 +13,58 @@
  */
 class GeneratesDocumentationSearchIndexFile implements ActionContract
 {
-    public function execute()
+    public Collection $searchIndex;
+    public static string $filePath = '_site/docs/searchIndex.json';
+
+    public static function run(): void
+    {
+        (new static())->execute();
+    }
+
+    public function __construct()
+    {
+        $this->searchIndex = new Collection();
+    }
+
+    public function execute(): void
+    {
+        $this->generate();
+        $this->save();
+    }
+
+    public function generate(): void
+    {
+        foreach ($this->getSourceFileSlugs() as $page) {
+            $this->searchIndex->push(
+                $this->generatePageObject($page)
+            );
+        }
+    }
+
+    public function generatePageObject(string $slug): object
+    {
+        return (object) [
+            'slug' => $slug
+        ];
+    }
+
+    public function getSourceFileSlugs(): array
+    {
+        return [];
+    }
+
+    public function getObject(): object
+    {
+        return (object) $this->searchIndex;
+    }
+
+    public function getJson(): string
     {
+        return json_encode($this->getObject());
+    }
 
+    public function save(): void
+    {
+        file_put_contents(Hyde::path(static::$filePath), $this->getJson());
     }
 }

tests/Feature/Actions/GeneratesDocumentationSearchIndexFileTest.php

@@ -3,12 +3,38 @@
 namespace Tests\Feature\Actions;
 
 use Tests\TestCase;
-use Hyde\Framework\Actions\GeneratesDocumentationSearchIndexFile;
+use Hyde\Framework\Actions\GeneratesDocumentationSearchIndexFile as Action;
 
 /**
  * @covers \Hyde\Framework\Actions\GeneratesDocumentationSearchIndexFile
  */
 class GeneratesDocumentationSearchIndexFileTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
 
+        unlinkIfExists(Action::$filePath);
+    }
+
+    protected function tearDown(): void
+    {
+        unlinkIfExists(Action::$filePath);
+
+        parent::tearDown();
+    }
+
+
+    // Test save method saves the file to the correct location.
+    public function test_save_method_saves_the_file_to_the_correct_location()
+    {
+        (new Action())->save();
+
+        $this->assertFileExists('_site/docs/searchIndex.json');
+    }
+
+
+    // Test it generates a JSON file with a search index
+
+    // Test it handles generation even when there are no pages
 }