Optimization

Author: GIGABAIT93

README.md

@@ -9,14 +9,13 @@
 
 A powerful modular extension framework for Laravel 12+ that enables you to build scalable, maintainable applications with runtime discovery, activation control, and scaffolding utilities.
 
-## 🚀 Features
+## 🚀 Key Features
 
 - **Runtime Discovery**: Automatically discover and load extensions from configured directories
 - **Activation Management**: Enable/disable extensions with dependency checks and protection mechanisms
 - **Flexible Storage**: Choose between file-based or database activators for persistence
 - **Rich API**: Manage extensions through facade, HTTP API, and Artisan commands
 - **Async Operations**: Queue enable/disable/install operations with status monitoring
-- **Dependency Resolution**: Smart dependency management with conflict detection
 - **Code Generation**: Scaffold new extensions with customizable stubs
 - **Event System**: Comprehensive event dispatching for extension lifecycle
 - **Multi-type Support**: Support for different extension types (Modules, Themes, etc.)
@@ -37,13 +36,13 @@ composer require gigabait93/laravel-extensions
 Publish the configuration file:
 
 ```bash
-php artisan extensions:publish --tag=extensions-config
+php artisan vendor:publish --tag=extensions-config
 ```
 
 If using database activator, publish and run migrations:
 
 ```bash
-php artisan extensions:publish --tag=extensions-migrations
+php artisan vendor:publish --tag=extensions-migrations
 php artisan migrate
 ```
 
@@ -53,103 +52,25 @@ Discover existing extensions:
 php artisan extensions:discover
 ```
 
-## 🏗️ Extension Structure
-
-Extensions are organized in type-based directories:
-
-```
-extensions/
-├── Modules/
-│   ├── Blog/
-│   │   ├── extension.json
-│   │   ├── composer.json
-│   │   ├── helpers.php
-│   │   ├── Providers/
-│   │   │   └── BlogServiceProvider.php
-│   │   ├── Routes/
-│   │   │   ├── web.php
-│   │   │   └── api.php
-│   │   ├── Http/
-│   │   │   └── Controllers/
-│   │   ├── Models/
-│   │   ├── Database/
-│   │   │   ├── Migrations/
-│   │   │   └── Seeders/
-│   │   └── Resources/
-│   │       └── views/
-│   └── Shop/
-├── Themes/
-│   └── Admin/
-└── Plugins/
-    └── Analytics/
-```
-
-### Extension Manifest (extension.json)
-
-```json
-{
-  "id": "blog",
-  "name": "Blog",
-  "provider": "Modules\\Blog\\Providers\\BlogServiceProvider",
-  "type": "Modules",
-  "description": "Simple blog module",
-  "author": "John Doe",
-  "version": "1.0.0",
-  "compatible_with": "^12.0",
-  "requires_extensions": ["base"],
-  "meta": {
-    "category": "content"
-  }
-}
-```
-
-## 🎨 Usage
-
-### Basic Operations
+## 🎯 Quick Start
 
 ```php
 use Gigabait93\Extensions\Facades\Extensions;
 
 // Get all extensions
 $extensions = Extensions::all();
 
-// Get active extensions
-$active = Extensions::enabled();
-
-// Find specific extension
-$blog = Extensions::find('blog');
-
-// Get extension by ID
-$extension = Extensions::get('blog');
-
 // Enable extension
 Extensions::enable('blog');
 
-// Disable extension
+// Disable extension  
 Extensions::disable('blog');
 
-// Install extension dependencies
-Extensions::installDependencies('blog');
-
 // Install dependencies and enable
 Extensions::installAndEnable('blog');
 ```
 
-### Async Operations
-
-```php
-use Gigabait93\Extensions\Jobs\ExtensionEnableJob;
-use Gigabait93\Extensions\Jobs\ExtensionDisableJob;
-use Gigabait93\Extensions\Jobs\ExtensionInstallDepsJob;
-
-// Queue extension operations
-Extensions::enableAsync('blog');
-Extensions::disableAsync('shop');
-Extensions::installDepsAsync('analytics');
-Extensions::installAndEnableAsync('blog');
-```
-
-### Artisan Commands
+### Basic Commands
 
 ```bash
 # List all extensions
@@ -158,133 +79,22 @@ php artisan extensions:list
 # Enable extension
 php artisan extensions:enable blog
 
-# Disable extension
-php artisan extensions:disable blog
-
-# Install dependencies
-php artisan extensions:install-deps blog
-
 # Create new extension
 php artisan extensions:make Blog --type=module
-
-# Migrate extensions
-php artisan extensions:migrate
-
-# Publish extension assets
-php artisan extensions:publish blog
-
-# Reload extensions cache
-php artisan extensions:reload
 ```
 
-## 🎭 Events
-
-The package dispatches various events during extension lifecycle:
-
-```php
-use Gigabait93\Extensions\Events\{
-    ExtensionEnabledEvent,
-    ExtensionDisabledEvent,
-    ExtensionDiscoveredEvent,
-    ExtensionDeletedEvent,
-    ExtensionDepsInstalledEvent
-};
-
-// Listen to extension events
-Event::listen(ExtensionEnabledEvent::class, function ($event) {
-    logger()->info("Extension {$event->extension->name} was enabled");
-});
-
-Event::listen(ExtensionDisabledEvent::class, function ($event) {
-    logger()->info("Extension {$event->extension->name} was disabled");
-});
-```
-
-## ⚙️ Configuration
-
-Configure the package in `config/extensions.php`:
+## 📚 Documentation
 
-```php
-return [
-    // Extensions that cannot be disabled
-    'protected' => [
-        'Modules' => 'ExtensionsDebugger',
-    ],
-
-    // Loading order for active extensions
-    'load_order' => [
-        'Modules' => 'ExtensionsDebugger',
-    ],
-
-    // Mutually exclusive extension types
-    'switch_types' => [
-        'Themes',
-    ],
-
-    // Extension directories by type
-    'paths' => [
-        'Modules' => base_path('extensions/Modules'),
-        'Themes' => base_path('extensions/Themes'),
-    ],
-
-    // Stub configuration for scaffolding
-    'stubs' => [
-        'path' => null, // Use package stubs
-        'default' => [
-            'config', 'console', 'database', 'events',
-            'exceptions', 'facades', 'helpers', 'http',
-            'jobs', 'lang', 'listeners', 'models',
-            'notifications', 'policies', 'resources',
-            'routes', 'rules', 'services',
-        ],
-    ],
-
-    // Activator class for managing states
-    'activator' => \Gigabait93\Extensions\Activators\FileActivator::class,
-
-    // JSON file path for FileActivator
-    'json_file' => base_path('storage/extensions.json'),
-];
-```
+For detailed documentation, visit [https://gigabait93.github.io/laravel-extensions/](https://gigabait93.github.io/laravel-extensions/).
 
 ## 🧪 Testing
 
-Run the test suite:
-
 ```bash
 composer test
-```
-
-Run code style checks:
-
-```bash
-composer cs-check
-```
-
-Fix code style issues:
-
-```bash
 composer cs-fix
-```
-
-Run static analysis:
-
-```bash
 composer phpstan
 ```
 
-## 📚 Documentation
-
-For detailed documentation, visit [https://gigabait93.github.io/laravel-extensions/](https://gigabait93.github.io/laravel-extensions/).
-
-The documentation covers:
-- Installation and configuration
-- Extension development
-- Manifest format reference
-- Event system
-- API reference
-- Best practices
-
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

docs/scaffolding.md

@@ -17,16 +17,23 @@ Use the `ExtensionBuilder` to generate extensions programmatically:
 ```php
 use Gigabait93\Extensions\Scaffolding\ExtensionBuilder;
 
-$builder = ExtensionBuilder::make()
+// Get available extension types and stub groups
+$availableTypes = ExtensionBuilder::getAvailableTypes();
+$availableGroups = ExtensionBuilder::getAvailableStubGroups();
+
+// Build extension
+$builder = app(ExtensionBuilder::class);
+$result = $builder
     ->withType('Modules')
     ->withName('Blog')
     ->withBasePath(base_path('extensions'))
+    ->withGroups(['providers', 'config', 'routes'])
     ->build();
 
 // Check result
-if ($builder->isSuccess()) {
-    echo "Extension created successfully!";
-}
+echo "Extension created at: " . $result['path'];
+echo "Namespace: " . $result['namespace'];
+echo "Files created: " . count($result['files']);
 ```
 
 ### 🎨 Template Variables

src/Entities/Extension.php

@@ -7,6 +7,7 @@
 use Gigabait93\Extensions\Facades\Extensions as ExtensionsFacade;
 use Gigabait93\Extensions\Support\ManifestValue;
 use Gigabait93\Extensions\Support\OpResult;
+use Gigabait93\Extensions\Support\PathResolver;
 
 /**
  * Extension entity that exposes all manifest fields as real, typed, read-only properties.
@@ -398,11 +399,7 @@ public function hasProviderFile(): bool
             return false;
         }
 
-        // Convert namespace to path
-        $providerPath = str_replace(['\\', '/'], DIRECTORY_SEPARATOR, $this->provider) . '.php';
-        $fullPath = $this->path . DIRECTORY_SEPARATOR . $providerPath;
-
-        return file_exists($fullPath);
+        return PathResolver::hasProviderFile($this->path, $this->provider);
     }
 
     public function getSize(): int
@@ -437,27 +434,17 @@ public function getFormattedSize(): string
 
     public function hasReadme(): bool
     {
-        $readmeFiles = ['README.md', 'readme.md', 'README.txt', 'readme.txt'];
-        foreach ($readmeFiles as $file) {
-            if (file_exists($this->path . DIRECTORY_SEPARATOR . $file)) {
-                return true;
-            }
-        }
-
-        return false;
+        return PathResolver::findReadmePath($this->path) !== null;
     }
 
     public function getReadmeContent(): ?string
     {
-        $readmeFiles = ['README.md', 'readme.md', 'README.txt', 'readme.txt'];
-        foreach ($readmeFiles as $file) {
-            $path = $this->path . DIRECTORY_SEPARATOR . $file;
-            if (file_exists($path)) {
-                return file_get_contents($path) ?: null;
-            }
+        $readmePath = PathResolver::findReadmePath($this->path);
+        if ($readmePath === null) {
+            return null;
         }
 
-        return null;
+        return file_get_contents($readmePath) ?: null;
     }
 
     public function compareVersion(string $version): int

src/Scaffolding/ExtensionBuilder.php

@@ -234,4 +234,29 @@ private function registryCanonicalName(string $type): string
 
         return $type;
     }
+
+    /**
+     * Get all available extension types from the registry.
+     *
+     * @return string[]
+     */
+    public static function getAvailableTypes(): array
+    {
+        $registry = app(RegistryService::class);
+
+        return $registry->types();
+    }
+
+    /**
+     * Get all available stub groups from the default stubs path.
+     *
+     * @param string|null $stubsPath Optional custom stubs path
+     * @return string[]
+     */
+    public static function getAvailableStubGroups(?string $stubsPath = null): array
+    {
+        $path = $stubsPath ?? ScaffoldConfig::stubsPath();
+
+        return StubGroups::scan($path);
+    }
 }