feat: add wildcard theme resolution to build and clean commands

Author: dermatz

src/Console/Command/AbstractCommand.php

@@ -478,4 +478,54 @@ private function removeSecureEnvironmentValue(string $name): void
         unset($this->secureEnvStorage[$name]);
         $this->clearEnvironmentCache();
     }
+
+    /**
+     * Resolve wildcard theme codes (e.g., Vendor/* to all underlying vendor themes)
+     *
+     * @param string[] $themeCodes
+     * @param \OpenForgeProject\MageForge\Model\ThemeList $themeList
+     * @return string[]
+     */
+    protected function resolveWildcardThemes(array $themeCodes, \OpenForgeProject\MageForge\Model\ThemeList $themeList): array
+    {
+        $resolved = [];
+        $availableThemes = null;
+
+        foreach ($themeCodes as $code) {
+            if (\str_ends_with($code, '/*')) {
+                // Lazy-load themes only when needed
+                if ($availableThemes === null) {
+                    $availableThemes = array_map(
+                        fn($theme) => $theme->getCode(),
+                        $themeList->getAllThemes()
+                    );
+                }
+
+                $prefix = substr($code, 0, -1); // Keeps the trailing slash, e.g. "Vendor/"
+                
+                $matched = array_filter(
+                    $availableThemes,
+                    fn(string $availableCode) => \str_starts_with($availableCode, $prefix)
+                );
+
+                if (empty($matched)) {
+                    $this->io->warning(sprintf("No themes found for prefix '%s'", $prefix));
+                } else {
+                    $this->io->note(sprintf(
+                        "Resolved '%s' to %d theme(s): %s",
+                        $code,
+                        count($matched),
+                        implode(', ', $matched)
+                    ));
+                }
+
+                $resolved = array_merge($resolved, $matched);
+            } else {
+                $resolved[] = $code;
+            }
+        }
+
+        // Return a fresh list without duplicates
+        return array_values(array_unique($resolved));
+    }
 }

src/Console/Command/Theme/BuildCommand.php

@@ -66,6 +66,17 @@ protected function configure(): void
     protected function executeCommand(InputInterface $input, OutputInterface $output): int
     {
         $themeCodes = $input->getArgument('themeCodes');
+
+        // Allow wildcards using the AbstractCommand helper
+        if (!empty($themeCodes)) {
+            $themeCodes = $this->resolveWildcardThemes($themeCodes, $this->themeList);
+            
+            // If wildcards matched nothing and no other explicit themes remain
+            if (empty($themeCodes)) {
+                return Command::SUCCESS;
+            }
+        }
+
         $isVerbose = $this->isVerbose($output);
 
         if (empty($themeCodes)) {
@@ -337,12 +348,19 @@ private function processTheme(
     private function displayBuildSummary(SymfonyStyle $io, array $successList, float $duration): void
     {
         $io->newLine();
-        $io->success(sprintf('🚀 Build process completed in %.2f seconds with the following results:', $duration));
-        $io->writeln('Summary:');
-        $io->newLine();
-
-        if (empty($successList)) {
-            $io->warning('No themes were built successfully.');
+        
+        $successCount = count($successList);
+        
+        if ($successCount > 0) {
+            $io->success(sprintf(
+                '🚀 Successfully built %d theme(s). Build process completed in %.2f seconds.', 
+                $successCount, 
+                $duration
+            ));
+            $io->writeln('Summary:');
+            $io->newLine();
+        } else {
+            $io->warning(sprintf('Build process completed in %.2f seconds, but no themes were built successfully.', $duration));
             return;
         }
 

src/Console/Command/Theme/CleanCommand.php

@@ -105,6 +105,15 @@ private function resolveThemeCodes(InputInterface $input, OutputInterface $outpu
             return $this->getAllThemeCodes();
         }
 
+        if (!empty($themeCodes)) {
+            $themeCodes = $this->resolveWildcardThemes($themeCodes, $this->themeList);
+            
+            // If wildcards matched nothing and no other explicit themes remain
+            if (empty($themeCodes)) {
+                return null;
+            }
+        }
+
         if (empty($themeCodes)) {
             return $this->selectThemesInteractively($output);
         }