@jolly-pixel/engine 1.3.0 → 2.1.0

package/README.md

@@ -1,4 +1,4 @@
-<p align="center"><h1 align="center">
+<h1 align="center">
   engine
 </h1>
 
@@ -49,11 +49,11 @@ Systems are responsible for driving the game loop, orchestrating rendering, and
 resources such as assets. They operate on actors and their components
 each frame.
 
-- [GameInstance](./docs/systems/game-instance.md) — top-level orchestrator that ties the renderer, scene,
+- [World](./docs/systems/world.md) — top-level orchestrator that ties the renderer, scene,
   input, and audio into a unified game loop.
   - [Renderer](./docs/systems/renderer.md) — abstracts the Three.js render pipeline and supports
     direct and post-processing render strategies.
-  - [Scene](./docs/systems/scene.md) — the ECS world manager that owns the actor tree and drives
+  - [SceneManager](./docs/systems/scene-manager.md) — the ECS world manager that owns the actor tree and drives
     per-frame lifecycle (awake → start → update → destroy).
 - [Asset](./docs/asset.md) — lazy-loading asset pipeline with a
   registry of loaders, a queue, and a cache.
@@ -64,14 +64,14 @@ each frame.
 ```ts
 import { Systems, Actor } from "@jolly-pixel/engine";
 
-const scene = new Systems.SceneEngine();
+const sceneManager = new Systems.SceneManager();
 const renderer = new Systems.ThreeRenderer(canvas, {
-  scene,
+  sceneManager,
   renderMode: "direct"
 });
-const game = new Systems.GameInstance(renderer, {
+const game = new Systems.World(renderer, {
   enableOnExit: true,
-  scene
+  sceneManager
 });
 
 game.connect();
@@ -97,10 +97,10 @@ dictionary of Behaviors. The engine uses the name *Actor* (inspired by [Superpow
 <summary>Code Example</summary>
 
 ```ts
-const player = gameInstance.createActor("Player");
-player.transform.setLocalPosition(0, 1, 0);
+const player = world.createActor("Player");
+player.transform.setLocalPosition({ x: 0, y: 1, z: 0 });
 
-const child = gameInstance.createActor("Weapon", {
+const child = world.createActor("Weapon", {
   parent: player
 });
 
@@ -141,16 +141,16 @@ class PlayerBehavior extends Behavior {
   }
 
   update() {
-    if (this.actor.gameInstance.input.isKeyDown("ArrowUp")) {
+    if (this.actor.world.input.isKeyDown("ArrowUp")) {
       this.onMovement.emit();
       this.actor.transform.moveForward(this.speed);
     }
   }
 }
 
-new Actor(gameInstance, { name: "player" })
-  .registerComponent(ModelRenderer, { path: "models/Player.glb" })
-  .registerComponent(PlayerBehavior, { speed: 0.5 });
+new Actor(world, { name: "player" })
+  .addComponent(ModelRenderer, { path: "models/Player.glb" })
+  .addComponent(PlayerBehavior, { speed: 0.5 });
 ```
 
 </details>
@@ -174,7 +174,7 @@ query API so that behaviors can react to player actions without coupling to a sp
 ```ts
 import { InputCombination } from "@jolly-pixel/engine";
 
-const { input } = gameInstance;
+const { input } = world;
 
 if (input.isKeyDown("Space")) {
   console.log("jump!");
@@ -190,7 +190,7 @@ if (dashCombo.evaluate(input)) {
 ```
 
 > [!TIP]
-> In ActorComponent or Behavior input are accessible through this.actor.gameInstance.input
+> In ActorComponent or Behavior input are accessible through this.actor.world.input
 
 </details>
 
@@ -210,7 +210,7 @@ Manages sound playback across the engine. It provides a global volume controller
 ```ts
 import { GlobalAudioManager, AudioBackground } from "@jolly-pixel/engine";
 
-const audioManager = GlobalAudioManager.fromGameInstance(gameInstance);
+const audioManager = GlobalAudioManager.fromWorld(world);
 const bg = new AudioBackground({
   audioManager,
   autoPlay: true,
@@ -223,8 +223,8 @@ const bg = new AudioBackground({
   }]
 });
 
-gameInstance.audio.observe(bg);
-gameInstance.audio.volume = 0.5;
+world.audio.observe(bg);
+world.audio.volume = 0.5;
 ```
 
 </details>

package/dist/actor/Actor.d.ts

@@ -1,40 +1,51 @@
 import * as THREE from "three";
-import { type GameInstance } from "../systems/GameInstance.ts";
-import type { ActorComponent } from "./ActorComponent.ts";
 import { ActorTree } from "./ActorTree.ts";
 import { Transform } from "./Transform.ts";
+import { IntegerIncrement } from "../systems/generators/IntegerIncrement.ts";
+import { PersistentIdIncrement } from "../systems/generators/PersistentIdIncrement.ts";
+import type { World, WorldDefaultContext } from "../systems/World.ts";
 import type { Behavior } from "../components/script/Behavior.ts";
 import type { Component } from "../components/types.ts";
 type ComponentConstructor = new (actor: Actor<any>, ...args: any[]) => Component;
 type RequiresOptions<T extends ComponentConstructor> = T extends new (actor: Actor<any>, options: infer O, ...args: any[]) => any ? undefined extends O ? false : true : false;
-export interface ActorOptions<TContext = Record<string, unknown>> {
+export interface ActorOptions<TContext = WorldDefaultContext> {
     name: string;
     parent?: Actor<TContext> | null;
     visible?: boolean;
     layer?: number | number[];
 }
-export declare class Actor<TContext = Record<string, unknown>> extends ActorTree<TContext> {
-    gameInstance: GameInstance<any, TContext>;
+export declare class Actor<TContext = WorldDefaultContext> extends ActorTree<TContext> {
+    #private;
+    static Id: IntegerIncrement;
+    static PersistentId: PersistentIdIncrement;
+    world: World<any, TContext>;
+    id: number;
+    persistentId: string;
     name: string;
-    awoken: boolean;
     parent: Actor<TContext> | null;
     components: Component[];
+    componentsRequiringUpdate: Component[];
     behaviors: Record<string, Behavior<any, TContext>[]>;
-    transform: Transform;
+    awoken: boolean;
     pendingForDestruction: boolean;
-    threeObject: THREE.Group<THREE.Object3DEventMap>;
-    constructor(gameInstance: GameInstance<any, any>, options: ActorOptions<TContext>);
-    registerComponent<T extends ComponentConstructor>(componentClass: T, ...args: RequiresOptions<T> extends true ? [options: ConstructorParameters<T>[1], callback?: (component: InstanceType<T>) => void] : [options?: ConstructorParameters<T>[1], callback?: (component: InstanceType<T>) => void]): this;
-    registerComponentAndGet<T extends ComponentConstructor>(componentClass: T, ...args: RequiresOptions<T> extends true ? [options: ConstructorParameters<T>[1]] : [options?: ConstructorParameters<T>[1]]): InstanceType<T>;
-    getComponentByName<T extends ActorComponent<TContext>>(actor: Actor<TContext>, componentName: string): T;
+    object3D: THREE.Group<THREE.Object3DEventMap>;
+    transform: Transform;
+    constructor(world: World<any, TContext>, options: ActorOptions<TContext>);
+    addComponent<T extends ComponentConstructor>(componentClass: T, ...args: RequiresOptions<T> extends true ? [options: ConstructorParameters<T>[1], callback?: (component: InstanceType<T>) => void] : [options?: ConstructorParameters<T>[1], callback?: (component: InstanceType<T>) => void]): this;
+    addComponentAndGet<T extends ComponentConstructor>(componentClass: T, ...args: RequiresOptions<T> extends true ? [options: ConstructorParameters<T>[1]] : [options?: ConstructorParameters<T>[1]]): InstanceType<T>;
+    getComponent(typeName: string): Component | null;
+    getComponent<T>(componentClass: new (...args: any[]) => T): T | null;
+    getComponents<T extends Component>(componentClass: new (...args: any[]) => T): IterableIterator<T>;
+    addChildren(...objects: THREE.Object3D[]): this;
+    removeChildren(...objects: THREE.Object3D[]): this;
     awake(): void;
     update(deltaTime: number): void;
+    fixedUpdate(deltaTime: number): void;
+    toString(): string;
     isDestroyed(): boolean;
     destroy(): void;
+    static disposeObject3D(object: THREE.Object3D): void;
     markDestructionPending(): void;
-    addBehavior<T extends new (...args: any) => Behavior<any, TContext>>(behaviorClass: T, properties?: ConstructorParameters<T>[0]): Behavior<any, TContext>;
-    getBehavior<T extends new (...args: any) => any>(behaviorClass: T): InstanceType<T> | null;
-    getBehaviors<T extends new (...args: any) => any>(behaviorClass: T): IterableIterator<InstanceType<T>>;
     setParent(newParent: Actor<TContext>, keepLocal?: boolean): void;
 }
 export {};

package/dist/actor/Actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Actor.d.ts","sourceRoot":"","sources":["../../src/actor/Actor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Actor.d.ts","sourceRoot":"","sources":["../../src/actor/Actor.ts"],"names":[],"mappings":"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"}

package/dist/actor/Actor.js

@@ -1,137 +1,167 @@
 // Import Third-party Dependencies
 import * as THREE from "three";
 // Import Internal Dependencies
-import {} from "../systems/GameInstance.js";
 import { ActorTree } from "./ActorTree.js";
 import { Transform } from "./Transform.js";
+import { IntegerIncrement } from "../systems/generators/IntegerIncrement.js";
+import { PersistentIdIncrement } from "../systems/generators/PersistentIdIncrement.js";
+function isPendingForDestruction(component) {
+    return "pendingForDestruction" in component && component.pendingForDestruction === true;
+}
 export class Actor extends ActorTree {
-    gameInstance;
+    static Id = new IntegerIncrement();
+    static PersistentId = new PersistentIdIncrement();
+    world;
+    id = Actor.Id.incr();
+    persistentId = Actor.PersistentId.next();
     name;
-    awoken = false;
     parent = null;
     components = [];
+    componentsRequiringUpdate = [];
     behaviors = {};
-    transform;
+    awoken = false;
     pendingForDestruction = false;
-    threeObject = new THREE.Group();
-    constructor(gameInstance, options) {
+    object3D = new THREE.Group();
+    transform;
+    constructor(world, options) {
         super();
         const { name, parent = null, visible = true, layer } = options;
-        if (parent !== null && parent.pendingForDestruction) {
+        if (parent !== null &&
+            parent.pendingForDestruction) {
             throw new Error("Cannot add actor to a parent that is pending for destruction.");
         }
-        this.gameInstance = gameInstance;
+        this.world = world;
         this.name = name;
         this.parent = parent;
-        this.threeObject.visible = visible;
-        this.threeObject.name = this.name;
-        this.threeObject.userData.isActor = true;
+        this.object3D.visible = visible;
+        this.object3D.name = this.name;
+        this.object3D.userData.isActor = true;
         if (layer) {
             const layers = Array.isArray(layer) ? layer : [layer];
             for (const layer of layers) {
-                this.threeObject.layers.enable(layer);
-                this.gameInstance.scene.getSource().layers.enable(layer);
+                this.object3D.layers.enable(layer);
+                this.world.sceneManager.getSource().layers.enable(layer);
             }
         }
-        this.transform = new Transform(this.threeObject);
+        this.transform = new Transform(this.object3D);
         if (parent) {
             parent.add(this);
-            parent.threeObject.add(this.threeObject);
-            this.threeObject.updateMatrixWorld(false);
+            parent.object3D.add(this.object3D);
+            this.object3D.updateMatrixWorld(false);
         }
         else {
-            this.gameInstance.scene.tree.add(this);
+            this.world.sceneManager.tree.add(this);
         }
+        this.world.sceneManager.registerActor(this);
     }
-    registerComponent(componentClass, ...args) {
-        const [options, callback] = args;
-        const component = new componentClass(this, options);
-        callback?.(component);
+    #initializeComponent(component) {
         if (this.awoken) {
             component.awake?.();
         }
+        if (("update" in component && typeof component.update === "function") ||
+            ("fixedUpdate" in component && typeof component.fixedUpdate === "function")) {
+            component.needUpdate = true;
+        }
+    }
+    addComponent(componentClass, ...args) {
+        const [options, callback] = args;
+        const component = new componentClass(this, options);
+        callback?.(component);
+        this.#initializeComponent(component);
         return this;
     }
-    registerComponentAndGet(componentClass, ...args) {
+    addComponentAndGet(componentClass, ...args) {
         const [options] = args;
         const component = new componentClass(this, options);
-        if (this.awoken) {
-            component.awake?.();
-        }
+        this.#initializeComponent(component);
         return component;
     }
-    getComponentByName(actor, componentName) {
-        const component = actor.components.find((comp) => comp.typeName === componentName);
-        if (!component) {
-            throw new Error(`Component with typeName "${componentName}" not found on actor "${actor.name}"`);
+    getComponent(typeNameOrClass) {
+        if (typeof typeNameOrClass === "string") {
+            for (const comp of this.components) {
+                if (comp.typeName === typeNameOrClass && !isPendingForDestruction(comp)) {
+                    return comp;
+                }
+            }
+            return null;
+        }
+        for (const comp of this.components) {
+            if (comp instanceof typeNameOrClass && !isPendingForDestruction(comp)) {
+                return comp;
+            }
+        }
+        return null;
+    }
+    *getComponents(componentClass) {
+        for (const comp of this.components) {
+            if (comp instanceof componentClass && !isPendingForDestruction(comp)) {
+                yield comp;
+            }
         }
-        return component;
+    }
+    addChildren(...objects) {
+        this.object3D.add(...objects);
+        return this;
+    }
+    removeChildren(...objects) {
+        for (const object of objects) {
+            this.object3D.remove(object);
+            Actor.disposeObject3D(object);
+        }
+        return this;
     }
     awake() {
         this.components.forEach((component) => component.awake?.());
     }
     update(deltaTime) {
         if (!this.pendingForDestruction) {
-            this.components.forEach((component) => component.update?.(deltaTime));
+            this.componentsRequiringUpdate.forEach((component) => component.update?.(deltaTime));
+        }
+    }
+    fixedUpdate(deltaTime) {
+        if (!this.pendingForDestruction) {
+            this.componentsRequiringUpdate.forEach((component) => component.fixedUpdate?.(deltaTime));
         }
     }
+    toString() {
+        return `${this.name}:${this.id}-${this.persistentId}`;
+    }
     isDestroyed() {
         return this.pendingForDestruction;
     }
     destroy() {
+        this.world.sceneManager.unregisterActor(this);
         for (let i = this.components.length - 1; i >= 0; i--) {
             this.components[i].destroy?.();
         }
         if (this.parent === null) {
-            this.gameInstance.scene.tree.remove(this);
+            this.world.sceneManager.tree.remove(this);
         }
         else {
-            this.parent.threeObject.remove(this.threeObject);
+            this.parent.object3D.remove(this.object3D);
             this.parent.remove(this);
         }
-        this.threeObject.clear();
-    }
-    markDestructionPending() {
-        this.pendingForDestruction = true;
-        this.destroyAllActors();
+        this.object3D.traverse((child) => Actor.disposeObject3D(child));
+        this.object3D.clear();
     }
-    addBehavior(behaviorClass, properties = Object.create(null)) {
-        const behavior = new behaviorClass(this);
-        for (const [propertyName, value] of Object.entries(properties)) {
-            behavior.setProperty(propertyName, value);
-        }
-        if (this.awoken) {
-            // @ts-ignore
-            behavior.awake?.();
-        }
-        return behavior;
-    }
-    getBehavior(behaviorClass) {
-        for (const behaviorName in this.behaviors) {
-            if (!Object.hasOwn(this.behaviors, behaviorName)) {
-                continue;
-            }
-            for (const behavior of this.behaviors[behaviorName]) {
-                if (behavior instanceof behaviorClass &&
-                    !behavior.isDestroyed()) {
-                    return behavior;
+    static disposeObject3D(object) {
+        if ("geometry" in object && object.geometry instanceof THREE.BufferGeometry) {
+            object.geometry.dispose();
+        }
+        if ("material" in object) {
+            const materials = Array.isArray(object.material)
+                ? object.material
+                : [object.material];
+            for (const material of materials) {
+                if (material instanceof THREE.Material) {
+                    material.dispose();
                 }
             }
         }
-        return null;
     }
-    *getBehaviors(behaviorClass) {
-        for (const behaviorName in this.behaviors) {
-            if (!Object.hasOwn(this.behaviors, behaviorName)) {
-                continue;
-            }
-            for (const behavior of this.behaviors[behaviorName]) {
-                if (behavior instanceof behaviorClass &&
-                    !behavior.isDestroyed()) {
-                    yield behavior;
-                }
-            }
-        }
+    markDestructionPending() {
+        this.pendingForDestruction = true;
+        this.destroyAllActors();
     }
     setParent(newParent, keepLocal = false) {
         if (this.pendingForDestruction) {
@@ -143,20 +173,20 @@ export class Actor extends ActorTree {
         if (!keepLocal) {
             this.transform.getGlobalMatrix(Transform.Matrix);
         }
-        const oldSiblings = (this.parent === null) ? this.gameInstance.scene.tree : this.parent;
+        const oldSiblings = (this.parent === null) ? this.world.sceneManager.tree : this.parent;
         oldSiblings.remove(this);
-        this.threeObject.parent?.remove(this.threeObject);
+        this.object3D.parent?.remove(this.object3D);
         this.parent = newParent;
         const siblings = (newParent === null) ?
-            this.gameInstance.scene.tree :
+            this.world.sceneManager.tree :
             newParent;
         siblings.add(this);
         const threeParent = (newParent === null) ?
-            this.gameInstance.scene.getSource() :
-            newParent.threeObject;
-        threeParent.add(this.threeObject);
+            this.world.sceneManager.getSource() :
+            newParent.object3D;
+        threeParent.add(this.object3D);
         if (keepLocal) {
-            this.threeObject.updateMatrixWorld(false);
+            this.object3D.updateMatrixWorld(false);
         }
         else {
             this.transform.setGlobalMatrix(Transform.Matrix);

package/dist/actor/Actor.js.map

@@ -1 +1 @@
-{"version":3,"file":"Actor.js","sourceRoot":"","sources":["../../src/actor/Actor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Actor.js","sourceRoot":"","sources":["../../src/actor/Actor.ts"],"names":[],"mappings":"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"}

package/dist/actor/ActorComponent.d.ts

@@ -1,23 +1,30 @@
 import { EventEmitter } from "@posva/event-emitter";
 import { Actor } from "./Actor.ts";
+import { IntegerIncrement } from "../systems/generators/IntegerIncrement.ts";
+import { PersistentIdIncrement } from "../systems/generators/PersistentIdIncrement.ts";
+import type { WorldDefaultContext } from "../systems/World.ts";
 import type { Component, FreeComponentEnum } from "../components/types.ts";
-export interface ActorComponentOptions<TContext = Record<string, unknown>> {
+export interface ActorComponentOptions<TContext = WorldDefaultContext> {
     actor: Actor<TContext>;
     typeName: FreeComponentEnum;
 }
 export type ActorComponentEvents = {
     metadataInitialized: [];
 };
-export declare class ActorComponent<TContext = Record<string, unknown>> extends EventEmitter<ActorComponentEvents> implements Component {
+export declare class ActorComponent<TContext = WorldDefaultContext> extends EventEmitter<ActorComponentEvents> implements Component {
     #private;
-    protected static Id: number;
-    static generateNextId(): number;
-    static clearId(): void;
+    static Id: IntegerIncrement;
+    static PersistentId: PersistentIdIncrement;
     id: number;
+    persistentId: string;
     actor: Actor<TContext>;
     typeName: FreeComponentEnum;
     pendingForDestruction: boolean;
     constructor(options: ActorComponentOptions<TContext>);
+    get needUpdate(): boolean;
+    set needUpdate(value: boolean);
+    get context(): TContext;
+    toString(): string;
     isDestroyed(): boolean;
     destroy(): void;
 }

package/dist/actor/ActorComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActorComponent.d.ts","sourceRoot":"","sources":["../../src/actor/ActorComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,qBAAqB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,mBAAmB,EAAE,EAAE,CAAC;CACzB,CAAC;AAEF,qBAAa,cAAc,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,YAAY,CAAC,oBAAoB,CAAE,YAAW,SAAS;;IAC7H,SAAS,CAAC,MAAM,CAAC,EAAE,SAAK;IAExB,MAAM,CAAC,cAAc;IAIrB,MAAM,CAAC,OAAO;IAId,EAAE,SAAmC;IACrC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,qBAAqB,UAAS;gBAG5B,OAAO,EAAE,qBAAqB,CAAC,QAAQ,CAAC;IA0B1C,WAAW;IAIX,OAAO;CAWR"}
+{"version":3,"file":"ActorComponent.d.ts","sourceRoot":"","sources":["../../src/actor/ActorComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,KAAK,EACV,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,qBAAqB,CACpC,QAAQ,GAAG,mBAAmB;IAE9B,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,mBAAmB,EAAE,EAAE,CAAC;CACzB,CAAC;AAEF,qBAAa,cAAc,CACzB,QAAQ,GAAG,mBAAmB,CAC9B,SAAQ,YAAY,CAAC,oBAAoB,CAAE,YAAW,SAAS;;IAC/D,MAAM,CAAC,EAAE,mBAA0B;IACnC,MAAM,CAAC,YAAY,wBAA+B;IAElD,EAAE,SAA4B;IAC9B,YAAY,SAAsC;IAClD,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;IAG5B,qBAAqB,UAAS;gBAG5B,OAAO,EAAE,qBAAqB,CAAC,QAAQ,CAAC;IAc1C,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,OAAO,EAc5B;IAED,IAAI,OAAO,IAAI,QAAQ,CAEtB;IAcQ,QAAQ,IAAI,MAAM;IAI3B,WAAW;IAIX,OAAO;CAaR"}

package/dist/actor/ActorComponent.js

@@ -3,28 +3,47 @@ import { EventEmitter } from "@posva/event-emitter";
 // Import Internal Dependencies
 import { Actor } from "./Actor.js";
 import { getSignalMetadata, SignalEvent } from "./Signal.js";
+import { IntegerIncrement } from "../systems/generators/IntegerIncrement.js";
+import { PersistentIdIncrement } from "../systems/generators/PersistentIdIncrement.js";
 export class ActorComponent extends EventEmitter {
-    static Id = 0;
-    static generateNextId() {
-        return this.Id++;
-    }
-    static clearId() {
-        this.Id = 0;
-    }
-    id = ActorComponent.generateNextId();
+    static Id = new IntegerIncrement();
+    static PersistentId = new PersistentIdIncrement();
+    id = ActorComponent.Id.incr();
+    persistentId = ActorComponent.PersistentId.next();
     actor;
     typeName;
+    #needUpdate = false;
     pendingForDestruction = false;
     constructor(options) {
         super();
         this.actor = options.actor;
         this.typeName = options.typeName;
         this.actor.components.push(this);
-        this.actor.gameInstance.scene.componentsToBeStarted.push(this);
+        this.actor.world.sceneManager.componentsToBeStarted.push(this);
         // Defer the initialization of signal decorators to ensure
         // that the component instance is fully constructed
         queueMicrotask(() => this.#initSignalDecorators());
     }
+    get needUpdate() {
+        return this.#needUpdate;
+    }
+    set needUpdate(value) {
+        this.#needUpdate = value;
+        if (this.#needUpdate) {
+            if (!this.actor.componentsRequiringUpdate.includes(this)) {
+                this.actor.componentsRequiringUpdate.push(this);
+            }
+        }
+        else {
+            const index = this.actor.componentsRequiringUpdate.indexOf(this);
+            if (index !== -1) {
+                this.actor.componentsRequiringUpdate.splice(index, 1);
+            }
+        }
+    }
+    get context() {
+        return this.actor.world.context;
+    }
     #initSignalDecorators() {
         const proto = Object.getPrototypeOf(this);
         const metadata = getSignalMetadata(proto);
@@ -35,13 +54,17 @@ export class ActorComponent extends EventEmitter {
         }
         this.emit("metadataInitialized");
     }
+    toString() {
+        return `${this.typeName}:${this.id}-${this.persistentId}`;
+    }
     isDestroyed() {
         return this.pendingForDestruction;
     }
     destroy() {
-        const startIndex = this.actor.gameInstance.scene.componentsToBeStarted.indexOf(this);
+        this.needUpdate = false;
+        const startIndex = this.actor.world.sceneManager.componentsToBeStarted.indexOf(this);
         if (startIndex !== -1) {
-            this.actor.gameInstance.scene.componentsToBeStarted.splice(startIndex, 1);
+            this.actor.world.sceneManager.componentsToBeStarted.splice(startIndex, 1);
         }
         const index = this.actor.components.indexOf(this);
         if (index !== -1) {