@awesome-ecs/abstract 0.29.0 → 0.31.0

package/dist/components/index.d.cts

@@ -1,2 +1,2 @@
-import { f as ComponentTypeUid, n as IdentityComponent, p as IComponent, t as BasicComponentType } from "../identity-component-CsU-wYTX.cjs";
+import { S as IComponent, n as IdentityComponent, t as BasicComponentType, x as ComponentTypeUid } from "../identity-component-DLDaOTyK.cjs";
 export { BasicComponentType, ComponentTypeUid, IComponent, IdentityComponent };

package/dist/components/index.d.mts

@@ -1,2 +1,2 @@
-import { f as ComponentTypeUid, n as IdentityComponent, p as IComponent, t as BasicComponentType } from "../identity-component-B3VGtdQW.mjs";
+import { S as IComponent, n as IdentityComponent, t as BasicComponentType, x as ComponentTypeUid } from "../identity-component-CuWHf7jX.mjs";
 export { BasicComponentType, ComponentTypeUid, IComponent, IdentityComponent };

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';\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,mBAAL,yBAAA,kBAAA;;;;AAIL,kBAAA,YAAA;;;;AAIA,kBAAA,YAAA;;KACD;;;;;;ACHD,IAAY,qBAAL,yBAAA,oBAAA;;AAEL,oBAAA,UAAA;;AAEA,oBAAA,cAAA;;AAEA,oBAAA,eAAA;;KACD"}
+{"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   * Returns a read-only snapshot of all queued updates without removing them.\r\n   * Useful for inspection/debugging UIs.\r\n   * @returns An array of all currently queued updates.\r\n   */\r\n  items(): ReadonlyArray<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,mBAAL,yBAAA,kBAAA;;;;AAIL,kBAAA,YAAA;;;;AAIA,kBAAA,YAAA;;KACD;;;;;;ACHD,IAAY,qBAAL,yBAAA,oBAAA;;AAEL,oBAAA,UAAA;;AAEA,oBAAA,cAAA;;AAEA,oBAAA,eAAA;;KACD"}

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-CsU-wYTX.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-DTHsTJ1j.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 };
+import { _ as IEntityProxy, b as TypedEntityProxy, f as EntityTypeUid, g as EntityProxy, h as IEntityModel, m as IEntity, p as EntityUid, v as IEntityProxyRepository, y as RequiredProxies } from "../identity-component-DLDaOTyK.cjs";
+import { _ as IEntityContextCache, 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-BguFn1Xj.cjs";
+export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityProxy, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityContextCache, 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-B3VGtdQW.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-CBxqWVDf.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 };
+import { _ as IEntityProxy, b as TypedEntityProxy, f as EntityTypeUid, g as EntityProxy, h as IEntityModel, m as IEntity, p as EntityUid, v as IEntityProxyRepository, y as RequiredProxies } from "../identity-component-CuWHf7jX.mjs";
+import { _ as IEntityContextCache, 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-kNcUiDBd.mjs";
+export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityProxy, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityContextCache, 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';\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,mBAAL,yBAAA,kBAAA;;;;AAIL,kBAAA,YAAA;;;;AAIA,kBAAA,YAAA;;KACD;;;;;;ACHD,IAAY,qBAAL,yBAAA,oBAAA;;AAEL,oBAAA,UAAA;;AAEA,oBAAA,cAAA;;AAEA,oBAAA,eAAA;;KACD"}
+{"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   * Returns a read-only snapshot of all queued updates without removing them.\r\n   * Useful for inspection/debugging UIs.\r\n   * @returns An array of all currently queued updates.\r\n   */\r\n  items(): ReadonlyArray<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,mBAAL,yBAAA,kBAAA;;;;AAIL,kBAAA,YAAA;;;;AAIA,kBAAA,YAAA;;KACD;;;;;;ACHD,IAAY,qBAAL,yBAAA,oBAAA;;AAEL,oBAAA,UAAA;;AAEA,oBAAA,cAAA;;AAEA,oBAAA,eAAA;;KACD"}

package/dist/factories/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import { IPipelineContext } from '../pipelines';\r\nimport { IPipeline } from '../pipelines/pipeline';\r\n\r\n/**\r\n * Category identifier for grouping performance metrics.\r\n * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.\r\n */\r\nexport type PipelineCategoryName = string;\r\n\r\n/**\r\n * Built-in metric categories for classifying pipeline and middleware performance entries.\r\n *\r\n * - `module` — System module pipelines (initialize, update, render, sync phases).\r\n * - `runtime` — Runtime orchestration pipeline and its middleware.\r\n * - `system` — Individual system middleware within a module pipeline.\r\n */\r\nexport enum PipelineCategory {\r\n  module = 'module',\r\n  runtime = 'runtime',\r\n  system = 'system'\r\n}\r\n\r\n/**\r\n * Options for identifying and categorizing performance metrics on pipelines.\r\n */\r\nexport type PipelineMetricOptions = {\r\n  /** Display name for the pipeline in performance metrics. */\r\n  pipelineName: string;\r\n  /** Category assigned to pipeline-level metric entries. */\r\n  pipelineCategory: PipelineCategoryName;\r\n  /** Category assigned to per-middleware metric entries within this pipeline. */\r\n  middlewareCategory: PipelineCategoryName;\r\n};\r\n\r\n/**\r\n * Creates pipeline instances for various contexts.\r\n * Abstracts pipeline creation to support different implementations.\r\n * Used by the system to instantiate pipelines without coupling to specific implementations.\r\n */\r\nexport interface IPipelineFactory {\r\n  /**\r\n   * Creates a new pipeline for the specified context type.\r\n   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.\r\n   * @param options - Optional performance metric options (name, category) for the pipeline.\r\n   * @returns A new pipeline instance ready for middleware registration.\r\n   */\r\n  createPipeline<TContext extends IPipelineContext>(\r\n    options?: PipelineMetricOptions\r\n  ): IPipeline<TContext>;\r\n}\r\n"],"mappings":";;;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;AACL,kBAAA,YAAA;AACA,kBAAA,aAAA;AACA,kBAAA,YAAA;;KACD"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import { IPipelineContext } from '../pipelines';\r\nimport { IPipeline } from '../pipelines/pipeline';\r\n\r\n/**\r\n * Category identifier for grouping performance metrics.\r\n * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.\r\n */\r\nexport type PipelineCategoryName = string;\r\n\r\n/**\r\n * Built-in metric categories for classifying pipeline and middleware performance entries.\r\n *\r\n * - `module` — System module pipelines (initialize, update, render, sync phases).\r\n * - `runtime` — Runtime orchestration pipeline and its middleware.\r\n * - `system` — Individual system middleware within a module pipeline.\r\n */\r\nexport enum PipelineCategory {\r\n  module = 'module',\r\n  runtime = 'runtime',\r\n  system = 'system'\r\n}\r\n\r\n/**\r\n * Options for identifying and categorizing performance metrics on pipelines.\r\n */\r\nexport type PipelineOptions = {\r\n  /** Display name for the pipeline in performance metrics. */\r\n  pipelineName: string;\r\n  /** Category assigned to pipeline-level metric entries. */\r\n  pipelineCategory: PipelineCategoryName;\r\n  /** Category assigned to per-middleware metric entries within this pipeline. */\r\n  middlewareCategory: PipelineCategoryName;\r\n};\r\n\r\n/**\r\n * Creates pipeline instances for various contexts.\r\n * Abstracts pipeline creation to support different implementations.\r\n * Used by the system to instantiate pipelines without coupling to specific implementations.\r\n */\r\nexport interface IPipelineFactory {\r\n  /**\r\n   * Creates a new pipeline for the specified context type.\r\n   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.\r\n   * @param options - Optional performance metric options (name, category) for the pipeline.\r\n   * @returns A new pipeline instance ready for middleware registration.\r\n   */\r\n  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;\r\n}\r\n"],"mappings":";;;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;AACL,kBAAA,YAAA;AACA,kBAAA,aAAA;AACA,kBAAA,YAAA;;KACD"}

package/dist/factories/index.d.cts

@@ -1,95 +1,2 @@
-import { a as IEntity } from "../identity-component-CsU-wYTX.cjs";
-import { l as IPipelineContext, o as IPipeline } from "../index-BRkKPsOV.cjs";
-import { n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, u as ISystemContext } from "../index-Df4VhCPr.cjs";
-
-//#region src/factories/context-factory.d.ts
-interface IContextFactory {
-  /**
-   * Creates a new system context for the given entity type.
-   * @template TEntity - The entity type for which the system context is being created.
-   * @returns A new context instance.
-   */
-  createSystemContext<TEntity extends IEntity>(): ISystemContext<TEntity>;
-}
-//#endregion
-//#region src/factories/pipeline-factory.d.ts
-/**
- * Category identifier for grouping performance metrics.
- * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.
- */
-type PipelineCategoryName = string;
-/**
- * Built-in metric categories for classifying pipeline and middleware performance entries.
- *
- * - `module` — System module pipelines (initialize, update, render, sync phases).
- * - `runtime` — Runtime orchestration pipeline and its middleware.
- * - `system` — Individual system middleware within a module pipeline.
- */
-declare enum PipelineCategory {
-  module = "module",
-  runtime = "runtime",
-  system = "system"
-}
-/**
- * Options for identifying and categorizing performance metrics on pipelines.
- */
-type PipelineMetricOptions = {
-  /** Display name for the pipeline in performance metrics. */pipelineName: string; /** Category assigned to pipeline-level metric entries. */
-  pipelineCategory: PipelineCategoryName; /** Category assigned to per-middleware metric entries within this pipeline. */
-  middlewareCategory: PipelineCategoryName;
-};
-/**
- * Creates pipeline instances for various contexts.
- * Abstracts pipeline creation to support different implementations.
- * Used by the system to instantiate pipelines without coupling to specific implementations.
- */
-interface IPipelineFactory {
-  /**
-   * Creates a new pipeline for the specified context type.
-   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.
-   * @param options - Optional performance metric options (name, category) for the pipeline.
-   * @returns A new pipeline instance ready for middleware registration.
-   */
-  createPipeline<TContext extends IPipelineContext>(options?: PipelineMetricOptions): IPipeline<TContext>;
-}
-//#endregion
-//#region src/factories/runtime-factory.d.ts
-/**
- * Creates runtime contexts and pipelines for system execution.
- * Provides factory methods for constructing runtime infrastructure.
- * Allows different runtime strategies through multiple implementations.
- */
-interface IRuntimeFactory {
-  /**
-   * Creates a new runtime context for system execution.
-   * @template TEntity - The entity type for the runtime context.
-   * @returns A new systems runtime context instance.
-   */
-  createRuntimeContext<TEntity extends IEntity>(): ISystemsRuntimeContext<TEntity>;
-  /**
-   * Creates a pipeline for systems runtime orchestration.
-   * @template TEntity - The entity type for this runtime pipeline.
-   * @param name - Optional name for debugging.
-   * @returns A new runtime pipeline for system execution.
-   */
-  createRuntimePipeline<TEntity extends IEntity>(name?: string): IPipeline<ISystemsRuntimeContext<TEntity>>;
-}
-//#endregion
-//#region src/factories/systems-factory.d.ts
-/**
- * Creates systems module builders for constructing entity system pipelines.
- * Provides factory access to module builder instances.
- * Enables composition of systems for different entity types.
- */
-interface ISystemsFactory {
-  /**
-   * Creates a new builder for constructing a systems module.
-   * @template TEntity - The entity type for which systems are being built.
-   * @param name - The System Builder's name.
-   * @returns A new systems module builder instance.
-   */
-  createSystemsModuleBuilder<TEntity extends IEntity>(name: string): ISystemsModuleBuilder<TEntity>;
-}
-//#endregion
-export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineMetricOptions };
-//# sourceMappingURL=index.d.cts.map
+import { d as IPipelineFactory, f as PipelineCategory, h as IContextFactory, m as PipelineOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-zohK7ftH.cjs";
+export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineOptions };

package/dist/factories/index.d.mts

@@ -1,95 +1,2 @@
-import { a as IEntity } from "../identity-component-B3VGtdQW.mjs";
-import { l as IPipelineContext, o as IPipeline } from "../index-C8yZ7-zP.mjs";
-import { n as ISystemsRuntimeContext, o as ISystemsModuleBuilder, u as ISystemContext } from "../index-BC8RgFVd.mjs";
-
-//#region src/factories/context-factory.d.ts
-interface IContextFactory {
-  /**
-   * Creates a new system context for the given entity type.
-   * @template TEntity - The entity type for which the system context is being created.
-   * @returns A new context instance.
-   */
-  createSystemContext<TEntity extends IEntity>(): ISystemContext<TEntity>;
-}
-//#endregion
-//#region src/factories/pipeline-factory.d.ts
-/**
- * Category identifier for grouping performance metrics.
- * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.
- */
-type PipelineCategoryName = string;
-/**
- * Built-in metric categories for classifying pipeline and middleware performance entries.
- *
- * - `module` — System module pipelines (initialize, update, render, sync phases).
- * - `runtime` — Runtime orchestration pipeline and its middleware.
- * - `system` — Individual system middleware within a module pipeline.
- */
-declare enum PipelineCategory {
-  module = "module",
-  runtime = "runtime",
-  system = "system"
-}
-/**
- * Options for identifying and categorizing performance metrics on pipelines.
- */
-type PipelineMetricOptions = {
-  /** Display name for the pipeline in performance metrics. */pipelineName: string; /** Category assigned to pipeline-level metric entries. */
-  pipelineCategory: PipelineCategoryName; /** Category assigned to per-middleware metric entries within this pipeline. */
-  middlewareCategory: PipelineCategoryName;
-};
-/**
- * Creates pipeline instances for various contexts.
- * Abstracts pipeline creation to support different implementations.
- * Used by the system to instantiate pipelines without coupling to specific implementations.
- */
-interface IPipelineFactory {
-  /**
-   * Creates a new pipeline for the specified context type.
-   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.
-   * @param options - Optional performance metric options (name, category) for the pipeline.
-   * @returns A new pipeline instance ready for middleware registration.
-   */
-  createPipeline<TContext extends IPipelineContext>(options?: PipelineMetricOptions): IPipeline<TContext>;
-}
-//#endregion
-//#region src/factories/runtime-factory.d.ts
-/**
- * Creates runtime contexts and pipelines for system execution.
- * Provides factory methods for constructing runtime infrastructure.
- * Allows different runtime strategies through multiple implementations.
- */
-interface IRuntimeFactory {
-  /**
-   * Creates a new runtime context for system execution.
-   * @template TEntity - The entity type for the runtime context.
-   * @returns A new systems runtime context instance.
-   */
-  createRuntimeContext<TEntity extends IEntity>(): ISystemsRuntimeContext<TEntity>;
-  /**
-   * Creates a pipeline for systems runtime orchestration.
-   * @template TEntity - The entity type for this runtime pipeline.
-   * @param name - Optional name for debugging.
-   * @returns A new runtime pipeline for system execution.
-   */
-  createRuntimePipeline<TEntity extends IEntity>(name?: string): IPipeline<ISystemsRuntimeContext<TEntity>>;
-}
-//#endregion
-//#region src/factories/systems-factory.d.ts
-/**
- * Creates systems module builders for constructing entity system pipelines.
- * Provides factory access to module builder instances.
- * Enables composition of systems for different entity types.
- */
-interface ISystemsFactory {
-  /**
-   * Creates a new builder for constructing a systems module.
-   * @template TEntity - The entity type for which systems are being built.
-   * @param name - The System Builder's name.
-   * @returns A new systems module builder instance.
-   */
-  createSystemsModuleBuilder<TEntity extends IEntity>(name: string): ISystemsModuleBuilder<TEntity>;
-}
-//#endregion
-export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineMetricOptions };
-//# sourceMappingURL=index.d.mts.map
+import { d as IPipelineFactory, f as PipelineCategory, h as IContextFactory, m as PipelineOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-DZlhICMZ.mjs";
+export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineOptions };

package/dist/factories/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import { IPipelineContext } from '../pipelines';\r\nimport { IPipeline } from '../pipelines/pipeline';\r\n\r\n/**\r\n * Category identifier for grouping performance metrics.\r\n * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.\r\n */\r\nexport type PipelineCategoryName = string;\r\n\r\n/**\r\n * Built-in metric categories for classifying pipeline and middleware performance entries.\r\n *\r\n * - `module` — System module pipelines (initialize, update, render, sync phases).\r\n * - `runtime` — Runtime orchestration pipeline and its middleware.\r\n * - `system` — Individual system middleware within a module pipeline.\r\n */\r\nexport enum PipelineCategory {\r\n  module = 'module',\r\n  runtime = 'runtime',\r\n  system = 'system'\r\n}\r\n\r\n/**\r\n * Options for identifying and categorizing performance metrics on pipelines.\r\n */\r\nexport type PipelineMetricOptions = {\r\n  /** Display name for the pipeline in performance metrics. */\r\n  pipelineName: string;\r\n  /** Category assigned to pipeline-level metric entries. */\r\n  pipelineCategory: PipelineCategoryName;\r\n  /** Category assigned to per-middleware metric entries within this pipeline. */\r\n  middlewareCategory: PipelineCategoryName;\r\n};\r\n\r\n/**\r\n * Creates pipeline instances for various contexts.\r\n * Abstracts pipeline creation to support different implementations.\r\n * Used by the system to instantiate pipelines without coupling to specific implementations.\r\n */\r\nexport interface IPipelineFactory {\r\n  /**\r\n   * Creates a new pipeline for the specified context type.\r\n   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.\r\n   * @param options - Optional performance metric options (name, category) for the pipeline.\r\n   * @returns A new pipeline instance ready for middleware registration.\r\n   */\r\n  createPipeline<TContext extends IPipelineContext>(\r\n    options?: PipelineMetricOptions\r\n  ): IPipeline<TContext>;\r\n}\r\n"],"mappings":";;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;AACL,kBAAA,YAAA;AACA,kBAAA,aAAA;AACA,kBAAA,YAAA;;KACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/factories/pipeline-factory.ts"],"sourcesContent":["import { IPipelineContext } from '../pipelines';\r\nimport { IPipeline } from '../pipelines/pipeline';\r\n\r\n/**\r\n * Category identifier for grouping performance metrics.\r\n * Typed as string to allow extension beyond the built-in {@link PipelineCategory} values.\r\n */\r\nexport type PipelineCategoryName = string;\r\n\r\n/**\r\n * Built-in metric categories for classifying pipeline and middleware performance entries.\r\n *\r\n * - `module` — System module pipelines (initialize, update, render, sync phases).\r\n * - `runtime` — Runtime orchestration pipeline and its middleware.\r\n * - `system` — Individual system middleware within a module pipeline.\r\n */\r\nexport enum PipelineCategory {\r\n  module = 'module',\r\n  runtime = 'runtime',\r\n  system = 'system'\r\n}\r\n\r\n/**\r\n * Options for identifying and categorizing performance metrics on pipelines.\r\n */\r\nexport type PipelineOptions = {\r\n  /** Display name for the pipeline in performance metrics. */\r\n  pipelineName: string;\r\n  /** Category assigned to pipeline-level metric entries. */\r\n  pipelineCategory: PipelineCategoryName;\r\n  /** Category assigned to per-middleware metric entries within this pipeline. */\r\n  middlewareCategory: PipelineCategoryName;\r\n};\r\n\r\n/**\r\n * Creates pipeline instances for various contexts.\r\n * Abstracts pipeline creation to support different implementations.\r\n * Used by the system to instantiate pipelines without coupling to specific implementations.\r\n */\r\nexport interface IPipelineFactory {\r\n  /**\r\n   * Creates a new pipeline for the specified context type.\r\n   * @template TContext - The context type for the pipeline. Must extend IPipelineContext.\r\n   * @param options - Optional performance metric options (name, category) for the pipeline.\r\n   * @returns A new pipeline instance ready for middleware registration.\r\n   */\r\n  createPipeline<TContext extends IPipelineContext>(options?: PipelineOptions): IPipeline<TContext>;\r\n}\r\n"],"mappings":";;;;;;;;AAgBA,IAAY,mBAAL,yBAAA,kBAAA;AACL,kBAAA,YAAA;AACA,kBAAA,aAAA;AACA,kBAAA,YAAA;;KACD"}

package/dist/{identity-component-B3VGtdQW.d.mts → identity-component-CuWHf7jX.d.mts}

@@ -1,5 +1,3 @@
-import { n as Immutable } from "./types-aD9p7TDy.mjs";
-
 //#region src/components/component.d.ts
 type ComponentTypeUid = string | number;
 /**
@@ -169,8 +167,9 @@ type EntityUid = string | number;
 /**
  * Represents the core identification and initialization data for an entity.
  * @template TProxyTypes - A readonly array of entity type IDs that must be provided as proxies when creating an entity.
+ *                         When non-empty, the `proxies` property is required on the model.
  */
-interface IEntityModel<TProxyTypes extends readonly EntityTypeUid[] = undefined> {
+type IEntityModel<TProxyTypes extends readonly EntityTypeUid[] = readonly []> = {
   /**
    * The unique identifier for this entity instance.
    */
@@ -181,12 +180,11 @@ interface IEntityModel<TProxyTypes extends readonly EntityTypeUid[] = undefined>
    * child entities inherit from their parent via addEntity().
    */
   readonly scopeId?: string;
-  /**
-   * Optional array of proxies (references) to other entities.
-   * Used to establish relationships at entity creation time.
-   */
+} & (TProxyTypes extends readonly [] ? {
   readonly proxies?: RequiredProxies<TProxyTypes>;
-}
+} : {
+  readonly proxies: RequiredProxies<TProxyTypes>;
+});
 /**
  * The core entity interface representing a composition of components and relationships.
  * Entities are immutable containers that store data (components) and maintain relationships (proxies) to other entities.
@@ -212,6 +210,74 @@ interface IEntity {
   readonly myProxy: Readonly<EntityProxy<this>>;
 }
 //#endregion
+//#region src/utils/types.d.ts
+/**
+ * Maps all properties of a type to boolean flags.
+ * Useful for feature flags, capability indicators, or boolean option sets.
+ *
+ * @template T - The type whose properties are mapped to booleans.
+ * @example type Features = BooleanProps<{health: any; armor: any}>; // => {health: boolean, armor: boolean}
+ */
+type BooleanProps<T> = { [Property in keyof T]: boolean };
+/**
+ * Removes readonly modifiers from all properties, making them mutable.
+ * One level of immutability removal (see MutableDeep for recursive removal).
+ *
+ * @template T - The type to make mutable.
+ * @example type Mut = Mutable<{readonly x: number}>; // => {x: number}
+ */
+type Mutable<T> = { -readonly [K in keyof T]: T[K] };
+/**
+ * Recursively removes readonly modifiers from all properties at all nesting levels.
+ * Makes entire object graph mutable.
+ *
+ * @template T - The type to make mutable recursively.
+ */
+type MutableDeep<T> = { -readonly [K in keyof T]: Mutable<T[K]> };
+type ImmutablePrimitive = undefined | null | boolean | string | number | Function;
+/**
+ * Makes a type fully immutable at the top level only.
+ * Primitives and functions remain unchanged.
+ * Collections (Array, Map, Set) become readonly.
+ * Objects have their properties made readonly.
+ *
+ * @template T - The type to make immutable.
+ * @example type Imm = Immutable<{x: number}>; // => {readonly x: number}
+ */
+type Immutable<T> = T extends ImmutablePrimitive ? T : T extends Array<infer U> ? ImmutableArray<U> : T extends Map<infer K, infer V> ? ImmutableMap<K, V> : T extends Set<infer M> ? ImmutableSet<M> : ImmutableObject<T>;
+/**
+ * Readonly array variant for use in Immutable type transformation.
+ *
+ * @template T - Element type of the array.
+ */
+type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
+/**
+ * Readonly map variant for use in Immutable type transformation.
+ *
+ * @template K - Key type of the map.
+ * @template V - Value type of the map.
+ */
+type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
+/**
+ * Readonly set variant for use in Immutable type transformation.
+ *
+ * @template T - Element type of the set.
+ */
+type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
+/**
+ * Makes all object properties readonly (one level only).
+ *
+ * @template T - The type to make immutable.
+ */
+type ImmutableObject<T> = { readonly [K in keyof T]: T[K] };
+/**
+ * Recursively makes all properties readonly at all nesting levels.
+ * Provides complete immutability guarantee for the entire object graph.
+ *
+ * @template T - The type to make deeply immutable.
+ */
+type ImmutableObjectDeep<T> = { readonly [K in keyof T]: Immutable<T[K]> };
+//#endregion
 //#region src/components/identity-component.d.ts
 /**
  * The `BasicComponentType` enum defines the types of basic components available.
@@ -250,5 +316,5 @@ interface IdentityComponent<TModel extends IEntityModel> extends IComponent {
   readonly lastUpdated?: Date;
 }
 //#endregion
-export { IEntity as a, IEntityProxy as c, TypedEntityProxy as d, ComponentTypeUid as f, EntityUid as i, IEntityProxyRepository as l, IdentityComponent as n, IEntityModel as o, IComponent as p, EntityTypeUid as r, EntityProxy as s, BasicComponentType as t, RequiredProxies as u };
-//# sourceMappingURL=identity-component-B3VGtdQW.d.mts.map
+export { IComponent as S, IEntityProxy as _, ImmutableArray as a, TypedEntityProxy as b, ImmutableObjectDeep as c, MutableDeep as d, EntityTypeUid as f, EntityProxy as g, IEntityModel as h, Immutable as i, ImmutableSet as l, IEntity as m, IdentityComponent as n, ImmutableMap as o, EntityUid as p, BooleanProps as r, ImmutableObject as s, BasicComponentType as t, Mutable as u, IEntityProxyRepository as v, ComponentTypeUid as x, RequiredProxies as y };
+//# sourceMappingURL=identity-component-CuWHf7jX.d.mts.map

package/dist/{identity-component-CsU-wYTX.d.cts → identity-component-DLDaOTyK.d.cts}

@@ -1,5 +1,3 @@
-import { n as Immutable } from "./types-DqWnkvhp.cjs";
-
 //#region src/components/component.d.ts
 type ComponentTypeUid = string | number;
 /**
@@ -169,8 +167,9 @@ type EntityUid = string | number;
 /**
  * Represents the core identification and initialization data for an entity.
  * @template TProxyTypes - A readonly array of entity type IDs that must be provided as proxies when creating an entity.
+ *                         When non-empty, the `proxies` property is required on the model.
  */
-interface IEntityModel<TProxyTypes extends readonly EntityTypeUid[] = undefined> {
+type IEntityModel<TProxyTypes extends readonly EntityTypeUid[] = readonly []> = {
   /**
    * The unique identifier for this entity instance.
    */
@@ -181,12 +180,11 @@ interface IEntityModel<TProxyTypes extends readonly EntityTypeUid[] = undefined>
    * child entities inherit from their parent via addEntity().
    */
   readonly scopeId?: string;
-  /**
-   * Optional array of proxies (references) to other entities.
-   * Used to establish relationships at entity creation time.
-   */
+} & (TProxyTypes extends readonly [] ? {
   readonly proxies?: RequiredProxies<TProxyTypes>;
-}
+} : {
+  readonly proxies: RequiredProxies<TProxyTypes>;
+});
 /**
  * The core entity interface representing a composition of components and relationships.
  * Entities are immutable containers that store data (components) and maintain relationships (proxies) to other entities.
@@ -212,6 +210,74 @@ interface IEntity {
   readonly myProxy: Readonly<EntityProxy<this>>;
 }
 //#endregion
+//#region src/utils/types.d.ts
+/**
+ * Maps all properties of a type to boolean flags.
+ * Useful for feature flags, capability indicators, or boolean option sets.
+ *
+ * @template T - The type whose properties are mapped to booleans.
+ * @example type Features = BooleanProps<{health: any; armor: any}>; // => {health: boolean, armor: boolean}
+ */
+type BooleanProps<T> = { [Property in keyof T]: boolean };
+/**
+ * Removes readonly modifiers from all properties, making them mutable.
+ * One level of immutability removal (see MutableDeep for recursive removal).
+ *
+ * @template T - The type to make mutable.
+ * @example type Mut = Mutable<{readonly x: number}>; // => {x: number}
+ */
+type Mutable<T> = { -readonly [K in keyof T]: T[K] };
+/**
+ * Recursively removes readonly modifiers from all properties at all nesting levels.
+ * Makes entire object graph mutable.
+ *
+ * @template T - The type to make mutable recursively.
+ */
+type MutableDeep<T> = { -readonly [K in keyof T]: Mutable<T[K]> };
+type ImmutablePrimitive = undefined | null | boolean | string | number | Function;
+/**
+ * Makes a type fully immutable at the top level only.
+ * Primitives and functions remain unchanged.
+ * Collections (Array, Map, Set) become readonly.
+ * Objects have their properties made readonly.
+ *
+ * @template T - The type to make immutable.
+ * @example type Imm = Immutable<{x: number}>; // => {readonly x: number}
+ */
+type Immutable<T> = T extends ImmutablePrimitive ? T : T extends Array<infer U> ? ImmutableArray<U> : T extends Map<infer K, infer V> ? ImmutableMap<K, V> : T extends Set<infer M> ? ImmutableSet<M> : ImmutableObject<T>;
+/**
+ * Readonly array variant for use in Immutable type transformation.
+ *
+ * @template T - Element type of the array.
+ */
+type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
+/**
+ * Readonly map variant for use in Immutable type transformation.
+ *
+ * @template K - Key type of the map.
+ * @template V - Value type of the map.
+ */
+type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
+/**
+ * Readonly set variant for use in Immutable type transformation.
+ *
+ * @template T - Element type of the set.
+ */
+type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
+/**
+ * Makes all object properties readonly (one level only).
+ *
+ * @template T - The type to make immutable.
+ */
+type ImmutableObject<T> = { readonly [K in keyof T]: T[K] };
+/**
+ * Recursively makes all properties readonly at all nesting levels.
+ * Provides complete immutability guarantee for the entire object graph.
+ *
+ * @template T - The type to make deeply immutable.
+ */
+type ImmutableObjectDeep<T> = { readonly [K in keyof T]: Immutable<T[K]> };
+//#endregion
 //#region src/components/identity-component.d.ts
 /**
  * The `BasicComponentType` enum defines the types of basic components available.
@@ -250,5 +316,5 @@ interface IdentityComponent<TModel extends IEntityModel> extends IComponent {
   readonly lastUpdated?: Date;
 }
 //#endregion
-export { IEntity as a, IEntityProxy as c, TypedEntityProxy as d, ComponentTypeUid as f, EntityUid as i, IEntityProxyRepository as l, IdentityComponent as n, IEntityModel as o, IComponent as p, EntityTypeUid as r, EntityProxy as s, BasicComponentType as t, RequiredProxies as u };
-//# sourceMappingURL=identity-component-CsU-wYTX.d.cts.map
+export { IComponent as S, IEntityProxy as _, ImmutableArray as a, TypedEntityProxy as b, ImmutableObjectDeep as c, MutableDeep as d, EntityTypeUid as f, EntityProxy as g, IEntityModel as h, Immutable as i, ImmutableSet as l, IEntity as m, IdentityComponent as n, ImmutableMap as o, EntityUid as p, BooleanProps as r, ImmutableObject as s, BasicComponentType as t, Mutable as u, IEntityProxyRepository as v, ComponentTypeUid as x, RequiredProxies as y };
+//# sourceMappingURL=identity-component-DLDaOTyK.d.cts.map