yog-api 0.103.0

//! Injections (`#[inject]`, `docs/design/nanites.md`): what a mod hooks,
//! known before the game's classes load — the runtime asks the mod's
//! library for them (`yog_mod_nanites`) — and its handlers, subscribed when
//! the mod registers to the point's keyed event.

use yog_event::nanite::{Inject, Injected, Nanites, point};
use yog_sync::Mutex;

use super::{Java, Member, Nanite};
use crate::Registry;

/// A declared nanite: its kind, its member, where in it, its handler.
pub struct InjectEntry {
    /// `yog_ids::nanite_kind`.
    pub kind: &'static str,
    pub member: &'static Member,
    /// `yog_ids::mixin_at`.
    pub at: &'static str,
    /// What an `INVOKE`/`FIELD`/`NEW` at names, else empty.
    pub target: &'static str,
    pub ordinal: i32,
    /// `yog_ids::mixin_shift`.
    pub shift: &'static str,
    pub cancellable: bool,
    /// Among the point's handlers (higher first).
    pub priority: i32,
    /// A `modify_arg`'s argument, a `modify_variable`'s local (-1: by type).
    pub index: i32,
    /// A `modify_constant`'s constant (`int:5`).
    pub constant: &'static str,
    /// A `modify_variable`'s local's type (a descriptor, Mojang's).
    pub value_desc: &'static str,
    /// A `FIELD` redirect's write, else its read.
    pub write: bool,
    /// The locals an inject asks for (`"F, &I@1"`, `yog_ids::nanite_local`).
    pub locals: &'static str,
    /// None for what has no code of the mod's (an added field, an interface).
    pub handler: Option<fn(&mut Hook)>,
}

impl InjectEntry {
    /// What the host makes of it.
    pub fn spec(&self) -> Inject {
        let (method, desc) = self.member.signature();
        let class = self.member.class();
        let mut spec = Inject {
            point: String::new(),
            kind: self.kind.to_owned(),
            class: class.to_owned(),
            method: method.to_owned(),
            desc,
            at: self.at.to_owned(),
            target: self.target.to_owned(),
            ordinal: self.ordinal,
            shift: self.shift.to_owned(),
            cancellable: self.cancellable,
            index: self.index,
            constant: self.constant.to_owned(),
            value_desc: self.value_desc.to_owned(),
            write: self.write,
            locals: self
                .locals
                .split(yog_ids::nanite_local::LIST)
                .map(str::trim)
                .filter(|l| !l.is_empty())
                .map(str::to_owned)
                .collect(),
        };
        spec.point = point(&spec);
        spec
    }
}

/// What a redirect's original call is: a `Function` of its arguments.
const ORIGINAL_CLASS: &str = "java.util.function.Function";
const ORIGINAL_METHOD: &str = "apply";

fn original_desc() -> String {
    let object = super::java::class_desc("java.lang.Object");
    super::method_desc(std::slice::from_ref(&object), &object)
}

/// This mod's injections (each `#[inject]`'s `ctor` adds its own).
#[doc(hidden)]
pub fn __yog_nanite_registry() -> &'static Mutex<Vec<InjectEntry>> {
    static REG: Mutex<Vec<InjectEntry>> = Mutex::new(Vec::new());
    &REG
}

/// A declaration with no handler (an added field, an interface): its kind,
/// member, target.
#[doc(hidden)]
pub fn __declare(kind: &'static str, member: &'static Member, target: &'static str) {
    __yog_nanite_registry().lock().push(InjectEntry {
        kind,
        member,
        at: "",
        target,
        ordinal: -1,
        shift: "",
        cancellable: false,
        priority: 0,
        index: -1,
        constant: "",
        value_desc: "",
        write: false,
        locals: "",
        handler: None,
    });
}

/// Every injection of this mod, as the runtime asks before the game loads.
#[doc(hidden)]
pub fn __yog_nanites() -> Vec<u8> {
    let injects = __yog_nanite_registry()
        .lock()
        .iter()
        .map(InjectEntry::spec)
        .collect();
    yog_data::to_bytes(&Nanites { injects })
}

/// A handler to subscribe: its point, priority, function.
type Subscription = (String, i32, fn(&mut Hook));

/// Each injection's handler on its point (when the mod registers).
pub fn subscribe(registry: &mut Registry) {
    let entries: Vec<Subscription> = __yog_nanite_registry()
        .lock()
        .iter()
        .filter_map(|e| Some((e.spec().point, e.priority, e.handler?)))
        .collect();
    for (key, priority, handler) in entries {
        registry.change_key_at::<Injected>(&key, priority, move |e, _| handler(&mut Hook(e)));
    }
}

/// An injection point reached, as a handler sees it.
pub struct Hook<'a>(&'a mut Injected);

impl<'a> Hook<'a> {
    /// The point reached, to be changed.
    pub fn new(e: &'a mut Injected) -> Self {
        Hook(e)
    }

    /// The object the method runs on (none in a static one).
    pub fn this<T: Nanite>(&self) -> Option<T> {
        T::from_value(self.0.this.clone())
    }

    /// Argument `i`.
    pub fn arg<T: Java>(&self, i: usize) -> Option<T> {
        T::from_value(self.0.args.get(i)?.clone())
    }

    /// How many arguments there are.
    pub fn args(&self) -> usize {
        self.0.args.len()
    }

    /// The value returned, at a `RETURN`.
    pub fn value<T: Java>(&self) -> Option<T> {
        T::from_value(self.0.value.clone())
    }

    /// Stops the method (a cancellable injection's).
    pub fn cancel(&mut self) {
        self.0.cancelled = true;
    }

    /// Stops the method returning `value`.
    pub fn set_return<T: Java>(&mut self, value: T) {
        self.0.value = value.to_value();
        self.0.cancelled = true;
        self.0.returned = true;
    }

    /// Makes `value` the answer: a modified value, a redirected call's result.
    pub fn set_value<T: Java>(&mut self, value: T) {
        self.0.value = value.to_value();
        self.0.returned = true;
    }

    /// Runs a redirected call as it was, with `args` (the receiver first): its result.
    pub fn call_original(&self, args: Vec<yog_data::Value>) -> Option<yog_data::Value> {
        static APPLY: Member = Member::new(ORIGINAL_CLASS, ORIGINAL_METHOD, original_desc);
        APPLY.call(self.0.original.clone(), vec![yog_data::Value::List(args)])
    }

    /// Local `i` of those the inject asked for.
    pub fn local<T: Java>(&self, i: usize) -> Option<T> {
        T::from_value(self.0.locals.get(i)?.clone())
    }

    /// Sets local `i` (one the inject asked to write: `&` in `locals`).
    pub fn set_local<T: Java>(&mut self, i: usize, value: T) {
        if let Some(slot) = self.0.locals.get_mut(i) {
            *slot = value.to_value();
        }
    }

    /// Whether a handler before this one stopped it.
    pub fn cancelled(&self) -> bool {
        self.0.cancelled
    }
}