@awesome-ecs/abstract 0.27.0 → 0.28.0

package/dist/entities/index.d.cts

@@ -1,3 +1,3 @@
 import { a as IEntity, c as IEntityProxy, d as TypedEntityProxy, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy, u as RequiredProxies } from "../identity-component-uU0yDR-y.cjs";
-import { a as EntityUpdateType, c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, h as IEntityEventsManager, i as IEntityRepository, l as IEntitySnapshotProvider, m as IEntityEventsDispatcher, n as IEntityScheduler, o as IEntityUpdate, p as IEntityEvent, r as SchedulerPauseType, s as IEntityUpdateQueue, t as EntitySchedule, u as EntityEventSubscriptionFilter } from "../index-s3-CSfQd.cjs";
+import { a as EntityUpdateType, c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, h as IEntityEventsManager, i as IEntityRepository, l as IEntitySnapshotProvider, m as IEntityEventsDispatcher, n as IEntityScheduler, o as IEntityUpdate, p as IEntityEvent, r as SchedulerPauseType, s as IEntityUpdateQueue, t as EntitySchedule, u as EntityEventSubscriptionFilter } from "../index-C1Ojam4M.cjs";
 export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityProxy, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEntityUpdateQueue, IEventData, RequiredProxies, SchedulerPauseType, TypedEntityProxy };

package/dist/entities/index.d.mts

@@ -1,3 +1,3 @@
 import { a as IEntity, c as IEntityProxy, d as TypedEntityProxy, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy, u as RequiredProxies } from "../identity-component-CgzvgBVh.mjs";
-import { a as EntityUpdateType, c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, h as IEntityEventsManager, i as IEntityRepository, l as IEntitySnapshotProvider, m as IEntityEventsDispatcher, n as IEntityScheduler, o as IEntityUpdate, p as IEntityEvent, r as SchedulerPauseType, s as IEntityUpdateQueue, t as EntitySchedule, u as EntityEventSubscriptionFilter } from "../index-xgRroB4J.mjs";
+import { a as EntityUpdateType, c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, h as IEntityEventsManager, i as IEntityRepository, l as IEntitySnapshotProvider, m as IEntityEventsDispatcher, n as IEntityScheduler, o as IEntityUpdate, p as IEntityEvent, r as SchedulerPauseType, s as IEntityUpdateQueue, t as EntitySchedule, u as EntityEventSubscriptionFilter } from "../index-C0v9GTM7.mjs";
 export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityProxy, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEntityUpdateQueue, IEventData, RequiredProxies, SchedulerPauseType, TypedEntityProxy };

package/dist/factories/index.d.cts

@@ -1,6 +1,6 @@
 import { a as IEntity } from "../identity-component-uU0yDR-y.cjs";
 import { l as IPipelineContext, o as IPipeline } from "../index-BQojRXVz.cjs";
-import { n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, u as ISystemContext } from "../index-BPKNH5VY.cjs";
+import { n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, u as ISystemContext } from "../index-CrMUhuEK.cjs";
 
 //#region src/factories/context-factory.d.ts
 interface IContextFactory {

package/dist/factories/index.d.mts

@@ -1,6 +1,6 @@
 import { a as IEntity } from "../identity-component-CgzvgBVh.mjs";
 import { l as IPipelineContext, o as IPipeline } from "../index-DeYfvKO0.mjs";
-import { n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, u as ISystemContext } from "../index-Iv388eRi.mjs";
+import { n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, u as ISystemContext } from "../index-DQYLun1o.mjs";
 
 //#region src/factories/context-factory.d.ts
 interface IContextFactory {

package/dist/{index-xgRroB4J.d.mts → index-C0v9GTM7.d.mts}

@@ -110,22 +110,38 @@ interface IEntityEventsManager {
 /**
  * Event dispatcher for publishing events to interested entities.
  * Responsible for routing events to their subscribers through the update queue.
+ *
+ * Use `dispatchEvent` / `dispatchEvents` for targeted delivery (requires explicit targets).
+ * Use `broadcastEvent` / `broadcastEvents` for subscription-based delivery to all subscribers.
  */
 interface IEntityEventsDispatcher {
   /**
-   * Publishes a single event to subscribers.
-   * The event is routed based on subscriptions or explicit target(s).
+   * Publishes a single event to one or more explicit targets.
+   * The event is sent only to the specified target(s) — it does NOT fall back to subscriptions.
    * @param event - The event to dispatch.
-   * @param targets - Optional specific entities to send to. If provided, event is only sent to these targets.
+   * @param target - The entity or entities to send the event to.
    */
-  dispatchEvent(event: IEntityEvent<IEventData>, ...targets: IEntityProxy[]): void;
+  dispatchEvent(event: IEntityEvent<IEventData>, target: IEntityProxy | IEntityProxy[]): void;
   /**
-   * Publishes multiple events to subscribers.
-   * Efficiently dispatches an array of events in bulk.
+   * Publishes multiple events to one or more explicit targets.
+   * Each target receives all events in a single update.
    * @param events - The events to dispatch.
-   * @param targets - Optional specific entities to send to. If provided, events are only sent to these targets.
+   * @param target - The entity or entities to send the events to.
+   */
+  dispatchEvents(events: IEntityEvent<IEventData>[], target: IEntityProxy | IEntityProxy[]): void;
+  /**
+   * Broadcasts a single event to all subscribers registered for that event type.
+   * Uses the subscription registry to resolve targets. Use intentionally — this can
+   * generate O(N) queue entries where N is the subscriber count.
+   * @param event - The event to broadcast.
+   */
+  broadcastEvent(event: IEntityEvent<IEventData>): void;
+  /**
+   * Broadcasts multiple events to all subscribers.
+   * Events are grouped per subscriber so each receives a single update.
+   * @param events - The events to broadcast.
    */
-  dispatchEvents(events: IEntityEvent<IEventData>[], ...targets: IEntityProxy[]): void;
+  broadcastEvents(events: IEntityEvent<IEventData>[]): void;
 }
 //#endregion
 //#region src/entities/entity-snapshot.d.ts
@@ -396,4 +412,4 @@ interface IEntityScheduler {
 }
 //#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-xgRroB4J.d.mts.map
+//# sourceMappingURL=index-C0v9GTM7.d.mts.map

package/dist/{index-s3-CSfQd.d.cts → index-C1Ojam4M.d.cts}

@@ -110,22 +110,38 @@ interface IEntityEventsManager {
 /**
  * Event dispatcher for publishing events to interested entities.
  * Responsible for routing events to their subscribers through the update queue.
+ *
+ * Use `dispatchEvent` / `dispatchEvents` for targeted delivery (requires explicit targets).
+ * Use `broadcastEvent` / `broadcastEvents` for subscription-based delivery to all subscribers.
  */
 interface IEntityEventsDispatcher {
   /**
-   * Publishes a single event to subscribers.
-   * The event is routed based on subscriptions or explicit target(s).
+   * Publishes a single event to one or more explicit targets.
+   * The event is sent only to the specified target(s) — it does NOT fall back to subscriptions.
    * @param event - The event to dispatch.
-   * @param targets - Optional specific entities to send to. If provided, event is only sent to these targets.
+   * @param target - The entity or entities to send the event to.
    */
-  dispatchEvent(event: IEntityEvent<IEventData>, ...targets: IEntityProxy[]): void;
+  dispatchEvent(event: IEntityEvent<IEventData>, target: IEntityProxy | IEntityProxy[]): void;
   /**
-   * Publishes multiple events to subscribers.
-   * Efficiently dispatches an array of events in bulk.
+   * Publishes multiple events to one or more explicit targets.
+   * Each target receives all events in a single update.
    * @param events - The events to dispatch.
-   * @param targets - Optional specific entities to send to. If provided, events are only sent to these targets.
+   * @param target - The entity or entities to send the events to.
+   */
+  dispatchEvents(events: IEntityEvent<IEventData>[], target: IEntityProxy | IEntityProxy[]): void;
+  /**
+   * Broadcasts a single event to all subscribers registered for that event type.
+   * Uses the subscription registry to resolve targets. Use intentionally — this can
+   * generate O(N) queue entries where N is the subscriber count.
+   * @param event - The event to broadcast.
+   */
+  broadcastEvent(event: IEntityEvent<IEventData>): void;
+  /**
+   * Broadcasts multiple events to all subscribers.
+   * Events are grouped per subscriber so each receives a single update.
+   * @param events - The events to broadcast.
    */
-  dispatchEvents(events: IEntityEvent<IEventData>[], ...targets: IEntityProxy[]): void;
+  broadcastEvents(events: IEntityEvent<IEventData>[]): void;
 }
 //#endregion
 //#region src/entities/entity-snapshot.d.ts
@@ -396,4 +412,4 @@ interface IEntityScheduler {
 }
 //#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-s3-CSfQd.d.cts.map
+//# sourceMappingURL=index-C1Ojam4M.d.cts.map

package/dist/{index-BPKNH5VY.d.cts → index-CrMUhuEK.d.cts}

@@ -1,6 +1,6 @@
 import { a as IEntity, c as IEntityProxy, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy } from "./identity-component-uU0yDR-y.cjs";
 import { n as Immutable } from "./types-DLOd2zXO.cjs";
-import { c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, o as IEntityUpdate, p as IEntityEvent } from "./index-s3-CSfQd.cjs";
+import { c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, o as IEntityUpdate, p as IEntityEvent } from "./index-C1Ojam4M.cjs";
 import { a as ILogger, c as IJsonSerializer, r as PerformanceTimeEntry } from "./index-Cs9Eerjt.cjs";
 import { c as IMiddleware, l as IPipelineContext, o as IPipeline } from "./index-BQojRXVz.cjs";
 
@@ -12,20 +12,31 @@ import { c as IMiddleware, l as IPipelineContext, o as IPipeline } from "./index
  */
 interface ISystemContextEvents {
   /**
-   * Publishes an event to subscribers or specific targets.
-   * If targets are provided, event is sent only to those entities.
-   * Otherwise, event is routed to all subscribers based on subscription registry.
+   * Publishes an event to one or more explicit targets.
+   * The event is sent only to the specified target(s) — it does NOT fall back to subscriptions.
    * @param data - The event payload.
-   * @param targets - Optional specific entities to send to.
+   * @param target - The entity or entities to send the event to.
    */
-  dispatchEvent<TEventData extends IEventData>(data: TEventData, ...targets: IEntityProxy[]): void;
+  dispatchEvent<TEventData extends IEventData>(data: TEventData, target: IEntityProxy | IEntityProxy[]): void;
   /**
-   * Publishes multiple events in bulk.
-   * More efficient than calling dispatchEvent repeatedly.
+   * Publishes multiple events to one or more explicit targets.
+   * Each target receives all events in a single update.
    * @param data - Array of event payloads to dispatch.
-   * @param targets - Optional specific entities to send to.
+   * @param target - The entity or entities to send the events to.
    */
-  dispatchEvents<TEventData extends IEventData>(data: TEventData[], ...targets: IEntityProxy[]): void;
+  dispatchEvents<TEventData extends IEventData>(data: TEventData[], target: IEntityProxy | IEntityProxy[]): void;
+  /**
+   * Broadcasts an event to all subscribers registered for that event type.
+   * Uses the subscription registry to resolve targets.
+   * @param data - The event payload.
+   */
+  broadcastEvent<TEventData extends IEventData>(data: TEventData): void;
+  /**
+   * Broadcasts multiple events to all subscribers.
+   * Events are grouped per subscriber so each receives a single update.
+   * @param data - Array of event payloads to broadcast.
+   */
+  broadcastEvents<TEventData extends IEventData>(data: TEventData[]): void;
   /**
    * Retrieves an event from the current context by its identifier.
    * Useful for checking if an event was received this frame.
@@ -530,4 +541,4 @@ interface ISystemsRuntimeContext<TEntity extends IEntity> extends IPipelineConte
 type ISystemsRuntimeMiddleware<TEntity extends IEntity> = IMiddleware<ISystemsRuntimeContext<TEntity>>;
 //#endregion
 export { ISystemsModuleRepository as a, ISystemsModule as c, ISystemContextSnapshot as d, ISystemContextScheduler as f, ISystemContextEvents as h, ISystemContextEntity as i, SystemType as l, ISystemContextProxies as m, ISystemsRuntimeContext as n, ISystemsModuleBuilder as o, ISystemContextRepository as p, ISystemsRuntime as r, ISystemMiddleware as s, ISystemsRuntimeMiddleware as t, ISystemContext as u };
-//# sourceMappingURL=index-BPKNH5VY.d.cts.map
+//# sourceMappingURL=index-CrMUhuEK.d.cts.map

package/dist/{index-Iv388eRi.d.mts → index-DQYLun1o.d.mts}

@@ -1,6 +1,6 @@
 import { a as IEntity, c as IEntityProxy, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy } from "./identity-component-CgzvgBVh.mjs";
 import { n as Immutable } from "./types-CnDtpKsY.mjs";
-import { c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, o as IEntityUpdate, p as IEntityEvent } from "./index-xgRroB4J.mjs";
+import { c as IEntitySnapshot, d as EntityEventSubscriptionOptions, f as EntityEventUid, g as IEventData, o as IEntityUpdate, p as IEntityEvent } from "./index-C0v9GTM7.mjs";
 import { a as ILogger, c as IJsonSerializer, r as PerformanceTimeEntry } from "./index-hHkhvmkO.mjs";
 import { c as IMiddleware, l as IPipelineContext, o as IPipeline } from "./index-DeYfvKO0.mjs";
 
@@ -12,20 +12,31 @@ import { c as IMiddleware, l as IPipelineContext, o as IPipeline } from "./index
  */
 interface ISystemContextEvents {
   /**
-   * Publishes an event to subscribers or specific targets.
-   * If targets are provided, event is sent only to those entities.
-   * Otherwise, event is routed to all subscribers based on subscription registry.
+   * Publishes an event to one or more explicit targets.
+   * The event is sent only to the specified target(s) — it does NOT fall back to subscriptions.
    * @param data - The event payload.
-   * @param targets - Optional specific entities to send to.
+   * @param target - The entity or entities to send the event to.
    */
-  dispatchEvent<TEventData extends IEventData>(data: TEventData, ...targets: IEntityProxy[]): void;
+  dispatchEvent<TEventData extends IEventData>(data: TEventData, target: IEntityProxy | IEntityProxy[]): void;
   /**
-   * Publishes multiple events in bulk.
-   * More efficient than calling dispatchEvent repeatedly.
+   * Publishes multiple events to one or more explicit targets.
+   * Each target receives all events in a single update.
    * @param data - Array of event payloads to dispatch.
-   * @param targets - Optional specific entities to send to.
+   * @param target - The entity or entities to send the events to.
    */
-  dispatchEvents<TEventData extends IEventData>(data: TEventData[], ...targets: IEntityProxy[]): void;
+  dispatchEvents<TEventData extends IEventData>(data: TEventData[], target: IEntityProxy | IEntityProxy[]): void;
+  /**
+   * Broadcasts an event to all subscribers registered for that event type.
+   * Uses the subscription registry to resolve targets.
+   * @param data - The event payload.
+   */
+  broadcastEvent<TEventData extends IEventData>(data: TEventData): void;
+  /**
+   * Broadcasts multiple events to all subscribers.
+   * Events are grouped per subscriber so each receives a single update.
+   * @param data - Array of event payloads to broadcast.
+   */
+  broadcastEvents<TEventData extends IEventData>(data: TEventData[]): void;
   /**
    * Retrieves an event from the current context by its identifier.
    * Useful for checking if an event was received this frame.
@@ -530,4 +541,4 @@ interface ISystemsRuntimeContext<TEntity extends IEntity> extends IPipelineConte
 type ISystemsRuntimeMiddleware<TEntity extends IEntity> = IMiddleware<ISystemsRuntimeContext<TEntity>>;
 //#endregion
 export { ISystemsModuleRepository as a, ISystemsModule as c, ISystemContextSnapshot as d, ISystemContextScheduler as f, ISystemContextEvents as h, ISystemContextEntity as i, SystemType as l, ISystemContextProxies as m, ISystemsRuntimeContext as n, ISystemsModuleBuilder as o, ISystemContextRepository as p, ISystemsRuntime as r, ISystemMiddleware as s, ISystemsRuntimeMiddleware as t, ISystemContext as u };
-//# sourceMappingURL=index-Iv388eRi.d.mts.map
+//# sourceMappingURL=index-DQYLun1o.d.mts.map

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-BPKNH5VY.cjs";
+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-CrMUhuEK.cjs";
 export { ISystemContext, ISystemContextEntity, 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-Iv388eRi.mjs";
+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-DQYLun1o.mjs";
 export { ISystemContext, ISystemContextEntity, ISystemContextEvents, ISystemContextProxies, ISystemContextRepository, ISystemContextScheduler, ISystemContextSnapshot, ISystemMiddleware, ISystemsModule, ISystemsModuleBuilder, ISystemsModuleRepository, ISystemsRuntime, ISystemsRuntimeContext, ISystemsRuntimeMiddleware, SystemType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesome-ecs/abstract",
-  "version": "0.27.0",
+  "version": "0.28.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": "2497216453c86197b6a5e15e7a569b9ccf79a1f1"
+  "gitHead": "41492d7ce0a5e4182798619fe238d0a6d4af6e5a"
 }