docs: clarify protocol and document publication contracts

This commit is contained in:
2026-11-12 20:38:06 +08:00
parent ab3cd0c7cf
commit 0c4bd06231
3 changed files with 22 additions and 5 deletions
+3
View File
@@ -94,6 +94,8 @@ pub fn install(
CallEffect::External,
)
};
// Aster typed trait 要求固定的规范调用形状;例如 on 以 receiver+事件名+回调+阶段四参描述。
// 这只修改 trait 的签名副本,不收紧原生 on/dispatch 方法本身允许省略尾参的 arity。
signature.arity = CallArity::exact(parameters + 1);
// 接收者类型改为 Any,使能力可由其他符合方法契约的名义类型实现,不把契约绑定死在 Block。
signature.parameters[0] = AnnotationType::Any.into();
@@ -103,6 +105,7 @@ pub fn install(
});
}
// VM 创建受类型约束的 trait;后面保活、附 Trait 名义类型并公开两个查询入口。
// EndorTraitObject.trace 会追踪签名中的名义类型,requirements 不是只供显示的无拥有关系文本。
let capability = vm.new_typed_trait(name, requirements)?;
// 新能力放入宿主 roots 管理生命周期,再同时暴露于 ui 属性与 desktop 类型注册表。
roots.push(capability);