docs: add doc comments

Author: kenjis

system/Config/Factories.php

@@ -65,6 +65,8 @@ class Factories
      * A multi-dimensional array with components as
      * keys to the array of name-indexed instances.
      *
+     * [component => [FQCN => instance]]
+     *
      * @var array<string, array<string, object>>
      * @phpstan-var  array<string, array<class-string, object>>
      */
@@ -118,6 +120,8 @@ public static function __callStatic(string $component, array $arguments)
 
     /**
      * Is the component Config?
+     *
+     * @param string $component Lowercase, plural component name
      */
     private static function isConfig(string $component): bool
     {
@@ -231,6 +235,8 @@ protected static function verifyInstanceOf(array $options, string $name): bool
      * @param string $component Lowercase, plural component name
      *
      * @return array<string, bool|string|null>
+     *
+     * @internal For testing only
      */
     public static function getOptions(string $component): array
     {
@@ -247,13 +253,16 @@ public static function getOptions(string $component): array
             // Load values from the best Factory configuration (will include Registrars)
             : config(Factory::class)->{$component} ?? [];
 
+        // The setOptions() reset the component. So getOptions() may reset
+        // the component.
         return self::setOptions($component, $values);
     }
 
     /**
      * Normalizes, stores, and returns the configuration for a specific component
      *
      * @param string $component Lowercase, plural component name
+     * @param array  $values    option values
      *
      * @return array<string, bool|string|null> The result after applying defaults and normalization
      */
@@ -305,6 +314,8 @@ public static function reset(?string $component = null)
      *
      * @param string $component Lowercase, plural component name
      * @param string $name      The name of the instance
+     *
+     * @internal For testing only
      */
     public static function injectMock(string $component, string $name, object $instance)
     {
@@ -321,6 +332,8 @@ public static function injectMock(string $component, string $name, object $insta
 
     /**
      * Gets a basename from a class name, namespaced or not.
+     *
+     * @internal For testing only
      */
     public static function getBasename(string $name): string
     {