<?php

namespace Kylin\Modules\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Filesystem\Filesystem;
use Kylin\Modules\ModuleManager;

/**
 * 模块生成异常命令
 *
 * 为模块生成新的异常类
 */
class ModuleMakeExceptionCommand extends Command
{
    /**
     * 命令名称和签名
     *
     * @var string
     * 
     * 命令参数说明：
     * 1. {module} - 模块名称（必填）
     *    - 数据类型：字符串
     *    - 用途：指定异常类所属的模块名称
     *    - 示例：php artisan module:make-exception game CustomException
     * 
     * 2. {name} - 异常类名称（必填）
     *    - 数据类型：字符串
     *    - 用途：指定要创建的异常类名称
     *    - 示例：php artisan module:make-exception game CustomException
     * 
     * 命令选项说明：
     * 1. {--r|render} - 生成可渲染的异常
     *    - 简写：-r
     *    - 完整形式：--render
     *    - 用途：生成一个带有render方法的可渲染异常类
     *    - 示例：php artisan module:make-exception game CustomException --render
     */
    protected $signature = 'module:make-exception {module : 模块名称} {name : 异常类名称} {--r|render : 生成可渲染的异常}';

    /**
     * 命令描述
     *
     * @var string
     */
    protected $description = '为模块生成新的异常类';

    /**
     * 文件系统实例
     *
     * @var Filesystem
     */
    private readonly Filesystem $files;

    /**
     * 创建新命令实例
     *
     * @param  ModuleManager  $moduleManager  模块管理器实例
     * @param  Filesystem  $files  文件系统实例
     */
    public function __construct(
        private readonly ModuleManager $moduleManager,
        Filesystem $files
    ) {
        parent::__construct();
        $this->files = $files;
    }

    /**
     * 执行控制台命令
     */
    public function handle(): int
    {
        $moduleName = (string) $this->argument('module');
        $name = (string) $this->argument('name');
        $render = $this->option('render');

        // 检查模块是否存在
        $module = $this->moduleManager->get($moduleName);
        if (!$module) {
            $this->error("模块 [{$moduleName}] 未找到");
            return 1;
        }

        $modulePath = $module->getPath();
        $srcPath = "{$modulePath}/src";
        $exceptionsPath = "{$srcPath}/Exceptions";

        // 确保目录存在
        if (!($this->files->exists($exceptionsPath))) {
            $this->files->makeDirectory($exceptionsPath, 0755, true);
            $this->info("创建异常目录: {$exceptionsPath}");
        }

        // 生成异常类
        $exceptionClass = $this->buildExceptionClass($moduleName, $name, $render);
        $exceptionFile = "{$exceptionsPath}/{$name}.php";

        if ($this->files->exists($exceptionFile)) {
            $this->error("异常 [{$name}] 已存在");
            return 1;
        }

        $this->files->put($exceptionFile, $exceptionClass);
        $this->info("创建异常: {$exceptionFile}");

        return 0;
    }

    /**
     * 构建异常类
     *
     * @param  string  $moduleName  模块名称
     * @param  string  $name  异常名称
     * @param  bool  $render  是否生成可渲染的异常
     * @return string  异常类代码
     */
    protected function buildExceptionClass(string $moduleName, string $name, bool $render): string
    {
        $namespace = "{$moduleName}\Exceptions";
        if ($render) {
            $stubPath = __DIR__ . '/../../../stubs/exception.render.stub';
            $stub = $this->files->get($stubPath);
            return str_replace(
                ['{{ namespace }}', '{{ class }}'],
                [$namespace, $name],
                $stub
            );
        } else {
            $stubPath = __DIR__ . '/../../../stubs/exception.stub';
            $stub = $this->files->get($stubPath);
            return str_replace(
                ['{{ namespace }}', '{{ class }}'],
                [$namespace, $name],
                $stub
            );
        }
    }
}