Add block events to allow hooking of data

src/Components/DropBlockEditor.php

@@ -2,8 +2,14 @@
 
 namespace Jeffreyvr\DropBlockEditor\Components;
 
+use Illuminate\Contracts\Events\Dispatcher;
 use Illuminate\Support\Str;
 use Jeffreyvr\DropBlockEditor\Blocks\Block;
+use Jeffreyvr\DropBlockEditor\Events\BlockClone;
+use Jeffreyvr\DropBlockEditor\Events\BlockCloned;
+use Jeffreyvr\DropBlockEditor\Events\BlockDeleted;
+use Jeffreyvr\DropBlockEditor\Events\BlockInsert;
+use Jeffreyvr\DropBlockEditor\Events\BlockInserted;
 use Jeffreyvr\DropBlockEditor\Parsers\Parse;
 use Livewire\Component;
 
@@ -39,6 +45,8 @@ class DropBlockEditor extends Component
         'refreshComponent' => '$refresh',
     ];
 
+    protected ?Dispatcher $events = null;
+
     public function canUndo(): bool
     {
         return $this->historyIndex > 0;
@@ -124,10 +132,20 @@ public function cloneBlock(): void
     {
         $clone = $this->activeBlocks[$this->activeBlockIndex];
 
+        if ($this->events) {
+            $event = new BlockClone($clone);
+            $this->events->dispatch($event);
+            $clone = $event->getBlock();
+        }
+
         $this->activeBlocks[] = $clone;
 
         $this->activeBlockIndex = array_key_last($this->activeBlocks);
 
+        if ($this->events) {
+            $this->events->dispatch(new BlockCloned($this->activeBlocks[$this->activeBlockIndex]));
+        }
+
         $this->recordInHistory();
     }
 
@@ -137,8 +155,14 @@ public function deleteBlock(): void
 
         $this->activeBlockIndex = false;
 
+        $deleted = $this->activeBlocks[$activeBlockId];
+
         unset($this->activeBlocks[$activeBlockId]);
 
+        if ($this->events) {
+            $this->events->dispatch(new BlockDeleted($deleted));
+        }
+
         $this->recordInHistory();
     }
 
@@ -157,6 +181,11 @@ public function getActiveBlock(): bool|Block
             ->data($this->activeBlocks[$this->activeBlockIndex]['data']);
     }
 
+    public function boot(?Dispatcher $events = null): void
+    {
+        $this->events = $events;
+    }
+
     public function mount(): void
     {
         $this->parsers = config('dropblockeditor.parsers', []);
@@ -185,11 +214,21 @@ public function reorder($ids): void
 
     public function insertBlock($id, $index = null, $placement = null): void
     {
-        if ($index === null) {
-            $block = $this->blocks[$id];
+        $block = $this->blocks[$id];
+
+        if ($this->events) {
+            $event = new BlockInsert($block);
+            $this->events->dispatch($event);
+            $block = $event->getBlock();
+        }
 
+        if ($index === null) {
             $this->activeBlocks[] = $block;
 
+            if ($this->events) {
+                $this->events->dispatch(new BlockInserted($block));
+            }
+
             return;
         }
 
@@ -199,7 +238,11 @@ public function insertBlock($id, $index = null, $placement = null): void
             $newIndex = $index + 1;
         }
 
-        $this->activeBlocks = array_merge(array_slice($this->activeBlocks, 0, $newIndex), [$this->blocks[$id]], array_slice($this->activeBlocks, $newIndex));
+        $this->activeBlocks = array_merge(array_slice($this->activeBlocks, 0, $newIndex), [$block], array_slice($this->activeBlocks, $newIndex));
+
+        if ($this->events) {
+            $this->events->dispatch(new BlockInserted($block));
+        }
 
         $this->recordInHistory();
     }

src/Events/BlockClone.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Jeffreyvr\DropBlockEditor\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+
+class BlockClone
+{
+    use Dispatchable;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct(protected array $block = [])
+    {
+        //
+    }
+
+    public function setBlock(array $block): void
+    {
+        $this->block = $block;
+    }
+
+    public function getBlock(): array
+    {
+        return $this->block;
+    }
+}

src/Events/BlockCloned.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Jeffreyvr\DropBlockEditor\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+
+class BlockCloned
+{
+    use Dispatchable;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct(protected array $block = [])
+    {
+        //
+    }
+
+    public function getBlock(): array
+    {
+        return $this->block;
+    }
+}

src/Events/BlockDeleted.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Jeffreyvr\DropBlockEditor\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+
+class BlockDeleted
+{
+    use Dispatchable;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct(protected array $block = [])
+    {
+        //
+    }
+
+    public function getBlock(): array
+    {
+        return $this->block;
+    }
+}

src/Events/BlockInsert.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Jeffreyvr\DropBlockEditor\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+
+class BlockInsert
+{
+    use Dispatchable;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct(protected array $block = [])
+    {
+        //
+    }
+
+    public function setBlock(array $block): void
+    {
+        $this->block = $block;
+    }
+
+    public function getBlock(): array
+    {
+        return $this->block;
+    }
+}

src/Events/BlockInserted.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Jeffreyvr\DropBlockEditor\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+
+class BlockInserted
+{
+    use Dispatchable;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct(protected array $block = [])
+    {
+        //
+    }
+
+    public function getBlock(): array
+    {
+        return $this->block;
+    }
+}