Make the media file class stringable

packages/framework/src/Support/Filesystem/MediaFile.php

@@ -5,6 +5,7 @@
 namespace Hyde\Support\Filesystem;
 
 use Hyde\Hyde;
+use Stringable;
 use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
 use Illuminate\Support\Collection;
@@ -21,7 +22,7 @@
 /**
  * File abstraction for a project media file.
  */
-class MediaFile extends ProjectFile
+class MediaFile extends ProjectFile implements Stringable
 {
     /** @var array<string> The default extensions for media types */
     final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
@@ -42,6 +43,14 @@ public function __construct(string $path)
         parent::__construct($this->getNormalizedPath($path));
     }
 
+    /**
+     * Cast the instance to a string which is the resolved web link to the media file.
+     */
+    public function __toString(): string
+    {
+        return $this->getLink();
+    }
+
     /**
      * Get an array of media asset filenames relative to the `_media/` directory.
      *

packages/framework/tests/Unit/Support/MediaFileUnitTest.php

@@ -517,6 +517,63 @@ public function testGetLinkWithCurrentPageContextAndCustomMediaDirectory()
         Hyde::setMediaDirectory('_media'); // Reset to default
     }
 
+    public function testCanCastToString()
+    {
+        $file = new MediaFile('foo.txt');
+        $this->assertIsString((string) $file);
+        $this->assertSame('media/foo.txt', (string) $file);
+    }
+
+    public function testStringCastReturnsLink()
+    {
+        $file = new MediaFile('foo.txt');
+        $this->assertSame($file->getLink(), (string) $file);
+    }
+
+    public function testStringCastWithCustomMediaDirectory()
+    {
+        Hyde::setMediaDirectory('custom_media');
+        $file = new MediaFile('foo.txt');
+        $this->assertSame('custom_media/foo.txt', (string) $file);
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    public function testStringCastWithPrettyUrls()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.pretty_urls' => true]);
+        $file = new MediaFile('foo.txt');
+        $this->assertSame('media/foo.txt', (string) $file);
+    }
+
+    public function testStringCastWithNestedFile()
+    {
+        $file = new MediaFile('subdirectory/foo.txt');
+        $this->assertSame('media/subdirectory/foo.txt', (string) $file);
+    }
+
+    public function testStringCastWithBaseUrl()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.url' => 'https://example.com']);
+        $file = new MediaFile('foo.txt');
+        $this->assertSame('https://example.com/media/foo.txt', (string) $file);
+    }
+
+    public function testStringCastWithCacheBusting()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => true]);
+        $this->mockFilesystem->shouldReceive('hash')
+            ->andReturn('abc123');
+        $file = new MediaFile('foo.txt');
+        $this->assertSame('media/foo.txt?v=abc123', (string) $file);
+    }
+
+    public function testStringCastWithCurrentPageContext()
+    {
+        $this->mockCurrentPage('foo/bar');
+        $file = new MediaFile('baz.txt');
+        $this->assertSame('../media/baz.txt', (string) $file);
+    }
+
     // Helper method to mock the current page
     protected function mockCurrentPage(string $page): void
     {