本项目的所有重要变更都会记录在此页,版本号遵循语义化版本。
以修复子入口导出和生命周期回收为主的补丁版本。
useStorage:React、Vue、Preact、Solid、Svelte、Angular 六个入口此前只导出 useXxxStorage,按文档 import { useStorage } from 'ew-responsive-store/react' 会拿到 undefined。现在两个名字同时可用,旧别名不受影响。getSnapshot 在渲染阶段写存储:版本迁移此前在 getSnapshot 内直接回写,违反 useSyncExternalStore 的纯函数要求。现在迁移结果延迟到订阅、外部变更、setValue 等非渲染路径落盘。onError 后仍输出 console.error:现在只调用回调,不再重复打印。exports 补充 "./package.json":兼容会读取包清单的工具链。retainStorageManager / releaseStorageManager。注册表按引用计数与订阅者数量判断是否回收,回收延迟到微任务执行,避免 React StrictMode 的「挂载 → 卸载 → 再挂载」误删仍在使用的实例。StorageService 是 providedIn: 'root',也会使用调用方组件的 DestroyRef;Svelte 在实例被回收后重新订阅会自动重新获取。dedupe、动态 key 回收,以及 Vue 在 setup 外使用 effectScope 的完整示例。parse: 'auto' 下数字与布尔仍以 JSON 写入,读取时可能回落为字符串;需要严格类型请使用默认的 json 模式。这是一次以稳定性、可预测性和工程化为主的重构版本。
immediate 默认值改为 false:组件创建时直接使用存储中的值初始化,不再额外写一次存储。需要把默认值立即持久化时显式传入 immediate: true。ParseStrType.EVAL 标记为废弃:内部使用 new Function,在严格 CSP 环境(如 Tauri、Electron 加固)会直接抛错,请改用 JSON 或新增的 AUTO。.cjs:main 与各个 exports.require 已同步更新。通过包名或子路径导入不受影响,仅直接按旧文件名引用 UMD 产物的场景需要调整。key + 存储区域的所有组件共享同一个管理器,setValue 后立即互相同步。setValue(prev => next),与 React useState 的 updater 用法一致。parse 解析模式:'json'(默认,严格 JSON)与 'auto'(兼容 'dark'、'1' 这类历史裸字符串)。remove() / clear():remove() 删除当前 key 并回落初始值;clear() 只清理本库管理的 key,不会误删业务方的其它数据。version + migrate(oldValue, oldVersion),读取旧数据时自动升级并回写。serializer / deserializer,支持 Date、Map、Set 等类型;serializer 返回 null / undefined 时拒绝写入。equals(a, b),默认按引用或 JSON 字符串比较,相等时跳过写入与通知。memoryFallback(默认 true)在存储不可用或写入失败时降级到内存;onError({ key, storage, operation, error }) 便于接入日志与上报。[value, setValue, { key, remove, clear, manager }];Svelte store 增加 remove / clear / destroy;Angular 与 Vanilla 提供 setValue / updateValue / reset / remove / clear。useSyncExternalStore,服务端渲染使用 getInitialSnapshot() 返回初始值。StorageManager、getStorageManager、getRegisteredManagers、clearManagedStorage、clearStorageManagerRegistry 以及相关类型。setItem 抛错导致状态直接失效的问题。window 导致的报错。storage 事件在 clear() 或版本标记变化时未正确同步的问题。package.json 增加 files 白名单,仅发布 dist 与 README。sideEffects: false,exports 中 types 前置,改善 tree-shaking 与类型解析。peerDependencies.react 调整为 >=18.0.0,移除自依赖,零运行时依赖。clear、版本迁移等场景。ew-responsive-store/react、/vue、/preact、/solid、/svelte、/angular、/vanilla。useStorage 函数名。peerDependencies 并从产物中外部化,保持包体积最小。useReactStorage 迁移为从 React 入口导入的 useStorage。useStorage,让 localStorage / sessionStorage 数据响应式化。storage、deep、immediate 配置。parseStr、isValidJSON、isStorageEnabled 实用函数与完整 TypeScript 类型。更早的
0.0.1-beta.0~0.0.1-beta.9为预发布迭代,主要引入了 ReactuseReactStorage、跨标签页同步与类型定义,未单独列出。