@lytjs/store 4.0.5 → 4.2.0

package/README.md

@@ -0,0 +1,303 @@
+# @lytjs/store
+
+Lyt.js 状态管理 - Pinia 风格的简单直观的状态管理库。
+
+## 安装
+
+```bash
+npm install @lytjs/store
+
+# 或使用 pnpm
+pnpm add @lytjs/store
+```
+
+## 特性
+
+- 🚀 DevTools 支持
+- 🔄 热模块替换 (HMR)
+- 📦 插件系统
+- 🎯 TypeScript 友好
+- 🔌 零运行时依赖
+- 💾 可通过插件支持持久化
+
+## 快速开始
+
+```javascript
+import { defineStore } from '@lytjs/store';
+
+// 1. 定义 Store
+export const useCounterStore = defineStore('counter', {
+  state: () => ({
+    count: 0,
+    name: 'Lyt.js'
+  }),
+  getters: {
+    doubleCount: (state) => state.count * 2
+  },
+  actions: {
+    increment() {
+      this.count++;
+    },
+    async fetchData() {
+      const res = await api.get('/data');
+      this.data = res.data;
+    }
+  }
+});
+
+// 2. 在组件中使用
+import { useCounterStore } from './store';
+
+const counter = useCounterStore();
+
+counter.increment();
+console.log(counter.count);
+console.log(counter.doubleCount);
+```
+
+## 组合式 Store
+
+```javascript
+import { defineStore } from '@lytjs/store';
+import { ref, computed } from '@lytjs/reactivity';
+
+export const useCounterStore = defineStore('counter', () => {
+  const count = ref(0);
+  const name = ref('Lyt.js');
+  const doubleCount = computed(() => count.value * 2);
+
+  function increment() {
+    count.value++;
+  }
+
+  return { count, name, doubleCount, increment };
+});
+```
+
+## 核心概念
+
+### State
+
+```javascript
+export const useStore = defineStore('main', {
+  state: () => ({
+    counter: 0,
+    user: null
+  })
+});
+```
+
+### Getters
+
+```javascript
+export const useStore = defineStore('main', {
+  state: () => ({ counter: 0 }),
+  getters: {
+    doubleCount: (state) => state.counter * 2,
+    doublePlusOne() {
+      return this.doubleCount + 1;
+    }
+  }
+});
+```
+
+### Actions
+
+```javascript
+export const useStore = defineStore('main', {
+  state: () => ({ counter: 0 }),
+  actions: {
+    increment() {
+      this.counter++;
+    },
+    randomizeCounter() {
+      this.counter = Math.round(100 * Math.random());
+    }
+  }
+});
+```
+
+## 在 Setup 中使用
+
+```javascript
+import { useCounterStore } from '@/stores/counter';
+import { storeToRefs } from '@lytjs/store';
+
+export default {
+  setup() {
+    const store = useCounterStore();
+
+    // 直接读取
+    store.increment();
+
+    // 解构，保持响应式
+    const { count, doubleCount } = storeToRefs(store);
+    const { increment } = store;
+
+    return { count, doubleCount, increment };
+  }
+};
+```
+
+## 订阅 State
+
+```javascript
+const store = useStore();
+
+// 订阅 state 的变化
+const unsubscribe = store.$subscribe((mutation, state) => {
+  console.log(mutation);
+  localStorage.setItem('cart', JSON.stringify(state));
+});
+
+// 订阅 actions 的调用
+const unsubscribeAction = store.$onAction(({ name, after, onError }) => {
+  console.log(`Action ${name} called`);
+  
+  after((result) => {
+    console.log(`Action ${name} finished with result:`, result);
+  });
+  
+  onError((error) => {
+    console.error(`Action ${name} failed:`, error);
+  });
+});
+```
+
+## 插件
+
+```javascript
+import { createPinia } from '@lytjs/store';
+
+const pinia = createPinia();
+
+// 持久化插件示例
+function localStoragePlugin(context) {
+  const { store } = context;
+  
+  const savedState = localStorage.getItem(store.$id);
+  if (savedState) {
+    store.$patch(JSON.parse(savedState));
+  }
+  
+  store.$subscribe((mutation, state) => {
+    localStorage.setItem(store.$id, JSON.stringify(state));
+  });
+}
+
+pinia.use(localStoragePlugin);
+```
+
+## DevTools
+
+```javascript
+import { createPinia } from '@lytjs/store';
+
+const pinia = createPinia();
+
+// 启用 DevTools
+pinia.use(({ store }) => {
+  store.$onAction(({ name, after }) => {
+    after(() => {
+      console.log(`[Store] ${name}`);
+    });
+  });
+});
+```
+
+## 示例
+
+### 完整示例
+
+```javascript
+import { defineStore } from '@lytjs/store';
+
+export const useUserStore = defineStore('user', {
+  state: () => ({
+    user: null,
+    isAuthenticated: false,
+    token: null
+  }),
+  
+  getters: {
+    userName: (state) => state.user?.name,
+    isLoggedIn: (state) => state.isAuthenticated
+  },
+  
+  actions: {
+    async login(credentials) {
+      try {
+        const response = await api.post('/login', credentials);
+        this.user = response.data.user;
+        this.token = response.data.token;
+        this.isAuthenticated = true;
+        localStorage.setItem('token', this.token);
+      } catch (error) {
+        console.error('Login failed:', error);
+        throw error;
+      }
+    },
+    
+    logout() {
+      this.user = null;
+      this.token = null;
+      this.isAuthenticated = false;
+      localStorage.removeItem('token');
+    }
+  }
+});
+```
+
+### 组合式 API 示例
+
+```javascript
+import { defineStore } from '@lytjs/store';
+import { ref, computed } from '@lytjs/reactivity';
+
+export const useTodoStore = defineStore('todo', () => {
+  const todos = ref([]);
+  
+  const completedTodos = computed(() => 
+    todos.value.filter(todo => todo.completed)
+  );
+  
+  const pendingTodos = computed(() => 
+    todos.value.filter(todo => !todo.completed)
+  );
+  
+  function addTodo(text) {
+    todos.value.push({
+      id: Date.now(),
+      text,
+      completed: false
+    });
+  }
+  
+  function toggleTodo(id) {
+    const todo = todos.value.find(t => t.id === id);
+    if (todo) {
+      todo.completed = !todo.completed;
+    }
+  }
+  
+  return { todos, completedTodos, pendingTodos, addTodo, toggleTodo };
+});
+```
+
+## 性能
+
+- 轻量级，零运行时依赖
+- 基于 Proxy 的响应式系统
+- 高效的订阅机制
+
+## 兼容性
+
+- Node.js >= 18.0.0
+- Chrome 64+
+- Firefox 63+
+- Safari 12+
+- Edge 79+
+
+## License
+
+MIT

package/dist/index.cjs

@@ -1 +1 @@
-var x=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var V=Object.prototype.hasOwnProperty;var W=(o,t)=>{for(var S in t)x(o,S,{get:t[S],enumerable:!0})},F=(o,t,S,f)=>{if(t&&typeof t=="object"||typeof t=="function")for(let c of L(t))!V.call(o,c)&&c!==S&&x(o,c,{get:()=>t[c],enumerable:!(f=P(t,c))||f.enumerable});return o};var H=o=>F(x({},"__esModule",{value:!0}),o);var K={};W(K,{clearAllStores:()=>C,createStore:()=>w,getStore:()=>O,getStoreIds:()=>j});module.exports=H(K);var y=require("@lytjs/reactivity"),i=require("@lytjs/common"),l=new Map;function O(o){return l.get(o)}function w(o,t={}){if(l.has(o))return()=>l.get(o);let S=typeof t.state=="function"?t.state():t.state||{},f={};if(t.modules)for(let e of Object.keys(t.modules)){let n=t.modules[e],r=typeof n.state=="function"?n.state():n.state||{};f[e]={...r}}let c={...S,...f},a=(0,y.reactive)({...c}),m={};if(t.getters)for(let e of Object.keys(t.getters)){let n=t.getters[e],r=(0,y.computed)(()=>n(a));Object.defineProperty(m,e,{get(){return r.value},enumerable:!0})}if(t.modules)for(let e of Object.keys(t.modules)){let n=t.modules[e];if(n.getters)for(let r of Object.keys(n.getters)){let s=n.getters[r],k=`${e}/${r}`,R=(0,y.computed)(()=>{let A=a[e];return s(A)});Object.defineProperty(m,k,{get(){return R.value},enumerable:!0})}}let $={},g=[];if(t.actions)for(let e of Object.keys(t.actions)){let n=t.actions[e];$[e]=function(...r){for(let s of g)s({name:e,args:r});return n.apply(b,r)}}if(t.modules)for(let e of Object.keys(t.modules)){let n=t.modules[e];if(n.actions)for(let r of Object.keys(n.actions)){let s=n.actions[r],k=`${e}/${r}`;$[k]=function(...R){for(let A of g)A({name:k,args:R});return s.apply(b,R)}}}let v=new i.SubscriptionManager,d=!1,p=[];function h(e){v.notify([e,a])}let u=null;function I(){if(u||d)return;let e=(0,i.createSnapshot)(a);u=(0,y.watch)(a,()=>{let n=(0,i.createSnapshot)(a),r=(0,i.diffObjects)(e,n);for(let s in r.added)h({storeId:o,type:"add",key:s,newValue:r.added[s]});for(let s in r.removed)h({storeId:o,type:"delete",key:s,oldValue:r.removed[s]});for(let s in r.changed)h({storeId:o,type:"set",key:s,newValue:r.changed[s].new,oldValue:r.changed[s].old});e=n},{deep:!0}),p.push(u)}function M(){if(!v.hasSubscribers()&&u){u();let e=p.indexOf(u);e!==-1&&p.splice(e,1),u=null}}let b={$id:o,get state(){return a},get getters(){return m},get actions(){return $},$expose(){return{state:a,getters:m}},$reset(){if(d)return;let e=Object.keys(a),n=Object.keys(c);for(let r of n)a[r]=c[r];for(let r of e)n.includes(r)||delete a[r]},$subscribe(e){if(d)return()=>{};let n=v.subscribe(([r,s])=>{e(r,s)});return I(),()=>{n(),M()}},$dispose(){if(!d){for(let e of p)e();p.length=0,u=null,v.clear(),l.delete(o),d=!0}},$patch(e){d||((0,i.isFunction)(e)?e(a):(0,i.mergeObjects)(a,e))},use(e){if(d)return()=>{};let n=e.install(b);return()=>{typeof n=="function"&&n()}},$onAction(e){return d?()=>{}:(g.push(e),()=>{let n=g.indexOf(e);n!==-1&&g.splice(n,1)})}};return l.set(o,b),()=>b}function j(){return Array.from(l.keys())}function C(){for(let[o,t]of l)t.$dispose();l.clear()}
+var x=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var V=Object.prototype.hasOwnProperty;var W=(o,t)=>{for(var S in t)x(o,S,{get:t[S],enumerable:!0})},F=(o,t,S,f)=>{if(t&&typeof t=="object"||typeof t=="function")for(let c of L(t))!V.call(o,c)&&c!==S&&x(o,c,{get:()=>t[c],enumerable:!(f=P(t,c))||f.enumerable});return o};var H=o=>F(x({},"__esModule",{value:!0}),o);var K={};W(K,{clearAllStores:()=>C,createStore:()=>w,getStore:()=>O,getStoreIds:()=>j});module.exports=H(K);var y=require("@lytjs/reactivity"),i=require("@lytjs/common"),l=new Map;function O(o){return l.get(o)}function w(o,t={}){if(l.has(o))return()=>l.get(o);let S=typeof t.state=="function"?t.state():t.state||{},f={};if(t.modules)for(let e of Object.keys(t.modules)){let n=t.modules[e],r=typeof n.state=="function"?n.state():n.state||{};f[e]={...r}}let c={...S,...f},a=(0,y.reactive)({...c}),m={};if(t.getters)for(let e of Object.keys(t.getters)){let n=t.getters[e],r=(0,y.computed)(()=>n(a));Object.defineProperty(m,e,{get(){return r.value},enumerable:!0})}if(t.modules)for(let e of Object.keys(t.modules)){let n=t.modules[e];if(n.getters)for(let r of Object.keys(n.getters)){let s=n.getters[r],v=`${e}/${r}`,R=(0,y.computed)(()=>{let A=a[e];return s(A)});Object.defineProperty(m,v,{get(){return R.value},enumerable:!0})}}let $={},g=[];if(t.actions)for(let e of Object.keys(t.actions)){let n=t.actions[e];$[e]=function(...r){for(let s of g)s({name:e,args:r});return n.apply(b,r)}}if(t.modules)for(let e of Object.keys(t.modules)){let n=t.modules[e];if(n.actions)for(let r of Object.keys(n.actions)){let s=n.actions[r],v=`${e}/${r}`;$[v]=function(...R){for(let A of g)A({name:v,args:R});return s.apply(b,R)}}}let k=new i.SubscriptionManager,d=!1,p=[];function h(e){k.notify([e,a])}let u=null;function I(){if(u||d)return;let e=(0,i.createSnapshot)(a);u=(0,y.watch)(a,()=>{let n=(0,i.createSnapshot)(a),r=(0,i.diffObjects)(e,n);for(let s in r.added)h({storeId:o,type:"add",key:s,newValue:r.added[s]});for(let s in r.removed)h({storeId:o,type:"delete",key:s,oldValue:r.removed[s]});for(let s in r.changed)h({storeId:o,type:"set",key:s,newValue:r.changed[s].new,oldValue:r.changed[s].old});e=n},{deep:!0}),p.push(u)}function M(){if(!k.hasSubscribers()&&u){u();let e=p.indexOf(u);e!==-1&&p.splice(e,1),u=null}}let b={$id:o,get state(){return a},get getters(){return m},get actions(){return $},$expose(){return{state:a,getters:m}},$reset(){if(d)return;let e=Object.keys(a),n=Object.keys(c);for(let r of n)a[r]=c[r];for(let r of e)n.includes(r)||delete a[r]},$subscribe(e){if(d)return()=>{};let n=k.subscribe(([r,s])=>{e(r,s)});return I(),()=>{n(),M()}},$dispose(){if(!d){for(let e of p)e();p.length=0,u=null,k.clear(),l.delete(o),d=!0}},$patch(e){d||((0,i.isFunction)(e)?e(a):(0,i.mergeObjects)(a,e))},use(e){if(d)return()=>{};let n=e.install(b);return()=>{typeof n=="function"&&n()}},$onAction(e){return d?()=>{}:(g.push(e),()=>{let n=g.indexOf(e);n!==-1&&g.splice(n,1)})}};return l.set(o,b),()=>b}function j(){return Array.from(l.keys())}function C(){for(let[o,t]of l)t.$dispose();l.clear()}

package/dist/index.mjs

@@ -1 +1 @@
-import{reactive as w,computed as $,watch as j}from"@lytjs/reactivity";import{createSnapshot as h,diffObjects as C,mergeObjects as I,isFunction as M,SubscriptionManager as P}from"@lytjs/common";var d=new Map;function L(a){return d.get(a)}function V(a,r={}){if(d.has(a))return()=>d.get(a);let A=typeof r.state=="function"?r.state():r.state||{},R={};if(r.modules)for(let e of Object.keys(r.modules)){let t=r.modules[e],n=typeof t.state=="function"?t.state():t.state||{};R[e]={...n}}let b={...A,...R},s=w({...b}),S={};if(r.getters)for(let e of Object.keys(r.getters)){let t=r.getters[e],n=$(()=>t(s));Object.defineProperty(S,e,{get(){return n.value},enumerable:!0})}if(r.modules)for(let e of Object.keys(r.modules)){let t=r.modules[e];if(t.getters)for(let n of Object.keys(t.getters)){let o=t.getters[n],g=`${e}/${n}`,p=$(()=>{let k=s[e];return o(k)});Object.defineProperty(S,g,{get(){return p.value},enumerable:!0})}}let m={},u=[];if(r.actions)for(let e of Object.keys(r.actions)){let t=r.actions[e];m[e]=function(...n){for(let o of u)o({name:e,args:n});return t.apply(y,n)}}if(r.modules)for(let e of Object.keys(r.modules)){let t=r.modules[e];if(t.actions)for(let n of Object.keys(t.actions)){let o=t.actions[n],g=`${e}/${n}`;m[g]=function(...p){for(let k of u)k({name:g,args:p});return o.apply(y,p)}}}let f=new P,i=!1,l=[];function v(e){f.notify([e,s])}let c=null;function x(){if(c||i)return;let e=h(s);c=j(s,()=>{let t=h(s),n=C(e,t);for(let o in n.added)v({storeId:a,type:"add",key:o,newValue:n.added[o]});for(let o in n.removed)v({storeId:a,type:"delete",key:o,oldValue:n.removed[o]});for(let o in n.changed)v({storeId:a,type:"set",key:o,newValue:n.changed[o].new,oldValue:n.changed[o].old});e=t},{deep:!0}),l.push(c)}function O(){if(!f.hasSubscribers()&&c){c();let e=l.indexOf(c);e!==-1&&l.splice(e,1),c=null}}let y={$id:a,get state(){return s},get getters(){return S},get actions(){return m},$expose(){return{state:s,getters:S}},$reset(){if(i)return;let e=Object.keys(s),t=Object.keys(b);for(let n of t)s[n]=b[n];for(let n of e)t.includes(n)||delete s[n]},$subscribe(e){if(i)return()=>{};let t=f.subscribe(([n,o])=>{e(n,o)});return x(),()=>{t(),O()}},$dispose(){if(!i){for(let e of l)e();l.length=0,c=null,f.clear(),d.delete(a),i=!0}},$patch(e){i||(M(e)?e(s):I(s,e))},use(e){if(i)return()=>{};let t=e.install(y);return()=>{typeof t=="function"&&t()}},$onAction(e){return i?()=>{}:(u.push(e),()=>{let t=u.indexOf(e);t!==-1&&u.splice(t,1)})}};return d.set(a,y),()=>y}function W(){return Array.from(d.keys())}function F(){for(let[a,r]of d)r.$dispose();d.clear()}export{F as clearAllStores,V as createStore,L as getStore,W as getStoreIds};
+import{reactive as w,computed as $,watch as j}from"@lytjs/reactivity";import{createSnapshot as h,diffObjects as C,mergeObjects as I,isFunction as M,SubscriptionManager as P}from"@lytjs/common";var d=new Map;function L(a){return d.get(a)}function V(a,r={}){if(d.has(a))return()=>d.get(a);let A=typeof r.state=="function"?r.state():r.state||{},R={};if(r.modules)for(let e of Object.keys(r.modules)){let t=r.modules[e],n=typeof t.state=="function"?t.state():t.state||{};R[e]={...n}}let b={...A,...R},s=w({...b}),S={};if(r.getters)for(let e of Object.keys(r.getters)){let t=r.getters[e],n=$(()=>t(s));Object.defineProperty(S,e,{get(){return n.value},enumerable:!0})}if(r.modules)for(let e of Object.keys(r.modules)){let t=r.modules[e];if(t.getters)for(let n of Object.keys(t.getters)){let o=t.getters[n],g=`${e}/${n}`,p=$(()=>{let v=s[e];return o(v)});Object.defineProperty(S,g,{get(){return p.value},enumerable:!0})}}let m={},u=[];if(r.actions)for(let e of Object.keys(r.actions)){let t=r.actions[e];m[e]=function(...n){for(let o of u)o({name:e,args:n});return t.apply(y,n)}}if(r.modules)for(let e of Object.keys(r.modules)){let t=r.modules[e];if(t.actions)for(let n of Object.keys(t.actions)){let o=t.actions[n],g=`${e}/${n}`;m[g]=function(...p){for(let v of u)v({name:g,args:p});return o.apply(y,p)}}}let f=new P,i=!1,l=[];function k(e){f.notify([e,s])}let c=null;function x(){if(c||i)return;let e=h(s);c=j(s,()=>{let t=h(s),n=C(e,t);for(let o in n.added)k({storeId:a,type:"add",key:o,newValue:n.added[o]});for(let o in n.removed)k({storeId:a,type:"delete",key:o,oldValue:n.removed[o]});for(let o in n.changed)k({storeId:a,type:"set",key:o,newValue:n.changed[o].new,oldValue:n.changed[o].old});e=t},{deep:!0}),l.push(c)}function O(){if(!f.hasSubscribers()&&c){c();let e=l.indexOf(c);e!==-1&&l.splice(e,1),c=null}}let y={$id:a,get state(){return s},get getters(){return S},get actions(){return m},$expose(){return{state:s,getters:S}},$reset(){if(i)return;let e=Object.keys(s),t=Object.keys(b);for(let n of t)s[n]=b[n];for(let n of e)t.includes(n)||delete s[n]},$subscribe(e){if(i)return()=>{};let t=f.subscribe(([n,o])=>{e(n,o)});return x(),()=>{t(),O()}},$dispose(){if(!i){for(let e of l)e();l.length=0,c=null,f.clear(),d.delete(a),i=!0}},$patch(e){i||(M(e)?e(s):I(s,e))},use(e){if(i)return()=>{};let t=e.install(y);return()=>{typeof t=="function"&&t()}},$onAction(e){return i?()=>{}:(u.push(e),()=>{let t=u.indexOf(e);t!==-1&&u.splice(t,1)})}};return d.set(a,y),()=>y}function W(){return Array.from(d.keys())}function F(){for(let[a,r]of d)r.$dispose();d.clear()}export{F as clearAllStores,V as createStore,L as getStore,W as getStoreIds};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lytjs/store",
-  "version": "4.0.5",
+  "version": "4.2.0",
   "description": "Lyt.js 内置状态管理 - 轻量级全局状态管理，支持模块化和插件扩展",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -38,8 +38,8 @@
     "state-management"
   ],
   "dependencies": {
-    "@lytjs/common": "^4.0.5",
-    "@lytjs/reactivity": "^4.0.5"
+    "@lytjs/common": "^4.2.0",
+    "@lytjs/reactivity": "^4.2.0"
   },
   "engines": {
     "node": ">=18.0.0"