Add psalm template annotations for codec examples

We still exclude psalm from these examples to avoid littering the code with assertions and annotations

Author: alcaeus

docs/examples/codecs/handling-data-types/DateTimeCodec.php

@@ -7,6 +7,9 @@
 use MongoDB\Codec\EncodeIfSupported;
 use MongoDB\Exception\UnsupportedValueException;
 
+/**
+ * @template-implements Codec<Document, DateTimeImmutable>
+ */
 final class DateTimeCodec implements Codec
 {
     use DecodeIfSupported;

docs/examples/codecs/handling-data-types/PersonCodec.php

@@ -6,6 +6,9 @@
 use MongoDB\Codec\EncodeIfSupported;
 use MongoDB\Exception\UnsupportedValueException;
 
+/**
+ * @template-implements DocumentCodec<Person>
+ */
 final class PersonCodec implements DocumentCodec
 {
     use DecodeIfSupported;

docs/examples/codecs/handling-documents/PersonCodec.php

@@ -6,6 +6,9 @@
 use MongoDB\Codec\EncodeIfSupported;
 use MongoDB\Exception\UnsupportedValueException;
 
+/**
+ * @template-implements DocumentCodec<Person>
+ */
 final class PersonCodec implements DocumentCodec
 {
     // These traits define commonly used functionality to avoid duplication

docs/examples/codecs/handling-embedded-documents/AddressCodec.php

@@ -6,6 +6,9 @@
 use MongoDB\Codec\EncodeIfSupported;
 use MongoDB\Exception\UnsupportedValueException;
 
+/**
+ * @template-implements DocumentCodec<Address>
+ */
 final class AddressCodec implements DocumentCodec
 {
     use DecodeIfSupported;

docs/examples/codecs/handling-embedded-documents/PersonCodec.php

@@ -6,6 +6,9 @@
 use MongoDB\Codec\EncodeIfSupported;
 use MongoDB\Exception\UnsupportedValueException;
 
+/**
+ * @template-implements DocumentCodec<Person>
+ */
 final class PersonCodec implements DocumentCodec
 {
     use DecodeIfSupported;

psalm.xml.dist

@@ -11,7 +11,7 @@
 >
     <projectFiles>
         <directory name="src" />
-        <directory name="docs/examples" />
+        <directory name="docs/examples/encryption" />
         <directory name="examples" />
         <ignoreFiles>
             <directory name="vendor" />