IDE autocomplete support through PHPDoc added 🚀

Author: rahulhaque

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to `laravel-filepond` will be documented in this file.
 
+## 10.2.2 - 2025-07-16
+
+- Added PHPDoc for IDE autocomplete support. 🚀
+
 ## 10.1.2 - 2025-05-08
 
 - Mimetype added in fileinfo response. ✨

README.md

@@ -305,7 +305,7 @@ User::find(1)->fileponds;
 
 ## Development
 
-First clone the repo and `cd` into the directory. Switch to `10.x-dev` branch. Build and start development environment with docker.
+First clone the repo and `cd` into the directory. Build development environment with docker.
 
 ```bash
 # Build the development image
@@ -357,8 +357,8 @@ If you discover any security related issues, please email [email protected]
 
 ## Credits
 
--   [Rahul Haque](https://github.com/rahulhaque)
--   [All Contributors](../../contributors)
+- [Rahul Haque](https://github.com/rahulhaque)
+- [All Contributors](../../contributors)
 
 ## License
 

src/Filepond.php

@@ -26,7 +26,7 @@ public function field(string|array|null $field, bool $checkOwnership = true)
     /**
      * Return file object from the field
      *
-     * @return array|\Illuminate\Http\UploadedFile
+     * @return \Illuminate\Http\UploadedFile|array<int, \Illuminate\Http\UploadedFile>|null
      */
     public function getFile()
     {
@@ -47,7 +47,7 @@ public function getFile()
      * Get the filepond file as Data URL string
      * More at - https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
      *
-     * @return array|string
+     * @return array|array<int, string>|null
      *
      * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
      */
@@ -79,7 +79,25 @@ public function getModel()
     /**
      * Copy the FilePond files to destination
      *
-     * @return array
+     * @return array{
+     *     id: int,
+     *     dirname: string,
+     *     basename: string,
+     *     extension: string,
+     *     mimetype: string,
+     *     filename: string,
+     *     location: string,
+     *     url: string
+     * }|array<int, array{
+     *     id: int,
+     *     dirname: string,
+     *     basename: string,
+     *     extension: string,
+     *     mimetype: string,
+     *     filename: string,
+     *     location: string,
+     *     url: string
+     * }>|null
      *
      * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
      */
@@ -108,7 +126,25 @@ public function copyTo(string $path, string $disk = '', string $visibility = '')
     /**
      * Copy the FilePond files to destination and delete
      *
-     * @return array
+     * @return array{
+     *     id: int,
+     *     dirname: string,
+     *     basename: string,
+     *     extension: string,
+     *     mimetype: string,
+     *     filename: string,
+     *     location: string,
+     *     url: string
+     * }|array<int, array{
+     *     id: int,
+     *     dirname: string,
+     *     basename: string,
+     *     extension: string,
+     *     mimetype: string,
+     *     filename: string,
+     *     location: string,
+     *     url: string
+     * }>|null
      *
      * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
      */
@@ -145,7 +181,7 @@ public function moveTo(string $path, string $disk = '', string $visibility = '')
     public function delete()
     {
         if (! $this->getFieldValue()) {
-            return null;
+            return;
         }
 
         if ($this->getIsMultipleUpload()) {
@@ -174,7 +210,16 @@ public function delete()
     /**
      * Put the file in permanent storage and return response
      *
-     * @return array
+     * @return array{
+     *     id: int,
+     *     dirname: string,
+     *     basename: string,
+     *     extension: string,
+     *     mimetype: string,
+     *     filename: string,
+     *     location: string,
+     *     url: string
+     * }
      *
      * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
      */
@@ -187,7 +232,7 @@ private function putFile(FilepondModel $filepond, string $path, string $disk, st
         Storage::disk($permanentDisk)->writeStream(
             $pathInfo['dirname'].DIRECTORY_SEPARATOR.$pathInfo['filename'].'.'.$filepond->extension,
             Storage::disk($this->getTempDisk())->readStream($filepond->filepath),
-            $visibility !== '' ? ['visibility' => $visibility] : [],
+            $visibility !== '' ? ['visibility' => $visibility] : []
         );
 
         return [