@jael-ecs/core 1.0.3 → 1.1.1

package/README.md

@@ -32,7 +32,8 @@ _A modern, performant, and user-friendly Entity Component System library written
 
 - **User Friendly API** - Clean, fluent api that's easy to learn
 - **High Performance** - Optimized SparseSet implementation for fast entity lookups
-- **Minimal Bundle size** - Compact bundle size without dependencies.(34kb 📦)
+- **Query System** - Optimized cache query system for entity packets
+- **Minimal Bundle size** - Compact bundle size without dependencies.(38kb 📦)
 
 ## Installation
 
@@ -60,13 +61,19 @@ interface Velocity {
 }
 
 // Create entities
-const player = world.create();
-world.addComponent(player, "position", { x: 0, y: 0 });
-world.addComponent(player, "velocity", { dx: 1, dy: 1 });
+const playerId = world.create();
+world.addComponent(playerId, "position", { x: 0, y: 0 });
+world.addComponent(playerId, "velocity", { dx: 1, dy: 1 });
 
-const enemy = world.create();
-world.addComponent(enemy, "position", { x: 10, y: 10 });
-world.addComponent(enemy, "velocity", { dx: -1, dy: 0 });
+const enemyId = world.create();
+world.addComponent(enemyId, "position", { x: 10, y: 10 });
+world.addComponent(enemyId, "velocity", { dx: -1, dy: 0 });
+
+// Using Entity Proxy
+const playerId = world.create();
+const player = world.getEntity(playerId);
+player.add("position", { x: 0, y: 0 });
+player.add("velocity", { dx: 1, dy: 1 });
 
 // Create a system
 const movementSystem: System = {
@@ -74,10 +81,20 @@ const movementSystem: System = {
   update() {
     const query = world.include("position", "velocity");
 
-    for (const entity of query.entities) {
+    // Get direct proxy access
+    query.entities.forEach((entity) => {
       const position = entity.get<Position>("position");
       const velocity = entity.get<Velocity>("velocity");
 
+      position.x += velocity.dx * (Time.delta || 0.016);
+      position.y += velocity.dy * (Time.delta || 0.016);
+    });
+
+    // Get entity ids from query
+    for (const entityId of query.ids) {
+      const position = this.world.getComponent<Position>(entityId, "position");
+      const velocity = this.world.getComponent<Velocity>(entityId, "velocity");
+
       position.x += velocity.dx * (Time.delta || 0.016);
       position.y += velocity.dy * (Time.delta || 0.016);
     }
@@ -111,29 +128,26 @@ The central hub that manages entities, components, and systems.
 
 ```typescript
 // Create a new entity
-const entity = world.create();
+const entityId = world.create();
 
 // Destroy an entity
-world.destroy(entity);
+world.destroy(entityId);
 
 // Check if entity exists
-const exists = world.exist(entity);
+const exists = world.exist(entityId);
 ```
 
 #### Component Management
 
 ```typescript
 // Add component
-world.addComponent(entity, "position", { x: 0, y: 0 });
+world.addComponent(entityId, "position", { x: 0, y: 0 });
 
 // Remove component
-world.removeComponent(entity, "position");
+world.removeComponent(entityId, "position");
 
 // Get component
-const position = entity.get<Position>("position");
-
-// Check if entity has component
-const hasPosition = entity.has("position");
+const position = world.getComponent<Position>(entityId, "position");
 ```
 
 #### System Management
@@ -149,7 +163,7 @@ world.removeSystem(yourSystem);
 #### Events
 
 ```typescript
-// Listen to world events
+// Listen to world events ( returns entity proxy for easy reading )
 world.on("entityCreated", ({ entity }) => {
   console.log("Entity created:", entity);
 });
@@ -173,11 +187,12 @@ world.on("updated", () => {
 
 ### Entity
 
-Base entity class for intuitive component management
+Base entity class for intuitive component management as proxy around id
 
 ```typescript
 // Create entity
-const entity = world.create();
+const entityId = world.create();
+const entity = world.getEntity(entityId); // Returns Entity class proxy
 
 // Add component
 entity.add("position", { x: 0, y: 0 });
@@ -190,6 +205,9 @@ const posExist = entity.has("position");
 
 // Get curren value of the component
 const compSchema = entity.get("position");
+
+entity.id // Returns unique entity id from proxy
+
 ```
 
 ### System
@@ -199,7 +217,7 @@ Systems contain the game logic that processes entities with specific components.
 ```typescript
 interface System {
   priority: number; // Execution order (lower = earlier)
-  init?(): void // Runs when added to the world
+  init?(): void; // Runs when added to the world
   exit?(): void; // Cleanup when removed
   update(): void; // Main update logic
 }
@@ -218,13 +236,13 @@ const renderSystem: System = {
   update(dt) {
     const renderableQuery = world.include("position", "sprite");
 
-    for (const entity of renderableQuery.entities) {
+    renderableQuery.entities.forEach((entity) => {
       const position = entity.get<Position>("position");
       const sprite = entity.get<Sprite>("sprite");
 
       // Render entity
       drawSprite(sprite, position.x, position.y);
-    }
+    })
   },
 
   exit() {
@@ -266,29 +284,36 @@ const complexQuery2 = world.include("position", "health").exclude("static");
 #### Accessing Results
 
 ```typescript
-// Iterate through entities
-for (const entity of query.entities) {
-  // Process entity
+// Iterate through entities as proxy
+query.entities.forEach((entity) => {
+  // Process Entity proxy
+})
+
+// Iterate through entities ids
+for(const entityId of query.ids){
+  // Process Entity id
 }
 
+
+
 // Get the first value of the query
-const first = query.entities.first();
+const first = query.entities[0];
+const firstId = query.ids.first()
 
 // Check query size
-const count = query.entities.size();
+const count = query.size();
 
 // Check if query has any entities
-const isEmpty = query.entities.size() === 0;
+const isEmpty = query.size() === 0;
 
 // Subscribe to query events
-query.on('added', (entity: Entity) => {
-  // Entity added
-})
-
-query.on('removed', (entity: Entity) => {
+query.on("added", (entityId: number) => {
   // Entity added
-})
+});
 
+query.on("removed", (entityId: number) => {
+  // Entity removed
+});
 ```
 
 ### SparseSet
@@ -353,8 +378,8 @@ interface WorldEvents {
 }
 
 interface QueryEvents {
-  added: Entity; //Entity added to query entities
-  removed: Entity; //Entity removed to query entities
+  added: number; //EntityId added to query entities
+  removed: number; //EntityId removed to query entities
 }
 
 // Listen to events
@@ -369,7 +394,7 @@ world.emit("entityCreated", { entity: someEntity });
 world.off("entityCreated", handler);
 
 // Romeve all listeners of a type
-world.clearEvent('type')
+world.clearEvent("type");
 
 // Remove all listeners
 world.clearAllEvents();
@@ -425,8 +450,8 @@ class MovementSystem implements System {
   }
 
   update() {
-    for (const entity of this.movementQuery.entities) {
-      // Process movement
+    for(const entityId of this.movementQuery.ids){
+      // Process movement using entityId
     }
   }
 }
@@ -438,13 +463,13 @@ type MovementSystem = { movementQuery: Query | null } & System;
 const movementSystem: MovementSystem = {
   movementQuery: null;
   priority: 1;
-  
+
   init(){
     this.movementQuery = world.include('position', 'velocity');
   }
 
   update(){
-    for (const entity of this.movementQuery.entities) {
+    for (const entityId of this.movementQuery.ids) {
       // Process movement
     }
   }
@@ -461,7 +486,7 @@ update() {
 
 ```typescript
 // Remember to clean up when removing entities
-world.destroy(entity); // Automatically removes all components
+world.destroy(entityId); // Automatically removes all components
 
 // Clean up systems if they have resources
 system.exit?.(); // Called automatically when removed from world

package/dist/ComponentManager.d.ts

@@ -1,24 +1,25 @@
-import { Entity } from './EntityManager';
 import { default as EventRegistry } from './EventRegistry';
 import { default as World } from './World';
 export type ComponentSchema = Record<string, any>;
 export interface ComponentManagerEvents {
     add: {
-        entity: Entity;
+        entityId: number;
         component: keyof ComponentSchema;
     };
     remove: {
-        entity: Entity;
+        entityId: number;
         component: keyof ComponentSchema;
     };
 }
 export declare class ComponentManager extends EventRegistry<ComponentManagerEvents> {
-    componentSet: Map<number, ComponentSchema>;
+    componentSet: {
+        [k: number]: ComponentSchema;
+    };
     world: World;
     constructor(world: World);
-    clearComponentSchema(entity: Entity): void;
-    addComponent<K extends keyof ComponentSchema>(entity: Entity, key: K, value: ComponentSchema[K]): void;
-    getComponent<K extends keyof ComponentSchema>(entity: Entity, key: K): ComponentSchema[K] | undefined;
-    hasComponent<K extends keyof ComponentSchema>(entity: Entity, key: K): boolean;
-    removeComponent<K extends keyof ComponentSchema>(entity: Entity, key: K): void;
+    clearComponentSchema(entityId: number): void;
+    addComponent<K extends keyof ComponentSchema>(entityId: number, key: K, value: ComponentSchema[K]): void;
+    getComponent<K extends keyof ComponentSchema>(entityId: number, key: K): ComponentSchema[K] | undefined;
+    hasComponent<K extends keyof ComponentSchema>(entityId: number, key: K): boolean;
+    removeComponent<K extends keyof ComponentSchema>(entityId: number, key: K): void;
 }

package/dist/EntityManager.d.ts

@@ -1,7 +1,7 @@
 import { default as EventRegistry } from './EventRegistry';
 import { SparseSet } from './SparseSet';
 import { default as World } from './World';
-declare class Entity {
+export declare class Entity {
     readonly id: number;
     private _world;
     constructor(world: World, id: number);
@@ -30,18 +30,17 @@ declare class Entity {
     get<T = any>(compType: string): T;
 }
 export declare class EntityManager extends EventRegistry<EntityManagerEvents> {
-    entityMap: SparseSet<Entity>;
+    entityMap: SparseSet<number>;
     nextId: number;
     _world: World;
     constructor(world: World);
-    get entities(): SparseSet<Entity>;
-    create(): Entity;
-    exist(entity: Entity): boolean;
+    get entities(): SparseSet<number>;
+    create(): number;
+    exist(id: number): boolean;
     size(): number;
-    destroy(entity: Entity): Entity;
+    destroy(id: number): number;
 }
 export interface EntityManagerEvents {
-    create: Entity;
-    destroy: Entity;
+    create: number;
+    destroy: number;
 }
-export { type Entity };

package/dist/EventRegistry.d.ts

@@ -1,11 +1,14 @@
-export type Event<E> = (e: E[keyof E]) => void;
-export default class EventRegistry<E extends Record<string, any> = {}> {
+export type Event<V> = {
+    [key: string]: V;
+};
+export type EventCallback<V> = (event: V[keyof V]) => void;
+export default class EventRegistry<E extends Event<any> = {}> {
     private _listeners;
-    on(type: keyof E, callback: Event<E>): void;
-    off(type: keyof E, callback: Event<E>): void;
-    once(type: keyof E, callback: Event<E>): void;
+    on(type: keyof E, callback: EventCallback<E>): void;
+    off(type: keyof E, callback: EventCallback<E>): void;
+    once(type: keyof E, callback: EventCallback<E>): void;
     clearEvent(type: keyof E): void;
     clearAllEvents(): void;
-    contains(type: keyof E, callback: Event<E>): boolean;
+    contains(type: keyof E, callback: EventCallback<E>): boolean;
     emit(type: keyof E, data: E[keyof E]): void;
 }

package/dist/Query.d.ts

@@ -7,16 +7,21 @@ export interface QueryConfig {
     exclude: string[];
 }
 export interface QueryEvents {
-    added: Entity;
-    removed: Entity;
+    added: number;
+    removed: number;
 }
 export declare class Query extends EventRegistry<QueryEvents> {
-    config: QueryConfig;
-    entityMap: SparseSet<Entity>;
-    world: World;
+    private config;
+    private entityMap;
+    private entityInstancesCache;
+    private world;
     constructor(config: QueryConfig, world: World);
-    hasComponents(entity: Entity): boolean;
-    get entities(): SparseSet<Entity>;
+    hasComponents(entityId: number): boolean;
+    size(): number;
+    get hash(): number;
+    get ids(): SparseSet<number>;
+    private getCachedEntity;
+    get entities(): Entity[];
     include(...comps: string[]): Query;
     exclude(...comps: string[]): Query;
     private _checkExistingEntities;

package/dist/World.d.ts

@@ -1,5 +1,5 @@
 import { ComponentManager, ComponentSchema } from './ComponentManager';
-import { EntityManager, Entity } from './EntityManager';
+import { Entity, EntityManager } from './EntityManager';
 import { default as EventRegistry } from './EventRegistry';
 import { Query, QueryConfig } from './Query';
 import { SparseSet } from './SparseSet';
@@ -27,17 +27,19 @@ export default class World extends EventRegistry<WorldEvents> {
     systemManager: SystemManager;
     queries: Map<number, Query>;
     constructor();
-    get entities(): SparseSet<Entity>;
+    getEntity(id: number): Entity | undefined;
+    get entityIds(): SparseSet<number>;
     query(config: QueryConfig): Query;
     private _updateQueries;
-    exist(entity: Entity): boolean;
+    exist(entityId: number): boolean;
     include(...comps: string[]): Query;
     exclude(...comps: string[]): Query;
-    create(): Entity;
-    destroy(entity: Entity): void;
+    create(): number;
+    destroy(entityId: number): void;
     addSystem(sys: System): void;
     removeSystem(sys: System): void;
-    addComponent(entity: Entity, compKey: string, compValue: any): void;
-    removeComponent(entity: Entity, compKey: string): void;
+    addComponent(entityId: number, compKey: string, compValue: any): void;
+    getComponent<T>(entityId: number, compKey: string): T;
+    removeComponent(entityId: number, compKey: string): void;
     update(): void;
 }

package/dist/jael-build.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class o{_listeners=new Map;on(e,t){if(this.contains(e,t))return;const s=this._listeners.get(e);s?s.add(t):this._listeners.set(e,new Set([t]))}off(e,t){if(!this.contains(e,t))return;const s=this._listeners.get(e);s&&s.delete(t)}once(e,t){const s=(i=>{t(i),this.off(e,s)});this.on(e,s)}clearEvent(e){this._listeners.get(e)&&this._listeners.get(e)?.clear()}clearAllEvents(){this._listeners.forEach(e=>e.clear()),this._listeners.clear()}contains(e,t){return this._listeners.get(e)?this._listeners.get(e).has(t):!1}emit(e,t){this._listeners.get(e)&&this._listeners.get(e)?.forEach(s=>{s(t)})}}class c{systemList=[];addSystem(e){this.systemList.push(e),e.init?.(),this.reorder()}reorder(){this.systemList.sort((e,t)=>e.priority-t.priority)}has(e){return this.systemList.indexOf(e)>0}removeSystem(e){if(!this.has(e))return;const t=this.systemList.indexOf(e);t>=0&&(this.systemList.splice(t,1),e.exit?.(),this.reorder())}}class d{denseValues=[];sparse=new Map;[Symbol.iterator](){let e=this.values.length;const t={value:void 0,done:!1};return{next:()=>(t.value=this.values[--e],t.done=e<0,t)}}get values(){return this.denseValues}first(){return this.denseValues[0]}add(e){this.has(e)||(this.denseValues.push(e),this.sparse.set(e,this.denseValues.length-1))}indexOf(e){return this.sparse.get(e)?this.sparse.get(e):-1}remove(e){if(!this.has(e))return;const t=this.sparse.get(e);this.sparse.delete(e);const s=this.denseValues[this.denseValues.length-1];s!==e&&(this.denseValues[t]=s,this.sparse.set(s,t)),this.denseValues.pop()}forEach(e){for(let t of this)e(t)}size(){return this.denseValues.length}clear(){for(let e of this)this.remove(e)}has(e){return this.sparse.has(e)}}class m{id;_world;constructor(e,t){this.id=t,this._world=e}add(e,t){this._world.addComponent(this,e,t)}remove(e){this._world.removeComponent(this,e)}has(e){return this._world.componentManager.hasComponent(this,e)}get(e){return this._world.componentManager.getComponent(this,e)}}class u extends o{entityMap=new d;nextId=0;_world;constructor(e){super(),this._world=e}get entities(){return this.entityMap}create(){const e=this.nextId++,t=new m(this._world,e);return this.entities.add(t),this.emit("create",t),t}exist(e){return this.entities.has(e)}size(){return this.entities.size()}destroy(e){return this.entities.remove(e),this.emit("destroy",e),e}}class l extends o{componentSet=new Map;world;constructor(e){super(),this.world=e}clearComponentSchema(e){this.componentSet.get(e.id)&&this.componentSet.delete(e.id)}addComponent(e,t,s){const i=this.componentSet.get(e.id);i?i[t]=s:this.componentSet.set(e.id,{[t]:s}),this.emit("add",{entity:e,component:t})}getComponent(e,t){return this.hasComponent(e,t)?this.componentSet.get(e.id)[t]:void 0}hasComponent(e,t){const s=this.componentSet.get(e.id);return s?t in s:!1}removeComponent(e,t){if(!this.componentSet.get(e.id))return;const s=this.componentSet.get(e.id);s&&s[t]!==void 0&&(delete s[t],Object.keys(s).length===0&&this.componentSet.delete(e.id),this.emit("remove",{entity:e,component:t}))}}class a extends o{config;entityMap;world;constructor(e,t){super(),this.config=e,this.world=t,this.entityMap=new d}hasComponents(e){return this.config.include?.every(t=>e.has(t))&&this.config.exclude?.every(t=>!e.has(t))}get entities(){return this.entityMap}include(...e){return this.world.include(...e)}exclude(...e){return this.world.exclude(...e)}_checkExistingEntities(){for(let e of this.entities)this.world.exist(e)||(this.emit("removed",e),this.entityMap.remove(e))}checkEntities(){for(let e of this.world.entities)e&&this.hasComponents(e)&&(this.entityMap.add(e),this.emit("added",e));this._checkExistingEntities()}static getHash(e){const t=e.include?.map(n=>n.trim()).filter(n=>n).join("_"),s=e.exclude?.map(n=>n.trim()).filter(n=>n).join("_"),i="in_"+t+"_out_"+s;let h=0;for(const n of i)h=(h<<5)-h+n.charCodeAt(0),h|=0;return h}}class p extends o{_startTime=0;_oldTime=0;_requestId=0;running=!1;delta=0;elapsed=0;constructor(){super()}_loop(){let e=0;if(this.running){const t=performance.now();e=(t-this._oldTime)/1e3,this._oldTime=t,this.elapsed+=e}this.delta=e,this.emit("update"),this._requestId=requestAnimationFrame(this._loop.bind(this))}start(){this._startTime=performance.now(),this._oldTime=this._startTime,this.elapsed=0,this.delta=0,this.running=!0,this._loop()}stop(){this.running=!1,cancelAnimationFrame(this._requestId),this._requestId=0}}let g=new p;class f extends o{entityManager;componentManager;systemManager;queries;constructor(){super(),this.entityManager=new u(this),this.componentManager=new l(this),this.systemManager=new c,this.entityManager.on("create",e=>{e&&(this.emit("entityCreated",{entity:e}),this._updateQueries())}),this.entityManager.on("destroy",e=>{e&&(this.emit("entityDestroyed",{entity:e}),this._updateQueries(),this.componentManager.clearComponentSchema(e))}),this.componentManager.on("add",e=>{this.emit("componentAdded",{entity:e.entity,component:e.component}),this._updateQueries()}),this.componentManager.on("remove",e=>{this.emit("componentRemoved",{entity:e.entity,component:e.component}),this._updateQueries()}),this.queries=new Map}get entities(){return this.entityManager.entities}query(e){const t=a.getHash(e);let i=this.queries.get(t);return i||(i=new a(e,this),this.queries.set(t,i),this._updateQueries()),i}_updateQueries(){this.queries.forEach(e=>e.checkEntities())}exist(e){return this.entityManager.exist(e)}include(...e){return this.query({include:e,exclude:[]})}exclude(...e){return this.query({include:[],exclude:e})}create(){return this.entityManager.create()}destroy(e){this.entityManager.destroy(e)}addSystem(e){this.systemManager.addSystem(e)}removeSystem(e){this.systemManager.removeSystem(e)}addComponent(e,t,s){this.componentManager.addComponent(e,t,s)}removeComponent(e,t){this.componentManager.removeComponent(e,t)}update(){this.systemManager.systemList.forEach(e=>{e.update()}),this.emit("updated")}}exports.ComponentManager=l;exports.EntityManager=u;exports.EventRegistry=o;exports.Query=a;exports.SparseSet=d;exports.SystemManager=c;exports.Time=g;exports.World=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class o{_listeners=new Map;on(e,t){if(this.contains(e,t))return;const s=this._listeners.get(e);s?s.add(t):this._listeners.set(e,new Set([t]))}off(e,t){if(!this.contains(e,t))return;const s=this._listeners.get(e);s&&s.delete(t)}once(e,t){const s=(n=>{t(n),this.off(e,s)});this.on(e,s)}clearEvent(e){this._listeners.get(e)&&this._listeners.get(e)?.clear()}clearAllEvents(){this._listeners.forEach(e=>e.clear()),this._listeners.clear()}contains(e,t){return this._listeners.get(e)?this._listeners.get(e).has(t):!1}emit(e,t){this._listeners.get(e)&&this._listeners.get(e)?.forEach(s=>{s(t)})}}class u{systemList=[];addSystem(e){this.systemList.push(e),e.init?.(),this.reorder()}reorder(){this.systemList.sort((e,t)=>e.priority-t.priority)}has(e){return this.systemList.indexOf(e)>0}removeSystem(e){if(!this.has(e))return;const t=this.systemList.indexOf(e);t>=0&&(this.systemList.splice(t,1),e.exit?.(),this.reorder())}}class d{denseValues=[];sparse=new Map;[Symbol.iterator](){let e=this.values.length;const t={value:void 0,done:!1};return{next:()=>(t.value=this.values[--e],t.done=e<0,t)}}get values(){return this.denseValues}first(){return this.denseValues[0]}add(e){this.has(e)||(this.denseValues.push(e),this.sparse.set(e,this.denseValues.length-1))}indexOf(e){const t=this.sparse.get(e);return t!==void 0?t:-1}remove(e){if(!this.has(e))return;const t=this.sparse.get(e);this.sparse.delete(e);const s=this.denseValues[this.denseValues.length-1];s!==e&&(this.denseValues[t]=s,this.sparse.set(s,t)),this.denseValues.pop()}forEach(e){for(let t of this)e(t)}size(){return this.denseValues.length}clear(){for(let e of this)this.remove(e)}has(e){return this.sparse.has(e)}}class a{id;_world;constructor(e,t){this.id=t,this._world=e}add(e,t){this._world.addComponent(this.id,e,t)}remove(e){this._world.removeComponent(this.id,e)}has(e){return this._world.componentManager.hasComponent(this.id,e)}get(e){return this._world.componentManager.getComponent(this.id,e)}}class l extends o{entityMap=new d;nextId=0;_world;constructor(e){super(),this._world=e}get entities(){return this.entityMap}create(){const e=this.nextId++;return this.entities.add(e),this.emit("create",e),e}exist(e){return this.entities.has(e)}size(){return this.entities.size()}destroy(e){return this.entities.remove(e),this.emit("destroy",e),e}}class m extends o{componentSet={};world;constructor(e){super(),this.world=e}clearComponentSchema(e){this.componentSet[e]&&delete this.componentSet[e]}addComponent(e,t,s){if(!this.world.exist(e))return;const n=this.componentSet[e];n?n[t]=s:this.componentSet[e]={[t]:s},this.emit("add",{entityId:e,component:t})}getComponent(e,t){if(this.hasComponent(e,t))return this.componentSet[e][t]}hasComponent(e,t){const s=this.componentSet[e];return s?t in s:!1}removeComponent(e,t){if(!this.componentSet[e])return;const s=this.componentSet[e];s&&s[t]!==void 0&&(delete s[t],Object.keys(s).length===0&&delete this.componentSet[e],this.emit("remove",{entityId:e,component:t}))}}class c extends o{config;entityMap;entityInstancesCache;world;constructor(e,t){super(),this.config=e,this.world=t,this.entityInstancesCache=new Map,this.entityMap=new d,this.on("removed",s=>{this.entityInstancesCache.delete(s)})}hasComponents(e){const t=this.world.componentManager;return this.config.include?.every(s=>t.getComponent(e,s))&&this.config.exclude?.every(s=>!t.getComponent(e,s))}size(){return this.ids.size()}get hash(){return c.getHash(this.config)}get ids(){return this.entityMap}getCachedEntity(e){const t=this.entityInstancesCache.get(e);if(t)return t;{const s=this.world.getEntity(e);return s?(this.entityInstancesCache.set(e,s),s):void 0}}get entities(){const e=[],t=this.entityMap.size()>100;return this.entityMap.forEach(s=>{if(t){const n=this.getCachedEntity(s);n&&e.push(n)}else{const n=this.world.getEntity(s);n&&e.push(n)}}),e}include(...e){return this.world.include(...e)}exclude(...e){return this.world.exclude(...e)}_checkExistingEntities(){for(let e of this.ids)this.world.exist(e)||(this.emit("removed",e),this.entityMap.remove(e))}checkEntities(){this.entityInstancesCache.clear();for(let e of this.world.entityIds)this.hasComponents(e)&&(this.entityMap.add(e),this.emit("added",e));this._checkExistingEntities()}static getHash(e){const t=e.include?.map(i=>i.trim()).filter(i=>i).join("_"),s=e.exclude?.map(i=>i.trim()).filter(i=>i).join("_"),n="in_"+t+"_out_"+s;let h=0;for(const i of n)h=(h<<5)-h+i.charCodeAt(0),h|=0;return h}}class p extends o{_startTime=0;_oldTime=0;_requestId=0;running=!1;delta=0;elapsed=0;constructor(){super()}_loop(){let e=0;if(this.running){const t=performance.now();e=(t-this._oldTime)/1e3,this._oldTime=t,this.elapsed+=e}this.delta=e,this.emit("update"),this._requestId=requestAnimationFrame(this._loop.bind(this))}start(){this._startTime=performance.now(),this._oldTime=this._startTime,this.elapsed=0,this.delta=0,this.running=!0,this._loop()}stop(){this.running=!1,cancelAnimationFrame(this._requestId),this._requestId=0}}let g=new p;class f extends o{entityManager;componentManager;systemManager;queries;constructor(){super(),this.entityManager=new l(this),this.componentManager=new m(this),this.systemManager=new u,this.entityManager.on("create",e=>{this.emit("entityCreated",{entity:new a(this,e)}),this._updateQueries()}),this.entityManager.on("destroy",e=>{this.emit("entityDestroyed",{entity:new a(this,e)}),this._updateQueries(),this.componentManager.clearComponentSchema(e)}),this.componentManager.on("add",({entityId:e,component:t})=>{this.emit("componentAdded",{entity:new a(this,e),component:t}),this._updateQueries()}),this.componentManager.on("remove",({entityId:e,component:t})=>{this.getEntity(e)&&this.emit("componentRemoved",{entity:new a(this,e),component:t}),this._updateQueries()}),this.queries=new Map}getEntity(e){return this.exist(e)?new a(this,e):void 0}get entityIds(){return this.entityManager.entities}query(e){const t=c.getHash(e);let n=this.queries.get(t);return n||(n=new c(e,this),this.queries.set(t,n),this._updateQueries()),n}_updateQueries(){this.queries.forEach(e=>e.checkEntities())}exist(e){return this.entityManager.exist(e)}include(...e){return this.query({include:e,exclude:[]})}exclude(...e){return this.query({include:[],exclude:e})}create(){return this.entityManager.create()}destroy(e){this.entityManager.destroy(e)}addSystem(e){this.systemManager.addSystem(e)}removeSystem(e){this.systemManager.removeSystem(e)}addComponent(e,t,s){this.componentManager.addComponent(e,t,s)}getComponent(e,t){return this.componentManager.getComponent(e,t)}removeComponent(e,t){this.componentManager.removeComponent(e,t)}update(){this.systemManager.systemList.forEach(e=>{e.update()}),this.emit("updated")}}exports.ComponentManager=m;exports.EntityManager=l;exports.EventRegistry=o;exports.Query=c;exports.SparseSet=d;exports.SystemManager=u;exports.Time=g;exports.World=f;

package/dist/jael-build.js

@@ -1,4 +1,4 @@
-class h {
+class a {
   _listeners = /* @__PURE__ */ new Map();
   on(e, t) {
     if (this.contains(e, t))
@@ -13,8 +13,8 @@ class h {
     s && s.delete(t);
   }
   once(e, t) {
-    const s = ((i) => {
-      t(i), this.off(e, s);
+    const s = ((n) => {
+      t(n), this.off(e, s);
     });
     this.on(e, s);
   }
@@ -33,7 +33,7 @@ class h {
     });
   }
 }
-class c {
+class u {
   systemList = [];
   addSystem(e) {
     this.systemList.push(e), e.init?.(), this.reorder();
@@ -73,7 +73,8 @@ class d {
     this.has(e) || (this.denseValues.push(e), this.sparse.set(e, this.denseValues.length - 1));
   }
   indexOf(e) {
-    return this.sparse.get(e) ? this.sparse.get(e) : -1;
+    const t = this.sparse.get(e);
+    return t !== void 0 ? t : -1;
   }
   remove(e) {
     if (!this.has(e)) return;
@@ -97,7 +98,7 @@ class d {
     return this.sparse.has(e);
   }
 }
-class u {
+class h {
   id;
   _world;
   constructor(e, t) {
@@ -109,14 +110,14 @@ class u {
    * @param compValue Component value
    */
   add(e, t) {
-    this._world.addComponent(this, e, t);
+    this._world.addComponent(this.id, e, t);
   }
   /**
    * Remove component of current entity.
    * @param compType Component name
    */
   remove(e) {
-    this._world.removeComponent(this, e);
+    this._world.removeComponent(this.id, e);
   }
   /**
    * Check if current entity has a component.
@@ -124,7 +125,7 @@ class u {
    * @returns boolean
    */
   has(e) {
-    return this._world.componentManager.hasComponent(this, e);
+    return this._world.componentManager.hasComponent(this.id, e);
   }
   /**
    * Get passed component schema of current entity.
@@ -132,10 +133,10 @@ class u {
    * @returns Return component schema with T(any as default) as type
    */
   get(e) {
-    return this._world.componentManager.getComponent(this, e);
+    return this._world.componentManager.getComponent(this.id, e);
   }
 }
-class l extends h {
+class l extends a {
   entityMap = new d();
   nextId = 0;
   _world;
@@ -146,8 +147,8 @@ class l extends h {
     return this.entityMap;
   }
   create() {
-    const e = this.nextId++, t = new u(this._world, e);
-    return this.entities.add(t), this.emit("create", t), t;
+    const e = this.nextId++;
+    return this.entities.add(e), this.emit("create", e), e;
   }
   exist(e) {
     return this.entities.has(e);
@@ -159,47 +160,82 @@ class l extends h {
     return this.entities.remove(e), this.emit("destroy", e), e;
   }
 }
-class m extends h {
-  componentSet = /* @__PURE__ */ new Map();
+class m extends a {
+  componentSet = {};
   world;
   constructor(e) {
     super(), this.world = e;
   }
   clearComponentSchema(e) {
-    this.componentSet.get(e.id) && this.componentSet.delete(e.id);
+    this.componentSet[e] && delete this.componentSet[e];
   }
   addComponent(e, t, s) {
-    const i = this.componentSet.get(
-      e.id
-    );
-    i ? i[t] = s : this.componentSet.set(e.id, { [t]: s }), this.emit("add", { entity: e, component: t });
+    if (!this.world.exist(e)) return;
+    const n = this.componentSet[e];
+    n ? n[t] = s : this.componentSet[e] = { [t]: s }, this.emit("add", { entityId: e, component: t });
   }
   getComponent(e, t) {
-    return this.hasComponent(e, t) ? this.componentSet.get(e.id)[t] : void 0;
+    if (this.hasComponent(e, t))
+      return this.componentSet[e][t];
   }
   hasComponent(e, t) {
-    const s = this.componentSet.get(e.id);
+    const s = this.componentSet[e];
     return s ? t in s : !1;
   }
   removeComponent(e, t) {
-    if (!this.componentSet.get(e.id)) return;
-    const s = this.componentSet.get(e.id);
-    s && s[t] !== void 0 && (delete s[t], Object.keys(s).length === 0 && this.componentSet.delete(e.id), this.emit("remove", { entity: e, component: t }));
+    if (!this.componentSet[e]) return;
+    const s = this.componentSet[e];
+    s && s[t] !== void 0 && (delete s[t], Object.keys(s).length === 0 && delete this.componentSet[e], this.emit("remove", { entityId: e, component: t }));
   }
 }
-class a extends h {
+class c extends a {
   config;
   entityMap;
+  entityInstancesCache;
   world;
   constructor(e, t) {
-    super(), this.config = e, this.world = t, this.entityMap = new d();
+    super(), this.config = e, this.world = t, this.entityInstancesCache = /* @__PURE__ */ new Map(), this.entityMap = new d(), this.on("removed", (s) => {
+      this.entityInstancesCache.delete(s);
+    });
   }
   hasComponents(e) {
-    return this.config.include?.every((t) => e.has(t)) && this.config.exclude?.every((t) => !e.has(t));
+    const t = this.world.componentManager;
+    return this.config.include?.every(
+      (s) => t.getComponent(e, s)
+    ) && this.config.exclude?.every(
+      (s) => !t.getComponent(e, s)
+    );
   }
-  get entities() {
+  size() {
+    return this.ids.size();
+  }
+  get hash() {
+    return c.getHash(this.config);
+  }
+  get ids() {
     return this.entityMap;
   }
+  getCachedEntity(e) {
+    const t = this.entityInstancesCache.get(e);
+    if (t)
+      return t;
+    {
+      const s = this.world.getEntity(e);
+      return s ? (this.entityInstancesCache.set(e, s), s) : void 0;
+    }
+  }
+  get entities() {
+    const e = [], t = this.entityMap.size() > 100;
+    return this.entityMap.forEach((s) => {
+      if (t) {
+        const n = this.getCachedEntity(s);
+        n && e.push(n);
+      } else {
+        const n = this.world.getEntity(s);
+        n && e.push(n);
+      }
+    }), e;
+  }
   include(...e) {
     return this.world.include(...e);
   }
@@ -207,23 +243,24 @@ class a extends h {
     return this.world.exclude(...e);
   }
   _checkExistingEntities() {
-    for (let e of this.entities)
+    for (let e of this.ids)
       this.world.exist(e) || (this.emit("removed", e), this.entityMap.remove(e));
   }
   checkEntities() {
-    for (let e of this.world.entities)
-      e && this.hasComponents(e) && (this.entityMap.add(e), this.emit("added", e));
+    this.entityInstancesCache.clear();
+    for (let e of this.world.entityIds)
+      this.hasComponents(e) && (this.entityMap.add(e), this.emit("added", e));
     this._checkExistingEntities();
   }
   static getHash(e) {
-    const t = e.include?.map((n) => n.trim()).filter((n) => n).join("_"), s = e.exclude?.map((n) => n.trim()).filter((n) => n).join("_"), i = "in_" + t + "_out_" + s;
+    const t = e.include?.map((i) => i.trim()).filter((i) => i).join("_"), s = e.exclude?.map((i) => i.trim()).filter((i) => i).join("_"), n = "in_" + t + "_out_" + s;
     let o = 0;
-    for (const n of i)
-      o = (o << 5) - o + n.charCodeAt(0), o |= 0;
+    for (const i of n)
+      o = (o << 5) - o + i.charCodeAt(0), o |= 0;
     return o;
   }
 }
-class p extends h {
+class p extends a {
   _startTime = 0;
   _oldTime = 0;
   _requestId = 0;
@@ -249,41 +286,42 @@ class p extends h {
   }
 }
 let g = new p();
-class f extends h {
+class f extends a {
   entityManager;
   componentManager;
   systemManager;
   queries;
   constructor() {
-    super(), this.entityManager = new l(this), this.componentManager = new m(this), this.systemManager = new c(), this.entityManager.on("create", (e) => {
-      e && (this.emit("entityCreated", { entity: e }), this._updateQueries());
+    super(), this.entityManager = new l(this), this.componentManager = new m(this), this.systemManager = new u(), this.entityManager.on("create", (e) => {
+      this.emit("entityCreated", {
+        entity: new h(this, e)
+      }), this._updateQueries();
     }), this.entityManager.on("destroy", (e) => {
-      e && (this.emit("entityDestroyed", { entity: e }), this._updateQueries(), this.componentManager.clearComponentSchema(e));
-    }), this.componentManager.on(
-      "add",
-      (e) => {
-        this.emit("componentAdded", {
-          entity: e.entity,
-          component: e.component
-        }), this._updateQueries();
-      }
-    ), this.componentManager.on(
-      "remove",
-      (e) => {
-        this.emit("componentRemoved", {
-          entity: e.entity,
-          component: e.component
-        }), this._updateQueries();
-      }
-    ), this.queries = /* @__PURE__ */ new Map();
-  }
-  get entities() {
+      this.emit("entityDestroyed", {
+        entity: new h(this, e)
+      }), this._updateQueries(), this.componentManager.clearComponentSchema(e);
+    }), this.componentManager.on("add", ({ entityId: e, component: t }) => {
+      this.emit("componentAdded", {
+        entity: new h(this, e),
+        component: t
+      }), this._updateQueries();
+    }), this.componentManager.on("remove", ({ entityId: e, component: t }) => {
+      this.getEntity(e) && this.emit("componentRemoved", {
+        entity: new h(this, e),
+        component: t
+      }), this._updateQueries();
+    }), this.queries = /* @__PURE__ */ new Map();
+  }
+  getEntity(e) {
+    return this.exist(e) ? new h(this, e) : void 0;
+  }
+  get entityIds() {
     return this.entityManager.entities;
   }
   query(e) {
-    const t = a.getHash(e);
-    let i = this.queries.get(t);
-    return i || (i = new a(e, this), this.queries.set(t, i), this._updateQueries()), i;
+    const t = c.getHash(e);
+    let n = this.queries.get(t);
+    return n || (n = new c(e, this), this.queries.set(t, n), this._updateQueries()), n;
   }
   _updateQueries() {
     this.queries.forEach((e) => e.checkEntities());
@@ -312,6 +350,9 @@ class f extends h {
   addComponent(e, t, s) {
     this.componentManager.addComponent(e, t, s);
   }
+  getComponent(e, t) {
+    return this.componentManager.getComponent(e, t);
+  }
   removeComponent(e, t) {
     this.componentManager.removeComponent(e, t);
   }
@@ -324,10 +365,10 @@ class f extends h {
 export {
   m as ComponentManager,
   l as EntityManager,
-  h as EventRegistry,
-  a as Query,
+  a as EventRegistry,
+  c as Query,
   d as SparseSet,
-  c as SystemManager,
+  u as SystemManager,
   g as Time,
   f as World
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jael-ecs/core",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "description": "Entity Component System library with typescript",
   "keywords": [
     "ecs",