esengine/packages/editor/editor-app/src-tauri/src/commands/compiler.rs

//! User code compilation commands.
//! 用户代码编译命令。
//!
//! Provides TypeScript compilation using esbuild for user scripts.
//! 使用 esbuild 为用户脚本提供 TypeScript 编译。

use notify::{Config, RecommendedWatcher, RecursiveMode, Watcher, Event, EventKind};
use serde::{Deserialize, Serialize};
use std::path::Path;
use std::process::Command;
use std::sync::mpsc::channel;
use std::time::Duration;
use tauri::{command, AppHandle, Emitter, State};
use crate::state::ScriptWatcherState;

/// Compilation options.
/// 编译选项。
#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct CompileOptions {
    /// Entry file path | 入口文件路径
    pub entry_path: String,
    /// Output file path | 输出文件路径
    pub output_path: String,
    /// Output format (esm or iife) | 输出格式
    pub format: String,
    /// Global name for IIFE format | IIFE 格式的全局名称
    pub global_name: Option<String>,
    /// Whether to generate source map | 是否生成 source map
    pub source_map: bool,
    /// Whether to minify | 是否压缩
    pub minify: bool,
    /// External dependencies | 外部依赖
    pub external: Vec<String>,
    /// Module aliases (e.g., "@esengine/ecs-framework" -> "/path/to/shim.js")
    /// 模块别名
    pub alias: Option<std::collections::HashMap<String, String>>,
    /// Project root for resolving imports | 项目根目录用于解析导入
    pub project_root: String,
}

/// Compilation error.
/// 编译错误。
#[derive(Debug, Clone, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct CompileError {
    /// Error message | 错误信息
    pub message: String,
    /// File path | 文件路径
    pub file: Option<String>,
    /// Line number | 行号
    pub line: Option<u32>,
    /// Column number | 列号
    pub column: Option<u32>,
}

/// Compilation result.
/// 编译结果。
#[derive(Debug, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct CompileResult {
    /// Whether compilation succeeded | 是否编译成功
    pub success: bool,
    /// Compilation errors | 编译错误
    pub errors: Vec<CompileError>,
    /// Output file path (if successful) | 输出文件路径（如果成功）
    pub output_path: Option<String>,
}

/// Environment check result.
/// 环境检测结果。
#[derive(Debug, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct EnvironmentCheckResult {
    /// Whether all required tools are available | 所有必需工具是否可用
    pub ready: bool,
    /// esbuild availability status | esbuild 可用性状态
    pub esbuild: ToolStatus,
}

/// Tool availability status.
/// 工具可用性状态。
#[derive(Debug, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct ToolStatus {
    /// Whether the tool is available | 工具是否可用
    pub available: bool,
    /// Tool version (if available) | 工具版本（如果可用）
    pub version: Option<String>,
    /// Tool path (if available) | 工具路径（如果可用）
    pub path: Option<String>,
    /// Source of the tool: "bundled", "local", "global" | 工具来源
    pub source: Option<String>,
    /// Error message (if not available) | 错误信息（如果不可用）
    pub error: Option<String>,
}

/// File change event sent to frontend.
/// 发送到前端的文件变更事件。
#[derive(Debug, Clone, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct FileChangeEvent {
    /// Type of change: "create", "modify", "remove" | 变更类型
    pub change_type: String,
    /// File paths that changed | 发生变更的文件路径
    pub paths: Vec<String>,
}

/// Install esbuild globally using npm.
/// 使用 npm 全局安装 esbuild。
///
/// # Returns | 返回
/// Progress messages as the installation proceeds.
/// 安装过程中的进度消息。
#[command]
pub async fn install_esbuild(app: AppHandle) -> Result<(), String> {
    println!("[Environment] Starting esbuild installation...");

    // Emit progress event | 发送进度事件
    let _ = app.emit("esbuild-install:progress", "Checking npm...");

    // Check if npm is available | 检查 npm 是否可用
    let npm_cmd = if cfg!(windows) { "npm.cmd" } else { "npm" };
    let npm_check = Command::new(npm_cmd)
        .arg("--version")
        .output()
        .map_err(|_| "npm not found. Please install Node.js first. | 未找到 npm，请先安装 Node.js。".to_string())?;

    if !npm_check.status.success() {
        return Err("npm not working properly. | npm 无法正常工作。".to_string());
    }

    let _ = app.emit("esbuild-install:progress", "Installing esbuild globally...");
    println!("[Environment] Running: npm install -g esbuild");

    // Install esbuild globally | 全局安装 esbuild
    let output = Command::new(npm_cmd)
        .args(&["install", "-g", "esbuild"])
        .output()
        .map_err(|e| format!("Failed to run npm install | npm install 执行失败: {}", e))?;

    if output.status.success() {
        println!("[Environment] esbuild installed successfully");
        let _ = app.emit("esbuild-install:progress", "Installation complete!");
        let _ = app.emit("esbuild-install:success", true);
        Ok(())
    } else {
        let stderr = String::from_utf8_lossy(&output.stderr);
        let error_msg = format!("Failed to install esbuild | 安装 esbuild 失败: {}", stderr);
        println!("[Environment] {}", error_msg);
        let _ = app.emit("esbuild-install:error", &error_msg);
        Err(error_msg)
    }
}

/// Check development environment.
/// 检测开发环境。
///
/// Checks if all required tools (esbuild, etc.) are available.
/// 检查所有必需的工具是否可用。
#[command]
pub async fn check_environment() -> Result<EnvironmentCheckResult, String> {
    let esbuild_status = check_esbuild_status();

    Ok(EnvironmentCheckResult {
        ready: esbuild_status.available,
        esbuild: esbuild_status,
    })
}

/// Check esbuild availability and get its status.
/// 检查 esbuild 可用性并获取其状态。
///
/// Checks multiple sources: bundled, local node_modules, pnpm, npx, global.
/// 检查多个来源：内置、本地 node_modules、pnpm、npx、全局。
fn check_esbuild_status() -> ToolStatus {
    // Try to find esbuild from any available source
    // 尝试从任何可用来源查找 esbuild
    match find_esbuild_with_source(None) {
        Ok(info) => {
            let display_path = if info.prefix_args.is_empty() {
                info.cmd.clone()
            } else {
                format!("{} {}", info.cmd, info.prefix_args.join(" "))
            };
            ToolStatus {
                available: true,
                version: Some(info.version),
                path: Some(display_path),
                source: Some(info.source),
                error: None,
            }
        }
        Err(e) => {
            ToolStatus {
                available: false,
                version: None,
                path: None,
                source: None,
                error: Some(e),
            }
        }
    }
}

/// Esbuild execution info.
/// Esbuild 执行信息。
#[derive(Debug, Clone)]
struct EsbuildInfo {
    /// Command to run (e.g., "esbuild.cmd", "pnpm.cmd")
    /// 要运行的命令
    cmd: String,
    /// Prefix args before esbuild args (e.g., ["exec", "esbuild"] for pnpm)
    /// esbuild 参数前的前缀参数
    prefix_args: Vec<String>,
    /// Source of esbuild: "local", "pnpm", "npx", "global"
    /// esbuild 来源
    source: String,
    /// Version string
    /// 版本字符串
    version: String,
}

/// Find esbuild with source information.
/// 查找 esbuild 并返回来源信息。
///
/// Returns EsbuildInfo on success.
/// 成功时返回 EsbuildInfo。
fn find_esbuild_with_source(project_root: Option<&str>) -> Result<EsbuildInfo, String> {
    // 1. Check local node_modules/.bin/esbuild (project-specific)
    // 1. 检查本地 node_modules/.bin/esbuild（项目特定）
    if let Some(root) = project_root {
        let local_esbuild = if cfg!(windows) {
            Path::new(root).join("node_modules").join(".bin").join("esbuild.cmd")
        } else {
            Path::new(root).join("node_modules").join(".bin").join("esbuild")
        };

        if local_esbuild.exists() {
            let path_str = local_esbuild.to_string_lossy().to_string();
            if let Ok(version) = get_esbuild_version(&path_str) {
                println!("[Compiler] Found local esbuild: {}", path_str);
                return Ok(EsbuildInfo {
                    cmd: path_str,
                    prefix_args: vec![],
                    source: "local".to_string(),
                    version,
                });
            }
        }
    }

    // 2. Try pnpm exec esbuild (works with pnpm workspaces)
    // 2. 尝试 pnpm exec esbuild（支持 pnpm 工作区）
    if let Ok(version) = try_package_manager_esbuild("pnpm", &["exec", "esbuild", "--version"], project_root) {
        let cmd = if cfg!(windows) { "pnpm.cmd" } else { "pnpm" };
        println!("[Compiler] Found esbuild via pnpm");
        return Ok(EsbuildInfo {
            cmd: cmd.to_string(),
            prefix_args: vec!["exec".to_string(), "esbuild".to_string()],
            source: "pnpm".to_string(),
            version,
        });
    }

    // 3. Try npx esbuild (works with npm projects)
    // 3. 尝试 npx esbuild（支持 npm 项目）
    if let Ok(version) = try_package_manager_esbuild("npx", &["esbuild", "--version"], project_root) {
        let cmd = if cfg!(windows) { "npx.cmd" } else { "npx" };
        println!("[Compiler] Found esbuild via npx");
        return Ok(EsbuildInfo {
            cmd: cmd.to_string(),
            prefix_args: vec!["esbuild".to_string()],
            source: "npx".to_string(),
            version,
        });
    }

    // 4. Fall back to global esbuild
    // 4. 回退到全局 esbuild
    let global_esbuild = if cfg!(windows) { "esbuild.cmd" } else { "esbuild" };
    if let Ok(version) = get_esbuild_version(global_esbuild) {
        println!("[Compiler] Found global esbuild");
        return Ok(EsbuildInfo {
            cmd: global_esbuild.to_string(),
            prefix_args: vec![],
            source: "global".to_string(),
            version,
        });
    }

    Err("esbuild not found. Install locally (pnpm add -D esbuild) or globally (npm i -g esbuild) | 未找到 esbuild，请本地安装 (pnpm add -D esbuild) 或全局安装 (npm i -g esbuild)".to_string())
}

/// Try to get esbuild version via package manager (pnpm/npx).
/// 尝试通过包管理器获取 esbuild 版本。
fn try_package_manager_esbuild(cmd: &str, args: &[&str], project_root: Option<&str>) -> Result<String, String> {
    let cmd_name = if cfg!(windows) { format!("{}.cmd", cmd) } else { cmd.to_string() };

    let mut command = Command::new(&cmd_name);
    command.args(args);

    if let Some(root) = project_root {
        command.current_dir(root);
    }

    match command.output() {
        Ok(output) if output.status.success() => {
            let version = String::from_utf8_lossy(&output.stdout).trim().to_string();
            Ok(version)
        }
        _ => Err(format!("{} esbuild not available", cmd))
    }
}

/// Get esbuild version.
/// 获取 esbuild 版本。
fn get_esbuild_version(esbuild_path: &str) -> Result<String, String> {
    let output = Command::new(esbuild_path)
        .arg("--version")
        .output()
        .map_err(|e| format!("Failed to run esbuild: {}", e))?;

    if output.status.success() {
        let version = String::from_utf8_lossy(&output.stdout).trim().to_string();
        Ok(version)
    } else {
        Err("esbuild --version failed".to_string())
    }
}

/// Compile TypeScript using esbuild.
/// 使用 esbuild 编译 TypeScript。
///
/// # Arguments | 参数
/// * `options` - Compilation options | 编译选项
///
/// # Returns | 返回
/// Compilation result | 编译结果
#[command]
pub async fn compile_typescript(options: CompileOptions) -> Result<CompileResult, String> {
    // Find esbuild with execution info | 查找 esbuild 并获取执行信息
    let esbuild_info = find_esbuild_with_source(Some(&options.project_root))?;

    // Build esbuild arguments | 构建 esbuild 参数
    let mut esbuild_args = vec![
        options.entry_path.clone(),
        "--bundle".to_string(),
        format!("--outfile={}", options.output_path),
        format!("--format={}", options.format),
        "--platform=browser".to_string(),
        "--target=es2020".to_string(),
    ];

    // Add source map option | 添加 source map 选项
    if options.source_map {
        esbuild_args.push("--sourcemap".to_string());
    }

    // Add minify option | 添加压缩选项
    if options.minify {
        esbuild_args.push("--minify".to_string());
    }

    // Add global name for IIFE format | 添加 IIFE 格式的全局名称
    if let Some(ref global_name) = options.global_name {
        esbuild_args.push(format!("--global-name={}", global_name));
    }

    // Add external dependencies | 添加外部依赖
    for external in &options.external {
        esbuild_args.push(format!("--external:{}", external));
    }

    // Add module aliases | 添加模块别名
    if let Some(ref aliases) = options.alias {
        for (from, to) in aliases {
            esbuild_args.push(format!("--alias:{}={}", from, to));
        }
    }

    // Combine prefix args with esbuild args | 合并前缀参数和 esbuild 参数
    let mut all_args: Vec<String> = esbuild_info.prefix_args.clone();
    all_args.extend(esbuild_args);

    // Build full command string for error reporting | 构建完整命令字符串用于错误报告
    let cmd_str = format!("{} {}", esbuild_info.cmd, all_args.join(" "));
    println!("[Compiler] Running: {} (source: {})", cmd_str, esbuild_info.source);

    // Run esbuild | 运行 esbuild
    let output = Command::new(&esbuild_info.cmd)
        .args(&all_args)
        .current_dir(&options.project_root)
        .output()
        .map_err(|e| format!("Failed to run esbuild | 运行 esbuild 失败: {}", e))?;

    if output.status.success() {
        println!("[Compiler] Compilation successful: {}", options.output_path);
        Ok(CompileResult {
            success: true,
            errors: vec![],
            output_path: Some(options.output_path),
        })
    } else {
        let stderr = String::from_utf8_lossy(&output.stderr);
        let stdout = String::from_utf8_lossy(&output.stdout);

        println!("[Compiler] Compilation failed");
        println!("[Compiler] stdout: {}", stdout);
        println!("[Compiler] stderr: {}", stderr);

        // Try to parse errors from both stdout and stderr | 尝试从 stdout 和 stderr 解析错误
        let mut errors = parse_esbuild_errors(&stderr);
        if errors.is_empty() {
            errors = parse_esbuild_errors(&stdout);
        }

        // If still no parsed errors, include the raw output and command | 如果仍然没有解析到错误，包含原始输出和命令
        if errors.is_empty() {
            let combined_output = if !stderr.is_empty() && !stdout.is_empty() {
                format!("stdout: {}\nstderr: {}", stdout.trim(), stderr.trim())
            } else if !stderr.is_empty() {
                stderr.trim().to_string()
            } else if !stdout.is_empty() {
                stdout.trim().to_string()
            } else {
                format!("Command failed: {}", cmd_str)
            };

            errors.push(CompileError {
                message: combined_output,
                file: None,
                line: None,
                column: None,
            });
        }

        Ok(CompileResult {
            success: false,
            errors,
            output_path: None,
        })
    }
}

/// Type check options.
/// 类型检查选项。
#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct TypeCheckOptions {
    /// Project root directory | 项目根目录
    pub project_root: String,
    /// TypeScript config path (optional) | TypeScript 配置路径（可选）
    pub tsconfig_path: Option<String>,
    /// Files to check (optional, if not set checks whole project)
    /// 要检查的文件（可选，如果未设置则检查整个项目）
    pub files: Option<Vec<String>>,
}

/// Type check result.
/// 类型检查结果。
#[derive(Debug, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct TypeCheckResult {
    /// Whether type check passed | 类型检查是否通过
    pub success: bool,
    /// Type errors | 类型错误
    pub errors: Vec<CompileError>,
    /// Duration in milliseconds | 耗时（毫秒）
    pub duration_ms: u64,
}

/// Check TypeScript types using tsc.
/// 使用 tsc 检查 TypeScript 类型。
///
/// Runs tsc --noEmit to check types without generating output files.
/// 运行 tsc --noEmit 检查类型但不生成输出文件。
#[command]
pub async fn check_types(options: TypeCheckOptions) -> Result<TypeCheckResult, String> {
    let start = std::time::Instant::now();

    // Find tsc executable | 查找 tsc 可执行文件
    let tsc_info = find_tsc_with_source(Some(&options.project_root))?;

    // Build tsc arguments | 构建 tsc 参数
    let mut tsc_args: Vec<String> = tsc_info.prefix_args.clone();
    tsc_args.push("--noEmit".to_string());
    tsc_args.push("--pretty".to_string());
    tsc_args.push("false".to_string());

    // Use project tsconfig if specified | 使用项目 tsconfig（如果指定）
    if let Some(ref tsconfig) = options.tsconfig_path {
        tsc_args.push("--project".to_string());
        tsc_args.push(tsconfig.clone());
    }

    // Add specific files if provided | 添加特定文件（如果提供）
    if let Some(ref files) = options.files {
        for file in files {
            tsc_args.push(file.clone());
        }
    }

    let cmd_str = format!("{} {}", tsc_info.cmd, tsc_args.join(" "));
    println!("[TypeCheck] Running: {} (source: {})", cmd_str, tsc_info.source);

    // Run tsc | 运行 tsc
    let output = Command::new(&tsc_info.cmd)
        .args(&tsc_args)
        .current_dir(&options.project_root)
        .output()
        .map_err(|e| format!("Failed to run tsc | 运行 tsc 失败: {}", e))?;

    let duration_ms = start.elapsed().as_millis() as u64;

    if output.status.success() {
        println!("[TypeCheck] Type check passed in {}ms", duration_ms);
        Ok(TypeCheckResult {
            success: true,
            errors: vec![],
            duration_ms,
        })
    } else {
        let stdout = String::from_utf8_lossy(&output.stdout);
        let stderr = String::from_utf8_lossy(&output.stderr);

        println!("[TypeCheck] Type check failed in {}ms", duration_ms);

        // Parse tsc output | 解析 tsc 输出
        let errors = parse_tsc_errors(&stdout, &stderr);

        Ok(TypeCheckResult {
            success: false,
            errors,
            duration_ms,
        })
    }
}

/// TSC execution info (similar to EsbuildInfo).
/// TSC 执行信息。
#[derive(Debug, Clone)]
struct TscInfo {
    cmd: String,
    prefix_args: Vec<String>,
    source: String,
}

/// Find tsc executable.
/// 查找 tsc 可执行文件。
fn find_tsc_with_source(project_root: Option<&str>) -> Result<TscInfo, String> {
    // 1. Check local node_modules/.bin/tsc
    if let Some(root) = project_root {
        let local_tsc = if cfg!(windows) {
            Path::new(root).join("node_modules").join(".bin").join("tsc.cmd")
        } else {
            Path::new(root).join("node_modules").join(".bin").join("tsc")
        };

        if local_tsc.exists() {
            let path_str = local_tsc.to_string_lossy().to_string();
            println!("[TypeCheck] Found local tsc: {}", path_str);
            return Ok(TscInfo {
                cmd: path_str,
                prefix_args: vec![],
                source: "local".to_string(),
            });
        }
    }

    // 2. Try pnpm exec tsc
    if try_tsc_via_package_manager("pnpm", &["exec", "tsc", "--version"], project_root).is_ok() {
        let cmd = if cfg!(windows) { "pnpm.cmd" } else { "pnpm" };
        println!("[TypeCheck] Found tsc via pnpm");
        return Ok(TscInfo {
            cmd: cmd.to_string(),
            prefix_args: vec!["exec".to_string(), "tsc".to_string()],
            source: "pnpm".to_string(),
        });
    }

    // 3. Try npx tsc
    if try_tsc_via_package_manager("npx", &["tsc", "--version"], project_root).is_ok() {
        let cmd = if cfg!(windows) { "npx.cmd" } else { "npx" };
        println!("[TypeCheck] Found tsc via npx");
        return Ok(TscInfo {
            cmd: cmd.to_string(),
            prefix_args: vec!["tsc".to_string()],
            source: "npx".to_string(),
        });
    }

    // 4. Try global tsc
    let global_tsc = if cfg!(windows) { "tsc.cmd" } else { "tsc" };
    if Command::new(global_tsc).arg("--version").output().map(|o| o.status.success()).unwrap_or(false) {
        println!("[TypeCheck] Found global tsc");
        return Ok(TscInfo {
            cmd: global_tsc.to_string(),
            prefix_args: vec![],
            source: "global".to_string(),
        });
    }

    Err("TypeScript not found. Install locally (pnpm add -D typescript) or globally (npm i -g typescript) | 未找到 TypeScript，请本地安装 (pnpm add -D typescript) 或全局安装 (npm i -g typescript)".to_string())
}

/// Try to run tsc via package manager.
/// 尝试通过包管理器运行 tsc。
fn try_tsc_via_package_manager(cmd: &str, args: &[&str], project_root: Option<&str>) -> Result<(), String> {
    let cmd_name = if cfg!(windows) { format!("{}.cmd", cmd) } else { cmd.to_string() };

    let mut command = Command::new(&cmd_name);
    command.args(args);

    if let Some(root) = project_root {
        command.current_dir(root);
    }

    match command.output() {
        Ok(output) if output.status.success() => Ok(()),
        _ => Err(format!("{} tsc not available", cmd))
    }
}

/// Parse tsc error output.
/// 解析 tsc 错误输出。
fn parse_tsc_errors(stdout: &str, stderr: &str) -> Vec<CompileError> {
    let mut errors = Vec::new();
    let combined = format!("{}\n{}", stdout, stderr);

    // tsc output format: file(line,col): error TSxxxx: message
    // tsc 输出格式: 文件(行,列): error TSxxxx: 消息
    let re = regex::Regex::new(r"(.+?)\((\d+),(\d+)\):\s*error\s+TS\d+:\s*(.+)").ok();

    for line in combined.lines() {
        if let Some(ref regex) = re {
            if let Some(caps) = regex.captures(line) {
                errors.push(CompileError {
                    file: Some(caps.get(1).map_or("", |m| m.as_str()).to_string()),
                    line: caps.get(2).and_then(|m| m.as_str().parse().ok()),
                    column: caps.get(3).and_then(|m| m.as_str().parse().ok()),
                    message: caps.get(4).map_or("", |m| m.as_str()).to_string(),
                });
            }
        } else if line.contains("error TS") {
            // Fallback: just capture the error line
            errors.push(CompileError {
                message: line.to_string(),
                file: None,
                line: None,
                column: None,
            });
        }
    }

    // If no errors parsed but output is not empty, add raw output
    if errors.is_empty() && !combined.trim().is_empty() {
        errors.push(CompileError {
            message: combined.trim().to_string(),
            file: None,
            line: None,
            column: None,
        });
    }

    errors
}

/// Watch for file changes in scripts directory.
/// 监视脚本目录中的文件变更。
///
/// Emits "user-code:file-changed" events when files change.
/// 当文件发生变更时触发 "user-code:file-changed" 事件。
#[command]
pub async fn watch_scripts(
    app: AppHandle,
    watcher_state: State<'_, ScriptWatcherState>,
    project_path: String,
    scripts_dir: String,
) -> Result<(), String> {
    let watch_path = Path::new(&project_path).join(&scripts_dir);

    if !watch_path.exists() {
        return Err(format!(
            "Scripts directory does not exist | 脚本目录不存在: {}",
            watch_path.display()
        ));
    }

    // Check if already watching this project | 检查是否已在监视此项目
    {
        let watchers = watcher_state.watchers.lock().await;
        if watchers.contains_key(&project_path) {
            println!("[UserCode] Already watching: {}", project_path);
            return Ok(());
        }
    }

    // Create a channel for shutdown signal | 创建关闭信号通道
    let (shutdown_tx, mut shutdown_rx) = tokio::sync::oneshot::channel::<()>();

    // Clone values for the spawned task | 克隆值以供任务使用
    let project_path_clone = project_path.clone();
    let watch_path_clone = watch_path.clone();
    let app_clone = app.clone();

    // Spawn file watcher task | 启动文件监视任务
    tokio::spawn(async move {
        // Create notify watcher | 创建 notify 监视器
        let (tx, rx) = channel();

        let mut watcher = match RecommendedWatcher::new(
            move |res: Result<Event, notify::Error>| {
                if let Ok(event) = res {
                    let _ = tx.send(event);
                }
            },
            Config::default().with_poll_interval(Duration::from_millis(500)),
        ) {
            Ok(w) => w,
            Err(e) => {
                eprintln!("[UserCode] Failed to create watcher: {}", e);
                return;
            }
        };

        // Start watching | 开始监视
        if let Err(e) = watcher.watch(&watch_path_clone, RecursiveMode::Recursive) {
            eprintln!("[UserCode] Failed to watch path: {}", e);
            return;
        }

        println!("[UserCode] Started watching: {}", watch_path_clone.display());

        // Debounce state | 防抖状态
        let mut pending_paths: std::collections::HashSet<String> = std::collections::HashSet::new();
        let mut last_event_time = std::time::Instant::now();
        let debounce_duration = Duration::from_millis(300);

        // Event loop | 事件循环
        loop {
            // Check for shutdown | 检查关闭信号
            if shutdown_rx.try_recv().is_ok() {
                println!("[UserCode] Stopping watcher for: {}", project_path_clone);
                break;
            }

            // Check for file events with timeout | 带超时检查文件事件
            match rx.recv_timeout(Duration::from_millis(100)) {
                Ok(event) => {
                    // Filter for TypeScript/JavaScript files | 过滤 TypeScript/JavaScript 文件
                    let ts_paths: Vec<String> = event
                        .paths
                        .iter()
                        .filter(|p| {
                            let ext = p.extension().and_then(|e| e.to_str()).unwrap_or("");
                            matches!(ext, "ts" | "tsx" | "js" | "jsx")
                        })
                        .map(|p| p.to_string_lossy().to_string())
                        .collect();

                    if !ts_paths.is_empty() {
                        // Only handle create/modify/remove events | 只处理创建/修改/删除事件
                        match event.kind {
                            EventKind::Create(_) | EventKind::Modify(_) | EventKind::Remove(_) => {
                                // Add to pending paths and update last event time | 添加到待处理路径并更新最后事件时间
                                for path in ts_paths {
                                    pending_paths.insert(path);
                                }
                                last_event_time = std::time::Instant::now();
                            }
                            _ => continue,
                        };
                    }
                }
                Err(std::sync::mpsc::RecvTimeoutError::Timeout) => {
                    // Check if we should emit pending events (debounce) | 检查是否应该发送待处理事件（防抖）
                    if !pending_paths.is_empty() && last_event_time.elapsed() >= debounce_duration {
                        let file_event = FileChangeEvent {
                            change_type: "modify".to_string(),
                            paths: pending_paths.drain().collect(),
                        };

                        println!("[UserCode] File change detected (debounced): {:?}", file_event);

                        // Emit event to frontend | 向前端发送事件
                        if let Err(e) = app_clone.emit("user-code:file-changed", file_event) {
                            eprintln!("[UserCode] Failed to emit event: {}", e);
                        }
                    }
                }
                Err(std::sync::mpsc::RecvTimeoutError::Disconnected) => {
                    println!("[UserCode] Watcher channel disconnected");
                    break;
                }
            }
        }
    });

    // Store watcher handle | 存储监视器句柄
    {
        let mut watchers = watcher_state.watchers.lock().await;
        watchers.insert(
            project_path.clone(),
            crate::state::WatcherHandle { shutdown_tx },
        );
    }

    println!("[UserCode] Watch scripts started for: {}/{}", project_path, scripts_dir);
    Ok(())
}

/// Watch for file changes in asset directories.
/// 监视资产目录中的文件变更。
///
/// Watches multiple directories (assets, scenes, etc.) for all file types.
/// 监视多个目录（assets, scenes 等）中的所有文件类型。
///
/// Emits "user-code:file-changed" events when files change.
/// 当文件发生变更时触发 "user-code:file-changed" 事件。
#[command]
pub async fn watch_assets(
    app: AppHandle,
    watcher_state: State<'_, ScriptWatcherState>,
    project_path: String,
    directories: Vec<String>,
) -> Result<(), String> {
    // Create a unique key for this watcher set | 为此监视器集创建唯一键
    let watcher_key = format!("{}/assets", project_path);

    // Check if already watching | 检查是否已在监视
    {
        let watchers = watcher_state.watchers.lock().await;
        if watchers.contains_key(&watcher_key) {
            println!("[AssetWatcher] Already watching: {}", watcher_key);
            return Ok(());
        }
    }

    // Validate directories exist | 验证目录是否存在
    let mut watch_paths = Vec::new();
    for dir in &directories {
        let watch_path = Path::new(&project_path).join(dir);
        if watch_path.exists() {
            watch_paths.push((watch_path, dir.clone()));
        } else {
            println!("[AssetWatcher] Directory does not exist, skipping: {}", watch_path.display());
        }
    }

    if watch_paths.is_empty() {
        return Err("No valid directories to watch | 没有有效的目录可监视".to_string());
    }

    // Create a channel for shutdown signal | 创建关闭信号通道
    let (shutdown_tx, mut shutdown_rx) = tokio::sync::oneshot::channel::<()>();

    // Clone values for the spawned task | 克隆值以供任务使用
    let project_path_clone = project_path.clone();
    let app_clone = app.clone();

    // Spawn file watcher task | 启动文件监视任务
    tokio::spawn(async move {
        // Create notify watcher | 创建 notify 监视器
        let (tx, rx) = channel();

        let mut watcher = match RecommendedWatcher::new(
            move |res: Result<Event, notify::Error>| {
                if let Ok(event) = res {
                    let _ = tx.send(event);
                }
            },
            Config::default().with_poll_interval(Duration::from_millis(500)),
        ) {
            Ok(w) => w,
            Err(e) => {
                eprintln!("[AssetWatcher] Failed to create watcher: {}", e);
                return;
            }
        };

        // Start watching all directories | 开始监视所有目录
        for (path, dir_name) in &watch_paths {
            if let Err(e) = watcher.watch(path, RecursiveMode::Recursive) {
                eprintln!("[AssetWatcher] Failed to watch {}: {}", dir_name, e);
            } else {
                println!("[AssetWatcher] Started watching: {}", path.display());
            }
        }

        // Asset file extensions to monitor | 要监视的资产文件扩展名
        let asset_extensions: std::collections::HashSet<&str> = [
            // Images
            "png", "jpg", "jpeg", "webp", "gif", "bmp", "svg",
            // Audio
            "mp3", "ogg", "wav", "flac", "m4a",
            // Data formats
            "json", "xml", "yaml", "yml", "txt",
            // Custom asset types
            "prefab", "ecs", "btree", "particle", "tmx", "tsx",
            // Scripts (also watch these in assets dir)
            "ts", "tsx", "js", "jsx",
            // Materials and shaders
            "mat", "shader", "glsl", "vert", "frag",
            // Fonts
            "ttf", "otf", "woff", "woff2",
            // 3D assets
            "gltf", "glb", "obj", "fbx",
        ].into_iter().collect();

        // Debounce state | 防抖状态
        let mut pending_events: std::collections::HashMap<String, String> = std::collections::HashMap::new();
        let mut last_event_time = std::time::Instant::now();
        let debounce_duration = Duration::from_millis(300);

        // Event loop | 事件循环
        loop {
            // Check for shutdown | 检查关闭信号
            if shutdown_rx.try_recv().is_ok() {
                println!("[AssetWatcher] Stopping watcher for: {}", project_path_clone);
                break;
            }

            // Check for file events with timeout | 带超时检查文件事件
            match rx.recv_timeout(Duration::from_millis(100)) {
                Ok(event) => {
                    // Filter for asset files | 过滤资产文件
                    let valid_paths: Vec<(String, String)> = event
                        .paths
                        .iter()
                        .filter(|p| {
                            // Skip .meta files | 跳过 .meta 文件
                            if p.to_string_lossy().ends_with(".meta") {
                                return false;
                            }
                            // Check extension | 检查扩展名
                            let ext = p.extension().and_then(|e| e.to_str()).unwrap_or("");
                            asset_extensions.contains(ext.to_lowercase().as_str())
                        })
                        .map(|p| {
                            let path_str = p.to_string_lossy().to_string();
                            let change_type = match event.kind {
                                EventKind::Create(_) => "create",
                                EventKind::Modify(_) => "modify",
                                EventKind::Remove(_) => "remove",
                                _ => "modify",
                            };
                            (path_str, change_type.to_string())
                        })
                        .collect();

                    if !valid_paths.is_empty() {
                        // Only handle create/modify/remove events | 只处理创建/修改/删除事件
                        match event.kind {
                            EventKind::Create(_) | EventKind::Modify(_) | EventKind::Remove(_) => {
                                for (path, change_type) in valid_paths {
                                    pending_events.insert(path, change_type);
                                }
                                last_event_time = std::time::Instant::now();
                            }
                            _ => continue,
                        };
                    }
                }
                Err(std::sync::mpsc::RecvTimeoutError::Timeout) => {
                    // Check if we should emit pending events (debounce) | 检查是否应该发送待处理事件（防抖）
                    if !pending_events.is_empty() && last_event_time.elapsed() >= debounce_duration {
                        // Group by change type | 按变更类型分组
                        let mut by_type: std::collections::HashMap<String, Vec<String>> = std::collections::HashMap::new();
                        for (path, change_type) in pending_events.drain() {
                            by_type.entry(change_type).or_default().push(path);
                        }

                        // Emit events for each type | 为每种类型发送事件
                        for (change_type, paths) in by_type {
                            let file_event = FileChangeEvent {
                                change_type,
                                paths,
                            };

                            println!("[AssetWatcher] File change detected (debounced): {:?}", file_event);

                            // Emit event to frontend | 向前端发送事件
                            if let Err(e) = app_clone.emit("user-code:file-changed", file_event) {
                                eprintln!("[AssetWatcher] Failed to emit event: {}", e);
                            }
                        }
                    }
                }
                Err(std::sync::mpsc::RecvTimeoutError::Disconnected) => {
                    println!("[AssetWatcher] Watcher channel disconnected");
                    break;
                }
            }
        }
    });

    // Store watcher handle | 存储监视器句柄
    {
        let mut watchers = watcher_state.watchers.lock().await;
        watchers.insert(
            watcher_key.clone(),
            crate::state::WatcherHandle { shutdown_tx },
        );
    }

    println!("[AssetWatcher] Watch started for directories: {:?}", directories);
    Ok(())
}

/// Stop watching for file changes.
/// 停止监视文件变更。
#[command]
pub async fn stop_watch_scripts(
    watcher_state: State<'_, ScriptWatcherState>,
    project_path: Option<String>,
) -> Result<(), String> {
    let mut watchers = watcher_state.watchers.lock().await;

    match project_path {
        Some(path) => {
            // Stop specific watcher | 停止特定监视器
            if let Some(handle) = watchers.remove(&path) {
                let _ = handle.shutdown_tx.send(());
                println!("[UserCode] Stopped watching: {}", path);
            }
        }
        None => {
            // Stop all watchers | 停止所有监视器
            for (path, handle) in watchers.drain() {
                let _ = handle.shutdown_tx.send(());
                println!("[UserCode] Stopped watching: {}", path);
            }
        }
    }

    Ok(())
}

/// Find esbuild executable path (deprecated, use find_esbuild_with_source).
/// 查找 esbuild 可执行文件路径（已弃用，使用 find_esbuild_with_source）。
///
/// Kept for backward compatibility - returns just the command string.
/// 保留用于向后兼容 - 仅返回命令字符串。
fn find_esbuild(project_root: &str) -> Result<EsbuildInfo, String> {
    find_esbuild_with_source(Some(project_root))
}

/// Parse esbuild error output.
/// 解析 esbuild 错误输出。
fn parse_esbuild_errors(stderr: &str) -> Vec<CompileError> {
    let mut errors = Vec::new();

    // Simple error parsing - esbuild outputs errors in a specific format
    // 简单的错误解析 - esbuild 以特定格式输出错误
    for line in stderr.lines() {
        if line.contains("error:") || line.contains("Error:") {
            // Try to parse file:line:column format | 尝试解析 file:line:column 格式
            let parts: Vec<&str> = line.splitn(2, ": ").collect();

            if parts.len() == 2 {
                let location = parts[0];
                let message = parts[1].to_string();

                // Parse location (file:line:column) | 解析位置
                let loc_parts: Vec<&str> = location.split(':').collect();

                let (file, line_num, column) = if loc_parts.len() >= 3 {
                    (
                        Some(loc_parts[0].to_string()),
                        loc_parts[1].parse().ok(),
                        loc_parts[2].parse().ok(),
                    )
                } else {
                    (None, None, None)
                };

                errors.push(CompileError {
                    message,
                    file,
                    line: line_num,
                    column,
                });
            } else {
                errors.push(CompileError {
                    message: line.to_string(),
                    file: None,
                    line: None,
                    column: None,
                });
            }
        }
    }

    // If no specific errors found, add the whole stderr as one error
    // 如果没有找到特定错误，将整个 stderr 作为一个错误
    if errors.is_empty() && !stderr.trim().is_empty() {
        errors.push(CompileError {
            message: stderr.to_string(),
            file: None,
            line: None,
            column: None,
        });
    }

    errors
}