Vue 组件的属性、双向绑定与事件载荷应如何建立统一类型契约

核心结论：Vue 组件类型设计应围绕单向数据流建立一份清晰契约：属性描述父组件输入，事件描述子组件输出，双向绑定只是特定属性与更新事件的语法约定，不应通过直接修改属性实现。类型层要让事件名称、载荷与属性类型保持关联；运行时层仍要提供必要的属性验证和外部数据校验。对于现代项目，应优先使用当前版本支持的组合式类型声明方式，不应把旧式装饰器示例机械迁移到新代码。

底层机制上，TypeScript 的类型在编译后通常被擦除，而 Vue 运行时需要实际的属性选项、事件声明和组件元数据。纯类型参数可以为编辑器和编译器提供调用约束，但不能自动验证网络数据。某些装饰器方案依赖反射元数据把类字段类型映射为运行时构造器，这种映射只能表达有