dino-ge 1.3.2 → 1.3.7

package/src/Engine.ts

@@ -1,467 +0,0 @@
-import Canvas from './Canvas.js';
-import GameObject from './GameObject.js';
-import Input from './Input.js';
-import Scene from './Scene.js';
-import Camera from './Camera.js';
-import System from './System.js';
-import PhysicsSystem from './PhysicsSystem.js';
-import RenderingSystem from './RenderingSystem.js';
-import PhysicsComponent from './PhysicsComponent.js';
-import TagComponent from './TagComponent.js';
-
-/**
- * Options for initializing the Engine.
- */
-export interface EngineOpts {
-  /** Width of the game window (e.g., '800px' or '100%'). */
-  width: string;
-  /** Height of the game window (e.g., '600px' or '100%'). */
-  height: string;
-  /** Title of the game, set in the document head. */
-  title: string;
-  /** Background colour of the canvas. */
-  backgroundColour: string;
-}
-
-/**
- * Lifecycle and update callbacks for the engine.
- */
-export interface EngineCallbacks {
-  /** Called once after the engine is initialized. */
-  onLoad: () => void;
-  /** Called every frame for game logic and rendering. */
-  update: () => void;
-  /** Optional callback for physics or fixed-step logic. */
-  fixedUpdate?: () => void;
-}
-
-/**
- * Specialized Set for managing game objects with helper methods.
- */
-export class ObjectSet extends Set<GameObject> {
-  /**
-   * Find all objects with a specific tag.
-   * @param tag The tag to search for.
-   */
-  findAll: (tag: string) => GameObject[] = () => [];
-}
-
-/**
- * Interface for the shared global state of the Engine.
- */
-interface EngineState {
-  objects: ObjectSet;
-  paused: boolean;
-  debug: boolean;
-  selectedObject: GameObject | null;
-  camera: Camera;
-  systems: System[];
-  renderingSystem?: RenderingSystem;
-  events: EventTarget;
-}
-
-/**
- * Shared state for the engine to ensure singletons work across different module loads.
- */
-const _globalState: EngineState = (globalThis as unknown as { __DINO_ENGINE_STATE__: EngineState; }).__DINO_ENGINE_STATE__ || {
-  objects: new ObjectSet(),
-  paused: false,
-  debug: false,
-  selectedObject: null,
-  camera: new Camera(),
-  systems: [new PhysicsSystem()],
-  events: new EventTarget()
-};
-(globalThis as unknown as { __DINO_ENGINE_STATE__: EngineState; }).__DINO_ENGINE_STATE__ = _globalState;
-
-/**
- * The core singleton class that manages the game loop, rendering, and scene state.
- */
-export default class Engine {
-  /**
-   * Global set of game objects if no scene is active.
-   */
-  public static get objects(): ObjectSet { return _globalState.objects; }
-
-  /**
-   * Global list of systems that process game objects.
-   */
-  private static get _systems(): System[] { return _globalState.systems; }
-
-  /**
-   * The global rendering system.
-   */
-  public static get renderingSystem(): RenderingSystem | undefined { return _globalState.renderingSystem; }
-  public static set renderingSystem(val: RenderingSystem | undefined) { _globalState.renderingSystem = val; }
-
-  /**
-   * Whether the game loop is currently paused.
-   */
-  public static get paused(): boolean { return _globalState.paused; }
-  public static set paused(val: boolean) {
-    if (_globalState.paused !== val) {
-      _globalState.paused = val;
-      this.emit('paused', val);
-    }
-  }
-
-  /**
-   * Toggle for visual debug mode (hitboxes and stats).
-   */
-  public static get debug(): boolean { return _globalState.debug; }
-  public static set debug(val: boolean) {
-    if (_globalState.debug !== val) {
-      _globalState.debug = val;
-      this.emit('debug', val);
-    }
-  }
-
-  /**
-   * Internal event bus for engine events.
-   */
-  private static get events(): EventTarget { return _globalState.events; }
-
-  /**
-   * Listens for an event on the global engine bus.
-   * @param type The event type (e.g., 'paused', 'PLAYER_DIED').
-   * @param callback The function to run when the event occurs.
-   */
-  public static on(type: string, callback: (event: CustomEvent) => void) {
-    this.events.addEventListener(type, callback as (e: Event) => void);
-  }
-
-  /**
-   * Stops listening for an event on the global engine bus.
-   * @param type The event type.
-   * @param callback The function to remove.
-   */
-  public static off(type: string, callback: (event: CustomEvent) => void) {
-    this.events.removeEventListener(type, callback as (e: Event) => void);
-  }
-
-  /**
-   * Emits a custom event on the global engine bus.
-   * @param type The event type.
-   * @param detail Optional data to pass with the event.
-   */
-  public static emit(type: string, detail?: unknown) {
-    this.events.dispatchEvent(new CustomEvent(type, { detail }));
-  }
-
-  /**
-   * The currently selected object in debug mode.
-   */
-  public static get selectedObject(): GameObject | null { return _globalState.selectedObject; }
-  public static set selectedObject(val: GameObject | null) { _globalState.selectedObject = val; }
-
-  /**
-   * The global camera instance.
-   */
-  public static get camera(): Camera { return _globalState.camera; }
-
-  private static _currentScene: Scene;
-
-  /**
-   * Gets the currently active scene.
-   */
-  public static get currentScene(): Scene {
-    return this._currentScene;
-  }
-
-  /**
-   * Sets the active scene, resetting the camera and calling the scene's onLoad.
-   */
-  public static set currentScene(scene: Scene) {
-    this._currentScene = scene;
-    this.camera.reset();
-    scene.onLoad();
-  }
-
-  #canvas: Canvas;
-  #ctx!: CanvasRenderingContext2D;
-  #window: HTMLDivElement;
-  #title: HTMLTitleElement;
-
-  /** Current background colour. */
-  backgroundColour: string;
-  /** Registered engine callbacks. */
-  callbacks: EngineCallbacks;
-
-  /** Pixel width of the canvas. */
-  width: number;
-  /** Pixel height of the canvas. */
-  height: number;
-
-  /** Current mouse x position in world space. */
-  get mouseX() {
-    return Input.mouseX;
-  }
-
-  /** Current mouse y position in world space. */
-  get mouseY() {
-    return Input.mouseY;
-  }
-
-  /** Current frames per second. */
-  fps: number = 0;
-  #oldTimestamp: number = 0;
-  #secondsPassed: number = 0;
-  #accumulator: number = 0;
-  #fixedDelta: number = 1 / 60;
-
-  constructor(callbacks: EngineCallbacks, opts: Partial<EngineOpts> = {}) {
-    const defaultedOpts = {
-      width: '100%',
-      height: '100%',
-      title: 'Example',
-      backgroundColour: 'white',
-      ...opts,
-    };
-
-
-    Engine.objects.findAll = this.#findAllObjects.bind(this);
-
-    this.#title = document.createElement('title');
-    this.#title.innerHTML = defaultedOpts.title;
-    document.getElementsByTagName('head')[0].appendChild(this.#title);
-
-    this.backgroundColour = defaultedOpts.backgroundColour;
-
-    this.callbacks = {
-      onLoad: () => {
-        callbacks.onLoad();
-        this.#onLoad();
-      },
-      update: callbacks.update,
-    };
-
-    this.#canvas = new Canvas();
-    this.#ctx = this.#canvas.canvas.getContext('2d')!;
-    this.width = this.#canvas.canvas.width;
-    this.height = this.#canvas.canvas.height;
-
-    if (Engine.renderingSystem) {
-      Engine.renderingSystem.setContext(this.#ctx);
-    } else {
-      Engine.renderingSystem = new RenderingSystem(this.#ctx);
-    }
-
-    this.#window = document.createElement('div');
-    this.#window.id = 'canvas-container';
-    this.#window.style.width = defaultedOpts.width;
-    this.#window.style.height = defaultedOpts.height;
-
-    Input.init();
-
-    window.addEventListener('resize', () => {
-      this.#canvas.resize();
-      this.width = this.#canvas.canvas.width;
-      this.height = this.#canvas.canvas.height;
-    });
-
-    document.getElementsByTagName('body')[0].appendChild(this.#window);
-    this.#window.appendChild(this.#canvas.canvas);
-
-    setTimeout(() => this.callbacks.onLoad(), 0);
-  }
-
-  #onLoad() {
-    this.#draw();
-
-    window.requestAnimationFrame(this.#update.bind(this));
-  }
-
-  #update(timestamp: number) {
-    if (!Engine.paused) {
-      this.#secondsPassed = (timestamp - this.#oldTimestamp) / 1000;
-      this.#oldTimestamp = timestamp;
-
-      this.fps = Math.round(1 / this.#secondsPassed);
-
-      // Fixed update loop
-      this.#accumulator += this.#secondsPassed;
-      while (this.#accumulator >= this.#fixedDelta) {
-        this.#fixedUpdate();
-        this.#accumulator -= this.#fixedDelta;
-      }
-
-      if (Engine.currentScene) {
-        Engine.currentScene.update();
-      }
-
-      this.callbacks.update();
-      this.#draw();
-    } else {
-      // Still allow drawing in paused mode if debug is on or for initial frame
-      this.#draw();
-    }
-
-    window.requestAnimationFrame(this.#update.bind(this));
-  }
-
-  #fixedUpdate() {
-    const objects = Engine.currentScene ? Engine.currentScene.objects : Engine.objects;
-
-    Engine._systems.forEach((system) => {
-      if (system.fixedUpdate) {
-        system.fixedUpdate(objects, this.#fixedDelta);
-      }
-    });
-
-    if (this.callbacks.fixedUpdate) {
-      this.callbacks.fixedUpdate();
-    }
-  }
-
-  #setBackground() {
-    this.#ctx.fillStyle = this.backgroundColour;
-    this.#ctx.fillRect(0, 0, this.#canvas.canvas.width, this.#canvas.canvas.height);
-  }
-
-  #draw() {
-    this.#setBackground();
-
-    const objects = Engine.currentScene ? Engine.currentScene.objects : Engine.objects;
-
-    if (Engine.renderingSystem) {
-      Engine.renderingSystem.update(objects, 0, Engine.debug);
-    }
-
-    if (Engine.debug) {
-      this.#drawDebug(objects);
-    }
-  }
-  #drawDebug(objects: Set<GameObject>) {
-    // Draw Stats Overlay (Top Right)
-    this.#ctx.save();
-    this.#ctx.setTransform(1, 0, 0, 1, 0, 0); // Reset transform for UI
-
-    const overlayWidth = 180;
-    const statsHeight = 80;
-    const padding = 10;
-    const x = this.#canvas.canvas.width - overlayWidth - padding;
-    let y = padding;
-
-    // Background for Stats
-    this.#ctx.fillStyle = 'rgba(0, 0, 0, 0.7)';
-    this.#ctx.fillRect(x, y, overlayWidth, statsHeight);
-
-    this.#ctx.fillStyle = 'white';
-    this.#ctx.textAlign = 'left';
-    this.#ctx.textBaseline = 'top';
-
-    this.#ctx.fillText(`FPS: ${this.fps}`, x + 10, y + 10);
-    this.#ctx.fillText(`Objects: ${objects.size}`, x + 10, y + 25);
-    this.#ctx.fillText(`Mouse X: ${Math.round(this.mouseX)}`, x + 10, y + 45);
-    this.#ctx.fillText(`Mouse Y: ${Math.round(this.mouseY)}`, x + 10, y + 60);
-
-    // Inspector Panel (If object selected)
-    if (Engine.selectedObject) {
-      y += statsHeight + 10;
-      const obj = Engine.selectedObject;
-      const properties: [string, string | number][] = [
-        ['Pos', `${Math.round(obj.position.x)}, ${Math.round(obj.position.y)}`],
-        ['Size', `${Math.round(obj.width)}x${Math.round(obj.height)}`]
-      ];
-
-      const tagComp = obj.getComponent(TagComponent);
-      if (tagComp) {
-        properties.unshift(['Tag', tagComp.tag]);
-        properties.push(['Z-Index', tagComp.zIndex]);
-      }
-
-      const physComp = obj.getComponent(PhysicsComponent);
-      if (physComp) {
-        properties.push(['Vel', `${Math.round(physComp.velocity.x)}, ${Math.round(physComp.velocity.y)}`]);
-        properties.push(['Acc', `${Math.round(physComp.acceleration.x)}, ${Math.round(physComp.acceleration.y)}`]);
-      }
-
-      const inspectorHeight = 20 + (properties.length * 15);
-      this.#ctx.fillStyle = 'rgba(0, 0, 0, 0.7)';
-      this.#ctx.fillRect(x, y, overlayWidth, inspectorHeight);
-      this.#ctx.strokeStyle = '#00ff00';
-      this.#ctx.strokeRect(x, y, overlayWidth, inspectorHeight);
-
-      this.#ctx.fillStyle = '#00ff00';
-      this.#ctx.fillText('INSPECTOR', x + 10, y + 5);
-
-      this.#ctx.fillStyle = 'white';
-      properties.forEach(([key, val], i) => {
-        this.#ctx.fillText(`${key}: ${val}`, x + 10, y + 20 + (i * 15));
-      });
-    }
-
-    this.#ctx.restore();
-  }
-
-  #findAllObjects(tag: string = '') {
-    return Array.from(Engine.objects).filter((obj) => obj.tag === tag);
-  }
-
-  /**
-   * Promisified setTimeout.
-   * @param timeoutFn The function to run after the timeout.
-   * @param time The time in milliseconds to wait.
-   */
-  async setTimeout(timeoutFn: () => void, time: number) {
-    await new Promise((resolve) => {
-      setTimeout(resolve, time);
-    });
-    timeoutFn();
-  }
-
-  /**
-   * Run a function repeatedly for a duration and then run a final function.
-   * @param milliseconds Total duration.
-   * @param fn Function to run every second.
-   * @param onEnded Final function to run.
-   */
-  countdown(milliseconds: number, fn: () => void, onEnded: () => void) {
-    setTimeout(onEnded, milliseconds);
-
-    for (let i = 1; i <= milliseconds; i += 1) {
-      if (i % 1000 === 0) {
-        setTimeout(fn, i);
-      }
-    }
-  }
-
-  /** Sets the CSS cursor style for the game canvas. */
-  set cursor(value: string) {
-    const canvas = document.getElementById('canvas');
-    if (canvas) canvas.style.cursor = value;
-  }
-
-  /**
-   * Register a new game object with the active scene or global engine.
-   * @param object The object to register.
-   */
-  static registerObject(object: GameObject) {
-    if (Engine.currentScene) {
-      Engine.currentScene.add(object);
-    } else {
-      this.objects.add(object);
-    }
-  }
-
-  /**
-   * Remove a game object from the active scene or global engine.
-   * @param object The object to destroy.
-   */
-  static destroyObject(object: GameObject) {
-    if (Engine.currentScene) {
-      Engine.currentScene.remove(object);
-    } else {
-      this.objects.delete(object);
-    }
-  }
-
-  /** Destroy all objects in the active scene or global engine. */
-  static destroyAll() {
-    if (Engine.currentScene) {
-      Engine.currentScene.clear();
-    } else {
-      this.objects.clear();
-    }
-  }
-}

package/src/EventBusComponent.ts

@@ -1,35 +0,0 @@
-import Component from './Component.js';
-
-/**
- * Component that allows an entity to emit and listen for local events.
- */
-export default class EventBusComponent extends Component {
-  private events: EventTarget = new EventTarget();
-
-  /**
-   * Listens for a local event on this entity.
-   * @param type The event type.
-   * @param callback The function to run when the event occurs.
-   */
-  on(type: string, callback: (event: CustomEvent) => void) {
-    this.events.addEventListener(type, callback as (e: Event) => void);
-  }
-
-  /**
-   * Stops listening for a local event.
-   * @param type The event type.
-   * @param callback The function to remove.
-   */
-  off(type: string, callback: (event: CustomEvent) => void) {
-    this.events.removeEventListener(type, callback as (e: Event) => void);
-  }
-
-  /**
-   * Emits a local event on this entity.
-   * @param type The event type.
-   * @param detail Optional data to pass with the event.
-   */
-  emit(type: string, detail?: unknown) {
-    this.events.dispatchEvent(new CustomEvent(type, { detail }));
-  }
-}

package/src/GameObject.ts

@@ -1,204 +0,0 @@
-import Engine from './Engine.js';
-import Vector2 from './Vector2.js';
-import Component from './Component.js';
-import PhysicsComponent from './PhysicsComponent.js';
-import TransformComponent from './TransformComponent.js';
-import TagComponent from './TagComponent.js';
-import EventBusComponent from './EventBusComponent.js';
-
-/**
- * Base class for all entities in the game world.
- * Provides properties for physics, rendering, and lifecycle management.
- * Acts as the 'Entity' in our evolving Entity Component System.
- */
-export default abstract class GameObject {
-  /** Collection of components attached to this entity. */
-  private _components: Map<string, Component> = new Map();
-
-  /** Internal components for backward compatibility and core logic. */
-  private _physics: PhysicsComponent;
-  private _transform: TransformComponent;
-  private _tag: TagComponent;
-  private _eventBus: EventBusComponent;
-
-  constructor(tag: string, zIndex: number) {
-    this._tag = new TagComponent(tag, zIndex);
-    this.addComponent(this._tag);
-
-    this._physics = new PhysicsComponent();
-    this.addComponent(this._physics);
-
-    this._transform = new TransformComponent();
-    this.addComponent(this._transform);
-
-    this._eventBus = new EventBusComponent();
-    this.addComponent(this._eventBus);
-  }
-
-  /**
-   * Listens for a local event on this entity.
-   * @param type The event type.
-   * @param callback The function to run when the event occurs.
-   */
-  on(type: string, callback: (event: CustomEvent) => void) {
-    this._eventBus.on(type, callback);
-  }
-
-  /**
-   * Stops listening for a local event.
-   * @param type The event type.
-   * @param callback The function to remove.
-   */
-  off(type: string, callback: (event: CustomEvent) => void) {
-    this._eventBus.off(type, callback);
-  }
-
-  /**
-   * Emits a local event on this entity.
-   * @param type The event type.
-   * @param detail Optional data to pass with the event.
-   */
-  emit(type: string, detail?: unknown) {
-    this._eventBus.emit(type, detail);
-  }
-
-  /**
-   * A unique identifier for the object type.
-   * @deprecated Use getComponent(TagComponent).tag
-   */
-  get tag(): string { return this._tag.tag; }
-  set tag(val: string) { this._tag.tag = val; }
-
-  /**
-   * Rendering order (lower is background, higher is foreground).
-   * @deprecated Use getComponent(TagComponent).zIndex
-   */
-  get zIndex(): number { return this._tag.zIndex; }
-  set zIndex(val: number) { this._tag.zIndex = val; }
-
-  /**
-   * The world-space position of the object.
-   * Getter returns world position, setter sets local position.
-   */
-  get position(): Vector2 { return this._transform.worldPosition; }
-  set position(val: Vector2) { this._transform.position = val; }
-
-  /**
-   * The local position relative to the parent.
-   */
-  get localPosition(): Vector2 { return this._transform.position; }
-  set localPosition(val: Vector2) { this._transform.position = val; }
-
-  /**
-   * The world-space rotation in radians.
-   */
-  get rotation(): number { return this._transform.worldRotation; }
-  set rotation(val: number) { this._transform.rotation = val; }
-
-  /**
-   * The local rotation in radians relative to the parent.
-   */
-  get localRotation(): number { return this._transform.rotation; }
-  set localRotation(val: number) { this._transform.rotation = val; }
-
-  /**
-   * The local scale relative to the parent.
-   */
-  get scale(): Vector2 { return this._transform.scale; }
-  set scale(val: Vector2) { this._transform.scale = val; }
-
-  /**
-   * Adds a child GameObject to this entity.
-   * @param child The child entity to add.
-   */
-  addChild(child: GameObject) {
-    child._transform.parent = this._transform;
-    this._transform.children.add(child._transform);
-  }
-
-  /**
-   * Removes a child GameObject from this entity.
-   * @param child The child entity to remove.
-   */
-  removeChild(child: GameObject) {
-    if (child._transform.parent === this._transform) {
-      child._transform.parent = undefined;
-      this._transform.children.delete(child._transform);
-    }
-  }
-
-  /**
-   * Gets or sets the parent GameObject.
-   */
-  get parent(): GameObject | undefined {
-    return this._transform.parent?.gameObject;
-  }
-  set parent(val: GameObject | undefined) {
-    if (this._transform.parent) {
-      this._transform.parent.children.delete(this._transform);
-    }
-    this._transform.parent = val?._transform;
-    val?._transform.children.add(this._transform);
-  }
-
-  /**
-   * Adds a component to this entity.
-   * @param component The component to add.
-   */
-  addComponent(component: Component) {
-    const key = component.constructor.name;
-    this._components.set(key, component);
-
-    // Also index by RenderComponent if it is one, to allow abstract querying.
-    // Use flag instead of instanceof to work across potential module duplications.
-    if ((component as unknown as { isRenderComponent: boolean; }).isRenderComponent) {
-      this._components.set('RenderComponent', component);
-    }
-
-    component.gameObject = this;
-  }
-
-  /**
-   * Removes a component from this entity by its class.
-   * @param componentClass The class of the component to remove.
-   */
-  removeComponent<T extends Component>(componentClass: { new(...args: unknown[]): T; }) {
-    this._components.delete(componentClass.name);
-  }
-
-  /**
-   * Checks if this entity has a component of the specified class.
-   * @param componentClass The class of the component to check for.
-   */
-  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
-  hasComponent<T extends Component>(componentClass: Function & { prototype: T; }): boolean {
-    return this._components.has(componentClass.name);
-  }
-
-  /** Gets a component from this entity by its class.
-   * @param componentClass The class of the component to retrieve.
-   */
-  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
-  getComponent<T extends Component>(componentClass: Function & { prototype: T; }): T | undefined {
-    return this._components.get(componentClass.name) as T;
-  }
-
-  /** The width of the object in pixels. */
-  get width(): number { return 0; }
-  /** The height of the object in pixels. */
-  get height(): number { return 0; }
-
-  /**
-   * Registers the object with the active scene or global engine loop.
-   */
-  registerSelf() {
-    Engine.registerObject(this);
-  }
-
-  /**
-   * Removes the object from the active scene.
-   */
-  destroySelf() {
-    Engine.destroyObject(this);
-  }
-}