Fix stan issues

Author: jaapio

packages/guides-restructured-text/src/RestructuredText/Directives/Attributes/Option.php

@@ -22,7 +22,7 @@ final class Option
     public function __construct(
         public readonly string $name,
         public readonly OptionType $type = OptionType::String,
-        public readonly mixed $default = null,
+        public readonly bool|string|int|float|null $default = null,
         public readonly string $description = '',
         public readonly string|null $example = null,
     ) {

packages/guides-restructured-text/src/RestructuredText/Directives/BaseDirective.php

@@ -184,7 +184,7 @@ final protected function readOption(Directive $directive, string $optionName): m
         return $this->getOptionValue($directive, $optionAttribute);
     }
 
-    /** @return array<string, bool|float|int|string|null> */
+    /** @return array<string, scalar|scalar[]|null> */
     final protected function readAllOptions(Directive $directive): array
     {
         $this->initialize();
@@ -195,7 +195,8 @@ final protected function readAllOptions(Directive $directive): array
         );
     }
 
-    private function getOptionValue(Directive $directive, Option|null $option): mixed
+    /** @return scalar|scalar[]|null */
+    private function getOptionValue(Directive $directive, Option|null $option): bool|float|int|string|array|null
     {
         if ($option === null) {
             return null;

packages/guides-restructured-text/src/RestructuredText/Directives/GeneralDirective.php

@@ -31,7 +31,7 @@
  */
 final class GeneralDirective extends SubDirective
 {
-    /** @param Rule<Node> $startingRule */
+    /** @param Rule<CollectionNode> $startingRule */
     public function __construct(
         Rule $startingRule,
         private readonly SettingsManager $settingsManager,

packages/guides-restructured-text/src/RestructuredText/Parser/Productions/DirectiveContentRule.php

@@ -18,7 +18,7 @@
 use phpDocumentor\Guides\Nodes\Node;
 use phpDocumentor\Guides\RestructuredText\Parser\BlockContext;
 
-/** @implements Rule<Node> */
+/** @implements Rule<CollectionNode> */
 final class DirectiveContentRule implements Rule
 {
     public function __construct(private readonly RuleContainer $bodyElements)

packages/guides/src/Nodes/AbstractNode.php

@@ -26,13 +26,13 @@ abstract class AbstractNode implements Node
     /** @var string[] */
     protected array $classes = [];
 
-    /** @var array<string, scalar|null> */
+    /** @var array<string, scalar|scalar[]|null> */
     protected array $options = [];
 
     /** @var TValue */
     protected $value;
 
-    /** @return array<string, scalar|null> */
+    /** @return array<string, scalar|scalar[]|null> */
     public function getOptions(): array
     {
         return $this->options;
@@ -89,7 +89,7 @@ public function getClassesString(): string
     }
 
     /**
-     * @param array<string, scalar|null> $options
+     * @param array<string, scalar|scalar[]|null> $options
      *
      * @return static
      */

packages/guides/src/Nodes/Node.php

@@ -15,10 +15,10 @@
 
 interface Node
 {
-    /** @return array<string, scalar|null> */
+    /** @return array<string, scalar|scalar[]|null> */
     public function getOptions(): array;
 
-    /** @param array<string, scalar|null> $options */
+    /** @param array<string, scalar|scalar[]|null> $options */
     public function withOptions(array $options): Node;
 
     /** @param array<string, scalar|null> $options */