@awesome-ecs/abstract 0.29.0 → 0.30.0

package/dist/{index-DTHsTJ1j.d.cts → index-BguFn1Xj.d.cts}

@@ -1,5 +1,58 @@
-import { a as IEntity, c as IEntityProxy, n as IdentityComponent, o as IEntityModel, p as IComponent, r as EntityTypeUid } from "./identity-component-CsU-wYTX.cjs";
+import { S as IComponent, _ as IEntityProxy, f as EntityTypeUid, h as IEntityModel, m as IEntity, n as IdentityComponent, p as EntityUid } from "./identity-component-DLDaOTyK.cjs";
 
+//#region src/entities/entity-context-cache.d.ts
+/**
+ * A generic per-entity key-value store for runtime contexts.
+ *
+ * Each package registers its own per-entity data using its own key constants.
+ * Disposal removes all entries for an entity in a single call, covering all packages.
+ *
+ * @example
+ * // Core stores SystemContext:
+ * cache.set(entityUid, SYSTEM_KEY, systemContext);
+ *
+ * // AI stores per-module StateContexts:
+ * cache.set(entityUid, `state:${moduleName}`, stateContext);
+ *
+ * // On removal, one call cleans up everything:
+ * cache.disposeEntity(entityUid);
+ */
+interface IEntityContextCache {
+  /**
+   * Retrieves a cached value by entity UID and key.
+   * @template T - The expected value type.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - The key to look up.
+   * @returns The cached value, or undefined if not found.
+   */
+  get<T>(entityUid: EntityUid, key: string | symbol): T | undefined;
+  /**
+   * Stores a value for an entity under the given key.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - The key to store under.
+   * @param value - The value to cache.
+   */
+  set(entityUid: EntityUid, key: string | symbol, value: unknown): void;
+  /**
+   * Checks whether a cached entry exists.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - Optional key to check. If omitted, checks if any entry exists for the entity.
+   */
+  has(entityUid: EntityUid, key?: string | symbol): boolean;
+  /**
+   * Returns an iterator over all key-value pairs cached for the given entity.
+   * @param entityUid - The entity's unique identifier.
+   * @returns An iterable iterator of [key, value] pairs, or undefined if the entity has no entries.
+   */
+  getEntries(entityUid: EntityUid): IterableIterator<[string | symbol, unknown]> | undefined;
+  /**
+   * Removes all cached entries for the given entity.
+   * Should be called when an entity is removed from the system.
+   * @param entityUid - The entity's unique identifier.
+   */
+  disposeEntity(entityUid: EntityUid): void;
+}
+//#endregion
 //#region src/entities/entity-events.d.ts
 /**
  * Represents a unique identifier for an entity event.
@@ -255,6 +308,12 @@ interface IEntityUpdateQueue {
    * @returns The next update in the queue.
    */
   peek(): IEntityUpdate;
+  /**
+   * Returns a read-only snapshot of all queued updates without removing them.
+   * Useful for inspection/debugging UIs.
+   * @returns An array of all currently queued updates.
+   */
+  items(): ReadonlyArray<IEntityUpdate>;
   /**
    * Removes all updates from the queue.
    */
@@ -411,5 +470,5 @@ interface IEntityScheduler {
   resume(): void;
 }
 //#endregion
-export { EntityUpdateType as a, IEntitySnapshot as c, EntityEventSubscriptionOptions as d, EntityEventUid as f, IEventData as g, IEntityEventsManager as h, IEntityRepository as i, IEntitySnapshotProvider as l, IEntityEventsDispatcher as m, IEntityScheduler as n, IEntityUpdate as o, IEntityEvent as p, SchedulerPauseType as r, IEntityUpdateQueue as s, EntitySchedule as t, EntityEventSubscriptionFilter as u };
-//# sourceMappingURL=index-DTHsTJ1j.d.cts.map
+export { IEntityContextCache as _, EntityUpdateType as a, IEntitySnapshot as c, EntityEventSubscriptionOptions as d, EntityEventUid as f, IEventData as g, IEntityEventsManager as h, IEntityRepository as i, IEntitySnapshotProvider as l, IEntityEventsDispatcher as m, IEntityScheduler as n, IEntityUpdate as o, IEntityEvent as p, SchedulerPauseType as r, IEntityUpdateQueue as s, EntitySchedule as t, EntityEventSubscriptionFilter as u };
+//# sourceMappingURL=index-BguFn1Xj.d.cts.map

package/dist/{index-CBxqWVDf.d.mts → index-kNcUiDBd.d.mts}

@@ -1,5 +1,58 @@
-import { a as IEntity, c as IEntityProxy, n as IdentityComponent, o as IEntityModel, p as IComponent, r as EntityTypeUid } from "./identity-component-B3VGtdQW.mjs";
+import { S as IComponent, _ as IEntityProxy, f as EntityTypeUid, h as IEntityModel, m as IEntity, n as IdentityComponent, p as EntityUid } from "./identity-component-CuWHf7jX.mjs";
 
+//#region src/entities/entity-context-cache.d.ts
+/**
+ * A generic per-entity key-value store for runtime contexts.
+ *
+ * Each package registers its own per-entity data using its own key constants.
+ * Disposal removes all entries for an entity in a single call, covering all packages.
+ *
+ * @example
+ * // Core stores SystemContext:
+ * cache.set(entityUid, SYSTEM_KEY, systemContext);
+ *
+ * // AI stores per-module StateContexts:
+ * cache.set(entityUid, `state:${moduleName}`, stateContext);
+ *
+ * // On removal, one call cleans up everything:
+ * cache.disposeEntity(entityUid);
+ */
+interface IEntityContextCache {
+  /**
+   * Retrieves a cached value by entity UID and key.
+   * @template T - The expected value type.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - The key to look up.
+   * @returns The cached value, or undefined if not found.
+   */
+  get<T>(entityUid: EntityUid, key: string | symbol): T | undefined;
+  /**
+   * Stores a value for an entity under the given key.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - The key to store under.
+   * @param value - The value to cache.
+   */
+  set(entityUid: EntityUid, key: string | symbol, value: unknown): void;
+  /**
+   * Checks whether a cached entry exists.
+   * @param entityUid - The entity's unique identifier.
+   * @param key - Optional key to check. If omitted, checks if any entry exists for the entity.
+   */
+  has(entityUid: EntityUid, key?: string | symbol): boolean;
+  /**
+   * Returns an iterator over all key-value pairs cached for the given entity.
+   * @param entityUid - The entity's unique identifier.
+   * @returns An iterable iterator of [key, value] pairs, or undefined if the entity has no entries.
+   */
+  getEntries(entityUid: EntityUid): IterableIterator<[string | symbol, unknown]> | undefined;
+  /**
+   * Removes all cached entries for the given entity.
+   * Should be called when an entity is removed from the system.
+   * @param entityUid - The entity's unique identifier.
+   */
+  disposeEntity(entityUid: EntityUid): void;
+}
+//#endregion
 //#region src/entities/entity-events.d.ts
 /**
  * Represents a unique identifier for an entity event.
@@ -255,6 +308,12 @@ interface IEntityUpdateQueue {
    * @returns The next update in the queue.
    */
   peek(): IEntityUpdate;
+  /**
+   * Returns a read-only snapshot of all queued updates without removing them.
+   * Useful for inspection/debugging UIs.
+   * @returns An array of all currently queued updates.
+   */
+  items(): ReadonlyArray<IEntityUpdate>;
   /**
    * Removes all updates from the queue.
    */
@@ -411,5 +470,5 @@ interface IEntityScheduler {
   resume(): void;
 }
 //#endregion
-export { EntityUpdateType as a, IEntitySnapshot as c, EntityEventSubscriptionOptions as d, EntityEventUid as f, IEventData as g, IEntityEventsManager as h, IEntityRepository as i, IEntitySnapshotProvider as l, IEntityEventsDispatcher as m, IEntityScheduler as n, IEntityUpdate as o, IEntityEvent as p, SchedulerPauseType as r, IEntityUpdateQueue as s, EntitySchedule as t, EntityEventSubscriptionFilter as u };
-//# sourceMappingURL=index-CBxqWVDf.d.mts.map
+export { IEntityContextCache as _, EntityUpdateType as a, IEntitySnapshot as c, EntityEventSubscriptionOptions as d, EntityEventUid as f, IEventData as g, IEntityEventsManager as h, IEntityRepository as i, IEntitySnapshotProvider as l, IEntityEventsDispatcher as m, IEntityScheduler as n, IEntityUpdate as o, IEntityEvent as p, SchedulerPauseType as r, IEntityUpdateQueue as s, EntitySchedule as t, EntityEventSubscriptionFilter as u };
+//# sourceMappingURL=index-kNcUiDBd.d.mts.map

package/dist/pipelines/index.d.cts

@@ -1,2 +1,2 @@
-import { a as IParentMiddleware, c as IMiddleware, i as IParentContext, l as IPipelineContext, n as INestedContext, o as IPipeline, r as INestedMiddleware, s as IMiddlewareRunner, t as IPipelineRunner, u as PipelineRuntime } from "../index-BRkKPsOV.cjs";
+import { A as IMiddleware, C as IPipelineRunner, D as IParentMiddleware, E as IParentContext, M as PipelineRuntime, O as IPipeline, T as INestedMiddleware, j as IPipelineContext, k as IMiddlewareRunner, w as INestedContext } from "../index-BVkmidEx.cjs";
 export { IMiddleware, IMiddlewareRunner, INestedContext, INestedMiddleware, IParentContext, IParentMiddleware, IPipeline, IPipelineContext, IPipelineRunner, PipelineRuntime };

package/dist/pipelines/index.d.mts

@@ -1,2 +1,2 @@
-import { a as IParentMiddleware, c as IMiddleware, i as IParentContext, l as IPipelineContext, n as INestedContext, o as IPipeline, r as INestedMiddleware, s as IMiddlewareRunner, t as IPipelineRunner, u as PipelineRuntime } from "../index-C8yZ7-zP.mjs";
+import { A as IMiddleware, C as IPipelineRunner, D as IParentMiddleware, E as IParentContext, M as PipelineRuntime, O as IPipeline, T as INestedMiddleware, j as IPipelineContext, k as IMiddlewareRunner, w as INestedContext } from "../index-8XDo0pla.mjs";
 export { IMiddleware, IMiddlewareRunner, INestedContext, INestedMiddleware, IParentContext, IParentMiddleware, IPipeline, IPipelineContext, IPipelineRunner, PipelineRuntime };

package/dist/systems/index.d.cts

@@ -1,2 +1,2 @@
-import { a as ISystemsModuleRepository, c as ISystemsModule, d as ISystemContextSnapshot, f as ISystemContextScheduler, h as ISystemContextEvents, i as ISystemContextEntity, l as SystemType, m as ISystemContextProxies, n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, p as ISystemContextRepository, r as ISystemsRuntime, s as ISystemMiddleware, t as ISystemsRuntimeMiddleware, u as ISystemContext } from "../index-Df4VhCPr.cjs";
-export { ISystemContext, ISystemContextEntity, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };
+import { S as ISystemContextEvents, _ as ISystemContext, a as ISystemsRuntime, b as ISystemContextRepository, c as ISystemMiddleware, g as IMutableSystemContext, i as ISystemsRuntimeContext, l as ISystemsModule, o as ISystemsModuleRepository, r as ISystemsRuntimeMiddleware, s as ISystemsModuleBuilder, u as SystemType, v as ISystemContextSnapshot, x as ISystemContextProxies, y as ISystemContextScheduler } from "../index-BVkmidEx.cjs";
+export { IMutableSystemContext, ISystemContext, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };

package/dist/systems/index.d.mts

@@ -1,2 +1,2 @@
-import { a as ISystemsModuleRepository, c as ISystemsModule, d as ISystemContextSnapshot, f as ISystemContextScheduler, h as ISystemContextEvents, i as ISystemContextEntity, l as SystemType, m as ISystemContextProxies, n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, p as ISystemContextRepository, r as ISystemsRuntime, s as ISystemMiddleware, t as ISystemsRuntimeMiddleware, u as ISystemContext } from "../index-BC8RgFVd.mjs";
-export { ISystemContext, ISystemContextEntity, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };
+import { S as ISystemContextEvents, _ as ISystemContext, a as ISystemsRuntime, b as ISystemContextRepository, c as ISystemMiddleware, g as IMutableSystemContext, i as ISystemsRuntimeContext, l as ISystemsModule, o as ISystemsModuleRepository, r as ISystemsRuntimeMiddleware, s as ISystemsModuleBuilder, u as SystemType, v as ISystemContextSnapshot, x as ISystemContextProxies, y as ISystemContextScheduler } from "../index-8XDo0pla.mjs";
+export { IMutableSystemContext, ISystemContext, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };

package/dist/utils/index.d.cts

@@ -1,3 +1,3 @@
-import { a as ImmutableObject, c as Mutable, i as ImmutableMap, l as MutableDeep, n as Immutable, o as ImmutableObjectDeep, r as ImmutableArray, s as ImmutableSet, t as BooleanProps } from "../types-DqWnkvhp.cjs";
-import { a as ILogger, c as IJsonSerializer, i as PerformanceTimerUid, l as dispatchSequential, n as PerformanceMetricOptions, o as ILoggerOptions, r as PerformanceTimeEntry, s as LogLevel, t as IPerformanceTimer } from "../index-DCx0PjvH.cjs";
-export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, dispatchSequential };
+import { a as ImmutableArray, c as ImmutableObjectDeep, d as MutableDeep, i as Immutable, l as ImmutableSet, o as ImmutableMap, r as BooleanProps, s as ImmutableObject, u as Mutable } from "../identity-component-DLDaOTyK.cjs";
+import { B as TickSnapshot, F as PerformanceTimeEntry, G as dispatchSequential, H as ILoggerOptions, I as PerformanceTimerUid, L as MiddlewareMetricsSummary, N as IPerformanceTimer, P as PerformanceMetricOptions, R as RenderSnapshot, U as LogLevel, V as ILogger, W as IJsonSerializer, z as TickMetricEntry } from "../index-BVkmidEx.cjs";
+export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, MiddlewareMetricsSummary, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, RenderSnapshot, TickMetricEntry, TickSnapshot, dispatchSequential };

package/dist/utils/index.d.mts

@@ -1,3 +1,3 @@
-import { a as ImmutableObject, c as Mutable, i as ImmutableMap, l as MutableDeep, n as Immutable, o as ImmutableObjectDeep, r as ImmutableArray, s as ImmutableSet, t as BooleanProps } from "../types-aD9p7TDy.mjs";
-import { a as ILogger, c as IJsonSerializer, i as PerformanceTimerUid, l as dispatchSequential, n as PerformanceMetricOptions, o as ILoggerOptions, r as PerformanceTimeEntry, s as LogLevel, t as IPerformanceTimer } from "../index-EpAQRAeF.mjs";
-export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, dispatchSequential };
+import { a as ImmutableArray, c as ImmutableObjectDeep, d as MutableDeep, i as Immutable, l as ImmutableSet, o as ImmutableMap, r as BooleanProps, s as ImmutableObject, u as Mutable } from "../identity-component-CuWHf7jX.mjs";
+import { B as TickSnapshot, F as PerformanceTimeEntry, G as dispatchSequential, H as ILoggerOptions, I as PerformanceTimerUid, L as MiddlewareMetricsSummary, N as IPerformanceTimer, P as PerformanceMetricOptions, R as RenderSnapshot, U as LogLevel, V as ILogger, W as IJsonSerializer, z as TickMetricEntry } from "../index-8XDo0pla.mjs";
+export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, MiddlewareMetricsSummary, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, RenderSnapshot, TickMetricEntry, TickSnapshot, dispatchSequential };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesome-ecs/abstract",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "A comprehensive Entity-Component-System (ECS) Architecture implementation. Abstract components.",
   "type": "module",
   "scripts": {
@@ -97,5 +97,5 @@
     "url": "https://github.com/privatebytes/awesome-ecs/issues"
   },
   "homepage": "https://github.com/privatebytes/awesome-ecs#readme",
-  "gitHead": "37f8cf92c99229fac359cc6513e8a0abf002308b"
+  "gitHead": "e4f5e0176478cb0e32364b0df375c537acbdcb66"
 }