@composy/store-core 0.0.1 → 0.0.2

package/CHANGELOG.md

@@ -1,5 +1,66 @@
-# Changelog
+## [0.0.2] - 2026-10-12
 
-## 0.1.0 (2026-06-11)
+### ✨ 新功能
 
-- 初始版本发布
+- **store**: 优化核心类型定义与基础实现，完善文档及示例 ([1a4771d](https://gitee.com/ldesign-v1/ldesign-store/commit/1a4771ddfb2802408500d13d4824f40b1290812d)) - @swimly
+- **store**: 新增 playground 示例与文档体系 ([87bf247](https://gitee.com/ldesign-v1/ldesign-store/commit/87bf2471823bc12c7b12ac97c5859b005e7929d7)) - @swimly
+- **store**: 添加 LDesign 项目配置及 Store 优化实施规范 ([7c2671e](https://gitee.com/ldesign-v1/ldesign-store/commit/7c2671e5cef66284d3acdd84297472afeea0b5e0)) - @swimly
+- **store**: 完善构建配置并暴露 getters 和 actions 运行时属性 ([8545317](https://gitee.com/ldesign-v1/ldesign-store/commit/854531704d5a9ec9222eee40d445112722f2e698)) - @swimly
+- hand-crafted playground with real demos for store\packages\core ([d04cb89](https://gitee.com/ldesign-v1/ldesign-store/commit/d04cb89393558d33425c55e1803e6618e672aa64)) - @swimly
+- auto-generated playground + README for store sub-packages ([90e109c](https://gitee.com/ldesign-v1/ldesign-store/commit/90e109c10b911656a6ed2322b2815bf83baaea2f)) - @swimly
+- add playground for store\packages\core ([23b3bc8](https://gitee.com/ldesign-v1/ldesign-store/commit/23b3bc8638d6181bbffd530ae9f1227102059e81)) - @swimly
+- 新增 Vue 插件、工具函数与 Playground 示例 ([4df6602](https://gitee.com/ldesign-v1/ldesign-store/commit/4df6602a2800b3698e6bc5c7036a140958a0504c)) - @swimly
+- **engine**: 添加 store engine 插件基础结构 ([07ef880](https://gitee.com/ldesign-v1/ldesign-store/commit/07ef8801f672654b3ff207c4b28defc3944a52cd)) - @swimly
+- 新增工具类型、错误处理和快照功能 ([6219701](https://gitee.com/ldesign-v1/ldesign-store/commit/6219701e7327f26794df8264cbd70c3037618080)) - @swimly
+
+### ♻️ 代码重构
+
+- 重构项目配置与代码结构，优化类型系统与功能 ([64e29ac](https://gitee.com/ldesign-v1/ldesign-store/commit/64e29ac61444ffff1e6e792bbe9a9501227e376b)) - @swimly
+- **vue**: 重构运行时架构并统一持久化实现 ([c9a66e3](https://gitee.com/ldesign-v1/ldesign-store/commit/c9a66e3e563780a4f46879387faaa9f8b1408709)) - @swimly
+- 移除文档系统和playground，标准化构建配置 ([9ae1c1b](https://gitee.com/ldesign-v1/ldesign-store/commit/9ae1c1b150aa765fae43e3599d338691a9a01345)) - @swimly
+- **core**: 重构核心模块结构并优化类型定义 ([20a3436](https://gitee.com/ldesign-v1/ldesign-store/commit/20a343674d6f5117089729acd0732a64ad0d21b8)) - @swimly
+- **build**: 移除umd格式并更新构建配置 ([c02dc47](https://gitee.com/ldesign-v1/ldesign-store/commit/c02dc47d00a56a6ed22b7391777953053ad6c740)) - @swimly
+
+### 📝 文档更新
+
+- **core**: 新增@ldesign/store-core优化任务文档 ([b421080](https://gitee.com/ldesign-v1/ldesign-store/commit/b421080ab44f4df0438f1e0941d5b998efc30dce)) - @swimly
+
+### 📦 构建系统
+
+- add rolldown bundler config for vue and core packages ([2a1f932](https://gitee.com/ldesign-v1/ldesign-store/commit/2a1f932a150c946b8c453a25527c4de1353c5d0a)) - @swimly
+- 升级项目所有依赖至兼容最新版本 ([2bf6f05](https://gitee.com/ldesign-v1/ldesign-store/commit/2bf6f05ca266c410d2df4d5ec1ccea5840654492)) - @swimly
+- 重构构建配置与修复类型检查问题 ([2ef2c0b](https://gitee.com/ldesign-v1/ldesign-store/commit/2ef2c0b74779cf4911cb61954bfce8523b9b5725)) - @swimly
+- 标准化构建配置并调整输出目录结构 ([33c101e](https://gitee.com/ldesign-v1/ldesign-store/commit/33c101ee476820b3a3de8be1be354169ba4e90b5)) - @swimly
+- **vue**: 添加 libraryType 配置并扩展 core 包导出 ([980c3e8](https://gitee.com/ldesign-v1/ldesign-store/commit/980c3e87ce3be2b73f2d74073e702da3ce79b8f8)) - @swimly
+
+### 🔧 其他
+
+- 更新项目配置与依赖版本 ([a98d95c](https://gitee.com/ldesign-v1/ldesign-store/commit/a98d95c2cf6fc17d601dcdfc34940dca631426f3)) - @swimly
+- 更新 core 和 vue 包的依赖版本 ([8e29acd](https://gitee.com/ldesign-v1/ldesign-store/commit/8e29acdad154447e140c7475313ff947265ffef2)) - @swimly
+- update store (26 files) ([b8cccd2](https://gitee.com/ldesign-v1/ldesign-store/commit/b8cccd20cd665d78968b104c030aacf01f33f2a8)) - @swimly
+- normalize versions, clean artifacts, update gitignore ([7b373ed](https://gitee.com/ldesign-v1/ldesign-store/commit/7b373ed6f54f1afc004ae7ac3ebc33fea062a22b)) - @swimly
+- update - docs(core): 新增@ldesign/store-core优化任务æ ([a486937](https://gitee.com/ldesign-v1/ldesign-store/commit/a486937b0c0939cad23dcfcb675dd2aa450171cd)) - @swimly
+- 批量更新 - 规范 .gitignore 清理源码 ([d4fc64e](https://gitee.com/ldesign-v1/ldesign-store/commit/d4fc64ebb656fa8ef03adc319b41becaa453fd00)) - @swimly
+- unified build config and structure ([e41794e](https://gitee.com/ldesign-v1/ldesign-store/commit/e41794e94409cf358de7568b812794d44b656813)) - @swimly
+- 统一配置 ESLint、Prettier 和测试脚本 ([de95488](https://gitee.com/ldesign-v1/ldesign-store/commit/de95488a91bbe087badc21feabf9f54a22ee5459)) - @swimly
+- 统一代码规范配置并更新测试工具 ([7ecaf03](https://gitee.com/ldesign-v1/ldesign-store/commit/7ecaf03f7bd22ae43b9d0775f8439a583f548829)) - @swimly
+- 更新依赖版本至固定版本并移除冗余插件 ([fd11677](https://gitee.com/ldesign-v1/ldesign-store/commit/fd116777c7ca95a0d29ea1e05d6c4e7513584a33)) - @swimly
+- batch commit submodule changes ([b2bb508](https://gitee.com/ldesign-v1/ldesign-store/commit/b2bb508085b6eac2b9e748a89b46470964382b6d)) - @swimly
+- set versions to 0.0.1 and pin @ldesign deps ([b4219a7](https://gitee.com/ldesign-v1/ldesign-store/commit/b4219a727eeaf842199869cb9b40c702010bbb2f)) - @swimly
+- 更新多个子模块至最新提交并重构lottie库依赖配置 ([792a7ec](https://gitee.com/ldesign-v1/ldesign-store/commit/792a7eca24e6f9825ad37fb70926b1562c17ae52)) - @swimly
+- 移除多余的空行并删除vue示例的README文件 ([37c15f7](https://gitee.com/ldesign-v1/ldesign-store/commit/37c15f7d7df4acafdc3307a6417e468c503bfa0f)) - @swimly
+
+### 👥 Contributors
+
+swimly, swimly
+
+### 📊 Statistics
+
+- Total Commits: **35**
+- Contributors: **2**
+
+# Changelog
+
+## 0.1.0 (2026-06-11)
+
+- 初始版本发布

package/README.md

@@ -1,172 +1,196 @@
-# @composy/store-core
-
-> 🎯 框架无关的状态管理核心库 — Store、中间件、插件、PubSub、工具函数，一应俱全
-
-[![npm version](https://img.shields.io/npm/v/@composy/store-core.svg)](https://www.npmjs.com/package/@composy/store-core)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-
-## ✨ 特性
-
-- 🏗️ **Store 抽象** — BaseStore 基类 + createStore 工厂函数，灵活创建状态管理
-- 🔧 **中间件系统** — Logger/持久化/时间旅行/校验中间件开箱即用
-- 🔌 **插件扩展** — defineStorePlugin + createPluginManager，可扩展架构
-- 📢 **事件通信** — PubSub 发布订阅 + EventBus 事件总线
-- ⚡ **性能优化** — 批量更新（batch）、记忆化选择器、智能缓存
-- 🧰 **工具函数** — deepClone/deepMerge/createSelector/debounce/throttle 全套
-- 🧩 **Engine Bridge** — 框架无关的 engine state/API/container/events 生命周期桥接
-- 📦 **TypeScript** — 完整类型定义
-
-## 🧭 Core-first 边界
-
-`@composy/store-core` 是唯一的通用能力承载层。Store 生命周期、action 订阅、批处理、中间件链、时间旅行快照、engine state/API 同步和工具函数都在这里维护。
-
-框架适配包只能通过公开 API 复用 core：
-
-- Vue/Pinia runtime 由 `@composy/store-vue` 创建。
-- engine state/API/container/events 的绑定由 `createStoreEngineBridge()` 统一完成。
-- 后续新增 React/Lit/Vanilla 适配时应复用同一个 bridge，不要再复制 engine plugin 生命周期。
-
-## 📦 安装
-
-```bash
-pnpm add @composy/store-core
-```
-
-## 🚀 快速开始
-
-### createStore — 工厂函数
-
-```typescript
-import { createStore } from '@composy/store-core'
-
-const useCounterStore = createStore({
-  id: 'counter',
-  state: () => ({ count: 0 }),
-  getters: {
-    doubleCount: (state) => state.count * 2,
-    isPositive: (state) => state.count > 0,
-  },
-  actions: {
-    increment() { this.$patch({ count: this.$state.count + 1 }) },
-    decrement() { this.$patch({ count: this.$state.count - 1 }) },
-    reset() { this.$reset() },
-  },
-})
-
-const store = useCounterStore()
-store.actions.increment()
-console.info(store.$state.count)       // 1
-console.info(store.getters.doubleCount) // 2
-```
-
-### 中间件
-
-```typescript
-import {
-  createLoggerMiddleware,
-  createMiddlewareManager,
-  createPersistMiddleware,
-  createTimeTravelMiddleware,
-} from '@composy/store-core'
-
-const manager = createMiddlewareManager()
-
-// Logger — 自动记录状态变化
-manager.use(createLoggerMiddleware({ logState: true }))
-
-// 持久化 — 状态自动保存到 localStorage
-manager.use(createPersistMiddleware({ storage: 'localStorage', stores: ['user'] }))
-
-// 时间旅行 — 撤销/重做
-const { middleware, controller } = createTimeTravelMiddleware({ maxHistory: 50 })
-manager.use(middleware)
-
-controller.undo() // 撤销
-controller.redo() // 重做
-```
-
-### Engine Bridge
-
-```typescript
-import { createStoreEngineBridge } from '@composy/store-core/engine'
-
-const bridge = createStoreEngineBridge({
-  name: 'store',
-  version: '1.0.0',
-  createRuntime: () => runtime,
-})
-
-await bridge.install(engine)
-```
-
-Bridge 会同步写入 `store:runtime`、`store:pinia`、`store:api`、`store:registry` 和 `store:bus`，并注册 engine API。
-
-### PubSub & EventBus
-
-```typescript
-import { createEventBus, createPubSubWithValue } from '@composy/store-core'
-
-// PubSub — 值订阅
-const counter = createPubSubWithValue(0)
-counter.subscribe((value, oldValue) => {
-  console.info(`${oldValue} → ${value}`)
-})
-counter.setValue(42)
-
-// EventBus — 事件总线
-const bus = createEventBus()
-bus.on('state:changed', (data) => console.info(data))
-bus.emit('state:changed', { storeId: 'counter', state: { count: 1 } })
-```
-
-### 工具函数
-
-```typescript
-import {
-  createSelector, debounce, deepClone,
-  deepEqual, deepMerge,
-  getByPath, setByPath, throttle,
-} from '@composy/store-core'
-
-deepClone({ nested: { value: 1 } })           // 深拷贝
-deepMerge({ a: 1 }, { b: 2 }, { a: 3 })      // → { a: 3, b: 2 }
-deepEqual({ a: 1 }, { a: 1 })                 // → true
-createSelector((state: { count: number }) => state.count)
-getByPath(obj, 'a.b.c')                       // 路径读取
-setByPath(obj, 'a.b.c', 'new')                // 路径设置
-debounce(fn, 300)                              // 防抖
-throttle(fn, 300)                              // 节流
-```
-
-## 📚 API 速查
-
-| 模块   | API                             | 说明         |
-| ------ | ------------------------------- | ------------ |
-| 核心   | `BaseStore`                     | Store 基类   |
-| 核心   | `createStore`                   | 工厂函数     |
-| 核心   | `batch`                         | 批量更新     |
-| 中间件 | `createLoggerMiddleware`        | 日志中间件   |
-| 中间件 | `createPersistMiddleware`       | 持久化中间件 |
-| 中间件 | `createTimeTravelMiddleware`    | 时间旅行     |
-| Engine | `createStoreEngineBridge`       | engine 桥接  |
-| 插件   | `defineStorePlugin`             | 定义插件     |
-| 插件   | `createPluginManager`           | 插件管理器   |
-| 工具   | `deepClone/deepMerge/deepEqual` | 深度操作     |
-| 工具   | `getByPath/setByPath`           | 路径操作     |
-| 工具   | `createSelector`                | 记忆化选择器 |
-| 工具   | `debounce/throttle`             | 防抖/节流    |
-
-## ✅ 验证与产物
-
-```bash
-pnpm -C packages/store/packages/core run lint:check
-pnpm -C packages/store/packages/core run type-check
-pnpm -C packages/store/packages/core run test:run
-pnpm -C packages/store/packages/core run build
-```
-
-完整构建后必须同时存在 `dist`、`es`、`esm`、`lib` 四类产物目录。
-
-## 📄 License
-
-MIT © [LDesign Team](https://github.com/ldesign)
+# @composy/store-core
+
+> 🎯 框架无关的状态管理核心库 — Store、中间件、插件、PubSub、工具函数，一应俱全
+
+[![npm version](https://img.shields.io/npm/v/@composy/store-core.svg)](https://www.npmjs.com/package/@composy/store-core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+## ✨ 特性
+
+- 🏗️ **Store 抽象** — BaseStore 基类 + createStore 工厂函数，灵活创建状态管理
+- 🔧 **中间件系统** — Logger/持久化/时间旅行/校验中间件开箱即用
+- 🔌 **插件扩展** — defineStorePlugin + createPluginManager，可扩展架构
+- 📢 **事件通信** — PubSub 发布订阅 + EventBus 事件总线
+- ⚡ **性能优化** — 批量更新（batch）、记忆化选择器、智能缓存
+- 🧰 **工具函数** — deepClone/deepMerge/createSelector/debounce/throttle 全套
+- 🧩 **Engine Bridge** — 框架无关的 engine state/API/container/events 生命周期桥接
+- 📦 **TypeScript** — 完整类型定义
+
+## 🧭 Core-first 边界
+
+`@composy/store-core`
+是唯一的通用能力承载层。Store 生命周期、action 订阅、批处理、中间件链、时间旅行快照、engine
+state/API 同步和工具函数都在这里维护。
+
+框架适配包只能通过公开 API 复用 core：
+
+- Vue/Pinia runtime 由 `@composy/store-vue` 创建。
+- engine state/API/container/events 的绑定由 `createStoreEngineBridge()` 统一完成。
+- 后续新增 React/Lit/Vanilla 适配时应复用同一个 bridge，不要再复制 engine plugin 生命周期。
+
+## 📦 安装
+
+```bash
+pnpm add @composy/store-core
+```
+
+## 🚀 快速开始
+
+### createStore — 工厂函数
+
+```typescript
+import { createStore } from '@composy/store-core'
+
+const useCounterStore = createStore({
+  id: 'counter',
+  state: () => ({ count: 0 }),
+  getters: {
+    doubleCount: state => state.count * 2,
+    isPositive: state => state.count > 0,
+  },
+  actions: {
+    increment() {
+      this.$patch({ count: this.$state.count + 1 })
+    },
+    decrement() {
+      this.$patch({ count: this.$state.count - 1 })
+    },
+    reset() {
+      this.$reset()
+    },
+  },
+})
+
+const store = useCounterStore()
+store.actions.increment()
+console.info(store.$state.count) // 1
+console.info(store.getters.doubleCount) // 2
+```
+
+### Async middleware mutation ordering
+
+When a store uses asynchronous middleware, `$patch`, `$patchAsync`, `$state = ...`, and `$reset()`
+are serialized. Each queued mutation is built from the state committed by the previous mutation, so
+concurrent updates do not overwrite each other with stale snapshots. Stores without middleware keep
+their synchronous patch behavior.
+
+### 中间件
+
+```typescript
+import {
+  createLoggerMiddleware,
+  createMiddlewareManager,
+  createPersistMiddleware,
+  createTimeTravelMiddleware,
+} from '@composy/store-core'
+
+const manager = createMiddlewareManager()
+
+// Logger — 自动记录状态变化
+manager.use(createLoggerMiddleware({ logState: true }))
+
+// 持久化 — 状态自动保存到 localStorage
+manager.use(createPersistMiddleware({ storage: 'localStorage', stores: ['user'] }))
+
+// 时间旅行 — 撤销/重做
+const { middleware, controller } = createTimeTravelMiddleware({ maxHistory: 50 })
+manager.use(middleware)
+
+controller.undo() // 撤销
+controller.redo() // 重做
+```
+
+### Engine Bridge
+
+```typescript
+import { createStoreEngineBridge } from '@composy/store-core/engine'
+
+const bridge = createStoreEngineBridge({
+  name: 'store',
+  version: '1.0.0',
+  createRuntime: () => runtime,
+})
+
+await bridge.install(engine)
+```
+
+Bridge 会同步写入 `store:runtime`、`store:pinia`、`store:api`、`store:registry` 和
+`store:bus`，并注册 engine API。
+
+### PubSub & EventBus
+
+```typescript
+import { createEventBus, createPubSubWithValue } from '@composy/store-core'
+
+// PubSub — 值订阅
+const counter = createPubSubWithValue(0)
+counter.subscribe((value, oldValue) => {
+  console.info(`${oldValue} → ${value}`)
+})
+counter.setValue(42)
+
+// EventBus — 事件总线
+const bus = createEventBus()
+bus.on('state:changed', data => console.info(data))
+bus.emit('state:changed', { storeId: 'counter', state: { count: 1 } })
+```
+
+### 工具函数
+
+```typescript
+import {
+  createSelector,
+  debounce,
+  deepClone,
+  deepEqual,
+  deepMerge,
+  getByPath,
+  setByPath,
+  throttle,
+} from '@composy/store-core'
+
+deepClone({ nested: { value: 1 } }) // 深拷贝
+deepMerge({ a: 1 }, { b: 2 }, { a: 3 }) // → { a: 3, b: 2 }
+deepEqual({ a: 1 }, { a: 1 }) // → true
+createSelector((state: { count: number }) => state.count)
+getByPath(obj, 'a.b.c') // 路径读取
+setByPath(obj, 'a.b.c', 'new') // 路径设置
+debounce(fn, 300) // 防抖
+throttle(fn, 300) // 节流
+```
+
+## 📚 API 速查
+
+| 模块   | API                             | 说明         |
+| ------ | ------------------------------- | ------------ |
+| 核心   | `BaseStore`                     | Store 基类   |
+| 核心   | `createStore`                   | 工厂函数     |
+| 核心   | `batch`                         | 批量更新     |
+| 中间件 | `createLoggerMiddleware`        | 日志中间件   |
+| 中间件 | `createPersistMiddleware`       | 持久化中间件 |
+| 中间件 | `createTimeTravelMiddleware`    | 时间旅行     |
+| Engine | `createStoreEngineBridge`       | engine 桥接  |
+| 插件   | `defineStorePlugin`             | 定义插件     |
+| 插件   | `createPluginManager`           | 插件管理器   |
+| 工具   | `deepClone/deepMerge/deepEqual` | 深度操作     |
+| 工具   | `getByPath/setByPath`           | 路径操作     |
+| 工具   | `createSelector`                | 记忆化选择器 |
+| 工具   | `debounce/throttle`             | 防抖/节流    |
+
+## ✅ 验证与产物
+
+```bash
+pnpm -C packages/store/packages/core run lint:check
+pnpm -C packages/store/packages/core run type-check
+pnpm -C packages/store/packages/core run test:run
+pnpm -C packages/store/packages/core run build
+```
+
+完整构建后必须同时存在 `dist`、`es`、`esm`、`lib` 四类产物目录。
+
+Build and TypeScript project settings are maintained in `.ldesign/`; package-root `tsconfig.json`
+and `eslint.config.js` are compatibility entry points.
+
+## 📄 License
+
+MIT © [LDesign Team](https://github.com/ldesign)