@awesome-ecs/abstract 0.26.0 → 0.28.0

package/dist/entities/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/entities/entity-queue.ts","../../src/entities/entity-scheduler.ts"],"sourcesContent":["import { IEntityModel } from './entity';\r\nimport { IEntityProxy } from './entity-proxies';\r\nimport { IEntitySnapshot } from './entity-snapshot';\r\n\r\n/**\r\n * Specifies the action to be performed on an entity.\r\n * Updates are categorized to enable different processing paths in the runtime.\r\n */\r\nexport enum EntityUpdateType {\r\n  /**\r\n   * Indicates the entity should be updated with new data.\r\n   */\r\n  update = 'update',\r\n  /**\r\n   * Indicates the entity should be removed from the system.\r\n   */\r\n  remove = 'remove'\r\n}\r\n\r\n/**\r\n * Represents a queued entity state change or removal.\r\n * Updates flow through the system to be processed by entity update handlers.\r\n */\r\nexport interface IEntityUpdate {\r\n  /**\r\n   * The type of operation: update or remove.\r\n   */\r\n  readonly type: EntityUpdateType;\r\n\r\n  /**\r\n   * The entity being affected by this update.\r\n   */\r\n  readonly entity: IEntityProxy;\r\n\r\n  /**\r\n   * Optional model data for initialization or reconfiguration.\r\n   */\r\n  readonly model?: IEntityModel;\r\n\r\n  /**\r\n   * Optional serialized state to apply to the entity.\r\n   */\r\n  readonly snapshot?: IEntitySnapshot;\r\n}\r\n\r\n/**\r\n * Queue interface for managing pending entity updates.\r\n * Different implementations may use different prioritization strategies (e.g., priority queues, FIFO, ordered by entity type).\r\n * Updates are consumed by the runtime and dispatched to appropriate entity systems.\r\n */\r\nexport interface IEntityUpdateQueue {\r\n  /**\r\n   * The current number of updates in the queue.\r\n   */\r\n  readonly size: number;\r\n\r\n  /**\r\n   * Adds an update to the queue for processing.\r\n   * @param change - The update to queue.\r\n   */\r\n  enqueue(change: IEntityUpdate): void;\r\n\r\n  /**\r\n   * Removes and returns the next update from the queue.\r\n   * The specific update returned depends on the queue's prioritization strategy.\r\n   * @returns The next queued update.\r\n   */\r\n  dequeue(): IEntityUpdate;\r\n\r\n  /**\r\n   * Views the next update without removing it.\r\n   * Useful for inspection before dequeuing.\r\n   * @returns The next update in the queue.\r\n   */\r\n  peek(): IEntityUpdate;\r\n\r\n  /**\r\n   * Removes all updates from the queue.\r\n   */\r\n  clear(): void;\r\n}\r\n","import { EntityTypeUid } from './entity';\nimport { IEntityProxy } from './entity-proxies';\n\n/**\n * Describes a scheduled entity update, including the target entity and optional interval.\n */\nexport type EntitySchedule = {\n  readonly proxy: IEntityProxy;\n  readonly intervalMs?: number;\n};\n\n/**\n * Controls which scheduling modes are paused.\n */\nexport enum SchedulerPauseType {\n  /** Pause both interval timers and frame subscriptions. */\n  full = 'full',\n  /** Pause only frame subscriptions. Interval timers continue firing. */\n  perFrame = 'perFrame',\n  /** Pause only interval timers. Frame subscriptions continue. */\n  intervals = 'intervals'\n}\n\n/**\n * Manages time-based scheduling of entity updates.\n *\n * Entities can be scheduled with an interval (timer-driven) or without one (per-frame).\n * The runtime pulls pending entities each tick via the {@link pending} iterator,\n * which yields both per-frame subscriptions and interval entities whose timer has fired.\n */\nexport interface IEntityScheduler {\n  /**\n   * Returns all currently scheduled entities with their configuration.\n   * Useful for inspection and debugging.\n   */\n  readonly schedules: ReadonlyArray<EntitySchedule>;\n\n  /**\n   * Yields entities pending processing this tick: per-frame subscriptions\n   * followed by interval entities whose timer has fired since the last drain.\n   * Iterating drains the due interval buckets; a second iteration without\n   * timer advancement yields only per-frame subscriptions.\n   */\n  readonly pending: IterableIterator<IEntityProxy>;\n\n  /**\n   * The set of entities scheduled for per-frame updates (no interval).\n   */\n  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;\n\n  /**\n   * The number of entities currently awaiting processing:\n   * per-frame subscriptions (if not paused) plus interval entities whose timer has fired.\n   */\n  readonly pendingCount: number;\n\n  /**\n   * Whether the scheduler is currently paused in any mode.\n   */\n  readonly isPaused: boolean;\n\n  /**\n   * Registers an entity for updates.\n   * @param entityProxy - The entity to schedule.\n   * @param intervalMs - Update frequency in milliseconds. If omitted, the entity is scheduled per-frame.\n   */\n  schedule(entityProxy: IEntityProxy, intervalMs?: number): void;\n\n  /**\n   * Unregisters an entity from the scheduler.\n   * @param entityProxy - The entity to unschedule.\n   */\n  remove(entityProxy: IEntityProxy): void;\n\n  /**\n   * Checks if an entity is currently scheduled for updates.\n   * @param entityProxy - The entity to check.\n   * @returns True if the entity is scheduled, false otherwise.\n   */\n  has(entityProxy: IEntityProxy): boolean;\n\n  /**\n   * Removes all schedules and clears all timers.\n   */\n  clear(): void;\n\n  /**\n   * Entity types currently excluded from {@link pending} iteration.\n   */\n  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;\n\n  /**\n   * Excludes an entity type from {@link pending} iteration.\n   * Entities remain registered; only yielding is suppressed.\n   */\n  skipEntityType(entityType: EntityTypeUid): void;\n\n  /**\n   * Re-includes a previously skipped entity type in {@link pending} iteration.\n   */\n  unskipEntityType(entityType: EntityTypeUid): void;\n\n  /**\n   * Pauses the scheduler.\n   * @param type - Which scheduling modes to pause. Defaults to {@link SchedulerPauseType.full}.\n   */\n  pause(type?: SchedulerPauseType): void;\n\n  /**\n   * Resumes the scheduler from any paused state.\n   */\n  resume(): void;\n}\n"],"mappings":";;;;;;AAQA,IAAY,8DAAL;;;;AAIL;;;;AAIA;;;;;;;;;ACFF,IAAY,kEAAL;;AAEL;;AAEA;;AAEA"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/entities/entity-queue.ts","../../src/entities/entity-scheduler.ts"],"sourcesContent":["import { IEntityModel } from './entity';\r\nimport { IEntityProxy } from './entity-proxies';\r\nimport { IEntitySnapshot } from './entity-snapshot';\r\n\r\n/**\r\n * Specifies the action to be performed on an entity.\r\n * Updates are categorized to enable different processing paths in the runtime.\r\n */\r\nexport enum EntityUpdateType {\r\n  /**\r\n   * Indicates the entity should be updated with new data.\r\n   */\r\n  update = 'update',\r\n  /**\r\n   * Indicates the entity should be removed from the system.\r\n   */\r\n  remove = 'remove'\r\n}\r\n\r\n/**\r\n * Represents a queued entity state change or removal.\r\n * Updates flow through the system to be processed by entity update handlers.\r\n */\r\nexport interface IEntityUpdate {\r\n  /**\r\n   * The type of operation: update or remove.\r\n   */\r\n  readonly type: EntityUpdateType;\r\n\r\n  /**\r\n   * The entity being affected by this update.\r\n   */\r\n  readonly entity: IEntityProxy;\r\n\r\n  /**\r\n   * Optional model data for initialization or reconfiguration.\r\n   */\r\n  readonly model?: IEntityModel;\r\n\r\n  /**\r\n   * Optional serialized state to apply to the entity.\r\n   */\r\n  readonly snapshot?: IEntitySnapshot;\r\n}\r\n\r\n/**\r\n * Queue interface for managing pending entity updates.\r\n * Different implementations may use different prioritization strategies (e.g., priority queues, FIFO, ordered by entity type).\r\n * Updates are consumed by the runtime and dispatched to appropriate entity systems.\r\n */\r\nexport interface IEntityUpdateQueue {\r\n  /**\r\n   * The current number of updates in the queue.\r\n   */\r\n  readonly size: number;\r\n\r\n  /**\r\n   * Adds an update to the queue for processing.\r\n   * @param change - The update to queue.\r\n   */\r\n  enqueue(change: IEntityUpdate): void;\r\n\r\n  /**\r\n   * Removes and returns the next update from the queue.\r\n   * The specific update returned depends on the queue's prioritization strategy.\r\n   * @returns The next queued update.\r\n   */\r\n  dequeue(): IEntityUpdate;\r\n\r\n  /**\r\n   * Views the next update without removing it.\r\n   * Useful for inspection before dequeuing.\r\n   * @returns The next update in the queue.\r\n   */\r\n  peek(): IEntityUpdate;\r\n\r\n  /**\r\n   * Removes all updates from the queue.\r\n   */\r\n  clear(): void;\r\n}\r\n","import { EntityTypeUid } from './entity';\r\nimport { IEntityProxy } from './entity-proxies';\r\n\r\n/**\r\n * Describes a scheduled entity update, including the target entity and optional interval.\r\n */\r\nexport type EntitySchedule = {\r\n  readonly proxy: IEntityProxy;\r\n  readonly intervalMs?: number;\r\n};\r\n\r\n/**\r\n * Controls which scheduling modes are paused.\r\n */\r\nexport enum SchedulerPauseType {\r\n  /** Pause both interval timers and frame subscriptions. */\r\n  full = 'full',\r\n  /** Pause only frame subscriptions. Interval timers continue firing. */\r\n  perFrame = 'perFrame',\r\n  /** Pause only interval timers. Frame subscriptions continue. */\r\n  intervals = 'intervals'\r\n}\r\n\r\n/**\r\n * Manages time-based scheduling of entity updates.\r\n *\r\n * Entities can be scheduled with an interval (timer-driven) or without one (per-frame).\r\n * The runtime pulls pending entities each tick via the {@link pending} iterator,\r\n * which yields both per-frame subscriptions and interval entities whose timer has fired.\r\n */\r\nexport interface IEntityScheduler {\r\n  /**\r\n   * Returns all currently scheduled entities with their configuration.\r\n   * Useful for inspection and debugging.\r\n   */\r\n  readonly schedules: ReadonlyArray<EntitySchedule>;\r\n\r\n  /**\r\n   * Yields entities pending processing this tick: per-frame subscriptions\r\n   * followed by interval entities whose timer has fired since the last drain.\r\n   * Iterating drains the due interval buckets; a second iteration without\r\n   * timer advancement yields only per-frame subscriptions.\r\n   */\r\n  readonly pending: IterableIterator<IEntityProxy>;\r\n\r\n  /**\r\n   * The set of entities scheduled for per-frame updates (no interval).\r\n   */\r\n  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;\r\n\r\n  /**\r\n   * Entity types currently excluded from {@link pending} iteration.\r\n   */\r\n  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;\r\n\r\n  /**\r\n   * The number of entities currently awaiting processing:\r\n   * per-frame subscriptions (if not paused) plus interval entities whose timer has fired.\r\n   */\r\n  readonly pendingCount: number;\r\n\r\n  /**\r\n   * Whether the scheduler is currently paused in any mode.\r\n   */\r\n  readonly isPaused: boolean;\r\n\r\n  /**\r\n   * Registers an entity for updates.\r\n   * @param entityProxy - The entity to schedule.\r\n   * @param intervalMs - Update frequency in milliseconds. If omitted, the entity is scheduled per-frame.\r\n   */\r\n  schedule(entityProxy: IEntityProxy, intervalMs?: number): void;\r\n\r\n  /**\r\n   * Unregisters an entity from the scheduler.\r\n   * @param entityProxy - The entity to unschedule.\r\n   */\r\n  remove(entityProxy: IEntityProxy): void;\r\n\r\n  /**\r\n   * Checks if an entity is currently scheduled for updates.\r\n   * @param entityProxy - The entity to check.\r\n   * @returns True if the entity is scheduled, false otherwise.\r\n   */\r\n  has(entityProxy: IEntityProxy): boolean;\r\n\r\n  /**\r\n   * Removes all schedules and clears all timers.\r\n   */\r\n  clear(): void;\r\n\r\n  /**\r\n   * Excludes an entity type from {@link pending} iteration.\r\n   * Entities remain registered; only yielding is suppressed.\r\n   */\r\n  skipEntityType(entityType: EntityTypeUid): void;\r\n\r\n  /**\r\n   * Re-includes a previously skipped entity type in {@link pending} iteration.\r\n   */\r\n  unskipEntityType(entityType: EntityTypeUid): void;\r\n\r\n  /**\r\n   * Pauses the scheduler.\r\n   * @param type - Which scheduling modes to pause. Defaults to {@link SchedulerPauseType.full}.\r\n   */\r\n  pause(type?: SchedulerPauseType): void;\r\n\r\n  /**\r\n   * Resumes the scheduler from any paused state.\r\n   */\r\n  resume(): void;\r\n}\r\n"],"mappings":";;;;;;AAQA,IAAY,8DAAL;;;;AAIL;;;;AAIA;;;;;;;;;ACFF,IAAY,kEAAL;;AAEL;;AAEA;;AAEA"}

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-D_z9RbVT.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-ke1H7wmC.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/entities/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/entities/entity-queue.ts","../../src/entities/entity-scheduler.ts"],"sourcesContent":["import { IEntityModel } from './entity';\r\nimport { IEntityProxy } from './entity-proxies';\r\nimport { IEntitySnapshot } from './entity-snapshot';\r\n\r\n/**\r\n * Specifies the action to be performed on an entity.\r\n * Updates are categorized to enable different processing paths in the runtime.\r\n */\r\nexport enum EntityUpdateType {\r\n  /**\r\n   * Indicates the entity should be updated with new data.\r\n   */\r\n  update = 'update',\r\n  /**\r\n   * Indicates the entity should be removed from the system.\r\n   */\r\n  remove = 'remove'\r\n}\r\n\r\n/**\r\n * Represents a queued entity state change or removal.\r\n * Updates flow through the system to be processed by entity update handlers.\r\n */\r\nexport interface IEntityUpdate {\r\n  /**\r\n   * The type of operation: update or remove.\r\n   */\r\n  readonly type: EntityUpdateType;\r\n\r\n  /**\r\n   * The entity being affected by this update.\r\n   */\r\n  readonly entity: IEntityProxy;\r\n\r\n  /**\r\n   * Optional model data for initialization or reconfiguration.\r\n   */\r\n  readonly model?: IEntityModel;\r\n\r\n  /**\r\n   * Optional serialized state to apply to the entity.\r\n   */\r\n  readonly snapshot?: IEntitySnapshot;\r\n}\r\n\r\n/**\r\n * Queue interface for managing pending entity updates.\r\n * Different implementations may use different prioritization strategies (e.g., priority queues, FIFO, ordered by entity type).\r\n * Updates are consumed by the runtime and dispatched to appropriate entity systems.\r\n */\r\nexport interface IEntityUpdateQueue {\r\n  /**\r\n   * The current number of updates in the queue.\r\n   */\r\n  readonly size: number;\r\n\r\n  /**\r\n   * Adds an update to the queue for processing.\r\n   * @param change - The update to queue.\r\n   */\r\n  enqueue(change: IEntityUpdate): void;\r\n\r\n  /**\r\n   * Removes and returns the next update from the queue.\r\n   * The specific update returned depends on the queue's prioritization strategy.\r\n   * @returns The next queued update.\r\n   */\r\n  dequeue(): IEntityUpdate;\r\n\r\n  /**\r\n   * Views the next update without removing it.\r\n   * Useful for inspection before dequeuing.\r\n   * @returns The next update in the queue.\r\n   */\r\n  peek(): IEntityUpdate;\r\n\r\n  /**\r\n   * Removes all updates from the queue.\r\n   */\r\n  clear(): void;\r\n}\r\n","import { EntityTypeUid } from './entity';\nimport { IEntityProxy } from './entity-proxies';\n\n/**\n * Describes a scheduled entity update, including the target entity and optional interval.\n */\nexport type EntitySchedule = {\n  readonly proxy: IEntityProxy;\n  readonly intervalMs?: number;\n};\n\n/**\n * Controls which scheduling modes are paused.\n */\nexport enum SchedulerPauseType {\n  /** Pause both interval timers and frame subscriptions. */\n  full = 'full',\n  /** Pause only frame subscriptions. Interval timers continue firing. */\n  perFrame = 'perFrame',\n  /** Pause only interval timers. Frame subscriptions continue. */\n  intervals = 'intervals'\n}\n\n/**\n * Manages time-based scheduling of entity updates.\n *\n * Entities can be scheduled with an interval (timer-driven) or without one (per-frame).\n * The runtime pulls pending entities each tick via the {@link pending} iterator,\n * which yields both per-frame subscriptions and interval entities whose timer has fired.\n */\nexport interface IEntityScheduler {\n  /**\n   * Returns all currently scheduled entities with their configuration.\n   * Useful for inspection and debugging.\n   */\n  readonly schedules: ReadonlyArray<EntitySchedule>;\n\n  /**\n   * Yields entities pending processing this tick: per-frame subscriptions\n   * followed by interval entities whose timer has fired since the last drain.\n   * Iterating drains the due interval buckets; a second iteration without\n   * timer advancement yields only per-frame subscriptions.\n   */\n  readonly pending: IterableIterator<IEntityProxy>;\n\n  /**\n   * The set of entities scheduled for per-frame updates (no interval).\n   */\n  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;\n\n  /**\n   * The number of entities currently awaiting processing:\n   * per-frame subscriptions (if not paused) plus interval entities whose timer has fired.\n   */\n  readonly pendingCount: number;\n\n  /**\n   * Whether the scheduler is currently paused in any mode.\n   */\n  readonly isPaused: boolean;\n\n  /**\n   * Registers an entity for updates.\n   * @param entityProxy - The entity to schedule.\n   * @param intervalMs - Update frequency in milliseconds. If omitted, the entity is scheduled per-frame.\n   */\n  schedule(entityProxy: IEntityProxy, intervalMs?: number): void;\n\n  /**\n   * Unregisters an entity from the scheduler.\n   * @param entityProxy - The entity to unschedule.\n   */\n  remove(entityProxy: IEntityProxy): void;\n\n  /**\n   * Checks if an entity is currently scheduled for updates.\n   * @param entityProxy - The entity to check.\n   * @returns True if the entity is scheduled, false otherwise.\n   */\n  has(entityProxy: IEntityProxy): boolean;\n\n  /**\n   * Removes all schedules and clears all timers.\n   */\n  clear(): void;\n\n  /**\n   * Entity types currently excluded from {@link pending} iteration.\n   */\n  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;\n\n  /**\n   * Excludes an entity type from {@link pending} iteration.\n   * Entities remain registered; only yielding is suppressed.\n   */\n  skipEntityType(entityType: EntityTypeUid): void;\n\n  /**\n   * Re-includes a previously skipped entity type in {@link pending} iteration.\n   */\n  unskipEntityType(entityType: EntityTypeUid): void;\n\n  /**\n   * Pauses the scheduler.\n   * @param type - Which scheduling modes to pause. Defaults to {@link SchedulerPauseType.full}.\n   */\n  pause(type?: SchedulerPauseType): void;\n\n  /**\n   * Resumes the scheduler from any paused state.\n   */\n  resume(): void;\n}\n"],"mappings":";;;;;AAQA,IAAY,8DAAL;;;;AAIL;;;;AAIA;;;;;;;;;ACFF,IAAY,kEAAL;;AAEL;;AAEA;;AAEA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/entities/entity-queue.ts","../../src/entities/entity-scheduler.ts"],"sourcesContent":["import { IEntityModel } from './entity';\r\nimport { IEntityProxy } from './entity-proxies';\r\nimport { IEntitySnapshot } from './entity-snapshot';\r\n\r\n/**\r\n * Specifies the action to be performed on an entity.\r\n * Updates are categorized to enable different processing paths in the runtime.\r\n */\r\nexport enum EntityUpdateType {\r\n  /**\r\n   * Indicates the entity should be updated with new data.\r\n   */\r\n  update = 'update',\r\n  /**\r\n   * Indicates the entity should be removed from the system.\r\n   */\r\n  remove = 'remove'\r\n}\r\n\r\n/**\r\n * Represents a queued entity state change or removal.\r\n * Updates flow through the system to be processed by entity update handlers.\r\n */\r\nexport interface IEntityUpdate {\r\n  /**\r\n   * The type of operation: update or remove.\r\n   */\r\n  readonly type: EntityUpdateType;\r\n\r\n  /**\r\n   * The entity being affected by this update.\r\n   */\r\n  readonly entity: IEntityProxy;\r\n\r\n  /**\r\n   * Optional model data for initialization or reconfiguration.\r\n   */\r\n  readonly model?: IEntityModel;\r\n\r\n  /**\r\n   * Optional serialized state to apply to the entity.\r\n   */\r\n  readonly snapshot?: IEntitySnapshot;\r\n}\r\n\r\n/**\r\n * Queue interface for managing pending entity updates.\r\n * Different implementations may use different prioritization strategies (e.g., priority queues, FIFO, ordered by entity type).\r\n * Updates are consumed by the runtime and dispatched to appropriate entity systems.\r\n */\r\nexport interface IEntityUpdateQueue {\r\n  /**\r\n   * The current number of updates in the queue.\r\n   */\r\n  readonly size: number;\r\n\r\n  /**\r\n   * Adds an update to the queue for processing.\r\n   * @param change - The update to queue.\r\n   */\r\n  enqueue(change: IEntityUpdate): void;\r\n\r\n  /**\r\n   * Removes and returns the next update from the queue.\r\n   * The specific update returned depends on the queue's prioritization strategy.\r\n   * @returns The next queued update.\r\n   */\r\n  dequeue(): IEntityUpdate;\r\n\r\n  /**\r\n   * Views the next update without removing it.\r\n   * Useful for inspection before dequeuing.\r\n   * @returns The next update in the queue.\r\n   */\r\n  peek(): IEntityUpdate;\r\n\r\n  /**\r\n   * Removes all updates from the queue.\r\n   */\r\n  clear(): void;\r\n}\r\n","import { EntityTypeUid } from './entity';\r\nimport { IEntityProxy } from './entity-proxies';\r\n\r\n/**\r\n * Describes a scheduled entity update, including the target entity and optional interval.\r\n */\r\nexport type EntitySchedule = {\r\n  readonly proxy: IEntityProxy;\r\n  readonly intervalMs?: number;\r\n};\r\n\r\n/**\r\n * Controls which scheduling modes are paused.\r\n */\r\nexport enum SchedulerPauseType {\r\n  /** Pause both interval timers and frame subscriptions. */\r\n  full = 'full',\r\n  /** Pause only frame subscriptions. Interval timers continue firing. */\r\n  perFrame = 'perFrame',\r\n  /** Pause only interval timers. Frame subscriptions continue. */\r\n  intervals = 'intervals'\r\n}\r\n\r\n/**\r\n * Manages time-based scheduling of entity updates.\r\n *\r\n * Entities can be scheduled with an interval (timer-driven) or without one (per-frame).\r\n * The runtime pulls pending entities each tick via the {@link pending} iterator,\r\n * which yields both per-frame subscriptions and interval entities whose timer has fired.\r\n */\r\nexport interface IEntityScheduler {\r\n  /**\r\n   * Returns all currently scheduled entities with their configuration.\r\n   * Useful for inspection and debugging.\r\n   */\r\n  readonly schedules: ReadonlyArray<EntitySchedule>;\r\n\r\n  /**\r\n   * Yields entities pending processing this tick: per-frame subscriptions\r\n   * followed by interval entities whose timer has fired since the last drain.\r\n   * Iterating drains the due interval buckets; a second iteration without\r\n   * timer advancement yields only per-frame subscriptions.\r\n   */\r\n  readonly pending: IterableIterator<IEntityProxy>;\r\n\r\n  /**\r\n   * The set of entities scheduled for per-frame updates (no interval).\r\n   */\r\n  readonly frameSubscriptions: ReadonlySet<IEntityProxy>;\r\n\r\n  /**\r\n   * Entity types currently excluded from {@link pending} iteration.\r\n   */\r\n  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;\r\n\r\n  /**\r\n   * The number of entities currently awaiting processing:\r\n   * per-frame subscriptions (if not paused) plus interval entities whose timer has fired.\r\n   */\r\n  readonly pendingCount: number;\r\n\r\n  /**\r\n   * Whether the scheduler is currently paused in any mode.\r\n   */\r\n  readonly isPaused: boolean;\r\n\r\n  /**\r\n   * Registers an entity for updates.\r\n   * @param entityProxy - The entity to schedule.\r\n   * @param intervalMs - Update frequency in milliseconds. If omitted, the entity is scheduled per-frame.\r\n   */\r\n  schedule(entityProxy: IEntityProxy, intervalMs?: number): void;\r\n\r\n  /**\r\n   * Unregisters an entity from the scheduler.\r\n   * @param entityProxy - The entity to unschedule.\r\n   */\r\n  remove(entityProxy: IEntityProxy): void;\r\n\r\n  /**\r\n   * Checks if an entity is currently scheduled for updates.\r\n   * @param entityProxy - The entity to check.\r\n   * @returns True if the entity is scheduled, false otherwise.\r\n   */\r\n  has(entityProxy: IEntityProxy): boolean;\r\n\r\n  /**\r\n   * Removes all schedules and clears all timers.\r\n   */\r\n  clear(): void;\r\n\r\n  /**\r\n   * Excludes an entity type from {@link pending} iteration.\r\n   * Entities remain registered; only yielding is suppressed.\r\n   */\r\n  skipEntityType(entityType: EntityTypeUid): void;\r\n\r\n  /**\r\n   * Re-includes a previously skipped entity type in {@link pending} iteration.\r\n   */\r\n  unskipEntityType(entityType: EntityTypeUid): void;\r\n\r\n  /**\r\n   * Pauses the scheduler.\r\n   * @param type - Which scheduling modes to pause. Defaults to {@link SchedulerPauseType.full}.\r\n   */\r\n  pause(type?: SchedulerPauseType): void;\r\n\r\n  /**\r\n   * Resumes the scheduler from any paused state.\r\n   */\r\n  resume(): void;\r\n}\r\n"],"mappings":";;;;;AAQA,IAAY,8DAAL;;;;AAIL;;;;AAIA;;;;;;;;;ACFF,IAAY,kEAAL;;AAEL;;AAEA;;AAEA"}

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-cF9FviwN.cjs";
-import { n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, u as ISystemContext } from "../index-BoBx4MQT.cjs";
+import { l as IPipelineContext, o as IPipeline } from "../index-BQojRXVz.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-CyoGuBNw.mjs";
-import { n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, u as ISystemContext } from "../index-CBIhhk81.mjs";
+import { l as IPipelineContext, o as IPipeline } from "../index-DeYfvKO0.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-cF9FviwN.d.cts → index-BQojRXVz.d.cts}

@@ -1,5 +1,5 @@
 import { n as Immutable } from "./types-DLOd2zXO.cjs";
-import { r as PerformanceTimeEntry } from "./index-CmTRwW4W.cjs";
+import { r as PerformanceTimeEntry } from "./index-Cs9Eerjt.cjs";
 
 //#region src/pipelines/pipeline-context.d.ts
 /**
@@ -221,4 +221,4 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
 }
 //#endregion
 export { IParentMiddleware as a, IMiddleware as c, IParentContext as i, IPipelineContext as l, INestedContext as n, IPipeline as o, INestedMiddleware as r, IMiddlewareRunner as s, IPipelineRunner as t, PipelineRuntime as u };
-//# sourceMappingURL=index-cF9FviwN.d.cts.map
+//# sourceMappingURL=index-BQojRXVz.d.cts.map

package/dist/{index-ke1H7wmC.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.
    */
-  dispatchEvents(events: IEntityEvent<IEventData>[], ...targets: IEntityProxy[]): void;
+  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.
+   */
+  broadcastEvents(events: IEntityEvent<IEventData>[]): void;
 }
 //#endregion
 //#region src/entities/entity-snapshot.d.ts
@@ -341,6 +357,10 @@ interface IEntityScheduler {
    * The set of entities scheduled for per-frame updates (no interval).
    */
   readonly frameSubscriptions: ReadonlySet<IEntityProxy>;
+  /**
+   * Entity types currently excluded from {@link pending} iteration.
+   */
+  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;
   /**
    * The number of entities currently awaiting processing:
    * per-frame subscriptions (if not paused) plus interval entities whose timer has fired.
@@ -371,10 +391,6 @@ interface IEntityScheduler {
    * Removes all schedules and clears all timers.
    */
   clear(): void;
-  /**
-   * Entity types currently excluded from {@link pending} iteration.
-   */
-  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;
   /**
    * Excludes an entity type from {@link pending} iteration.
    * Entities remain registered; only yielding is suppressed.
@@ -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-ke1H7wmC.d.mts.map
+//# sourceMappingURL=index-C0v9GTM7.d.mts.map

package/dist/{index-D_z9RbVT.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.
    */
-  dispatchEvents(events: IEntityEvent<IEventData>[], ...targets: IEntityProxy[]): void;
+  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.
+   */
+  broadcastEvents(events: IEntityEvent<IEventData>[]): void;
 }
 //#endregion
 //#region src/entities/entity-snapshot.d.ts
@@ -341,6 +357,10 @@ interface IEntityScheduler {
    * The set of entities scheduled for per-frame updates (no interval).
    */
   readonly frameSubscriptions: ReadonlySet<IEntityProxy>;
+  /**
+   * Entity types currently excluded from {@link pending} iteration.
+   */
+  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;
   /**
    * The number of entities currently awaiting processing:
    * per-frame subscriptions (if not paused) plus interval entities whose timer has fired.
@@ -371,10 +391,6 @@ interface IEntityScheduler {
    * Removes all schedules and clears all timers.
    */
   clear(): void;
-  /**
-   * Entity types currently excluded from {@link pending} iteration.
-   */
-  readonly skippedEntityTypes: ReadonlySet<EntityTypeUid>;
   /**
    * Excludes an entity type from {@link pending} iteration.
    * Entities remain registered; only yielding is suppressed.
@@ -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-D_z9RbVT.d.cts.map
+//# sourceMappingURL=index-C1Ojam4M.d.cts.map

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

@@ -1,8 +1,8 @@
 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-D_z9RbVT.cjs";
-import { a as ILogger, c as IJsonSerializer, r as PerformanceTimeEntry } from "./index-CmTRwW4W.cjs";
-import { c as IMiddleware, l as IPipelineContext, o as IPipeline } from "./index-cF9FviwN.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";
 
 //#region src/systems/pipeline/system-context-events.d.ts
 /**
@@ -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.
@@ -188,6 +199,12 @@ interface ISystemContextScheduler {
    * @param target - Optional entity to unschedule. Defaults to current entity in context.
    */
   removeSchedule(target?: IEntityProxy): void;
+  /**
+   * Checks whether an entity has a scheduled update.
+   * If no target is specified, checks the current entity.
+   * @param target - Optional entity to check. Defaults to current entity in context.
+   */
+  hasSchedule(target?: IEntityProxy): boolean;
 }
 //#endregion
 //#region src/systems/pipeline/system-context-snapshot.d.ts
@@ -365,6 +382,14 @@ interface ISystemsModuleBuilder<TEntity extends IEntity> {
    * Accessible during and after construction.
    */
   readonly pipelines: ReadonlyMap<SystemType, IPipeline<ISystemContext<TEntity>>>;
+  /**
+   * Whether this entity type is a scope root.
+   */
+  readonly scopeRoot: boolean;
+  /**
+   * Whether this entity type is a scoped proxy.
+   */
+  readonly scopedProxy: boolean;
   /**
    * Registers middleware systems for a specific pipeline stage.
    * The middleware are added to the pipeline in the order provided.
@@ -516,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-BoBx4MQT.d.cts.map
+//# sourceMappingURL=index-CrMUhuEK.d.cts.map

package/dist/{index-Iqc9jR5E.d.mts → index-Cs9Eerjt.d.cts}

@@ -1,3 +1,17 @@
+//#region src/utils/dispatch-sequential.d.ts
+/**
+ * Executes a function for each item in an iterable, sequentially.
+ *
+ * Uses a sync fast-path: iterates synchronously until the first Promise is
+ * encountered, then switches to async for the remainder. If no item produces
+ * a Promise, the entire call stays synchronous with zero async overhead.
+ *
+ * @param items - The iterable to iterate over.
+ * @param fn - The function to call for each item. May return void or a Promise.
+ * @returns void if all calls were synchronous, or a Promise if any were async.
+ */
+declare function dispatchSequential<T>(items: Iterable<T>, fn: (item: T) => void | Promise<void>): void | Promise<void>;
+//#endregion
 //#region src/utils/json-serializer.d.ts
 /**
  * Custom JSON serialization and deserialization interface.
@@ -157,5 +171,5 @@ interface IPerformanceTimer {
   endTimer(timerUid: PerformanceTimerUid): PerformanceTimeEntry;
 }
 //#endregion
-export { ILogger as a, IJsonSerializer as c, PerformanceTimerUid as i, PerformanceMetricOptions as n, ILoggerOptions as o, PerformanceTimeEntry as r, LogLevel as s, IPerformanceTimer as t };
-//# sourceMappingURL=index-Iqc9jR5E.d.mts.map
+export { ILogger as a, IJsonSerializer as c, PerformanceTimerUid as i, dispatchSequential as l, PerformanceMetricOptions as n, ILoggerOptions as o, PerformanceTimeEntry as r, LogLevel as s, IPerformanceTimer as t };
+//# sourceMappingURL=index-Cs9Eerjt.d.cts.map

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

@@ -1,8 +1,8 @@
 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-ke1H7wmC.mjs";
-import { a as ILogger, c as IJsonSerializer, r as PerformanceTimeEntry } from "./index-Iqc9jR5E.mjs";
-import { c as IMiddleware, l as IPipelineContext, o as IPipeline } from "./index-CyoGuBNw.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";
 
 //#region src/systems/pipeline/system-context-events.d.ts
 /**
@@ -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.
@@ -188,6 +199,12 @@ interface ISystemContextScheduler {
    * @param target - Optional entity to unschedule. Defaults to current entity in context.
    */
   removeSchedule(target?: IEntityProxy): void;
+  /**
+   * Checks whether an entity has a scheduled update.
+   * If no target is specified, checks the current entity.
+   * @param target - Optional entity to check. Defaults to current entity in context.
+   */
+  hasSchedule(target?: IEntityProxy): boolean;
 }
 //#endregion
 //#region src/systems/pipeline/system-context-snapshot.d.ts
@@ -365,6 +382,14 @@ interface ISystemsModuleBuilder<TEntity extends IEntity> {
    * Accessible during and after construction.
    */
   readonly pipelines: ReadonlyMap<SystemType, IPipeline<ISystemContext<TEntity>>>;
+  /**
+   * Whether this entity type is a scope root.
+   */
+  readonly scopeRoot: boolean;
+  /**
+   * Whether this entity type is a scoped proxy.
+   */
+  readonly scopedProxy: boolean;
   /**
    * Registers middleware systems for a specific pipeline stage.
    * The middleware are added to the pipeline in the order provided.
@@ -516,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-CBIhhk81.d.mts.map
+//# sourceMappingURL=index-DQYLun1o.d.mts.map

package/dist/{index-CyoGuBNw.d.mts → index-DeYfvKO0.d.mts}

@@ -1,5 +1,5 @@
 import { n as Immutable } from "./types-CnDtpKsY.mjs";
-import { r as PerformanceTimeEntry } from "./index-Iqc9jR5E.mjs";
+import { r as PerformanceTimeEntry } from "./index-hHkhvmkO.mjs";
 
 //#region src/pipelines/pipeline-context.d.ts
 /**
@@ -221,4 +221,4 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
 }
 //#endregion
 export { IParentMiddleware as a, IMiddleware as c, IParentContext as i, IPipelineContext as l, INestedContext as n, IPipeline as o, INestedMiddleware as r, IMiddlewareRunner as s, IPipelineRunner as t, PipelineRuntime as u };
-//# sourceMappingURL=index-CyoGuBNw.d.mts.map
+//# sourceMappingURL=index-DeYfvKO0.d.mts.map

package/dist/{index-CmTRwW4W.d.cts → index-hHkhvmkO.d.mts}

@@ -1,3 +1,17 @@
+//#region src/utils/dispatch-sequential.d.ts
+/**
+ * Executes a function for each item in an iterable, sequentially.
+ *
+ * Uses a sync fast-path: iterates synchronously until the first Promise is
+ * encountered, then switches to async for the remainder. If no item produces
+ * a Promise, the entire call stays synchronous with zero async overhead.
+ *
+ * @param items - The iterable to iterate over.
+ * @param fn - The function to call for each item. May return void or a Promise.
+ * @returns void if all calls were synchronous, or a Promise if any were async.
+ */
+declare function dispatchSequential<T>(items: Iterable<T>, fn: (item: T) => void | Promise<void>): void | Promise<void>;
+//#endregion
 //#region src/utils/json-serializer.d.ts
 /**
  * Custom JSON serialization and deserialization interface.
@@ -157,5 +171,5 @@ interface IPerformanceTimer {
   endTimer(timerUid: PerformanceTimerUid): PerformanceTimeEntry;
 }
 //#endregion
-export { ILogger as a, IJsonSerializer as c, PerformanceTimerUid as i, PerformanceMetricOptions as n, ILoggerOptions as o, PerformanceTimeEntry as r, LogLevel as s, IPerformanceTimer as t };
-//# sourceMappingURL=index-CmTRwW4W.d.cts.map
+export { ILogger as a, IJsonSerializer as c, PerformanceTimerUid as i, dispatchSequential as l, PerformanceMetricOptions as n, ILoggerOptions as o, PerformanceTimeEntry as r, LogLevel as s, IPerformanceTimer as t };
+//# sourceMappingURL=index-hHkhvmkO.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-cF9FviwN.cjs";
+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-BQojRXVz.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-CyoGuBNw.mjs";
+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-DeYfvKO0.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-BoBx4MQT.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-CBIhhk81.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/dist/utils/index.cjs

@@ -1,4 +1,32 @@
 
+//#region src/utils/dispatch-sequential.ts
+/**
+* Executes a function for each item in an iterable, sequentially.
+*
+* Uses a sync fast-path: iterates synchronously until the first Promise is
+* encountered, then switches to async for the remainder. If no item produces
+* a Promise, the entire call stays synchronous with zero async overhead.
+*
+* @param items - The iterable to iterate over.
+* @param fn - The function to call for each item. May return void or a Promise.
+* @returns void if all calls were synchronous, or a Promise if any were async.
+*/
+function dispatchSequential(items, fn) {
+	const iterator = items[Symbol.iterator]();
+	for (let next = iterator.next(); !next.done; next = iterator.next()) {
+		const result = fn(next.value);
+		if (result instanceof Promise) return continueAsync(iterator, fn, result);
+	}
+}
+async function continueAsync(iterator, fn, pending) {
+	await pending;
+	for (let next = iterator.next(); !next.done; next = iterator.next()) {
+		const result = fn(next.value);
+		if (result instanceof Promise) await result;
+	}
+}
+
+//#endregion
 //#region src/utils/logger.ts
 /**
 * Logging severity levels in increasing order.
@@ -25,4 +53,5 @@ let LogLevel = /* @__PURE__ */ function(LogLevel) {
 
 //#endregion
 exports.LogLevel = LogLevel;
+exports.dispatchSequential = dispatchSequential;
 //# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/utils/logger.ts"],"sourcesContent":["/**\r\n * Logger interface for debug and diagnostic output.\r\n * Supports multiple log levels for controlling verbosity.\r\n * Implementations can target different outputs (console, file, remote, etc.).\r\n */\r\nexport interface ILogger {\r\n  /**\r\n   * Logs a message with a specified severity level.\r\n   * @param level - The severity level of the message.\r\n   * @param message - The primary message content.\r\n   * @param args - Additional arguments to include in the log output.\r\n   */\r\n  log(level: LogLevel, message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs detailed diagnostic information.\r\n   * Typically the lowest level, most verbose output.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  trace(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs debug-level information.\r\n   * Useful during development and troubleshooting.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  debug(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs warning-level messages.\r\n   * Indicates potentially problematic conditions.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  warn(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs error-level messages.\r\n   * Indicates error conditions that may require attention.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  error(message: any, ...args: any[]): void;\r\n}\r\n\r\n/**\r\n * Logging severity levels in increasing order.\r\n */\r\nexport enum LogLevel {\r\n  /**\r\n   * Most detailed, diagnostic-level logging.\r\n   */\r\n  trace,\r\n\r\n  /**\r\n   * Development and debugging information.\r\n   */\r\n  debug,\r\n\r\n  /**\r\n   * Warning-level conditions.\r\n   */\r\n  warn,\r\n\r\n  /**\r\n   * Error-level conditions.\r\n   */\r\n  error\r\n}\r\n\r\n/**\r\n * Configuration options for logger instances.\r\n */\r\nexport interface ILoggerOptions {\r\n  /**\r\n   * Enables/disables each log level.\r\n   * If a level is disabled, log calls at that level are ignored.\r\n   */\r\n  enabled: Map<LogLevel, boolean>;\r\n}\r\n"],"mappings":";;;;;AAkDA,IAAY,8CAAL;;;;AAIL;;;;AAKA;;;;AAKA;;;;AAKA"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/utils/dispatch-sequential.ts","../../src/utils/logger.ts"],"sourcesContent":["/**\r\n * Executes a function for each item in an iterable, sequentially.\r\n *\r\n * Uses a sync fast-path: iterates synchronously until the first Promise is\r\n * encountered, then switches to async for the remainder. If no item produces\r\n * a Promise, the entire call stays synchronous with zero async overhead.\r\n *\r\n * @param items - The iterable to iterate over.\r\n * @param fn - The function to call for each item. May return void or a Promise.\r\n * @returns void if all calls were synchronous, or a Promise if any were async.\r\n */\r\nexport function dispatchSequential<T>(\r\n  items: Iterable<T>,\r\n  fn: (item: T) => void | Promise<void>\r\n): void | Promise<void> {\r\n  const iterator = items[Symbol.iterator]();\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      return continueAsync(iterator, fn, result);\r\n    }\r\n  }\r\n}\r\n\r\nasync function continueAsync<T>(\r\n  iterator: Iterator<T>,\r\n  fn: (item: T) => void | Promise<void>,\r\n  pending: Promise<void>\r\n): Promise<void> {\r\n  await pending;\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      await result;\r\n    }\r\n  }\r\n}\r\n","/**\r\n * Logger interface for debug and diagnostic output.\r\n * Supports multiple log levels for controlling verbosity.\r\n * Implementations can target different outputs (console, file, remote, etc.).\r\n */\r\nexport interface ILogger {\r\n  /**\r\n   * Logs a message with a specified severity level.\r\n   * @param level - The severity level of the message.\r\n   * @param message - The primary message content.\r\n   * @param args - Additional arguments to include in the log output.\r\n   */\r\n  log(level: LogLevel, message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs detailed diagnostic information.\r\n   * Typically the lowest level, most verbose output.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  trace(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs debug-level information.\r\n   * Useful during development and troubleshooting.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  debug(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs warning-level messages.\r\n   * Indicates potentially problematic conditions.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  warn(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs error-level messages.\r\n   * Indicates error conditions that may require attention.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  error(message: any, ...args: any[]): void;\r\n}\r\n\r\n/**\r\n * Logging severity levels in increasing order.\r\n */\r\nexport enum LogLevel {\r\n  /**\r\n   * Most detailed, diagnostic-level logging.\r\n   */\r\n  trace,\r\n\r\n  /**\r\n   * Development and debugging information.\r\n   */\r\n  debug,\r\n\r\n  /**\r\n   * Warning-level conditions.\r\n   */\r\n  warn,\r\n\r\n  /**\r\n   * Error-level conditions.\r\n   */\r\n  error\r\n}\r\n\r\n/**\r\n * Configuration options for logger instances.\r\n */\r\nexport interface ILoggerOptions {\r\n  /**\r\n   * Enables/disables each log level.\r\n   * If a level is disabled, log calls at that level are ignored.\r\n   */\r\n  enabled: Map<LogLevel, boolean>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;AAWA,SAAgB,mBACd,OACA,IACsB;CACtB,MAAM,WAAW,MAAM,OAAO,WAAW;AAEzC,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,QAAO,cAAc,UAAU,IAAI,OAAO;;;AAKhD,eAAe,cACb,UACA,IACA,SACe;AACf,OAAM;AAEN,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,OAAM;;;;;;;;;ACaZ,IAAY,8CAAL;;;;AAIL;;;;AAKA;;;;AAKA;;;;AAKA"}

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-DLOd2zXO.cjs";
-import { a as ILogger, c as IJsonSerializer, i as PerformanceTimerUid, n as PerformanceMetricOptions, o as ILoggerOptions, r as PerformanceTimeEntry, s as LogLevel, t as IPerformanceTimer } from "../index-CmTRwW4W.cjs";
-export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid };
+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-Cs9Eerjt.cjs";
+export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, 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-CnDtpKsY.mjs";
-import { a as ILogger, c as IJsonSerializer, i as PerformanceTimerUid, n as PerformanceMetricOptions, o as ILoggerOptions, r as PerformanceTimeEntry, s as LogLevel, t as IPerformanceTimer } from "../index-Iqc9jR5E.mjs";
-export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid };
+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-hHkhvmkO.mjs";
+export { BooleanProps, IJsonSerializer, ILogger, ILoggerOptions, IPerformanceTimer, Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableObjectDeep, ImmutableSet, LogLevel, Mutable, MutableDeep, PerformanceMetricOptions, PerformanceTimeEntry, PerformanceTimerUid, dispatchSequential };

package/dist/utils/index.mjs

@@ -1,3 +1,31 @@
+//#region src/utils/dispatch-sequential.ts
+/**
+* Executes a function for each item in an iterable, sequentially.
+*
+* Uses a sync fast-path: iterates synchronously until the first Promise is
+* encountered, then switches to async for the remainder. If no item produces
+* a Promise, the entire call stays synchronous with zero async overhead.
+*
+* @param items - The iterable to iterate over.
+* @param fn - The function to call for each item. May return void or a Promise.
+* @returns void if all calls were synchronous, or a Promise if any were async.
+*/
+function dispatchSequential(items, fn) {
+	const iterator = items[Symbol.iterator]();
+	for (let next = iterator.next(); !next.done; next = iterator.next()) {
+		const result = fn(next.value);
+		if (result instanceof Promise) return continueAsync(iterator, fn, result);
+	}
+}
+async function continueAsync(iterator, fn, pending) {
+	await pending;
+	for (let next = iterator.next(); !next.done; next = iterator.next()) {
+		const result = fn(next.value);
+		if (result instanceof Promise) await result;
+	}
+}
+
+//#endregion
 //#region src/utils/logger.ts
 /**
 * Logging severity levels in increasing order.
@@ -23,5 +51,5 @@ let LogLevel = /* @__PURE__ */ function(LogLevel) {
 }({});
 
 //#endregion
-export { LogLevel };
+export { LogLevel, dispatchSequential };
 //# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/logger.ts"],"sourcesContent":["/**\r\n * Logger interface for debug and diagnostic output.\r\n * Supports multiple log levels for controlling verbosity.\r\n * Implementations can target different outputs (console, file, remote, etc.).\r\n */\r\nexport interface ILogger {\r\n  /**\r\n   * Logs a message with a specified severity level.\r\n   * @param level - The severity level of the message.\r\n   * @param message - The primary message content.\r\n   * @param args - Additional arguments to include in the log output.\r\n   */\r\n  log(level: LogLevel, message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs detailed diagnostic information.\r\n   * Typically the lowest level, most verbose output.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  trace(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs debug-level information.\r\n   * Useful during development and troubleshooting.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  debug(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs warning-level messages.\r\n   * Indicates potentially problematic conditions.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  warn(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs error-level messages.\r\n   * Indicates error conditions that may require attention.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  error(message: any, ...args: any[]): void;\r\n}\r\n\r\n/**\r\n * Logging severity levels in increasing order.\r\n */\r\nexport enum LogLevel {\r\n  /**\r\n   * Most detailed, diagnostic-level logging.\r\n   */\r\n  trace,\r\n\r\n  /**\r\n   * Development and debugging information.\r\n   */\r\n  debug,\r\n\r\n  /**\r\n   * Warning-level conditions.\r\n   */\r\n  warn,\r\n\r\n  /**\r\n   * Error-level conditions.\r\n   */\r\n  error\r\n}\r\n\r\n/**\r\n * Configuration options for logger instances.\r\n */\r\nexport interface ILoggerOptions {\r\n  /**\r\n   * Enables/disables each log level.\r\n   * If a level is disabled, log calls at that level are ignored.\r\n   */\r\n  enabled: Map<LogLevel, boolean>;\r\n}\r\n"],"mappings":";;;;AAkDA,IAAY,8CAAL;;;;AAIL;;;;AAKA;;;;AAKA;;;;AAKA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/dispatch-sequential.ts","../../src/utils/logger.ts"],"sourcesContent":["/**\r\n * Executes a function for each item in an iterable, sequentially.\r\n *\r\n * Uses a sync fast-path: iterates synchronously until the first Promise is\r\n * encountered, then switches to async for the remainder. If no item produces\r\n * a Promise, the entire call stays synchronous with zero async overhead.\r\n *\r\n * @param items - The iterable to iterate over.\r\n * @param fn - The function to call for each item. May return void or a Promise.\r\n * @returns void if all calls were synchronous, or a Promise if any were async.\r\n */\r\nexport function dispatchSequential<T>(\r\n  items: Iterable<T>,\r\n  fn: (item: T) => void | Promise<void>\r\n): void | Promise<void> {\r\n  const iterator = items[Symbol.iterator]();\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      return continueAsync(iterator, fn, result);\r\n    }\r\n  }\r\n}\r\n\r\nasync function continueAsync<T>(\r\n  iterator: Iterator<T>,\r\n  fn: (item: T) => void | Promise<void>,\r\n  pending: Promise<void>\r\n): Promise<void> {\r\n  await pending;\r\n\r\n  for (let next = iterator.next(); !next.done; next = iterator.next()) {\r\n    const result = fn(next.value);\r\n\r\n    if (result instanceof Promise) {\r\n      await result;\r\n    }\r\n  }\r\n}\r\n","/**\r\n * Logger interface for debug and diagnostic output.\r\n * Supports multiple log levels for controlling verbosity.\r\n * Implementations can target different outputs (console, file, remote, etc.).\r\n */\r\nexport interface ILogger {\r\n  /**\r\n   * Logs a message with a specified severity level.\r\n   * @param level - The severity level of the message.\r\n   * @param message - The primary message content.\r\n   * @param args - Additional arguments to include in the log output.\r\n   */\r\n  log(level: LogLevel, message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs detailed diagnostic information.\r\n   * Typically the lowest level, most verbose output.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  trace(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs debug-level information.\r\n   * Useful during development and troubleshooting.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  debug(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs warning-level messages.\r\n   * Indicates potentially problematic conditions.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  warn(message: any, ...args: any[]): void;\r\n\r\n  /**\r\n   * Logs error-level messages.\r\n   * Indicates error conditions that may require attention.\r\n   * @param message - The message to log.\r\n   * @param args - Additional data.\r\n   */\r\n  error(message: any, ...args: any[]): void;\r\n}\r\n\r\n/**\r\n * Logging severity levels in increasing order.\r\n */\r\nexport enum LogLevel {\r\n  /**\r\n   * Most detailed, diagnostic-level logging.\r\n   */\r\n  trace,\r\n\r\n  /**\r\n   * Development and debugging information.\r\n   */\r\n  debug,\r\n\r\n  /**\r\n   * Warning-level conditions.\r\n   */\r\n  warn,\r\n\r\n  /**\r\n   * Error-level conditions.\r\n   */\r\n  error\r\n}\r\n\r\n/**\r\n * Configuration options for logger instances.\r\n */\r\nexport interface ILoggerOptions {\r\n  /**\r\n   * Enables/disables each log level.\r\n   * If a level is disabled, log calls at that level are ignored.\r\n   */\r\n  enabled: Map<LogLevel, boolean>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,mBACd,OACA,IACsB;CACtB,MAAM,WAAW,MAAM,OAAO,WAAW;AAEzC,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,QAAO,cAAc,UAAU,IAAI,OAAO;;;AAKhD,eAAe,cACb,UACA,IACA,SACe;AACf,OAAM;AAEN,MAAK,IAAI,OAAO,SAAS,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO,SAAS,MAAM,EAAE;EACnE,MAAM,SAAS,GAAG,KAAK,MAAM;AAE7B,MAAI,kBAAkB,QACpB,OAAM;;;;;;;;;ACaZ,IAAY,8CAAL;;;;AAIL;;;;AAKA;;;;AAKA;;;;AAKA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesome-ecs/abstract",
-  "version": "0.26.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": "455478d411536325b36f39780c59941b14e633c4"
+  "gitHead": "41492d7ce0a5e4182798619fe238d0a6d4af6e5a"
 }