use std::hash::{Hash, Hasher}; use oxide_kernel::shape_forge::EMPTY_SHAPE_ID; use oxide_types::object::JsObject; use oxide_types::value::JsValue; use oxide_runtime_api::{NativeResult, VmHost}; macro_rules! native_try { ($expr:expr) => { match $expr { Ok(value) => value, Err(err) => return NativeResult::Err(err), } }; } /// Set/Map 的键包装:用 SameValue 语义比较(NaN 视为相同、±0 视为相同), /// 非 double 值按原始位比较。 #[derive(Clone, Copy)] pub struct SetKey(pub JsValue); impl PartialEq for SetKey { fn eq(&self, other: &Self) -> bool { if self.0.is_double() && other.0.is_double() { let a = self.0.as_double(); let b = other.0.as_double(); if a.is_nan() && b.is_nan() { return true; } if a == 0.0 && b == 0.0 { return true; } return a == b; } // SAFETY: JsValue 是 8 字节 NaN-box Copy 值;此处以原始位定义非 double 值的同一性。 unsafe { std::mem::transmute::(self.0) == std::mem::transmute::(other.0) } } } impl Eq for SetKey {} impl Hash for SetKey { fn hash(&self, state: &mut H) { if self.0.is_double() { let d = self.0.as_double(); if d.is_nan() { 0u64.hash(state); } else if d == 0.0 { 0.0f64.to_bits().hash(state); } else { d.to_bits().hash(state); } } else { // SAFETY: JsValue 是 8 字节 NaN-box Copy 值;哈希原始位与上面的相等判定一致。 unsafe { std::mem::transmute::(self.0).hash(state) } } } } pub(crate) type SetInner = indexmap::IndexSet; /// 取出 Set 对象 native-data 槽中存储的 `IndexSet` 指针。 /// /// # 调用方维护的安全性契约 /// /// 指针在 Set `JsObject` 存活期间有效:`JsObject` 分配于当前 `Epoch` arena, /// native builtin 执行期间不会调用 `Epoch::reset()`。持有分配的 /// `Box` 由 `new_set_inner()` 创建,Set 生命周期内不释放。 /// native 调用为单线程,同一 Set 对象同时至多存在一个活 `*mut` 别名。 fn get_set_inner(vm: &mut H, this_val: JsValue) -> Result<*mut SetInner, JsValue> { if !this_val.is_object() { return Err(crate::error::create_type_error(vm, "called on non-Set object")); } let set_ptr = this_val.as_js_object_ptr(); if set_ptr.is_null() { return Err(crate::error::create_type_error(vm, "Set internal state invalid")); } // SAFETY: set_ptr 是当前 Epoch bump 分配的 JsObject 的非空、对齐指针, // 本调用期间有效。 let set_obj = unsafe { &*set_ptr }; if !set_obj.is_set() { return Err(crate::error::create_type_error(vm, "Set.prototype.add called on incompatible receiver")); } // SAFETY: native_data 持有 `alloc_set` 写入的裸指针,即有效的 // 堆分配 `Box>`;IndexSet 至多要求 8 字节对齐, // 全局分配器满足该要求。 let inner_ptr = set_obj.native_data() as *mut SetInner; if inner_ptr.is_null() { return Err(crate::error::create_type_error(vm, "Set internal state invalid")); } Ok(inner_ptr) } fn new_set_inner() -> *mut SetInner { Box::into_raw(Box::new(SetInner::new())) } fn alloc_set(vm: &mut H) -> *mut JsObject { let set_proto = vm.session().builtin_world().set_proto.as_ptr() as *mut JsObject; let mut obj = JsObject::new_empty(EMPTY_SHAPE_ID, JsValue::from_js_object(set_proto)); obj.set_set(true); let inner = new_set_inner(); obj.set_native_data(inner as *mut u8); vm.alloc_object(obj) } /// 收集 Set 中作为对象引用的元素(GC 根边),供跨 epoch 遍历/重写时追踪。 pub fn set_native_edges(obj: &JsObject) -> Vec { if !obj.is_set() { return Vec::new(); } let inner = obj.native_data() as *const SetInner; if inner.is_null() { return Vec::new(); } unsafe { (*inner) .iter() .map(|key| key.0) .filter(|value: &JsValue| value.is_object()) .collect() } } /// 克隆 Set 的 native 数据到新对象,用 `rewrite` 改写其中的对象引用。 pub fn clone_set_native_with_rewrite(src: &JsObject, dst: &mut JsObject, mut rewrite: F) where F: FnMut(JsValue) -> JsValue, { if !src.is_set() { return; } let inner = src.native_data() as *const SetInner; if inner.is_null() { dst.set_native_data(std::ptr::null_mut()); return; } let mut cloned = SetInner::new(); unsafe { for key in (*inner).iter() { let new_key = if key.0.is_object() { SetKey(rewrite(key.0)) } else { *key }; cloned.insert(new_key); } } dst.set_native_data(Box::into_raw(Box::new(cloned)) as *mut u8); } /// 原地重写 Set 的 native 数据,用 `rewrite` 改写其中的对象引用。 pub fn rewrite_set_native(obj: &mut JsObject, mut rewrite: F) where F: FnMut(JsValue) -> JsValue, { if !obj.is_set() { return; } let inner = obj.native_data() as *mut SetInner; if inner.is_null() { return; } unsafe { let mut rewritten = SetInner::with_capacity((*inner).len()); for key in (*inner).iter() { let new_key = if key.0.is_object() { SetKey(rewrite(key.0)) } else { *key }; rewritten.insert(new_key); } *inner = rewritten; } } /// 释放 Set 的 native 数据(IndexSet),返回释放的字节数供泄漏统计。 pub fn drop_set_native(obj: &mut JsObject) -> u64 { if !obj.is_set() { return 0; } let inner = obj.native_data() as *mut SetInner; if inner.is_null() { return 0; } unsafe { let boxed: Box = Box::from_raw(inner); let bytes = std::mem::size_of::() + boxed.capacity() * std::mem::size_of::(); drop(boxed); obj.set_native_data(std::ptr::null_mut()); bytes as u64 } } /// `Set` 构造函数:创建带空 IndexSet native 数据的 Set 对象。 pub fn set_constructor(vm: &mut H, _args: &[u8]) -> NativeResult { let set_obj = alloc_set(vm); NativeResult::Ok(JsValue::from_js_object(set_obj)) } /// `Set.prototype.add(value)`:插入元素,返回 this。 pub fn set_add(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let inner = native_try!(get_set_inner(vm, this_val)); let val = vm.reg(if args.len() > 1 { args[1] } else { 0 }); unsafe { (*inner).insert(SetKey(val)); } NativeResult::Ok(this_val) } /// `Set.prototype.has(value)`:元素是否存在。 pub fn set_has(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let inner = native_try!(get_set_inner(vm, this_val)); let val = vm.reg(if args.len() > 1 { args[1] } else { 0 }); let found = unsafe { (*inner).contains(&SetKey(val)) }; NativeResult::Ok(JsValue::bool(found)) } /// `Set.prototype.delete(value)`:删除元素并返回是否删除成功。 pub fn set_delete(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let inner = native_try!(get_set_inner(vm, this_val)); let val = vm.reg(if args.len() > 1 { args[1] } else { 0 }); let removed = unsafe { (*inner).shift_remove(&SetKey(val)) }; NativeResult::Ok(JsValue::bool(removed)) } /// `Set.prototype.clear()`:清空全部元素,返回 undefined。 pub fn set_clear(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let inner = native_try!(get_set_inner(vm, this_val)); unsafe { (*inner).clear(); } NativeResult::Ok(JsValue::undefined()) } /// `Set.prototype.size` getter:返回元素数量。 pub fn set_size(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let inner = native_try!(get_set_inner(vm, this_val)); NativeResult::Ok(JsValue::float(unsafe { (*inner).len() } as f64)) } /// `Set.prototype.entries()`:返回按插入序迭代 `[value, value]` 对的迭代器。 pub fn set_entries(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let _inner = native_try!(get_set_inner(vm, this_val)); NativeResult::Ok(crate::iterator::make_mode_iterator( vm, this_val, crate::iterator::set_entries_iter_next:: as *const (), )) } /// `Set.prototype.values()`:返回按插入序迭代值的迭代器。 pub fn set_values(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let _inner = native_try!(get_set_inner(vm, this_val)); NativeResult::Ok(crate::iterator::make_mode_iterator( vm, this_val, crate::iterator::set_values_iter_next:: as *const (), )) } /// `Set.prototype.keys()`:别名 `values()`(Set 无独立键),返回同样的迭代器。 pub fn set_keys(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let _inner = native_try!(get_set_inner(vm, this_val)); // Set 的 keys() 是 values() 的别名——返回同样的逐元素迭代器。 NativeResult::Ok(crate::iterator::make_mode_iterator( vm, this_val, crate::iterator::set_values_iter_next:: as *const (), )) }