<?php

namespace Kylin\Modules\Console\Commands;

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

/**
 * 模块生成辅助函数命令
 *
 * 为模块生成新的辅助函数文件
 */
class ModuleMakeHelperCommand extends Command
{
    /**
     * 命令名称和签名
     *
     * @var string
     * 
     * 命令参数说明：
     * 1. {module} - 模块名称（必填）
     *    - 数据类型：字符串
     *    - 用途：指定辅助函数文件所属的模块名称
     *    - 示例：php artisan module:make-helper game Helper
     * 
     * 2. {name} - 辅助函数文件名称（必填）
     *    - 数据类型：字符串
     *    - 用途：指定要创建的辅助函数文件名称
     *    - 示例：php artisan module:make-helper game Helper
     */
    protected $signature = 'module:make-helper {module : 模块名称} {name : 辅助函数文件名称}';

    /**
     * 命令描述
     *
     * @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');

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

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

        // 确保目录存在
        if (!($this->files->exists($helpersPath))) {
            $this->files->makeDirectory($helpersPath, 0755, true);
            $this->info("创建辅助函数目录: {$helpersPath}");
        }

        // 生成辅助函数文件
        $helperContent = $this->buildHelperFile($moduleName, $name);
        $helperFile = "{$helpersPath}/{$name}.php";

        if ($this->files->exists($helperFile)) {
            $this->error("辅助函数文件 [{$name}.php] 已存在");
            return 1;
        }

        $this->files->put($helperFile, $helperContent);
        $this->info("创建辅助函数文件: {$helperFile}");

        return 0;
    }

    /**
     * 构建辅助函数文件内容
     *
     * @param  string  $name  辅助函数文件名
     * @return string  辅助函数文件内容
     */
    protected function buildHelperFile(string $moduleName, string $name): string
    {
        $stubPath = __DIR__ . '/../../../stubs/helper.stub';
        $stub = $this->files->get($stubPath);
        return str_replace('{{ name }}', $name, $stub);
    }
}