Merge pull request #835 from crazywhalecc/chore/test-and-validate

Chore: PHPUnit test & docs & PHPDoc for vendor mode

src/SPC/util/CustomExt.php

@@ -8,16 +8,30 @@ use SPC\builder\Extension;
 use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 
+/**
+ * Custom extension attribute and manager
+ *
+ * This class provides functionality to register and manage custom PHP extensions
+ * that can be used during the build process.
+ */
 #[\Attribute(\Attribute::IS_REPEATABLE | \Attribute::TARGET_CLASS)]
 class CustomExt
 {
     private static array $custom_ext_class = [];
 
+    /**
+     * Constructor for custom extension attribute
+     *
+     * @param string $ext_name The extension name
+     */
     public function __construct(protected string $ext_name) {}
 
     /**
      * Load all custom extension classes
      *
+     * This method scans the extension directory and registers all classes
+     * that have the CustomExt attribute.
+     *
      * @throws \ReflectionException
      * @throws FileSystemException
      */
@@ -32,6 +46,12 @@ class CustomExt
         }
     }
 
+    /**
+     * Get the class name for a custom extension
+     *
+     * @param  string $ext_name The extension name
+     * @return string The class name for the extension
+     */
     public static function getExtClass(string $ext_name): string
     {
         return self::$custom_ext_class[$ext_name] ?? Extension::class;