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

Chore: PHPUnit test & docs & PHPDoc for vendor mode

src/SPC/store/pkg/CustomPackage.php

@@ -4,12 +4,36 @@ declare(strict_types=1);
 
 namespace SPC\store\pkg;
 
+/**
+ * Abstract base class for custom package implementations
+ *
+ * This class provides a framework for implementing custom package download
+ * and extraction logic. Extend this class to create custom package handlers.
+ */
 abstract class CustomPackage
 {
+    /**
+     * Get the list of package names supported by this implementation
+     *
+     * @return array Array of supported package names
+     */
     abstract public function getSupportName(): array;
 
+    /**
+     * Fetch the package from its source
+     *
+     * @param string     $name   Package name
+     * @param bool       $force  Force download even if already exists
+     * @param null|array $config Optional configuration array
+     */
     abstract public function fetch(string $name, bool $force = false, ?array $config = null): void;
 
+    /**
+     * Extract the downloaded package
+     *
+     * @param  string            $name Package name
+     * @throws \RuntimeException If extraction is not implemented
+     */
     public function extract(string $name): void
     {
         throw new \RuntimeException("Extract method not implemented for package: {$name}");