Cordis 4.0.0-rc.10

[shigma]

Breaking Changes

• loader: EntryTree.write() is replaced by EntryTree.commit(change: EntryChange). A subclass receives one EntryChange per tree-side mutation, carrying the entry id, its group, the new options, and the previous ones.

Notable Changes

This release improves @cordisjs/plugin-hmr in several areas:

• A three-stage partial reload makes reloading safer and faster.
• ctx.hmr.watch() lets a plugin hook its own files into the watcher and decide what a change does.
• Config hot-reloading works without loader.internal.

The reconciliation between the config file and the runtime tree in @cordisjs/plugin-include is redesigned:

• The loader reports each tree-side mutation as a structured change, and include folds those into a journal.
• A read three-way merges the journal against the file. Edits on disjoint entries and keys both survive. On a conflicting key the file wins, and the conflict is logged.
• A write applies the journal's deltas onto the last known file content, guarded by a content pre-check and an atomic temp-file replace. Changes left by a failed write stay in the journal and are retried, down to a last flush on dispose.
• Changes to patch-owned keys and to patch-inserted entries are persisted into patches on the include entry.
• Anonymous entries keep a stable id across reloads.

Features

• hmr: three-stage partial reload with per-fiber drain (feat(hmr): three-stage partial reload with per-fiber drain #111)
• hmr: keep config reloading available without loader internals
• hmr: support ctx.hmr.watch() (feat(hmr): support hmr.watch() #128)

Bug Fixes

• core: resolve service injection from the def site
• core: reject repeated next() calls from a waterfall listener (fix(core): guard waterfall continuations #44)
• core: do not leave fiber failures unhandled (fix(core): do not leave fiber failures unhandled #109)
• hmr: do not rebuild fibers whose ancestor is already disposed (fix(hmr): nested entry trees hmr and rollback #103)
• include: reconcile file and runtime edits through a journal (fix(include): reconcile file and runtime edits through a journal #121)
• loader: detect internal API by runtime shape
• loader: await nested reconciliation during config update
• loader: resolve bare specifiers from the project (fix(loader): resolve bare specifiers from the project #123)

---

不兼容变更

• loader: EntryTree.write() 由 EntryTree.commit(change: EntryChange) 取代。树上每发生一次变更，子类会收到一个 EntryChange，其中包含条目 id、所属分组、新的 options 以及此前的 options。

重要变更

本次更新对 @cordisjs/plugin-hmr 进行了多方面的优化：

• 三阶段部分重载提供了更安全和快速的 hmr。
• ctx.hmr.watch() 允许插件把自己的文件接入监听，并定制文件变化时的行为。
• 支持在不依赖 loader.internal 的情况下使用配置热更新。

我们重新设计了 @cordisjs/plugin-include 中配置文件与运行时配置树之间的 reconciliation 机制：

• loader 将树上的每次变更结构化上报，include 把它们折叠成一份 journal。
• 读取时把 journal 与文件三方合并。落在不同条目、不同键上的改动两边都保留；同一个键上冲突时以文件为准，并记录冲突日志。
• 写入时把 journal 中的增量应用到上次读到的文件内容上，经内容校验和临时文件原子替换落盘。写入失败的改动留在 journal 中重试，直到销毁时的最后一次 flush。
• patch 拥有的键以及 patch 插入的条目，其运行时改动持久化到 include 条目自身的 patches 中。
• 匿名条目在重载之间保持稳定的 id。

新特性

• hmr: 三阶段部分重载，按 fiber 排空 (feat(hmr): three-stage partial reload with per-fiber drain #111)
• hmr: 缺少 loader internals 时仍可使用配置热更新
• hmr: 新增 ctx.hmr.watch() (feat(hmr): support hmr.watch() #128)

问题修复

• core: 服务注入从定义处解析
• core: 阻止 waterfall 监听器重复调用 next() (fix(core): guard waterfall continuations #44)
• core: 不再遗留未处理的 fiber 失败 (fix(core): do not leave fiber failures unhandled #109)
• hmr: 不再重建祖先已销毁的 fiber (fix(hmr): nested entry trees hmr and rollback #103)
• include: 通过 journal 协调文件与运行时的改动 (fix(include): reconcile file and runtime edits through a journal #121)
• loader: 按运行时形态检测 internal API
• loader: 配置更新时等待嵌套重建完成
• loader: 裸包名从配置文件所属项目解析 (fix(loader): resolve bare specifiers from the project #123)

---

Packages

• cordis: 4.0.0-rc.9 → 4.0.0-rc.10
• @cordisjs/plugin-hmr: 1.0.15 → 1.1.0
• @cordisjs/plugin-include: 1.0.5 → 1.1.0
• @cordisjs/plugin-loader: 1.0.0-rc.6 → 1.0.0-rc.7

---

This discussion was created from the release Cordis 4.0.0-rc.10.