@inglorious/store 7.1.3 → 8.0.0

package/README.md

@@ -367,18 +367,16 @@ Inglorious Store has a few built-in events that you can use:
 
 The lifecycle events can be used to define event handlers similar to constructor and destructor methods in OOP:
 
-> Remember: events are broadcast to all entities, just like with reducers! Each handler decides if it should respond. More on that in the section below.
+> Note: these special lifecycle events are not broadcast: they are visible only to the added/removed entity!
 
 ```javascript
 const types = {
   counter: {
-    create(entity, id) {
-      if (entity.id !== id) return // "are you talking to me?"
+    create(entity) {
       entity.createdAt = Date.now()
     },
 
-    destroy(entity, id) {
-      if (entity.id !== id) return // "are you talking to me?"
+    destroy(entity) {
       entity.destroyedAt = Date.now()
     },
   },
@@ -721,11 +719,11 @@ Each handler receives three arguments:
   - `getTypes()` - type definitions (for middleware)
   - `getType(typeName)` - type definition (for overriding)
 
-### Built-in Lifecycle Events
+### Built-in Events
 
-- **`create(entity, id)`** - triggered when entity added via `add` event
-- **`destroy(entity, id)`** - triggered when entity removed via `remove` event
-- **`morph(entity, newType)`** - triggered when entity type changes
+- **`create(entity)`** - triggered when entity added via `add` event, visible only to that entity
+- **`destroy(entity)`** - triggered when entity removed via `remove` event, visible only to that entity
+- **`morph(typeName, newType)`** - used to change the behavior of a type on the fly
 
 ### Notify vs Dispatch
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inglorious/store",
-  "version": "7.1.3",
+  "version": "8.0.0",
   "description": "A state manager for real-time, collaborative apps, inspired by game development patterns and compatible with Redux.",
   "author": "IceOnFire <antony.mistretta@gmail.com> (https://ingloriouscoderz.it)",
   "license": "MIT",

package/src/client/devtools.js

@@ -5,7 +5,7 @@ const LAST_STATE = 1
 // HMR-safe container to persist a single DevTools connection across Vite reloads.
 // Uses import.meta.hot.data when available (preferred), falls back to module scope.
 const globalContainer = import.meta.hot
-  ? (import.meta.hot.data.__INGLORIOUS_DEVTOOLS__ ??= {})
+  ? ((import.meta.hot.data ??= {}).__INGLORIOUS_DEVTOOLS__ ??= {})
   : {}
 
 // connection shape: {

package/src/store.js

@@ -17,12 +17,12 @@ import { augmentType, augmentTypes } from "./types.js"
  * @returns {Object} The store with methods to interact with state and events.
  */
 export function createStore({
-  types: originalTypes,
-  entities: originalEntities,
+  types: originalTypes = {},
+  entities: originalEntities = {},
   systems = [],
   middlewares = [],
   updateMode = "auto",
-}) {
+} = {}) {
   const listeners = new Set()
 
   const types = augmentTypes(originalTypes)
@@ -90,18 +90,20 @@ export function createStore({
 
         // Handle special system events
         if (event.type === "morph") {
-          const { id, type } = event.payload
+          const { name, type } = event.payload
 
-          const entity = draft[id]
-          const oldType = types[entity.type]
-          const oldTypeName = entity.type
+          const oldType = types[name]
 
-          originalTypes[entity.type] = type
-          types[entity.type] = augmentType(originalTypes[entity.type])
-          const newType = types[entity.type]
+          originalTypes[name] = type
+          types[name] = augmentType(type)
+          const newType = types[name]
 
-          eventMap.removeEntity(id, oldType, oldTypeName)
-          eventMap.addEntity(id, newType, oldTypeName) // Use the original type name
+          for (const [id, entity] of Object.entries(draft)) {
+            if (entity.type === name) {
+              eventMap.removeEntity(id, oldType, name)
+              eventMap.addEntity(id, newType, name)
+            }
+          }
           continue
         }
 
@@ -111,7 +113,7 @@ export function createStore({
           const type = types[entity.type]
 
           eventMap.addEntity(id, type, entity.type)
-          incomingEvents.unshift({ type: "create", payload: id })
+          incomingEvents.unshift({ type: `#${id}:create` })
           continue
         }
 
@@ -123,7 +125,7 @@ export function createStore({
           delete draft[id]
 
           eventMap.removeEntity(id, type, typeName)
-          incomingEvents.unshift({ type: "destroy", payload: id })
+          incomingEvents.unshift({ type: `#${id}:destroy` })
           continue
         }
 
@@ -231,11 +233,11 @@ export function createStore({
     )
 
     entitiesToCreate.forEach((id) => {
-      incomingEvents.push({ type: "create", payload: id })
+      incomingEvents.push({ type: `#${id}:create` })
     })
 
     entitiesToDestroy.forEach((id) => {
-      incomingEvents.push({ type: "destroy", payload: id })
+      incomingEvents.push({ type: `#${id}:destroy` })
     })
   }
 

package/src/store.test.js

@@ -169,7 +169,7 @@ test("it should change an entity's behavior via a 'morph' event", () => {
     bug: { id: "bug", type: "bug", isFull: true },
   })
 
-  store.notify("morph", { id: "bug", type: [Caterpillar, Butterfly] })
+  store.notify("morph", { name: "bug", type: [Caterpillar, Butterfly] })
   store.notify("fly")
   store.update()
   expect(store.getState()).toStrictEqual({