@awesome-ecs/abstract 0.32.1 → 0.34.0

package/dist/{index-C5nragoq.d.cts → index-DMZSrHoB.d.cts}

@@ -1,4 +1,4 @@
-import { r as Immutable } from "./types-Bbmnq4ni.cjs";
+import { r as Immutable } from "./types-BaCGIrym.cjs";
 
 //#region src/components/config.d.ts
 /**
@@ -120,6 +120,117 @@ interface IComponentWithConfig<TConfig extends ConfigRecord> extends IComponent
   readonly config: TConfig;
 }
 //#endregion
+//#region src/components/identity-component.d.ts
+/**
+ * The `BasicComponentType` enum defines the types of basic components available.
+ */
+declare enum BasicComponentType {
+  identity = "identity"
+}
+/**
+ * The mandatory metadata component for every entity.
+ * Contains core information that defines what an entity is and when it was last updated.
+ * This component is immutable after creation and uniquely identifies each entity.
+ *
+ * @template TModel - The entity model type containing initialization data.
+ */
+interface IdentityComponent<TModel extends IEntityModel> extends IComponent {
+  /**
+   * The entity type classification.
+   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.
+   */
+  readonly entityType: EntityTypeUid;
+  /**
+   * The initialization model for this entity.
+   * Provides the minimal data structure used when the entity was first created.
+   * Serves as a reference point for the entity's initial configuration.
+   *
+   * @type {Immutable<TModel>}
+   */
+  readonly model: Immutable<TModel>;
+  /**
+   * The proxy for this entity, derived from `entityType` and `model.uid`.
+   */
+  readonly proxy: IEntityProxy;
+  /**
+   * The timestamp of the entity's last system update.
+   * Useful for calculating elapsed time (delta time) between consecutive updates.
+   * Helps systems make time-aware decisions.
+   *
+   * @type {Date | undefined}
+   */
+  readonly lastUpdated?: Date;
+}
+//#endregion
+//#region src/entities/entity.d.ts
+/**
+ * Represents the unique identifier for an entity type.
+ * Can be either a string or a number.
+ */
+type EntityTypeUid = string | number;
+/**
+ * Represents the unique identifier for an entity.
+ * Can be either a string or a number.
+ */
+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.
+ *                         Use `[]` for concrete models without creation-time proxies.
+ *                         Omit the generic only for broad infrastructure APIs that accept any model.
+ */
+type IEntityModel<TProxyTypes extends readonly EntityTypeUid[] | void = void> = {
+  /**
+   * The unique identifier for this entity instance.
+   */
+  readonly uid: EntityUid;
+  /**
+   * The scope this entity belongs to.
+   * Automatically set by the framework — scopeRoot entities generate a UUID,
+   * child entities inherit from their parent via addEntity().
+   */
+  readonly scopeId?: string;
+} & ([TProxyTypes] extends [void] ? {
+  readonly proxies?: Readonly<Record<EntityTypeUid, IEntityProxy>>;
+} : TProxyTypes extends readonly [] ? {
+  readonly proxies?: Readonly<Record<EntityTypeUid, never>>;
+} : TProxyTypes extends readonly EntityTypeUid[] ? {
+  readonly proxies: RequiredProxies<TProxyTypes>;
+} : never);
+declare const EntityModelType: unique symbol;
+interface IEntityModelRef<TModel extends IEntityModel> {
+  readonly [EntityModelType]?: TModel;
+}
+/**
+ * Extract the model type carried by an entity's identity component.
+ */
+type ModelOf<TEntity> = TEntity extends IEntityModelRef<infer TModel> ? TModel : IEntityModel;
+/**
+ * Base entity contract.
+ *
+ * Concrete entity types extend this interface and declare their own component and proxy
+ * members directly, for example `readonly terrain: TerrainComponent` or
+ * `readonly gridProxy: EntityProxy<GridEntity>`.
+ */
+interface IEntity {
+  /**
+   * The identity component containing core entity metadata and initialization information.
+   * Every entity has exactly one identity component that persists for the entity's lifetime.
+   */
+  readonly identity: Readonly<IdentityComponent<ModelOf<this>>>;
+}
+/**
+ * Entity contract carrying the concrete model type for `ModelOf<TEntity>` inference.
+ */
+interface IEntityWith<TModel extends IEntityModel> extends IEntity, IEntityModelRef<TModel> {}
+/**
+ * Runtime entity spec consumed by dispatchers.
+ */
+type IEntitySpec<TEntity extends IEntity> = {
+  readonly type: EntityTypeUid;
+  readonly init: (model: ModelOf<TEntity>) => TEntity;
+};
+//#endregion
 //#region src/entities/entity-proxies.d.ts
 /**
  * Represents a reference (pointer) to another entity.
@@ -139,11 +250,13 @@ interface IEntityProxy {
 }
 /**
  * A typed variant of `IEntityProxy` that carries compile-time type information.
- * This allows IDEs to provide better type inference and type-checking when working with entity relationships.
+ * This allows IDEs to infer the entity type when resolving a proxy through a repository.
  *
  * @template TEntity - The specific entity type that this proxy references.
  */
 interface EntityProxy<TEntity extends IEntity> extends IEntityProxy {}
+type EntityProxyLookup<TEntity extends IEntity = IEntity> = EntityTypeUid | EntityProxy<TEntity>;
+type EntityProxyManyLookup<TEntity extends IEntity = IEntity> = EntityProxyLookup<TEntity>;
 /**
  * A helper type to create a typed entity proxy.
  */
@@ -152,9 +265,17 @@ type TypedEntityProxy<T extends EntityTypeUid> = {
   entityUid: EntityUid;
 };
 /**
- * A mapped type that transforms an array of EntityType into an array of TypedEntityProxy.
+ * A model-level record of required entity proxies, keyed by entity type.
+ */
+type RequiredProxies<TProxyTypes extends readonly EntityTypeUid[]> = { readonly [TType in TProxyTypes[number]]: TypedEntityProxy<TType> };
+/**
+ * Extracts the union of EntityTypeUid values declared as required proxies on an entity model.
+ * Resolves to `never` if the model declares no required proxies, which makes proxy lookups
+ * via that union uncallable at compile time.
+ *
+ * @template TModel - The entity model to inspect.
  */
-type RequiredProxies<TProxyTypes extends readonly EntityTypeUid[]> = [...{ [I in keyof TProxyTypes]: TypedEntityProxy<TProxyTypes[I]> }, ...IEntityProxy[]];
+type ProxyTypesOf<TModel> = TModel extends IEntityModel<infer P> ? P extends readonly EntityTypeUid[] ? P[number] : never : never;
 /**
  * Central registry for managing entity-to-entity relationships through proxies.
  * Maintains bidirectional proxy links, ensuring consistency across all entity references.
@@ -196,20 +317,20 @@ interface IEntityProxyRepository {
    * @param targetType - The entity type of the target proxy to retrieve.
    * @returns The entity proxy, or null if not found.
    */
-  get(source: IEntityProxy, targetType: EntityTypeUid): IEntityProxy | null;
+  getProxy<TEntity extends IEntity = IEntity>(source: IEntityProxy, targetType: EntityTypeUid): EntityProxy<TEntity> | null;
   /**
    * Retrieves all proxies of a specific type for a source entity.
    * @param source - The proxy of the source entity.
    * @param targetType - The entity type of the target proxies to retrieve.
    * @returns A readonly array of entity proxies.
    */
-  getMany(source: IEntityProxy, targetType: EntityTypeUid): Readonly<IEntityProxy[]>;
+  getProxies<TEntity extends IEntity = IEntity>(source: IEntityProxy, targetType: EntityTypeUid): Readonly<EntityProxy<TEntity>[]>;
   /**
    * Retrieves all proxies for a source entity.
    * @param source - The proxy of the source entity.
    * @returns A readonly map of entity type UIDs to an array of their proxies.
    */
-  getAll(source: IEntityProxy): ReadonlyMap<EntityTypeUid, Readonly<IEntityProxy[]>>;
+  getAllProxies(source: IEntityProxy): ReadonlyMap<EntityTypeUid, Readonly<IEntityProxy[]>>;
   /**
    * Registers an entity as a scoped proxy, making it resolvable by any entity in the same scope.
    * Only entity types marked as scopeRoot or scopedProxy should be registered.
@@ -223,7 +344,7 @@ interface IEntityProxyRepository {
    * @param entityType - The entity type to resolve.
    * @returns The scoped proxy, or null if none exists.
    */
-  getScopedProxy(scopeId: string, entityType: EntityTypeUid): IEntityProxy | null;
+  getScopedProxy<TEntity extends IEntity = IEntity>(scopeId: string, entityType: EntityTypeUid): EntityProxy<TEntity> | null;
   /**
    * Removes an entity from the scoped proxy index.
    * Called during entity cleanup to unregister from scope resolution.
@@ -233,100 +354,20 @@ interface IEntityProxyRepository {
   removeScopedProxy(entity: IEntityProxy, scopeId: string): void;
 }
 //#endregion
-//#region src/entities/entity.d.ts
-/**
- * Represents the unique identifier for an entity type.
- * Can be either a string or a number.
- */
-type EntityTypeUid = string | number;
-/**
- * Represents the unique identifier for an entity.
- * Can be either a string or a number.
- */
-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.
- */
-type IEntityModel<TProxyTypes extends readonly EntityTypeUid[] = readonly []> = {
-  /**
-   * The unique identifier for this entity instance.
-   */
-  readonly uid: EntityUid;
-  /**
-   * The scope this entity belongs to.
-   * Automatically set by the framework — scopeRoot entities generate a UUID,
-   * child entities inherit from their parent via addEntity().
-   */
-  readonly scopeId?: string;
-} & (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.
- * State modifications occur exclusively through system operations, maintaining data integrity and enabling safe concurrent access.
- *
- * Implementations should provide strongly-typed accessors for components and proxies specific to their entity type,
- * enhancing IDE support and type safety without adding behavior beyond data access.
- */
-interface IEntity {
-  /**
-   * The set of components attached to this entity.
-   * Components are the primary data storage mechanism, mapped by their unique type identifiers.
-   */
-  readonly components: ReadonlyMap<ComponentTypeUid, IComponent>;
-  /**
-   * The identity component containing core entity metadata and initialization information.
-   * Every entity has exactly one identity component that persists for the entity's lifetime.
-   */
-  readonly identity: Readonly<IdentityComponent<IEntityModel>>;
-  /**
-   * A reference to this entity's own proxy.
-   */
-  readonly myProxy: Readonly<EntityProxy<this>>;
-}
-//#endregion
-//#region src/components/identity-component.d.ts
-/**
- * The `BasicComponentType` enum defines the types of basic components available.
- */
-declare enum BasicComponentType {
-  identity = "identity"
-}
+//#region src/components/component-repository.d.ts
 /**
- * The mandatory metadata component for every entity.
- * Contains core information that defines what an entity is and when it was last updated.
- * This component is immutable after creation and uniquely identifies each entity.
+ * The runtime source of truth for component instances, keyed by entity proxy.
  *
- * @template TModel - The entity model type containing initialization data.
+ * Generic `get<TComponent>` lets callsites narrow on demand without any global
+ * `ComponentTypeMap` augmentation. Most reads go through typed component fields on
+ * `context.entity`; direct `repository.get` is the escape hatch.
  */
-interface IdentityComponent<TModel extends IEntityModel> extends IComponent {
-  /**
-   * The entity type classification.
-   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.
-   */
-  readonly entityType: EntityTypeUid;
-  /**
-   * The initialization model for this entity.
-   * Provides the minimal data structure used when the entity was first created.
-   * Serves as a reference point for the entity's initial configuration.
-   *
-   * @type {Immutable<TModel>}
-   */
-  readonly model: Immutable<TModel>;
-  /**
-   * The timestamp of the entity's last system update.
-   * Useful for calculating elapsed time (delta time) between consecutive updates.
-   * Helps systems make time-aware decisions.
-   *
-   * @type {Date | undefined}
-   */
-  readonly lastUpdated?: Date;
+interface IComponentRepository {
+  setMany(key: IEntityProxy, components: readonly IComponent[]): void;
+  get<TComponent extends IComponent = IComponent>(key: IEntityProxy, type: ComponentTypeUid): TComponent | undefined;
+  getAll(key: IEntityProxy): readonly IComponent[];
+  removeAll(key: IEntityProxy): void;
 }
 //#endregion
-export { ConfigRecord as _, IEntity as a, IEntityProxy as c, TypedEntityProxy as d, ComponentTypeUid as f, ConfigOption as g, ConfigCustomControlOptions as h, EntityUid as i, IEntityProxyRepository as l, IComponentWithConfig as m, IdentityComponent as n, IEntityModel as o, IComponent as p, EntityTypeUid as r, EntityProxy as s, BasicComponentType as t, RequiredProxies as u };
-//# sourceMappingURL=index-C5nragoq.d.cts.map
+export { ConfigCustomControlOptions as C, IComponentWithConfig as S, ConfigRecord as T, ModelOf as _, IEntityProxy as a, ComponentTypeUid as b, RequiredProxies as c, EntityUid as d, IEntity as f, IEntityWith as g, IEntitySpec as h, EntityProxyManyLookup as i, TypedEntityProxy as l, IEntityModelRef as m, EntityProxy as n, IEntityProxyRepository as o, IEntityModel as p, EntityProxyLookup as r, ProxyTypesOf as s, IComponentRepository as t, EntityTypeUid as u, BasicComponentType as v, ConfigOption as w, IComponent as x, IdentityComponent as y };
+//# sourceMappingURL=index-DMZSrHoB.d.cts.map

package/dist/{index-BlP67nCr.d.mts → index-Dbwzlrgp.d.mts}

@@ -1,4 +1,4 @@
-import { r as Immutable } from "./types-C1ojaDL4.mjs";
+import { r as Immutable } from "./types-BaCGIrym.mjs";
 
 //#region src/components/config.d.ts
 /**
@@ -120,6 +120,117 @@ interface IComponentWithConfig<TConfig extends ConfigRecord> extends IComponent
   readonly config: TConfig;
 }
 //#endregion
+//#region src/components/identity-component.d.ts
+/**
+ * The `BasicComponentType` enum defines the types of basic components available.
+ */
+declare enum BasicComponentType {
+  identity = "identity"
+}
+/**
+ * The mandatory metadata component for every entity.
+ * Contains core information that defines what an entity is and when it was last updated.
+ * This component is immutable after creation and uniquely identifies each entity.
+ *
+ * @template TModel - The entity model type containing initialization data.
+ */
+interface IdentityComponent<TModel extends IEntityModel> extends IComponent {
+  /**
+   * The entity type classification.
+   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.
+   */
+  readonly entityType: EntityTypeUid;
+  /**
+   * The initialization model for this entity.
+   * Provides the minimal data structure used when the entity was first created.
+   * Serves as a reference point for the entity's initial configuration.
+   *
+   * @type {Immutable<TModel>}
+   */
+  readonly model: Immutable<TModel>;
+  /**
+   * The proxy for this entity, derived from `entityType` and `model.uid`.
+   */
+  readonly proxy: IEntityProxy;
+  /**
+   * The timestamp of the entity's last system update.
+   * Useful for calculating elapsed time (delta time) between consecutive updates.
+   * Helps systems make time-aware decisions.
+   *
+   * @type {Date | undefined}
+   */
+  readonly lastUpdated?: Date;
+}
+//#endregion
+//#region src/entities/entity.d.ts
+/**
+ * Represents the unique identifier for an entity type.
+ * Can be either a string or a number.
+ */
+type EntityTypeUid = string | number;
+/**
+ * Represents the unique identifier for an entity.
+ * Can be either a string or a number.
+ */
+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.
+ *                         Use `[]` for concrete models without creation-time proxies.
+ *                         Omit the generic only for broad infrastructure APIs that accept any model.
+ */
+type IEntityModel<TProxyTypes extends readonly EntityTypeUid[] | void = void> = {
+  /**
+   * The unique identifier for this entity instance.
+   */
+  readonly uid: EntityUid;
+  /**
+   * The scope this entity belongs to.
+   * Automatically set by the framework — scopeRoot entities generate a UUID,
+   * child entities inherit from their parent via addEntity().
+   */
+  readonly scopeId?: string;
+} & ([TProxyTypes] extends [void] ? {
+  readonly proxies?: Readonly<Record<EntityTypeUid, IEntityProxy>>;
+} : TProxyTypes extends readonly [] ? {
+  readonly proxies?: Readonly<Record<EntityTypeUid, never>>;
+} : TProxyTypes extends readonly EntityTypeUid[] ? {
+  readonly proxies: RequiredProxies<TProxyTypes>;
+} : never);
+declare const EntityModelType: unique symbol;
+interface IEntityModelRef<TModel extends IEntityModel> {
+  readonly [EntityModelType]?: TModel;
+}
+/**
+ * Extract the model type carried by an entity's identity component.
+ */
+type ModelOf<TEntity> = TEntity extends IEntityModelRef<infer TModel> ? TModel : IEntityModel;
+/**
+ * Base entity contract.
+ *
+ * Concrete entity types extend this interface and declare their own component and proxy
+ * members directly, for example `readonly terrain: TerrainComponent` or
+ * `readonly gridProxy: EntityProxy<GridEntity>`.
+ */
+interface IEntity {
+  /**
+   * The identity component containing core entity metadata and initialization information.
+   * Every entity has exactly one identity component that persists for the entity's lifetime.
+   */
+  readonly identity: Readonly<IdentityComponent<ModelOf<this>>>;
+}
+/**
+ * Entity contract carrying the concrete model type for `ModelOf<TEntity>` inference.
+ */
+interface IEntityWith<TModel extends IEntityModel> extends IEntity, IEntityModelRef<TModel> {}
+/**
+ * Runtime entity spec consumed by dispatchers.
+ */
+type IEntitySpec<TEntity extends IEntity> = {
+  readonly type: EntityTypeUid;
+  readonly init: (model: ModelOf<TEntity>) => TEntity;
+};
+//#endregion
 //#region src/entities/entity-proxies.d.ts
 /**
  * Represents a reference (pointer) to another entity.
@@ -139,11 +250,13 @@ interface IEntityProxy {
 }
 /**
  * A typed variant of `IEntityProxy` that carries compile-time type information.
- * This allows IDEs to provide better type inference and type-checking when working with entity relationships.
+ * This allows IDEs to infer the entity type when resolving a proxy through a repository.
  *
  * @template TEntity - The specific entity type that this proxy references.
  */
 interface EntityProxy<TEntity extends IEntity> extends IEntityProxy {}
+type EntityProxyLookup<TEntity extends IEntity = IEntity> = EntityTypeUid | EntityProxy<TEntity>;
+type EntityProxyManyLookup<TEntity extends IEntity = IEntity> = EntityProxyLookup<TEntity>;
 /**
  * A helper type to create a typed entity proxy.
  */
@@ -152,9 +265,17 @@ type TypedEntityProxy<T extends EntityTypeUid> = {
   entityUid: EntityUid;
 };
 /**
- * A mapped type that transforms an array of EntityType into an array of TypedEntityProxy.
+ * A model-level record of required entity proxies, keyed by entity type.
+ */
+type RequiredProxies<TProxyTypes extends readonly EntityTypeUid[]> = { readonly [TType in TProxyTypes[number]]: TypedEntityProxy<TType> };
+/**
+ * Extracts the union of EntityTypeUid values declared as required proxies on an entity model.
+ * Resolves to `never` if the model declares no required proxies, which makes proxy lookups
+ * via that union uncallable at compile time.
+ *
+ * @template TModel - The entity model to inspect.
  */
-type RequiredProxies<TProxyTypes extends readonly EntityTypeUid[]> = [...{ [I in keyof TProxyTypes]: TypedEntityProxy<TProxyTypes[I]> }, ...IEntityProxy[]];
+type ProxyTypesOf<TModel> = TModel extends IEntityModel<infer P> ? P extends readonly EntityTypeUid[] ? P[number] : never : never;
 /**
  * Central registry for managing entity-to-entity relationships through proxies.
  * Maintains bidirectional proxy links, ensuring consistency across all entity references.
@@ -196,20 +317,20 @@ interface IEntityProxyRepository {
    * @param targetType - The entity type of the target proxy to retrieve.
    * @returns The entity proxy, or null if not found.
    */
-  get(source: IEntityProxy, targetType: EntityTypeUid): IEntityProxy | null;
+  getProxy<TEntity extends IEntity = IEntity>(source: IEntityProxy, targetType: EntityTypeUid): EntityProxy<TEntity> | null;
   /**
    * Retrieves all proxies of a specific type for a source entity.
    * @param source - The proxy of the source entity.
    * @param targetType - The entity type of the target proxies to retrieve.
    * @returns A readonly array of entity proxies.
    */
-  getMany(source: IEntityProxy, targetType: EntityTypeUid): Readonly<IEntityProxy[]>;
+  getProxies<TEntity extends IEntity = IEntity>(source: IEntityProxy, targetType: EntityTypeUid): Readonly<EntityProxy<TEntity>[]>;
   /**
    * Retrieves all proxies for a source entity.
    * @param source - The proxy of the source entity.
    * @returns A readonly map of entity type UIDs to an array of their proxies.
    */
-  getAll(source: IEntityProxy): ReadonlyMap<EntityTypeUid, Readonly<IEntityProxy[]>>;
+  getAllProxies(source: IEntityProxy): ReadonlyMap<EntityTypeUid, Readonly<IEntityProxy[]>>;
   /**
    * Registers an entity as a scoped proxy, making it resolvable by any entity in the same scope.
    * Only entity types marked as scopeRoot or scopedProxy should be registered.
@@ -223,7 +344,7 @@ interface IEntityProxyRepository {
    * @param entityType - The entity type to resolve.
    * @returns The scoped proxy, or null if none exists.
    */
-  getScopedProxy(scopeId: string, entityType: EntityTypeUid): IEntityProxy | null;
+  getScopedProxy<TEntity extends IEntity = IEntity>(scopeId: string, entityType: EntityTypeUid): EntityProxy<TEntity> | null;
   /**
    * Removes an entity from the scoped proxy index.
    * Called during entity cleanup to unregister from scope resolution.
@@ -233,100 +354,20 @@ interface IEntityProxyRepository {
   removeScopedProxy(entity: IEntityProxy, scopeId: string): void;
 }
 //#endregion
-//#region src/entities/entity.d.ts
-/**
- * Represents the unique identifier for an entity type.
- * Can be either a string or a number.
- */
-type EntityTypeUid = string | number;
-/**
- * Represents the unique identifier for an entity.
- * Can be either a string or a number.
- */
-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.
- */
-type IEntityModel<TProxyTypes extends readonly EntityTypeUid[] = readonly []> = {
-  /**
-   * The unique identifier for this entity instance.
-   */
-  readonly uid: EntityUid;
-  /**
-   * The scope this entity belongs to.
-   * Automatically set by the framework — scopeRoot entities generate a UUID,
-   * child entities inherit from their parent via addEntity().
-   */
-  readonly scopeId?: string;
-} & (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.
- * State modifications occur exclusively through system operations, maintaining data integrity and enabling safe concurrent access.
- *
- * Implementations should provide strongly-typed accessors for components and proxies specific to their entity type,
- * enhancing IDE support and type safety without adding behavior beyond data access.
- */
-interface IEntity {
-  /**
-   * The set of components attached to this entity.
-   * Components are the primary data storage mechanism, mapped by their unique type identifiers.
-   */
-  readonly components: ReadonlyMap<ComponentTypeUid, IComponent>;
-  /**
-   * The identity component containing core entity metadata and initialization information.
-   * Every entity has exactly one identity component that persists for the entity's lifetime.
-   */
-  readonly identity: Readonly<IdentityComponent<IEntityModel>>;
-  /**
-   * A reference to this entity's own proxy.
-   */
-  readonly myProxy: Readonly<EntityProxy<this>>;
-}
-//#endregion
-//#region src/components/identity-component.d.ts
-/**
- * The `BasicComponentType` enum defines the types of basic components available.
- */
-declare enum BasicComponentType {
-  identity = "identity"
-}
+//#region src/components/component-repository.d.ts
 /**
- * The mandatory metadata component for every entity.
- * Contains core information that defines what an entity is and when it was last updated.
- * This component is immutable after creation and uniquely identifies each entity.
+ * The runtime source of truth for component instances, keyed by entity proxy.
  *
- * @template TModel - The entity model type containing initialization data.
+ * Generic `get<TComponent>` lets callsites narrow on demand without any global
+ * `ComponentTypeMap` augmentation. Most reads go through typed component fields on
+ * `context.entity`; direct `repository.get` is the escape hatch.
  */
-interface IdentityComponent<TModel extends IEntityModel> extends IComponent {
-  /**
-   * The entity type classification.
-   * Categorizes entities into logical types, allowing systems to selectively operate on specific entity categories.
-   */
-  readonly entityType: EntityTypeUid;
-  /**
-   * The initialization model for this entity.
-   * Provides the minimal data structure used when the entity was first created.
-   * Serves as a reference point for the entity's initial configuration.
-   *
-   * @type {Immutable<TModel>}
-   */
-  readonly model: Immutable<TModel>;
-  /**
-   * The timestamp of the entity's last system update.
-   * Useful for calculating elapsed time (delta time) between consecutive updates.
-   * Helps systems make time-aware decisions.
-   *
-   * @type {Date | undefined}
-   */
-  readonly lastUpdated?: Date;
+interface IComponentRepository {
+  setMany(key: IEntityProxy, components: readonly IComponent[]): void;
+  get<TComponent extends IComponent = IComponent>(key: IEntityProxy, type: ComponentTypeUid): TComponent | undefined;
+  getAll(key: IEntityProxy): readonly IComponent[];
+  removeAll(key: IEntityProxy): void;
 }
 //#endregion
-export { ConfigRecord as _, IEntity as a, IEntityProxy as c, TypedEntityProxy as d, ComponentTypeUid as f, ConfigOption as g, ConfigCustomControlOptions as h, EntityUid as i, IEntityProxyRepository as l, IComponentWithConfig as m, IdentityComponent as n, IEntityModel as o, IComponent as p, EntityTypeUid as r, EntityProxy as s, BasicComponentType as t, RequiredProxies as u };
-//# sourceMappingURL=index-BlP67nCr.d.mts.map
+export { ConfigCustomControlOptions as C, IComponentWithConfig as S, ConfigRecord as T, ModelOf as _, IEntityProxy as a, ComponentTypeUid as b, RequiredProxies as c, EntityUid as d, IEntity as f, IEntityWith as g, IEntitySpec as h, EntityProxyManyLookup as i, TypedEntityProxy as l, IEntityModelRef as m, EntityProxy as n, IEntityProxyRepository as o, IEntityModel as p, EntityProxyLookup as r, ProxyTypesOf as s, IComponentRepository as t, EntityTypeUid as u, BasicComponentType as v, ConfigOption as w, IComponent as x, IdentityComponent as y };
+//# sourceMappingURL=index-Dbwzlrgp.d.mts.map

package/dist/{index-DMTkNY1e.d.cts → index-aVjnG975.d.cts}

@@ -1,4 +1,4 @@
-import { r as Immutable } from "./types-Bbmnq4ni.cjs";
+import { r as Immutable } from "./types-BaCGIrym.cjs";
 
 //#region src/pipelines/pipeline-context.d.ts
 /**
@@ -7,16 +7,16 @@ import { r as Immutable } from "./types-Bbmnq4ni.cjs";
  */
 interface IPipelineContext {
   /**
-   * The runtime state and control interface for the pipeline.
+   * The dispatch state and control interface for the pipeline.
    * Allows middleware to query and influence pipeline behavior.
    */
-  readonly runtime?: PipelineRuntime;
+  readonly dispatch?: PipelineDispatch;
 }
 /**
- * Runtime state and control interface for pipeline execution.
+ * Dispatch state and control interface for pipeline execution.
  * Allows middleware to query status and influence pipeline flow.
  */
-type PipelineRuntime = {
+type PipelineDispatch = {
   /**
    * Flag to request pipeline halt.
    * Set to true to stop executing remaining middleware (cleanup still runs).
@@ -25,7 +25,7 @@ type PipelineRuntime = {
   /**
    * Optional error state if an exception occurred during execution.
    */
-  error?: any;
+  error?: unknown;
 };
 //#endregion
 //#region src/pipelines/middleware.d.ts
@@ -198,12 +198,12 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
   /**
    * Executes the action phase of all middleware in sequence.
    * Middleware at startIndex and onward are executed in order.
-   * Execution may terminate early if middleware requests it via context.runtime.shouldStop.
+   * Execution may terminate early if middleware requests it via context.dispatch.shouldStop.
    * @param context - The context passed to each middleware action.
    * @param middleware - The ordered middleware array to execute.
    * @param startIndex - Optional starting position in the middleware array (default: 0).
    */
-  dispatch(context: Partial<TContext>, middleware: IMiddleware<TContext>[], startIndex?: number): void | Promise<void>;
+  dispatch(context: Partial<TContext>, middleware: readonly IMiddleware<TContext>[], startIndex?: number): void | Promise<void>;
   /**
    * Executes the cleanup phase of all middleware in reverse order.
    * All middleware cleanup functions are called (if defined), regardless of errors.
@@ -211,8 +211,8 @@ interface IPipelineRunner<TContext extends IPipelineContext> {
    * @param context - The context passed to each middleware cleanup.
    * @param middleware - The ordered middleware array for cleanup (reversed during execution).
    */
-  cleanup(context: Partial<TContext>, middleware: IMiddleware<TContext>[]): void | Promise<void>;
+  cleanup(context: Partial<TContext>, middleware: readonly IMiddleware<TContext>[]): void | Promise<void>;
 }
 //#endregion
-export { IParentMiddleware as a, IMiddleware as c, IParentContext as i, IPipelineContext as l, INestedContext as n, IPipeline as o, INestedMiddleware as r, IMiddlewareRunner as s, IPipelineRunner as t, PipelineRuntime as u };
-//# sourceMappingURL=index-DMTkNY1e.d.cts.map
+export { IParentMiddleware as a, IMiddleware as c, IParentContext as i, IPipelineContext as l, INestedContext as n, IPipeline as o, INestedMiddleware as r, IMiddlewareRunner as s, IPipelineRunner as t, PipelineDispatch as u };
+//# sourceMappingURL=index-aVjnG975.d.cts.map