lua-types 0.0.14

//! `LuaError` and its canonical constructors. PORT_STRATEGY §3.7, PORTING.md §6.

use crate::status::LuaStatus;
use crate::value::LuaValue;
use std::fmt;

/// Internal control-flow payload used by the standalone CLI to implement
/// `os.exit` without making Lua protected calls catch it as an ordinary error.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct LuaExit(pub i32);

/// The Lua error type. Carries a `LuaValue` payload because Lua errors can
/// be any value (typically a string).
#[derive(Debug, Clone)]
pub enum LuaError {
    Runtime(LuaValue),
    Syntax(LuaValue),
    Memory,
    Error,
    Yield,
    File,
    Gc,
}

impl LuaError {
    // ── Generic message constructors ─────────────────────────────────────
    pub fn runtime(args: fmt::Arguments<'_>) -> Self {
        LuaError::Runtime(LuaValue::Str(crate::gc::GcRef::new(
            crate::string::LuaString::from_bytes(format!("{}", args).into_bytes()),
        )))
    }
    pub fn syntax(args: fmt::Arguments<'_>) -> Self {
        LuaError::Syntax(LuaValue::Str(crate::gc::GcRef::new(
            crate::string::LuaString::from_bytes(format!("{}", args).into_bytes()),
        )))
    }
    pub fn syntax_at(args: fmt::Arguments<'_>, source: &[u8], line: i32) -> Self {
        LuaError::Syntax(LuaValue::Str(crate::gc::GcRef::new(
            crate::string::LuaString::from_bytes(
                format!("{}:{}: {}", String::from_utf8_lossy(source), line, args).into_bytes()
            ),
        )))
    }
    pub fn syntax_raw(msg: &[u8]) -> Self {
        LuaError::Syntax(LuaValue::Str(crate::gc::GcRef::new(
            crate::string::LuaString::from_bytes(msg.to_vec()),
        )))
    }

    // ── Standard-shape constructors ──────────────────────────────────────
    pub fn type_error(v: &LuaValue, op: &str) -> Self {
        LuaError::runtime(format_args!("attempt to {} a {} value", op, v.type_name()))
    }
    pub fn call_error(v: &LuaValue) -> Self {
        Self::type_error(v, "call")
    }
    pub fn concat_error(p1: &LuaValue, p2: &LuaValue) -> Self {
        let bad = if matches!(p1, LuaValue::Str(_) | LuaValue::Int(_) | LuaValue::Float(_)) { p2 } else { p1 };
        LuaError::runtime(format_args!("attempt to concatenate a {} value", bad.type_name()))
    }
    pub fn arith_error(p1: &LuaValue, p2: &LuaValue, _msg: &str) -> Self {
        let bad = if matches!(p1, LuaValue::Int(_) | LuaValue::Float(_)) { p2 } else { p1 };
        LuaError::runtime(format_args!("attempt to perform arithmetic on a {} value", bad.type_name()))
    }
    pub fn int_overflow(_p1: &LuaValue, _p2: &LuaValue) -> Self {
        LuaError::runtime(format_args!("number has no integer representation"))
    }
    pub fn order_error(p1: &LuaValue, p2: &LuaValue) -> Self {
        LuaError::runtime(format_args!("attempt to compare {} with {}", p1.type_name(), p2.type_name()))
    }
    pub fn for_error(v: &LuaValue, what: &str) -> Self {
        LuaError::runtime(format_args!("bad 'for' {} (number expected, got {})", what, v.type_name()))
    }
    pub fn arg_error(narg: i32, msg: &str) -> Self {
        LuaError::runtime(format_args!("bad argument #{} ({})", narg, msg))
    }
    pub fn type_arg_error(narg: i32, expected: &str, got: &LuaValue) -> Self {
        LuaError::runtime(format_args!("bad argument #{} ({} expected, got {})", narg, expected, got.type_name()))
    }

    // ── Pass-through constructors ────────────────────────────────────────
    pub fn from_value(v: LuaValue) -> Self {
        // Special-case: the global "not enough memory" string becomes Memory.
        // The real impl checks ptr equality against G(L)->memerrmsg.
        LuaError::Runtime(v)
    }
    pub fn with_status(status: LuaStatus) -> Self {
        match status {
            LuaStatus::Ok        => LuaError::Error,
            LuaStatus::Yield     => LuaError::Yield,
            LuaStatus::ErrRun    => LuaError::Runtime(LuaValue::Nil),
            LuaStatus::ErrSyntax => LuaError::Syntax(LuaValue::Nil),
            LuaStatus::ErrMem    => LuaError::Memory,
            LuaStatus::ErrErr    => LuaError::Error,
            LuaStatus::ErrFile   => LuaError::File,
            LuaStatus::ErrGc     => LuaError::Gc,
        }
    }

    pub fn to_status(&self) -> LuaStatus {
        match self {
            LuaError::Runtime(_) => LuaStatus::ErrRun,
            LuaError::Syntax(_)  => LuaStatus::ErrSyntax,
            LuaError::Memory     => LuaStatus::ErrMem,
            LuaError::Error      => LuaStatus::ErrErr,
            LuaError::Yield      => LuaStatus::Yield,
            LuaError::File       => LuaStatus::ErrFile,
            LuaError::Gc         => LuaStatus::ErrGc,
        }
    }

    pub fn into_value(self) -> LuaValue {
        match self {
            LuaError::Runtime(v) | LuaError::Syntax(v) => v,
            _ => LuaValue::Nil,
        }
    }
}

impl fmt::Display for LuaError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "{:?}", self)
    }
}
impl std::error::Error for LuaError {}

// ──────────────────────────────────────────────────────────────────────────────
// PORT STATUS
//   source:        n/a (Rust-native error enum; no C analogue)
//   target_crate:  lua-types
//   confidence:    high
//   todos:         0
//   port_notes:    0
//   unsafe_blocks: 0
//   notes:         LuaError + supporting variants. Pure Rust idiom (Result<T, LuaError>) replacing
//                  C's setjmp/longjmp error propagation. No direct C-source mapping.
// ──────────────────────────────────────────────────────────────────────────────