Add short and concise PHPDoc annotations to the public methods

Author: emmadesilva

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

@@ -29,6 +29,12 @@ class MediaFile extends ProjectFile
     public readonly string $mimeType;
     public readonly string $hash;
 
+    /**
+     * Create a new MediaFile instance.
+     *
+     * @param string $path The file path relative to the project root or media source directory.
+     * @throws FileNotFoundException If the file does not exist in the media source directory.
+     */
     public function __construct(string $path)
     {
         parent::__construct($this->getNormalizedPath($path));
@@ -90,6 +96,11 @@ public function getIdentifier(): string
         return Str::after($this->getPath(), Hyde::getMediaDirectory().'/');
     }
 
+    /**
+     * Get the file information as an array.
+     *
+     * @return array<string, mixed> The file information
+     */
     public function toArray(): array
     {
         return array_merge(parent::toArray(), [
@@ -99,16 +110,31 @@ public function toArray(): array
         ]);
     }
 
+    /**
+     * Get the content length of the file.
+     *
+     * @return int The content length in bytes
+     */
     public function getContentLength(): int
     {
         return $this->length;
     }
 
+    /**
+     * Get the MIME type of the file.
+     *
+     * @return string The MIME type
+     */
     public function getMimeType(): string
     {
         return $this->mimeType;
     }
 
+    /**
+     * Get the hash of the file.
+     *
+     * @return string The file hash
+     */
     public function getHash(): string
     {
         return $this->hash;