run-rs 0.2.25

//! Value helpers shared by the VM and the bridges. Coercion into annotated
//! types, indexing, field access, the `?` operator, casts, and iteration. These
//! carry no control flow, the VM drives that.

use std::rc::Rc;

use anyhow::{Result, anyhow, bail};

use super::Interp;
use super::numeric::{float_to_int, truncate};
use super::typeir::{CastIr, TypeIr, lower_type};
use super::value::{KeyRef, Map, MapKind, StructShape, Value};

/// Field layout of a user struct, built once per struct and reused for every
/// coerced instance so field names are shared instead of re-allocated.
pub(super) struct Shape {
    /// Runtime layout shared by every instance built from this shape.
    pub runtime: Rc<StructShape>,
    /// Per field, its lowered type when coercion can change the value. None
    /// means coercion is a no-op for the field, skipped per instance.
    pub coerce: Vec<Option<TypeIr>>,
}

/// The exact message a compiled binary panics with on a bad index.
fn oob(len: usize, i: usize) -> anyhow::Error {
    anyhow!("index out of bounds: the len is {len} but the index is {i}")
}

impl Interp {
    /// Turn a dynamic value into `ty` when it reaches a known struct, walking
    /// `Vec<T>` and `Option<T>`. Aliases and smart pointers were already
    /// resolved away by the lowering. Anything else is unchanged.
    pub(super) fn coerce_value(&self, value: Value, ty: &TypeIr) -> Value {
        match ty {
            TypeIr::Dynamic | TypeIr::Generic(_) | TypeIr::MapValue(_) => value,
            TypeIr::Vec(inner) => {
                let Value::Vec(items) = &value else {
                    return value;
                };
                match &**inner {
                    // A struct element type resolves once for the whole vector,
                    // and a primitive element type needs no work at all.
                    TypeIr::Struct(canon) => match self.struct_shape(canon) {
                        Some(shape) => Value::vec(
                            items
                                .borrow()
                                .iter()
                                .map(|v| match v {
                                    Value::Map(m, _) => self.struct_from_map(&shape, &m.borrow()),
                                    other => other.clone(),
                                })
                                .collect(),
                        ),
                        None => value,
                    },
                    TypeIr::Vec(_) | TypeIr::Option(_) | TypeIr::Set(_) => Value::vec(
                        items
                            .borrow()
                            .iter()
                            .map(|v| self.coerce_value(v.clone(), inner))
                            .collect(),
                    ),
                    TypeIr::Dynamic | TypeIr::Generic(_) | TypeIr::MapValue(_) => value,
                }
            }
            TypeIr::Set(inner) => {
                // A map-shaped value only needs the set tag. A `collect()`
                // lands here as a Vec and packs into the shared map storage.
                if let Value::Map(m, _) = &value {
                    return Value::Map(m.clone(), MapKind::Set);
                }
                let Value::Vec(items) = &value else {
                    return value;
                };
                let mut set = Map::default();
                for v in items.borrow().iter() {
                    // An element that cannot be a key leaves the value alone,
                    // the give-up path every other coercion takes.
                    let Some(key) = self.coerce_value(v.clone(), inner).into_key() else {
                        return value.clone();
                    };
                    set.insert(key, Value::Unit);
                }
                Value::set_of(set)
            }
            TypeIr::Option(inner) => {
                if let Value::Enum {
                    enum_name,
                    variant,
                    data,
                } = &value
                    && &**enum_name == "Option"
                    && &**variant == "Some"
                {
                    let coerced =
                        self.coerce_value(data.first().cloned().unwrap_or(Value::Unit), inner);
                    return Value::some(coerced);
                }
                value
            }
            TypeIr::Struct(canon) => {
                if let Value::Map(map, _) = &value
                    && let Some(shape) = self.struct_shape(canon)
                {
                    return self.struct_from_map(&shape, &map.borrow());
                }
                value
            }
        }
    }

    /// If `value` is `Ok(x)` coerce `x`, otherwise coerce `value` directly.
    pub(super) fn coerce_result(&self, value: Value, ty: &TypeIr) -> Value {
        if let Value::Enum {
            enum_name,
            variant,
            data,
        } = &value
            && &**enum_name == "Result"
            && &**variant == "Ok"
        {
            let inner = data.first().cloned().unwrap_or(Value::Unit);
            return Value::ok(self.coerce_value(inner, ty));
        }
        self.coerce_value(value, ty)
    }

    /// Cached field layout for a known struct, by canonical name.
    pub(super) fn struct_shape(&self, canon: &str) -> Option<Rc<Shape>> {
        if let Some(shape) = self.shapes.borrow().get(canon) {
            return Some(shape.clone());
        }
        let def = self.structs().get(canon)?;
        let module = def.module;
        let def = def.ast.clone();
        let canon: Rc<str> = Rc::from(canon);
        let mut fields: Vec<Rc<str>> = Vec::new();
        let mut renames: Vec<Option<Rc<str>>> = Vec::new();
        let mut coerce = Vec::new();
        let rule = super::json_bridge::serde_rename_all(&def.attrs);
        if let syn::Fields::Named(named) = &def.fields {
            for f in &named.named {
                let Some(ident) = &f.ident else { continue };
                fields.push(ident.to_string().into());
                // A field's own rename wins over the container rule.
                renames.push(
                    super::json_bridge::serde_rename(f)
                        .or_else(|| rule.map(|r| r.apply(&ident.to_string())))
                        .map(Rc::from),
                );
                // Field types resolve where the struct is declared, with no
                // function generics in scope.
                let ir = lower_type(&f.ty, self.resolver(), module, &[]);
                coerce.push(ir.is_active().then_some(ir));
            }
        }
        let shape = Rc::new(Shape {
            runtime: StructShape::with_renames(canon.clone(), fields, renames),
            coerce,
        });
        self.shapes.borrow_mut().insert(canon, shape.clone());
        Some(shape)
    }

    pub(super) fn struct_from_map(&self, shape: &Shape, map: &Map) -> Value {
        let mut values = Vec::with_capacity(shape.coerce.len());
        for (fname, ty) in shape.runtime.fields.iter().zip(&shape.coerce) {
            let raw = map
                .get(&KeyRef::Str(fname))
                .cloned()
                .unwrap_or_else(Value::none);
            let coerced = match ty {
                Some(t) => self.coerce_value(raw, t),
                None => raw,
            };
            values.push(coerced);
        }
        Value::structure(shape.runtime.clone(), values)
    }

    pub(super) fn eval_try(&self, v: Value) -> Result<std::result::Result<Value, Value>> {
        match v {
            Value::Enum {
                enum_name,
                variant,
                data,
            } if &*enum_name == "Result" => {
                let inner = data.first().cloned().unwrap_or(Value::Unit);
                if &*variant == "Ok" {
                    Ok(Ok(inner))
                } else {
                    Ok(Err(Value::err(inner)))
                }
            }
            Value::Enum {
                enum_name,
                variant,
                data,
            } if &*enum_name == "Option" => {
                let inner = data.first().cloned().unwrap_or(Value::Unit);
                if &*variant == "Some" {
                    Ok(Ok(inner))
                } else {
                    Ok(Err(Value::none()))
                }
            }
            // A json accessor hands its value back already unwrapped, a json
            // string is a plain String here. Let `?` pass it through as its
            // own Some, the rule match, if let, and or_else already follow,
            // see the json_option example. Scripts pass a real cargo check,
            // so `?` never reaches a value that is not Option or Result in
            // the source types.
            other => Ok(Ok(other)),
        }
    }

    /// An `as` cast to a named primitive type, with real Rust semantics per
    /// width: integer casts truncate, float to integer casts saturate, and
    /// f32 becomes a real f32 value.
    pub(super) fn eval_cast(&self, v: Value, target: &CastIr) -> Result<Value> {
        let width = match target {
            CastIr::F64 => {
                return Ok(Value::Float(match v {
                    Value::Int(i) => i as f64,
                    Value::IntW(..) => v.int_parts().unwrap().0 as f64,
                    Value::Float(f) => f,
                    Value::F32(f) => f64::from(f),
                    other => bail!("cannot cast {} to float", other.type_name()),
                }));
            }
            CastIr::F32 => {
                return Ok(Value::F32(match v {
                    Value::Int(i) => i as f32,
                    Value::IntW(..) => v.int_parts().unwrap().0 as f32,
                    Value::Float(f) => f as f32,
                    Value::F32(f) => f,
                    other => bail!("cannot cast {} to float", other.type_name()),
                }));
            }
            CastIr::Char => {
                return Ok(match v {
                    Value::Int(i) => Value::Char(
                        char::from_u32(i as u32).ok_or_else(|| anyhow!("invalid char code {i}"))?,
                    ),
                    Value::Char(c) => Value::Char(c),
                    other => bail!("cannot cast {} to char", other.type_name()),
                });
            }
            CastIr::Unsupported(name) => bail!("unsupported cast target: {name}"),
            CastIr::Int(width) => *width,
        };
        let value = match v {
            Value::Int(i) => truncate(i128::from(i), width),
            Value::IntW(..) => truncate(v.int_parts().unwrap().0, width),
            Value::Float(f) => float_to_int(f, width),
            // The f64 image of an f32 is the same real number, so saturating
            // through it is exact.
            Value::F32(f) => float_to_int(f64::from(f), width),
            Value::Char(c) => truncate(i128::from(c as u32), width),
            Value::Bool(b) => i128::from(b),
            other => bail!("cannot cast {} to integer", other.type_name()),
        };
        Ok(Value::int_of_width(value, width))
    }

    // -- indexing and fields ----------------------------------------------

    pub(super) fn index(&self, base: &Value, key: &Value) -> Result<Value> {
        if let Value::Range {
            start,
            end,
            inclusive,
        } = key
        {
            return slice_value(base, *start, *end, *inclusive);
        }
        Ok(match base {
            Value::Vec(items) => {
                let i = as_index(key)?;
                let items = items.borrow();
                items.get(i).cloned().ok_or_else(|| oob(items.len(), i))?
            }
            Value::Str(s) => {
                let i = as_index(key)?;
                s.chars()
                    .nth(i)
                    .map(Value::Char)
                    .ok_or_else(|| oob(s.chars().count(), i))?
            }
            Value::Tuple(items) => {
                let i = as_index(key)?;
                let items = items.borrow();
                items.get(i).cloned().ok_or_else(|| oob(items.len(), i))?
            }
            Value::Map(map, _) => {
                let k = key
                    .key_ref()
                    .ok_or_else(|| anyhow!("{} is not a valid map key", key.type_name()))?;
                map.borrow()
                    .get(&k)
                    .cloned()
                    .ok_or_else(|| anyhow!("no entry found for key"))?
            }
            Value::Native(handle)
                if matches!(&*handle.borrow(), super::native::Native::RegexCaptures(_)) =>
            {
                super::regex_bridge::capture_index(handle, key)?
            }
            other => bail!("cannot index {}", other.type_name()),
        })
    }

    pub(super) fn set_index(&self, base: &Value, key: &Value, val: Value) -> Result<()> {
        match base {
            Value::Vec(items) => {
                let i = as_index(key)?;
                let mut items = items.borrow_mut();
                if i >= items.len() {
                    return Err(oob(items.len(), i));
                }
                items[i] = val;
            }
            Value::Map(map, _) => {
                let k = key
                    .as_key()
                    .ok_or_else(|| anyhow!("{} is not a valid map key", key.type_name()))?;
                map.borrow_mut().insert(k, val);
            }
            other => bail!("cannot index-assign into {}", other.type_name()),
        }
        Ok(())
    }

    pub(super) fn get_field(
        &self,
        base: &Value,
        member: &super::bytecode::Member,
    ) -> Result<Value> {
        use super::bytecode::Member;
        match (base, member) {
            (Value::Struct(s), Member::Named(name)) => {
                s.get(name).ok_or_else(|| anyhow!("no field `{name}`"))
            }
            (Value::Tuple(items), Member::Indexed(i)) => items
                .borrow()
                .get(*i)
                .cloned()
                .ok_or_else(|| anyhow!("no field `{i}`")),
            (Value::Struct(s), Member::Indexed(i)) => s
                .values
                .borrow()
                .get(*i)
                .cloned()
                .ok_or_else(|| anyhow!("no field `{i}`")),
            (b, _) => bail!("cannot access field of {}", b.type_name()),
        }
    }

    pub(super) fn set_field(
        &self,
        base: &Value,
        member: &super::bytecode::Member,
        val: Value,
    ) -> Result<()> {
        use super::bytecode::Member;
        match (base, member) {
            (Value::Struct(s), Member::Named(name)) => {
                if !s.set(name, val) {
                    bail!("no field `{name}`");
                }
            }
            (Value::Struct(s), Member::Indexed(i)) => {
                let mut values = s.values.borrow_mut();
                match values.get_mut(*i) {
                    Some(slot) => *slot = val,
                    None => bail!("no field `{i}`"),
                }
            }
            (Value::Tuple(items), Member::Indexed(i)) => {
                items.borrow_mut()[*i] = val;
            }
            (b, _) => bail!("cannot assign to field of {}", b.type_name()),
        }
        Ok(())
    }
}

fn as_index(key: &Value) -> Result<usize> {
    match key {
        Value::Int(i) if *i >= 0 => Ok(*i as usize),
        Value::Int(i) => bail!("negative index {i}"),
        Value::IntW(..) => {
            let (v, _) = key.int_parts().unwrap();
            usize::try_from(v).map_err(|_| anyhow!("index {v} out of range"))
        }
        other => bail!("index must be an integer, got {}", other.type_name()),
    }
}

/// `v[a..b]` on vectors and byte-based `s[a..b]` on strings, matching real
/// slice semantics. An i64::MAX end is the open-end sentinel meaning len.
fn slice_value(base: &Value, start: i64, end: i64, inclusive: bool) -> Result<Value> {
    let bounds = |len: usize| -> Result<(usize, usize)> {
        if start < 0 {
            bail!("negative slice start {start}");
        }
        let end = if end == i64::MAX {
            len as i64
        } else if inclusive {
            end + 1
        } else {
            end
        };
        if end < start || end as usize > len {
            bail!("slice {start}..{end} out of bounds (len {len})");
        }
        Ok((start as usize, end as usize))
    };
    match base {
        Value::Vec(items) => {
            let items = items.borrow();
            let (a, b) = bounds(items.len())?;
            Ok(Value::vec(items[a..b].to_vec()))
        }
        Value::Str(s) => {
            let (a, b) = bounds(s.len())?;
            match s.get(a..b) {
                Some(sub) => Ok(Value::str(sub.to_string())),
                None => bail!("slice {a}..{b} is not on a char boundary"),
            }
        }
        other => bail!("cannot slice {}", other.type_name()),
    }
}