R2 Builder 体系与连带注册建模

[Tki-sor]

Question

Builder 体系与连带注册的建模：

1. Builder 采用 public field 约定（PR feat: Skeleton for a generic registry system #37 §3.1，理由：链式方法返回类型无法表达子类 self type）——是否采纳为全项目约定？
2. 逐类型 XxxBuilderJS 的去留：通用 builder 完全吸收 vs 保留 per-type 作为糖。
3. 连带注册（Co-registration，术语见 CONTEXT.md）：additionalBuilders() vs handleAdditionalRegistry(Consumer<...>)（PR feat: Skeleton for a generic registry system #37 §1.2 思路）的取舍；Block→BlockItem、Fluid→流体方块+桶 的默认规则放引擎还是插件。

需求信号：#36。产出：ADR（Builder 与连带注册）。

[Tki-sor]

决议

（一轮 grilling，用户全盘采纳）

1. public field 约定：数据属性 public field，禁止 return-this 链式 setter；动作方法保留返回 void。
2. per-type Builder 保留为类型内容：通用机制吸收管道；构造统一经 registry_types 注册工厂（命名分裂消失）；TaggableBuilder 等成基类接口。新增注册表类型 = 1 个 Builder 类 + 清单 1 行（判据①兑现）。
3. 连带注册 = 回调式三件套：handleAdditionalObjects(AdditionalObjectRegistry) 在 after-all 统一执行；预创建子 builder + noXxx() 置 null + RegistryObjectBuilder implements Supplier<T> 懒互引（KubeJS 验证同款，且与现状 BlockBuilderJS 自发雏形一致）。
4. 默认连带规则随 builder 类：BlockBuilderJS 默认带 BlockItem、FluidBuilder 四子 builder；引擎只提供框架。

被拒：additionalBuilders() 直返集合、引擎全局规则表。

注意：脚本端既有 .hardness(2) 链式写法受 1 影响——兼容层深度归 R3 裁定。

决策全文：docs/adr/0005-builder-and-co-registration.md（ADR-0005）。前置：ADR-0004、RE2 §3.5。