Kobweb项目中的kotlin-js-ext模块拆分实践

在Kobweb项目的开发过程中，我们注意到compose-html-ext模块包含了一些与Compose框架无关的通用功能。这些功能实际上属于更基础的Kotlin/JS工具层，不应该与Compose强耦合。本文将详细介绍我们如何识别这个问题，以及最终的解决方案。

问题背景

在开发Web Worker相关功能时，我们发现需要使用WindowExtensions中的invokeThenInterval扩展函数。然而，Web Worker环境并不使用Compose框架，这使得引入compose-html-ext作为依赖显得不太合理。这促使我们重新审视模块划分的合理性。

技术分析

经过仔细分析，compose-html-ext模块中确实包含了两类功能：

1. 与Compose框架直接相关的HTML扩展
2. 通用的Kotlin/JS工具函数

这种混合设计带来了几个问题：

• 不必要的依赖传递
• 代码组织不够清晰
• 限制了在非Compose环境中的使用

解决方案

我们决定将这些通用功能拆分到一个新的模块kotlin-js-ext中，并使其成为compose-html-ext的API依赖。这样做的好处包括：

1. 更好的模块化：每个模块职责更单一
2. 更灵活的依赖：非Compose项目可以单独使用基础工具
3. 更清晰的包结构：通过合理的包名区分不同层级的代码

在包名设计上，我们考虑将原来的com.varabyte.kobweb.compose.util改为com.varabyte.kobweb.js.util，以更准确地反映模块的定位。

实施结果

这个改进已经在Kobweb 0.15.4版本中实现，新模块命名为browser-ext。这个变更使得项目结构更加清晰，也为未来的扩展打下了更好的基础。

经验总结

这个案例给我们带来的启示：

• 定期审视模块划分的合理性很重要
• 工具类功能应该尽量与框架解耦
• 良好的包结构设计能提高代码的可维护性

对于其他Kotlin/JS项目，这也提供了一个很好的模块化实践参考。合理的分层设计不仅能提高代码复用性，还能让项目结构更加清晰易懂。