@artilingo/artiframe-cli 1.0.0

package/src/App.php

@@ -0,0 +1,266 @@
+<?php
+namespace ArtiFrame\Cli;
+
+use ArtiFrame\Cli\Services\Translator;
+
+class App
+{
+    private array $originalArgs;
+    private array $args;
+    private Translator $translator;
+
+    public function __construct(array $argv)
+    {
+        $this->originalArgs = $argv;
+        $this->args = $argv;
+        $this->initTranslator();
+    }
+
+    private function initTranslator(): void
+    {
+        $lang = $this->getOrAskLanguage();
+        $this->translator = new Translator($lang);
+    }
+
+    private function getOrAskLanguage(): string
+    {
+        $home = getenv('HOME') ?: getenv('USERPROFILE');
+        $configFile = $home ? $home . \DIRECTORY_SEPARATOR . '.artiframe_lang' : null;
+
+        $lang = null;
+        
+        // 1. Check argument --lang=
+        foreach ($this->originalArgs as $arg) {
+            if (strpos($arg, '--lang=') === 0) {
+                $lang = strtolower(substr($arg, 7, 2));
+                if ($configFile) file_put_contents($configFile, $lang);
+                return $lang;
+            }
+        }
+
+        // 2. Check config file
+        if ($configFile && file_exists($configFile)) {
+            $lang = trim(file_get_contents($configFile));
+            if (in_array($lang, ['tr', 'en', 'de', 'fr', 'es'])) {
+                return $lang;
+            }
+        }
+
+        // 3. Fallback check system env (optional, but asking is better)
+        
+        // 4. Ask user
+        echo PHP_EOL;
+        echo "\033[1;32mWelcome to ArtiFrame! / ArtiFrame'e Hoş Geldiniz!\033[0m" . PHP_EOL;
+        echo "Please select your preferred language / Lütfen dilinizi seçin:" . PHP_EOL;
+        echo "  [1] 🇹🇷 Türkçe (TR)" . PHP_EOL;
+        echo "  [2] 🇬🇧 English (EN)" . PHP_EOL;
+        echo "  [3] 🇩🇪 Deutsch (DE)" . PHP_EOL;
+        echo "  [4] 🇫🇷 Français (FR)" . PHP_EOL;
+        echo "  [5] 🇪🇸 Español (ES)" . PHP_EOL;
+        echo PHP_EOL;
+        
+        while (true) {
+            echo "Select [1-5]: ";
+            $choice = trim(fgets(STDIN));
+            $map = [
+                '1' => 'tr',
+                '2' => 'en',
+                '3' => 'de',
+                '4' => 'fr',
+                '5' => 'es'
+            ];
+            
+            if (isset($map[$choice])) {
+                $lang = $map[$choice];
+                if ($configFile) file_put_contents($configFile, $lang);
+                echo PHP_EOL . "Language set to: " . strtoupper($lang) . PHP_EOL;
+                return $lang;
+            }
+            echo "Invalid choice. Please try again." . PHP_EOL;
+        }
+    }
+
+    public function run(): void
+    {
+        $script = array_shift($this->args);
+        
+        // Strip --lang flag globally for args
+        $this->args = array_filter($this->args, function($arg) {
+            return strpos($arg, '--lang=') !== 0;
+        });
+        $this->args = array_values($this->args);
+
+        // If no arguments provided, enter Interactive Mode (REPL)
+        if (empty($this->args)) {
+            $this->runInteractiveShell();
+            return;
+        }
+
+        // One-shot mode
+        $commandName = array_shift($this->args);
+        $this->routeCommand($commandName, $this->args);
+    }
+
+    private function runInteractiveShell(): void
+    {
+        $this->showBanner();
+
+        while (true) {
+            echo "\033[1;32martiframe\033[0m\033[38;5;240m>\033[0m ";
+            $input = trim(fgets(STDIN));
+            
+            if ($input === '') {
+                continue;
+            }
+
+            if (in_array(strtolower($input), ['exit', 'quit'])) {
+                echo PHP_EOL . "\033[38;5;240m  Goodbye. Build something great.\033[0m" . PHP_EOL . PHP_EOL;
+                break;
+            }
+
+            $parts = explode(' ', $input);
+            $parts = array_filter($parts, function($v) { return trim($v) !== ''; });
+            $parts = array_values($parts);
+
+            $commandName = array_shift($parts);
+            
+            try {
+                $this->routeCommand($commandName, $parts);
+            } catch (\Exception $e) {
+                echo "\033[1;31m  ✖ Error:\033[0m " . $e->getMessage() . PHP_EOL;
+            }
+            echo PHP_EOL;
+        }
+    }
+
+    private function showBanner(): void
+    {
+        $g  = "\033[38;2;0;157;108m"; // #009d6c green
+        $lg = "\033[38;2;0;200;140m"; // lighter green for accent
+        $d  = "\033[38;2;80;80;80m";  // dim gray for decorators
+        $w  = "\033[1;37m";            // white bold
+        $r  = "\033[0m";               // reset
+
+        echo PHP_EOL;
+        echo $g . "  ┌─────────────────────────────────────────────────────────────┐" . $r . PHP_EOL;
+        echo $g . "  │" . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $g . "   █████╗ ██████╗ ████████╗██╗███████╗██████╗  █████╗ ███╗   ███╗███████╗" . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $g . "  ██╔══██╗██╔══██╗╚══██╔══╝██║██╔════╝██╔══██╗██╔══██╗████╗ ████║██╔════╝" . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $lg . "  ███████║██████╔╝   ██║   ██║█████╗  ██████╔╝███████║██╔████╔██║█████╗  " . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $g . "  ██╔══██║██╔══██╗   ██║   ██║██╔══╝  ██╔══██╗██╔══██║██║╚██╔╝██║██╔══╝  " . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $g . "  ██║  ██║██║  ██║   ██║   ██║██║     ██║  ██║██║  ██║██║ ╚═╝ ██║███████╗" . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $g . "  ╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝   ╚═╝╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝" . $r . PHP_EOL;
+        echo $g . "  │" . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $d . "  ─────────────────────────────────────────────────────────" . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $w . "  [A] Agile Circuit Core v" . ARTIFRAME_VERSION . $r . $d . "  │  Lightweight Native PHP Framework" . $r . PHP_EOL;
+        echo $g . "  │" . $r . "  " . $d . "  ─────────────────────────────────────────────────────────" . $r . PHP_EOL;
+        echo $g . "  │" . $r . PHP_EOL;
+        echo $g . "  └─────────────────────────────────────────────────────────────┘" . $r . PHP_EOL;
+        echo PHP_EOL;
+        echo "  " . $d . "Type " . $r . $g . "help" . $r . $d . " for available commands, or " . $r . $g . "exit" . $r . $d . " to quit." . $r . PHP_EOL;
+        echo PHP_EOL;
+    }
+
+
+
+    private function routeCommand(string $commandName, array $commandArgs): void
+    {
+        switch ($commandName) {
+            case 'new':
+                (new \ArtiFrame\Cli\Commands\NewProjectCommand($this->translator))->execute($commandArgs);
+                break;
+                
+            case 'make:view':
+                (new \ArtiFrame\Cli\Commands\MakeViewCommand($this->translator))->execute($commandArgs);
+                break;
+                
+            case 'make:api':
+                (new \ArtiFrame\Cli\Commands\MakeApiCommand($this->translator))->execute($commandArgs);
+                break;
+                
+            case 'make:class':
+                (new \ArtiFrame\Cli\Commands\MakeClassCommand($this->translator))->execute($commandArgs);
+                break;
+                
+            case 'version':
+                (new \ArtiFrame\Cli\Commands\VersionCommand($this->translator))->execute($commandArgs);
+                break;
+
+            case 'help':
+            default:
+                $this->showHelp();
+                break;
+        }
+    }
+
+    private function showHelp(): void
+    {
+        $g  = "\033[38;2;0;157;108m";  // #009d6c green
+        $lg = "\033[38;2;0;200;140m";  // light green
+        $y  = "\033[38;5;220m";         // yellow for args
+        $d  = "\033[38;2;100;100;100m"; // dim
+        $w  = "\033[1;37m";             // white bold
+        $c  = "\033[38;5;81m";          // cyan for sub-options
+        $r  = "\033[0m";                // reset
+
+        echo PHP_EOL;
+        echo "  " . $w . "COMMANDS" . $r . PHP_EOL;
+        echo "  " . $d . "─────────────────────────────────────────────────────────────" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // new
+        echo "  " . $g . "new" . $r . " " . $y . "<project-path>" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   Create a new ArtiFrame project from scratch." . PHP_EOL;
+        echo "  " . $d . "└── " . $r . "Example: " . $lg . "new my-app" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // make:view
+        echo "  " . $g . "make:view" . $r . " " . $y . "<path>" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   Generate a new view file with its paired CSS and JS assets." . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   The path can use subdirectories (auto-created)." . PHP_EOL;
+        echo "  " . $d . "└── " . $r . "Example: " . $lg . "make:view pages/about.php" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // make:api
+        echo "  " . $g . "make:api" . $r . " " . $y . "<template>" . $r . " " . $y . "<path>" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   Generate a new API endpoint file." . PHP_EOL;
+        echo "  " . $d . "│" . $r . PHP_EOL;
+        echo "  " . $d . "├── " . $c . "standart" . $r . "      Single-action endpoint (one request, one response)." . PHP_EOL;
+        echo "  " . $d . "│               " . $r . "Example: " . $lg . "make:api standart api/user/get.php" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . PHP_EOL;
+        echo "  " . $d . "└── " . $c . "switch-case" . $r . "   Multi-action endpoint with action routing." . PHP_EOL;
+        echo "  " . $d . "                " . $r . "Example: " . $lg . "make:api switch-case api/user/crud.php" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // make:class
+        echo "  " . $g . "make:class" . $r . " " . $y . "<path>" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   Generate a new PHP class file with namespace boilerplate." . PHP_EOL;
+        echo "  " . $d . "└── " . $r . "Example: " . $lg . "make:class classes/UserManager.php" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // version
+        echo "  " . $g . "version" . $r . " " . $y . "<action>" . $r . " " . $y . "<level>" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   Manage the semantic version number stored in your project config." . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   Version format: " . $w . "MAJOR.MINOR.PATCH" . $r . "  (e.g. 2.4.1)" . PHP_EOL;
+        echo "  " . $d . "│" . $r . PHP_EOL;
+        echo "  " . $d . "├── " . $c . "upgrade" . $r . PHP_EOL;
+        echo "  " . $d . "│   ├── " . $c . "patch" . $r . "   Bug fixes, small tweaks.     " . $d . "1.0.0 → 1.0.1" . $r . PHP_EOL;
+        echo "  " . $d . "│   ├── " . $c . "minor" . $r . "   New backwards-compat feature. " . $d . "1.0.0 → 1.1.0" . $r . PHP_EOL;
+        echo "  " . $d . "│   └── " . $c . "major" . $r . "   Breaking changes.            " . $d . "1.0.0 → 2.0.0" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . PHP_EOL;
+        echo "  " . $d . "└── " . $c . "downgrade" . $r . PHP_EOL;
+        echo "  " . $d . "    ├── " . $c . "patch" . $r . "   Roll back last patch.         " . $d . "1.0.3 → 1.0.2" . $r . PHP_EOL;
+        echo "  " . $d . "    ├── " . $c . "minor" . $r . "   Roll back last minor release.  " . $d . "1.3.0 → 1.2.0" . $r . PHP_EOL;
+        echo "  " . $d . "    └── " . $c . "major" . $r . "   Roll back last major release.  " . $d . "3.0.0 → 2.0.0" . $r . PHP_EOL;
+        echo PHP_EOL;
+        echo "  " . $d . "    Example: " . $lg . "version upgrade minor" . $r . PHP_EOL;
+        echo "  " . $d . "    Example: " . $lg . "version downgrade patch" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // help / exit
+        echo "  " . $d . "─────────────────────────────────────────────────────────────" . $r . PHP_EOL;
+        echo "  " . $g . "help" . $r . "           Show this help message." . PHP_EOL;
+        echo "  " . $g . "exit" . $r . " / " . $g . "quit" . $r . "   Exit the interactive shell." . PHP_EOL;
+        echo PHP_EOL;
+    }
+}

package/src/Commands/MakeApiCommand.php

@@ -0,0 +1,71 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+use ArtiFrame\Cli\Services\Safeguard;
+
+class MakeApiCommand
+{
+    private Translator $translator;
+    private Safeguard  $safeguard;
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+        $this->safeguard  = new Safeguard($translator);
+    }
+
+    public function execute(array $args): void
+    {
+        $type   = $args[0] ?? null;
+        $target = $args[1] ?? null;
+
+        if (!$type || !in_array($type, ['standart', 'switch-case'])) {
+            echo "❌ " . $this->translator->get('ERROR_API_TYPE') . PHP_EOL;
+            exit(1);
+        }
+
+        if (!$target) {
+            echo "❌ " . $this->translator->get('ERROR_API_PATH_REQUIRED') . PHP_EOL;
+            exit(1);
+        }
+
+        // Normalize path
+        $target = ltrim(str_replace('\\', '/', $target), '/');
+
+        // Ensure .php extension
+        if (!str_ends_with($target, '.php')) {
+            $target .= '.php';
+        }
+
+        $projectRoot = getcwd();
+        $apiPath     = $projectRoot . '/public/api/' . $type . '/' . $target;
+
+        if (!$this->safeguard->checkTarget($apiPath)) {
+            exit(1);
+        }
+
+        $stubName = 'api-' . $type . '.stub';
+        $stubPath = $projectRoot . '/bin/stubs/' . $stubName;
+
+        if (!file_exists($stubPath)) {
+            echo "❌ " . $this->translator->get('ERROR_STUB_NOT_FOUND', ['path' => $stubPath]) . PHP_EOL;
+            exit(1);
+        }
+
+        // Generate File
+        $this->ensureDirectoryExists(dirname($apiPath));
+
+        $content = file_get_contents($stubPath);
+        file_put_contents($apiPath, $content);
+
+        echo $this->translator->get('SUCCESS_API', ['type' => $type, 'path' => $target]) . PHP_EOL;
+    }
+
+    private function ensureDirectoryExists(string $path): void
+    {
+        if (!is_dir($path)) {
+            mkdir($path, 0755, true);
+        }
+    }
+}

package/src/Commands/MakeClassCommand.php

@@ -0,0 +1,88 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+use ArtiFrame\Cli\Services\Safeguard;
+
+class MakeClassCommand
+{
+    private Translator $translator;
+    private Safeguard  $safeguard;
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+        $this->safeguard  = new Safeguard($translator);
+    }
+
+    public function execute(array $args): void
+    {
+        $target = $args[0] ?? null;
+
+        if (!$target || strpos($target, '/') === false && strpos($target, '\\') === false) {
+            echo "❌ " . $this->translator->get('DIR_REQUIRED_ERROR') . PHP_EOL;
+            echo "Example: /src/Service/PaymentService" . PHP_EOL;
+            exit(1);
+        }
+
+        // Normalize path
+        $target = ltrim(str_replace('\\', '/', $target), '/');
+
+        // Allowed roots
+        if (!str_starts_with($target, 'app/') && !str_starts_with($target, 'src/')) {
+            echo "❌ " . $this->translator->get('ERROR_CLASS_ROOT') . PHP_EOL;
+            exit(1);
+        }
+
+        // Ensure .php extension
+        if (!str_ends_with($target, '.php')) {
+            $target .= '.php';
+        }
+
+        $projectRoot = getcwd();
+        $classPath   = $projectRoot . '/' . $target;
+
+        if (!$this->safeguard->checkTarget($classPath)) {
+            exit(1);
+        }
+
+        $stubPath = $projectRoot . '/bin/stubs/class.stub';
+        if (!file_exists($stubPath)) {
+            echo "❌ " . $this->translator->get('ERROR_STUB_NOT_FOUND', ['path' => $stubPath]) . PHP_EOL;
+            exit(1);
+        }
+
+        // Determine Namespace and Class Name
+        $pathParts = explode('/', str_replace('.php', '', $target));
+        $className = array_pop($pathParts);
+
+        // Create Namespace array with proper casing
+        $namespaceParts = [];
+        foreach ($pathParts as $part) {
+            $namespaceParts[] = ucfirst($part);
+        }
+        $namespace = implode('\\', $namespaceParts);
+
+        // Generate File
+        $this->ensureDirectoryExists(dirname($classPath));
+
+        $content = file_get_contents($stubPath);
+        $content = str_replace(
+            ['{{NAMESPACE}}', '{{CLASS_NAME}}'],
+            [$namespace, $className],
+            $content
+        );
+
+        file_put_contents($classPath, $content);
+
+        echo $this->translator->get('SUCCESS_CLASS', ['path' => $target]) . PHP_EOL;
+        echo $this->translator->get('NAMESPACE_LABEL') . ' ' . $namespace . PHP_EOL;
+    }
+
+    private function ensureDirectoryExists(string $path): void
+    {
+        if (!is_dir($path)) {
+            mkdir($path, 0755, true);
+        }
+    }
+}

package/src/Commands/MakeViewCommand.php

@@ -0,0 +1,95 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+use ArtiFrame\Cli\Services\Safeguard;
+
+class MakeViewCommand
+{
+    private Translator $translator;
+    private Safeguard  $safeguard;
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+        $this->safeguard  = new Safeguard($translator);
+    }
+
+    public function execute(array $args): void
+    {
+        $target = $args[0] ?? null;
+
+        if (!$target) {
+            echo "❌ " . $this->translator->get('ERROR_VIEW_PATH_REQUIRED') . PHP_EOL;
+            exit(1);
+        }
+
+        // Normalize path
+        $target = ltrim(str_replace('\\', '/', $target), '/');
+
+        // Ensure .php extension
+        if (!str_ends_with($target, '.php')) {
+            $target .= '.php';
+        }
+
+        $projectRoot = getcwd();
+        $viewPath = $projectRoot . '/public/' . $target;
+
+        if (!$this->safeguard->checkTarget($viewPath)) {
+            exit(1);
+        }
+
+        // Determine hierarchy for assets
+        $pathParts      = explode('/', $target);
+        $fileNameWithExt = array_pop($pathParts);
+        $fileName       = pathinfo($fileNameWithExt, PATHINFO_FILENAME);
+
+        $subDir = count($pathParts) > 0 ? implode('/', $pathParts) : 'root';
+
+        $cssRelative = '/assets/css/' . $subDir . '/' . $fileName . '.css';
+        $jsRelative  = '/assets/js/' . $subDir . '/' . $fileName . '.js';
+
+        $cssPath = $projectRoot . '/public' . $cssRelative;
+        $jsPath  = $projectRoot . '/public' . $jsRelative;
+
+        // Stub path
+        $stubPath = $projectRoot . '/bin/stubs/view.stub';
+        if (!file_exists($stubPath)) {
+            echo "❌ " . $this->translator->get('ERROR_STUB_NOT_FOUND', ['path' => $stubPath]) . PHP_EOL;
+            echo $this->translator->get('ERROR_RUN_FROM_ROOT') . PHP_EOL;
+            exit(1);
+        }
+
+        // Generate Files
+        $this->ensureDirectoryExists(dirname($viewPath));
+        $this->ensureDirectoryExists(dirname($cssPath));
+        $this->ensureDirectoryExists(dirname($jsPath));
+
+        // Format Title
+        $title = ucfirst(str_replace(['-', '_'], ' ', $fileName));
+
+        // Read and parse stub
+        $lang    = $this->translator->getLang();
+        $content = file_get_contents($stubPath);
+        $content = str_replace(
+            ['{{LANG}}', '{{VIEW_TITLE}}', '{{CSS_PATH}}', '{{JS_PATH}}'],
+            [$lang, $title, $cssRelative, $jsRelative],
+            $content
+        );
+
+        file_put_contents($viewPath, $content);
+        file_put_contents($cssPath, "/* CSS for {$title} */\n");
+        file_put_contents($jsPath, "/* JS for {$title} */\n");
+
+        echo $this->translator->get('SUCCESS_VIEW', ['path' => $target]) . PHP_EOL;
+        echo $this->translator->get('SUCCESS_CSS', ['path' => $cssRelative]) . PHP_EOL;
+        echo $this->translator->get('SUCCESS_JS',  ['path' => $jsRelative]) . PHP_EOL;
+    }
+
+    private function ensureDirectoryExists(string $path): void
+    {
+        if (!is_dir($path)) {
+            mkdir($path, 0755, true);
+        }
+    }
+}