docs: clarify UI bridge continuation and publication boundaries
This commit is contained in:
@@ -5,6 +5,8 @@
|
||||
//! Function.owner 保存绑定对象,requested_type 保存原生子类构造请求;本文件 args 只包含显式原生参数。
|
||||
//! 简单分支同步返回 NativeResult::Return;需要执行源协议/事件处理器的分支返回 Invoke,让 VM 接着推进调用栈。
|
||||
//! NativeContext 追踪本次分配和 upgrade 的临时根,返回/委托时提升输出引用,其余在域退出时释放。
|
||||
//! 下面的提前返回按能力分层:相机/场景、查询/状态、构造、展示协议先处理,最后才要求 Block owner 并克隆 Data。
|
||||
//! 这不是统一回滚事务:有些分支会先写托管属性或窗口注册表,末尾 replace_payload 只提交仍需写回的结构副本。
|
||||
use super::*;
|
||||
|
||||
impl NativeCallable for Function {
|
||||
@@ -641,6 +643,8 @@ impl NativeCallable for Function {
|
||||
vec![desktop],
|
||||
))?;
|
||||
// 小驱动先调用 present(value, window),再把结果交 PresentResult 验证/可选打开,所有委托共用当前 VM 预算。
|
||||
// 两个 PushNull 填 Call 的空接收者槽,避免 VM 额外插入 receiver;value/window 已作为 present 的两个显式参数加载。
|
||||
// 栈先保留 complete 的调用,再嵌套两参 present,最后把其结果作 complete 的一个参数,形成验证续接。
|
||||
let instructions = [
|
||||
endor_core::Instruction::new(endor_core::Opcode::LoadConst, 0),
|
||||
endor_core::Instruction::simple(endor_core::Opcode::PushNull),
|
||||
@@ -748,6 +752,7 @@ impl NativeCallable for Function {
|
||||
}
|
||||
// 接收者可能是共享转发别名,解析到最终 Data 后修改副本,最后用一次 replace_payload 写入结构边。
|
||||
let (data_ref, data) = block::resolve(cx.store(), owner)?;
|
||||
// data_ref 是最终 Data,不是 owner 包装或它的 Cell;新子组成用此身份防回边,末尾也替换这一对象的 payload。
|
||||
// 在副本上编辑结构,再经末尾 replace_payload 更新强边与版本,避免直接篡改借用 payload。
|
||||
let mut data = data.clone();
|
||||
// 默认返回 Unit/Nil,append/insert/订阅等分支会改成自己的业务结果;查询分支直接返回。
|
||||
@@ -899,6 +904,7 @@ impl NativeCallable for Function {
|
||||
return Ok(NativeResult::Return(Value::Nil));
|
||||
}
|
||||
// 后退/前进钳到历史首尾,复用已保留根对象而非重新执行旧源码。
|
||||
// 这里不增删历史;导航根通过 Data.trace 保活,show 仅安排后续刷新,不立即切换 active 或产生 Mount。
|
||||
let next = if matches!(self.operation, Back) {
|
||||
// saturating_sub 在首项停住,不绕回列表尾部。
|
||||
data.history_index.saturating_sub(1)
|
||||
@@ -1089,6 +1095,7 @@ impl NativeCallable for Function {
|
||||
_ => return Err(invalid("unsupported Block operation")),
|
||||
}
|
||||
// 非提前返回的结构编辑/订阅操作在末尾统一经过写屏障,触发拥有边更新和变更日志。
|
||||
// 只覆盖解析到的 Data;原 Block/Cell 身份保持,所有转发到同一 Data 的别名因此观察到本次结构修改。
|
||||
cx.replace_payload(data_ref, data)?;
|
||||
Ok(NativeResult::Return(result))
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user