chore: adds since tags

Author: JasonTheAdams

src/Common/AbstractEnum.php

@@ -29,6 +29,8 @@
  * $enum->equals('first'); // Returns true
  * $enum->is(PersonEnum::firstName()); // Returns true
  * PersonEnum::cases(); // Returns array of all enum instances
+ *
+ * @since n.e.x.t
  */
 abstract class AbstractEnum
 {
@@ -55,6 +57,7 @@ abstract class AbstractEnum
     /**
      * Constructor is private to ensure instances are created through static methods
      *
+     * @since n.e.x.t
      * @param string|int $value The enum value
      * @param string $name The constant name
      */
@@ -67,6 +70,7 @@ final private function __construct($value, string $name)
     /**
      * Magic getter to provide read-only access to properties
      *
+     * @since n.e.x.t
      * @param string $property The property name
      * @return mixed
      * @throws BadMethodCallException If property doesn't exist
@@ -85,6 +89,7 @@ final public function __get(string $property)
     /**
      * Magic setter to prevent property modification
      *
+     * @since n.e.x.t
      * @param string $property The property name
      * @param mixed $value The value to set
      * @throws BadMethodCallException Always, as enum properties are read-only
@@ -99,6 +104,7 @@ final public function __set(string $property, $value): void
     /**
      * Create an enum instance from a value, throws exception if invalid
      *
+     * @since n.e.x.t
      * @param string|int $value The enum value
      * @return static
      * @throws InvalidArgumentException If the value is not valid
@@ -117,6 +123,7 @@ final public static function from($value): self
     /**
      * Try to create an enum instance from a value, returns null if invalid
      *
+     * @since n.e.x.t
      * @param string|int $value The enum value
      * @return static|null
      */
@@ -134,6 +141,7 @@ final public static function tryFrom($value): ?self
     /**
      * Get all enum cases
      *
+     * @since n.e.x.t
      * @return static[]
      */
     final public static function cases(): array
@@ -149,6 +157,7 @@ final public static function cases(): array
     /**
      * Check if this enum has the same value as the given value
      *
+     * @since n.e.x.t
      * @param string|int|self $other The value or enum to compare
      * @return bool
      */
@@ -164,6 +173,7 @@ final public function equals($other): bool
     /**
      * Check if this enum is the same instance type and value as another enum
      *
+     * @since n.e.x.t
      * @param self $other The other enum to compare
      * @return bool
      */
@@ -175,6 +185,7 @@ final public function is(self $other): bool
     /**
      * Get all valid values for this enum
      *
+     * @since n.e.x.t
      * @return array<string, string|int>
      */
     final public static function getValues(): array
@@ -185,6 +196,7 @@ final public static function getValues(): array
     /**
      * Check if a value is valid for this enum
      *
+     * @since n.e.x.t
      * @param string|int $value The value to check
      * @return bool
      */
@@ -196,6 +208,7 @@ final public static function isValidValue($value): bool
     /**
      * Get or create a singleton instance for the given value and name
      *
+     * @since n.e.x.t
      * @param string|int $value The enum value
      * @param string $name The constant name
      * @return static
@@ -220,6 +233,7 @@ private static function getInstance($value, string $name): self
     /**
      * Get all constants for this enum class
      *
+     * @since n.e.x.t
      * @return array<string, string|int>
      * @throws \RuntimeException If invalid constant found
      */
@@ -270,6 +284,7 @@ final protected static function getConstants(): array
     /**
      * Handle dynamic method calls for enum checking
      *
+     * @since n.e.x.t
      * @param string $name The method name
      * @param array<mixed> $arguments The method arguments
      * @return bool
@@ -295,6 +310,7 @@ final public function __call(string $name, array $arguments): bool
     /**
      * Handle static method calls for enum creation
      *
+     * @since n.e.x.t
      * @param string $name The method name
      * @param array<mixed> $arguments The method arguments
      * @return static
@@ -317,6 +333,7 @@ final public static function __callStatic(string $name, array $arguments): self
     /**
      * Convert camelCase to CONSTANT_CASE
      *
+     * @since n.e.x.t
      * @param string $camelCase The camelCase string
      * @return string The CONSTANT_CASE version
      */
@@ -332,6 +349,7 @@ private static function camelCaseToConstant(string $camelCase): string
     /**
      * String representation of the enum
      *
+     * @since n.e.x.t
      * @return string
      */
     final public function __toString(): string

src/Messages/Enums/MessagePartTypeEnum.php

@@ -9,6 +9,7 @@
 /**
  * Enum for message part types
  *
+ * @since n.e.x.t
  * @method static self text() Create an instance for TEXT type
  * @method static self inlineFile() Create an instance for INLINE_FILE type
  * @method static self remoteFile() Create an instance for REMOTE_FILE type

src/Messages/Enums/MessageRoleEnum.php

@@ -9,6 +9,7 @@
 /**
  * Enum for message roles in AI conversations
  *
+ * @since n.e.x.t
  * @method static self user() Create an instance for USER role
  * @method static self model() Create an instance for MODEL role
  * @method static self system() Create an instance for SYSTEM role

src/Messages/Enums/ModalityEnum.php

@@ -9,6 +9,7 @@
 /**
  * Enum for input/output modalities
  *
+ * @since n.e.x.t
  * @method static self text() Create an instance for TEXT modality
  * @method static self document() Create an instance for DOCUMENT modality
  * @method static self image() Create an instance for IMAGE modality

src/Operations/Enums/OperationStateEnum.php

@@ -9,6 +9,7 @@
 /**
  * Enum for operation states
  *
+ * @since n.e.x.t
  * @method static self starting() Create an instance for STARTING state
  * @method static self processing() Create an instance for PROCESSING state
  * @method static self succeeded() Create an instance for SUCCEEDED state

src/Providers/Enums/ProviderTypeEnum.php

@@ -9,6 +9,7 @@
 /**
  * Enum for provider types
  *
+ * @since n.e.x.t
  * @method static self cloud() Create an instance for CLOUD type
  * @method static self server() Create an instance for SERVER type
  * @method static self client() Create an instance for CLIENT type

src/Providers/Enums/ToolTypeEnum.php

@@ -9,6 +9,7 @@
 /**
  * Enum for tool types
  *
+ * @since n.e.x.t
  * @method static self functionDeclarations() Create an instance for FUNCTION_DECLARATIONS type
  * @method static self webSearch() Create an instance for WEB_SEARCH type
  * @method bool isFunctionDeclarations() Check if the type is FUNCTION_DECLARATIONS

src/Providers/Models/Enums/CapabilityEnum.php

@@ -9,6 +9,8 @@
 /**
  * Enum for model capabilities
  *
+ * @since n.e.x.t
+ *
  * @method static self textGeneration() Create an instance for TEXT_GENERATION capability
  * @method static self imageGeneration() Create an instance for IMAGE_GENERATION capability
  * @method static self textToSpeechConversion() Create an instance for TEXT_TO_SPEECH_CONVERSION capability

src/Providers/Models/Enums/OptionEnum.php

@@ -9,6 +9,8 @@
 /**
  * Enum for model options
  *
+ * @since n.e.x.t
+ *
  * @method static self inputModalities() Create an instance for INPUT_MODALITIES option
  * @method static self outputModalities() Create an instance for OUTPUT_MODALITIES option
  * @method static self systemInstruction() Create an instance for SYSTEM_INSTRUCTION option

src/Results/Enums/FinishReasonEnum.php

@@ -9,6 +9,7 @@
 /**
  * Enum for finish reasons of AI generation
  *
+ * @since n.e.x.t
  * @method static self stop() Create an instance for STOP reason
  * @method static self length() Create an instance for LENGTH reason
  * @method static self contentFilter() Create an instance for CONTENT_FILTER reason