ebox/CHANGELOG.zh-CN.md
2026-08-25 17:16:56 +08:00

2.3 KiB
Raw Blame History

变更日志

Ebox 的重要变化记录在这里。

2.0.0(未发布)

新增

  • 直接依赖独立的 ECSS 0.1.0 cascade engine 与 TP 1.0.0 retained/reactive text runtime。
  • Box、Flex 与 Grid 节点统一使用 ECSS property schema、selector、stylesheet、inheritance、cascade layer、custom property、computed value 与 provenance。
  • 通过 ebox-region-resolve 提供 surface-scoped region handleebox-render-to-bufferebox-display-buffer 统一使用 retained TP publicationhandle、selector、viewport 与 scroll 更新加入同一原子事务。
  • 增加 typography longhand 与继承 foreground 的投影;子盒子覆盖背景色时仍能保持文字可读。
  • 增加公开、可嵌套的 framework render-burst 边界,覆盖 commit 前分配,与 Ebox commit 共用交互 deferred GC ownership并在 batch 边界不主动 GC 的情况下恢复原设置。

变更

  • ECSS 是唯一 selector matcher 与 cascade winner。Ebox 只把节点树适配为 ECSS subject解释 computed value 的测量、布局与绘制后果,并分类 layout impact。
  • TP 是唯一 live buffer writer。Ebox 只生成 retained surface candidate 与语义 dirty-owner plandiff execution、marker-backed mount、revision、transaction 与 rollback 都属于 TP。
  • Flex/Grid container 与 item declaration 和普通 box 一样进入同一条 ECSS pipeline不再维护平行 style path。
  • Region 更新改用 opaque、surface-scoped handle同一份声明式 source 可以挂载到多个 buffer而不共享 live identity。

删除

  • ebox-pop-to-bufferebox-switch-to-buffer,以及它们暴露的私有 erase-and-evaluate buffer writer。
  • Ebox 内重复的 selector parser/matcher 与 cascade winner。
  • 仓库内置 playground fixture可执行 .ebox reference 已迁到独立 ebox-playground 包。

迁移

  • ECSS 0.1.0 与 TP 1.0.0 互相独立,安装顺序任意;两者都安装后再安装 Ebox 2.0.0。
  • 数字 region id 更新改为先调用 ebox-region-resolve,再把返回的 handle 交给 ebox-region-update
  • ebox-pop-to-bufferebox-switch-to-buffer 改为 ebox-display-buffer;如果显示行为由调用方控制,则使用 ebox-render-to-buffer
  • Ebox 不扫描历史渲染文本来重建 runtime identity请通过 Ebox 2.0 重新 mount 声明式 source。