@jael-ecs/core 1.0.3 → 1.1.0

package/README.md

@@ -60,13 +60,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 +80,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 +127,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 +162,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 +186,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 +204,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 +216,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 +235,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 +283,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 +377,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 +393,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 +449,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 +462,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 +485,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 d{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 c{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 m{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 u extends o{entityMap=new c;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 l extends o{componentSet={};world;constructor(e){super(),this.world=e}clearComponentSchema(e){this.componentSet[e]&&delete this.componentSet[e]}addComponent(e,t,s){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 a extends o{config;entityMap;entityInstancesCache;world;constructor(e,t){super(),this.config=e,this.world=t,this.entityInstancesCache=new Map,this.entityMap=new c,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 a.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 u(this),this.componentManager=new l(this),this.systemManager=new d,this.entityManager.on("create",e=>{const t=this.getEntity(e);t&&(this.emit("entityCreated",{entity:t}),this._updateQueries())}),this.entityManager.on("destroy",e=>{const t=this.getEntity(e);t&&(this.emit("entityCreated",{entity:t}),this._updateQueries(),this.componentManager.clearComponentSchema(e))}),this.componentManager.on("add",e=>{const t=this.getEntity(e.entityId);t&&(this.emit("componentAdded",{entity:t,component:e.component}),this._updateQueries())}),this.componentManager.on("remove",e=>{const t=this.getEntity(e.entityId);t&&(this.emit("componentRemoved",{entity:t,component:e.component}),this._updateQueries())}),this.queries=new Map}getEntity(e){if(this.entityManager.exist(e))return new m(this,e)}get entityIds(){return this.entityManager.entities}query(e){const t=a.getHash(e);let n=this.queries.get(t);return n||(n=new a(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=l;exports.EntityManager=u;exports.EventRegistry=o;exports.Query=a;exports.SparseSet=c;exports.SystemManager=d;exports.Time=g;exports.World=f;

package/dist/jael-build.js

@@ -1,66 +1,66 @@
 class h {
   _listeners = /* @__PURE__ */ new Map();
-  on(e, t) {
-    if (this.contains(e, t))
+  on(t, e) {
+    if (this.contains(t, e))
       return;
-    const s = this._listeners.get(e);
-    s ? s.add(t) : this._listeners.set(e, /* @__PURE__ */ new Set([t]));
+    const s = this._listeners.get(t);
+    s ? s.add(e) : this._listeners.set(t, /* @__PURE__ */ new Set([e]));
   }
-  off(e, t) {
-    if (!this.contains(e, t))
+  off(t, e) {
+    if (!this.contains(t, e))
       return;
-    const s = this._listeners.get(e);
-    s && s.delete(t);
+    const s = this._listeners.get(t);
+    s && s.delete(e);
   }
-  once(e, t) {
-    const s = ((i) => {
-      t(i), this.off(e, s);
+  once(t, e) {
+    const s = ((n) => {
+      e(n), this.off(t, s);
     });
-    this.on(e, s);
+    this.on(t, s);
   }
-  clearEvent(e) {
-    this._listeners.get(e) && this._listeners.get(e)?.clear();
+  clearEvent(t) {
+    this._listeners.get(t) && this._listeners.get(t)?.clear();
   }
   clearAllEvents() {
-    this._listeners.forEach((e) => e.clear()), this._listeners.clear();
+    this._listeners.forEach((t) => t.clear()), this._listeners.clear();
   }
-  contains(e, t) {
-    return this._listeners.get(e) ? this._listeners.get(e).has(t) : !1;
+  contains(t, e) {
+    return this._listeners.get(t) ? this._listeners.get(t).has(e) : !1;
   }
-  emit(e, t) {
-    this._listeners.get(e) && this._listeners.get(e)?.forEach((s) => {
-      s(t);
+  emit(t, e) {
+    this._listeners.get(t) && this._listeners.get(t)?.forEach((s) => {
+      s(e);
     });
   }
 }
-class c {
+class d {
   systemList = [];
-  addSystem(e) {
-    this.systemList.push(e), e.init?.(), this.reorder();
+  addSystem(t) {
+    this.systemList.push(t), t.init?.(), this.reorder();
   }
   reorder() {
-    this.systemList.sort((e, t) => e.priority - t.priority);
+    this.systemList.sort((t, e) => t.priority - e.priority);
   }
-  has(e) {
-    return this.systemList.indexOf(e) > 0;
+  has(t) {
+    return this.systemList.indexOf(t) > 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());
+  removeSystem(t) {
+    if (!this.has(t)) return;
+    const e = this.systemList.indexOf(t);
+    e >= 0 && (this.systemList.splice(e, 1), t.exit?.(), this.reorder());
   }
 }
-class d {
+class c {
   denseValues = [];
   sparse = /* @__PURE__ */ new Map();
   [Symbol.iterator]() {
-    let e = this.values.length;
-    const t = {
+    let t = this.values.length;
+    const e = {
       value: void 0,
       done: !1
     };
     return {
-      next: () => (t.value = this.values[--e], t.done = e < 0, t)
+      next: () => (e.value = this.values[--t], e.done = t < 0, e)
     };
   }
   get values() {
@@ -69,157 +69,193 @@ class d {
   first() {
     return this.denseValues[0];
   }
-  add(e) {
-    this.has(e) || (this.denseValues.push(e), this.sparse.set(e, this.denseValues.length - 1));
+  add(t) {
+    this.has(t) || (this.denseValues.push(t), this.sparse.set(t, this.denseValues.length - 1));
   }
-  indexOf(e) {
-    return this.sparse.get(e) ? this.sparse.get(e) : -1;
+  indexOf(t) {
+    const e = this.sparse.get(t);
+    return e !== void 0 ? e : -1;
   }
-  remove(e) {
-    if (!this.has(e)) return;
-    const t = this.sparse.get(e);
-    this.sparse.delete(e);
+  remove(t) {
+    if (!this.has(t)) return;
+    const e = this.sparse.get(t);
+    this.sparse.delete(t);
     const s = this.denseValues[this.denseValues.length - 1];
-    s !== e && (this.denseValues[t] = s, this.sparse.set(s, t)), this.denseValues.pop();
+    s !== t && (this.denseValues[e] = s, this.sparse.set(s, e)), this.denseValues.pop();
   }
-  forEach(e) {
-    for (let t of this)
-      e(t);
+  forEach(t) {
+    for (let e of this)
+      t(e);
   }
   size() {
     return this.denseValues.length;
   }
   clear() {
-    for (let e of this)
-      this.remove(e);
+    for (let t of this)
+      this.remove(t);
   }
-  has(e) {
-    return this.sparse.has(e);
+  has(t) {
+    return this.sparse.has(t);
   }
 }
 class u {
   id;
   _world;
-  constructor(e, t) {
-    this.id = t, this._world = e;
+  constructor(t, e) {
+    this.id = e, this._world = t;
   }
   /**
    * Add component to current entity.
    * @param compType Component name
    * @param compValue Component value
    */
-  add(e, t) {
-    this._world.addComponent(this, e, t);
+  add(t, e) {
+    this._world.addComponent(this.id, t, e);
   }
   /**
    * Remove component of current entity.
    * @param compType Component name
    */
-  remove(e) {
-    this._world.removeComponent(this, e);
+  remove(t) {
+    this._world.removeComponent(this.id, t);
   }
   /**
    * Check if current entity has a component.
    * @param compType Component name
    * @returns boolean
    */
-  has(e) {
-    return this._world.componentManager.hasComponent(this, e);
+  has(t) {
+    return this._world.componentManager.hasComponent(this.id, t);
   }
   /**
    * Get passed component schema of current entity.
    * @param compType Component name
    * @returns Return component schema with T(any as default) as type
    */
-  get(e) {
-    return this._world.componentManager.getComponent(this, e);
+  get(t) {
+    return this._world.componentManager.getComponent(this.id, t);
   }
 }
 class l extends h {
-  entityMap = new d();
+  entityMap = new c();
   nextId = 0;
   _world;
-  constructor(e) {
-    super(), this._world = e;
+  constructor(t) {
+    super(), this._world = t;
   }
   get entities() {
     return this.entityMap;
   }
   create() {
-    const e = this.nextId++, t = new u(this._world, e);
+    const t = this.nextId++;
     return this.entities.add(t), this.emit("create", t), t;
   }
-  exist(e) {
-    return this.entities.has(e);
+  exist(t) {
+    return this.entities.has(t);
   }
   size() {
     return this.entities.size();
   }
-  destroy(e) {
-    return this.entities.remove(e), this.emit("destroy", e), e;
+  destroy(t) {
+    return this.entities.remove(t), this.emit("destroy", t), t;
   }
 }
 class m extends h {
-  componentSet = /* @__PURE__ */ new Map();
+  componentSet = {};
   world;
-  constructor(e) {
-    super(), this.world = e;
+  constructor(t) {
+    super(), this.world = t;
   }
-  clearComponentSchema(e) {
-    this.componentSet.get(e.id) && this.componentSet.delete(e.id);
+  clearComponentSchema(t) {
+    this.componentSet[t] && delete this.componentSet[t];
   }
-  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 });
+  addComponent(t, e, s) {
+    const n = this.componentSet[t];
+    n ? n[e] = s : this.componentSet[t] = { [e]: s }, this.emit("add", { entityId: t, component: e });
   }
-  getComponent(e, t) {
-    return this.hasComponent(e, t) ? this.componentSet.get(e.id)[t] : void 0;
+  getComponent(t, e) {
+    if (this.hasComponent(t, e))
+      return this.componentSet[t][e];
   }
-  hasComponent(e, t) {
-    const s = this.componentSet.get(e.id);
-    return s ? t in s : !1;
+  hasComponent(t, e) {
+    const s = this.componentSet[t];
+    return s ? e 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 }));
+  removeComponent(t, e) {
+    if (!this.componentSet[t]) return;
+    const s = this.componentSet[t];
+    s && s[e] !== void 0 && (delete s[e], Object.keys(s).length === 0 && delete this.componentSet[t], this.emit("remove", { entityId: t, component: e }));
   }
 }
 class a extends h {
   config;
   entityMap;
+  entityInstancesCache;
   world;
-  constructor(e, t) {
-    super(), this.config = e, this.world = t, this.entityMap = new d();
+  constructor(t, e) {
+    super(), this.config = t, this.world = e, this.entityInstancesCache = /* @__PURE__ */ new Map(), this.entityMap = new c(), 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));
+  hasComponents(t) {
+    const e = this.world.componentManager;
+    return this.config.include?.every(
+      (s) => e.getComponent(t, s)
+    ) && this.config.exclude?.every(
+      (s) => !e.getComponent(t, s)
+    );
   }
-  get entities() {
+  size() {
+    return this.ids.size();
+  }
+  get hash() {
+    return a.getHash(this.config);
+  }
+  get ids() {
     return this.entityMap;
   }
-  include(...e) {
-    return this.world.include(...e);
+  getCachedEntity(t) {
+    const e = this.entityInstancesCache.get(t);
+    if (e)
+      return e;
+    {
+      const s = this.world.getEntity(t);
+      return s ? (this.entityInstancesCache.set(t, s), s) : void 0;
+    }
   }
-  exclude(...e) {
-    return this.world.exclude(...e);
+  get entities() {
+    const t = [], e = this.entityMap.size() > 100;
+    return this.entityMap.forEach((s) => {
+      if (e) {
+        const n = this.getCachedEntity(s);
+        n && t.push(n);
+      } else {
+        const n = this.world.getEntity(s);
+        n && t.push(n);
+      }
+    }), t;
+  }
+  include(...t) {
+    return this.world.include(...t);
+  }
+  exclude(...t) {
+    return this.world.exclude(...t);
   }
   _checkExistingEntities() {
-    for (let e of this.entities)
-      this.world.exist(e) || (this.emit("removed", e), this.entityMap.remove(e));
+    for (let t of this.ids)
+      this.world.exist(t) || (this.emit("removed", t), this.entityMap.remove(t));
   }
   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 t of this.world.entityIds)
+      this.hasComponents(t) && (this.entityMap.add(t), this.emit("added", t));
     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;
+  static getHash(t) {
+    const e = t.include?.map((i) => i.trim()).filter((i) => i).join("_"), s = t.exclude?.map((i) => i.trim()).filter((i) => i).join("_"), n = "in_" + e + "_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;
   }
 }
@@ -234,12 +270,12 @@ class p extends h {
     super();
   }
   _loop() {
-    let e = 0;
+    let t = 0;
     if (this.running) {
-      const t = performance.now();
-      e = (t - this._oldTime) / 1e3, this._oldTime = t, this.elapsed += e;
+      const e = performance.now();
+      t = (e - this._oldTime) / 1e3, this._oldTime = e, this.elapsed += t;
     }
-    this.delta = e, this.emit("update"), this._requestId = requestAnimationFrame(this._loop.bind(this));
+    this.delta = t, 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();
@@ -255,69 +291,80 @@ class f extends h {
   systemManager;
   queries;
   constructor() {
-    super(), this.entityManager = new l(this), this.componentManager = new m(this), this.systemManager = new c(), this.entityManager.on("create", (e) => {
+    super(), this.entityManager = new l(this), this.componentManager = new m(this), this.systemManager = new d(), this.entityManager.on("create", (t) => {
+      const e = this.getEntity(t);
       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.entityManager.on("destroy", (t) => {
+      const e = this.getEntity(t);
+      e && (this.emit("entityCreated", { entity: e }), this._updateQueries(), this.componentManager.clearComponentSchema(t));
     }), this.componentManager.on(
       "add",
-      (e) => {
-        this.emit("componentAdded", {
-          entity: e.entity,
-          component: e.component
-        }), this._updateQueries();
+      (t) => {
+        const e = this.getEntity(t.entityId);
+        e && (this.emit("componentAdded", {
+          entity: e,
+          component: t.component
+        }), this._updateQueries());
       }
     ), this.componentManager.on(
       "remove",
-      (e) => {
-        this.emit("componentRemoved", {
-          entity: e.entity,
-          component: e.component
-        }), this._updateQueries();
+      (t) => {
+        const e = this.getEntity(t.entityId);
+        e && (this.emit("componentRemoved", {
+          entity: e,
+          component: t.component
+        }), this._updateQueries());
       }
     ), this.queries = /* @__PURE__ */ new Map();
   }
-  get entities() {
+  getEntity(t) {
+    if (this.entityManager.exist(t))
+      return new u(this, t);
+  }
+  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;
+  query(t) {
+    const e = a.getHash(t);
+    let n = this.queries.get(e);
+    return n || (n = new a(t, this), this.queries.set(e, n), this._updateQueries()), n;
   }
   _updateQueries() {
-    this.queries.forEach((e) => e.checkEntities());
+    this.queries.forEach((t) => t.checkEntities());
   }
-  exist(e) {
-    return this.entityManager.exist(e);
+  exist(t) {
+    return this.entityManager.exist(t);
   }
-  include(...e) {
-    return this.query({ include: e, exclude: [] });
+  include(...t) {
+    return this.query({ include: t, exclude: [] });
   }
-  exclude(...e) {
-    return this.query({ include: [], exclude: e });
+  exclude(...t) {
+    return this.query({ include: [], exclude: t });
   }
   create() {
     return this.entityManager.create();
   }
-  destroy(e) {
-    this.entityManager.destroy(e);
+  destroy(t) {
+    this.entityManager.destroy(t);
+  }
+  addSystem(t) {
+    this.systemManager.addSystem(t);
   }
-  addSystem(e) {
-    this.systemManager.addSystem(e);
+  removeSystem(t) {
+    this.systemManager.removeSystem(t);
   }
-  removeSystem(e) {
-    this.systemManager.removeSystem(e);
+  addComponent(t, e, s) {
+    this.componentManager.addComponent(t, e, s);
   }
-  addComponent(e, t, s) {
-    this.componentManager.addComponent(e, t, s);
+  getComponent(t, e) {
+    return this.componentManager.getComponent(t, e);
   }
-  removeComponent(e, t) {
-    this.componentManager.removeComponent(e, t);
+  removeComponent(t, e) {
+    this.componentManager.removeComponent(t, e);
   }
   update() {
-    this.systemManager.systemList.forEach((e) => {
-      e.update();
+    this.systemManager.systemList.forEach((t) => {
+      t.update();
     }), this.emit("updated");
   }
 }
@@ -326,8 +373,8 @@ export {
   l as EntityManager,
   h as EventRegistry,
   a as Query,
-  d as SparseSet,
-  c as SystemManager,
+  c as SparseSet,
+  d 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.0",
   "description": "Entity Component System library with typescript",
   "keywords": [
     "ecs",