Breaking: Remove the mediaLink helper replaced by the Asset API

Author: emmadesilva

docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md

@@ -1,7 +1,7 @@
 <section id="hyde-kernel-hyperlink-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsHyperlinks -->
-<!-- Generated by HydePHP DocGen script at 2024-09-02 11:18:08 in 0.14ms -->
+<!-- Generated by HydePHP DocGen script at 2024-09-04 19:44:45 in 0.10ms -->
 
 #### `formatLink()`
 
@@ -19,14 +19,6 @@ No description provided.
 Hyde::relativeLink(string $destination): string
 ```
 
-#### `mediaLink()`
-
-No description provided.
-
-```php
-Hyde::mediaLink(string $destination, bool $validate): string
-```
-
 #### `asset()`
 
 No description provided.

docs/architecture-concepts/the-hydekernel.md

@@ -205,14 +205,6 @@ No description provided.
 Hyde::relativeLink(string $destination): string
 ```
 
-#### `mediaLink()`
-
-No description provided.
-
-```php
-Hyde::mediaLink(string $destination, bool $validate): string
-```
-
 #### `asset()`
 
 No description provided.

ide.json

@@ -22,7 +22,7 @@
             },
             "condition": [
                 {
-                    "methodNames": ["get", "mediaLink", "hasMediaFile"],
+                    "methodNames": ["get", "hasMediaFile"],
                     "place": "parameter",
                     "classFqn": ["\\Hyde\\Facades\\Asset"],
                     "parameters": [1]

packages/framework/src/Facades/Asset.php

@@ -22,11 +22,6 @@ public static function get(string $file): MediaFile
         return hyde()->asset($file);
     }
 
-    public static function mediaLink(string $file): string
-    {
-        return hyde()->mediaLink($file);
-    }
-
     public static function hasMediaFile(string $file): bool
     {
         return file_exists(MediaFile::sourcePath($file));

packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php

@@ -24,11 +24,6 @@ public function relativeLink(string $destination): string
         return $this->hyperlinks->relativeLink($destination);
     }
 
-    public function mediaLink(string $destination, bool $validate = false): string
-    {
-        return $this->hyperlinks->mediaLink($destination, $validate);
-    }
-
     public function asset(string $name): MediaFile
     {
         return $this->hyperlinks->asset($name);

packages/framework/src/Foundation/Kernel/Hyperlinks.php

@@ -14,7 +14,6 @@
 use function str_ends_with;
 use function str_starts_with;
 use function substr_count;
-use function file_exists;
 use function str_replace;
 use function str_repeat;
 use function substr;
@@ -87,23 +86,6 @@ public function relativeLink(string $destination): string
         return str_replace('//', '/', $route);
     }
 
-    /**
-     * Gets a relative web link to the given file stored in the _site/media folder.
-     *
-     * @deprecated Use the `asset` method instead.
-     *
-     * An exception will be thrown if the file does not exist in the _media directory,
-     * and the second argument is set to true.
-     */
-    public function mediaLink(string $destination, bool $validate = false): string
-    {
-        if ($validate && ! file_exists($sourcePath = "{$this->kernel->getMediaDirectory()}/$destination")) {
-            throw new FileNotFoundException($sourcePath);
-        }
-
-        return static::withCacheBusting($this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination"), $destination);
-    }
-
     /**
      * Gets a MediaAsset instance for the given file stored in the `_site/media` folder.
      * The returned value can be cast into a string in Blade views to resole the URL.