Cordis 4.0.0-rc.11

[shigma]

Breaking Changes

• Config handling is split out of internal/update into separate events. Update listeners now receive (resolvedConfig, next) without the noSave argument; persistence handlers should move to internal/commit(fiber, originalConfig). Config resolution uses internal/config(fiber, next). The fiber.update(config, noSave) call signature is unchanged.

• Several internal APIs have changed:

  • fiber.config retains the original config instead of the resolved value. Plugins receive interpolated and validated values through their callback or constructor argument.
  • fiber.store is split into fiber.committed for injected bindings and fiber.provisions for the fiber's own provided bindings.
  • Impl.fiber is replaced by Impl.ctx; the owning fiber is available through impl.ctx.fiber.
  • ctx.reflect.notify() no longer returns a list of fibers.

Notable Changes

• Service disposal now follows dependency order. Providers wait for dependent fibers to finish asynchronous cleanup before disposing their own effects, keeping services available throughout consumer teardown. Withdrawing a binding waits only for its consumers to unload, without waiting for their subsequent reload. Unrelated fibers and sibling effects retain concurrent cleanup.
• Config resolution, persistence, and plugin updates now have separate internal events. The new internal/config(fiber, next) hook lets the loader interpolate expressions before schema validation on each load or reload. The new internal/commit(fiber, originalConfig) event handles persistence of the original input, while internal/update receives the resolved config. This keeps reloads working with current values and preserves expressions for write-back.

Features

• core: resolve plugin config on every reload (feat(core): resolve plugin config on every reload #134)
• create: report scaffold failures and request timeouts (fix(create): report scaffold failures #151)
• loader: evaluate !!js expressions in disabled (feat(loader): evaluate !!js expressions in disabled #179)

Bug Fixes

• core: report the correct dispatch mode for ctx.parallel() (fix(core): report parallel dispatch mode #136)
• core: dispose internal/update hooks with the fiber (fix(core): dispose internal/update hooks with the fiber #56)
• core: track reload revisions in fiber epochs (fix(core): track reload revisions in fiber epochs #189)
• core: unregister service bindings from the correct isolation realm after a move (fix(core): unregister a service impl after an isolate move #191)
• core: dispose providers after their dependents (fix(core): dispose providers after their dependents #196)
• create: preserve invalid .yarnrc.yml files (fix(create): leave an invalid .yarnrc.yml alone #173)
• create: replace stale temporary Yarn binaries (fix(create): replace stale temporary yarn binaries #150)
• hmr: handle an absent process.argv[1] when collecting externals (fix(hmr): guard absent process.argv[1] when collecting externals #170)
• hmr: match watch paths that differ in case from baseDir on Windows (fix(hmr): match watch paths that differ in case from baseDir on Windows #157)
• hmr: do not rebuild entries disabled or removed during unload (fix(hmr): do not rebuild an entry disabled or removed during unload #190)
• include: only treat ENOENT as a missing file (fix(include): only treat ENOENT as a missing file #171)
• loader: keep _initTask set until initialization settles (fix(loader): keep _initTask set until init settles #166)
• loader: reject entry ids containing the tree separator (fix(loader): reject entry ids containing the tree separator #172)
• timer: prevent throttled callbacks from running after disposal (fix(timer): prevent execution after throttle disposer is called #161)
• timer: enforce a void return type for throttled and debounced functions (fix(timer): enforce void return type for throttled and debounced functions #163)

---

不兼容变更

• internal/update 中的配置处理职责拆分到独立事件。更新监听器的参数改为 (resolvedConfig, next)，移除了 noSave；持久化逻辑应迁移至 internal/commit(fiber, originalConfig)，配置解析通过 internal/config(fiber, next) 完成。fiber.update(config, noSave) 的调用签名保持不变。

• 部分内部 API 发生变更：

  • fiber.config 保留原始配置，而非解析后的值。插件通过回调或构造函数的参数接收经过插值和校验的配置。
  • fiber.store 拆分为记录注入绑定的 fiber.committed 和记录自身提供绑定的 fiber.provisions。
  • Impl.fiber 改为 Impl.ctx，可通过 impl.ctx.fiber 访问所属 fiber。
  • ctx.reflect.notify() 不再返回 fiber 列表。

重要变更

• 服务销毁现在遵循依赖顺序。提供者等待依赖它的 fiber 完成异步清理后，才销毁自身的副作用，保证消费者在清理期间仍能使用这些服务。撤回一个绑定时，只等待该绑定的消费者卸载，不等待它们之后的重载。无关 fiber 和同级副作用仍可并发清理。
• 配置解析、持久化和插件更新现在由独立的内部事件处理。新增的 internal/config(fiber, next) 钩子允许 loader 在每次加载或重载时先对表达式插值，再进行 schema 校验；新增的 internal/commit(fiber, originalConfig) 事件负责持久化原始输入，internal/update 则接收解析后的配置。这样既能在重载时使用当前值，也能在写回时保留表达式。

新特性

• core: 每次重载都重新解析插件配置 (feat(core): resolve plugin config on every reload #134)
• create: 明确报告项目创建失败和请求超时 (fix(create): report scaffold failures #151)
• loader: 支持在 disabled 中求值 !!js 表达式 (feat(loader): evaluate !!js expressions in disabled #179)

问题修复

• core: 为 ctx.parallel() 上报正确的派发模式 (fix(core): report parallel dispatch mode #136)
• core: 随 fiber 一同清理 internal/update 钩子 (fix(core): dispose internal/update hooks with the fiber #56)
• core: 在 fiber epoch 中跟踪重载修订号 (fix(core): track reload revisions in fiber epochs #189)
• core: 服务绑定移动隔离域后，从正确的隔离域注销 (fix(core): unregister a service impl after an isolate move #191)
• core: 等待依赖者清理完成后再销毁服务提供者 (fix(core): dispose providers after their dependents #196)
• create: 保留无效的 .yarnrc.yml 文件，不覆盖其内容 (fix(create): leave an invalid .yarnrc.yml alone #173)
• create: 替换残留的临时 Yarn 可执行文件 (fix(create): replace stale temporary yarn binaries #150)
• hmr: 收集 externals 时兼容缺少 process.argv[1] 的情况 (fix(hmr): guard absent process.argv[1] when collecting externals #170)
• hmr: 在 Windows 上正确匹配与 baseDir 大小写不同的监听路径 (fix(hmr): match watch paths that differ in case from baseDir on Windows #157)
• hmr: 不再重建卸载期间被禁用或移除的条目 (fix(hmr): do not rebuild an entry disabled or removed during unload #190)
• include: 仅将 ENOENT 视为文件不存在 (fix(include): only treat ENOENT as a missing file #171)
• loader: 保持 _initTask，直到初始化完成或失败 (fix(loader): keep _initTask set until init settles #166)
• loader: 拒绝包含配置树分隔符的条目 id (fix(loader): reject entry ids containing the tree separator #172)
• timer: 阻止节流回调在销毁后继续执行 (fix(timer): prevent execution after throttle disposer is called #161)
• timer: 将节流和防抖函数的返回类型修正为 void (fix(timer): enforce void return type for throttled and debounced functions #163)

---

Packages

• cordis: 4.0.0-rc.10 → 4.0.0-rc.11
• create-cordis: 0.3.0 → 0.3.1
• @cordisjs/plugin-hmr: 1.1.0 → 1.1.1
• @cordisjs/plugin-include: 1.1.0 → 1.1.1
• @cordisjs/plugin-loader: 1.0.0-rc.7 → 1.0.0-rc.8
• @cordisjs/plugin-timer: 1.1.3 → 1.1.4

---

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