docs(src): add ARFA 1.3 @author/@since/@Package docblocks to all 15 source files

Author: walmir-silva

src/Attribute/Serialize.php

@@ -7,7 +7,12 @@
 /**
  * Marks a property for serialization control.
  *
- * Parameters: name (wire-name override), groups (string[]), format-specific options.
+ * Parameters: name (wire-name override), groups (string[]), ignore (bool).
+ * Properties without this attribute are included automatically using their property name.
+ *
+ * @package KaririCode\Serializer\Attribute
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
  */
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 final readonly class Serialize

src/Configuration/SerializerConfiguration.php

@@ -4,6 +4,13 @@
 
 namespace KaririCode\Serializer\Configuration;
 
+/**
+ * Immutable configuration value object for the serializer engine.
+ *
+ * @package KaririCode\Serializer\Configuration
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 final readonly class SerializerConfiguration
 {
     public function __construct(

src/Contract/EncoderRegistry.php

@@ -4,6 +4,13 @@
 
 namespace KaririCode\Serializer\Contract;
 
+/**
+ * Contract for format-encoder registries.
+ *
+ * @package KaririCode\Serializer\Contract
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 interface EncoderRegistry
 {
     public function register(Encoder $encoder): void;

src/Core/InMemoryEncoderRegistry.php

@@ -8,6 +8,15 @@
 use KaririCode\Serializer\Contract\EncoderRegistry;
 use KaririCode\Serializer\Exception\SerializationException;
 
+/**
+ * In-memory encoder registry backed by a plain PHP array.
+ *
+ * Throws SerializationException on duplicate registration or unknown format lookup.
+ *
+ * @package KaririCode\Serializer\Core
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 final class InMemoryEncoderRegistry implements EncoderRegistry
 {
     /** @var array<string, Encoder> */

src/Core/SerializationContextImpl.php

@@ -6,6 +6,16 @@
 
 use KaririCode\Serializer\Contract\SerializationContext;
 
+/**
+ * Immutable serialization context carrying the active format and parameters.
+ *
+ * Uses the named-constructor pattern: instantiate via `SerializationContextImpl::create()`.
+ * `withFormat()` and `withParameters()` return new instances (full immutability).
+ *
+ * @package KaririCode\Serializer\Core
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 final readonly class SerializationContextImpl implements SerializationContext
 {
     /**

src/Encoder/JsonEncoder.php

@@ -8,6 +8,16 @@
 use KaririCode\Serializer\Contract\SerializationContext;
 use KaririCode\Serializer\Exception\SerializationException;
 
+/**
+ * Encodes/decodes data as RFC 8259-compliant JSON.
+ *
+ * Uses JSON_THROW_ON_ERROR for deterministic error handling.
+ * Supports `pretty` context parameter for human-readable output.
+ *
+ * @package KaririCode\Serializer\Encoder
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 final readonly class JsonEncoder implements Encoder
 {
     /** @param array<mixed> $data */

src/Encoder/QueryStringEncoder.php

@@ -7,7 +7,13 @@
 use KaririCode\Serializer\Contract\Encoder;
 use KaririCode\Serializer\Contract\SerializationContext;
 
-/** Encodes/decodes URL query strings (application/x-www-form-urlencoded). */
+/**
+ * Encodes/decodes data as RFC 3986-compliant URL query strings (application/x-www-form-urlencoded).
+ *
+ * @package KaririCode\Serializer\Encoder
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 final readonly class QueryStringEncoder implements Encoder
 {
     /** @param array<mixed> $data */

src/Encoder/XmlEncoder.php

@@ -8,6 +8,16 @@
 use KaririCode\Serializer\Contract\SerializationContext;
 use KaririCode\Serializer\Exception\SerializationException;
 
+/**
+ * Encodes/decodes arrays as application/xml via SimpleXMLElement + DOMDocument.
+ *
+ * Uses `libxml_use_internal_errors` to suppress PHP notices on malformed XML decode.
+ * Supports `root` and `pretty` context parameters.
+ *
+ * @package KaririCode\Serializer\Encoder
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 final readonly class XmlEncoder implements Encoder
 {
     /** @param array<mixed> $data */

src/Event/SerializationCompletedEvent.php

@@ -6,6 +6,13 @@
 
 use KaririCode\Serializer\Result\SerializationResult;
 
+/**
+ * Event emitted when a serialization operation completes successfully.
+ *
+ * @package KaririCode\Serializer\Event
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 final readonly class SerializationCompletedEvent
 {
     public function __construct(public SerializationResult $result, public float $durationMs, public float $timestamp = 0)

src/Event/SerializationStartedEvent.php

@@ -4,6 +4,13 @@
 
 namespace KaririCode\Serializer\Event;
 
+/**
+ * Event emitted when a serialization operation begins.
+ *
+ * @package KaririCode\Serializer\Event
+ * @author  Walmir Silva <walmir.silva@kariricode.org>
+ * @since   3.1.0 ARFA 1.3
+ */
 final readonly class SerializationStartedEvent
 {
     public function __construct(public string $format, public float $timestamp = 0)