// Copyright (c) 2026 Dominic Masters
//
// This software is released under the MIT License.
// https://opensource.org/licenses/MIT

/// <reference path="component/component.d.ts" />

/**
 * A game entity. `new Entity()` adds it to the currently active scene's
 * entity manager (see Scene.getActive()) -- throws if no scene is
 * active.
 */
declare class Entity {
  constructor();

  /** The engine-assigned numeric entity ID. */
  readonly id: number;

  /** Optional name; empty string if unset. */
  name: string;

  /**
   * Adds a component of the given type (e.g. POSITION) to this entity
   * and returns its wrapper.
   */
  add(type: number): Component;

  /**
   * Gets this entity's component of the given type, or undefined if it
   * doesn't have one.
   */
  getComponent(type: number): Component | undefined;

  /** Removes this entity and all its position-component descendants. */
  dispose(): void;
}