README

🧱 Skywalker Toolkit

The Universal Architectural Foundation for Elite Laravel Engineering

Skywalker Toolkit is not just a utility package; it is the Universal Base Package for all Skywalker products. Designed for extreme backwards and forwards compatibility, it enforces strict Consistency, Speed, and Security across a vast array of PHP and Laravel environments ranging from legacy monolithic apps to modern microservices.

🌐 Broad System Compatibility

The Toolkit is engineered to be a drop-in foundation that just works. No strict type conflicts, no version lock-ins.

• PHP Support: ^7.0 | ^8.0 | ^9.0
• Laravel Support: ^6.20.45 | ^7.x | ^8.x | ^9.x | ^10.x | ^11.x | ^12.x

🏗️ The Core Pillars

1. Robust Foundation Classes

Design complex systems with a consistent base. Use Action, Dto, and Service to enforce clean boundaries.

use Skywalker\Support\Foundation\Service;

class UserRegistrationService extends Service {
    public function register(array $data): array {
        return $this->transaction(function() use ($data) {
             // Registration logic...
             return ['status' => 'success'];
        });
    }
}

2. Prefixed Architecture (PrefixedModel)

Prevent database collision in multi-package environments. The PrefixedModel allows you to isolate table names dynamically.

use Skywalker\Support\Database\PrefixedModel;

abstract class LocationModel extends PrefixedModel {
    protected $prefix = 'location_'; // Resulting table: location_locations
}

3. Advanced I/O & Profiling (Command)

Console commands designed for production. Integrated framing and structured output for professional DX.

use Skywalker\Support\Console\Command;

class SyncCommand extends Command {
    public function handle(): int {
        $this->frame("Starting Elite Sync Process");
        // Your logic here
        return 0;
    }
}

4. Zero-Friction Filesystem & Validation Helpers

Standardized access to core Laravel features with enhanced utility via global helpers and injectables.

// Global Helpers
$files = filesystem();
$validator = validator($data, $rules);

// Traits for any Class
use Skywalker\Support\Filesystem\Concerns\HasFilesystem;
use Skywalker\Support\Validation\Concerns\ValidatesAttributes;

class Processor {
    use HasFilesystem, ValidatesAttributes;

    public function process($data) {
        $this->validate($data, ['file' => 'required|string']);
        if ($this->filesystem()->exists($data['file'])) {
             // Logic...
        }
    }
}

5. Enterprise Security Foundation

The Aether Security Suite provides the bedrock for all Skywalker security packages. It includes a universal Zero-Trust engine and strictly typed validation protocols.

use Skywalker\Support\Security\ZeroTrust\TrustEngine;

$score = TrustEngine::calculateScore($user); // Returns a float security score

🛠️ Developmental Standards

Skywalker Toolkit is built with the highest engineering standards:

• Broad Typing: Purposely stripped of strict typing (declare(strict_types=1)) to ensure native compilation in PHP 7.0 environments.
• Static Analysis: Verified by PHPStan.
• Automated CI: GitHub Actions integration.
• Deep Testing: Powered by a modernized PHPUnit suite guaranteeing 100% operational success across architectures.

🩺 Integrated Package Map & HealthCheck

Monitor your entire vault of Skywalker packages with a single call.

use Skywalker\Support\Health;
use Skywalker\Support\ProjectMap;

$status = Health::check();
$packages = ProjectMap::discover();

📄 Documentation Suite

• Changelog - Stay updated with the latest releases.
• Contributing - Guidelines for elite contributions.
• Security - Reporting vulnerabilities correctly.
• License - MIT Open Source License.
• Maintainers - The team behind the foundation.
• Code of Conduct - Our community standards.

Created & Maintained by Skywalker-Labs. The foundation for excellence.