LegendState 中 Map 对象 size 属性的响应式处理方案

背景介绍

在响应式编程中，处理集合类型数据（如 Map、Set、Array）时，我们经常需要对其大小变化做出响应。LegendState 作为一个状态管理库，在最新版本中对 Map 对象的 size 属性处理进行了重要改进。

问题分析

在 LegendState 的早期版本中，开发者尝试通过 m$.size.get() 来获取 Map 的大小并建立响应式依赖时遇到了问题。这主要是因为：

1. 类型系统不匹配 - size 属性被错误地类型化为 Observable 而非原始数值
2. 响应式机制不完善 - 无法单独对 size 属性建立细粒度的响应式依赖
3. API 设计不一致 - 与原生 Map 的 API 行为存在差异

解决方案

LegendState 在 3.0.0-alpha.22 版本中对此问题进行了修复，主要改进包括：

1. 正确的类型定义：将 m$.size 的类型修正为 number 而非 Observable，与原生 Map API 保持一致
2. 细粒度的响应式追踪：直接访问 m$.size 即可建立浅层(shallow)响应式依赖
3. 移除不合理的 API：不再支持 m$.get(true) 这种可能引起歧义的浅层获取方式

使用示例

// 创建响应式 Map
const m$ = observable(new Map());

// 响应式获取大小（自动建立依赖）
effect(() => {
  console.log(`Map size changed to: ${m$.size}`);
});

// 修改 Map 内容
m$.set('key', 'value'); // 将触发上面的 effect

相关改进

这一改进也影响了其他集合类型：

1. Array：length 属性现在也是响应式的
2. Set：size 属性同样遵循这一模式

最佳实践

对于需要不建立响应式依赖的获取操作，推荐使用：

// 不建立响应式依赖的获取
const currentSize = m$.peek().size;

总结

LegendState 通过这次改进，使得集合类型大小的响应式处理更加符合直觉和原生 API 的行为。开发者现在可以：

1. 更自然地使用 m$.size 语法
2. 获得更精确的类型提示
3. 实现更细粒度的响应式控制

这一变化体现了 LegendState 对开发者体验的持续优化，使得状态管理代码更加简洁和可维护。