DearOreUI — Minecraft 基岩版 OreUI 的运行时扩展

ScreenTechStackSelector::getTechStackForScreen   ← 判断当前页面是否为 OreUI 技术栈
        ↓
SceneProvider::createScene                       ← 页面创建（PageCreated 生命周期）
        ↓
Router 路由方法                                   ← 页面导航（路径/查询/片段）
        ↓
OreUI::View::initialize                          ← 捕获真实 cohtml::View*（MCAPI 导出符号）
        ↓
OreUI::View::$OnReadyForBindings                 ← 脚本上下文就绪门控（关键）
        ↓
CoherentHostBridge::sendScript                   ← 有界延迟队列 + 冲刷
        ↓
cohtml::View::ExecuteScript(script)              ← 引擎真实执行 JS
        ↓
页面内 bootstrap → CSSOM 构建 DOM                 ← 在全屏 Overlay 中渲染

#include "ll/api/mod/RegisterHelper.h"
#include "api/IDearOreUIApi.h"
#include "api/manifest/ModManifest.h"
#include "api/manifest/UiManifest.h"
 
using namespace dearoreui::api;
 
// IDearOreUIApi* oreui = ...; // 稳定获取方式见 environment 页，当前参考内置 Demo
 
bool onLoad() {
    // 1. 注册 Mod（前置条件：资源/UI 注册都要求 Mod 已注册）
    ModManifest manifest;
    manifest.id           = ModId{"my-first-ui"};
    manifest.modNamespace = "my_first_ui";
    manifest.modVersion   = Version{1, 0, 0};
    auto modResult = oreui->registerMod(manifest);
    if (modResult.isErr()) return false;
 
    // 2. 声明 Overlay：在哪个页面、锚在哪、要不要吃指针事件
    UiManifest ui;
    ui.modNamespace = "my_first_ui";
    ui.id           = "hello";
    ui.kind         = UiKind::Overlay;
    ui.pageScopes   = {PageScope::Any}; // 所有 OreUI 页面
    ui.anchor       = UiAnchor::Center;
    ui.fingerprint  = "hello-overlay-v1"; // 冲突检测用
 
    return oreui->registerOverlay(
        ModId{"my-first-ui"}, ui, "<div>Hello, DearOreUI!</div>"
    ).isOk();
}
 
LL_REGISTER_MOD(MyMod, onLoad);

component::ComponentSpec panel;
panel.kind  = component::ComponentKind::Panel;
panel.label = "DearOreUI";
 
component::ComponentSpec text;
text.kind    = component::ComponentKind::Text;
text.variant = "heading";
text.label   = "DEMO";
 
component::ComponentSpec button;
button.kind    = component::ComponentKind::Button;
button.variant = "primary";
button.label   = "OK";
 
panel.children.push_back(text);
panel.children.push_back(button);
 
oreui->registerComponent(ModId{"dearoreui"}, uiManifest, panel);

Mod A 注册（manifest + 资源 + 脚本 + 样式 + UI）
Mod B 注册
Mod C 注册
        ↓
统一注册表（IModRegistry）
        ↓
按页面/版本/能力筛选
        ↓
依赖排序（DependencyResolver）
        ↓
冲突检测（ConflictDetector，指纹/路径/命名空间）
        ↓
变换计划（ChangePlanner / PageTransformer）
        ↓
注入当前 OreUI 页面

L0  运行时查询        —— 只读、零副作用（isReady / capabilities / protocolVersion）
 ↓
L1  声明式资源注册     —— 资源 / 脚本 / 样式 / UI 声明式注册
 ↓
L2  页面生命周期订阅   —— PageContext / 页面事件
 ↓
L3  受控 Host API     —— 权限校验的 C++↔JS 双向调用
 ↓
L4  版本化代码变换     —— 依赖排序 / 冲突检测 / 变换计划
 ↓
L5  Facet Provider    —— 宿主能力抽象
 ↓
L6  高级兼容适配       —— vtable 指纹 / 多版本 ABI 适配

阶段 0~7.1    已交付
   Hook 候选验证 / 公共类型与诊断 / Runtime-Mod-API 门面 /
   Hook-Capability-PageContext / Source-Resource-Inject / IPC-Host-Facet /
   多 Mod 注册表-冲突-变换 / UI 挂载与声明式 UI / 真实显示链路打通

阶段 8       已交付（2026-08-22 核对）
   通用渲染器（htmlBody→CSSOM）/ 组件库（37 种 ComponentKind + 主题令牌）/
   JS→C++ Facet 通道（单发限制）/ API 门面（Runtime/Resource/Mod/UI/Host 五组接口）