Threlte 框架迁移指南：从旧版本升级到新版本的重要变更

Threlte 框架在最新版本中引入了一些重要的架构变更和功能改进，这些变化旨在提升开发体验和性能优化。本文将详细介绍这些变更内容，并指导开发者如何平滑迁移到新版本。

事件系统重构

Threlte 移除了 ForwardEventHandlers 和 createRawEventDispatcher 这两个API。新的版本采用了更加简洁和高效的事件处理机制。开发者现在可以直接使用组件内置的事件系统，无需额外的转发或原始事件分发器。

组件引用语法变更

旧版本中使用的 <Component let:ref /> 语法在新版本中不再支持。这是为了简化组件引用机制，开发者现在需要使用标准的引用方式来处理组件实例。

插槽(Slots)更名为片段(Snippets)

Threlte 将原有的"Slots"概念更名为"Snippets"，这一变更不仅仅是命名上的改变，还伴随着功能上的增强。新的Snippets系统提供了更灵活的组件组合方式，同时保持了良好的类型安全。

尺寸属性调整

userSize 属性已被移除。开发者现在应该使用更直观的尺寸控制方式，这有助于简化布局逻辑并提高代码可读性。

渲染器定制方式更新

不再使用 rendererParameters 来定制渲染器，取而代之的是新的 createRenderer API。这一变更使得渲染器定制更加模块化和可维护，开发者可以更精确地控制渲染流程。

迁移建议

1. 对于事件处理，检查项目中所有使用旧事件API的地方，逐步替换为新的内置事件系统
2. 更新所有组件引用语法，移除 let:ref 的使用
3. 将代码中的Slots相关代码重命名为Snippets
4. 查找并替换所有 userSize 的使用点
5. 重构渲染器定制代码，使用新的 createRenderer API

这些变更虽然需要一定的迁移工作，但将带来更好的开发体验和性能表现。建议开发者在非生产环境中先进行测试迁移，确保所有功能正常工作后再部署到生产环境。