<?php

namespace Kylin\Modules\Console\Commands;

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

/**
 * 模块生成语言文件命令
 *
 * 为模块生成新的语言文件
 */
class ModuleMakeLangCommand extends Command
{
    /**
     * 命令名称和签名
     *
     * @var string
     * 
     * 命令参数说明：
     * 1. {module} - 模块名称（必填）
     *    - 数据类型：字符串
     *    - 用途：指定语言文件所属的模块名称
     *    - 示例：php artisan module:make-lang game messages
     * 
     * 2. {name} - 语言文件名称（必填）
     *    - 数据类型：字符串
     *    - 用途：指定要创建的语言文件名称
     *    - 示例：php artisan module:make-lang game messages
     * 
     * 命令选项说明：
     * 1. {--l|locale=zh_CN} - 语言区域（默认为 zh_CN）
     *    - 简写：-l
     *    - 完整形式：--locale
     *    - 数据类型：字符串
     *    - 用途：指定语言文件的语言区域
     *    - 默认值：zh_CN
     *    - 示例：php artisan module:make-lang game messages --locale=en
     */
    protected $signature = 'module:make-lang {module : 模块名称} {name : 语言文件名称} {--l|locale=zh_CN : 语言区域（默认为 zh_CN）}';

    /**
     * 命令描述
     *
     * @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');
        $locale = $this->option('locale') ?: 'zh_CN';

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

        $modulePath = $module->getPath();
        $langPath = "{$modulePath}/resources/lang/{$locale}";

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

        // 生成语言文件
        $langContent = $this->buildLangContent($name);
        $langFile = "{$langPath}/{$name}.php";

        if ($this->files->exists($langFile)) {
            $this->error("语言文件 [{$name}.php] 已存在");
            return 1;
        }

        $this->files->put($langFile, $langContent);
        $this->info("创建语言文件: {$langFile}");

        return 0;
    }

    /**
     * 构建语言文件内容
     *
     * @param  string  $name  语言文件名称
     * @return string  语言文件内容
     */
    protected function buildLangContent(string $name): string
    {
        $stubPath = __DIR__ . '/../../../stubs/lang.stub';
        $stub = $this->files->get($stubPath);
        return $stub;
    }
}