@inglorious/store 8.0.1 → 9.0.0

package/README.md

@@ -30,7 +30,7 @@ Game engines solved state complexity years ago — Inglorious Store brings those
 - ✅ Entity-based state (manage multiple instances effortlessly)
 - ✅ No action creators, thunks, or slices
 - ✅ Predictable, testable, purely functional code
-- ✅ Built-in lifecycle events (`add`, `remove`, `morph`)
+- ✅ Built-in lifecycle events (`add`, `remove`)
 - ✅ 10x faster immutability than Redux Toolkit (Mutative vs Immer)
 
 ---
@@ -363,7 +363,6 @@ Inglorious Store has a few built-in events that you can use:
 
 - `add`: adds a new entity to the state. Triggers a `create` lifecycle event.
 - `remove`: removes an entity from the state. Triggers a `destroy` lifecycle event.
-- `morph`: changes the behavior of a type (advanced, used by middlewares/rendering systems)
 
 The lifecycle events can be used to define event handlers similar to constructor and destructor methods in OOP:
 
@@ -718,12 +717,12 @@ Each handler receives three arguments:
   - `dispatch(action)` - optional, if you prefer Redux-style dispatching
   - `getTypes()` - type definitions (for middleware)
   - `getType(typeName)` - type definition (for overriding)
+  - `setType(typeName, type)` - change the behavior of a type
 
 ### Built-in Events
 
 - **`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": "8.0.1",
+  "version": "9.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",
@@ -43,8 +43,8 @@
   },
   "files": [
     "src",
-    "!src/**/*.test.js",
-    "types"
+    "types",
+    "!src/**/*.test.js"
   ],
   "publishConfig": {
     "access": "public"

package/src/api.js

@@ -2,6 +2,7 @@ export function createApi(store, extras) {
   return {
     getTypes: store.getTypes,
     getType: store.getType,
+    setType: store.setType,
     getEntities: store.getState,
     getEntity: (id) => store.getState()[id],
     dispatch: store.dispatch,

package/src/event-map.js

@@ -44,7 +44,7 @@ export class EventMap {
 
   /**
    * Adds an entity's ID to the Sets for all event handlers defined in its type.
-   * This should be called when a new entity is created or its type is morphed.
+   * This should be called when a new entity is created or its type is changed via setType.
    *
    * @param {string} entityId - The ID of the entity.
    * @param {Type} type - The augmented type object of the entity.
@@ -71,7 +71,7 @@ export class EventMap {
 
   /**
    * Removes an entity's ID from the Sets for all event handlers defined in its type.
-   * This should be called when an entity is removed or its type is morphed.
+   * This should be called when an entity is removed or its type is changed via setType.
    *
    * @param {string} entityId - The ID of the entity.
    * @param {Type} type - The augmented type object of the entity.

package/src/store.js

@@ -37,6 +37,7 @@ export function createStore({
     dispatch, // needed for compatibility with Redux
     getTypes,
     getType,
+    setType,
     getState,
     setState,
     reset,
@@ -89,24 +90,6 @@ export function createStore({
         processedEvents.push(event)
 
         // Handle special system events
-        if (event.type === "morph") {
-          const { name, type } = event.payload
-
-          const oldType = types[name]
-
-          originalTypes[name] = type
-          types[name] = augmentType(type)
-          const newType = types[name]
-
-          for (const [id, entity] of Object.entries(draft)) {
-            if (entity.type === name) {
-              eventMap.removeEntity(id, oldType, name)
-              eventMap.addEntity(id, newType, name)
-            }
-          }
-          continue
-        }
-
         if (event.type === "add") {
           const { id, ...entity } = event.payload
           draft[id] = augmentEntity(id, entity)
@@ -200,6 +183,26 @@ export function createStore({
     return types[typeName]
   }
 
+  /**
+   * Sets an augmented type configuration given its name.
+   * @param {string} typeName - The name of the type to set.
+   * @param {Object} type - The type configuration.
+   */
+  function setType(typeName, type) {
+    const oldType = types[typeName]
+
+    originalTypes[typeName] = type
+    types[typeName] = augmentType(type)
+    const newType = types[typeName]
+
+    for (const [id, entity] of Object.entries(state)) {
+      if (entity.type === typeName) {
+        eventMap.removeEntity(id, oldType, typeName)
+        eventMap.addEntity(id, newType, typeName)
+      }
+    }
+  }
+
   /**
    * Retrieves the current state.
    * @returns {Object} The current state.

package/types/store.d.ts

@@ -75,6 +75,7 @@ export interface Api<
 > {
   getTypes: () => TypesConfig<TEntity>
   getType: (typeName: string) => EntityType<TEntity>
+  setType: (typeName: string, type: EntityType<TEntity>) => void
   getEntities: () => TState
   getEntity: (id: string) => TEntity | undefined
   dispatch: (event: Event) => void
@@ -95,6 +96,7 @@ export interface Store<
   dispatch: (event: Event) => void
   getTypes: () => TypesConfig<TEntity>
   getType: (typeName: string) => EntityType<TEntity>
+  setType: (typeName: string, type: EntityType<TEntity>) => void
   getState: () => TState
   setState: (nextState: TState) => void
   reset: () => void