@awesome-ecs/abstract 0.32.0 → 0.33.0

package/README.md

@@ -1,125 +1,124 @@
-# Awesome ECS - Abstract Package
-
-## Overview
-
-The Abstract package defines all core interfaces and abstractions for the Entity-Component-System (ECS) framework. It provides the foundational contracts that all other packages implement, including:
-
-- **Components**: Data-storage contracts
-- **Entities**: Container contracts for components and relationships
-- **Pipelines**: Middleware-based execution chains
-- **Systems**: Modular logic execution patterns
-- **Utilities**: Serialization, events, and scheduling
-
-This package has **zero external dependencies** and serves as the contract layer for the entire ECS framework.
-
-## Core Concepts
-
-### Components (`src/components/`)
-
-Components are **data-only containers**. They should never contain business logic.
-
-```typescript
-import { IComponent } from "@awesome-ecs/abstract";
-
-export class HealthComponent implements IComponent {
-  readonly componentType = ComponentType.health;
-  readonly isSerializable = true;  // Include in snapshots
-  
-  current: number = 100;
-  max: number = 100;
-}
-```
-
-**Key interfaces:**
-- `IComponent`: Base component interface with `componentType` and `isSerializable`
-- `IdentityComponent`: Mandatory component tracking entity UID and model
-
-### Entities (`src/entities/`)
-
-Entities are immutable **containers of components** and **proxies to other entities**. They never directly reference other entities—they use proxies for loose coupling.
-
-```typescript
-export class GridEntity extends EntityBase<GridModel> {
-  // Strongly-typed component getters
-  get coordinates(): CoordinatesComponent {
-    return this.getComponent(ComponentType.coordinates);
-  }
-
-  // Entity proxies for relationships (not direct references)
-  get sceneProxy(): EntityProxy<SceneEntity> {
-    return this.getProxy(EntityType.scene);
-  }
-}
-```
-
-**Key files:**
-- `entity.ts`: Base `IEntity` interface and `EntityTypeUid` types
-- `entity-proxies.ts`: `EntityProxy` for loose-coupling relationships
-- `entity-snapshot.ts`: `IEntitySnapshot` for serialization
-- `entity-queue.ts`: `IEntityUpdate` and `IEntityUpdateQueue` for batching changes
-- `entity-repository.ts`: `IEntityRepository` for entity lookups
-- `entity-scheduler.ts`: `IEntityScheduler` for deferred updates
-- `entity-events.ts`: `IEntityEvents` for reactive patterns
-
-### Pipelines (`src/pipelines/`)
-
-Pipelines execute **middleware chains** with two phases:
-
-1. **dispatch(context)**: Main execution phase
-2. **cleanup(context)**: Resource cleanup phase
-
-```typescript
-export interface IPipeline<TContext extends IPipelineContext> {
-  use(middleware: IMiddleware<TContext>): this;
-  dispatch(context: Partial<TContext>): void | Promise<void>;
-  cleanup(context: Partial<TContext>): void | Promise<void>;
-}
-```
-
-**Key files:**
-- `pipeline.ts`: Core `IPipeline` interface
-- `middleware.ts`: `IMiddleware` contract (action + optional cleanup)
-- `middleware-runner.ts`: Middleware execution engine
-- `pipeline-context.ts`: Context passed to middleware
-- `pipeline-runner.ts`: Pipeline execution orchestration
-
-### Systems (`src/systems/`)
-
-Systems are **modular logic units** that operate on entities. They implement the middleware pattern.
-
-**Pipeline-based systems:**
-- `system-middleware.ts`: `ISystemMiddleware<TEntity>` - middleware for a specific entity type
-- `system-context.ts`: Context passed to system middleware (entity, events, repository, etc.)
-
-**Module-based organization:**
-- `systems-module.ts`: `ISystemsModule<TEntity>` - groups related systems targeting an entity type
-- `systems-module-builder.ts`: `ISystemsModuleBuilder<TEntity>` - fluent builder for pipeline registration
-- `systems-module-repository.ts`: Module lifecycle and registration
-
-**Runtime execution:**
-- `systems-runtime.ts`: `ISystemsRuntime` - core tick-based execution loop
-- `systems-runtime-context.ts`: Context for runtime execution
-- `systems-runtime-middleware.ts`: Middleware for runtime operations
-
-### Utilities (`src/utils/`)
-
-- `types.ts`: Common types (`Immutable`, `BooleanProps`, `Readonly`)
-- `json-serializer.ts`: JSON serialization contracts
-- `logger.ts`: Logging interface
-- `performance-timer.ts`: Performance measurement
-
-## Key Design Principles
-
-1. **Components are data-only** - no behavior, just properties
-2. **Entities are immutable** - modifications through systems only
-3. **Relationships use proxies** - loose coupling between entities
-4. **Systems are middleware** - pluggable into pipelines
-5. **Pipelines are composable** - middleware chains with dispatch + cleanup
-
-## What's NOT in Abstract
-
-- Concrete entity implementations (→ @awesome-ecs/core)
-- System module base classes (→ @awesome-ecs/core)
-- Component factories (→ @awesome-ecs/core)
-- Multi-threading (→ @awesome-ecs/workers)
-- AI patterns (→ @awesome-ecs/ai)
+# Awesome ECS - Abstract Package
+
+## Overview
+
+The Abstract package defines all core interfaces and abstractions for the Entity-Component-System (ECS) framework. It provides the foundational contracts that all other packages implement, including:
+
+- **Components**: Data-storage contracts
+- **Entities**: Container contracts for components and relationships
+- **Pipelines**: Middleware-based execution chains
+- **Systems**: Modular logic execution patterns
+- **Utilities**: Serialization, events, and scheduling
+
+This package has **zero external dependencies** and serves as the contract layer for the entire ECS framework.
+
+## Core Concepts
+
+### Components (`src/components/`)
+
+Components are **data-only containers**. They should never contain business logic.
+
+```typescript
+import { IComponent } from "@awesome-ecs/abstract";
+
+export class HealthComponent implements IComponent {
+  readonly componentType = ComponentType.health;
+  readonly isSerializable = true;  // Include in snapshots
+  
+  current: number = 100;
+  max: number = 100;
+}
+```
+
+**Key interfaces:**
+- `IComponent`: Base component interface with `componentType` and `isSerializable`
+- `IdentityComponent`: Mandatory component tracking entity UID and model
+
+### Entities (`src/entities/`)
+
+Entities are immutable **containers of components** and **proxies to other entities**. They never directly reference other entities—they use proxies for loose coupling.
+
+```typescript
+export class GridEntity extends EntityBase<GridModel> {
+  // Strongly-typed component getters
+  get coordinates(): CoordinatesComponent {
+    return this.getComponent(ComponentType.coordinates);
+  }
+
+  // Entity proxies for relationships (not direct references)
+  get sceneProxy(): EntityProxy<SceneEntity> {
+    return this.getProxy(EntityType.scene);
+  }
+}
+```
+
+**Key files:**
+- `entity.ts`: Base `IEntity` interface and `EntityTypeUid` types
+- `entity-proxies.ts`: `EntityProxy` for loose-coupling relationships
+- `entity-snapshot.ts`: `IEntitySnapshot` for serialization
+- `entity-runtime-scheduler.ts`: `IEntityUpdate` and `IEntityRuntimeScheduler` for dirty mailboxes, cadence, and batched runtime dispatch
+- `entity-repository.ts`: `IEntityRepository` for entity lookups
+- `entity-events.ts`: `IEntityEvents` for reactive patterns
+
+### Pipelines (`src/pipelines/`)
+
+Pipelines execute **middleware chains** with two phases:
+
+1. **dispatch(context)**: Main execution phase
+2. **cleanup(context)**: Resource cleanup phase
+
+```typescript
+export interface IPipeline<TContext extends IPipelineContext> {
+  use(middleware: IMiddleware<TContext>): this;
+  dispatch(context: Partial<TContext>): void | Promise<void>;
+  cleanup(context: Partial<TContext>): void | Promise<void>;
+}
+```
+
+**Key files:**
+- `pipeline.ts`: Core `IPipeline` interface
+- `middleware.ts`: `IMiddleware` contract (action + optional cleanup)
+- `middleware-runner.ts`: Middleware execution engine
+- `pipeline-context.ts`: Context passed to middleware
+- `pipeline-runner.ts`: Pipeline execution orchestration
+
+### Systems (`src/systems/`)
+
+Systems are **modular logic units** that operate on entities. They implement the middleware pattern.
+
+**Pipeline-based systems:**
+- `system-middleware.ts`: `ISystemMiddleware<TEntity>` - middleware for a specific entity type
+- `system-context.ts`: Context passed to system middleware (entity, events, repository, etc.)
+
+**Module-based organization:**
+- `systems-module.ts`: `ISystemsModule<TEntity>` - groups related systems targeting an entity type
+- `systems-module-builder.ts`: `ISystemsModuleBuilder<TEntity>` - fluent builder for pipeline registration
+- `systems-module-repository.ts`: Module lifecycle and registration
+
+**Runtime execution:**
+- `systems-runtime.ts`: `ISystemsRuntime` - core tick-based execution loop
+- `systems-runtime-context.ts`: Context for runtime execution
+- `systems-runtime-middleware.ts`: Middleware for runtime operations
+
+### Utilities (`src/utils/`)
+
+- `types.ts`: Common types (`Immutable`, `BooleanProps`, `Readonly`)
+- `json-serializer.ts`: JSON serialization contracts
+- `logger.ts`: Logging interface
+- `performance-timer.ts`: Performance measurement
+
+## Key Design Principles
+
+1. **Components are data-only** - no behavior, just properties
+2. **Entities are immutable** - modifications through systems only
+3. **Relationships use proxies** - loose coupling between entities
+4. **Systems are middleware** - pluggable into pipelines
+5. **Pipelines are composable** - middleware chains with dispatch + cleanup
+
+## What's NOT in Abstract
+
+- Concrete entity implementations (→ @awesome-ecs/core)
+- System module base classes (→ @awesome-ecs/core)
+- Component factories (→ @awesome-ecs/core)
+- Multi-threading (→ @awesome-ecs/workers)
+- AI patterns (→ @awesome-ecs/ai)

package/dist/components/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/components/identity-component.ts"],"sourcesContent":["import { EntityTypeUid, IEntityModel } from '../entities/entity';\r\nimport { Immutable } from '../utils/types';\r\nimport { IComponent } from './component';\r\n\r\n/**\r\n * The `BasicComponentType` enum defines the types of basic components available.\r\n */\r\nexport enum BasicComponentType {\r\n  identity = 'identity'\r\n}\r\n\r\n/**\r\n * The mandatory metadata component for every entity.\r\n * Contains core information that defines what an entity is and when it was last updated.\r\n * This component is immutable after creation and uniquely identifies each entity.\r\n *\r\n * @template TModel - The entity model type containing initialization data.\r\n */\r\nexport interface IdentityComponent<TModel extends IEntityModel> extends IComponent {\r\n  /**\r\n   * The entity type classification.\r\n   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.\r\n   */\r\n  readonly entityType: EntityTypeUid;\r\n\r\n  /**\r\n   * The initialization model for this entity.\r\n   * Provides the minimal data structure used when the entity was first created.\r\n   * Serves as a reference point for the entity's initial configuration.\r\n   *\r\n   * @type {Immutable<TModel>}\r\n   */\r\n  readonly model: Immutable<TModel>;\r\n\r\n  /**\r\n   * The timestamp of the entity's last system update.\r\n   * Useful for calculating elapsed time (delta time) between consecutive updates.\r\n   * Helps systems make time-aware decisions.\r\n   *\r\n   * @type {Date | undefined}\r\n   */\r\n  readonly lastUpdated?: Date;\r\n}\r\n"],"mappings":";;;;;AAOA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,cAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/components/identity-component.ts"],"sourcesContent":["import { EntityTypeUid, IEntityModel } from '../entities/entity';\nimport { Immutable } from '../utils/types';\nimport { IComponent } from './component';\n\n/**\n * The `BasicComponentType` enum defines the types of basic components available.\n */\nexport enum BasicComponentType {\n  identity = 'identity'\n}\n\n/**\n * The mandatory metadata component for every entity.\n * Contains core information that defines what an entity is and when it was last updated.\n * This component is immutable after creation and uniquely identifies each entity.\n *\n * @template TModel - The entity model type containing initialization data.\n */\nexport interface IdentityComponent<TModel extends IEntityModel> extends IComponent {\n  /**\n   * The entity type classification.\n   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.\n   */\n  readonly entityType: EntityTypeUid;\n\n  /**\n   * The initialization model for this entity.\n   * Provides the minimal data structure used when the entity was first created.\n   * Serves as a reference point for the entity's initial configuration.\n   *\n   * @type {Immutable<TModel>}\n   */\n  readonly model: Immutable<TModel>;\n\n  /**\n   * The timestamp of the entity's last system update.\n   * Useful for calculating elapsed time (delta time) between consecutive updates.\n   * Helps systems make time-aware decisions.\n   *\n   * @type {Date | undefined}\n   */\n  readonly lastUpdated?: Date;\n}\n"],"mappings":";;;;;AAOA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,cAAA;;AACF,EAAA,CAAA,CAAA"}

package/dist/components/index.d.cts

@@ -1,2 +1,2 @@
-import { _ as ConfigRecord, f as ComponentTypeUid, g as ConfigOption, h as ConfigCustomControlOptions, m as IComponentWithConfig, n as IdentityComponent, p as IComponent, t as BasicComponentType } from "../index-C0jDrUBA.cjs";
+import { _ as ConfigOption, g as ConfigCustomControlOptions, h as IComponentWithConfig, m as IComponent, n as IdentityComponent, p as ComponentTypeUid, t as BasicComponentType, v as ConfigRecord } from "../index-HeCQLTSE.cjs";
 export { BasicComponentType, ComponentTypeUid, ConfigCustomControlOptions, ConfigOption, ConfigRecord, IComponent, IComponentWithConfig, IdentityComponent };

package/dist/components/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as ConfigRecord, f as ComponentTypeUid, g as ConfigOption, h as ConfigCustomControlOptions, m as IComponentWithConfig, n as IdentityComponent, p as IComponent, t as BasicComponentType } from "../index-b5BtWAvO.mjs";
+import { _ as ConfigOption, g as ConfigCustomControlOptions, h as IComponentWithConfig, m as IComponent, n as IdentityComponent, p as ComponentTypeUid, t as BasicComponentType, v as ConfigRecord } from "../index-Tznk33g6.mjs";
 export { BasicComponentType, ComponentTypeUid, ConfigCustomControlOptions, ConfigOption, ConfigRecord, IComponent, IComponentWithConfig, IdentityComponent };

package/dist/components/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/components/identity-component.ts"],"sourcesContent":["import { EntityTypeUid, IEntityModel } from '../entities/entity';\r\nimport { Immutable } from '../utils/types';\r\nimport { IComponent } from './component';\r\n\r\n/**\r\n * The `BasicComponentType` enum defines the types of basic components available.\r\n */\r\nexport enum BasicComponentType {\r\n  identity = 'identity'\r\n}\r\n\r\n/**\r\n * The mandatory metadata component for every entity.\r\n * Contains core information that defines what an entity is and when it was last updated.\r\n * This component is immutable after creation and uniquely identifies each entity.\r\n *\r\n * @template TModel - The entity model type containing initialization data.\r\n */\r\nexport interface IdentityComponent<TModel extends IEntityModel> extends IComponent {\r\n  /**\r\n   * The entity type classification.\r\n   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.\r\n   */\r\n  readonly entityType: EntityTypeUid;\r\n\r\n  /**\r\n   * The initialization model for this entity.\r\n   * Provides the minimal data structure used when the entity was first created.\r\n   * Serves as a reference point for the entity's initial configuration.\r\n   *\r\n   * @type {Immutable<TModel>}\r\n   */\r\n  readonly model: Immutable<TModel>;\r\n\r\n  /**\r\n   * The timestamp of the entity's last system update.\r\n   * Useful for calculating elapsed time (delta time) between consecutive updates.\r\n   * Helps systems make time-aware decisions.\r\n   *\r\n   * @type {Date | undefined}\r\n   */\r\n  readonly lastUpdated?: Date;\r\n}\r\n"],"mappings":";;;;AAOA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,cAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/components/identity-component.ts"],"sourcesContent":["import { EntityTypeUid, IEntityModel } from '../entities/entity';\nimport { Immutable } from '../utils/types';\nimport { IComponent } from './component';\n\n/**\n * The `BasicComponentType` enum defines the types of basic components available.\n */\nexport enum BasicComponentType {\n  identity = 'identity'\n}\n\n/**\n * The mandatory metadata component for every entity.\n * Contains core information that defines what an entity is and when it was last updated.\n * This component is immutable after creation and uniquely identifies each entity.\n *\n * @template TModel - The entity model type containing initialization data.\n */\nexport interface IdentityComponent<TModel extends IEntityModel> extends IComponent {\n  /**\n   * The entity type classification.\n   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.\n   */\n  readonly entityType: EntityTypeUid;\n\n  /**\n   * The initialization model for this entity.\n   * Provides the minimal data structure used when the entity was first created.\n   * Serves as a reference point for the entity's initial configuration.\n   *\n   * @type {Immutable<TModel>}\n   */\n  readonly model: Immutable<TModel>;\n\n  /**\n   * The timestamp of the entity's last system update.\n   * Useful for calculating elapsed time (delta time) between consecutive updates.\n   * Helps systems make time-aware decisions.\n   *\n   * @type {Date | undefined}\n   */\n  readonly lastUpdated?: Date;\n}\n"],"mappings":";;;;AAOA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,cAAA;;AACF,EAAA,CAAA,CAAA"}

package/dist/entities/index.cjs

@@ -1,31 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/entities/entity-queue.ts
-/**
-* Specifies the action to be performed on an entity.
-* Updates are categorized to enable different processing paths in the runtime.
-*/
+//#region src/entities/entity-scheduler.ts
 let EntityUpdateType = /* @__PURE__ */ function(EntityUpdateType) {
-	/**
-	* Indicates the entity should be updated with new data.
-	*/
 	EntityUpdateType["update"] = "update";
-	/**
-	* Indicates the entity should be removed from the system.
-	*/
 	EntityUpdateType["remove"] = "remove";
 	return EntityUpdateType;
 }({});
-//#endregion
-//#region src/entities/entity-scheduler.ts
-/**
-* Controls which scheduling modes are paused.
-*/
 let SchedulerPauseType = /* @__PURE__ */ function(SchedulerPauseType) {
-	/** Pause both interval timers and frame subscriptions. */
 	SchedulerPauseType["full"] = "full";
-	/** Pause only frame subscriptions. Interval timers continue firing. */
 	SchedulerPauseType["perFrame"] = "perFrame";
-	/** Pause only interval timers. Frame subscriptions continue. */
 	SchedulerPauseType["intervals"] = "intervals";
 	return SchedulerPauseType;
 }({});

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 { IEntityConfigSnapshot } from './entity-config';\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   * Optional config-only component state to apply to the entity.\r\n   * When present on an update, the runtime applies it after `snapshot` and\r\n   * includes the config system phase in the same tick.\r\n   */\r\n  readonly config?: IEntityConfigSnapshot;\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 or replaces an entity schedule.\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":";;;;;;AASA,IAAY,mBAAL,yBAAA,kBAAA;;;;CAIL,iBAAA,YAAA;;;;CAIA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA;;;;;;ACJA,IAAY,qBAAL,yBAAA,oBAAA;;CAEL,mBAAA,UAAA;;CAEA,mBAAA,cAAA;;CAEA,mBAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/entities/entity-scheduler.ts"],"sourcesContent":["import { EntityTypeUid, EntityUid, IEntity, IEntityModel } from './entity';\nimport { IEntityConfigSnapshot } from './entity-config';\nimport { IEntityEvent, IEventData } from './entity-events';\nimport { IEntityProxy } from './entity-proxies';\nimport { IEntitySnapshot } from './entity-snapshot';\n\nexport enum EntityUpdateType {\n  update = 'update',\n  remove = 'remove'\n}\n\nexport interface IEntityUpdate {\n  readonly type: EntityUpdateType;\n  readonly entity: IEntityProxy;\n  readonly model?: IEntityModel;\n  readonly snapshot?: IEntitySnapshot;\n  readonly config?: IEntityConfigSnapshot;\n}\n\nexport interface IEntityDispatchGroup {\n  readonly entityType: EntityTypeUid;\n  readonly updates: ReadonlyArray<IEntityUpdate>;\n  readonly dirtyUpdates: number;\n  readonly scheduledUpdates: number;\n  readonly removeUpdates: number;\n  readonly pipelineMask?: number;\n}\n\nexport type EntityRuntimePendingGroupOptions = {\n  readonly includeFrameSubscriptions?: boolean;\n};\n\nexport type EntitySchedule = {\n  readonly proxy: IEntityProxy;\n  readonly intervalMs?: number;\n};\n\nexport type EntityPriorityModel = {\n  readonly defaultPriority?: number;\n  readonly entityTypes?: ReadonlyMap<EntityTypeUid, number>;\n};\n\nexport enum SchedulerPauseType {\n  full = 'full',\n  perFrame = 'perFrame',\n  intervals = 'intervals'\n}\n\nexport interface IEntityRuntimeScheduler {\n  readonly dirtyCount: number;\n  readonly rawDirtyCount: number;\n  readonly pendingCount: number;\n\n  enqueue(update: IEntityUpdate): void;\n  enqueueEvent(entity: IEntityProxy, event: IEntityEvent<IEventData>): void;\n  enqueueEvents(entity: IEntityProxy, events: ReadonlyArray<IEntityEvent<IEventData>>): void;\n\n  schedule(proxy: IEntityProxy, intervalMs?: number): void;\n  removeSchedule(proxy: IEntityProxy): void;\n  hasSchedule(proxy: IEntityProxy): boolean;\n\n  takePendingGroups(\n    maxItems?: number,\n    options?: EntityRuntimePendingGroupOptions\n  ): ReadonlyArray<IEntityDispatchGroup>;\n}\n"],"mappings":";;AAMA,IAAY,mBAAL,yBAAA,kBAAA;CACL,iBAAA,YAAA;CACA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA;AAiCA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,UAAA;CACA,mBAAA,cAAA;CACA,mBAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}

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 "../index-C0jDrUBA.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, v as IEntityConfigSnapshot } from "../index-BGLTfuj8.cjs";
-export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityProxy, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityConfigSnapshot, IEntityContextCache, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEntityUpdateQueue, IEventData, RequiredProxies, SchedulerPauseType, TypedEntityProxy };
+import { a as IEntity, c as IEntityProxy, d as RequiredProxies, f as TypedEntityProxy, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy, u as ProxyTypesOf } from "../index-HeCQLTSE.cjs";
+import { _ as IEntityEventsManager, a as IEntityDispatchGroup, b as IEntityConfigSnapshot, c as SchedulerPauseType, d as IEntityRepository, f as EntityEventSubscriptionFilter, g as IEntityEventsDispatcher, h as IEntityEvent, i as EntityUpdateType, l as IEntitySnapshot, m as EntityEventUid, n as EntityRuntimePendingGroupOptions, o as IEntityRuntimeScheduler, p as EntityEventSubscriptionOptions, r as EntitySchedule, s as IEntityUpdate, t as EntityPriorityModel, u as IEntitySnapshotProvider, v as IEventData, y as IEntityContextCache } from "../index-0hg5PXZe.cjs";
+export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityPriorityModel, EntityProxy, EntityRuntimePendingGroupOptions, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityConfigSnapshot, IEntityContextCache, IEntityDispatchGroup, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityRuntimeScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEventData, ProxyTypesOf, 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 "../index-b5BtWAvO.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, v as IEntityConfigSnapshot } from "../index-C1hRAjM-.mjs";
-export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityProxy, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityConfigSnapshot, IEntityContextCache, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEntityUpdateQueue, IEventData, RequiredProxies, SchedulerPauseType, TypedEntityProxy };
+import { a as IEntity, c as IEntityProxy, d as RequiredProxies, f as TypedEntityProxy, i as EntityUid, l as IEntityProxyRepository, o as IEntityModel, r as EntityTypeUid, s as EntityProxy, u as ProxyTypesOf } from "../index-Tznk33g6.mjs";
+import { _ as IEntityEventsManager, a as IEntityDispatchGroup, b as IEntityConfigSnapshot, c as SchedulerPauseType, d as IEntityRepository, f as EntityEventSubscriptionFilter, g as IEntityEventsDispatcher, h as IEntityEvent, i as EntityUpdateType, l as IEntitySnapshot, m as EntityEventUid, n as EntityRuntimePendingGroupOptions, o as IEntityRuntimeScheduler, p as EntityEventSubscriptionOptions, r as EntitySchedule, s as IEntityUpdate, t as EntityPriorityModel, u as IEntitySnapshotProvider, v as IEventData, y as IEntityContextCache } from "../index--9JJtMKF.mjs";
+export { EntityEventSubscriptionFilter, EntityEventSubscriptionOptions, EntityEventUid, EntityPriorityModel, EntityProxy, EntityRuntimePendingGroupOptions, EntitySchedule, EntityTypeUid, EntityUid, EntityUpdateType, IEntity, IEntityConfigSnapshot, IEntityContextCache, IEntityDispatchGroup, IEntityEvent, IEntityEventsDispatcher, IEntityEventsManager, IEntityModel, IEntityProxy, IEntityProxyRepository, IEntityRepository, IEntityRuntimeScheduler, IEntitySnapshot, IEntitySnapshotProvider, IEntityUpdate, IEventData, ProxyTypesOf, RequiredProxies, SchedulerPauseType, TypedEntityProxy };

package/dist/entities/index.mjs

@@ -1,30 +1,12 @@
-//#region src/entities/entity-queue.ts
-/**
-* Specifies the action to be performed on an entity.
-* Updates are categorized to enable different processing paths in the runtime.
-*/
+//#region src/entities/entity-scheduler.ts
 let EntityUpdateType = /* @__PURE__ */ function(EntityUpdateType) {
-	/**
-	* Indicates the entity should be updated with new data.
-	*/
 	EntityUpdateType["update"] = "update";
-	/**
-	* Indicates the entity should be removed from the system.
-	*/
 	EntityUpdateType["remove"] = "remove";
 	return EntityUpdateType;
 }({});
-//#endregion
-//#region src/entities/entity-scheduler.ts
-/**
-* Controls which scheduling modes are paused.
-*/
 let SchedulerPauseType = /* @__PURE__ */ function(SchedulerPauseType) {
-	/** Pause both interval timers and frame subscriptions. */
 	SchedulerPauseType["full"] = "full";
-	/** Pause only frame subscriptions. Interval timers continue firing. */
 	SchedulerPauseType["perFrame"] = "perFrame";
-	/** Pause only interval timers. Frame subscriptions continue. */
 	SchedulerPauseType["intervals"] = "intervals";
 	return SchedulerPauseType;
 }({});

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 { IEntityConfigSnapshot } from './entity-config';\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   * Optional config-only component state to apply to the entity.\r\n   * When present on an update, the runtime applies it after `snapshot` and\r\n   * includes the config system phase in the same tick.\r\n   */\r\n  readonly config?: IEntityConfigSnapshot;\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 or replaces an entity schedule.\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":";;;;;AASA,IAAY,mBAAL,yBAAA,kBAAA;;;;CAIL,iBAAA,YAAA;;;;CAIA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA;;;;;;ACJA,IAAY,qBAAL,yBAAA,oBAAA;;CAEL,mBAAA,UAAA;;CAEA,mBAAA,cAAA;;CAEA,mBAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/entities/entity-scheduler.ts"],"sourcesContent":["import { EntityTypeUid, EntityUid, IEntity, IEntityModel } from './entity';\nimport { IEntityConfigSnapshot } from './entity-config';\nimport { IEntityEvent, IEventData } from './entity-events';\nimport { IEntityProxy } from './entity-proxies';\nimport { IEntitySnapshot } from './entity-snapshot';\n\nexport enum EntityUpdateType {\n  update = 'update',\n  remove = 'remove'\n}\n\nexport interface IEntityUpdate {\n  readonly type: EntityUpdateType;\n  readonly entity: IEntityProxy;\n  readonly model?: IEntityModel;\n  readonly snapshot?: IEntitySnapshot;\n  readonly config?: IEntityConfigSnapshot;\n}\n\nexport interface IEntityDispatchGroup {\n  readonly entityType: EntityTypeUid;\n  readonly updates: ReadonlyArray<IEntityUpdate>;\n  readonly dirtyUpdates: number;\n  readonly scheduledUpdates: number;\n  readonly removeUpdates: number;\n  readonly pipelineMask?: number;\n}\n\nexport type EntityRuntimePendingGroupOptions = {\n  readonly includeFrameSubscriptions?: boolean;\n};\n\nexport type EntitySchedule = {\n  readonly proxy: IEntityProxy;\n  readonly intervalMs?: number;\n};\n\nexport type EntityPriorityModel = {\n  readonly defaultPriority?: number;\n  readonly entityTypes?: ReadonlyMap<EntityTypeUid, number>;\n};\n\nexport enum SchedulerPauseType {\n  full = 'full',\n  perFrame = 'perFrame',\n  intervals = 'intervals'\n}\n\nexport interface IEntityRuntimeScheduler {\n  readonly dirtyCount: number;\n  readonly rawDirtyCount: number;\n  readonly pendingCount: number;\n\n  enqueue(update: IEntityUpdate): void;\n  enqueueEvent(entity: IEntityProxy, event: IEntityEvent<IEventData>): void;\n  enqueueEvents(entity: IEntityProxy, events: ReadonlyArray<IEntityEvent<IEventData>>): void;\n\n  schedule(proxy: IEntityProxy, intervalMs?: number): void;\n  removeSchedule(proxy: IEntityProxy): void;\n  hasSchedule(proxy: IEntityProxy): boolean;\n\n  takePendingGroups(\n    maxItems?: number,\n    options?: EntityRuntimePendingGroupOptions\n  ): ReadonlyArray<IEntityDispatchGroup>;\n}\n"],"mappings":";AAMA,IAAY,mBAAL,yBAAA,kBAAA;CACL,iBAAA,YAAA;CACA,iBAAA,YAAA;;AACF,EAAA,CAAA,CAAA;AAiCA,IAAY,qBAAL,yBAAA,oBAAA;CACL,mBAAA,UAAA;CACA,mBAAA,cAAA;CACA,mBAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}

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

package/dist/factories/index.d.cts

@@ -1,2 +1,2 @@
-import { d as IPipelineFactory, f as PipelineCategory, h as IContextFactory, m as PipelineOptions, n as IRuntimeFactory, p as PipelineCategoryName, t as ISystemsFactory } from "../index-B1OYkMOx.cjs";
-export { IContextFactory, IPipelineFactory, IRuntimeFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineOptions };
+import { _ as PipelineCategoryName, g as PipelineCategory, h as IPipelineFactory, t as ISystemsFactory, v as PipelineOptions, y as IContextFactory } from "../index-CPGVaS-_.cjs";
+export { IContextFactory, IPipelineFactory, ISystemsFactory, PipelineCategory, PipelineCategoryName, PipelineOptions };

package/dist/factories/index.d.mts

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