Add file-pond-clear event listener

Author: rawilk

docs/components/filepond.md

@@ -145,3 +145,17 @@ the `file-pond` component adds a watcher on your `wire:model` by using `@entangl
 will pick up on those changes and remove the removed files from the FilePond instance.
 
 You can opt out of this behavior by setting the boolean attribute `watch-value` to `false` on the component.
+
+## Clear Event Listener
+
+You may encounter some edge cases where you may need to clear the files out of the FilePond instance
+yourself. When using livewire, this can easily be accomplished by adding the following inside your
+component somewhere:
+
+```php
+$this->dispatchBrowserEvent('file-pond-clear', ['id' => $this->id]);
+```
+
+Each Livewire component has its own unique id assigned to it, so by passing `$this->id` into the
+event you're emitting, the component will be able to match the ids and clear the files for the correct
+component.

resources/views/components/files/file-pond.blade.php

@@ -1,6 +1,18 @@
 <div wire:ignore
      x-data="{ pond: null, @if ($shouldWatch($attributes)) value: @entangle($attributes->wire('model')), oldValue: undefined @endif }"
      x-cloak
+     x-on:file-pond-clear.window="
+         const id = $wire && $wire.__instance.id;
+         const sentId = $event.detail.id;
+         if (id && (sentId !== id)) {
+            return;
+         }
+         @if ($multiple)
+            pond.getFiles().forEach(file => pond.removeFile(file.id));
+         @else
+            pond.removeFile();
+         @endif
+     "
      x-init="
         {{ $plugins ?? '' }}
 
@@ -32,7 +44,7 @@
 
                     this.oldValue = value;
                 @else
-                    ! value && pond.removeFile()
+                    ! value && pond.removeFile();
                 @endif
             });
         @endif