fix

Author: tymondesigns

src/Types/ArraySchema.php

@@ -109,7 +109,7 @@ public function toArray(bool $includeSchemaRef = true, bool $includeTitle = true
     /**
      * Get array-specific features used by this schema.
      *
-     * @return SchemaFeature[]
+     * @return array<\Cortex\JsonSchema\Enums\SchemaFeature>
      */
     protected function getArrayFeatures(): array
     {
@@ -129,7 +129,7 @@ protected function getArrayFeatures(): array
     /**
      * Override to include array-specific features.
      *
-     * @return SchemaFeature[]
+     * @return array<\Cortex\JsonSchema\Enums\SchemaFeature>
      */
     #[Override]
     protected function getUsedFeatures(): array

src/Types/Concerns/HasDefinitions.php

@@ -61,7 +61,10 @@ protected function addDefinitionsToSchema(array $schema): array
             $schema[$keyword] = [];
 
             foreach ($this->definitions as $name => $definition) {
-                $schema[$keyword][$name] = $definition->toArray(includeSchemaRef: false);
+                /** @var array<string, mixed> $definitions */
+                $definitions = $schema[$keyword];
+                $definitions[$name] = $definition->toArray(includeSchemaRef: false);
+                $schema[$keyword] = $definitions;
             }
         }
 
@@ -71,7 +74,7 @@ protected function addDefinitionsToSchema(array $schema): array
     /**
      * Get definition features used by this schema.
      *
-     * @return SchemaFeature[]
+     * @return array<\Cortex\JsonSchema\Enums\SchemaFeature>
      */
     protected function getDefinitionFeatures(): array
     {

src/Types/Concerns/HasFormat.php

@@ -65,7 +65,7 @@ protected function validateFormatSupport(SchemaFormat $schemaFormat): void
     /**
      * Get format features used by this schema.
      *
-     * @return SchemaFeature[]
+     * @return array<\Cortex\JsonSchema\Enums\SchemaFeature>
      */
     protected function getFormatFeatures(): array
     {

src/Types/Concerns/HasMetadata.php

@@ -100,7 +100,7 @@ protected function addMetadataToSchema(array $schema): array
     /**
      * Get metadata features used by this schema.
      *
-     * @return SchemaFeature[]
+     * @return array<\Cortex\JsonSchema\Enums\SchemaFeature>
      */
     protected function getMetadataFeatures(): array
     {

src/Types/Concerns/HasReadWrite.php

@@ -56,7 +56,7 @@ protected function addReadWriteToSchema(array $schema): array
     /**
      * Get read/write features used by this schema.
      *
-     * @return SchemaFeature[]
+     * @return array<\Cortex\JsonSchema\Enums\SchemaFeature>
      */
     protected function getReadWriteFeatures(): array
     {

src/Types/Concerns/ValidatesVersionFeatures.php

@@ -14,7 +14,7 @@ trait ValidatesVersionFeatures
     /**
      * Validate that a feature is supported by the current schema version.
      *
-     * @throws SchemaException
+     * @throws \Cortex\JsonSchema\Exceptions\SchemaException
      */
     protected function validateFeatureSupport(SchemaFeature $schemaFeature): void
     {
@@ -33,9 +33,9 @@ protected function validateFeatureSupport(SchemaFeature $schemaFeature): void
     /**
      * Validate that multiple features are supported by the current schema version.
      *
-     * @param SchemaFeature[] $features
+     * @param array<\Cortex\JsonSchema\Enums\SchemaFeature> $features
      *
-     * @throws SchemaException
+     * @throws \Cortex\JsonSchema\Exceptions\SchemaException
      */
     protected function validateFeaturesSupport(array $features): void
     {
@@ -89,7 +89,7 @@ protected function addFeatureIfSupported(
      * Get features that should be validated when building the schema output.
      * Override in specific schema types to define which features they use.
      *
-     * @return SchemaFeature[]
+     * @return array<\Cortex\JsonSchema\Enums\SchemaFeature>
      */
     protected function getUsedFeatures(): array
     {
@@ -99,7 +99,7 @@ protected function getUsedFeatures(): array
     /**
      * Validate all features used by this schema type.
      *
-     * @throws SchemaException
+     * @throws \Cortex\JsonSchema\Exceptions\SchemaException
      */
     protected function validateAllUsedFeatures(): void
     {