docs: clarify layout continuation and runtime refresh cleanup
This commit is contained in:
@@ -6,6 +6,10 @@
|
||||
//! UI 类型与刷新由 bridge 适配;此模块负责源码预算、真实会话、执行结果和挂起刷新的生命周期。
|
||||
//! compile/evaluate 是一次性入口,关闭 Candidate 后只返回纯数据;生产持久路径使用增量入口并保存续体。
|
||||
//! 本模块仍直接依赖 UI Frame/桥接,不是已经可以独立搬走的通用 Nexus runtime,迁移需先抽出宿主接口。
|
||||
//!
|
||||
//! 增量刷新有两层“继续”:ReplSession 保存全窗口 RefreshWork,bridge 保存当前窗口的布局或绘制续体。
|
||||
//! API worker 下一量子恢复前者,step_refresh 再选择同一窗口恢复后者;两层都不重放已经执行的 Console/事件副作用。
|
||||
//! 尺寸目标确实变化才由 retarget_refresh 取消当前视觉续体并重启稳定轮;取消派生几何不会撤销已发生的业务写入。
|
||||
use anyhow::{Result, bail};
|
||||
use endor_core::{ExecutionLimits, ObjectRef, Value, Vm, VmError};
|
||||
use frontend::{
|
||||
@@ -241,6 +245,7 @@ fn compile_plan_with_globals(
|
||||
assigned(s, globals);
|
||||
}
|
||||
if let Some(other) = &b.otherwise {
|
||||
// else 中的潜在绑定也要让后续片段可编译引用,但这里不预先在 globals 字典创建实际值。
|
||||
for s in &other.statements {
|
||||
assigned(s, globals);
|
||||
}
|
||||
@@ -426,6 +431,7 @@ impl ReplSession {
|
||||
viewport: Option<crate::layout::Size>,
|
||||
) -> Result<Self> {
|
||||
if source.len() > MAX_SOURCE_BYTES {
|
||||
// 完整 PUT 候选在创建 VM 前限制原始 UTF-8 字节数,解析/代码生成尚未开始。
|
||||
bail!("source exceeds the 1 MiB limit");
|
||||
}
|
||||
// 来源标注把 API namespace/提交号接入 Aster 错误来源,不改变用户原文。
|
||||
@@ -573,6 +579,7 @@ impl ReplSession {
|
||||
);
|
||||
}
|
||||
if source.len() > MAX_SOURCE_BYTES {
|
||||
// 单次 Console 输入也受原始字节预算约束,不能仅靠下面累计 transcript 预算替代。
|
||||
bail!("input exceeds 1 MiB");
|
||||
}
|
||||
// 持久 Console 限制累计输入次数、源码文本和稍后的 AST 总节点数,用户需显式重置才能重新获得预算。
|
||||
@@ -592,6 +599,7 @@ impl ReplSession {
|
||||
budget.visit_ast_root(ast)?;
|
||||
}
|
||||
if self.ast_nodes + budget.nodes > MAX_AST_NODES {
|
||||
// 此处限制整个持久会话累计结构量;超限发生在记输入号、追加源码和执行用户语句之前。
|
||||
bail!("console session exceeds 10000 AST nodes; reset the session to continue");
|
||||
}
|
||||
// new 已建立的字典继续原地使用,保存对象身份和闭包,不能通过历史源码重放重建它。
|
||||
@@ -633,6 +641,7 @@ impl ReplSession {
|
||||
.push_str(&format!("// Console input {}\n", self.inputs));
|
||||
self.source.push_str(source.text());
|
||||
if !self.source.ends_with('\n') {
|
||||
// transcript 的尾部补换行只服务下一条输入的浏览行号,当前执行仍使用独立 SourceUnit 原文。
|
||||
self.source.push('\n');
|
||||
}
|
||||
// 本轮输入的代码树先使用局部行号,再用 offset 平移到累计源码中的对应位置。
|
||||
@@ -715,6 +724,7 @@ impl ReplSession {
|
||||
self.take_window_commands()?;
|
||||
self.bridge.discard_pending(&mut self.candidate.vm)?;
|
||||
if let Some(node) = self.nodes.last_mut() {
|
||||
// 标记本次已记录的输入节点,保留先前 Sources 记录,不把运行失败误记为从未执行。
|
||||
node.name
|
||||
.push_str(" (error; earlier statements may remain live)");
|
||||
}
|
||||
@@ -825,7 +835,7 @@ impl ReplSession {
|
||||
Err(error) => {
|
||||
self.faulted = true;
|
||||
// 错误时必须显式取消 paint/layout 的 owning VM 续体并恢复检查点,不能仅丢弃 Rust 工作结构。
|
||||
// 进入 paint 后只恢复其原续体和配对文档,不重复布局,也不重跑输入业务语句。
|
||||
// 这里是失败收尾,取消已有 paint 并丢弃配对草稿;只有正常下一量子的 step_refresh 才会恢复 paint。
|
||||
if let Some(paint) = work.paint.take() {
|
||||
self.bridge.cancel_paint_frame(
|
||||
&mut self.candidate.vm,
|
||||
@@ -834,6 +844,7 @@ impl ReplSession {
|
||||
)?;
|
||||
}
|
||||
if let Some(pending) = work.pending.take() {
|
||||
// 若失败发生在布局阶段,取消这份原窗口检查点配套的 Work;不会恢复执行源语句或发布其草稿。
|
||||
self.bridge
|
||||
.abort_layout_frame(&mut self.candidate.vm, *pending)?;
|
||||
}
|
||||
@@ -1057,6 +1068,7 @@ impl ReplSession {
|
||||
return Err(error);
|
||||
}
|
||||
if let Err(error) = self.bridge.note_refresh_restart(cancelled, cancelled_paint) {
|
||||
// 统计写入失败也表示桥接状态不可可靠访问,不能保留看似可续跑的刷新并继续执行源程序。
|
||||
self.faulted = true;
|
||||
return Err(error);
|
||||
}
|
||||
@@ -1110,6 +1122,7 @@ impl ReplSession {
|
||||
let mut changed = false;
|
||||
// 仅更新桥接仍注册的窗口;旧 GUI 尺寸记录不应在新域里隐式创建窗口资源。
|
||||
for (id, viewport) in viewports {
|
||||
// viewports 来自宿主尺寸记录,只有桥接当前仍注册的 ID 才有权改输入;其余记录不会分配新窗口。
|
||||
if ids.contains(id) {
|
||||
// 每次选明确窗口,使 ui.viewport 等隐式上下文读到对应窗口的尺寸输入。
|
||||
self.bridge.select_window(*id)?;
|
||||
@@ -1268,6 +1281,7 @@ impl ReplSession {
|
||||
)?;
|
||||
}
|
||||
if let Some(pending) = work.pending.take() {
|
||||
// 与 paint 清理互斥的布局续体还带 Mount 检查点,交桥接层完整取消而非直接丢弃 Rust 句柄。
|
||||
self.bridge
|
||||
.cancel_layout_frame(&mut self.candidate.vm, *pending)?;
|
||||
}
|
||||
@@ -1344,6 +1358,7 @@ impl ReplSession {
|
||||
bail!("event belongs to another runtime session");
|
||||
}
|
||||
if !self.accepts_tab_drop(input) {
|
||||
// 拖放还需验证目标端最新页面序列,身份不符时不先执行源 moveToWindow 再尝试修复位置。
|
||||
bail!("drop targets an obsolete presentation");
|
||||
}
|
||||
// 将 ui.window/viewport 等隐式上下文切到事件所属窗口,分发后统一恢复主窗口。
|
||||
@@ -1373,6 +1388,7 @@ impl ReplSession {
|
||||
self.bridge.discard_pending(&mut self.candidate.vm)?;
|
||||
}
|
||||
if !self.has_pending_refresh() {
|
||||
// 分派后的只读刷新若仍挂起,临时根归原调用持有;只有空闲边界才回收,不干扰下一量子恢复。
|
||||
self.bridge
|
||||
.reclaim(&mut self.candidate.vm, &mut self.candidate.roots)?;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user