@inglorious/store 11.0.3 → 11.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inglorious/store",
-  "version": "11.0.3",
+  "version": "11.0.5",
   "description": "A state manager for real-time, collaborative apps, inspired by game development patterns and compatible with Redux.",
   "author": "Matteo Antony Mistretta <antony.mistretta@gmail.com> (https://ingloriouscoderz.it)",
   "license": "MIT",
@@ -62,7 +62,7 @@
     "@inglorious/utils": "5.0.0"
   },
   "devDependencies": {
-    "@inglorious/eslint-config": "1.1.2",
+    "@inglorious/eslint-config": "1.1.4",
     "@reduxjs/toolkit": "^2.12.0",
     "prettier": "^3.9.6",
     "vite": "^8.2.2",

package/src/store.js

@@ -332,7 +332,10 @@ export function createStore({
   }
 
   /**
-   * Sets an augmented type configuration given its name.
+   * Sets an augmented type configuration given its name. Replacing a type, as
+   * hot module reloading does, notifies subscribers, since what its entities
+   * render may have changed. Adding a type does not: the store is unchanged,
+   * and a type can be added while rendering.
    * @param {string} typeName - The name of the type to set.
    * @param {Type} type - The type configuration.
    * @returns {void}
@@ -358,6 +361,10 @@ export function createStore({
         type: typeName,
       })
     }
+
+    if (oldType) {
+      listeners.forEach((onUpdate) => onUpdate())
+    }
   }
 
   /**

package/types/api.d.ts

@@ -21,7 +21,11 @@ export interface Api<
     (): TState
     (typeName: string): TEntity[]
   }
-  getEntity: (id: string) => TEntity | undefined
+  /** A known id gives that entity's own type; any other id, the union. */
+  getEntity: {
+    <TId extends keyof TState & string>(id: TId): TState[TId] | undefined
+    (id: string): TEntity | undefined
+  }
   select: <TResult>(selector: (state: TState) => TResult) => TResult
   dispatch: (event: Event) => void
   notify: (type: string, payload?: any) => void

package/types/store.d.ts

@@ -25,9 +25,18 @@ export interface Event<T = any> {
  * off so that it stops.
  */
 export type EntityType<TEntity extends BaseEntity = BaseEntity> = {
-  [K: string]: (entity: TEntity, payload: any, api: Api) => void
+  [K: string]: EventHandler<TEntity>
 }
 
+/**
+ * A handler, checked as a method is: a type for a specific entity, such as
+ * `Api<AppEntity>`'s, then fits where `BaseEntity`'s is expected, so a component
+ * typed with the plain `Api` accepts an app's.
+ */
+type EventHandler<TEntity extends BaseEntity> = {
+  bivarianceHack(entity: TEntity, payload: any, api: Api): void
+}["bivarianceHack"]
+
 /**
  * System definition with event handlers
  */
@@ -78,8 +87,11 @@ export interface StoreConfig<
   TEntity extends BaseEntity = BaseEntity,
   TState extends EntitiesState<TEntity> = EntitiesState<TEntity>,
 > {
-  types?: TypesConfig<TEntity>
-  entities?: TState
+  // Types do not pick the entity type: their handlers accept any entity, so
+  // it comes from `entities`, `middlewares` or the explicit type arguments.
+  types?: TypesConfig<NoInfer<TEntity>>
+  /** The initial entities. With `autoCreateEntities`, those the store creates itself can be left out. */
+  entities?: Partial<TState>
   systems?: System<TState>[]
   middlewares?: Middleware<TEntity, TState>[]
   autoCreateEntities?: boolean
@@ -112,7 +124,10 @@ export interface Store<
   getType: (typeName: string) => EntityType<TEntity>
   setType: (typeName: string, type: EntityType<TEntity>) => void
   getState: () => TState
-  getEntity: (id: string) => TState[string] | undefined
+  getEntity: {
+    <TId extends keyof TState & string>(id: TId): TState[TId] | undefined
+    (id: string): TState[string] | undefined
+  }
   setState: (nextState: TState) => void
   reset: () => void
   _api?: Api<TEntity, TState>

package/types/test.d.ts

@@ -11,7 +11,10 @@ export interface MockApi<
     (): TState
     (typeName: string): TEntity[]
   }
-  getEntity: (id: string) => TEntity | undefined
+  getEntity: {
+    <TId extends keyof TState & string>(id: TId): TState[TId] | undefined
+    (id: string): TEntity | undefined
+  }
   select: <TResult>(selector: (state: TState) => TResult) => TResult
   dispatch: (event: Event) => void
   notify: (type: string, payload?: any) => void