refactor: Use phpstan type aliases to reference operations from handlers

Now that there are explicit operation classes for each standard
operation, it feels appropriate to define the expected schema for
unserialized operations alongside the DTO and import it to the handler.
This more clearly shows the relationship between these objects.

Author: acoulton

src/operations/Add.php

@@ -2,6 +2,13 @@
 
 namespace blancks\JsonPatch\operations;
 
+/**
+ * @phpstan-type TAddOperationObject object{
+ *     op:string,
+ *     path: string,
+ *     value: mixed,
+ * }
+ */
 final class Add extends PatchOperation
 {
     public function __construct(

src/operations/Copy.php

@@ -2,6 +2,13 @@
 
 namespace blancks\JsonPatch\operations;
 
+/**
+ * @phpstan-type TCopyOperationObject object{
+ *     op:string,
+ *     path: string,
+ *     from: string,
+ * }
+ */
 final class Copy extends PatchOperation
 {
     public function __construct(

src/operations/Move.php

@@ -2,6 +2,13 @@
 
 namespace blancks\JsonPatch\operations;
 
+/**
+ * @phpstan-type TMoveOperationObject object{
+ *     op:string,
+ *     path: string,
+ *     from: string,
+ * }
+ */
 final class Move extends PatchOperation
 {
     public function __construct(

src/operations/Remove.php

@@ -2,6 +2,12 @@
 
 namespace blancks\JsonPatch\operations;
 
+/**
+ * @phpstan-type TRemoveOperationObject object{
+ *     op:string,
+ *     path: string,
+ * }
+ */
 final class Remove extends PatchOperation
 {
     public function __construct(

src/operations/Replace.php

@@ -2,6 +2,13 @@
 
 namespace blancks\JsonPatch\operations;
 
+/**
+ * @phpstan-type TReplaceOperationObject object{
+ *     op:string,
+ *     path: string,
+ *     value: mixed,
+ * }
+ */
 final class Replace extends PatchOperation
 {
     public function __construct(

src/operations/Test.php

@@ -2,6 +2,13 @@
 
 namespace blancks\JsonPatch\operations;
 
+/**
+ * @phpstan-type TTestOperationObject object{
+ *     op:string,
+ *     path: string,
+ *     value: mixed,
+ * }
+ */
 final class Test extends PatchOperation
 {
     public function __construct(

src/operations/handlers/AddHandler.php

@@ -3,20 +3,18 @@
 namespace blancks\JsonPatch\operations\handlers;
 
 use blancks\JsonPatch\json\accessors\UndefinedValue;
+use blancks\JsonPatch\operations\Add;
 
 /**
  * @internal
+ * @phpstan-import-type TAddOperationObject from Add
  */
 final class AddHandler extends PatchOperationHandler
 {
     private mixed $previous;
 
     /**
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     value: mixed,
-     * } $patch
+     * @param object&TAddOperationObject $patch
      * @return void
      */
     public function validate(object $patch): void
@@ -28,11 +26,7 @@ public function validate(object $patch): void
 
     /**
      * @param mixed $document
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     value: mixed,
-     * } $patch
+     * @param object&TAddOperationObject $patch
      * @return void
      */
     public function apply(mixed &$document, object $patch): void
@@ -41,11 +35,7 @@ public function apply(mixed &$document, object $patch): void
     }
 
     /**
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     value: mixed,
-     * } $patch
+     * @param object&TAddOperationObject $patch
      * @return null|array{
      *     op:string,
      *     path: string,

src/operations/handlers/CopyHandler.php

@@ -3,20 +3,18 @@
 namespace blancks\JsonPatch\operations\handlers;
 
 use blancks\JsonPatch\json\accessors\UndefinedValue;
+use blancks\JsonPatch\operations\Copy;
 
 /**
  * @internal
+ * @phpstan-import-type TCopyOperationObject from Copy
  */
 final class CopyHandler extends PatchOperationHandler
 {
     private mixed $previous;
 
     /**
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     from: string,
-     * } $patch
+     * @param object&TCopyOperationObject $patch
      * @return void
      */
     public function validate(object $patch): void
@@ -28,11 +26,7 @@ public function validate(object $patch): void
 
     /**
      * @param mixed $document
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     from: string,
-     * } $patch
+     * @param object&TCopyOperationObject $patch
      * @return void
      */
     public function apply(mixed &$document, object $patch): void
@@ -42,11 +36,7 @@ public function apply(mixed &$document, object $patch): void
     }
 
     /**
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     from: string,
-     * } $patch
+     * @param object&TCopyOperationObject $patch
      * @return null|array{
      *     op:string,
      *     path: string,

src/operations/handlers/MoveHandler.php

@@ -2,17 +2,16 @@
 
 namespace blancks\JsonPatch\operations\handlers;
 
+use blancks\JsonPatch\operations\Move;
+
 /**
  * @internal
+ * @phpstan-import-type TMoveOperationObject from Move
  */
 final class MoveHandler extends PatchOperationHandler
 {
     /**
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     from: string,
-     * } $patch
+     * @param object&TMoveOperationObject $patch
      * @return void
      */
     public function validate(object $patch): void
@@ -24,11 +23,7 @@ public function validate(object $patch): void
 
     /**
      * @param mixed $document
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     from: string,
-     * } $patch
+     * @param object&TMoveOperationObject $patch
      * @return void
      */
     public function apply(mixed &$document, object $patch): void
@@ -38,11 +33,7 @@ public function apply(mixed &$document, object $patch): void
     }
 
     /**
-     * @param object{
-     *     op:string,
-     *     path: string,
-     *     from: string,
-     * } $patch
+     * @param object&TMoveOperationObject $patch
      * @return null|array{
      *     op:string,
      *     path: string,

src/operations/handlers/RemoveHandler.php

@@ -2,18 +2,18 @@
 
 namespace blancks\JsonPatch\operations\handlers;
 
+use blancks\JsonPatch\operations\Remove;
+
 /**
  * @internal
+ * @phpstan-import-type TRemoveOperationObject from Remove
  */
 final class RemoveHandler extends PatchOperationHandler
 {
     private mixed $previous;
 
     /**
-     * @param object{
-     *     op:string,
-     *     path: string,
-     * } $patch
+     * @param object&TRemoveOperationObject $patch
      * @return void
      */
     public function validate(object $patch): void
@@ -24,10 +24,7 @@ public function validate(object $patch): void
 
     /**
      * @param mixed $document
-     * @param object{
-     *     op:string,
-     *     path: string,
-     * } $patch
+     * @param object&TRemoveOperationObject $patch
      * @return void
      */
     public function apply(mixed &$document, object $patch): void
@@ -36,10 +33,7 @@ public function apply(mixed &$document, object $patch): void
     }
 
     /**
-     * @param object{
-     *     op:string,
-     *     path: string,
-     * } $patch
+     * @param object&TRemoveOperationObject $patch
      * @return null|array{
      *     op:string,
      *     path: string,